VROOM Web Forms

Web forms provide a simple way to allow visitors and users to get in touch with the website owner or administrator through a form. Once a web form is submitted, emails are sent to both the user and the administrator, and a ticket is created containing the content of the message, the fields that were posted, and information pertaining to the user. Some forms may be enabled to allow for uploading documents, such as resumes, which may then be retrieved through the administration dashboard.

Processing Tickets

For all submitted web forms, a ticket will be generated. This ticket will be sent through email to the user and to the website administrator (or, if set, the CC email address set up in the web form). It will also be stored in the administration dashboard, and a notification will be displayed in the Dashboard when there are tickets that are new and not yet viewed.

Each ticket may be opened or closed by an administrator or any user with the appropriate permissions. This capability helps staff to track the status of each ticket and enter notes if necessary. Once a ticket has been viewed, the bold formatting is removed.

Tickets may be downloaded as a .csv (comma-separated value) file that can be loaded into most spreadsheet programs. Tickets may also be filtered according to the web form through which they were submitted.

Tickets cannot be replied to from within the system itself, but by clicking on the Email link you can reply to the ticket through your regular mail client, and the ticket ID will be automatically placed in the subject.

Creating a Web Form

To create a web form, click on Web Forms > All Web Forms, from within the administration portal, then click on Add Web Form. You then simply give the web form a name which will form the reference, and then fill out the form based on what you want the system to do once the user has posted the form (the Outcome), for example sending the user to a different page or presenting a custom message.

Referencing a Web Form

Web forms can be generated in templates by simply using the {webform:REFERENCE} tag, where REFERENCE is the automatically produced reference of the web form (found in the All Web Forms page).

The code that will be automatically produce will be a parent div, a label, and the input field for every form field in the set. For example, the default field set 'Inquiry Form' will produce a name field, email field, and message field. These fields can be styled through CSS.

The containing form will need to be placed in the template manually, as well as the Submit button. This allows the template developer to gain complete control of the look and feel of the web form. For example, in the template code below, an Inquiry web form has been referenced inside a form with a Submit button under that.

<form name="my-form" method="post" action="{page:uri}">
   {webform:my-inquiry-form}
   <input type="submit" value="Submit Inquiry!" />
</form>

NOTE: Web forms require additional tags in the template which present errors and messages based on the outcome of the form submission. Please make sure your template includes {message} and {errors} tags.