There are a couple of ways to upgrade PrestaShop. There is a one-click upgrade module available for PrestaShop v1.4.4 and later that will automatically back up and then upgrade PrestaShop. For previous versions, the PrestaShop Installer must be used to upgrade PrestaShop.
Automatically upgrading PrestaShop
To automatically upgrade PrestaShop to the latest version, click the Modules tab in the Back Office. The 1-Click Upgrade – AutoUpgrade module should appear at the top. If it doesn’t, download the module from the PrestaShop Addons website here.
Click the Install button if the module isn’t already installed and then click the Configure link. At the top of the configuration page is a warning to manually perform a full backup of the files and database and a pre-upgrade checklist.
Although the module will automatically perform a backup, it is better to have a full backup that is known to work in case the automatic backup fails. Learn how to backup files using cPanel File Manager here and how to back up the database using phpMyAdmin here.
If there is an error on the pre-upgrade checklist, use the table below to solve it.
|The 1-click upgrade module is up-to-date||Click the Update it! button on the module’s listing on the Modules tab or manually download the latest version from PrestaShop Addons|
|Your store root directory must be writeable||Make sure the root directory is chmod 755|
|The PHP “Safe mode” option must be turned off||Add
|The PHP “allow_url_fopen” option must be turned on or CURL must be installed||Add
|You must put your store under maintenance||Click the button to put the shop under maintenance|
|You must disable the Caching features of PrestaShop||Go to the Performance subtab of the Advanced Parameters tab, click the X in the Caching section to disable caching and then click the Save button|
|The PHP time limit must be either high or disabled||Add
At the bottom of the configuration page are backup options and upgrade options. In the Backup Options section, choose whether to automatically back up the files and database and whether to include the
img directory in the backup.
Remember that the backup feature is still experimental, so a manual backup is still required. If a manual backup has been made, these settings can be changed to No to save time. Click the Save button to save changes.
In the Upgrade Options section, there are options to choose what to overwrite when upgrading. The Server performance option can be used to upgrade faster, but only when using a dedicated server. Leave it on Low (recommended) when using a shared server.
The Disable non-native modules option can be used to choose whether third-party module should be disabled after upgrading. If there are third-party modules installed that may not be compatible with the latest version of PrestaShop, choose Yes to ensure the Module tab loads properly after the upgrade.
The Update the “default theme” option can be used to choose whether the default theme is overwritten during the upgrade. If the default theme was customised instead of being copied like it should have, choose No or copy the customised theme to a different directory.
The Upgrade the default e-mails option can be used to choose whether email templates are overwritten during the upgrade. If these email templates have not been customised, choose Yes to overwrite them with the latest templates. Click the Save button to save changes.
When all the items in the pre-upgrade checklist are ticked, an Upgrade PrestaShop now! button will appear in the Start your Upgrade section. The current PrestaShop version and latest known version are listed.
If the latest known version is outdated, click the refresh the page button to check for the latest version. Click the open changelog in a new window link to view a list of bug fixes included in the update. By default, the latest stable version of PrestaShop will be downloaded from the PrestaShop website.
To download an experimental build or use an archive from the local server instead of the PrestaShop website, click the More options (Expert mode) button. Choose whether to upgrade to major releases, minor releases, release candidates, beta releases or alpha releases.
Users who have been sent access to a private release can choose the Private release (requires link and md5 hashkey) option and then enter the link and MD5 hashkey from their email and choose whether to allow major upgrades.
To install files from the local server instead of the PrestaShop website, choose Local archive and then select a ZIP file from the
modules/autoupgrade/download directory. Choose Local directory to install the extracted files in the
modules/autoupgrade/latest/prestashop directory and enter the PrestaShop version number of the files. Click the Save button to save changes.
Before upgrading, check the Version comparison section to make sure no core files have been modified. If files have been correctly overridden, there should be no modifications to core files. Learn more about overriding files here.
Click the first See or hide the list button to see a list of modified core files. If there are core files listed, check the files and make a note of what was changed so the changes can be made again in the upgraded files. Click the second See or hide the list button to view a list of all files that will be overwritten during the upgrade.
When ready to upgrade, click the Upgrade PrestaShop now! button in the Start your Upgrade section to begin upgrading. An Activity Log is displayed as the latest version of PrestaShop is downloaded, the store is backed up and files are replaced.
If it is, change the Enable shop setting on the Preferences > Maintenance tab to Yes to enable the shop. If it isn’t, try to fix whatever has gone wrong or return to the 1-Click Upgrade – AutoUpgrade module configuration page, choose a backup and then click the Rollback button to restore the backup.
Manually upgrading PrestaShop
If the 1-Click Upgrade module is unavailable, PrestaShop will need to be manually upgraded. Note that the manual upgrade feature is not supported in the latest version of PrestaShop, so the shop must be manually upgraded to PrestaShop v1.4.4 and then automatically upgraded to the latest version of PrestaShop.
Backing up the files and database
Before manually upgrading PrestaShop, it is very important to create a backup of the files and database. Learn how to backup files using cPanel File Manager here and how to back up the database using phpMyAdmin here.
Check to make sure the backups and include all files and database tables. If any the default PrestaShop translations have been changed, go to the Tools > Translations tab and then use the Export a language section to export the translations of each theme.
Merging the files
After backing everything up, download PrestaShop v1.4.4 here. Extract the PrestaShop archive to a folder on the computer. Copy the
config/settings.inc.php file from the backup to the new PrestaShop folder.
This file gives the PrestaShop Installer the information it needs to perform the upgrade. If the mail templates have been customised, copy the
mails folder from the backup into the new directory and overwrite the files. To add the store’s logo and catalogue images, copy the
img folder from the backup into the new PrestaShop folder and overwrite the files.
Copy over third-party modules from the backup
modules folder to the new PrestaShop folder. Copy over all the themes except for the default theme from the backup
themes folder to the new PrestaShop folder. If the default theme was customised, rename it to something else before copying it over.
If the store has downloadable products, copy the backup
download folder to the new PrestaShop folder and overwrite the files. If the store has product attachments, copy the backup
upload folder over too. If the backup includes customised classes, copy them over to the
classes folder, edit each of the copies and add
Core to the end of the class name inside the file if it doesn’t already have it.
The new PrestaShop folder should now contain all the customised files from the backup.
Uploading the files
To prevent customers using the website during the upgrade, go to the Preferences > Maintenance tab and then change Enable Shop to No, click the Add my IP button and then click the Save button.
Now that the website is unavailable to customers, upload the new PrestaShop files to the server. The fastest way is to compress the new files as a ZIP file and then use cPanel to extract them on the server. Learn more about cPanel File Manager here.
Running the PrestaShop Installer
After uploading the files, navigate to http://www.domain.com/install to run the PrestaShop Installer. By default, the PrestaShop Installer is displayed in English. In the Choose your language step of the installer, there are options to switch the installer to French, Spanish, German and Italian.
Changing the installer language will not affect the languages of the PrestaShop store. The store languages are configured after installation. Make sure that the Update radio button is selected, tick I agree to the above conditions and then click the green Next button to go to the next step.
In the Disclaimer step, tick the I certify that I backed up my database and application files checkbox. By default, third-party module will be disabled so the Modules tab can properly load after the upgrade.
Untick Ok, please desactivate the following modules, I will reactivate them later if the third-party modules are known to work in PrestaShop v1.4.4. A list of upgrade files are displayed along with an estimate of how long the upgrade will take.
There is also a list of the current maximum execution time and memory limit. Increase the
memory_limit values in
php.ini if needed and then click the green Next button to go to the next step.
The System Compatibility step displays a checklist of required and optional PHP settings. If any of these have a cross instead of a tick, see the green box on the page here for advice on how to fix them. Click the green Next button to continue.
The PrestaShop Installer will then upgrade the PrestaShop database. When the upgrade completes, the message Your shop version is now 188.8.131.52 will display along with a View the log link.
Below that is a list of new features, a link to the Front Office and links to view modules and themes on PrestaShop Addons. Now that PrestaShop has been successfully upgraded, delete the install folder for security purposes.