# 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.0.2 to 1.3.5 If you are upgrading from Zen Cart v1.3.0.2, 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.0.2, 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. CSS-per-page coding changes may affect your stylesheet naming conventions. The naming for category pages now properly uses cPath, like: c_3_10.css, c_31_52_88.css, etc Stylesheet Change: CSS selector #cartAttribsList changed to .cartAttribsList You may need to adjust some templates to accommodate the change. NOTE: There are other stylesheet changes/additions. Please review the changes using WinMerge NOTE TO "CLASSIC" TEMPLATE USERS: IF YOUR SITE IS BASED ON the older "Classic" template, please note that the New Classic is very different. The new tableless "Classic Contemporary Green" replaces the old table-based "Classic" template. The folder is STILL named "classic"... so if your site is using a template named "classic", you will want to either skip upgrading this folder, or be VERY careful to not overwrite your changes. This is likely a good time to build your own custom template, using a name other than 'Classic'. Company Minimum Value: If you have never altered your "Minimum Value" for "Company" in Admin->Configuration-> Minimum Values you may wish to double-check it. The default value for this used to be '2', and in v1.3.5, this minimum is actually validated. Thus, if you don't update this to 0, then you may find customers complaining that they have to enter a company name even for personal registrations. 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. NOTE: for HTMLarea users: The /htmlarea folder has been MOVED into /editors/htmlarea You should move your old files to the new location before editing, as this will make things go a little smoother. Note that a couple files have changed in the htmlarea folder to accomodate the new folder path. This change opens the door to allow for other editors to be integrated. Plugins are available in the downloads area for FCKeditor and TinyMCE editors. phpBB file rename. The file class.phpBB.php was renamed to lowercase for consistency across webserver platforms. If you fail to rename yours during the upgrade, you will encounter error messages saying that the file cannot be found. Got a BIG database? Several new indexes are added during the upgrade process. We suggest testing the upgrade after busy hours if you are upgrading a database with large "products" or "orders" tables. # 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.0.2, see the changelog-v1-3-5.html # Whats New ... ### The following Improvements and bugfixes are included in v1.3.5: SECURITY UPDATES. Numerous IMPORTANT security updates have been included in this release to prevent hack attempts and other exploitation of your site. YOU SHOULD PREPARE TO UPGRADE ASAP NEW CLASSIC TEMPLATE with tableless design. Uses only the stylesheet to make tableless layout look the same as the old v1.2 Classic Template (but with an added color change). State/Country pulldown menus now work cooperatively Speed performance enhanced with improvements in database indexing Resolved Slow Query problem with new and upcoming products Attributes ... while shopping, if a customer makes an error and fails to choose a required attribute, their previous selections for pulldowns were not remembered. This is now fixed. Added: Optional alpha sorter pulldown menu in product listing and search results. Can be enabled in Admin->Configuration>Product Listing Added: Store Manager now has an optional button to use for optimizing database tables Added: metatags can now have a user-selected divider, rather than just "space" (ie: comma) Added: new notifiers added to password, address-book, checkout-process, checkout-shipping Added: Product Listing now has option to display category image or not Added: Site Map now enables/disables options using same settings as information sidebox Added: search input fields now reinstate the default text if user clicks away from the field Added: Admin->Customers->Orders page now has "edit" navigation button Added: legend on/off indicators for payment/shipping/ot modules for clarity Added: customer email notification upon customer status change from customer-listing screen Added: Zones Definitions description now shows in admin geozones listing Added: completed-order details available to checkout_success template for use by affiliate-tracking systems Added: Email footer now contains CC type if CC was used for payment Added: Checkout-Shipping page now explains that no options are available if no available options exist, rather than just leaving the selection area blank and confusing the customer Added: style classes added for images on product listing to allow option for borders etc Added: down-for-maintenance sends HTML 503 header so spiders return later and don't index the "down" page Added: Checkout-payment page now explains that no options are available for customer's region if zones have restricted modules from display, or none are available for other reasons Change: currency-updater now suppresses errors and also attempts to use cURL if normal attempts fail to retrieve currency data Change: CSS-per-page was grabbing too many wildcard matches. Logic improved. Change: renamed class.phpBB.php to lowercase for consistency Change: stylesheet selector #cartAttribsList changed to .cartAttribsList so that the ID wasn't used repeatedly within a loop Change: USPS module no longer uses obsolete password field. Updated help text for clarity. Change: individual add-to-cart buttons and qty box now available on product-listing Change: reinstated alternating-colors for all-products listing page Change: add style support for odd/even rows on checkout-confirmation page Change: admin configuration editor allows click on labels, not just radio buttons Change: admin user edit screen no longer displays unused level/demo options Change: POST data removed from navigation class Change: Updated descriptions and helptext in various payment/shipping modules for clarity Change: default image folders are now set for categories and manufacturers Change: attributes using radio buttons, if only 1 option in gang ... are auto-selected for cust Change: Shipping modules: Zones and Tables now can do Price or Weight or Items Change: newsletter-manager module no longer requires lock/unlock PayPal: downloadable items paid by eCheck are now activated upon eCheck clearing PayPal: multi-currency translator support repaired for currencies not handled natively by PayPal PayPal: debug logging support added PayPal: PayPal store-name display override added to language file. default: "store name purchase" Bugfix: Deleting Images from admin for products, changed to work with recent browser updates: Added checkbox to handle removal. Bugfix: Nick Name labels for forum now consistently displayed, and "*required" shows correctly Bugfix: Zone problems related to adding addresses during checkout resolved Bugfix: Zone problems where grabbing similar zones would ignore selected entry resolved Bugfix: resolved display problem of "referral source" field in My Account->Edit Bugfix: File Upload status messages now show when using upload attributes Bugfix: table-cell alignment fix in tpl_tabular_display Bugfix: My Account display of order information uninitialized array repaired Bugfix: My Account display of newsletter/notifications now turns off properly via admin switch Bugfix: Admin->Customers wasn't showing linked customer reviews stats properly Bugfix: Shopping Cart sidebox had display blocks misaligned within loops Bugfix: fixed problem with duplicates in whos_online display Bugfix: shopping cart qty box no longer drops too many products when clicking update Bugfix: prev/next now displays properly when "always show cat" is set to 1 Bugfix: when logging out, customer-selected language is retained until session expires Bugfix: duplicate status indicators removed from order status html-email notices Bugfix: email option for "sendmail-f" reinstated Bugfix: fixed html syntax error on checkout-shipping-address page Bugfix: CC module no longer stores full CC numbers Bugfix: admin legends with red icons displayed inconsistent ALT texts Bugfix: Breadcrumb issues with "Categories Always Show" switch set to a specific category Bugfix: separated featured/specials properly in Admin->Catalog->Featured Bugfix: phpBB link sometimes didn't detect properly if phpBB only partially existed. Bugfix: error in FILENAME_FEATURED_PRODUCTS when multiple-add-to-cart was turned off Bugfix: fixed attributes display of "Please Choose:" when READONLY are used Bugfix: cPath problems on searches and filters resolved Bugfix: reinstate functionality of admin switch for Minimum Value of Also Purchased Products Bugfix: reinstate out-of-stock indicators on checkout_confirmation page Bugfix: metatags handles manufacturer filters correctly Bugfix: metatags handles unknown page correctly Bugfix: also-purchased-products centerbox no longer queries the database if disabled Bugfix: checkout restrictions fixed where gift certificate/coupon used and payment module not properly selected Bugfix: adding a new admin was logging into new admin's account immediately (RG problem) Bugfix: admin product-type listing now goes to edit layout mode upon clicking Bugfix: ez-pages listing includes navigation buttons Bugfix: languages_code setting for some admin areas wasn't set properly including editor Bugfix: checkout_confirmation page has SSL link to shopping-cart to retain session for edits Bugfix: fixed XHTML error on contact-us page Bugfix: fixed line-spacing problems on support files for phpMailer. Added .htaccess to folder. Bugfix: repaired pulldown form in customers-edit screen Bugfix: HTML Emails were inserting @CRLF incorrectly for BR and P tags Bugfix: restored linefeed-handler setting for emails Bugfix: style added to handle "order_history" sidebox content so UL wasn't misaligned Bugfix: upcoming-products page was showing disabled products Bugfix: zones shipping module wasn't honoring tax-basis setting properly Bugfix: phpBB link in information sidebox builds smarter based on 1.3 syntax change Bugfix: SMTP server port setting reinstated Bugfix: checkout cart-contents areas have a CSS selector Bugfix: Page Not Found page now sends HTML 404 header Bugfix: table shipping module now works with total, weight, and items Bugfix: free shipping enhanced to work with item/weight/price on shipping modules Bugfix: group-pricing module wasn't working with tax classes properly Bugfix: Default Order Status was being set too early for zero-balance orders Bugfix: redemption of Gift Certificate from GV-FAQ page fixed Bugfix: phpBB error of duplicate email upon editing customer name resolved Bugfix: product+download combo items excluded from free-shipping price or item Bugfix: shipping modules were not consistently handling weights < 1 Bugfix: product-status was being set to off incorrectly if quantity was <1 instead of <=0 Bugfix: Version Info listing of database-upgrade history was sorted incorrectly and displayed some duplicates. Bugfix: footer bar logic changed for ez-pages listing to remove a DIV that caused troubles Bugfix: company field-validation on create-account wasn't happening Bugfix: qty boxes weren't hiding properly using pulldown filter sideboxes Bugfix: SQLPatch no longer mistakenly displays debug results of processed SQL statements Bugfix: some "extra_" folders were loading non-php files mistakenly Bugfix: More MySQL5 fixes implemented to prevent datatype errors requiring STRICT_TRANS_TABLES disabled. These fixes are not exhaustive. Still not MySQL5-certified Bugfix: group-pricing and coupons order-total modules not calculating taxes correctly. Structurally improved to be full credit-class modules. Bugfix: improved garbage-collection routines for session-handling Bugfix: Shipping estimator page was not properly nesting table components Bugfix: Admin... when editing customer records, customer's "zone" would be busted and replaced with the 2-letter state abbreviation, resulting in broken tax calcs in next checkout Bugfix: Shipping Estimator now remembers more information about customer in popup unless a timeout occurs Bugfix: product_music template was not showing genre and artist information Bugfix: address-book restrictions less than 2 was still showing "change address" on checkout Bugfix: sort order problem on modules in admin was preventing some modules from triggering if sort orders were the same Bugfix: Admin password-forgotten is now treated as an SSL page Bugfix: the category icon display on product-info pages now allows image option on/off Bugfix: fixed stylesheet problem with category tabs in Opera Bugfix: more reliable logic for stripping non-numeric characters from gv/coupon inputs Bugfix: removed empty <div> when banner is blank and no tagline defined for tpl_header

Zen Cart™ Copyright 2006