Stand-alone Ticket Form (SATF) tag allows your visitors to create new tickets directly from your web site.

{exp:helpdesk:satf} content {/exp:helpdesk:satf}

Page Navigation:

Parameters Tag Variables Examples

Parameters

The following parameters are available for use:

ajax=

ajax="yes"

This parameter allows you to control how to handle error messages.

If you set this parameter to “no” (a default state), you will be shown a standard ExpressionEngine error page. If you set this parameter to “yes”, the form will return error message in a JSON format. You can further combine this parameter with validate_js and validate_css parameters.

class=

class="your_form_class"

This parameter allows you to set the class attribute of your form.

id=

id="your_form_id"

This parameter allows you to set the id attribute of your form.

jquery_js=

jquery_js="yes"

If you wish to allow your visitors to upload files using your stand-alone ticket form, you will need to call jQuery library. If you already call jQuery in the head of your document, set this parameter to “no”. Otherwise, use “yes”.

jquery_ui_js=

jquery_ui_js="yes"

If you wish to allow your visitors to upload files using your stand-alone ticket form, you will need to call jQuery UI library. If you already call jQuery UI in the head of your document, set this parameter to “no”. Otherwise, use “yes”.

name=

name="your_form_name"

This parameter allows you to set the name attribute of your form.

return=

return="template_group/template_name"

This parameter determines where to send users once they have submitted your stand-alone ticket form.

require=

require="name|os"

This parameter allows you to control which fields will be required. If you wish to use more fields, separate them with pipe character. Fields required by default are:

  • Client name
  • Client e-mail
  • Summary
  • Issue

responsible_agent=

responsible_agent="5"

This parameter allows you to specify member_id of an agent who will be assigned a new ticket upon creation. If you omit this parameter, a new ticket will be set as unassigned and all agents within chosen member groups will be notified about it via e-mail.

site_id=

site_id="1"

MSM Only: The site_id specifies, which site to assign a new ticket into.

validate_js=

validate_js="yes"

If you chose to control form validation through ajax (ajax=”yes”), and set the validate_js parameter to “yes”, the form will be validated using our embedded JavaScripts. If you wish to handle JSON response using your own JavaScript, set this parameter to “no”.

validate_css=

validate_css="yes"

If you chose to control form validation through ajax (ajax=”yes”), and set the validate_css parameter to “yes”, the form will be validated using our embedded CSS styles.

 

Variables

The following variables are available for use:

  • captcha
  • attachments

captcha



If you wish to use captcha in your stand alone ticket forms, use the captcha variable. This variable will be replaced by a unique captcha image. The text in this image must be submitted into the captcha form field by the visitor in order for the form to be submitted.


attachments


{attachments limit="10"}


This variable will be replaced by a file upload field. You can limit the number of files to be uploaded by specifying the limit parameter.


Note: you can use this variable only when you have properly set the path / URL to attachments.


 


Example


{exp:helpdesk:satf ajax="yes" return="template_group/thank_you_template" require="custom_field"}

<label>Ticket priority</label>
<select name="ticket_priority">
   <option>high</option>
   <option>normal</option>
</select>

<label>Client name*</label>
<input type="text" name="client_name"/>

<label>Client email*</label>
<input type="text" name="client_email"/>

<label>Summary*</label>
<input type="text" name="summary"/>

<label>Issue*</label>
<textarea name="issue"></textarea>

<label>Custom field</label>
<textarea name="custom_field"></textarea>

<label>Attached files</label>
{attachments limit="5"}

<input type="submit" type="submit" />

{/exp:helpdesk:satf}