# Welcome to Zen Cart™ ... The Zen Cart™ software is made available to you for use, additions, changes, modifications, etc. without charge, under the GNU General Public License. While we do not charge for this software, donations are greatly appreciated each time you download a new version, to help cover the expenses of maintenance, upgrades, updates, the free support forum and the continued development of this software for your online e-commerce store. Donations can be made at: The Zen Cart™ Team Page We appreciate your support. The Zen Cart™ Team 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.

# Upgrade Instructions from v1.3.5 to 1.3.6 If you are upgrading from Zen Cart v1.3.5, the process is simple: - compare all the changed files with the files on your own site... and re-apply your customizations to the new files - upload the new files (with your customizations added) to your site - upload the zc_install folder to your server, and run zc_install/index.php ... select Database Upgrade from the System Inspection screen. Apply the required updates. If you are upgrading from a version prior to v1.3.5, please follow the instructions in the "how to upgrade" documentation in the /docs folder. # IMPORTANT NOTES SECURITY: Please be sure to review and apply the Site Security Recommendations to your site prior to taking your shop "live". If you are uncertain about how site security applies to you, talk to your web host to ensure that you have proper measures in place. Stylesheet Changes: There are some important stylesheet additions and a few changes. Two new styles were added: .hiddenField { display: none; } .visibleField { display: inline; } There was a conversion from <div class="navMainSearch forward"> to <div id="navMainSearch"> in the tpl_header.php file. If you wish to "not" convert that part of your header, you will need to add the following to your stylesheet /**************************/ /* backward compatibility, to be removed in 1.4: */ .navMainSearch { float: right; margin: 0.5em; } /**************************/ PayPal Users: If you are using the PayPal payment module, you will need to Remove and re-Install the PayPal module in Admin->Modules->Payment->PayPal in order to take advantage of the bugfixes in the module. (Write down your settings first, for easier re-configuration!) # UPGRADING YOUR TEMPLATES Since version 1.2, Zen Cart™ has had a major overhaul of the templating system for v1.3. As such, you have two options: upgrade your existing template by applying the new stylesheet and moving a few lines of code around; or the best way to have almost-tableless and much tidier template code, is to make a new template (based on template_default or the new "green" classic introduced in v1.3.5) and carefully re-apply your own customizations to the new template system. For further information on template upgrading, see the support-forum discussion on this topic. # CHANGELOG - List of Changed Files For a list of files that have been changed since v1.3.5, see the changelog-v1-3-6.html # Whats New ... ### The following Improvements and bugfixes are included in v1.3.6: SECURITY UPDATES. Important security updates related to XSS vulnerabilities have been included in this release to prevent exploitation of your site. YOU SHOULD PREPARE TO UPGRADE ASAP XSS vulnerability fixes included in this release State/Country pulldown menus work intelligently across browser platforms Discount coupons can now be restricted to only be usable if the customer's Billing Address matches the selected zone (ie: a 10%-off coupon could be set to apply only to US customers) Linkpoint/YourPay API payment module now included with Zen Cart. Minor updates to module. Products-Purchased report enhanced with search, hotlinks, etc Added: image-size settings can now be configured for top-level category images Added: centerboxes on Empty Shopping Cart page can now be enabled/disabled/sorted via the admin interface under "Stock" settings Added: currency-exchange "uplift" calculator added to My Store area, allowing automatic global padding of exchange rates during automated updates Added: search page now accepts URL parameters, allowing some retention of search history if details supplied by a referring source/link Added: Subcategories Row switch added to admin for Product Listing page Added: "zones" shipping module now allows "00" for "All zones". Also no longer case-sensitive Added: zone-status indicators added to suggest where zone configurations may be incomplete Added: "upcoming products" can now be excluded from New Products boxes/listings Added: built-in support for easy_rollovers contribution to be plugged in more simply Added: new switch for Product Info to disable display of product-model in meta-tags output where custom meta-tags not defined Added: create-account-success page now shows the customer's address for quick visual verification of their personal data Enhanced: $this_is_home_page variable can be used to determine whether the displayed page is truly the home page of the site or not. Handy for disabling breadcrumbs or other items for just the home page. Change: admin - when entering/editing products, now have the option to key in the name of the product image filename to use images already uploaded to server Change: admin order-status pulldowns now sort by ID instead of name Change: admin "extras" menu no longer appears if it has no content (ie: can remove the menu file for music items from the extra_boxes folder and the menu option will disappear) Change: improved calculation of commissionable_amount for affiliate hooks to support credit modules offering discounts Change: email system change to allow separation between php, sendmail, smtp etc methods of transport instead of only smtp/sendmail Change: Alternate email-encoding methods available. Default is now 7bit instead of 8bit. Can override via new file in extra_configures folder Change: image ALT text no longer displays if image not found Change: "Mixed ON/OFF" text no longer appears if there are no attributes for selected product Change: removed auto_increment from metatags tables for foreign-key fields Change: default editor plugins now selectable from Admin->Config->My Store via pulldown Change: status message added to messageStack if add-to-cart set to return to product Change: if customer record is deleted during a shopping session, they will now be logged out PayPal: no longer requires case-sensitivity on email address of PayPal account PayPal: was encountering an error if ez-pages functions were called in language files (unrelated to PayPal ... only related to customizations affecting PayPal loading) PayPal: fixed problem where purchase of a GV via PayPal was leaving GV linked to wrong order # Bugfix: banner bug related to status change ... missing parenthesis found Bugfix: textarea displays for define-pages area in Opera not displaying properly Bugfix: line-ending problem in the admin language file for coupon_admin.php Bugfix: email problems for SMTP mailservers resolved Bugfix: New Products date fixed to manage "All", "Current Month", and any number of days Bugfix: download-resets via Admin were not properly considering "unlimited" vs max days Bugfix: breadcrumb was displaying incompletely/incorrectly when navigating prev/next Bugfix: zen_redirect function works smarter for SSL pages Bugfix: USPS/UPS modules were incorrectly adjusting weight in some cases Bugfix: Manual-Add of Specials/Features product numbers in admin now checks proper ID's Bugfix: ot modules were not properly handling taxes when "tax in" pricing enabled Bugfix: maximum address book entries restriction was allowing one too many Bugfix: added missing switch to configuration menu for Page Not Found "define page" Bugfix: sidebox "id" duplicates removed Bugfix: stylesheet fixes Bugfix: Discount Quantity would occasionally vanish when editing by product price manager Bugfix: preg was breaking when testing template override files in template_func.php Bugfix: admin footer now properly shows version details Bugfix: admin coupon editor was incompletely handling multiple languages Bugfix: Coupon Zone notice in popup and lookup pages added Bugfix: Search page MySQL errors due to version-specific query problem Bugfix: tax calculations fixed for order total modules where include tax/shipping flags selected Bugfix: shopping cart was holding on to old quantity during some adjustment requests Bugfix: admin categories-metatags editor not handling language properly and giving SQL errors Bugfix: UPS shipping module changed to retrieve Fuel Surcharge rate if exists Bugfix: remove ereg_replace errors on additional-image-popup window (now uses str_replace) Bugfix: fixed occasional DOB errors when format changed or null data supplied Bugfix: coupon "amounts" now allowed 15,4 precision instead of 11 Bugfix: product-listing quantity boxes are now similar on advanced-search results Bugfix: sales/specials/features were not accurately expiring once-per-session Bugfix: apostrophes were causing problems when sending mail from admin Bugfix: admin menu pulldown borders were inconsistently displaying in FF Bugfix: admin banner manager page-selection occasionally lost Bugfix: remove hard-coded "Store Pickup" text from admin orders screen Bugfix: CURL proxy support consistency tidied Bugfix: currency-updater was timing out if more than 6 currencies had to be processed Bugfix: some MySQL5 strict_trans issues resolved Bugfix: shipping estimator was showing blank if all shipping modules were restricted by zones and the customer wasn't logged in Bugfix: remove stray NAVBAR_TITLE constant name from showing in metatags in popups etc Bugfix: $lng object consistency between catalog and admin fixed Bugfix: order of parameters in some URL's tidied (ie: mfg selection etc) Bugfix: media manager was including recursive cat/prod listings in pulldown Bugfix: status messages fixed where uploads failed when adding product to cart Bugfix: zone-definitions page wasn't retaining pointers properly for sidebox during navigation

Zen Cart™ Copyright 2006