The cart module provides snippets and manager functionality to allow users to add products to a shopping cart, pay for their selected products via various online payment gateways and finally monitor the order and previous orders.

Note: The cart module requires clearFusionCMS 1.2.0 or later in order to install and function.

Initial Setup

After the shopping cart module has been uploaded and installed it must have an initial configuration applied before it can be used.

The Store Address

Setting the store address is the first operation that must be done after installing the cart module, until this step is completed you will simply get errors. To set the store address within the site manager select Settings then Cart followed by Store Address, you must complete all the fields on this page before clicking Save Address.

The cart uses information from this page when calculating shipping and other portions of the order.

Note: If you've already tried to use the cart without setting the store address then you will need to clear your browser cache and the cookies to get everything working properly.


Now the cart has a home address the next stage is to create at least one zone. Zones allow you to break the countries of the world into manageable groups so rather than having to create settings for every country you only have to configure a zone and all the countries in that zone will have those options applied to them.

From the Dashboard click Zones followed by Add Zone. For the purposes of this example we're going to create a zone just for Australia, so in the Zone Name box enter Australia and then tick all the Australia regions in the regions list, finally click Create Zone.

You can create as many zones as you require, you may have a zone for your country and a zone for the rest of the world, if you did this then you can offer different tax and shipping rates depending on the zone the shopper resides in.

Product Classes

In most cases stores will only require a single product class, however there are cases where multiple product classes are required e.g. if a class of products attracts a different rate of tax to your standard products. All stores are required to have at least one product class to function.

From the Dashboard select Product Classes followed by Add Product Class and in the Product Class Name field enter Standard as we're only creating a single standard product class in this example. Click Add Product Class to create your new class.


The Taxes option allows you to create tax rates for different combinations of zones and product classes, it allows you to charge tax for on shore customers and no tax for exports.

To create a tax rate, in this case GST at 10%, from the Dashboard select Taxes and click Add Tax.

Enter GST in the Tax Name field and 10 in the Tax Rate % field, finally click Australia under Apply Tax to Zones and Standard under Apply Tax to Product Classes before clicking Create Tax.

A tax can be applied based on the billing address or on the shipping address, which is appropriate will depend on the tax laws within your country, if you're unsure you should seek advice from your local tax office.

In our sample store we only have one zone and one product class but in a live store selling internationally you will most likely have multiple zones and product classes. When creating or editing a tax you can select as many zone or classes as required.

If You Don't Charge Tax

If you don't need to charge the customer tax then you must still create a tax information for your cart but in this case set the tax rate to 0 then return to Settings then Cart. Under Cart Settings tick Do not show amount of tax fields on cart and orders and make sure Show without tax prices as well as price including tax is not ticked. This will avoid showing tax information to customers.


The cart is installed without currency information, so next select Currency from the Dashboard and click Add Currency.

We're going to add Australian Dollars as the default currency, you can add multiple currencies with different exchange rates, if you choose to do so shoppers are able to select the currency that they wish to view your prices in.

In the Currency Code field put AUD, tick Use as Default Currency and in the Left Currency Symbol filed enter $, now click Create Currency. With this setup prices will be formatted as $123,456.00.

Shipping Methods

The final step of configuring the cart module is to create one or more shipping methods, without a shipping method your customers will not be able to complete a purchase from your site.

From the Dashboard select Shipping and click Add Shipping Method. In this example we're going to create a flat fee shipping method charging $10 per shipment.

Enter Standard in the Shipping Method Name field, from the Cost Calculation dropdown select Flat Rate and enter 10 in the Cost field. The Product Class dropdown allows you to treat shipping differently to other products by selecting a different class, for now leave this as Standard. Tick both Australia under Geographic Regions and Standard under Product Classes before clicking Create Shipping Method.

By choosing the Geographic Regions and Product Classes a shipping method applies to you can define complex options of which shipping methods will be available for each product and shipping destination.

Note: The cart can support multiple shipping methods per order, multiple options are only presented to the shopper if the cart has valid shipping options for all the products but products don't share common shipping methods.

Default CSS

The cart module includes a default style sheet to get you started, just add the following line above </head> in your template to include it:

<link href="system/modules/cart/cart.css" rel="stylesheet" type="text/css">

While the default CSS provides a useful stating point you will in most cases want to refine the style to make your site unique.