api templates
DESCRIPTION
API template guide for creating products on ZazzleTRANSCRIPT
7/15/2019 API Templates
http://slidepdf.com/reader/full/api-templates 1/13
Creating Template Products
7/15/2019 API Templates
http://slidepdf.com/reader/full/api-templates 2/13
Creating Template Products Page 2
Copyright (c) 2011, Zazzle Inc.
All rights reserved.
Zazzle® is a registered trademark of Zazzle Inc. All other trademarks and registered trademarks
are the property of their respective owners.
• Nopartofthismanualmaybemodied,altered,transmitted,transcribed,storedinaretrievalsystem,ortranslatedintoanylanguageorcomputerlanguage,inanyformorbyanymeans,
electronic,mechanical,magnetic,optical,chemical,manual,orotherwise,withoutthepriorwritten
permissionofZazzle.com.Youmaymakeonecopyofthismanualforyourinternalbusinessor
personaluse.
• ZAZZLE.COMMAKESNOWARRANTYOFANYKINDWITHREGARDTOTHEMATERIAL
CONTAINEDINTHISMANUAL,EITHEREXPRESS,IMPLIED,STATUTORYOROTHERWISE,
INCLUDING,WITHOUTLIMITATION,THEIMPLIEDWARRANTIESOFMERCHANTABILITY,
NON-INFRINGEMENT,ANDFITNESSFORAPARTICULARPURPOSE.THEMATERIAL
CONTAINEDINTHISMANUALISPROVIDEDAS-IS.
• WITHRESPECTTOTHEMATERIALCONTAINEDINTHISMANUAL,INNOEVENT
WILLZAZZLE.COMORITSAFFILIATESBELIABLEFOR:ANYDIRECTDAMAGES,ANY
INCIDENTAL,CONSEQUENTIAL,SPECIAL,INDIRECT,EXEMPLARYORPUNITIVE
DAMAGES,WHETHERARISINGINTORT,CONTRACT,OROTHERWISE;ORFORLOST
PROFITS,LOSTSAVINGS,LOSSOFBUSINESSORANTICIPATORYPROFITS,EVENIF
ZAZZLE.COMORITSAFFILIATESHAVEBEENADVISEDOFTHEPOSSIBILITYOFSUCH
DAMAGES.
• AnyrightsnotexpresslygrantedhereinarereservedbyZazzle.com.
7/15/2019 API Templates
http://slidepdf.com/reader/full/api-templates 3/13
Creating Template Products Page 3
Table of Contents
Creating Template Products.................................................................................. 4
How to Make a Template Product ......................................................................... 5
Template Tips........................................................................................................ 11
Templates for Embroidered Products ................................................................ 11Locking Objects ................................................................................................... 13
7/15/2019 API Templates
http://slidepdf.com/reader/full/api-templates 4/13
Creating Template Products Page 4
Creating Template Products AZazzleTemplateisaproductthatcontainsimagesand/ortextplaceholdersthatareeasily
personalizedbythebuyer.Thisisagreatwaytoallowyourcustomerstomakeaproductpersonal
tothem,whileremovingthecomplexityofdesigningsomethingfromscratch.
Populartemplateproductsincludegreetingcardswhichallowthecustomertouploadtheirown
picture,t-shirtsforsportsteamswithaplayer’slastnameontheback,personalizedwedding
announcementpostageandinvitations,businesscards,andmore.Whenacustomerviewsatemplateproductpage,alltheyhavetodoislloutoneormoresimple
eldstopersonalizetheproduct.ThentheycanclicktheAdd to Cartbuttontobuytheproduct.
ZazzleTemplateProductscanalsobeusedinconjunctionwiththeZazzleAPIallowingthe
placeholderimagesand/ortexttobepopulatedfromyourwebsite.
Seehttp://www.zazzle.com/apiformoreinformationabouttheZazzleAPI.
Thefollowingisanexampleofatemplateproductonwhichcustomerscanaddtheirownimage
andtext:
http://www.zazzle.com/template_shirt-235859385108715923
7/15/2019 API Templates
http://slidepdf.com/reader/full/api-templates 5/13
Creating Template Products Page 5
How to Make a Template ProductThistutorialwillshowyouhowtocreatetheexampleproductabove.Ifyouhavecreatedproducts
onZazzlebefore,theprocessisthesame,withjustafewadditionalstepstodeneyourtemplate.
Youcanmakeaproductbecomeatemplatebysimplydeningwhichimage(s)ortextobject(s)
thebuyercanreplace.
1. Gotohttp://www.zazzle.com/createandchoosethetypeofproductyouwouldliketomake.In
thisexample,wewillselect“Men’sShirts”.2. Findthestyleofshirtyouwouldliketocreateandclickthe“Createonenow!”buttonbelowit.
Inthisexample,wewillchooseaBasicT-Shirt.
3. TheZazzleDesignToolappears,forthepurposesofthistutorial,youmayclickCancelonthe
GetStartedwindowthatappears.
4. Let’saddtheimagerst.PleaseclicktheAddImagesbutton.
Design Tool Add Images and Add Text Buttons
5. AfteryouclickAddImagesyoumayeitherchoosetoSelectimagestouploadfromyour
computer,orchooseanimagefromyouZazzleaccount.Youmayneedtocreateanice
placeholderimageliketheexamplebelowinyourfavoritegraphicdesignprogram.Many
examplescanbeseenintheZazzleTemplatesStore.
7/15/2019 API Templates
http://slidepdf.com/reader/full/api-templates 6/13
Creating Template Products Page 6
6. Theimagewillappearonyourshirt,andtheCustomizeItsectionofthepagewilldisplayarow
fortheimageyouhavejustadded.
Customize It Box with an image selected
7/15/2019 API Templates
http://slidepdf.com/reader/full/api-templates 7/13
Creating Template Products Page 7
7. Nowweneedtocongurethetemplateoptions.ClicktheAdvancedOptionsbutton,which
looks like gears.
Advanced Options button
8. Oneoftheadvancedoptionsisacheckboxlabeled“Makethisatemplateobject”.Checkthat
boxtodisplayalltheoptionsavailablefordeningthistemplateimageplaceholder.
Template Image Options
7/15/2019 API Templates
http://slidepdf.com/reader/full/api-templates 8/13
Creating Template Products Page 8
There are 4 options
•Product page label-Thisisthelabelthatthecustomerwillseeontheproductpage.Use
somethingdescriptivehere,like“Yourpicture”or“Yourlogo”.
•URL parameter name-IfyouareusingtheZazzleAPItopassdatatothisproductfroman
externalsource,thisistheparameternametheAPIwilluse.Avoidspacesorspecial
characters.YoucansafelyignorethiseldifyouarenotworkingwiththeAPI.
• Inner ft/fll mode-Ifyourtemplateallowsthebuyertoreplaceyourplaceholderimagewithoneofherown,thissettingdetermineshowthebuyer’simagereplacesyours.Theoptions
arenone,t,orll.
none-IfyousetInnert/llmodetonone,thebuyer’simagesimplyreplacesyour
placeholderimage,andmaybelargerorsmallerthantheplaceholder.
ft-Selectingtwillresizethebuyer’simagetotinsideofyourplaceholderimage
object’sdimensions.Thiswillensurethattheirimageisnotcropped,butcouldresultin
borders,or“letterboxing”toappeararoundyourimagethecoloroftheproduct
background.
fll-Selectingllwillresizetheirimagetolltheentiredimensionsofyourplaceholder
image.Ifthebuyer’simageiswiderortallerthanyourplaceholder,thismayresultin zoomingandcroppingofthecustomer’simage.
•Allow editing on product page-Keepthischeckedifyouwanttoenablethecustomerto
changetheimageontheproductpage.Uncheckingthisoptionisusuallyonlydonewhen
workingwiththeZazzleAPIifyoudonotwishtoallowthecustomertopersonalizethe
productafterlinkingover.
7/15/2019 API Templates
http://slidepdf.com/reader/full/api-templates 9/13
Creating Template Products Page 9
9. Nowwewilladdatextobjecttotheproduct.ClicktheAddTextbutton.
Customize It Box with a text object selected
10.Clickthelittlegearsbuttonagaintobringuptheadvancedoptions.
Customize It Box with a text object selected
7/15/2019 API Templates
http://slidepdf.com/reader/full/api-templates 10/13
Creating Template Products Page 10
11.ClickMakethisatemplateobject
Thereareonly3optionswhenworkingwithtextobjects
• Product page label-Thisisthelabelthatthecustomerwillseeontheproductpage.Use
somethingdescriptiveherethatshowswhattoenterlike“YourName”or“City”.
• URL parameter name-IfyouareusingtheZazzleAPItopassdatatothisproductfroman
externalsource,thisistheparameternametheAPIwilluse.Avoidspacesorspecial characters.YoucansafelyignorethiseldifyouarenotworkingwiththeAPI.
• Allow editing on product page-Keepthischeckedifyouwanttoenablethecustomerto
changethetextontheproductpage.Uncheckingthisoptionisusuallyonlydonewhenworking
withtheZazzleAPIifyoudonotwishtoallowthecustomertopersonalizetheproduct.
12.Onceyouhavelledoutalltheoptions,clicktheredPost for Salelinkatthebottomofthe
page.YouarethenpresentedwiththePostProductforSalepage.
Post Product For Sale Page with template felds highlighted
13.Noticethecheckboxlabeled“Thisproductisatemplate”.Thistellsyouthattheproduct
containstemplateobjects,andthatitwillbepostedforsaleasatemplate.Leavethisbox
checked,oryourproductwillnotbepostedasatemplateproduct.
7/15/2019 API Templates
http://slidepdf.com/reader/full/api-templates 11/13
Creating Template Products Page 11
14.Besuretollouttherestoftherequiredeldsonthispage.
15.ClickthePostItbuttontocompletetheprocess.
Congratulations! You have just created a template product!
Template Tips• Whencreatingimageplaceholders,thinkaboutmakingtheimagecontaintextthatsays “YOURIMAGEHERE”or“YOURLOGOHERE”.Designabunchofdifferentimage
placeholders for different sizes.
• Keeptheproductpagetemplatelabelsshortbutdescriptive.Usewordsthatdescribewhat
informationyouwanttheusertollout,like“Yourname”,“Bride’sname”,“Date”,etc.
• Whenpostingforsale,addtheword“template”inthetitle,description,ortagssoit’seasyfor
userstondtemplateproducts.
Templates for Embroidered ProductsCreatingatemplateforembroideredproductsisverysimilartomakingatemplateforprintproducts.Thereare,however,acoupleofkeydifferences.
1. You cannot make an embroidered image into a template object.Theimagesonan
embroideredproductrepresentaxedphysicalsizeandstitcharrangement,makingthempoo
candidatesforcustomersubstitution.
2. Text can cause boundary and overlapping issues.TextCANbemadeintoatemplate
object,butdoingsoraisesthepossibilitythatwemaynotbeabletomanufactureyourproduct,
duetooverlappingtextorboundaryissues.See examples below.
Text that oversteps its bounds
Inthisexample,texthasbeenreplacedwithmuchlongertextthatendsupbeingtoobigforthe
design area.
7/15/2019 API Templates
http://slidepdf.com/reader/full/api-templates 12/13
Creating Template Products Page 12
Whenthisoccurs,theproductcannotbemanufactured,andthebuyerwillseeawarningiconnext
totheAddtocartbutton,likethis:
Overlapping textItisalsopossiblefortexttooverlap,againmakingitimpossibletomanufactureproperly.The
customerwillseethesamewarningiconasaboveandhavetheopportunitytoxthetext.
7/15/2019 API Templates
http://slidepdf.com/reader/full/api-templates 13/13
Locking ObjectsUnder“Advancedoptions”foranyobject,youwillseeacheckboxlabeled“Lockobject(s)”
Advanced Options – Lock object(s)
Bycheckingthisoption,theimageortextobjectwillnotbecustomizablebyacustomerinthe
ZazzleDesignTool.Thismeansthatnoonewillbeabletochange,remove,resize,rotate,or
repositiontheobject.Allthoseoptionswillbedisabled.Pleasenotetheuserwillstillbeable
topersonalizetheobjectontheproductpageifthe“alloweditingontheproductpage”boxis
checked.