Versioning - PrestaShopCorp/ps_checkout GitHub Wiki

2023 : SemVer + Core version, 1 zip archive per github release

In 2023, the module versioning changed from SemVer to a 4-digits version number strategy.

Latest SemVer release was v3.0.2. The next release was v6.3.1.0 in March 2023.

The version number strategy is as follows:

• the 1st number indicates the major PrestaShop version compatible with this module version
• the 3 following digits follow SemVer as usual

Consequently

• v6.3.1.0 is PrestaShop Checkout 3.1.0, built for PrestaShop 1.6
• v7.4.3.0 is PrestaShop Checkout 4.3.0, built for PrestaShop 1.7
• v8.3.6.2 is PrestaShop Checkout 3.6.2, built for PrestaShop 8
• v9.4.3.3 is PrestaShop Checkout 4.3.3, built for PrestaShop 9

Following this strategy, each GitHub release contained one zip archive and only one.

This strategy was chosen because we considered publishing the same module code for multiple PrestaShop versions prevented us from using the core software new capabilities. If we build the same code for PrestaShop 1.7 and PrestaShop 9 we cannot use PrestaShop 9 new features.

2025 : SemVer but multiple zip archives per github release

In 2025 with the PrestaShop Checkout v5 rework, we are introducing a new paradigm:

• the module repository provides SemVer tags such as v5.0.0 or v5.0.1
• but for each version, we build a different zip archive for different PrestaShop versions

For example version v5.0.1 release contains 3 zip archives v7.5.0.1, v8.5.0.1, v9.5.0.1 each compatible with a PrestaShop version.

Doing this allows us to switch back to SemVer versioning while allowing us to distribute binaries aimed at different PrestaShop major versions, allowing us to use the core software new capabilities.