Prestashop Ok JainaOK 1.4 Reference Guide PRSH Ref Upd En

User Manual: prestashop Prestashop - 1.4 - Reference Guide Free User Guide for Prestashop Software, Manual

Open the PDF directly: View PDF PDF.
Page Count: 19

DownloadPrestashop Ok-  JainaOK - 1.4 Reference Guide PRSH-1.4 Ref-Upd-en
Open PDF In BrowserView PDF
	
  
	
  
	
  

Reference	
  Guide	
  
Updating	
  PrestaShop	
  
Use	
  this	
  document	
  as	
  a	
  step-­‐by-­‐step	
  guide	
  to	
  update	
  your	
  store	
  to	
  
PrestaShop	
  version	
  1.4	
  

Thank	
  you	
  for	
  using	
  PrestaShop	
  
	
  
	
  
	
  
	
  
	
  
	
  
	
  
Document	
  version	
  :	
  1.4.1EN	
  
(Updated	
  May	
  30h,	
  2011)	
  

	
  
	
  
	
  

	
  
Page	
  1	
  

	
  
	
  

5	
  Steps	
  to	
  Follow	
  for	
  a	
  Successful	
  Upgrade	
  	
  
	
  

These	
  five	
  steps	
  are	
  necessary	
  for	
  a	
  successful	
  upgrade.	
  Please	
  pay	
  close	
  attention	
  and	
  do	
  
not	
  skip	
  any	
  steps.	
  	
  
	
  

1. Save	
  and	
  Backup	
  Your	
  Current	
  Shop	
  
This	
  step	
  consists	
  of	
  backing	
  up	
  your	
  database	
  and	
  your	
  files.	
  This	
  step	
  is	
  not	
  avoidable	
  for	
  
success	
  and	
  should	
  never	
  ever	
  be	
  ignored	
  or	
  skipped.	
  	
  Do	
  not	
  proceed	
  to	
  step	
  two	
  without	
  
completing	
  this	
  step.	
  	
  
	
  

2. Getting	
  Ready	
  for	
  the	
  New	
  Version	
  
This	
  step	
  consists	
  of	
  preparing	
  the	
  files	
  that	
  you	
  will	
  need	
  to	
  copy	
  into	
  the	
  new	
  version	
  of	
  
PrestaShop.	
  	
  
	
  

3. Starting	
  the	
  Update	
  
This	
  step	
  consists	
  of	
  starting	
  the	
  upgrade	
  script	
  which	
  will	
  upgrade	
  your	
  database.	
  	
  
	
  

4. QA	
  and	
  Testing	
  
This	
  step	
  consists	
  of	
  doing	
  various	
  checks	
  to	
  make	
  sure	
  that	
  the	
  store	
  has	
  been	
  properly	
  updated	
  
to	
  the	
  latest	
  version.	
  	
  
	
  

5. Going	
  Live	
  with	
  the	
  New	
  Website	
  
This	
  step	
  will	
  accompany	
  you	
  in	
  going	
  live	
  with	
  the	
  latest	
  update.	
  	
  

Done	
   well,	
   the	
  whole	
   update	
   process	
   described	
   within	
   these	
   pages	
   should	
   not	
   take	
   more	
  
than	
  half	
  an	
  hour.	
  Do	
  not	
  try	
  to	
  skip	
  a	
  step	
  in	
  order	
  to	
  be	
  done	
  with	
  it	
  faster,	
  as	
  they	
  all	
  
are	
  crucial.	
  

Contact	
  Us	
  
	
  
Our	
  support	
  team	
  is	
  at	
  your	
  disposition	
  for	
  all	
  technical	
  problems	
  related	
  to	
  the	
  upgrade	
  
of	
  your	
  PrestaShop	
  store.	
  	
  
	
  
Via	
  email:	
  support@prestashop.com	
  
	
  
	
  
	
  
	
  

Page	
  2	
  

	
  
	
  

Step	
  1	
  –	
  Save	
  and	
  Backup	
  Your	
  Current	
  Store	
  
	
  

	
  	
  	
  

	
  

	
  Caution:	
  Not	
  backing	
  up	
  your	
  store	
  constitutes	
  a	
  very	
  important	
  risk	
  if	
  you	
  
encounter	
  any	
  difficulties	
  with	
  the	
  upgrade.	
  	
  There	
  is	
  a	
  risk	
  of	
  data	
  loss.	
  	
  
Do	
  not	
  ever	
  skip	
  this	
  step.	
  	
  Do	
  not	
  proceed	
  to	
  step	
  2	
  unless	
  you	
  are	
  
absolutely	
  certain	
  that	
  your	
  backups	
  are	
  completed,	
  successful,	
  and	
  fully	
  functional.	
  
Do	
  check	
  several	
  times.	
  

	
  

A.	
  Backing	
  Up	
  Your	
  Files	
  
You	
  must	
  save	
  all	
  of	
  the	
  files	
  related	
  to	
  your	
  PrestaShop	
  store.	
  
There	
  are	
  two	
  main	
  ways	
  of	
  backing	
  up	
  your	
  files:	
  
•

Ask	
  your	
  hosting	
  company	
  to	
  back	
  up	
  your	
  files.	
  
Making	
  sure	
  that	
  this	
  backup	
  is	
  fully	
  functional,	
  recent,	
  and	
  more	
  importantly	
  that	
  it	
  reflects	
  the	
  
content	
  of	
  your	
  current	
  store.	
  	
  

-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐	
  or	
  -­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐	
  
•

Copy	
  all	
  of	
  your	
  FTP	
  files	
  from	
  your	
  server	
  to	
  your	
  local	
  computer.	
  	
  
This	
  method	
  is	
  only	
  possible	
  if	
  your	
  hosting	
  provider	
  has	
  provided	
  you	
  with	
  an	
  FTP	
  access	
  to	
  your	
  
server.	
  Create	
  a	
  “Backup”	
  folder	
  on	
  your	
  computer,	
  then,	
  using	
  an	
  FTP	
  client	
  (such	
  as	
  FileZilla),	
  
select	
  all	
  the	
  PrestaShop	
  files	
  and	
  folders	
  on	
  your	
  server	
  (use	
  the	
  Ctrl-­‐A	
  command)	
  and	
  copy	
  
them	
  to	
  your	
  “Backup”	
  folder.
	
  

	
  

	
  
	
  

Page	
  3	
  

	
  
	
  

	
  

B.	
  Deactivating	
  Your	
  Store	
  
	
  	
  	
  

	
  

	
  Warning:	
  disabling	
  your	
  store	
  is	
  very	
  important.	
  

By	
  doing	
  so,	
  you	
  make	
  sure	
  that	
  there	
  is	
  no	
  activity	
  on	
  your	
  store	
  while	
  you	
  are	
  
updating	
  it.	
  Therefore,	
  if	
  you	
  ever	
  have	
  to	
  revert	
  the	
  update	
  using	
  a	
  backup,	
  you	
  won’t	
  have	
  
lost	
  any	
  unfinished	
  carts	
  or	
  orders.	
  
	
  
Go	
  to	
  your	
  store’s	
  back-­‐office,	
  click	
  on	
  the	
  “Preference”	
  tab,	
  then	
  select	
  “No”	
  for	
  the	
  “Enable	
  Shop”	
  
option.	
  

	
  
In	
  the	
  “Maintenance	
  IP”	
  field,	
  located	
  just	
  below	
  the	
  “Enable	
  Shop”	
  one,	
  enter	
  your	
  own	
  IP	
  address,	
  so	
  
that	
  you	
  can	
  keep	
  on	
  using	
  your	
  store	
  during	
  the	
  update.	
  This	
  will	
  allow	
  you	
  to	
  test	
  the	
  store,	
  while	
  still	
  
making	
  sure	
  visitors	
  cannot	
  access	
  the	
  website.	
  	
  
In	
  order	
  to	
  find	
  out	
  your	
  IP	
  address,	
  visit	
  this	
  page:	
  http://www.myip.dk/	
  	
  

	
  
	
  

	
  
	
  

	
  

Page	
  4	
  

	
  
	
  

C.	
  Backing	
  Up	
  Your	
  Database	
  
You	
  must	
  absolutely	
  back	
  up	
  the	
  whole	
  database	
  in	
  conjunction	
  to	
  your	
  PrestaShop	
  store.	
  
There	
  are	
  three	
  different	
  ways	
  to	
  back	
  up	
  your	
  database:	
  
•

Ask	
  you	
  hosting	
  provider	
  to	
  back	
  up	
  your	
  database	
  
Be	
  sure	
  that	
  your	
  database	
  backup	
  is	
  functional,	
  recent,	
  and	
  especially	
  that	
  it	
  contains	
  all	
  of	
  your	
  
data	
  for	
  your	
  PrestaShop	
  Store.	
  

-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐	
  or	
  -­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐	
  
•

Download	
  a	
  copy	
  of	
  your	
  database	
  via	
  phpMyAdmin	
  
Be	
  sure	
  that	
  your	
  database	
  backup	
  is	
  functional,	
  recent,	
  and	
  especially	
  that	
  it	
  contains	
  all	
  of	
  your	
  
data	
  for	
  your	
  PrestaShop	
  Store.	
  If	
  your	
  database	
  is	
  too	
  big,	
  you	
  might	
  receive	
  an	
  error.	
  If	
  that	
  is	
  
the	
  case,	
  you	
  will	
  need	
  to	
  contact	
  your	
  hosting	
  provider.	
  
	
  

	
  

	
  

-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐	
  or	
  -­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐	
  
•

Download	
  a	
  Database	
  Backup	
  from	
  your	
  PrestaShop	
  Back-­‐Office	
  	
  
Visit	
  the	
  “Tools	
  tab,	
  then	
  the	
  “DB	
  backup”	
  sub-­‐tab.	
  This	
  process	
  will	
  take	
  between	
  1	
  and	
  20	
  
minutes	
  depending	
  on	
  the	
  size	
  of	
  your	
  database.	
  	
  Make	
  sure	
  this	
  backup	
  is	
  functional,	
  recent,	
  
and	
  especially	
  that	
  it	
  contains	
  of	
  all	
  the	
  data	
  of	
  your	
  website.	
  	
  Open	
  the	
  zip	
  file	
  and	
  make	
  sure	
  
that	
  there	
  are	
  absolutely	
  NO	
  ERRORS	
  before	
  proceeding	
  to	
  the	
  next	
  step.	
  	
  

	
  
	
  
	
  

Page	
  5	
  

	
  
	
  

D.	
  Backing	
  up	
  Your	
  Customized	
  Translation	
  
If	
  you	
  did	
  not	
  add	
  any	
  personalized	
  translation	
  at	
  the	
  root	
  of	
  your	
  modules,	
  please	
  proceed	
  to	
  step	
  2.	
  
Navigate	
  to	
  the	
  “Tools”	
  tab,	
  then	
  the	
  “Translations”	
  sub-­‐tab	
  of	
  your	
  back-­‐office.	
  
In	
  the	
  section	
  “Export	
  a	
  Language”	
  select	
  the	
  language	
  to	
  which	
  you	
  have	
  made	
  any	
  modifications,	
  then	
  
select	
  your	
  current	
  theme,	
  and	
  click	
  “Export”.	
  
Save	
  the	
  downloaded	
  file	
  into	
  a	
  backup	
  folder	
  of	
  your	
  choice,	
  on	
  your	
  local	
  computer…	
  

	
  
	
  

	
  
	
  

	
  

	
  	
  	
  
Verify	
  your	
  Backup	
  folder,	
  does	
  it	
  contain…	
  
	
  

□	
  …a	
  complete	
  copy	
  of	
  all	
  of	
  your	
  files	
  	
  
	
  
□	
  …a	
  complete	
  
and	
  errorless	
  copy	
  of	
  your	
  database	
  
□	
  …a	
  copy	
  of	
  your	
  customized	
  translations	
  (optional)	
  
You	
  have	
  checked	
  the	
  entire	
  backup	
  above,	
  and	
  made	
  sure	
  that	
  they	
  are	
  all	
  correct	
  and	
  
that	
  you	
  would	
  be	
  able	
  to	
  return	
  to	
  your	
  current	
  version	
  /	
  restore	
  all	
  of	
  your	
  data.	
  	
  

If	
  you	
  answered	
  yes	
  to	
  all	
  of	
  the	
  questions	
  above,	
  then	
  proceed	
  to	
  Step	
  2.	
  
	
  
	
  

Page	
  6	
  

	
  
	
  

Step	
  2	
  –	
  Getting	
  Ready	
  for	
  the	
  New	
  Version	
  
	
  
A.	
  Downloading	
  and	
  Unzipping	
  of	
  the	
  Latest	
  PrestaShop	
  Version	
  
Visit	
  http://www.prestashop.com	
  and	
  download	
  the	
  latest	
  version	
  of	
  PrestaShop	
  (click	
  the	
  “Download”	
  button	
  on	
  
the	
  homepage).	
  
You	
  now	
  should	
  have	
  a	
  file:	
  prestashop_1.x.x.zip	
  (where	
  “x”	
  represents	
  the	
  version	
  number).	
  
Unzip	
  the	
  file	
  to	
  your	
  computer.	
  If	
  you	
  do	
  not	
  yet	
  have	
  an	
  unzipping	
  tool,	
  you	
  can	
  download	
  a	
  free	
  one	
  here:	
  
http://www.7-­‐zip.org/	
  	
  .	
  
Once	
  unzipped,	
  open	
  the	
  “prestashop”	
  folder	
  that	
  it	
  contained.	
  
In	
  that	
  “prestashop”	
  folder,	
  select	
  the	
  “admin”	
  folder	
  and	
  rename	
  it	
  to	
  something	
  unique	
  to	
  you	
  (for	
  instance,	
  
“admin436”.	
  Your	
  online	
  store	
  currently	
  also	
  has	
  a	
  unique	
  “admin”	
  folder,	
  from	
  its	
  original	
  installation;	
  you	
  can	
  
use	
  that	
  unique	
  name	
  if	
  you	
  wish.	
  If	
  you	
  do	
  not	
  know	
  the	
  unique	
  name	
  of	
  your	
  online	
  store’s	
  “admin”	
  folder,	
  use	
  
whichever	
  name	
  you	
  want.	
  

B.	
  Copy	
  the	
  files	
  backed	
  up	
  during	
  Step	
  1	
  to	
  the	
  “prestashop”	
  folder	
  
Some	
  of	
  the	
  folders	
  that	
  you	
  have	
  backed	
  up	
  will	
  need	
  to	
  be	
  copied	
  to	
  your	
  «	
  prestashop	
  »	
  folder.	
  

	
  
	
  
	
  
	
  

	
  	
  	
  

	
  

	
  Caution:	
  You	
  will	
  be	
  copying	
  files	
  from	
  your	
  “Backup”	
  directory	
  to	
  the	
  
“prestashop”	
  directory.	
  Answer	
  «	
  Yes	
  »	
  when	
  the	
  system	
  asks	
  you	
  to	
  replace	
  
the	
  existing	
  files.	
  

	
  	
  

	
  

	
  

The	
  following	
  folders	
  must	
  be	
  copied	
  from	
  your	
  backup	
  towards	
  the	
  recently	
  unzipped	
  “prestashop”	
  folder:	
  

□	
  “mails”	
  folder	
  has	
  all	
  the	
  mails	
  that	
  you	
  have	
  modified.	
  
If	
  you	
  have	
  never	
  made	
  any	
  modification	
  there,	
  do	
  not	
  worry	
  about	
  this	
  folder.	
  

□	
  “img”	
  folder	
  contains	
  your	
  logo	
  and	
  all	
  the	
  pictures	
  of	
  your	
  store	
  (categories,	
  products…)	
  
□	
  “modules”	
  folder,	
  only	
  copy	
  the	
  modules	
  that	
  you	
  have	
  added.	
  
	
  
	
  

Page	
  7	
  

	
  
	
  

□	
  “themes/yourtheme”	
  folder,	
  only	
  copy	
  your	
  current	
  theme.	
  If	
  you	
  use	
  the	
  default	
  theme	
  from	
  PrestaShop,	
  do	
  
not	
  copy	
  it,	
  you	
  must	
  use	
  the	
  one	
  from	
  the	
  new	
  version.	
  

□	
  “download”	
  and	
  “upload”	
  folders,	
  which	
  contain	
  all	
  the	
  downloadable	
  products,	
  the	
  attached	
  files	
  and	
  the	
  
customizable	
  products.	
  If	
  you	
  do	
  no	
  use	
  any	
  of	
  these	
  functionalities,	
  do	
  not	
  copy	
  these	
  folders.	
  	
  

□	
  “classes”	
  folder:	
  in	
  case	
  you	
  have	
  added	
  customized	
  classes	
  to	
  this	
  folder,	
  copy	
  them	
  to	
  the	
  new	
  “classes”	
  
folder.	
  Then	
  open	
  each	
  and	
  every	
  one	
  of	
  them,	
  and	
  rename	
  their	
  name,	
  adding	
  the	
  “Core”	
  suffix.	
  For	
  intance,	
  
“MyClasse”	
  becomes	
  “MyClasseCore”.	
  
Only	
  change	
  the	
  name	
  in	
  the	
  PHP	
  class	
  within	
  file,	
  not	
  the	
  name	
  of	
  the	
  file	
  itself.	
  	
  	
  

□	
  “config”	
  folders,	
  only	
  copy	
  the	
  settings.inc.php	
  file,	
  then	
  modify	
  the	
  following	
  lines:	
  
-­‐	
  The	
  line	
  that	
  contains	
  “PS_BASE_URI”	
  must	
  contain	
  the	
  name	
  of	
  the	
  subfolder	
  where	
  you	
  are	
  going	
  to	
  do	
  your	
  
update.	
  For	
  instance,	
  “/prestashop/”	
  instead	
  of	
  “/”,	
  or	
  of	
  the	
  name	
  of	
  current	
  folder	
  for	
  your	
  current	
  store.	
  
-­‐	
  If	
  you	
  modified	
  your	
  database	
  credentials	
  (you	
  should	
  not	
  have	
  had	
  to	
  do	
  that	
  normally),	
  update	
  all	
  the	
  lines	
  
that	
  contain	
  “DB_NAME”,	
  “DB_USER”	
  et	
  “DB_PASSWD”	
  too.	
  

C.	
  Moving	
  the	
  folder	
  «	
  prestashop	
  »	
  to	
  your	
  FTP	
  server.	
  	
  
The	
   “prestashop”	
   folder	
   that	
   you	
   have	
   unzipped,	
   now	
   contains	
   all	
   the	
   modifications	
   from	
   your	
   “Backup”	
  
folder	
   (and	
   therefore,	
   from	
   your	
   currently	
   live	
   store).	
  This	
  next	
  step	
  will	
  have	
  you	
  upload	
  that	
  folder	
  on	
  your	
  
FTP	
  server.	
  
	
  
	
  	
  	
  	
  
	
  
	
  Caution:	
  If	
  the	
  folder	
  of	
  your	
  store	
  is	
  already	
  named	
  «	
  prestashop	
  »,	
  rename	
  the	
  
	
  
folder	
  «	
  prestashop	
  »	
  on	
  your	
  hard	
  drive	
  before	
  sending	
  it	
  onto	
  your	
  FTP	
  
	
  
server.	
  
	
  
	
  
	
  
If	
  you	
  renamed	
  the	
  “prestashop”	
  folder,	
  do	
  not	
  forget	
  to	
  update	
  the	
  config/settings.inc.php	
  file	
  accordingly,	
  
as	
  explained	
  in	
  step	
  2-­‐B.	
  
	
  
Using	
  your	
  FTP	
  client,	
  upload	
  the	
  “prestashop”	
  folder	
  to	
  your	
  server.	
  	
  
	
  

	
  
	
  

Page	
  8	
  

	
  
	
  

	
  

	
  

D.	
  Checking	
  before	
  going	
  further	
  
	
  
Let’s	
  say	
  your	
  store	
  is	
  at	
  the	
  following	
  URL:	
  	
  http://www.myshop.com	
  
	
  
1.	
  To	
  test	
  the	
  update,	
  you	
  first	
  downloaded	
  the	
  latest	
  version	
  of	
  PrestaShop.	
  	
  
	
  
2.	
  You	
  unzipped	
  this	
  version,	
  which	
  contained	
  a	
  folder	
  called	
  “prestashop”	
  
	
  
3.	
  You	
  copied	
  your	
  customized	
  files	
  from	
  your	
  backup	
  to	
  this	
  new	
  “prestashop”	
  folder.	
  
	
  
4.	
  You	
  modified	
  the	
  file	
  config/settings.inc.php	
  on	
  line	
  “PS_BASE_URI”	
  so	
  that	
  it	
  has	
  the	
  name	
  of	
  the	
  
folder	
  on	
  your	
  server	
  (should	
  be	
  “prestashop”)	
  
	
  
For	
  instance:	
  
	
  
define(‘__PS_BASE_URI__’,	
  ‘/’);	
  	
  
was	
  replaced	
  by	
  
define(‘__PS_BASE_URI__’,	
  ‘/prestashop/’);	
  
	
  
5.	
  You	
  uploaded	
  your	
  “prestashop”	
  folder	
  to	
  your	
  FTP	
  server,	
  and	
  it	
  can	
  be	
  accessed	
  at:	
  
http://www.myshop.com/prestashop	
  
	
  

	
  	
  	
  
Did	
  you	
  follow	
  these	
  5	
  steps?	
  
	
  

□	
  Downloaded	
  and	
  extracted	
  PrestaShop	
  
□	
  Unzipping	
  the	
  downloaded	
  .zip	
  file	
  
□	
  Manual	
  copy	
  of	
  the	
  folder	
  of	
  step	
  2.B	
  
□	
  Transfer	
  the	
  whole	
  directory	
  “prestashop”	
  onto	
  your	
  FTP	
  
□	
  The	
  line	
  PS_BASE_URI	
  of	
  the	
  files	
  config/settings.inc.php	
  should	
  show	
  the	
  
name	
  of	
  the	
  transferred	
  folder	
  FTP	
  (	
  should	
  “prestashop”)	
  

	
  
If	
  you	
  answered	
  yes	
  to	
  all	
  the	
  questions	
  above,	
  then	
  proceed	
  to	
  step	
  3.	
  
	
  
	
  

	
  

	
  
	
  

	
  

Page	
  9	
  

	
  
	
  

Step	
  3	
  –	
  Starting	
  the	
  Update	
  
	
  
A.	
  Launching	
  the	
  update	
  script	
  
	
  
Visit	
  the	
  following	
  URL:	
  http://www.myshop.com/prestashop/install	
  
	
  
(Replace	
  myshop.com	
  with	
  the	
  actual	
  URL	
  of	
  your	
  store,	
  and	
  “prestashop”	
  with	
  the	
  name	
  of	
  the	
  folder	
  that	
  
you	
  have	
  just	
  transferred	
  to	
  your	
  FTP)	
  
	
  
That	
  URL	
  should	
  show:	
  
	
  

	
  

	
  
	
  
1. Select	
  «	
  Update	
  »	
  
2. Read	
  the	
  license	
  agreement,	
  then	
  select	
  the	
  option	
  “I	
  agree	
  to	
  the	
  above	
  terms	
  and	
  conditions”	
  
3. Click	
  on	
  the	
  “Next”	
  button	
  
	
  
	
  
	
  
	
  

Page	
  10	
  

	
  
	
  

If	
  you	
  did	
  follow	
  the	
  first	
  step	
  of	
  this	
  guide	
  concerning	
  back-­‐ups,	
  you	
  can	
  click	
  “I	
  certify	
  that	
  I	
  backed	
  up	
  my	
  
database	
  and	
  application	
  files.	
  I	
  assume	
  all	
  responsibility	
  for	
  any	
  data	
  loss	
  or	
  damage	
  related	
  to	
  this	
  
upgrade.”	
  	
  If	
  you	
  did	
  not	
  do	
  the	
  required	
  back-­‐ups	
  or	
  if	
  you	
  did	
  not	
  have	
  a	
  chance	
  to	
  verify	
  the	
  data’s	
  
integrity	
  and	
  that	
  these	
  backups	
  are	
  functional	
  and	
  recent,	
  please	
  go	
  back	
  to	
  step	
  1	
  of	
  this	
  guide.	
  	
  

	
  

	
  
B.	
  Verification	
  of	
  all	
  parameters	
  before	
  the	
  update	
  
	
  
The	
   parameters	
   of	
   your	
   hosting	
   provider	
   should	
   show	
   on	
   the	
   screen,	
   as	
   well	
   as	
   more	
   details	
   about	
   the	
  
operation	
  about	
  to	
  be	
  launched.	
  
	
  
• max_execution_time	
  shows	
  the	
  maximum	
  time	
  in	
  seconds	
  authorized	
  by	
  your	
  hosting	
  provider	
  for	
  
the	
   update	
   to	
   take	
   place.	
   If	
   this	
   number	
   is	
   smaller	
   than	
   the	
   estimated	
   time	
   of	
   installation,	
   we	
  
recommend	
  that	
  you	
  notify	
  your	
  hosting	
  provider	
  so	
  that	
  he	
  can	
  increase	
  this	
  limit.	
  	
  
	
  
• memory_limit	
   is	
   the	
   maximum	
   memory	
   that	
   you’re	
   hosting	
   provider	
   will	
   set	
   aside	
   for	
   you	
   to	
  
complete	
   the	
   upgrade.	
   If	
   this	
   value	
   is	
   smaller	
   than	
   “32M”,	
   you	
   should	
   contact	
   your	
   hosting	
   company	
  
to	
  request	
  an	
  increase	
  of	
  this	
  value.	
  	
  
	
  
If	
  any	
  of	
  these	
  two	
  parameters	
  does	
  not	
  meet	
  the	
  requirements,	
  you	
  are	
  taking	
  the	
  risk	
  of	
  receiving	
  an	
  error	
  
message	
  or	
  a	
  blank	
  page	
  after	
  clicking	
  the	
  “Next”.	
  
Otherwise,	
  click	
  the	
  “Next”	
  button	
  at	
  the	
  bottom	
  of	
  the	
  page.	
  	
  
	
  
	
  
	
  
	
  

	
  
	
  

Page	
  11	
  

	
  
	
  

If	
  sufficient	
  rights	
  are	
  assigned	
  to	
  your	
  files	
  and	
  folders,	
  the	
  following	
  page	
  will	
  show:	
  
	
  

	
  
	
  
If	
  not,	
  make	
  sure	
  that	
  the	
  folders	
  are	
  properly	
  configured:	
  change	
  their	
  permissions	
  of	
  the	
  folders	
  in	
  red	
  on	
  your	
  
FTP	
  server	
  (CHMOD	
  777	
  or	
  775,	
  depending	
  on	
  your	
  hosting	
  provider)	
  then	
  click	
  the	
  “Refresh	
  these	
  settings”	
  
button.	
  
In	
  order	
  to	
  perform	
  a	
  CHMOD,	
  using	
  your	
  FTP	
  client,	
  find	
  the	
  folders	
  that	
  have	
  the	
  wrong	
  permission	
  settings,	
  
right-­‐click	
  on	
  each	
  of	
  them	
  in	
  order	
  to	
  display	
  their	
  properties	
  (or	
  even	
  better,	
  their	
  access	
  rights),	
  and	
  tick	
  the	
  
boxes	
  that	
  are	
  not	
  yet	
  ticked,	
  until	
  a	
  refresh	
  of	
  the	
  “System	
  and	
  Permissions”	
  page	
  gives	
  you	
  only	
  green	
  folder.	
  
	
  
Once	
  you’re	
  done,	
  click	
  “Next”	
  at	
  the	
  bottom	
  of	
  the	
  page,	
  the	
  update	
  will	
  start	
  and	
  probably	
  last	
  a	
  few	
  minutes.	
  
	
  
	
  	
  	
  	
  
	
  
	
  Caution:	
  You	
  can	
  check	
  if	
  the	
  update	
  has	
  started	
  in	
  the	
  upper	
  right	
  part	
  of	
  the	
  
	
  
screen,	
  thanks	
  to	
  the	
  progress	
  bar.	
  Do	
  not	
  leave	
  the	
  page;	
  wait	
  for	
  the	
  update	
  
	
  
to	
  be	
  completed.	
  
	
  
	
  
	
  
	
  

	
  
	
  

Page	
  12	
  

	
  
	
  

C.	
  Finishing	
  the	
  update	
  
	
  
Once	
  the	
  update	
  is	
  finished,	
  you	
  should	
  see	
  the	
  following	
  screen:	
  
	
  

	
  
	
  
On	
  your	
  FTP	
  server,	
  inside	
  the	
  “prestashop”	
  folder,	
  you	
  should	
  delete:	
  
	
  
• The	
  	
  “install”	
  folder	
  (this	
  subfolder	
  contains	
  the	
  update	
  tools)	
  
• The	
  	
  README	
  files	
  (contain	
  information	
  about	
  the	
  installation)	
  
• The	
  CHANGELOG	
  file	
  (contains	
  information	
  about	
  the	
  latest	
  changes	
  in	
  PrestaShop)	
  
	
  
You	
   can	
   now	
   access	
   your	
   store’s	
   front-­‐office	
   at	
   http://www.myshop.com/prestashop	
   (change	
   the	
   URL	
  
accordingly).	
  
	
  

	
  	
  	
  

	
  

Did	
  you	
  fellow	
  these	
  3	
  steps?	
  

□	
  Launching	
  the	
  Update	
  tool	
  
□	
  Verifying	
  	
  the	
  parameters	
  and	
  started	
  the	
  update	
  
□	
  Finishing	
  the	
  installation	
  and	
  removing	
  the	
  unneeded	
  folders	
  and	
  files.	
  	
  
	
  
If	
  you	
  answered	
  yes	
  to	
  all	
  of	
  these	
  questions,	
  proceed	
  to	
  step	
  4.	
  
	
  
	
  

Page	
  13	
  

	
  
	
  

Step	
  4	
  –	
  Verifying	
  the	
  update	
  
A.	
  Import	
  your	
  Translation	
  that	
  you	
  saved	
  in	
  Step	
  1	
  
	
  
If	
   you	
  did	
   export	
   your	
   own	
   translations	
   during	
   step	
   1	
   (Backups),	
   import	
   them	
   back	
   into	
   your	
   new	
   store	
   by	
  
going	
  to	
  the	
  “Tools”	
  tab,	
  then	
  the	
  “Translations”	
  sub-­‐tab.	
  	
  
	
  

	
  

	
  
	
  
	
  
	
  
	
  
	
  
	
  
	
  
	
  
	
  
	
  
	
  

	
  
	
  

Page	
  14	
  

	
  
	
  

B.	
  Verification	
  of	
  the	
  main	
  Domain	
  Name	
  and	
  regeneration	
  of	
  your	
  .htaccess	
  
	
  
You	
   should	
   verify	
   that	
   the	
   domain	
   name	
   assigned	
   in	
   the	
   database	
   is	
   indeed	
   the	
   one	
   that	
   you	
   are	
   working	
  
with.	
  	
  To	
  do	
  so,	
  visit	
  the	
  “Preferences”	
  tab,	
  then	
  the	
  “SEO	
  &	
  URLs”	
  sub-­‐tab.	
  
	
  	
  

	
  
	
  
You	
  must	
  check	
  the	
  following	
  information:	
  
•

•
	
  
	
  
	
  
	
  
	
  
	
  
	
  
	
  

	
  

“PS	
  directory”:	
  this	
  folder	
  should	
  be	
  the	
  one	
  that	
  you	
  have	
  transferred	
  onto	
  your	
  FTP	
  server;	
  in	
  this	
  
tutorial,	
  it	
  would	
  be	
  “/prestashop/”	
  
	
  
“Domain	
   Name”:	
   This	
   should	
   be	
   the	
   domain	
   name	
   to	
   which	
   you	
   are	
   currently	
   connected.	
   Otherwise,	
  
all	
  your	
  links	
  will	
  be	
  invalid	
  and	
  will	
  use	
  an	
  incorrect	
  domain	
  name.	
  	
  

	
  	
  	
  

	
  

	
  Caution:	
  	
  In	
  any	
  case,	
  do	
  not	
  forget	
  to	
  regenerate	
  your	
  .htaccess	
  file	
  by	
  going	
  to	
  
the	
  “Tools”	
  tab,	
  then	
  “Generators”.	
  If	
  your	
  old	
  .htaccess	
  	
  file	
  contains	
  specific	
  
information	
  related	
  to	
  your	
  hosting,	
  copy/paste	
  them	
  into	
  the	
  “Specific	
  
Configuration“	
  space	
  provided	
  in	
  this	
  same	
  tab.	
  

	
  

C.	
  Verifying	
  your	
  theme’s	
  compatibility	
  
	
  
You	
   can	
   verify	
   your	
   theme’s	
   compatibility	
   with	
   the	
   updated	
   version	
   by	
   visiting	
   the	
   “theme	
   validator”	
  
developed	
  by	
  Prestashop.	
  
	
  
This	
  tools	
  is	
  available	
  at	
  the	
  following	
  address:	
  http://validator.prestashop.com/	
  
	
  
If	
  you	
  use	
  an	
  unmodified	
  copy	
  of	
  the	
  default	
  theme	
  of	
  PrestaShop,	
  this	
  step	
  is	
  not	
  necessary.	
  
	
  
	
  
	
  
Page	
  15	
  
	
  
	
  

D.	
  Tests	
  to	
  be	
  done	
  on	
  your	
  new	
  store.	
  
	
  
To	
  make	
  sure	
  that	
  everything	
  is	
  working	
  properly	
  on	
  your	
  updated	
  store,	
  you	
  should	
  perform	
  a	
  few	
  tests	
  :	
  

	
  	
  	
  
Testing	
  To-­‐Do	
  List	
  (this	
  is	
  not	
  a	
  complete	
  list,	
  you	
  should	
  do	
  as	
  much	
  testing	
  as	
  possible):	
  
	
  

□	
  All	
  pages	
  load	
  properly	
  (Home,	
  Categories,	
  Products…)	
  
□	
  Create	
  a	
  customer	
  account	
  
□	
  Place	
  an	
  order	
  	
  (add	
  to	
  cart	
  and	
  order)	
  
□	
  Verify	
  that	
  payments	
  work	
  properly	
  (credit	
  card,	
  Paypal,	
  etc.)	
  
□	
  In	
  the	
  Back	
  Office	
  ,	
  check	
  that	
  the	
  order	
  was	
  properly	
  placed	
  and	
  received	
  
□	
  Send	
  an	
  email	
  from	
  the	
  contact	
  page	
  or	
  	
  “Forgot	
  my	
  password”	
  
□	
  Check	
  the	
  resulting	
  invoice	
  
□	
  Check	
  all	
  the	
  modules	
  that	
  you	
  have	
  activated	
  
	
  
If	
  everything	
  test	
  perfect,	
  Congratulations!	
  Proceed	
  to	
  step	
  5.	
  
	
  

	
  
	
  
	
  
	
  
	
  
	
  
	
  
	
  
	
  
	
  
	
  
	
  
	
  

Page	
  16	
  

	
  
	
  

Step	
  5	
  –	
  Going	
  live	
  with	
  your	
  Up	
  to	
  Date	
  Store.	
  
	
  

A.	
  Swapping	
  your	
  updated	
  store	
  and	
  your	
  production	
  store.	
  
	
  
Congratulations,	
  you	
  have	
  achieved	
  all	
  the	
  essential	
  steps	
  to	
  update	
  your	
  store!	
  
You	
  now	
  need	
  to	
  swap	
  your	
  updated	
  store	
  with	
  your	
  production	
  store.	
  
You	
  have	
  two	
  options	
  to	
  do	
  so:	
  
•

On	
  your	
  FTP	
  Server,	
  select	
  the	
  entire	
  content	
  of	
  the	
  “prestashop”	
  folder	
  and	
  drag’n’drop	
  it	
  to	
  the	
  
folder	
  of	
  your	
  production	
  store.	
  This	
  option	
  is	
  fast.	
  If	
  your	
  FTP	
  client	
  offers	
  to	
  do	
  it,	
  ask	
  to	
  haveit	
  
overwrite	
  all	
  existing	
  files	
  	
  

-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐	
  or-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐	
  
•

	
  

	
  
	
  
	
  

You	
  can	
  also	
  download	
  you	
  whole	
  updated	
  store	
  directory	
  (“prestashop”)	
  from	
  the	
  FTP	
  server	
  
into	
  your	
  local	
  computer,	
  and	
  then	
  upload	
  all	
  the	
  files	
  back	
  onto	
  your	
  production	
  folder.	
  This	
  
option	
  will	
  take	
  a	
  little	
  bit	
  longer,	
  and	
  you	
  should	
  again	
  select	
  the	
  option	
  to	
  overwrite	
  all	
  the	
  
files.	
  	
  
	
  	
  	
  

	
  

	
  	
  At	
  the	
  end	
  of	
  the	
  operation,	
  edit	
  the	
  file	
  config/settings.inc.php:	
  look	
  for	
  the	
  
line	
  containing	
  _PS_BASE_URI_,	
  and	
  replace	
  “/prestashop/”	
  by	
  “/”.	
  If	
  you	
  don’t	
  
do	
  that,	
  your	
  images	
  and	
  theme	
  will	
  not	
  appear	
  correctly.	
  

à	
  For	
  more	
  information,	
  look	
  at	
  the	
  end	
  of	
  the	
  Paragraph	
  D.4	
  step	
  2.	
  

	
  
B.	
  Activating	
  your	
  store	
  
	
  
Visit	
  the	
  “Preference”	
  tab	
  in	
  the	
  back-­‐office	
  of	
  your	
  production	
  store	
  and	
  click	
  “Yes”	
  for	
  the	
  option	
  “Enable	
  
Shop”.	
  
	
  

	
  

	
  
	
  
	
  
	
  
	
  

Page	
  17	
  

	
  
	
  

	
  

	
  
	
  

	
  

Page	
  18	
  

	
  
	
  

In	
  case	
  of	
  issues	
  
In	
  some	
  rare	
  cases,	
  some	
  modules	
  are	
  not	
  compatible	
  with	
  new	
  version	
  of	
  PrestaShop.	
  You	
  should	
  
contact	
  the	
  company	
  /	
  person	
  that	
  provided	
  you	
  with	
  this	
  module	
  to	
  request	
  a	
  few	
  code	
  changes	
  to	
  
bring	
  it	
  up	
  to	
  date.	
  	
  

A.	
  Rolling	
  back	
  your	
  database.	
  	
  (Only	
  proceed	
  to	
  this	
  step	
  if	
  you	
  have	
  no	
  other	
  way	
  
out)	
  
If	
  your	
  update	
  went	
  bad	
  and	
  you	
  do	
  not	
  see	
  any	
  other	
  fix	
  than	
  to	
  roll	
  back	
  to	
  the	
  previous	
  version	
  of	
  
your	
  database,	
  there	
  are	
  two	
  mains	
  way	
  of	
  doing	
  so:	
  
•

Ask	
  your	
  hosting	
  provider	
  to	
  restore	
  the	
  back	
  up	
  for	
  you.	
  	
  
Make	
  sure	
  to	
  provide	
  them	
  with	
  the	
  latest	
  backup	
  that	
  you	
  have	
  done	
  during	
  Step	
  1!	
  

-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐	
  or	
  -­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐-­‐	
  
•

Import	
  your	
  backed	
  up	
  data	
  via	
  phpMyAdmin
If	
  the	
  size	
  of	
  your	
  database	
  is	
  too	
  big,	
  you	
  might	
  encounter	
  an	
  error	
  message.	
  If	
  so,	
  you	
  might	
  
need	
  to	
  ask	
  your	
  hosting	
  provider	
  for	
  help	
  by	
  changing	
  the	
  size	
  of	
  the	
  database	
  maximum	
  
upload.	
  	
  
This	
  is	
  typically	
  done	
  by	
  the	
  tools	
  provided	
  to	
  you	
  by	
  your	
  provider,	
  most	
  often	
  phpMyAdmin.	
  
You	
  will	
  find	
  the	
  backup	
  data	
  under	
  the	
  /admin/backups	
  folder.	
  	
  
You	
  can	
  also	
  download	
  the	
  database	
  from	
  within	
  your	
  back	
  office.	
  Visit	
  “Tools”	
  then	
  
“DBBackup”.	
  Select	
  your	
  latest	
  database	
  and	
  download	
  it	
  to	
  your	
  computer	
  by	
  clicking	
  on	
  it.	
  	
  It	
  
should	
  typically	
  take	
  between	
  1	
  and	
  20	
  minutes	
  to	
  download.	
  
	
  

	
  

	
  

B.	
  Contact	
  us	
  
Notre	
  équipe	
  support	
  est	
  à	
  votre	
  entière	
  disposition	
  pour	
  tout	
  problème	
  technique	
  lié	
  à	
  la	
  mise	
  à	
  jour	
  
de	
  votre	
  boutique	
  PrestaShop.	
  
Par	
  e-­‐mail	
  :	
  support@prestashop.com	
  
Par	
  téléphone	
  :	
  +33.01.40.18.30.04
http://support.prestashop.com/fr/	
  

	
  

	
  
	
  
	
  

Page	
  19	
  

	
  
	
  



Navigation menu