Page History

...

1. Save and Backup Your Current Store
   • Deactivate your store ("Maintenance" page of the "Preferences" menu).
   • Back up your files to your desktop, using your FTP client.
   • Back up your database ("Advanced Parameters/DB Backup" page, or using phpMyAdmin).
   • Back up your customized translation ("Export a language" section in "Tools/Translations" tab).
2. Getting ready for the new version
   • Download and unzip the latest version of PrestaShop: http://www.prestashop.com/en/download.
   • Copy the files that you backed up during Step 1 to the "prestashop" folder in your desktop.
   • Transfer the "prestashop" folder from your desktop to your FTP server (keeping your original files intact for now).
   • Checks to perform before going any further:
     1. Edit the config/settings.inc.php file and change the __PS_BASE_URI__ to match to the /prestashop/ folder that you just uploaded. Change others settings as needed.
     2. Access the /prestashop/ folder with your browser and check that everything works fine before going to the next step.
     3. Access the back-office.
3. Starting the Update
   • Launch the update script by accessing it with your browser. In version 1.5, it is located at /install/upgrade/upgrade.php.
   • Verification of all parameters before the update: follow the instructions on screen and make sure your server conforms to the new version technical requirements.
   • Finishing the update: once the updater has finished, delete the /prestashop/install folder and access both your front and back-office to make sure it works.
4. QA and Testing
   • Import your translations ("Import a language pack manually section in "Localization/Translations" page).
   • Check that the main domain name is correct ("Preferences / SEO & URLs" page, "Shop URL" section).
   • Regenerate your robots.txt files ("Preferences / SEO & URLs" page, "Generate robots.txt" section).
   • Check that your theme still works as expected. If not, you will have to edit its files.
   • Test your store thoroughly: create accounts, buy products, cancel orders, check invoices, etc.
5. Going live with your up-to-date store
   • Swapping your updated store and your production store: your store is updated and fully functional in the /prestashop folder, and your older store is deactivated at its normal URL. They both have the same content: products, pages, images, theme, modules, etc. It is time to swap the two. Either:
     • Move all files from /prestashop to the normal URL, replacing the old files with the new ones.
     • Upload your files from your desktop to the old version's URL, replacing the old files with the new ones.
     • Move the old files to a new folder (i.e. /oldshop) and move the updated store from the /prestashop folder to the normal one.
   • Activate your store ("Maintenance" page under the "Preferences" menu).

...

• /mails. Has all the mails templates, including those that you have modified.
  If you have never made any mail template modification, do not worry about this folder.
• /img. Contains your logo and all the pictures of your store (categories, products, etc.). Copy these specific files and folders:
  • logo.jpg - your store's logo
  • favicon.ico - your store's favicon
  • logo_stores.gif - your store's logo for the Store Locator's map
  • /c - your categories' images
  • /cms - your CMS page's images
  • /co - your attributes textural colors
  • /m - your manufacturers' logos
  • /p - your products pictures
  • /scenes - your categories' image-maps
  • /st - your physical stores' photos
  • /su - your suppliers' logos
  • ...basically, copy all folders except /img/admin and /img/jquery-ui.
• /modules. Only copy the modules that you have added to the default installation.
• /themes/themeName. Only copy your current theme. If you use the default theme from PrestaShop (unchanged), do not copy it, you must use the one from the new version. If you have made changes to the default it, do copy this folder, but rename the folder to something else, do not keep the /default name as-is.
• /download and /upload. 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. In case you have added customized classes to this folder, copy them to the new /classes folder.

  Tip

  When updating from a version below 1.4, you must manually edit these classes. You do not have to edit classes that you didn't customize. In order to function properly with the latest version of PrestaShop, all these class files need to have their class name suffixed with "Core". Do not attempt these if you are not comfortable with PHP files. Here is how to you should edit the customized files that you want to keep: Open each and every one of the class files, and find the ones where the class name is not Core-suffixed. If you are upgrading from PrestaShop 1.4.x, you shouldn't have any (except for custom classes). Rename the class name, adding the "Core" suffix. For instance, "MyClass" becomes "MyClassCore". Only change the name in the PHP class within file, not the name of the file itself! If all the files already have "Core" in their classname (such as "class AttributeCore extends ObjectModel"), then you do not need to change anything. Save the edited files.

• /config folder. You only have to copy one file, but it is essential. Take the settings.inc.php file (not config.inc.php), copy it to the /prestashop/config folder (it should not already have one. ; if it has, you might already have installed , 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 the name of current folder for your current store.
If you PrestaShop on this server), then if you modified your database credentials (you should not have had to do that normally), update or double-check all the lines that contain "DB_SERVER", DB_NAME", "DB_USER" and "DB_PASSWD" too.

Moving the "prestashop" folder to your FTP server

...

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: Code Blockhtmlhtml

   
   define('__PS_BASE_URI__', '/');
   

   ...was replaced by... Code Blockhtmlhtml

   
   define('__PS_BASE_URI__', '/prestashop/');
   

   (or any correct folder name for your own setting).You uploaded your "prestashop" folder to your FTP server, and it can be accessed at: http://www.your-shop-url.com/prestashop (it should return a blank page, not an error message).

Step 3 – Starting the Update

...

• You can also download your whole updated store's /prestashop folder 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.

Activating your store

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

...