The module's configuration screen is available from the "Modules" list, by clicking on the module's "Configure" link.
In PrestaShop 1.4, the The configuration screen is also available from:
The configuration screen presents you with a series of sections, providing information, tools and settings.
- Channel. Choose the distribution channel that you want to use. The recommended selection is "Minor releases", which means "any stable release above the current one". The other options are:
- Major releases. Only major stable releases above your own: 1.3, 1.4, 1.5, etc.
- Release candidates. RC versions are deemed stable enough to be tested by the majority, but not stable enough to be the real release. Use at your own risks.
- Beta releases, alpha releases. These are development versions. Use at your own risks.
- Private release. Sometimes, the PrestaShop developers upload a private test version. If you have the right URL and hash key, you can update to this version easily using this channel. If you check the "Allow major upgrade" box, you indicate that are only interested in major releases.
- Local archive. To be used if you have downloaded the version you want to upload upgrade to in the correct local folder,
/admin/autoupgrade/download. Once you have selected archive in the drop-down selector, indicate the version number in the text field (be very exact!).
- Local directory. To be used if you have downloaded and uncompressed the version you want to upload upgrade to in the
/prestashopfolder must come directly from the archive that you downloaded.
- branch. Indicates if anything is available in the chosen channel.
- name. The name of the latest version in the chosen channel.
- url. The URL to the latest version in the chosen channel.
- md5. The hash check for the latest version in the chosen channel.
- Module version up-to-date (0.6.1-devversion). Indicates whether you need to update the update module itself. If you have just installed it, there is little chance you will need to update it.
If you do not have the latest version of the module, a button appears below this field, marked "Install the latest by clicking 'Add from my computer'". Clicking it takes you to the "Modules" page. From there, click on the "Add a module from my computer" link to reveal the pre-filled form. Click the "Download this module" button to start updating the module. Finally, go back to the 1-Click Upgrade configuration page to continue performing pre-upgrade checks.
- Root directory is fully writable. Indicates if the read/write permissions are correctly set. If not, you will have to change them, using your FTP client, such as FileZilla.
See the Getting Started guide's "System compatibility & system configuration" section for a quick explanation of how to perform a CHMOD.
- Shop deactivated. Indicates if your shop is active or in maintenance mode. You must put your shop in maintenance mode during the whole process (file backup, database backup, automatic upgrade, verification), so as to prevent customers from losing orders... and you from losing clients. The module will not disable your shop for you, but does provide a button leading to the shop preference page:
- PrestaShop 1.4: enable/disable the shop in the main "Preferences" tab.
- PrestaShop 1.5: enable/disable the shop in the "Maintenance" page, under the "Preferences" menu.
- Cache deactivated. Indicates whether your shop's cache is enabled or disabled. You must disable it during the whole process. The module will not do it for you.
- PrestaShop 1.4: enable/disable the cache in the "Performances" page, under the "Preferences" tab.
- PrestaShop 1.5: enable/disable the cache in the "Performance" page, under the "Advanced parameters" menu.
- PHP time limit: disabled. The automatic upgrade can be a lengthy process, as it needs to download the archive from prestashop.com, unzip it on the server, replace the currently installed files, then trigger the update itself. Hence, the PHP settings might be too low, and break the upgrade altogether, mid-process at worse. In this field, PrestaShop gives you an indication of the current PHP settings. Ideally, it should indicate "disabled".
- Options chosen. Before launching the upgrade, you must make sure that you understand the settings. The "Backup options" and "Upgrade options" sections are available at the bottom of the page, and if the settings have not yet been saved, a button takes you to them.
PrestaShop's own backup files are saved on your server, and if it turns out your update has gone badly, you can find them in the "Rollback" section of the configuration page for the 1-Click Upgrade module.
Backup files are created as soon as the upgrade process is started, and are available immediately in the "Choose your backup" drop-down list.
Choose the most recent one. The date and hour of the creation of the backup file is right within the name:
Vversion-date-hour-random, for instance "V22.214.171.124_20120907-114024-f85f41a" for a backup of a previous PrestaShop 1.4.9 installation, made September 7th 2012, at 11:40:24 AM.
The "Rollback" button triggers two actions: