Pre-Release Notes

Note: This step only apples to pre-release version updates, which are done at the time of initiation of a new release.

If you are doing official release, please skip this step and go to the next step.

Git Work

The master branch is now the current release. If a patch is being done from a release in the past, create a branch for that patch.

Versioning files

Before doing the version updates, create a new branch specifically for these changes.

Here’s what should be in these files for version 2.0.0-alpha1:

# File Version
1 includes/version.php define('PROJECT_VERSION_MINOR', '0.0-alpha1');
2 zc_install/includes/version.php define('PROJECT_VERSION_MINOR', '0.0-alpha1');
3 zc_install/sql/install/mysql_zencart.sql project_version_major and project_version_minor for the two Zen-Cart Main rows should be 2 and 0.0.
project_version_patch1 for the two Zen-Cart Database rows should be New Installation-v200-alpha1

CHECK CAREFULLY - look at project_version_major, project_version_minor, project_version_patch1,project_version_comment
4 zc_install/sql/updates/mysql_upgrade_zencart_200.sql project_version_comment for the two version rows should be Version Update 1.5.8->2.0.0-alpha1

CHECK CAREFULLY - look at project_version_major, project_version_minor, project_version_patch1,project_version_comment
5 zc_install/includes/systemChecks.yml Top checkDBVersion block should be version: '2.0.0'
6 zc_install/ajaxLoadUpdatesSql.php '2.0.0'=>array('required'=>'1.5.8'),
7 zc_install/includes/modules/pages/database_upgrade/header_php.php $versionArray[] = '2.0.0';

Shortcut for editing these 7 files:

vi includes/version.php zc_install/includes/version.php zc_install/sql/install/mysql_zencart.sql zc_install/sql/updates/mysql_upgrade_zencart_200.sql zc_install/includes/systemChecks.yml zc_install/ajaxLoadUpdatesSql.php zc_install/includes/modules/pages/database_upgrade/header_php.php

PHP Compatibility

If the new version has different PHP compatibility ranges than the prior one, be sure to update:

Still have questions? Use the Search box in the upper right, or try the full list of FAQs. If you can't find it there, head over to the Zen Cart support forum and ask there in the appropriate subforum. In your post, please include your Zen Cart and PHP versions, and a link to your site.

Is there an error or omission on this page? Please post to General Questions on the support forum. Or, if you'd like to open a pull request, just review the guidelines and get started. You can even PR right here.
Last modified May 19, 2024 by Scott Wilson (c47689f).