Zen Cart® is derived from: Copyright 2003 osCommerce
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE
and is redistributable under the GNU General Public License
This software is OSI Certified Open Source Software.
OSI Certified is a certification mark of the Open Source Initiative.
Zen Cart® v1.5.5 is designed for PHP 5.6 to 7.1, with MySQL 5.1 thru 5.7 and Apache 2.2/2.4
It is compatible with PHP 5.2.10 through PHP 7.1, for backward-compatibility while upgrading your site, but you should be using a newer version whenever possible. (Note: At the time of this release, PHP 5.6 is considered obsolete. You should be using PHP 7.1 or greater by now.)
This document only mentions the actual changes specific to v1.5.5 since v1.5.4.
Simple: if you are using v1.5.4 already and have not customized any of the files listed in the changed_files-v1-5-5.html document, then simply replace those files with the new files as listed.
If you HAVE customized or altered certain files, simply re-do your customizations in the new version of those particular files by making the same changes needed.
If you are using Addons/Plugins that have made alterations to those files, it is best to compare those changed files against the original Zen Cart files for the version those plugins were built for, and see what changes were there ... and then re-build those changes in the v1.5.5 file.
If you are upgrading from a version OLDER than v1.5.4, then please do a standard site upgrade. Be sure to review all the links in this article, including tips on staging the upgrade in a separate directory/folder.
For a list of files that have been changed since v1.5.4, see the changed_files-v1-5-5.html document.
The contents of configure.php have changed (to be simplified) ... and they're MUCH SMALLER now!
The dist-configure.php shows the simplified contents, and zc_install will generate the leaner files (when doing fresh installs).
Also, zc_install will upgrade your configure.php files to the new format as long as the files are writable by your server's PHP.
While Zen Cart® v1.5.5 contains a newer "responsive_classic" template, we STRONGLY recommend that upgraders first upgrade
the site using everything (including template_default) except the responsive_classic template contents.
Then once the upgraded site is working properly you can consider what changes you might want to make to your own active template.
(Important notes about template_default are shown below)
AGAIN: The responsive_classic template should NOT be implemented immediately as part of an upgrade; it should be a separate step ...
if it is even used at all. IT IS NOT NECESSARY TO USE responsive_classic ON YOUR EXISTING SITE, AND YOU SHOULD UPGRADE THE REST OF
YOUR SITE FIRST BEFORE ATTEMPTING TO CONVERT/ADAPT IT TO YOUR USE.
UPGRADERS SHOULD BE SURE TO UPDATE BOTH template_default AND YOUR CUSTOM TEMPLATE as described here:
In Zen Cart the template_default directory contains the master copy of all storefront page templates.
The normal procedure for customizing template files for use in your own personalized template is to make a copy of the corresponding file from
template_default, put it into your own template folder (and matching folder structure), and make your customizations in that copy of the file.
This way the only files you need in your personalized template folder are those that you have altered in some way from template_default.
With that explained, it is important that whenever you upgrade your site, you should also inspect ALL the template_default files to determine
which changes in those files need to be replicated in your customized files.
Often a tool like Beyond Compare or Araxis Merge or GnuDiff
can be helpful for this. The process is simple: compare the template_default directory files from your *old* version against the
template_default files in the *new) version, and use those results as a reference to copy those updated changes into each of the files
you've customized in your custom/personalized template in your store.
Then, and only after you've done all those comparisons and updated your customized files in your custom template folder, you will
copy the template_default files from the new version into the template_default directory of your store. This way you'll be left with
updated personalized files *and* updated template_default files.
The template_default files previously had a lot of old <table> markup to specify widths, cell borders and padding and spacing.
These have been removed in v1.5.5 and relevant styles added to the bottom of the main stylesheet.css file. You will want to add the updated
CSS parts to your own stylesheet if your custom template still uses those tables. (A few 3rd-party templates have aggressively ripped out
various tables and may not be affected by this change.)
A few CSS changes were made in template_default to change IDs of repeating elements to be classes instead.
Of note #cartDisplay is now .cartDisplay, and #cartImage is .cartImage
The techy, detailed list of individual code changes can be viewed on github
A very long detailed list of individual code changes can be viewed on github
Copyright 2003 - 2017 Zen Ventures, LLC — Zen Cart® www.zen-cart.com