Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. In the CMS, navigate to Advanced Content → Custom Fields

  2. Select the table you wish to add your custom field to (e.g. Categories, Products, Users).

  3. The page will load, displaying any existing custom fields for the table you selected.

  4. Click the Add New Custom Field button. 

  5. In Add Custom Field Details, enter the field requirements (for display and entry of values by administrators): 
    • Field Name - a code to identify this field in the database. Alphanumeric only, with no spaces or special characters. Underscore ( '_ ') permitted.
    • Prompt - the field label displayed next to the field.
    • Help - additional information about the field displayed.
    • 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 - checkbox for 2 value option, e.g. True/False, Yes/No
        • Identity - checkbox will display an ON/OFF toggle
    • Display Type - the interface displayed to Administrators on the page the field appears in. NOTE - Display Type options depend on the Data Type selected.

      Expand
      titleClick here to for an explanation of display types...


      Display TypeAvailable for Data TypeExample
      Text BoxText, Integer, Decimal

      One line text box

      Multi-line Text BoxText

      HTML Text BoxText

      WYSIWYG content editor that allows the text to be formatted

      Dropdown ListText, Integer, Decimal

      Image SelectorText

      Numeric Text BoxInteger, Decimal

      Date PickerDateTime

      Time PickerDateTime

      Date/Time PickerDateTime

      BooleanCheck box



    • Allow Unlimited Text - (for Text Display Type only) tick to allow unlimited amount of text 
    • Mandatory - tick to make the custom field required on the page it displays in.
    • Active - leave ticked for the field to be in use. Untick to make inactive.


  1. To save the custom field, click Save.

...

  1. Navigate to Content → Pages & Templates.

  2. Select the page template to display the custom field. 
    1. Custom Product fields are commonly displayed on the Product Detail Template.
    2. Custom Category fields are commonly displayed on the Product List or Category List Template. 

  3. Locate the appropriate zone you want the field to display in. The optimal location will depend on your layout.

  4. Click the Add Widget button.

  5. Search for the required widget (for example 'Product List Field' or 'Category List Field' widget). 

  6. Click the Add button. 

  7. Configure options for field display:
  8. Click Save.


The custom field widget will now render on the relevant  template.

...