Upgrading an encapsulated plugin

Once you have created an encapsulated plugin, upgrading it is mostly a matter of creating a new version number under the plugin name, and then making your changes.

So if the old plugin was structured like this:


you can rename this to


and make your changes. Once you release, people will upload the new version and run through the upgrade process using Admin > Modules > Plugin Manager.

Note: One constraint is that even if your first version did not use SQL Installer Classes, your update must do so if there are database changes. The plain .sql files in the Installer folder are not run on an upgrade.

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 July 14, 2020 by Scott C Wilson (493cf61).