| Step Description | Expected result |
|---|---|
| Install a fresh 8.0.4 with php 8.1 | * The new shop is installed * The selection to BO or FO is displayed |
| Go to the BO. | Log in page is displayed. |
| Log in with email and password set during installation. | * Connection successful * Dashboard displayed |
| Go to Modules > Module manager. | Module manager page is displayed. |
| Click on the CTA “Upload a module”. | Modal “Upload a module” is displayed. |
| Select or drag and drop the .zip. | * The module is installing * The module is installed, the CTA “Configure” is displayed. |
| Close the modal. | * Modal is closed * Module manager page is displayed |
| Refresh the page. | Page is refreshed. |
| Search for “Update”. | Update Assistant is displayed. |
| Check for the version. | * The version is the latest in prod. * The lastest version in prod is displayed because it is the version available on the marketplace. |
| Go to the Shop Parameters > General. | General > Preferences page is displayed on the “General” tab. |
| Click on the “Maintenance” tab. | “Maintenance” tab is displayed. |
| Click on the toggle “Enable store” | Toggle is in “No” status. |
| Click on the CTA “Add my IP”. | IP address is filled. |
| Click on the CTA “Save”. | Shop is in maintenance mode. |
| Go to the folder [yourshopname_folder] > modules > autoupgrade > upgrade. | Files named upgrade […].php are present and +none+ instead of install[…].php. |
| Open the file [yourshopname_folder] > modules > autoupgrade > classes > Task > Update > Download.php. | File is opened. |
| In the function “public function run”, add “throw new Exception(“Brique”);” and save the folder. | File saved with modifications. |
| Go to “Update Assistant” module (side board). | * “Update Assistant” module is displayed : ** Title : “Welcome to PrestaShop Update Assistant” ** Two radio buttons : “Update your store” and “Restore from a backup” (disabled) ** CTA “Get started” disabled |
| Select the radio button “Update your store”. | * “Update your store” radio button is selected * CTA “Get started” is enabled |
| Click on the CTA “Get started”. | * A loader is displayed in the CTA “Get started” then, “Version choice” page is displayed : ** Stepper on step one (“Version choice”) ** Paragraph with “A more recent version is available / Current PrestaShop version: 1.7.8.9 / Current PHP version: 7.1.xx ** Radio button : PrestaShop 1.7.8.xx [Patch version](blue color rgb(190, 234, 243)) with description “The maximum version of PrestaShop to which you can update your store, based on its PHP version.” and the link “Release note” ** Blue alert info : " 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/" ** CTA : “Next” disabled |
| * Clic on the Radio button next to “Prestashop [last version]" * The check is finished |
* Checking requirement is launched then is finished : ** “The requirements check is complete, you can update your store to this version of PrestaShop." ** Or warnings ** CTA “Next” is enabled |
| * Click on the CTA “Next”. | * “Update options” page is displayed : ** Stepper on step 2 (“Update options”) ** 3 toggles : “Deactivate non-native modules”, “Regenerate email templates” , “Disable all overrides” with details about them under their name ** CTA “Next” enabled |
| Click on the CTA “Next”. | * “Back up your store” page is displayed : ** Stepper on step 3 (“Backup”) ** Subtitle “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." ** Toggle : “Include images in your backup” on Yes status ** 2 CTAs : “Update without backup” and “Launch backup” (both available) |
| Click on the CTA “Launch backup”. | Modal “Start backup?” is displayed : * Text : “Your files, database, and images will be backed up." * 2 CTAs : “Cancel” and “Start backup” |
| * Click on the CTA “Start Backup”. | * The “Backup” page is displayed : ** loading bar with the current process ** details of the current process are listed |
| Wait until the end of the backup | The title is modified : " Back up your store” : * The success alert “Backup completed” is displayed * CTA “Download backup logs” * CTA : “Start update” |
| Click on the CTA “Start update”. | The modal “Start Update?” is displayed : * Text : “You are about to launch the update, do you want to continue?" * 2 CTAs : “Cancel” and “{color:#0747A6}cutest rocket{color} Start Update " (both enabled) |
| Click on the CTA “{color:#0747a6}cutest rocket {color}Start update”. | Update is launched but the update fail : * Yellow warning alert : “Update failed”, description : “Your store may not work properly anymore. Select the backup you want to use and restore it to avoid any data loss.”, CTA “Restore” * At “Step dowload” 3 errors : ## “Exception: Brique” ## “It seems there was an issue with the server. This type of error usually happens when […]" ## " HTTP request failed. Type: ERR_BAD_RESPONSE - HTTP Code: 500” * Composant “Error Summary” with the 3 errors with a link “See error” for each * 3 CTAs : “Download update logs”, “Send error report” and “Restore” |
| Click on the link “See error” of the first error “Exception: Brique”. | The error in the list is displayed and highlighted in a darker grey for 2 seconds. |
| Click on the CTA “Download update logs”. | The download of the YYYY-MM-DD-HHMMSS-update.txt is launched by the browser. |
| Click on the CTA “Send error report”. | Modal “Send error report?” is displayed : * Title : “Send error report?" * Text : “Help us improve the module by sending us this error report. For your information, the logs will be attached with your message. You can add more details in the description if you wish." * Link : “Learn more about your data and your rights” * 3 fields : ** “Error message” (disabled) ** “Email (optional)” (enabled) ** “Description (optional)” (enabled) * 2 CTAs : “Cancel” and “Send error report” |
| Click on the link “Learn more about your data and your rights”. | Page “Data transparency” is displayed in a new tab. |
| Close the tab. | Module tab is displayed. |
| Click on the “Email (optional)” field. | The “Email (optional)” field is highlighted. |
| Click on the “Description (optional)” field. | * The “Email (optional)” field is not highlighted anymore * The “Description (optional)” field is highlighted. |
| Click on : * the cross * or the CTA “Cancel” * or outside the modal. |
The modal is closed. |
| Click on the CTA “Send error report”. | Modal “Send error report?” is displayed : * Title : “Send error report?" * Text : “Help us improve the module by sending us this error report. For your information, the logs will be attached with your message. You can add more details in the description if you wish." * Link : “Learn more about your data and your rights” * 3 fields : ** “Error message” (disabled) ** “Email (optional)” (enabled) ** “Description (optional)” (enabled) * 2 CTAs : “Cancel” and “Send error report” |
| * Fill “Email (optional)" * Fill “Description (optional)” |
Fields filled. |
| Click on the CTA “Send error report”. | Modal is closed. |
| Open the link on a new tab : [https://prestashop.sentry.io/feedback/?feedbackSlug=autoupgrade-module%3A6504514401&mailbox=ignored&project=4507254110552064&referrer=feedback_list_page] | Sentry is opened on the page “User feedback” : * The report sent is listed |
| Click on the report (user feedback). | The details of the error are displayed. |
| Open the link on a new tab : [https://eu.mixpanel.com/project/2828312/view/3362352/app/events#KoHua7f3PrJZ] | The error is listed with the same Anonymous ID and php written like “X.X.XX”. |
| Close the 2 tabs. | Module tab is displayed. |
| Reload the module page. | Update is launched but the update fail : * Yellow warning alert : “Update failed”, description : “Your store may not work properly anymore. Select the backup you want to use and restore it to avoid any data loss.”, CTA “Restore” * At “Step dowload” 3 errors : ## “Exception: Brique” ## “It seems there was an issue with the server. This type of error usually happens when […]" ## " HTTP request failed. Type: ERR_BAD_RESPONSE - HTTP Code: 500” * Composant “Error Summary” with the 3 errors with a link “See error” for each * 3 CTAs : “Download update logs”, “Send error report” and “Restore” |
| Click on the CTA “Restore” in the yellow warning alert. | “Backup Selection” page is displayed. |
| Open the file [yourshopname_folder] > modules > autoupgrade > classes > Task > Update > Download.php. | File is opened. |
| In the function “public function run”, modify “throw new Exception(“Brique”);” by " exit(0) “; and save the folder. | File saved with modifications. |
| Go to “Update Assistant” module (side board). | * “Update Assistant” module is displayed : ** Title : “Welcome to PrestaShop Update Assistant” ** Two radio buttons : “Update your store” and “Restore from a backup” (disabled) ** CTA “Get started” disabled |
| Select the radio button “Update your store”. | * “Update your store” radio button is selected * CTA “Get started” is enabled |
| Click on the CTA “Get started”. | * A loader is displayed in the CTA “Get started” then, “Version choice” page is displayed : ** Stepper on step one (“Version choice”) ** Paragraph with “A more recent version is available / Current PrestaShop version: 1.7.8.9 / Current PHP version: 7.1.xx ** Radio button : PrestaShop 1.7.8.xx [Patch version](blue color rgb(190, 234, 243)) with description “The maximum version of PrestaShop to which you can update your store, based on its PHP version.” and the link “Release note” ** Blue alert info : " 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/" ** CTA : “Next” disabled |
| * Clic on the Radio button next to “Prestashop [last version]" * The check is finished |
* Checking requirement is launched then is finished : ** “The requirements check is complete, you can update your store to this version of PrestaShop." ** Or warnings ** CTA “Next” is enabled |
| * Click on the CTA “Next”. | * “Update options” page is displayed : ** Stepper on step 2 (“Update options”) ** 3 toggles : “Deactivate non-native modules”, “Regenerate email templates” , “Disable all overrides” with details about them under their name ** CTA “Next” enabled |
| Click on the CTA “Next”. | * “Back up your store” page is displayed : ** Stepper on step 3 (“Backup”) ** Subtitle “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." ** Toggle : “Include images in your backup” on Yes status ** 2 CTAs : “Update without backup” and “Launch backup” (both available) |
| Click on the CTA “Launch backup”. | Modal “Start backup?” is displayed : * Text : “Your files, database, and images will be backed up." * 2 CTAs : “Cancel” and “Start backup” |
| * Click on the CTA “Start Backup”. | * The “Backup” page is displayed : ** loading bar with the current process ** details of the current process are listed |
| Wait until the end of the backup | The title is modified : " Back up your store” : * The success alert “Backup completed” is displayed * CTA “Download backup logs” * CTA : “Start update” |
| Click on the CTA “Start update”. | The modal “Start Update?” is displayed : * Text : “You are about to launch the update, do you want to continue?" * 2 CTAs : “Cancel” and “{color:#0747A6}cutest rocket{color} Start Update " (both enabled) |
| Click on get started and follow the different step until the update step. | * Upgrade is launched * You quickly only have two red cross error : ** It looks like there is no data received from the server. This can happen if: The server is temporarily unavailable. There’s an issue with the network or connection. ** HTTP request failed. Type: APP_ERR_RESPONSE_EMPTY - HTTP Code: 200 |
| Click on the CTA “Restore” (the one next to the CTA “Send error report”). | “Backup Selection” page is displayed. |
| Click on the CTA “Delete selection”. | The modal “Delete backup” is displayed : - text : “You are about to delete the V8.0.4_YYYYMMDD-HHMMSS-randomnumber backup made on M/D/YY, H:MM A/PM.” |
| Click on the CTA “Delete”. | Modal “Delete backup” is closed. |
| Click on the CTA “Delete selection” (with only one backup left). | The modal “Delete backup” is displayed : - text : “You are about to delete the V8.0.4_YYYYMMDD-HHMMSS-randomnumber backup made on M/D/YY, H:MM A/PM. As it’s your only backup, you will be redirected to the module’s home page.” |
| Click on the CTA “Delete”. | Modal “Delete backup” is closed and “Update Assistant” module is displayed : * Title : “Welcome to PrestaShop Update Assistant” * Two radio buttons : “Update your store” and “Restore from a backup” (disabled) * CTA “Get started” disabled |
| Open the file [yourshopname_folder] > modules > autoupgrade > classes > Task > Update > Download.php. | File is opened. |
| In the function “public function run”, modify “exit(0);” by “while(true) {}” and save the folder. | File saved with modifications. |
| Go to “Update Assistant” module (side board). | * “Update Assistant” module is displayed : ** Title : “Welcome to PrestaShop Update Assistant” ** Two radio buttons : “Update your store” and “Restore from a backup” (disabled) ** CTA “Get started” disabled |
| Select the radio button “Update your store”. | * “Update your store” radio button is selected * CTA “Get started” is enabled |
| Click on the CTA “Get started”. | * A loader is displayed in the CTA “Get started” then, “Version choice” page is displayed : ** Stepper on step one (“Version choice”) ** Paragraph with “A more recent version is available / Current PrestaShop version: 1.7.8.9 / Current PHP version: 7.1.xx ** Radio button : PrestaShop 1.7.8.xx [Patch version](blue color rgb(190, 234, 243)) with description “The maximum version of PrestaShop to which you can update your store, based on its PHP version.” and the link “Release note” ** Blue alert info : " 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/" ** CTA : “Next” disabled |
| * Clic on the Radio button next to “Prestashop [last version]" * The check is finished |
* Checking requirement is launched then is finished : ** “The requirements check is complete, you can update your store to this version of PrestaShop." ** Or warnings ** CTA “Next” is enabled |
| * Click on the CTA “Next”. | * “Update options” page is displayed : ** Stepper on step 2 (“Update options”) ** 3 toggles : “Deactivate non-native modules”, “Regenerate email templates” , “Disable all overrides” with details about them under their name ** CTA “Next” enabled |
| Click on the CTA “Next”. | * “Back up your store” page is displayed : ** Stepper on step 3 (“Backup”) ** Subtitle “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." ** Toggle : “Include images in your backup” on Yes status ** 2 CTAs : “Update without backup” and “Launch backup” (both available) |
| Click on the CTA “Update without backup” | Modal “Start update?” is displayed : * Text : “Before starting the update, make sure you have a complete and recent backup of your store (database, files, and images)." * 2 CTAs : “Cancel” and “Start backup” * A Checkbox “I have made my own backup and can restore it manually if a problem occurs." * 2 CTAs : “Cancel” (enabled) and “Start update” (disabled) |
| Check the checkbox “I have made my own backup (…)”. | The CTA “Start update” is enabled. |
| * Click on the CTA “Start update”. | * The page “Update” is displayed : ** Stepper on step 4 (“Update”) ** loading bar with the current process ** details of the current process are listed |
| Reload the page during the update. | Navigateur modal is displayed : * “This page is asking you to confirm that you want to leave — information you’ve entered may not be saved." * 2 CTAs : “Stay on Page” and “Leave Page” |
| Click on the CTA “Leave Page”. | Update is starting from the beginning. |
| Wait until the end of the upgrade load. | Update is launched but the update fail : * Red danger alert : “Update failed”, description : “You didn’t back up your store with the Update assistant module but you can restore using your own manual backup.” (because there is no backup saved) * At “Step dowload” 3 errors : ## “Maximum execution time of [yourMaxExecutionTime] seconds exceeded” ## “It seems there was an issue with the server. This type of error usually happens when […]" ## " HTTP request failed. Type: ERR_BAD_RESPONSE - HTTP Code: 500” * Composant “Error Summary” with the 3 errors with a link “See error” for each * 2 CTAs : “Download update logs”, “Send error report” |
| Go to “Update Assistant” module (side board). | “Update Assistant” module is displayed : * Title : “Welcome to PrestaShop Update Assistant” * Two radio buttons : “Update your store” and “Restore from a backup” (disabled) * CTA “Get started” disabled |
| Open the file [yourshopname_folder] > modules > autoupgrade > classes > Task > Update > Download.php. | File is opened. |
| In the function “public function run”, delete “while(true) {}” and save the folder. | File saved with modifications. |