e-Commerce Installation

Last modified: March 16, 2008 - 10:57

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.

Disable Cache for anonymous purchasing

Cayenne - August 12, 2007 - 16:32

Well, even regular caching interferes with the checkout procedure. Since anonymous users are not logged in, they get cached, and it all goes into an endless loop.

Either turn caching off or install cache exclude. This applies to v3, at the very least.

very misleading

Phillip Mc - December 9, 2007 - 13:09

The handbook page says that enabling the store module will automatically install all the required modules. That's not true. It gives an error message saying that the anon purchase module needs to be installed first.

so step 1: download and install the token.module

step 2: enable the anon purchasing module

step 3: enable the store.module (which will install all the core modules)

The correct installation instructions appear to be here:

http://www.drupalecommerce.org/documentation/install

phil

 
 

Drupal is a registered trademark of Dries Buytaert.