Release tagging

We are now ready to tag the release.

Ensure your Zen Cart folder is up to date, especailly as you will have merged the version stamping changes.

Now we tag the release.

Prerequisites

If you have not pulled the current list of tags, do so now:

git fetch --tags

You can confirm your local copy of tags using

git tag --list

Tagging

Note: The tag must be the same as the newVersion setting in the versionstamper’s config.php file.

git tag v1.5.8 obviously replacing the release name as appropriate

git push upstream --tags

Possible Remedial Commits

After creating the release on Github (the next step), you will want to test the build and make sure it works.
If you test the resultant build, and find a problem, it may be that you may need to do some remedial commits at this point.

For any new commits at this point, you must manually update headers as it is difficult to re-run the version stamper.

  • Edit files to update headers - change date and committer name
  • Create PR, merge, update your branch

If you have added extra commits you will need to update the release tag.

git tag -d v1.5.8
git push --delete upstream v1.5.8
git tag v1.5.8
git push upstream --tags

Then re-run these steps of the build:

Create the Release on Github

After this we then need to create the release on github.

https://github.com/zencart/zencart/tags

 Github Tags

By clicking on the … on the far right hand side we can create a release.

Github Create Release

The title should be the same name as the tag name.

For Pre-Releases:

  • Don’t forget to check the pre-release box

For Official Releases:

It’s a good idea to also check the “Create a discussion for this release” box.

When you’re ready, press the Publish Release button.

Verification

Take some time to verify the build you just published. Since you already did pre-testing before beginning the build process, hopefully there will be no issues, but if there are, return to the Possible Remedial Commits step.

Additional Release Tasks:




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 October 17, 2022 by Scott C Wilson (e46adb88).