Plugin Planet

Premium WordPress Plugins

Customizing USP Forms is the same basic process as crafting a normal WP Post or Page. The Form is created from the “Edit USP Form” screen, where USP Quicktags may be used to add fields, buttons, and more to the form. Each Quicktag includes its own attributes that may be used to customize the field input. For example, to adding a submit button to the form, the “USP:Submit” Quicktag prompts with an option to specify a custom button value, and then prompts again with an option to specify any custom CSS classes for the button. This Doc covers the USP Quicktags and their corresponding shortcodes and attributes.

USP Form Quicktags

USP Form Builder

Here is a summary of USP Quicktags and the shortcodes they produce, all using default attributes. See the next section for a complete list of attributes for each of the resulting shortcodes. Items marked with an asterisk * indicate that only one instance of the shortcode may be used for each form.

  • USP:Fieldset – shortcode: [usp_fieldset][/usp_fieldset], HTML: <fieldset></fieldset>
  • USP:Custom – shortcode: [usp_custom], HTML: <input name="usp-custom-1" ...>
  • * USP:Name – shortcode: [usp_name], HTML: <input name="usp-name" type="text" ...>
  • * USP:URL – shortcode: [usp_url], HTML: <input name="usp-url" type="text" ...>
  • * USP:Title – shortcode: [usp_title], HTML: <input name="usp-title" type="text" ...>
  • * USP:Tags – shortcode: [usp_tags], HTML: <input name="usp-tags" ...>
  • * USP:Captcha – shortcode: [usp_captcha], HTML: <input name="usp-captcha" type="text" ...>
  • * USP:Category – shortcode: [usp_category], HTML: <code><input name="usp-cats" ...>
  • * USP:Content – shortcode: [usp_content], HTML: <code><code><textarea name="usp-content" ...></textarea>
  • * USP:Files – shortcode: [usp_files], HTML: <input name="usp-files[]" ...>
  • * USP:Email – shortcode: [usp_email], HTML: <input name="usp-custom-1" ...>
  • * USP:Subject – shortcode: [usp_subject], HTML: <input name="usp-subject" ...>
  • * USP:Submit – shortcode: [usp_submit], HTML: <input type="submit" ...>
  • * USP:Reset – shortcode: [usp_reset], HTML: <div class="usp-reset-button"><a href="http://example.com/form/url/?usp_reset_form=true">Reset form</a></div>
  • * USP:Remember – shortcode: [usp_remember], HTML: <input name="usp-remember" ...>
  • * USP:CC – shortcode: [usp_cc], HTML: <div class="usp-contact-cc">A copy of this message will be sent to the specified email address.</div>
  • * USP:Redirect – shortcode: [usp_redirect], HTML: <input name="usp-redirect" type="hidden" value="http://example.com/" />
  • * USP:Taxonomy – shortcode: [usp_taxonomy], HTML: <select name="usp-taxonomy" ...>

Note about shortcode atrributes: listed above are the shortcodes with no attributes specified, meaning the default attribute values will be applied. When adding shortcodes via quicktags, all of their attributes will be included, even if left blank. This is perfectly fine and just means the default values will be used. In other words, this:

[usp_content]

..is equivaent to this:

[usp_content class="" placeholder="" label="" required="" max="" cols="" rows="" richtext=""]

Form Labels

Form labels are included by default for each relevant shortcode. So for example, all inputs and textareas included via shortcode will have its own label automatically included. Other items, such as the reset link and submit button, do not require labels and thus do not include them.

To customize labels, change the value of the label attribute. Blank label attributes will use the default values. To not include a label, there are basically two ways to go about it:

  • Create the form input manually using regular HTML/markup.
  • Use “null” (without the quotes) as the value of the shortcode’s label attribute, like so: [usp_content label="null"]

USP Form Shortcodes

Check out a complete list of USP Shortcodes and attributes. Note that all USP Pro shortcodes (and template tags) are also displayed/described in the plugin settings via the Tools tab.