How to release a new PrestaShop version
This section describes the release process, step by step. A PrestaShop version release requires all these steps to be completed.
To perform a build, you will need the following:
- Git, so you can clone the project’s Git repository on your computer.
- The PHP CLI executable (within the compatible version range of the PrestaShop version you will be building), so you can create a build.
- The Composer executable, to fetch PHP dependencies.
- The NodeJs CLI executable (within the compatible version range) and NPM, to compile assets.
- Perform preliminary tasks: (click to see the full step)
- **Set up the new version on the PrestaShop Addons Marketplace and update native modules' compatibility.** _To allow the PrestaShop Addons Marketplace and its API to serve modules compatible with this new PrestaShop version._ - **Update the version number in the Core.** - **Make sure the default translation catalogue has been updated and pushed to Crowdin.** _To make any new wordings translatable._ - **Perform manual verifications.** _To make sure that the project is ready to be built._
- Create a new build: (click to see the full step)
Merge security PRs locally.
Any security PRs must be merged on a local branch before making them public.
Update the Changelog and Contributors list.
These files must be included in the build.
Build the zip archive.
- Release the version publicly: (click to see the full step)
Merge security PRs on GitHub.
And publish the security advisories.
Merge the updated Changelog and Contributors list on GitHub.
Tag the version using Git and publish the release on GitHub.
Release the archive on PrestaShop.com.
- Final steps: (click to see the full step)
Update API stream for 1-click upgrade.
So that the 1-Click Upgrade (autoupgrade) module becomes aware of the new release.
Create Docker images for the new version.
Go through the checklist.
To make sure everything went all right.