Drupal e-Commerce

Backup Your Site

Important: Please backup 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

You will need two packages to install Drupal e-Commerce: the Token Module and the e-Commerce package. The e-Commerce package contains many sub-directories each containing their own modules relating to e-Commerce.

1. Download e-Commerce (v4) from the project page. There are three main options to choose from. From most stable, to most recent they are:
   • If you have a live site or new site going live soon, please stick with the stable version (eC3) which can be found in the "view all releases section" of the project page.
   • eC4 has an alpha candidate available for download from the project page. It is considered to be stable, and does not include modules which are under very active development or which still need debugging.
   • The latest version of Drupal e-Commerce is 5.x-4.x-dev. Note that the "4" part is what people are referring to when they mention "version 4." This version can also be downloaded from the project page.
2. Download the Token module
3. Download the Views module
4. Download the Rules module
5. Download the "Views Bulk Operations" module
   • Note: The "Views Bulk Operations" module Requires PHP5 to be running on your webserver

The above packages should be unzipped and untarred and placed in an appropriate module directory such as /sites/default/modules. If you are working from the command line within Linux/Unix you can expand these packages by using the following two commands:
gunzip packagename.tar.gz
tar -xvf packagename.tar

Enable the base module(s)

Navigate to the Modules page via Site building » Modules. Select the following modules:

• Other » Token
• e-Commerce Core » Store
• e-Commerce Core » Anonymous Purchasing

Scroll to the bottom and click "Save configuration." This will install all of the main e-Commerce modules. Note: You must install these three modules before installing any other e-Commerce-related modules. Do not try to install additional modules at the same time. It will not work. If you install other e-Commerce-related modules before you have installed the Store module, the additional modules will not be correctly installed. This is because of a bug within Drupal.

Additional modules

Once you have installed the Store module, you may consider adding additional modules. The rest of the modules are 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 requiring you to install modules from outside e-Commerce (for example: ec_media).

Configuring e-Commerce

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.