| Step Description | Expected result |
|---|---|
| Install A fresh last version of prestashop with php 8.1 | You should have the selection of where in your shop you want to go ( BO or FO ) |
| Go to the BO | You should have your dashboard showed |
| Go to the Module Manager " page" | Module Manager page is displayed correctly |
| * Search for the “update assistant” module. * Install it |
* Update assistant should have “The Update Assistant module helps you backup, update and restore your PrestaShop store. With just a few clicks, you can move to the latest version of PrestaShop with confidence.” as description * Module is correctly installed |
| Go to the General Parameters > Maintenance" page. Put the shop in maintenance mode" | Maintenance page is displayed correctly. Maintenance mode is activated |
| Set your “Maintenance IP” by clicking the button “+ Add my IP” and clic on “Save” button | Your IP should be setted on the field and you will have the green notification |
| * Go to the update assistant page | * You should see the configuration page of the module with a little problem on UI |
| * Open a terminal in your folder [yourshop]/modules/autoupgrade * launch the command : {code:java} cd _dev{code} * Launch the command : {code:java} npm install{code} * Launch the command : {code:java} npm run vite:build{code} * Launch the command : {code:java} cd ..{code} * Launch the command : {code:java} composer install{code} |
* A terminal is open in the right folder * You should be in the folder [yourshop]/modules/autoupgrade/_dev * Npm should be installed in your folder with this last word : “Run npm audit for details."* The terminal should say some files have been modified * You should return on the folder [yourshop]/modules/autoupgrade/ * You terminal will say “Nothing to install, update or remove” |
| * Return on the “Updrate Assistant” page | * You should be in the new UI page with : ** the title “Welcome to PrestaShop Update Assistant” ** Two radio button with : Update your store and Restore from a backup ** Radio button with the Restore should be disabled except if you have a backup ** A button “Get started” disabled |
| Clic on the radio button next to “Update your store” | * Your radio button should be checked * the button “Get starder” should be Enabled |
| Click on the button “Get started” | * You should have an image that show the load on the button get started until the load of the next page * You should be on a new page named “Version choice” * You should have a stepper on top of the page set on “1 : Version choice” * In the page, it should be : * ** A picture of a folder like in the attachment with a green notification “You’re up to date” and “Current PrestaShop version: [yourLastPrestaVersion] Current PHP version: [YourPHP] “ ** A blue notification with " Unlock the local update feature and manually update your store to your preferred upgrade by saving the archive and XML files of the PrestaShop version in the following directory on your server: /your-admin-directory/autoupgrade/download/" ** * ** A button named “Next” disabled |
| * Put a zip and xml from a new version in [yourshop]/[adminfolder]/autoupgrade/download | * It should have a zip, an xml and an index.php files in your folder |
| * Put another zip and xml from a new version in [yourshop]/[adminfolder]/autoupgrade/download | * It should have two zip, two xml and an index.php files in your folder |
| * Return on your prestashop and reload the page | * You shouldn’t have the image but you still have a green notification “You’re up to date” and “Current PrestaShop version: [yourLastPrestaVersion] Current PHP version: [YourPHP] “ * You should have : “You are already using the latest PrestaShop version available but you can update to the version of your choice from a local archive. “ * You should have a Radio button with “Local archive” in title and “Save the archive file of the version you want to update to in the following directory: /your-admin-directory/autoupgrade/download/ " in description |
| * Clic on the Radio button next to “Local archive” * Clic on the first drop list * Select your zip folder * Clic on the second drop list * Select the secon xml folder |
* You should have two drop list : ** One with title : “Archive to use*” and in the drop list “Select an archive” ** One with title : “XML file to use*” and in the drop list “Select a file” * You still have “Select an archive” selected and you have the zip name that you drop on your foler * In the drop list, you should have the name of your selected zip * You still have “Select a file” selected and you have the xml name that you drop on your foler * In the drop list, you should have the name of your selected xml and the checking requirement should be started |
| * The check is finished | * You should have a yellow advertising with “The PrestaShop version in your archive doesn’t match the one in XML file. Please fix this issue and try again. “and the button “Next” should still be disabled |
| * Clic on the first drop list * Select your zip folder * Clic on the second drop list * Select your xml folder |
* You still have “Select an archive” selected and you have the zip name that you drop on your foler * In the drop list, you should have the name of your selected zip * You still have “Select a file” selected and you have the xml name that you drop on your foler * In the drop list, you should have the name of your selected xml and the checking requirement should be started |
| * The check is finished | * You should have some warning like “We were unable to check your PHP compatibility with PrestaShop [PrestashopVersionAimed] “and the button “Next” should be enabled |
| * Clic on the “Next” Button | * You should be on the “Update option” page with : ** The stepper set on 2 : Update options ** 3 checkbox named " Deactivate non-native modules “, “Regenerate email templates” , " Disable all overrides " with details about them under there name ** “Next” Button enabled |
| Clic on the “Next” Button | * You should be on the “Back up your store” page with : ** The stepper should be on 3 : Backup ** sub title “Backing up your store’s files, database, and images means you can restore to a previous version if something goes wrong during the update. This keeps your data safe and ensures your business stays up and running." ** Checkboxe : “Include images in your backup” ** 2 buttons : “Update without backup” and “launch backup” |
| Click on “Launch Backup” | You should have a modal with * title : " Start backup? “ * Sub title : “Your files, database, and images will be backed up." * 2 button : “Cancel” and " Start Backup |
| Click on the cross or elsewhere the module | The modal should be close and you ’ll be on the page “Back up your store” |
| Click on “Update without backup” | You should have a modal with * title : " Start update? “ * Sub title : “Before starting the update, make sure you have a complete and recent backup of your store (database, files, and images)." * a Check box : “I have made my own backup and can restore it manually if a problem occur." * 2 button : “Cancel” and " Start update”, the last one is disabled |
| * Click on the checkbox “I have made my own backup (…)” * Click on the cross or elsewhere the module |
* The button “Start Update” should be enabled * The modal should be close and you ’ll be on the page “Back up your store” |
| Click on “Launch Backup” | You should have a modal with * title : " Start backup? “ * Sub title : “Your files, database, and images will be backed up." * 2 button : “Cancel” and " Start Backup” with a little icon on start backup |
| * Click on “Start Backup” | * You should be on the page “Backup” with : ** The current process writted ** a load bar ** The details of the current process on a second tab |
| Wait until the end of the backup | You should have be on a new page with * title : " Back up your store” * A green notification : “Backup completed” * A link : “Download backup logs” * 1 button : “Start Update”” |
| Click on Download backup logs | The download of the backup on txt should be launched by your bowser |
| Click on “Start Update” | You should have a modal with * title : " Start Update ? “ * Sub title : “You are about to launch the update, do you want to continue?" * 2 button : “Cancel” and " Start Update " the last button should have a picture of a rocket on it |
| * Click on “Start Update” | * You should be on the page “Update” with : ** The stepper should be on 4 : Update ** The current process writted ** a load bar ** The details of the current process on a second tab |
| Wait until the end of the update | You should have be on a new page with * title : " Post-update checklist “ * Stepper should be on “5 : Post-update” * A green notification : “Your store is up to date” * Sub title : “Next step” and Troubleshooting * A link : “Download update logs” * 2 button : “Exit” and " Open developer documentation” |
| * Click on “Download update logs” * Click on “Open Developper Document” * You can close the new tab showed |
* The download of the update on txt should be launched by your bowser * A new tab should be open with the name “Post-update checklist” * You’ll return on the post-update checklist |
| Click on the button “Exit” | * You should be redirected to “[admin_folder]/index” * Prestashop ask you to log in |
| * Set your connection information * click on log in |
* Your information should be set up * You should be on the dashboard with the new version number of prestashop in the top left, just after the word Prestashop |