...
A) Create a New Custom Field:
- Login to the CMS.
- Navigate to 'Custom Fields'.
- Click 'Products'.
- The page will load, displaying existing custom fields from the Products table.
- Click the 'Add New Custom Field' button.
- Populate the Custom Field Details as specified:
- Field Name - a code to associate with this field in the database. Alphanumeric only, with no spaces or special characters.
- Prompt - the field prompt/title which displays to Administrators on the Product Maintenance screen.
- Help - additional information which displays to Administrators on the Product Maintenance screen.
- Data Type:
- Text - alphanumeric characters, including spaces, special characters, and html.
- Integer - whole numbers
- Decimal - numeric data including fractional components
- DateTime - calendar dates and times
- Boolean - 2 values, e.g. True/False
- Allow Unlimited Text (for data type 'Text' only) - ticking this box removes the character limit from the field.
- Length (for data type 'Text' only) - where unlimited data has NOT been allowed, this sets the maximum field length.
- Display Type - the interface which displays to Administrators on the Product Maintenance screen. Options here will change depending on the Data Type selected earlier. Possibilities include TextBox, DropDownList, and DateTimePicker.
- Mandatory - ticking this box makes the custom field required in Product Maintenance.
- Active - ticked by default. Leave as is.
- Click 'Save' to create the custom field.
...
- Navigate to 'Catalogue' --> 'Product Maintenance'.
- Search for the required product by Product Code or Description.
- Click the 'Edit' button against the product.
- Scroll to the 'Custom Fields' section.
- Edit the data as required.
- Click 'Save'.
...
- Navigate to 'Layouts' --> 'Templates'.
- Scroll to the 'Product' section and click the 'Product Detail' or 'Product List Item' template as required (this example will use the Product Detail template).
- Locate the appropriate zone for the custom field widget. The optimal location will depend on site layout, but common placements include 'Zone MainRight' or 'Zone Bottom'.
- Click the 'Add Widget' button.
- Select 'Product Field' from the drop-down list.
- Click the 'Add' button.
- Drag the widget to the desired sequence in the widget list, if required.
- Click the 'Edit' button to configure options. A modal window will appear.
- Configure the widget as required:
- Description - a descriptive reference for the Administrator on the layout page. This does not display on the front-end website.
- Layer - this widget can be rendered conditionally based on role or customer, or displayed under all conditions (All Pages).
- Product Field - select the new custom field from the drop-down list. The format will be the Field Name prefaced with 'CUS_'.
- Show Heading - tick this box to include a heading for this widget.
- Heading Text - the heading text displayed to the end user.
- Fallback Information - default text can be entered, to be displayed against products with no data in this field.
- Show Toggle - allows the content to be hidden by default, and displayed when the user clicks on the Heading.
- Show Inline Heading - allows the heading to be displayed in line with the field content (ignored when toggle is in use).
- Show On Mobile - when ticked, this field will display on mobile devices, when unticked the field will be excluded.
- Click 'Save'.
The custom field widget will now render on the relevant product template.
Related articles
...