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.