Child pages
  • Updating PrestaShop

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • 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 using an FTP client
    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 the free FileZilla client), select all the PrestaShop files and folders on your server (use the Ctrl-A command) and copy them to your "Backup" folder.

...

  • 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.

Backing up Your Customized Translation

If you did not add any personalized translation at the root of your modulesedit the available translations or add new ones (either PrestaShop's or your modules'), please proceed to step 2.

...

Tip
titleVerify your Backup folder

Does it contain...

  • ...a complete copy of all of your files?
  • ...a complete and error-less copy of your database?
  • ...a copy of your customized translations (optional)?

You have checked the entire backup abovefolder, 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.

...

Once unzipped, open the "/prestashop" folder that it containedwas inside the Zip archive.

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.

...

Copying 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.

...

The following folders must be copied from your backup towards to 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.
  • /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 class name, adding the "Core" suffix. For instance, "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 and "DB_PASSWD" too.

Moving the "prestashop" folder to your FTP server

...

Warning
titleCaution

If the folder of your online store is already named "prestashop", rename the folder "prestashop" folder on your hard drive to something else before sending it onto your FTP server.

...

Tip
titleDid you follow these 5 steps?
  1. Downloaded and extracted PrestaShop
  2. Unzipping the downloaded .zip file
  3. Manual copy of the folder of step 2.B
  4. Transfer the whole directory "prestashop" onto your FTP
  5. The line Edited the PS_BASE_URI of line from the files config/settings.inc.php should show the name of the transferred folder FTP (should be "prestashop") file

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

...

Launching the update script

Visit your shop's install script URL, ; for instance: http://www.myprestashop.com/prestashop/install (Replace "myprestashop.com" with the actual URL of your store, and "prestashop" with the name of the folder that you have just transferred to your FTP).

...

If not, make sure that the folders' rights are properly configured: change their permissions the access rights of the folders marked in red in the install/update tool, directly on your FTP server (make a CHMOD 755 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.

...

Warning
Caution
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 or close your browser; wait for the update to be completed.

...

  • The {{/install} folder (this subfolder contains the update tools).
  • The README files (contain information about the installationPrestaShop install).
  • The CHANGELOG file (contains information about the latest changes in PrestaShop).

...

Tip
titleDid you follow these 3 steps?
  1. Launched the Update tool
  2. Verified the parameters and started the update
  3. Finished the installation and removing the unneeded folders and files.

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

Step 4 - QA and Testing

Import your

...

Translations

If you did export your own custom translations during step 1 (Backups), import them back into your new store by going to the "Tools" tab, then the "Translations" sub-tab.

...

You must check the following information:

  • "PS directory": this 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.

...

You can verify your theme's compatibility with the updated PrestaShop version by visiting the " theme validator " developed by PrestashopPrestaShop.

This tools tool 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.

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:.

Tip

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, PaypalPayPal, 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 every test is successful, congratulations! Proceed to step 5.

...

Warning

At the end of the process, edit the file config/settings.inc.php: look for the line containing PS_BASE_URI, and replace its value (should be "/prestashop/") by "/" (or wherever your current store is at). If you don't do that, your images and theme will not appear correctly.

...

Visit the "Preference" tab in the back-office of your production (now up-to-date) store and click "Yes" for the option "Enable Shop".

...

  • Import your backed up data via phpMyAdmin
    This is typically done by the database tools provided to you by your hosting provider, most often phpMyAdmin.
    You will find the backup data under the /admin/backups folder.
    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 hosting 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 nackup and download it to your computer by clicking on it. It should typically take between 1 and 20 minutes to download.

...