How to add Ticket Form Fields
Perhaps the default fields created during install are not enough and you need to capture more information when a customer submits their ticket.
Adding (and editing) fields for a submission form is very easy.
From the Tickets -> Submission Forms menu page, select to either edit an existing form, or create a new one.
Adding a new Form Field
From within the Edit Form screen, provide the following information for your new field within the Add a New Field meta box:
- Label
This will be the label for the field when displayed on your form - Description
If you want to display a description for your field, enter it here (optional). Select After Label to display the description after the field label but before the input field, or After Field to display the description after the input field - Type
The type of field you select will determine which options you have for the field. - Required
Make this a required field. The form cannot be submitted if the field is not completed - Label Class
Enter a custom CSS class you want to apply to the label element for this field (optional) - Input Class
Enter a custom CSS class you want to apply to the input element for this field (optional) - Maps to
Certain fields can be mapped to specific ticket fields. For example a text input field you are using as a Subject field, can be mapped to the ticket title field and a textarea or Rich Text Editor field can be mapped to the ticket content field. Each mapping can only be used once per form
Dynamic Options
Depending on the type of field you selected, more options may become available:
- Enable KB Articles Ajax Search?
If this option is selected for your field, once the customer has entered data into the field and focus moves to another element, an ajax search will be performed and potential KB Article solutions will be presented to the customer - Options
Displayed when the chosen field type is a select, checkbox or radio input. Enter the options that the customer can choose from (one per line) - Multiple Select?
Displayed when the chosen field type is a select input. Enabling will render a select list where multiple options can be selected - Initially Selected?
For checkboxes, you can select this option to have it checked by default when the form is loaded - Searchable?
If the field type is a select field, you can choose to enable the customer to search the available options. Useful for select fields with many available options - Placeholder
For a number of different field types you can set a placeholder here - Hide Label?
Choose to hide the field label. Perhaps use a placeholder instead
Once you have entered all the relevant information for your new field, click Add Field and the field will be added to your form and visible within the main window. You can now use the drag handle icon to place your field into the required position within the form.
When your customers submit a form, your new field will be presented. The data they input into the field will be visible by clicking the View Form Submission Data link which is displayed within the Original Ticket meta box.