X-Cart:Extra Fields

From X-Cart 4 Classic
Revision as of 09:00, 28 January 2010 by Admin (talk | contribs) (Adding Extra Fields)
Jump to: navigation, search

What Extra Fields module does

If you think the 'Product details' form used in X-Cart to provide information about products is lacking some fields, you should consider using X-Cart's Extra Fields module. This module allows you to create custom fields for the 'Product details' form.

For example, the module can be used to add 'Author' or 'ISBN' fields to a product that is a book:

Extra field1.gif

X-Cart supports product search by extra fields both in the Customer area and in the store's back end, so putting information by which a product is likely to be searched for in extra fields can facilitate finding products.

To enable search by extra fields in the Customer area, go to Settings -> General settings -> Product search options and enable search by the required fields. Check boxes "Search also in: %EXTRA_FIELD_NAME%" appear in the Customer area.

If a customer selects such a check box, search will also be conducted

Roles in Extra Fields module management

If you are an X-Cart GOLD administrator/provider:

If you are an X-Cart PRO administrator:

  • You can enable/disable Extra Fields module and adjust its configuration settings (See #Enabling and Configuring 'Extra Fields').
  • You can define which of the extra fields created by the store providers need to be included into the product search form (See #Enabling Search by Extra Fields).
  • You can see the extra fields of any product in the store regardless of what provider the product belongs to.

If you are an X-Cart PRO provider:

Enabling and Configuring 'Extra Fields'

To begin using the module:

  1. Enable Extra Fields module (Administration menu->Modules).
  2. If you enable the module in an X-Cart PRO-based store shared by multiple providers, adjust the maximum number of extra fields each provider will be able to define (General settings/Modules options->Extra fields options):

Extrafields opts1.gif

Click the Save button.

Adding Extra Fields

Creating extra fields

To add an extra field:

1. Go to the 'Extra fields' section of the store's back end (Products menu->Extra fields). You should see a dialog box titled 'Extra fields':

Extra field0.gif

2. Use the 'Add extra field' subsection of the 'Extra fields' dialog box to provide the details of the new extra field:

  • FIELD NAME - Name of the extra field as it will appear in the store interface (both in the store's back end and in the Customer area).
  • SERVICE NAME - Unique name by which the application will be able to identify the extra field. This value will not appear anywhere in the store interface and will be the same for all the store languages.
  • DEFAULT VALUE - Value that will appear in the extra field by default; will not be visible to customers unless saved by administrator or provider as the value of the extra field in the 'Product details' form. Completion of the DEFAULT VALUE field is optional.
  • SHOW - Check box defining the extra field's availability to customers (Selecting the check box makes the extra field visible in the Customer area. Unselecting the check box hides the extra field from the Customer area, but leaves it available for editing in the store's back end).
  • ORDERBY - Numeric value defining the position of the extra field on the 'Product details' page (In X-Cart PRO version, the position is defined relative to the other extra fields of the same provider).

3. Click the Add new button. The extra field should be added to the list of extra fields above. You should see an Information box with a confirmation message.

Note: After an extra field is created, it becomes available on the Product details page of every product that you can edit using your current account. However, please be aware that, no matter whether you have defined a default value for an extra field or not, the extra field does not appear on the Product details page of a product in the Customer area until you visit the Product details page of that product in the store's back end and assign a value to the field or approve the default value. See the chapter #Assigning Values to Extra Fields for details.

Managing multilingual extra field names

If your store supports more than one languages, you need to provide names for your extra fields in all the languages supported by your store.

To add a name for an extra field in a language other than the default store language:

1. Open the 'Extra fields' dialog box containing a list of your extra fields:

Extra field2.gif

2. From the language selector in the top right-hand corner of the 'Extra fields' dialog box, select the language in which you would like to add a field name. There will be a page refresh and you should see the language of the store's back end change to the language you selected.

3. Edit the names of the extra fields in the list replacing the values in the FIELD NAME column by field names in the selected language.

Note: The value of the FIELD NAME field is the only thing that needs to be changed for specific languages. An extra field's service name, default value, availability and position number remain the same for all the store languages.

4. Click the Update button to save the changes. The new values should be applied. You should see an Information box with a confirmation message.

Assigning Values to Extra Fields

Managing Extra Fields

Enabling Search by Extra Fields