Prerequisites

KiweeCommerce is in its first release, so we've only tested it against the following versions:

• LAMP stack (no WAMP/XAMPP yet)
• MODx 0.9.6 stable or newer
• PHP 5

It may or may not run on older/different versions of the above, especially older MODx installations. Back-porting and porting to other platforms is on our TODO list for future releases.

To install KiweeCommerce you will need to have write access to the index.php file at the root of the MODx installation. This allows us to install the menu hooks to integrate with MODx itself.

You will also need permissions to create tables in the database behind your site, so KiweeCommerce can add its own entries to track its data.

We will be submitting patches to the MODx developers that allow us to install hooks for menu and language-file entries without modifying the core MODx files. In the future, you will not even need write permissions for the MODx installation itself.

Downloading and Installing

Start by downloading the version you would like to run. There are three builds available. We recommend the "stable" build for production sites.

Unpack the distribution file into your MODx directory. It will create a subdirectory called "ecomminstall."

Inside this directory is a file called 'dbconfig.inc.php'. Edit this file and change the configuration options at the top to map to your database installation. Then visit:

http://www.yoursite.com/ecomminstall

Fill in the options to match your site installation. The installation script will then run, and will do four things:

1. Add its menu hooks by updating your MODx index.php.
2. Create the database tables it requires to run, and pre-populate some of them with default values.
3. Install its snippets and other code files to provide its functionality.
4. Create chunks to simplify the usage of its hooks. See Templates for more information on how to use these chunks.

After the installation process is complete, you should proceed to Configuration.