Upload
nemanja-ignjatovic
View
243
Download
0
Embed Size (px)
Citation preview
8/3/2019 Pre Stash Op Reference Guide Updating Pre Stash Op 110530b En
http://slidepdf.com/reader/full/pre-stash-op-reference-guide-updating-pre-stash-op-110530b-en 1/19
Page1
ReferenceGuideUpdatingPrestaShop
Usethisdocumentasastep-by-stepguidetoupdateyourstoreto
PrestaShopversion1.4
ThankyouforusingPrestaShop
Documentversion:1.4.1EN
(UpdatedMay30h,2011)
8/3/2019 Pre Stash Op Reference Guide Updating Pre Stash Op 110530b En
http://slidepdf.com/reader/full/pre-stash-op-reference-guide-updating-pre-stash-op-110530b-en 2/19
Page2
5StepstoFollowforaSuccessfulUpgrade
Thesefivestepsarenecessaryforasuccessfulupgrade.Pleasepaycloseattentionanddo
notskipanysteps.
1. SaveandBackupYourCurrentShopThisstepconsistsofbackingupyourdatabaseandyourfiles.Thisstepisnotavoidablefor
successandshouldnevereverbeignoredorskipped.Donotproceedtosteptwowithout
completingthisstep.
2. GettingReadyfortheNewVersionThisstepconsistsofpreparingthefilesthatyouwillneedtocopyintothenewversionof
PrestaShop.
3. StartingtheUpdateThisstepconsistsofstartingtheupgradescriptwhichwillupgradeyourdatabase.
4. QAandTestingThisstepconsistsofdoingvariouscheckstomakesurethatthestorehasbeenproperlyupdated
tothelatestversion.
5. GoingLivewiththeNewWebsiteThisstepwillaccompanyyouingoinglivewiththelatestupdate.
Donewell,thewholeupdateprocessdescribedwithinthesepagesshouldnottakemore
thanhalfanhour.Donottrytoskipastepinordertobedonewithitfaster,astheyall
arecrucial.
ContactUs
Oursupportteamisatyourdispositionforalltechnicalproblemsrelatedtotheupgrade
ofyourPrestaShopstore.
Viaemail:[email protected]
8/3/2019 Pre Stash Op Reference Guide Updating Pre Stash Op 110530b En
http://slidepdf.com/reader/full/pre-stash-op-reference-guide-updating-pre-stash-op-110530b-en 3/19
Page3
Step1–SaveandBackupYourCurrentStore
A.BackingUpYourFiles
YoumustsaveallofthefilesrelatedtoyourPrestaShopstore.
Therearetwomainwaysofbackingupyourfiles:
• Askyourhostingcompanytobackupyourfiles.
Makingsurethatthisbackupisfullyfunctional,recent,andmoreimportantlythatitreflectsthe
contentofyourcurrentstore.
-----------or-----------
• CopyallofyourFTPfilesfromyourservertoyourlocalcomputer.
ThismethodisonlypossibleifyourhostingproviderhasprovidedyouwithanFTPaccesstoyour
server.Createa“Backup”folderonyourcomputer,then,usinganFTPclient(suchasFileZilla),
selectallthePrestaShopfilesandfoldersonyourserver(usetheCtrl-Acommand)andcopy
themtoyour“Backup”folder.
Caution:Notbackingupyourstoreconstitutesaveryimportantriskifyou
encounteranydifficultieswiththeupgrade.Thereisariskofdataloss.
Donoteverskipthisstep.Donotproceedtostep2unlessyouareabsolutelycertainthatyourbackupsarecompleted,successful,andfullyfunctional.
Docheckseveraltimes.
8/3/2019 Pre Stash Op Reference Guide Updating Pre Stash Op 110530b En
http://slidepdf.com/reader/full/pre-stash-op-reference-guide-updating-pre-stash-op-110530b-en 4/19
Page4
B.DeactivatingYourStore
Gotoyourstore’sback-office,clickonthe“Preference”tab,thenselect“No”forthe“EnableShop”
option.
Inthe“MaintenanceIP”field,locatedjustbelowthe“EnableShop”one,enteryourownIPaddress,so
thatyoucankeeponusingyourstoreduringtheupdate.Thiswillallowyoutotestthestore,whilestillmakingsurevisitorscannotaccessthewebsite.
InordertofindoutyourIPaddress,visitthispage:http://www.myip.dk/
Warning:disablingyourstoreisveryimportant.
Bydoingso,youmakesurethatthereisnoactivityonyourstorewhileyouare
updatingit.Therefore,ifyoueverhavetoreverttheupdateusingabackup,youwon’thave
lostanyunfinishedcartsororders.
8/3/2019 Pre Stash Op Reference Guide Updating Pre Stash Op 110530b En
http://slidepdf.com/reader/full/pre-stash-op-reference-guide-updating-pre-stash-op-110530b-en 5/19
Page5
C.BackingUpYourDatabase
YoumustabsolutelybackupthewholedatabaseinconjunctiontoyourPrestaShopstore.
Therearethreedifferentwaystobackupyourdatabase:
• Askyouhostingprovidertobackupyourdatabase
Besurethatyourdatabasebackupisfunctional,recent,andespeciallythatitcontainsallofyour
dataforyourPrestaShopStore.
-----------or-----------
• DownloadacopyofyourdatabaseviaphpMyAdmin
Besurethatyourdatabasebackupisfunctional,recent,andespeciallythatitcontainsallofyour
dataforyourPrestaShopStore.Ifyourdatabaseistoobig,youmightreceiveanerror.Ifthatis
thecase,youwillneedtocontactyourhostingprovider.
-----------or-----------
• DownloadaDatabaseBackupfromyourPrestaShopBack-Office
Visitthe“Toolstab,thenthe“DBbackup”sub-tab.Thisprocesswilltakebetween1and20
minutesdependingonthesizeofyourdatabase.Makesurethisbackupisfunctional,recent,
andespeciallythatitcontainsofallthedataofyourwebsite.OpenthezipfileandmakesurethatthereareabsolutelyNOERRORSbeforeproceedingtothenextstep.
8/3/2019 Pre Stash Op Reference Guide Updating Pre Stash Op 110530b En
http://slidepdf.com/reader/full/pre-stash-op-reference-guide-updating-pre-stash-op-110530b-en 6/19
Page6
D.BackingupYourCustomizedTranslation
Ifyoudidnotaddanypersonalizedtranslationattherootofyourmodules,pleaseproceedtostep2.
Navigatetothe“Tools”tab,thenthe“Translations”sub-tabofyourback-office.
Inthesection“ExportaLanguage”selectthelanguagetowhichyouhavemadeanymodifications,then
selectyourcurrenttheme,andclick“Export”.
Savethedownloadedfileintoabackupfolderofyourchoice,onyourlocalcomputer…
VerifyyourBackupfolder,doesitcontain…
□…acompletecopyofallofyourfiles
□…acompleteanderrorlesscopyofyourdatabase
□…acopyofyourcustomizedtranslations(optional)
Youhavecheckedtheentirebackupabove,andmadesurethattheyareallcorrectand
thatyouwouldbeabletoreturntoyourcurrentversion/restoreallofyourdata.
Ifyouansweredyestoallofthequestionsabove,thenproceedtoStep2.
8/3/2019 Pre Stash Op Reference Guide Updating Pre Stash Op 110530b En
http://slidepdf.com/reader/full/pre-stash-op-reference-guide-updating-pre-stash-op-110530b-en 7/19
Page7
Step2–GettingReadyfortheNewVersion
A.DownloadingandUnzippingoftheLatestPrestaShopVersion
Visithttp://www.prestashop.comanddownloadthelatestversionofPrestaShop(clickthe“Download”buttonon
thehomepage).
Younowshouldhaveafile:prestashop_1.x.x.zip(where“x”representstheversionnumber).
Unzipthefiletoyourcomputer.Ifyoudonotyethaveanunzippingtool,youcandownloadafreeonehere:
http://www.7-zip.org/.
Onceunzipped,openthe“prestashop”folderthatitcontained.
Inthat“prestashop”folder,selectthe“admin”folderandrenameittosomethinguniquetoyou(forinstance,
“admin436”.Youronlinestorecurrentlyalsohasaunique“admin”folder,fromitsoriginalinstallation;youcan
usethatuniquenameifyouwish.Ifyoudonotknowtheuniquenameofyouronlinestore’s“admin”folder,use
whichevernameyouwant.
B.CopythefilesbackedupduringStep1tothe“prestashop”folder
Someofthefoldersthatyouhavebackedupwillneedtobecopiedtoyour«prestashop»folder.
Thefollowingfoldersmustbecopiedfromyourbackuptowardstherecentlyunzipped“prestashop”folder:
□“mails”folderhasallthemailsthatyouhavemodified.
Ifyouhavenevermadeanymodificationthere,donotworryaboutthisfolder.
□“img”foldercontainsyourlogoandallthepicturesofyourstore(categories,products…)
□“modules”folder,onlycopythemodulesthatyouhaveadded.
Caution:Youwillbecopyingfilesfromyour“Backup”directorytothe
“prestashop”directory.Answer«Yes»whenthesystemasksyoutoreplace
theexistingfiles.
8/3/2019 Pre Stash Op Reference Guide Updating Pre Stash Op 110530b En
http://slidepdf.com/reader/full/pre-stash-op-reference-guide-updating-pre-stash-op-110530b-en 8/19
Page8
□“themes/yourtheme”folder,onlycopyyourcurrenttheme.IfyouusethedefaultthemefromPrestaShop,do
notcopyit,youmustusetheonefromthenewversion.
□“download”and“upload”folders,whichcontainallthedownloadableproducts,theattachedfilesandthe
customizableproducts .Ifyoudonouseanyofthesefunctionalities,donotcopythesefolders.
□“classes”folder:incaseyouhaveaddedcustomizedclassestothisfolder,copythemtothenew“classes”
folder.Thenopeneachandeveryoneofthem,andrenametheirname,addingthe“Core”suffix.Forintance,
“MyClasse”becomes“MyClasseCore”.
OnlychangethenameinthePHPclasswithinfile, notthenameofthefileitself.
□“config”folders,onlycopythesettings.inc.phpfile,thenmodifythefollowinglines:
-Thelinethatcontains“PS_BASE_URI”mustcontainthenameofthesubfolderwhereyouaregoingtodoyour
update.Forinstance,“/prestashop/”insteadof“/”,orofthenameofcurrentfolderforyourcurrentstore.
-Ifyoumodifiedyourdatabasecredentials(youshouldnothavehadtodothatnormally),updateallthelines
thatcontain“DB_NAME”,“DB_USER”et“DB_PASSWD”too.
C.Movingthefolder«prestashop»toyourFTPserver.
The“prestashop” folder that youhave unzipped, nowcontainsall themodifications fromyour “Backup”
folder(andtherefore,fromyourcurrentlylivestore).Thisnextstepwillhaveyouuploadthatfolderonyour
FTPserver.
Ifyourenamedthe“prestashop”folder,donotforgettoupdatetheconfig/settings.inc.phpfileaccordingly,
asexplainedinstep2-B.
UsingyourFTPclient,uploadthe“prestashop”foldertoyourserver.
Caution:Ifthefolderofyourstoreisalreadynamed«prestashop»,renamethe
folder«prestashop»onyourharddrivebeforesendingitontoyourFTP
server.
8/3/2019 Pre Stash Op Reference Guide Updating Pre Stash Op 110530b En
http://slidepdf.com/reader/full/pre-stash-op-reference-guide-updating-pre-stash-op-110530b-en 9/19
Page9
D.Checkingbeforegoingfurther
Let’ssayyourstoreisatthefollowingURL:http://www.myshop.com
1.Totesttheupdate,youfirstdownloadedthelatestversionofPrestaShop.
2.Youunzippedthisversion,whichcontainedafoldercalled“prestashop”
3.Youcopiedyourcustomizedfilesfromyourbackuptothisnew“prestashop”folder.
4.Youmodifiedthefileconfig/settings.inc.phponline“PS_BASE_URI”sothatithasthenameofthe
folderonyourserver(shouldbe“prestashop”)
Forinstance:
define(‘__PS_BASE_URI__’,‘/’);
wasreplacedby
define(‘__PS_BASE_URI__’,‘/prestashop/’);
5.Youuploadedyour“prestashop”foldertoyourFTPserver,anditcanbeaccessedat:
http://www.myshop.com/prestashop
Didyoufollowthese5steps?
□DownloadedandextractedPrestaShop
□Unzippingthedownloaded.zipfile
□Manualcopyofthefolderofstep2.B
□Transferthewholedirectory“prestashop”ontoyourFTP
□ThelinePS_BASE_URIofthefilesconfig/settings.inc.phpshouldshowthe
nameofthetransferredfolderFTP(should“prestashop”)
Ifyouansweredyestoallthequestionsabove,thenproceedtostep3.
8/3/2019 Pre Stash Op Reference Guide Updating Pre Stash Op 110530b En
http://slidepdf.com/reader/full/pre-stash-op-reference-guide-updating-pre-stash-op-110530b-en 10/19
Page10
Step3–StartingtheUpdate
A.Launchingtheupdatescript
VisitthefollowingURL:http://www.myshop.com/prestashop/install
(Replacemyshop.comwiththeactualURLofyourstore,and“prestashop”withthenameofthefolderthat
youhavejusttransferredtoyourFTP)
ThatURLshouldshow:
1. Select«Update»
2. Readthelicenseagreement,thenselecttheoption“Iagreetotheabovetermsandconditions”3. Clickonthe“Next”button
8/3/2019 Pre Stash Op Reference Guide Updating Pre Stash Op 110530b En
http://slidepdf.com/reader/full/pre-stash-op-reference-guide-updating-pre-stash-op-110530b-en 11/19
Page11
Ifyoudidfollowthefirststepofthisguideconcerningback-ups,youcanclick“IcertifythatIbackedupmy
databaseandapplicationfiles.Iassumeallresponsibilityforanydatalossordamagerelatedtothis
upgrade.”Ifyoudidnotdotherequiredback-upsorifyoudidnothaveachancetoverifythedata’s
integrityandthatthesebackupsarefunctionalandrecent,pleasegobacktostep1ofthisguide.
B.Verificationofallparametersbeforetheupdate
The parameters of your hostingprovider should show on the screen, as well as more details about the
operationabouttobelaunched.
• max_execution_timeshowsthemaximumtimeinsecondsauthorizedbyyourhostingproviderfor
the update to take place. If this number is smaller than the estimated time of installation, we
recommendthatyounotifyyourhostingprovidersothathecanincreasethislimit.
• memory_limit is the maximum memory that you’re hosting provider will set aside for you to
completetheupgrade.Ifthisvalueissmallerthan“32M”,youshouldcontactyourhostingcompany
torequestanincreaseofthisvalue.
Ifanyofthesetwoparametersdoesnotmeettherequirements,youaretakingtheriskofreceivinganerror
messageorablankpageafterclickingthe“Next”.
Otherwise,clickthe“Next”buttonatthebottomofthepage.
8/3/2019 Pre Stash Op Reference Guide Updating Pre Stash Op 110530b En
http://slidepdf.com/reader/full/pre-stash-op-reference-guide-updating-pre-stash-op-110530b-en 12/19
Page12
Ifsufficientrightsareassignedtoyourfilesandfolders,thefollowingpagewillshow:
Ifnot,makesurethatthefoldersareproperlyconfigured:changetheirpermissionsofthefoldersinredonyour
FTPserver(CHMOD777or775,dependingonyourhostingprovider)thenclickthe“Refreshthesesettings”
button.
InordertoperformaCHMOD,usingyourFTPclient,findthefoldersthathavethewrongpermissionsettings,
right-clickoneachoftheminordertodisplaytheirproperties(orevenbetter,theiraccessrights),andtickthe
boxesthatarenotyetticked,untilarefreshofthe“SystemandPermissions”pagegivesyouonlygreenfolder.
Onceyou’redone,click“Next”atthebottomofthepage,theupdatewillstartandprobablylastafewminutes.
Caution:Youcancheckiftheupdatehasstartedintheupperrightpartofthe
screen,thankstotheprogressbar.Donotleavethepage;waitfortheupdate
tobecompleted.
8/3/2019 Pre Stash Op Reference Guide Updating Pre Stash Op 110530b En
http://slidepdf.com/reader/full/pre-stash-op-reference-guide-updating-pre-stash-op-110530b-en 13/19
Page13
C.Finishingtheupdate
Oncetheupdateisfinished,youshouldseethefollowingscreen:
OnyourFTPserver,insidethe“prestashop”folder,youshoulddelete:
• The“install”folder(thissubfoldercontainstheupdatetools)
• TheREADMEfiles(containinformationabouttheinstallation)
• TheCHANGELOGfile(containsinformationaboutthelatestchangesinPrestaShop)
You can now access your store’s front-office at http://www.myshop.com/prestashop (change the URL
accordingly).
Didyoufellowthese3steps?
□LaunchingtheUpdatetool
□Verifyingtheparametersandstartedtheupdate
□Finishingtheinstallationandremovingtheunneededfoldersandfiles.
Ifyouansweredyestoallofthesequestions,proceedtostep4.
8/3/2019 Pre Stash Op Reference Guide Updating Pre Stash Op 110530b En
http://slidepdf.com/reader/full/pre-stash-op-reference-guide-updating-pre-stash-op-110530b-en 14/19
Page14
Step4–Verifyingtheupdate
A.ImportyourTranslationthatyousavedinStep1
Ifyoudidexportyourowntranslationsduringstep1(Backups),importthembackintoyournewstoreby
goingtothe“Tools”tab,thenthe“Translations”sub-tab.
8/3/2019 Pre Stash Op Reference Guide Updating Pre Stash Op 110530b En
http://slidepdf.com/reader/full/pre-stash-op-reference-guide-updating-pre-stash-op-110530b-en 15/19
Page15
B.VerificationofthemainDomainNameandregenerationofyour.htaccess
Youshouldverifythatthedomainnameassignedinthedatabaseisindeedtheonethatyouareworking
with.Todoso,visitthe“Preferences”tab,thenthe“SEO&URLs”sub-tab.
Youmustcheckthefollowinginformation:
• “PSdirectory”:thisfoldershouldbetheonethatyouhavetransferredontoyourFTPserver;inthis
tutorial,itwouldbe“/prestashop/”
• “DomainName”:Thisshouldbethedomainnametowhichyouarecurrentlyconnected.Otherwise,
allyourlinkswillbeinvalidandwilluseanincorrectdomainname.
C.Verifyingyourtheme’scompatibility
You can verify your theme’s compatibility with the updated version by visiting the “theme validator”
developedbyPrestashop.
Thistoolsisavailableatthefollowingaddress: http://validator.prestashop.com/
IfyouuseanunmodifiedcopyofthedefaultthemeofPrestaShop,thisstepisnotnecessary.
Caution:Inanycase,donotforgettoregenerateyour.htaccessfilebygoingto
the“Tools”tab,then“Generators”.Ifyourold.htaccessfilecontainsspecific
informationrelatedtoyourhosting,copy/pastethemintothe“Specific
Configuration“spaceprovidedinthissametab.
8/3/2019 Pre Stash Op Reference Guide Updating Pre Stash Op 110530b En
http://slidepdf.com/reader/full/pre-stash-op-reference-guide-updating-pre-stash-op-110530b-en 16/19
Page16
D.Teststobedoneonyournewstore.
Tomakesurethateverythingisworkingproperlyonyourupdatedstore,youshouldperformafewtests:
TestingTo-DoList(thisisnotacompletelist,youshoulddoasmuchtestingaspossible):
□Allpagesloadproperly(Home,Categories,Products…)
□Createacustomeraccount
□Placeanorder(addtocartandorder)
□Verifythatpaymentsworkproperly(creditcard,Paypal,etc.)
□IntheBackOffice,checkthattheorderwasproperlyplacedandreceived
□Sendanemailfromthecontactpageor“Forgotmypassword”
□Checktheresultinginvoice
□Checkallthemodulesthatyouhaveactivated
Ifeverythingtestperfect,Congratulations!Proceedtostep5.
8/3/2019 Pre Stash Op Reference Guide Updating Pre Stash Op 110530b En
http://slidepdf.com/reader/full/pre-stash-op-reference-guide-updating-pre-stash-op-110530b-en 17/19
Page17
Step5–GoinglivewithyourUptoDateStore.
A.Swappingyourupdatedstoreandyourproductionstore.
Congratulations,youhaveachievedalltheessentialstepstoupdateyourstore!
Younowneedtoswapyourupdatedstorewithyourproductionstore.
Youhavetwooptionstodoso:
• OnyourFTPServer,selecttheentirecontentofthe“prestashop”folderanddrag’n’dropittothe
folderofyourproductionstore.Thisoptionisfast.IfyourFTPclientofferstodoit,asktohaveit
overwriteallexistingfiles
-----------or-----------
• Youcanalsodownloadyouwholeupdatedstoredirectory(“prestashop”)fromtheFTPserver
intoyourlocalcomputer,andthenuploadallthefilesbackontoyourproductionfolder.This
optionwilltakealittlebitlonger,andyoushouldagainselecttheoptiontooverwriteallthe
files.
B.Activatingyourstore
Visitthe“Preference”tabintheback-officeofyourproductionstoreandclick“Yes”fortheoption“Enable
Shop”.
Attheendoftheoperation,editthefileconfig/settings.inc.php:lookforthe
linecontaining_PS_BASE_URI_,andreplace“/prestashop/”by“/”.Ifyoudon’t
dothat,yourimagesandthemewillnotappearcorrectly.
àFormoreinformation,lookattheendoftheParagraphD.4step2.
8/3/2019 Pre Stash Op Reference Guide Updating Pre Stash Op 110530b En
http://slidepdf.com/reader/full/pre-stash-op-reference-guide-updating-pre-stash-op-110530b-en 18/19
Page18
8/3/2019 Pre Stash Op Reference Guide Updating Pre Stash Op 110530b En
http://slidepdf.com/reader/full/pre-stash-op-reference-guide-updating-pre-stash-op-110530b-en 19/19
Incaseofissues
Insomerarecases,somemodulesarenotcompatiblewithnewversionofPrestaShop.Youshould
contactthecompany/personthatprovidedyouwiththismoduletorequestafewcodechangesto
bringituptodate.
A.Rollingback yourdatabase.(Onlyproceedtothisstepifyouhavenootherwayout)
Ifyourupdatewentbadandyoudonotseeanyotherfixthantorollbacktothepreviousversionof
yourdatabase,therearetwomainswayofdoingso:
• Askyourhostingprovidertorestorethebackupforyou.
MakesuretoprovidethemwiththelatestbackupthatyouhavedoneduringStep1!
-----------or-----------
• ImportyourbackedupdataviaphpMyAdmin
Ifthesizeofyourdatabaseistoobig,youmightencounteranerrormessage.Ifso,youmight
needtoaskyourhostingproviderforhelpbychangingthesizeofthedatabasemaximum
upload.
Thisistypicallydonebythetoolsprovidedtoyoubyyourprovider,mostoftenphpMyAdmin.
Youwillfindthebackupdataunderthe/admin/backupsfolder.
Youcanalsodownloadthedatabasefromwithinyourbackoffice.Visit“Tools”then
“DBBackup”.Selectyourlatestdatabaseanddownloadittoyourcomputerbyclickingonit.It
shouldtypicallytakebetween1and20minutestodownload.
B.Contactus
Notreéquipesupportestàvotreentièredispositionpourtoutproblèmetechniqueliéàlamiseàjour
devotreboutiquePrestaShop.
Pare-mail:[email protected]
Partéléphone:+33.01.40.18.30.04http://support.prestashop.com/fr/