Release Specific Upgrade Considerations

Release Specific Upgrade Considerations for Zen Cart

This document lists things you may wish to take into account as you upgrade. This includes:

  • changes to the database schema or contents which deserve special notice
  • changes to basic template operation

Zen Cart 1.5.8

  • The function zen_cfg_read_only has been added to the core. This means any plugin authors who use this function should remove it from the plugin (for 1.5.7+) or wrap it in if (!function_exists('zen_cfg_read_only')) (for older versions of Zen Cart).

Zen Cart 1.5.7

  • The configuration constant UPLOAD_FILENAME_EXTENSIONS was removed from the database and replaced with an entry in includes/classes/upload.php. If you have modified this constant from its original setting of jpg,jpeg,gif,png,eps,cdr,ai,pdf,tif,tiff,bmp,zip you will want to make the same change in the aforementioned file.

  • Internal changes necessitated removing the following inclusions from admin/includes/auto_loaders/currency_cron.core.php:

    • class.base.php
    • init_file_db_names.php
    • init_database.php

    If you have created additional cron jobs and used this file as a base, please apply the 1.5.7 changes to your custom files.

  • The field products_description.products_viewed has been deprecated. It will be deleted in a future release. Product view tracking is now done using the table count_product_views.

Zen Cart 1.5.6

  • The variable $downloads, returned from includes/modules/downloads, changed from a query result to an array. The following template files had to be updated to accomodate this change:

    • tpl_modules_downloads.php
    • tpl_account_history_info_default.php

    You will want to adjust any copies of these files in your template to process an array rather than a database query.

  • The table containing the EZ-Pages data (ezpages) was split into two tables, ezpages and ezpages_content. This was done in order to add multi-language capabilities. Accordingly, template files (template overrides or custom files) which reference the ezpages table will need adjustment to account for this division.

Zen Cart 1.5.5

  • The arguments for the notifier NOTIFY_ORDER_AFTER_SEND_ORDER_EMAIL were changed. This necessitated a code change in the observers watching for it.

  • The responsive_classic template was introduced in this release. If you are coming from an older release with an older template, be sure to check and verify that your template performs properly on mobile devices. If not, you can use Responsive Classic or select another responsive template.

  • Starting in this version, the email css was pulled out of the individual templates into a shared file called email/email_common.css. If you are creating or updating email templates, you should follow this new practice.

Zen Cart 1.5.0

  • The admin menus are no longer built by files ending in .dhtml. Instead, a new database table called admin_pages was introduced. Mods which create their own menu entries must also follow this convention. Guidelines for upgrading plugins to 1.5 include instructions on this step.

Still have questions? No problem! Just head over to the Zen Cart support forum and ask there.
In your post, please include your Zen Cart and PHP versions, and a link to your site.


Last modified July 16, 2020 by Scott C Wilson (ae69d8f).