This task is for users with the OC Developer role.
When creating a new field, you need to select an Input type. This refers to the kind of data element you need to make; there are several field types to choose from. Each field type has unique settings you can use to customize your field.
The following is a list of the field types you can create.
Textbox
A single-line, free text box, which you can use to input information such as phone numbers or email addresses. These are the options you can set:
- Maximum length: Set a character limit (including spaces) for the text authors can enter.
- Enable: Check this to enable the field.
- Spell checking: Enable the spellcheck function for this field.
- Default Value: Enter a pre-fill value for when a new page is created with this field. You can set different values for multiple languages.
- Validation Message: Set a message to show if the entered value doesn't match the Validation Regex. You can set different values for multiple languages.
- Validation Regex: Enter a regular expression to validate the content entered into this field to ensure content authors can only enter a value in the expected format. You can set different values for multiple languages.
Textarea
A multi-line free text box, which you can use for short descriptions or additional information content areas. These are the options you can set:
- Maximum length: Set a character limit (including spaces) for the text authors can enter.
- Enable: Check this to enable the field.
- Spell checking: Enable the spellcheck function for this field.
-
New line styling: Choose what happens when someone creates a new line (by hitting enter or return) in the Textarea.
- None: New lines will be removed, and the text will be combined.
- New Line - BR: A <br> will render a new line for each enter or return.
- Unordered list - UL: Each line will be rendered as a bullet list item.
- Ordered list - OL: Each line will be rendered as a numbered list item.
- Default Value: Enter a prefill value for when a new page is created with this field. You can set different values for multiple languages.
- Validation Message: Set a message to show if the entered value doesn't match the Validation Regex. You can set different values for multiple languages.
- Validation Regex: Enter a regular expression to validate the content entered into this field to ensure content authors can only enter a value in the expected format. You can set different values for multiple languages.
WYSIWYG
The WYSIWYG (What You See Is What You Get) Editor is a rich text editor, allowing you to include many kinds of content (such as images, links, or tables) and format content. These are the options you can set:
-
Wysiwyg editor options: Enable the options you want to include in your text editor. Content authors may still be blocked from enabled features if page permissions are set. These are the options you can include in your WYSIWYG Editor:
- Images
- Documents
- Media
- Flash
- Tables
- Controls
- Forms
- Personalisation
- Custom styles
Drop Down List
A predefined list of values from which content authors can choose. Drop-down lists only allow content authors to select one option. These are the options you can set:
- Enable: Check this to enable the field.
- Options: Set your predefined list of values. Use the drop-down menu to choose if you want a Default list of values or different lists for different sites. Under Add a new option, enter Text and a Value, and check Is Default if you want this option to be auto-selected when the page is created. Once you select Add, you can move the options in the list, change the Is Default value, or Delete the option. Use the Translate to drop-down to enter the value in multiple languages.
Check Box List
A predefined list of values from which content authors can choose. Checkbox lists allow content authors to select multiple options. These are the options you can set:
- Enable: Check this to enable the field.
- Options: Set your predefined list of values. Use the drop-down menu to choose if you want a Default list of values or different lists for different sites. Under Add a new option, enter Text and a Value, and check Is Default if you want this option to be auto-selected when the page is created. Once you select Add, you can move the options in the list, change the Is Default value, or Delete the option. Use the Translate to drop-down to enter the value in multiple languages.
Radio Button List
A predefined list of values from which content authors can choose. Radio button lists only allow content authors to select one option. These are the options you can set:
- Enable: Check this to enable the field.
- Options: Set your predefined list of values. Use the drop-down menu to choose if you want a Default list of values or different lists for different sites. Under Add a new option, enter Text and a Value, and check Is Default if you want this option to be auto-selected when the page is created. Once you select Add, you can move the options in the list, change the Is Default value, or Delete the option. Use the Translate to drop-down to enter the value in multiple languages.
List Box
A predefined list of values from which content authors can choose. List boxes allow content authors to select multiple options. These are the options you can set:
- Enable: Check this to enable the field.
- Options: Set your predefined list of values. Use the drop-down menu to choose if you want a Default list of values or different lists for different sites. Under Add a new option, enter Text and a Value, and check Is Default if you want this option to be auto-selected when the page is created. Once you select Add, you can move the options in the list, change the Is Default value, or Delete the option. Use the Translate to drop-down to enter the value in multiple languages.
Date
A field to indicate dates and times, such as those on events, projects, or publish dates on news articles. These are the options you can set:
- Enable: Check this to enable the field.
- Default date: Enter a date to pre-fill upon page creation.
- Texttimezone: Enter a time zone for the date entered. Content authors will be able to change the time zone themselves if you enable it under Allow authors to enter. Otherwise, it will be set by this field.
- Allow authors to enter: Check each option you want content authors to be able to set, including Single date, Time span, Multi date, Recurring date, and Time Zone.
- Enable 'end time' for single date: Check this box if the date can be a time span within the same date, such as 10 am -12 pm on 1/2/2022. Uncheck this box if you’re using your Date field to enter a single point in time, such as a publish date.
Image Upload
A file upload field in which content authors can only upload image files. These are the options you can set:
- Max size: The maximum file size you can upload in kilobytes.
- Width x height: The full width and height of the image that can be uploaded.
Please note that image file extensions are specified under More > Content Types > Image; only the file extensions specified under File type extensions can be uploaded.
Document Upload
A file upload field in which content authors can only upload document files. These are the options you can set:
- Max size: The maximum file size you can upload in kilobytes.
Please note that document file extensions are specified under More > Content Types > Document; only the file extensions specified under File type extensions can be uploaded.
Media Upload
A file upload field in which content authors can only upload media files. These are the options you can set:
- Max size: The maximum file size you can upload in kilobytes.
Please note that media file extensions are specified under More > Content Types > Media; only the file extensions specified under File type extensions can be uploaded.
List Hyperlink
A list of links that can connect to content pages or files or to external web pages, like those used for related links or documents. These are the options you can set:
- Max amount of links: The maximum number of links a content author can add to this field.
- Can add manual hyperlinks: Check this box to allow content authors to paste external URLs into this field.
- Can edit system hyperlink's name: Check this box to allow content authors to edit the link text for all links in this field. If unchecked, the link text will use the page or file name.
- Can edit system hyperlink's url: Check this box to allow content authors to manually edit the URL of linked pages or files. This will allow them to include additional query strings or fragments.
- Can edit system hyperlink's target: Check this box to allow content authors to set links to open in a new browser window.
- Used for adding images: Check this box to enable image links in this field.
- Starting points for contents: Set a specific page in the site tree that content selection will start from. Setting this to None will disable content selection. You can set this field for each site you have.
- Starting point for files: Set a specific folder in your files library that content selection will start from. Setting this to None will disable content selection. You can set this field for each site you have.
- Starting point for shared files: Set a specific folder in your shared files library that content selection will start from. Setting this to None will disable content selection. You can set this field for each site you have.
- Show rss: Check this box to enable selection of RSS feeds. You can set this field for each site you have.
Tree
A tree field that can represent a parent-child or category-subcategory relationship. These are the options you can set:
- Tree: Configure the data tree under Default or under a specific site. Right-click on Root and select New item to start creating the tree and create new items by right-clicking on each node. You can also use the Translate to drop-down menu to translate items into various languages.
- Value: Edit the value of an item by right-clicking it and selecting Edit Value. Enter the new value and select Save.
Tag
A list of predefined values that a content author can choose from, such as those used to select content labels. Content authors can also add values to this list if it hasn't been predefined. These are the options you can set:
- Enable: Check this to enable the field.
- Add value(s): Add your list of values to this field. Values can be separated by a comma and can include the letters A-Z, numbers 0-9, and hyphens (-).
Multiple Content
This field allows content authors to add multiple sections of content, such as those used for side panels. Each content section will have a text box for a title and a WYSIWYG Editor. These are the options you can set:
- Max number of wysiwyg areas: Set the maximum number of content sections an author can create. Leaving this blank means the number is unlimited.
- Max character limit for the heading field: Enter a character limit (including spaces) for the title text field. Leaving this blank means it is unlimited.
- Label for the heading field: The label for the title field to show next to the field in admin.
- Spell checking for heading field: Check this box to enable spellchecking for the title field.
-
Wysiwyg editor options: Enable the options you want to include in your text editor. Remember that content authors may still be blocked from enabled features if page permissions are set. These are the options you can include in your WYSIWYG Editor:
- Images
- Documents
- Media
- Flash
- Tables
- Controls
- Forms
- Personalisation
- Custom styles