X-Cart:Feature Comparison

Overview

X-FeatureComparison enables your customers to use feature-based comparison service.

Unless a customer comes to your store with his mind set on a specific product, he is likely to browse and compare different products trying to determine which product will be right for him.

Feature-based comparison service facilitates the process of choosing the right thing by a customer: the user enters a desired combination of features, and the system then determines the product or products that provide that combination. For instance, if a customer is looking for a mobile phone, but is not yet sure as to its model, he can pick the desired mobile phone features (e.g., dual or triple band, light weight, replaceable covers, or programmable ringtones) and immediately buy the phone that matches the requirements. Visitors can also pick a product and compare it side by side with other products, so the customer can pick a product that he likes, and then compare other products against it to see if there are any better choices.

Using X-FeatureComparison module provides the store admin/provider users with the following abilities:

• to group products into product classes
• to define features specific to product classes
• to assign class-specific features to products
• to create multilingual names for product classes and class-specific features.
• to search for products by their product class

The customers get the ability:

• to search for products by features
• to compare products of the same class with one another

Installation

To install the module you have to perform the following actions:

1. Download the module distributive (x-fcomp-x.y.z.tgz, where x,y,z are the numbers of the module version) from File Area section of your X-Cart Account. 2. Uncompress the x-fcomp-x.y.z.tgz file and copy the files to X-Cart directory.

Note: Please make sure you keep the directory structure during unpacking and uploading, otherwise some necessary files can be overwritten!

3. Run in the browser the installation script http://www.yourhost.com/xcart_dir/install-xfcomp.php 4. Enter your authentication code, accept conditions of the License Agreement and click Next.

Note. The authentication code is issued on completion of X-Cart installation. It is used to prevent unauthorized re-installation of X-Cart and to install X-Cart modules (if you decide to purchase them). If you forgot the code, you may look it up at any time in include/install.php file.

5. Installation script will copy the files and make all the necessary changes in the database. 6. After module Installation is completed, you need to log in as Admin and

• enable Feature Comparison from the Modules section
• set the module options in General settings/Feature Comparison options.

X-Cart Gold and Pro module installations do not differ.

Configuring settings

To set up the options affecting the work of Feature Comparison module in your store:

1. Select General settings from the Administration menu.
2. Click the Feature Comparison options link in the section menu.
3. Set up the following options:

• The product class image width in the product classes list: Set the desired image width in pixels.
• Enable adding products to comparison lists for further comparing: Select this check box if you want to enable your customers to add products they want to compare to a special list appearing in the 'Comparison list' box in the menu column. If you leave this check box unselected, the link 'Add to comparison list' will not be displayed, so there will be no way for your customers to use the 'Comparison list' box.
• Enable feature-based search: Select this check box to allow your customers to search for products, possessing the specified features.
• The maximum number of products in the comparison list in the menu column: Specify the maximum number of products which a customer will be allowed to add to the Comparison list.
• Maximum number of products which can be shown on the feature-based comparisons page and on the Product details page in the form of a select box: If the quantity of products for comparison exceeds the number specified here, product selection will be done in a popup window: Specify the maximum number of products for comparison that will be able to appear in a select box.
• Maximum number of products which can be compared: Specify the maximum number of products that a customer will be allowed to compare at a time.

Click Save to apply the changes.

Administrative interface

Adding, updating and deleting product classes

Product classes can be defined in the ‘Product classes’ section of the store.

X-Cart PRO providers can access this section by clicking the Product classes link in the Catalog menu.

X-Cart PRO admin and X-Cart GOLD admin/provider can access this section via the Product classes link in the Catalog menu.

In the ‘Product classes’ section existing product classes appear in the ‘Product classes’ form.

To create a new product class:

1. Click the ‘Add product class’ link in the section menu. The ‘Add product class’ form will appear.

2. If necessary, add an icon for the product class being created (Icons associated with product classes appear on the ‘What are you looking for?’ page in the customer area along with the product class titles):

• Click on the ‘Change image’ button below the default ‘No Image Available’ picture. Confirm you desire to change the default image.
• Use the ‘Image selection’ window to select the image file which you want to use as the product class icon.
• Click on Apply. The new image will appear in the ‘Add product class’ form, replacing the default ‘No Image Available’ image. (Please note that at this point the image is merely selected, not saved. It will be lost if you refresh the page.)

3. Enter a title for the product class into the ‘Product class’ field. 4. Specify whether the class should be shown to the customers or not by selecting Yes or No from the ‘Enabled’ selectbox. 5. Specify the position number of the product class in the list of product classes (‘OrderBy’ field).

6. Click on ‘Add’. As soon as the product class is created, you will be informed about it by a message in the ‘Information’ box.

After the creation of the new product class, you can see another form appearing in the place of the ‘Add product class’ form. This new form is titled ‘Modify product class’.

This form allows you to modify the details of the product class you have just created (if necessary) and to define product class options (features) for it. You can turn to modifying the product class details (image, title, availability, or OrderBy position number) and defining product class options (features) at once, or put it off till later (The ‘Modify product class’ form can be accessed at any time by clicking on the title of the product class which you want to modify in the ‘Product classes’ form). To find out how to modify a product class, please refer to the ‘Modifying product classes’ section of this User guide.

To add more product classes, use the ‘Add product class’ link in the section menu.

To return to the list of product classes (‘Product classes’ form), click the ‘Product classes list’ link in the section menu. You will see the product classes you created in the form of a list in the ‘Product classes’ form.

The ‘Product classes’ form in X-Cart GOLD and in the Provider area of X-Cart PRO contains a 3-column table (PRODUCT CLASS / ENABLED / ORDERBY). In the Admin area of X-Cart PRO the table includes 4 columns (PRODUCT CLASS / ENABLED / ORDERBY / PROVIDER). The PROVIDER column allows the store admin to find out who created this or that product class.

You can change the availability status of your product classes and the order in which they are displayed right in the ‘Product classes’ form. To do so, select Yes or No from the ENABLED selectbox, change the product class position number in the OrderBy field opposite the title of the appropriate product class and click on Update. The changes will be saved.

To delete a product class, select the check box next to the title of the product class you would like to delete and click on ‘Delete selected’. The product class will be removed from the list. (You can use the Check all / Uncheck all links to select or unselect all the check boxes).

Modifying product classes

Modifying product class details

To modify the details of a product class:

1. Open the ‘Modify product class’ form.

2. If necessary, change or delete the class icon.

To change the icon, click on the ‘Change image’ button, select the image with which you want to replace the old one and click on ‘Apply’. The new image will appear in the ‘Modify product class’ form. (Please note that at this point the image is merely selected, not saved. It will be lost if you refresh the page.)

To delete the icon, click on the ‘Delete image’ button.

3. If necessary, change the product class title, availability status and OrderBy position number. 4. Click on ‘Save’.

Managing product class options (features)

To define product class options (features):

1. Open the ‘Modify product class’ form. Scroll down to the ‘Product class options’ section of the form.

2. Use the ‘Add new option’ subsection to add product class options:

1. Enter a name for the new option (Option column).
2. Enter tooltip text to be displayed when the mouse cursor is placed over the option name.
3. Use the selectbox in the Option type/Format column to select the option type (Please refer to the ‘Notes on options types’ section of this User guide to get information about the types of product class options).
4. Select Yes or No from the selectbox in the Enabled column to specify whether the feature should be displayed to customers or not.
5. Select Yes or No from the selectbox in the Show in search column to specify whether the feature should be available as a search criterion.
6. Enter a position number of the option in the list of product class options (OrderBy column).
7. If applicable, specify available variants for the option being created: enter the variant names in a column, each variant starting from a new line (Variants column).
8. Click on ‘Add’. The option will be created and added to the list of options in the ‘Product class options’ section of the form.
9. If applicable, specify the format in which concrete values of the option should be displayed (Option type/Format column, below the option type selectbox). Click on ‘Update’.
10. Repeat steps a-h to add more product class options.

To delete product class options (features):

1. In the ‘Product class options’ section of the ‘Modify product class’ form select the check boxes next to the names of the product class options which you want to delete.
2. Click on ‘'Delete selected options'’.

To modify product class options (features):

1. In the ‘Product class options’ section of the ‘Modify product class’ form change the necessary product class options’ settings.
2. Click on ‘Update’.

To modify the variants of a product class option:

1. In the ‘Product class options’ section of the ‘Modify product class’ form click on the option variants which you want to modify. The ‘Variants setup’ box will appear blow.

2. Use the ‘Variants setup’ box to modify the contents of the variants section:

• To rename one or more of the existing variants, change the names of the variants you want to rename and click on ‘Update’.
• To delete one or more of the existing variants, select the check boxes next to the names of the variants you want to delete and click on ‘Delete selected variants’.
• To add a new variant to the list, enter a name for the new variant in the ‘Add variant’ subsection and click on ‘Add’.

3. Click on the X (‘Close’ sign) in the top right corner of the ‘Variants setup’ box. The box will be closed.

In a multilingual store, names of product classes, product class options and option variants can be entered in different languages.

To enter multilingual names:

1. Select the necessary language from the Language selectbox in the top right corner of the ‘Modify product class’ form. The page will be refreshed and the product class title, product class options and option variants fields will be emptied allowing place for you to enter new names in the selected language.
2. Enter the product class name into the ‘Product class’ field and click on ‘Save’.
3. Provide names for the product class options and click on ‘Update’.
4. Click on each of the option variants links, provide new names for the variants and click on ‘Update’.
5. If you need more languages, repeat steps 1-5.

Notes on option types

X-FeatureComparison module supports the following option types:

• Text field
• Single option selector
• Multiple option selector
• Numeric field
• Boolean field
• Date field

These types determine the way in which providers and customers will be able to input data into the fields corresponding to product class options.

Text field is a simple text field into which custom text can be entered. Any characters entered into a field of this type are regarded as text. This option type requires the option field format to be specified (Input box or Text area, depending on the amount of text that needs to be entered).

Single option selector is a field displaying a predefined set of values from which only one can be selected. This option type requires variants to be provided.

Multiple option selector is a field displaying a predefined set of values from which several values can be selected. This option type requires variants to be provided.

Numeric field is a field that allows users to enter numeric values so they are treated as numbers (which allows customers to search for products using number ranges). This option type requires the option field format to be specified.

Boolean field is a field from which only one of the two values can be chosen: Yes or No (signifies presence or absence of some feature).

Date field is a field that allows users to enter dates (customers can search for products using date ranges). This option type requires the option field format to be specified.

Assigning product classes to products

After the necessary product classes have been defined, they need to be assigned to the products for which you want to allow comparison.

Note: It is not necessary that all the products in the store have a product class: assign product classes only to the products which can be compared.

To assign a product class to some product:

1. Find the product and open it for modification. 2. Click the ‘Product class’ link in the section menu.

‘Assign product class’ form will appear. As the product has not been assigned to any product class yet, ‘Undefined’ appears in the ‘Product class’ selectbox.

3. Use the selectbox to select the product class to which you want the product being modified to be assigned.

4. Click on ‘Apply’. The product class will be assigned. The ‘Product class options’ form will appear below the ‘Assign product class’ form (The set of fields in the ‘Product class options’ form corresponds to the product class selected for the product).

5. Use the option fields in the ‘Product class options’ form to assign the necessary option values to the product being modified.

6. Click on ‘Update’. The changes will be applied.

Searching for products with defined product classes

The store administrator can search for products by product classes. When X-FeatureComparison module is installed and enabled and at least one product class has been created, the ‘Advanced search options’ section of the search form in the Admin area includes ‘Product classes’ field. This field is a selectbox from which you can select the product class to which the product being searched for belongs.

Importing/Exporting data

Procedures

Information on import/export procedures can be found in X-Cart:User manual contents#Operating Your Store section.

CSV Format

Classes of products are imported/exported through the section [PRODUCT_CLASSES].

Format

!FCLASSID - product class ID

!CLASS - product class name

!AVAIL - activeness indicator (Y - this class is active, empty value - inactive class)

!IMAGE - the path to the imported image for this class

!ORDERBY - product class number

Required fields

!CLASS

Classes international names are imported/exported through the section [MULTILANGUAGE_PRODUCT_CLASSES]

Format

!CLASS - product class name (conf. [PRODUCT_CLASSES])

!CODE - language code (for example: US)

!CLASS_NAME - class international name

Required fields

!CLASS

!CODE

!CLASS_NAME

Features specific to product classes are imported/exported through the section [PRODUCT_CLASS_OPTIONS]

Format

!CLASS - product class name (conf. [PRODUCT_CLASSES])

!OPTIONID - product class option unique ID

!OPTION - option name

!TYPE - option type ("T" - text field, "S" - select box, "N" - numeric, "B" - Boolean, "D" - date, "M" - multiple select box)

!FORMAT - option format (for example, a text field can have 2 formats: I - input field, T - text field).

!VARIANTS - possible value variants for the fields which suppose selecting a value

!AVAIL - activeness indicator

!ORDERBY - number

Required fields

!CLASS

!OPTION

Option international names are imported/exported through the section [MULTILANGUAGE_PRODUCT_CLASS_OPTIONS]

Format

!CLASS - product class name

!OPTION - product class option name

!CODE - language code (for example: US).

!OPTION_NAME - option international name

Required fields

!CLASS

!OPTION

!CODE

!OPTION_NAME

Products related to a product class are imported/exported through the section [PRODUCT_FEATURE_VALUES]

Format

!PRODUCTID - unique product ID

!PRODUCTCODE - product SKU number

!PRODUCT - product name

!CLASS - product class number

!OPTION - option name

!VALUE - option value for the given product

Required fields

!CLASS

!OPTION