PHP JavaScript CSS HTML Gherkin SQLPL
Latest commit a90bc32 Nov 7, 2017 @zcwilt zcwilt Merge pull request #1547 from drbyte/order-decimal-places-fix1319
Change order prices decimal places from 2 to 4
Failed to load latest commit information.
admin Merge pull request #1525 from proseLA/redirect-https Oct 10, 2017
app need to use tplVarmanager rather than old tplVars Aug 15, 2017
cache Allow for apache 2.4 .htaccess "auth" rules (#1081) Jul 8, 2016
docs Docs Aug 9, 2016
download Allow for apache 2.4 .htaccess "auth" rules (#1081) Jul 8, 2016
editors Allow for apache 2.4 .htaccess "auth" rules (#1081) Jul 8, 2016
email Allow for apache 2.4 .htaccess "auth" rules (#1081) Jul 8, 2016
extras Allow for apache 2.4 .htaccess "auth" rules (#1081) Jul 8, 2016
images Allow for apache 2.4 .htaccess "auth" rules (#1081) Jul 8, 2016
includes Merge pull request #1537 from mc12345678/v160-remove-zen_get_buy_now-… Oct 31, 2017
logs Allow for apache 2.4 .htaccess "auth" rules (#1081) Jul 8, 2016
media Allow for apache 2.4 .htaccess "auth" rules (#1081) Jul 8, 2016
pub Fix missing entry in .gitignore Aug 19, 2016
testFramework Update to latest phpunit May 10, 2017
zc_install Change order prices decimal places from 2 to 4 Nov 7, 2017
.gitattributes Leave .gitignore files in gh-zips Oct 14, 2016
.gitignore Update test framework to use behat/phantomJS tests Nov 21, 2016
.gitmodules Include dependent submodules into core Jun 24, 2016
.scrutinizer.yml Move PHPmailer and password-compat into library folder Jun 25, 2016
.travis.yml Add PHP 7.3-dev support to CI Aug 16, 2017 Update current year and provide links to referenced pages Oct 4, 2017 Update Aug 20, 2017
ajax.php Merge new payment modules from v155 May 10, 2016
behat.yml fixing some errors from previous controller commit #1384 Feb 7, 2017
composer.json Update to latest phpunit May 10, 2017
composer.lock Update to latest phpunit May 10, 2017
favicon.ico CHANGE-628 - Set a default favicon placeholder Nov 3, 2013
index.php update docs Dec 9, 2014
install.txt Merge documentation updates from v155 May 9, 2016
ipn_main_handler.php Fixing erroneous extra parameter (#1263) Sep 1, 2016
license.txt Initial Commit Jul 3, 2012
mcs_learn_more.html Initial Commit Jul 3, 2012
nddbc.html Initial Commit Jul 3, 2012
page_not_found.php Initial Commit Jul 3, 2012
phpdoc.dist.xml Include dependent submodules into core Jun 24, 2016
robots_example.txt Initial Commit Jul 3, 2012
vbv_learn_more.html Initial Commit Jul 3, 2012

Zen Cart® - The Art of E-Commerce

Build Status Download Zen Cart®


You are currently viewing code for our development branch, which will be our next larger release, initially dubbed as Zen Cart® v1.6.0, which brings architectural improvements to allow for increased flexibility for customizing each storeowner's own preferences.

The latest stable version is currently v1.5.5e.

Download Latest Official Zen Cart® Release
Download Latest Official Zen Cart® Release

Zen Cart is free software, with free support available 24/7 on the Zen Cart® Support Site forums at provided by our enthusiastic community of actual Zen Cart® users, integrators, and the developers themselves.

Zen Cart® v1.6.0 - Development Branch

Download latest in-development version from github


Zen Cart® requires you to provide your own webserver (shared or dedicated/VPS), with a standard LAMP stack (Linux/Apache/MySQL/PHP), based on the following specifications

Requirements for v1.6.0:

  • Compatible with PHP 5.5.0 to 7.1.x
  • Compatible with MySQL 5.1 to 5.7 and MariaDB 10.1
  • CURL (via PHP) is used to communication with payment/shipping services
  • Compatible with with Apache 2.4 and 2.2
  • Recommended Apache modules include: expires, headers, env, alias, deflate, ssl, mime, rewrite (in addition to other common modules)

Zen Cart® can also run on Nginx, but requires that the server administrator understand properly configuring the nginx *.conf files when prompted with the recommended directives at the end of the zc_install setup phase.

Zen Cart® has been reported to run on IIS, but with some limitations, namely the need to manually secure various folders with IIS equivalents to .htaccess rules.


Installation is simple:

  1. Download Zen Cart®
  2. Ensure you check that the md5/sha1 hash of the Zip matches those publicly posted.
  1. Unzip the downloaded zip file
  2. Everything inside the folder you unzipped needs to be uploaded to your webserver … for example, into your public_html or www or html folder (the folder will already exist on your webserver)
  3. In your browser, enter the address to your site, such as: (or if you uploaded it into another subdirectory such as foldername use
  4. Rename the /includes/dist-configure.php and /admin/includes/dist-configure.php files to "configure.php" and make the files writable (so the install process can write your configuration information into them after you answer a few questions in the following steps).
  5. Also make the /cache and /logs folders writable. (You will be prompted about making other folders writable during installation)
  6. Follow the instructions that appear in your browser for installation.

If some of the terms used in these brief instructions are things you don't understand, there is a much more detailed set of instructions in the /docs/Implementation-Guide PDF.

Guidance for Secure Installations

The Implementation Guide document is provided to give detailed instructions on how to install and secure your site in accordance with PCI Compliance requirements. Whether your site "needs" PCI Compliance or not is up to you to decide, but you should still follow the documented principles to maximize your site's resiliance against troublesome access attempted by any undesired/unauthorized visitors.


Use your browser to open the /docs/index.html page for links to documentation and the Implementation Guide.

Developer Documentation

Developers wishing to contribute to the Zen Cart® core code may fork the zencart/zencart repository on github and issue Pull Requests from their own feature branches. For detailed help on using github, forking, branching, and contributing see Contributing to Zen Cart code.

Visit for version-specific guidance on issues relevant to developers. You may also help with this site by forking the zencart/documentation repository on github and submitting pull requests.

Developers will find the standalone Habitat VM to be a useful tool for staging site upgrades and doing offline feature development or testing. Designers may like it for testing new templates without affecting the live site.


For free support, visit our support site:

Follow Us

For news and updates about Zen Cart®, follow us on Twitter and Facebook

Sign up for our free Newsletter

Subscribe to Critical News Updates And Release Announcements


©Copyright 2003-2017, Zen Cart®. All rights reserved.