e-Commerce Installation

Last updated March 16, 2008. Created by skiquel on February 20, 2006.
Edited by sime, add1sun, Senpai, AjK. Log in to edit this page.

Backup Your Site

Important: Please back up your site and database first. If you need instructions on how to backup your site files and your database, refer to the backing up your site documentation.
Once you have a working backup, proceed as follows:

Installing The Modules

Download the files

Download e-Commerce (v3) from the project page. The current recommended download is 5.x-3.x-dev, even though there's an earlier 5.x-3.3 release. Note that the "3" part is what people are referring to when they mention "version 3". Untar/unzip the files and place the entire ecommerce directory in an appropriate module directory like /sites/default/modules.

Download Token module and put it in your modules directory also.

Enable the base module(s)

Navigate to the Modules page via Site building » Modules. Find and click next to the Store module and then click "Save configuration" at the bottom of the page. This will install all of the main e-Commerce modules.

Additional modules

The rest of the modules can be considered optional. e-Commerce modules are grouped into 4 major categories: core, payment, product and uncategorized. There is information next to the module defining dependencies with some modules (ec_media) requiring you to install modules from outside e-Commerce.

Standard settings

Go to e-Commerce configuration » Mail and here you can set up the emails templates that correspond to various situations. You can use special placeholders, like [user] that will be replaced with the actual data.

Go to e-Commerce configuration » Store and make some simple decisions about your store:

• Can the customer purchase anonymously?
• Do you want transaction notices sent periodically (requires cron)?
• Are the e-Commerce core modules all installed?
• What text would you like to display on the user's order history page?
• Set emails for invoice, payment error, questions, cancellations
• Should "add to cart" be a link? Or allow entering a quantity?

Go to e-Commerce configuration » Payment and check that your price formatting is to taste. Also on this page is a payment testing option that you should be aware of, because this setting is usually in addition to settings used by the various payment modules.

Set the order of pages in the checkout process by going to
e-Commerce configuration » Payment. Adjust the order as required and click Update screen order.

You can optionally enable the cart block at:
Site building » Blocks

Grant the proper access to user accounts under:
User management » Access control. The main access control provided by e-Commerce core is "administer store" in the Store section. Remember, each time you enable a module, you should check this page for new permissions that may need to be assigned.