| Step Description | Expected result |
|---|---|
| Install A fresh 8.0.4 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 paragraph with “A more recent version is available / Current PrestaShop version: 8.0.4/ Current PHP version: 8.1 * ** Two radio button with : “Prestashop [last major/minor version]” and “Local Archive” *** Prestashop 8.2.1[Minor version] With description “The maximum version of PrestaShop to which you can update your store, based on its PHP version. " and a button “Release note” *** if you don’t have a local archive set, you didn’t have a radio button and you should have 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 |
| * Reload the update page | * It should have the local channel loaded |
| on the link of the page, replace “route=update-page-version-choice” by “route=update-page-update-options” | You should be redirected to the same page : Update “Version Choice” |
| * Clic on the Radio button next to “Prestashop [last version]" * The check is finished |
* the checking requirement should be launched * You should have a green notification with “The requirements check is complete, you can update your store to this version of PrestaShop.” or maybe some warning and the button “Next” should be enabled |
| on the link of the page, replace “route=update-page-version-choice” by “route=update-page-update-options” | You should be redirected to the page : “Update Option” |
| Click on the previous button of your bowser | You should be redirected to Update “Version Choice” page with the online channel set |
| * 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 some warning like “We were unable to check your PHP compatibility with PrestaShop [PrestashopVersionAimed] “and the button “Next” should be enabled |
| on the link of the page, replace “route=update-page-version-choice” by “route=update-page-update-options” | You should be redirected to the same page : “Update Option” |
| * Delete the zip or the xml linked to version aimed from [yourshop]/[adminfolder]/autoupgrade/download * Reload the current page |
* The file should be deleted * you should be redirected to the Update “Version Choice” page with local channel set and with one of the xml or zip only |
| * Delete the “update_config.var” files from [yourshop]/[adminfolder]/autoupgrade * Reload the current page |
* The file should be deleted * you should be redirected to the Update “Version Choice” page with none radio button selected |
| on the link of the page, replace “route=update-page-version-choice” by “route=update-page-backup-options” | You should be redirected to the same page : Update “Version Choice” |
| * Clic on the Radio button next to “Prestashop [last version]" * The check is finished |
* the checking requirement should be launched * You should have a green notification with “The requirements check is complete, you can update your store to this version of PrestaShop.” or maybe some warning and the button “Next” should be enabled |
| on the link of the page, replace “route=update-page-version-choice” by “route=update-page-backup-options” | You should be redirected to the page : “Back up your store” |
| Click on the previous button of your bowser twice | You should be redirected to Update “Version Choice” page with the online channel set |
| * 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 some warning like “We were unable to check your PHP compatibility with PrestaShop [PrestashopVersionAimed] “and the button “Next” should be enabled |
| on the link of the page, replace “route=update-page-version-choice” by “route=update-page-backup-options” | You should be redirected to the page : “Back up your store” |
| * Delete the “update_config.var” files from [yourshop]/[adminfolder]/autoupgrade * Reload the current page |
* The file should be deleted * you should be redirected to the Update “Version Choice” page with none radio button selected |
| * 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 some warning like “We were unable to check your PHP compatibility with PrestaShop [PrestashopVersionAimed] “and the button “Next” should be enabled |
| on the link of the page, replace “route=update-page-version-choice” by “route=update-page-backup-options” | You should be redirected to the page : “Back up your store” |
| * Delete the zip or the xml linked to version aimed from [yourshop]/[adminfolder]/autoupgrade/download * Reload the current page |
* The file should be deleted * you should be redirected to the Update “Version Choice” page with none channel set because local channel aren’t showed |
| Do the process of an upgrade until the end of the upgrade | 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” |
| * Reload the page * Set up your mail and password * on the link of the page, replace “route=home-page” by “route=update-page-post-update” |
* Prestashop should ask you to be loged in * You should be redirected to the “Welcome to PrestaShop Update Assistant” page * You should be redirected to the “Post-update checklist” |
| * Delete the last “[…]-update.txt” files from [yourshop]/[adminfolder]/autoupgrade/logs * Reload the current page |
* The file should be deleted * you should be redirected to the “Welcome to PrestaShop Update Assistant” page |
| Do the process of an upgrade 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 the Update assistant on the sideboard * Click on Restore from a backup * Click on Get started |
* You should be redirected to the “Welcome to PrestaShop Update Assistant” page * The radio button should be checked next to the restore part and the button Get started should be enabled * You should be redirected to the “Backup selection” page |
| * Click on the drop list * Select the second backup * Reload th page |
* You should have two backup on the list * The drop list should close and the name of the second backup should be on the drop list * You should be redirected to “Backup selection” with the second backup on the drop list |
| * Delete the “restore_config.var” files from [yourshop]/[adminfolder]/autoupgrade * Reload the current page |
* The file should be deleted * You should be redirected to “Backup selection” with the first backup on the drop list |
| on the link of the page, replace “route=restore-page-backup-selection” by “route=restore-page-restore” | You should be redirected to the page : “Backup selection” |
| * Click on the drop list * Select the second backup * On the link of the page, replace “route=restore-page-backup-selection” by “route=restore-page-restore” |
* You should have two backup on the list * The drop list should close and the name of the second backup should be on the drop list * You should be redirected to the page : “Restore” page |
| * Wait until the end of the Restore * Reload the page |
* You should be on the “Post-restore checklist” page * You still be on the “Post-restore checklist” page |
| * Delete the last “[…]-restore.txt” files from [yourshop]/[adminfolder]/autoupgrade/logs * Reload the current page |
* The file should be deleted * you should be redirected to the “Welcome to PrestaShop Update Assistant” page |
| * Click on Restore from a backup * Click on Get started |
* The radio button should be checked next to the restore part and the button Get started should be enabled * You should be redirected to the “Backup selection” page |
| Delete the two different backup | You should have two different modal : * One to inform you that you will delete the backup * The other one to inform you that you will delete the backup and you’ll be redirected to the welcome page After the deletion, you’ll be redirected to the “Welcome to PrestaShop Update Assistant” page |
| On the link of the page, replace “route=home-page” by “route=restore-page-backup-selection” | You should be redirected to “Welcome to PrestaShop Update Assistant” page |