Post-Release tasks
Post-Release Tasks for the Zen Cart Forum
- Add the new version to the Zen Cart Version dropdown on the forum for new thread creation. (Note that this is not required for patch releases.)

Instructions:
- Login to the admin panel for zen-cart.com
- Thread Prefixes -> Thread prefix manager
- Where it says "Zen Cart version", click on Add Prefix

then set prefix id, title (both) to the version
e.g. v158
leave display order as 10
click Save
- Add the new version as a checkbox to the plugin version list. (Note that this is not required for patch releases.)

Instructions:
- Login to the admin panel for zen-cart.com
- Maintenance -> Execute SQL Query
insert into vb_dl2_zcversions (versiontext) values ('v1.5.8')
Other Post-Release Tasks
The first item applies to all releases; subsequent items are for major releases only.
-
Update the Release History page with the new version and date.
-
Create a “Known Bugs in
” thread on the Upgrading to 1.5.x subforum. Update the release announcement and the known bugs page with this link. -
Ensure the Release Specific Upgrade Considerations doc has a statement about this release.
-
Search the documentation in https://github.com/zencart/documentation for the string RELEASETIME and update those files.
-
Run the
build_doc
andview schema
tools.build_doc
is in the Zen Cart Tools repo. It creates the configuration documentation.view_schema
is a plugin located here. It creates the schema documentation. Install the plugin, then do an Inspect in Google Chrome on the output and copy the element with id=“pageWrapper” into a new file inzencart_documentation/content/dev/schema
. Remove the opening and closing div tags.
-
Emergency Re-release: If something was missed and you have to do a re-release, go back to Remedial Commits.
A day or two after the build has been released when you’re confident that all is well:
-
Message all developers who have merge privileges using the Skype Dev Chat channel, and then unlock the branch you are building. Go to the branches page and de-activate the branch protection rule you created earlier (uncheck the “PR required” checkbox for the rule).
-
Begin process of formally merging release to Master/Main FIXME - unsure
-
Take some time to review the What’s New document in the release folder to be sure it’s complete.
Post-Release Things to Consider
-
Is it time to remove old versions from the plugin version list?
-
Is it time to hide older what’s new / changed files documents in the releases folder?
-
Are there old stuck posts on the forum that should be unstuck?
-
Check the Zen Cart and Zen Cart Documentation project for tags that mark things that need to be taken care of - there might be a ‘Post Release 1.5.X’ tag or something like that, for example.