X-Cart:Configurator

Overview

What X-Configurator does

X-Configurator enables you to sell composite products with many interchangeable and optional components, where buyers are allowed to build their own product configurations. With that, the module can prevent non-expert customers from misconfiguring a particular product. For each product component the store administrator can set up rules of how to avoid possible incompatibility with other product components. For example, you can define that the AMD motherboard requires the Athlon processor, and your customers will not be able to order an AMD motherboard together with an Intel Pentium processor. This ensures that the customer will not order a misconfigured product, and this will not become the reason for a complain or a refund.

Originally developed for stores that sell computers, cell phones, home cinemas and other electronics, X-Configurator has now proven that it can be successfully used in online stores that sell various types of composite products, including furniture suites, air conditioning systems, hosting plans, golf club sets, bicycles, etc.

Among the key features of the X-Configurator module are:

• Unlimited number of composite products;
• Flexible product configuration;
• Compatibility checking mechanism;
• Step-by-step product builder.

How X-Configurator works

First the store administrator (in X-Cart Gold) or a provider (in X-Cart Pro) defines product types and specifications. The both parameters are used to classify products so that they could be included into a configurable product. A product type is a way to classify a product generically, while a specification aims at classifying the product more precisely. For example, if you sell computers in your store, you can have the product type "Desktop RAM" with its specifications "DDR", "DDR2" and "DDR3". These parameters enable you not only to classify separate products, but also to resolve incompatibility issues like in the situation when a DDR3 memory module would require a DDR3-compatible motherboard and would not work with other motherboards.

After product types and specifications have been defined, the store administrator or the product provider should classify the products in the store that will be used as components for configurable products, i.e. assign every product to a particular product type and specification, and define the requirements for the product: product types and specifications that the compatible products must belong to. Continuing the previous example, the product Patriot Viper 6GB 1600MHz DDR3 Memory Kit would belong to the product type "Desktop RAM" and the specification "DDR3", and it would have the requirements like the product type "Motherboard" with the specification like "DDR3 -compatible".

The next step is to add a configurable product and define its attributes, which is very similar to creating an ordinary product.

Finally, you need to create a scenario for the configuration builder, the step-by-step wizard that will help your buyers configure the product. The wizard can consist of several steps. Every step can have one or more slots that are used for selecting particular products and can be either optional or mandatory.

Interaction with other X-Cart modules

When you use X-Configurator together with the X-FeatureComparison module, your store visitors can compare interchangeable product components before they add a particular component into the product configuration. This would generally enhance your customers' experience as they would be able to make a more thoughtful decision on which component they want to include into the configuration.

Installing and Uninstalling X-Configurator

System requirements

To be able to successfully install and use X-Configurator you must have a working copy of X-Cart Gold or X-Cart Pro already installed on your server. Make sure that the version of the module is the same as the version of the installed copy of X-Cart.

Note: If you do not remember the version of the installed copy of X-Cart, find it in the Summary/Environment info section of the X-Cart Admin area (Administration menu -> Summary).

Installing X-Configurator

To install the module:

1. Obtain the distribution package for the X-Configurator add-on module by downloading it from the File Area section of your personal Help Desk account at https://secure.qtmsoft.com/ .

The distribution package you need is contained in the archive file x-pconf-x.y.z.tgz where x, y and z are the version numbers of the module, which must be the same as the version of the installed copy of X-Cart (e.g. 4.3.0., 4.3.1., etc.).

2. Put the distribution package to the X-Cart root directory on your server or hosting account.

• If you use a Windows-based server, or a UNIX-based server without terminal access:

1. Decompress the archive with the X-Configurator distribution package to a directory on your local system. To decompress the archive you can use your favorite compression program like WinZIP or any other archiver with support for TAR files.
2. Use an FTP client to upload all the files contained in the archive (retaining the directory structure) to the X-Cart root directory on your server or your hosting account.

• If you use a UNIX-based server with terminal access:

1. Use an FTP client to upload the archive with the distribution package to the X-Cart root directory on your server or your hosting account.
2. Decompress the package using one of the following commands:

gunzip < x-pconf-x.y.z.tgz | tar -xvf -

or

tar -xzvf x-pconf-x.y.z.tgz

3. In a web browser, run the installation script http://www.example.com/install-xpconf.php replacing www.example.com with the true URL of where X-Cart is installed to. This will launch the Installation Wizard.

4. Enter the Auth code, accept the License Agreement and click the Next button.

Note: The Auth code is a random code that is used to prevent unauthorized access to the X-Cart installation scripts. The code was generated automatically when you installed X-Cart onto your server or hosting account. If you do not remember the Auth code, find it in the Summary section of the X-Cart Admin area (Administration menu->Summary) before the License info subsection. The alternate way to know the code is to retrieve the value of the variable $installation_auth_code from the file <xcart_dir>include/install.php .

After you have clicked on Next, the installation script will copy the files and activate the module.

5. Click the Next button to continue the installation. The installation script will generate a new system fingerprint.

6. Click the Next button to finish the installation.

Uninstalling X-Configurator

To uninstall the module:

1. In a web browser, run the installation script http://www.example.com/install-xpconf.php replacing www.example.com with the true URL of where X-Cart is installed to. This will launch the Installation Wizard.
2. Select the radio button Uninstall the module, enter the Auth code and click the Next button.

Note: The Auth code is a random code that is used to prevent unauthorized access to the X-Cart installation scripts. The code was generated automatically when you installed X-Cart onto your server or hosting account. If you do not remember the Auth code, find it in the Summary section of the X-Cart Admin area (Administration menu->Summary) before the License info subsection. The alternate way to know the code is to retrieve the value of the variable $installation_auth_code from the file <xcart_dir>include/install.php .

Glossary

Base price 

The cost of a configurable product without the cost of the product options and separate components.

Component 

A regular product from the common stock that customers can select as part of a configurable product while ordering the configurable product. Before a product can become available for selection as part of a configurable product, the product must be classified, i.e. assigned to at least one product type.

Composite product 

See Configurable product.

Configurable product 

A product that can consist of many interchangeable components. Configurable products have most of the attributes that regular products have. Components for a configurable product are selected by the store customers when they order the product.

Configuration wizard 

A step-by-step wizard in the customer area that guides customers through a series of steps where they can select components for the configurable product.

Price modifier 

A slot attribute that is used to change the original cost of the slot products. Can be either positive (markup) or negative (markdown).

Product requirements 

A combination of product types and specifications that the compatible products must belong to.

Product type 

A classifying unit that is used to classify products generically. The set of the available product types in the store is defined by the store administrator (X-Cart Gold) or the store providers (X-Cart Pro).

Slot products 

A set of products that can be selected in the slot. The set is defined by the slot rules.

Slot rules 

A product type or a combination of several product types that defines the set of products that can be selected in the slot.

Slot 

A unit of a wizard step that is used to select a particular component for the configurable product. The set of products that can be selected in the slot is defined by the slot rules and is known as slot products.

Specification 

A classifying unit that is used to classify products belonging to a particular product type more precisely. The set of the available product types in the store is defined by the store administrator (X-Cart Gold) or the store providers (X-Cart Pro).

Step 

A move in the configuration wizard on the customer storefront. At every step of the wizard customers can select one or more product components.