Content Field

Secondary Fields

The shortcodes provided in this section display secondary fields. Secondary fields are used to collect data such as URL, Email, Files, Taxonomy, and more. Secondary fields actually are Custom Fields that have their own Quicktags to make them easier to add to forms. If your form includes any secondary fields, they may be viewed in the Custom Fields panel located on the “Edit Post” screen for each submitted post. As with primary fields, secondary fields may be included only once per form.

URL Field

Taxonomy Field

Captcha

Agree to Terms

Toggle Terms
Put your terms here..

Custom Fields

In USP Pro, Custom Fields are used to add virtually any type of fields to USP Forms. We have seen several Custom Fields already in this Starter Form, including the URL, Email, and Subject fields. Custom Fields may be used to add other types of fields, such as textareas, select fields, radio fields, checkboxes, and text fields. Here is a list of all attributes for the Custom Field shortcode.

Select Field

To add a custom select field, we define a Custom Field on the “Edit Form” screen in the “Custom Fields” meta box. For this Starter Form, a select field already is defined and ready for use. If you examine the Custom Fields meta box, you will notice a custom-field definition that looks like this: field#select|options#null:Option 1:Option 2:Option 3|option_default#Please Select..|option_select#null|label#Options|data-required#false To the left of that custom-field definition is its shortcode, which for this form looks like this:

Including that shortcode in the form results in the display of a select field, as defined by its attributes:

  • field = the type of field
  • options = list of options (include null for an empty option)
  • option_default = text to use for the null/empty field (default: “Please select…”)
  • option_select = the option that should be selected by default
  • label = the field label
  • data-required = whether or not the field is required

Learn more about custom select fields.

Text Field

To add a custom text field, we define a Custom Field on the “Edit Form” screen in the “Custom Fields” meta box. For this Starter Form, a text field already is defined and ready for use. If you examine the Custom Fields meta box, you will notice a custom-field definition that looks like this: label#Text Field|placeholder#Text Field|data-required#false To the left of that custom-field definition is its shortcode, which for this form looks like this:

Including that shortcode in the form results in the display of a text field, as defined by its attributes:

  • label = the field label
  • placeholder = the field placeholder
  • data-required = whether or not the field is required

Learn more about custom text fields.

Textarea

To add a custom textarea, we define a Custom Field on the “Edit Form” screen in the “Custom Fields” meta box. For this Starter Form, a textarea already is defined and ready for use. If you examine the Custom Fields meta box, you will notice a custom-field definition that looks like this: field#textarea|label#Textarea|placeholder#Textarea|data-required#false To the left of that custom-field definition is its shortcode, which for this form looks like this:

Including that shortcode in the form results in the display of a textarea field, as defined by its attributes:

  • field = the type of field
  • label = the field label
  • placeholder = the field placeholder
  • data-required = whether or not the field is required

Learn more about custom textarea fields.

Custom Files Field

To add a custom Files field, we define a Custom Field on the “Edit Form” screen in the “Custom Fields” meta box. For this Starter Form, a Files field already is defined and ready for use. If you examine the Custom Fields meta box, you will notice a custom-field definition that looks like this: field#input_file|label#Custom Files|multiple#true|data-required#false To the left of that custom-field definition is its shortcode, which for this form looks like this:

Including that shortcode in the form results in the display of a custom Files field, as defined by its attributes:

  • field = the type of field
  • label = the field label
  • multiple = whether to allow user to select multiple files
  • data-required = whether or not the field is required

Learn more about custom Files fields and visit the USP Uploads settings to set the default/global Files options (like min/max files, min/max size, etc.).

More types of custom fields

Check out the Custom Fields Shortcode Reference to add many other types of fields, including password, url, search, email, tel, month, week, time, datetime, datetime-local, color, date, range, and number. Tip: you can use the “USP:Custom” Quicktag to insert any Custom Field into the form.

Other Fields and Items

In addition to the fields we have covered so far, here are a few more fields and items that may be added to any USP Form.

Fieldset

By default, each form input is wrapped in a fieldset tag. If you disable this behavior in the plugin settings, you can use the “USP:Fieldset” Quicktag to add fieldset tags manually, anywhere in the form. Learn more.

Reset Link

The “USP:Reset” Quicktag makes it easy to add a “reset” link to the form. Learn more.

Remember Info

The “USP:Remember” Quicktag makes it easy to add a “Remember info” checkbox to any form. That way, if the form is submitted and returns an error, the user information will be “remembered” automatically. Learn more.

Custom Redirect

The “USP:Redirect” makes it easy to specify a custom redirect URL. Adding this to the form tells USP Pro to redirect the user to the redirect URL once the form is submitted successfully. Learn more.

Submit Button

By default, a submit button is added to each form. If you disable this behavior in the plugin settings, you can use the “USP:Submit” Quicktag to add a submit button manually, anywhere in the form. Learn more.

Notes

To learn more about USP Pro, check out the documentation at Plugin Planet. You also can find a list of useful resources in the plugin settings, under the “Tools” tab, in the “Helpful Resources” section. Before submitting this form (yes, it is an actual working form!), make sure to complete the few required fields: Post Title, Post Content, the Captcha, and Agree to Terms. You can fill out other fields as well, to see how they work. Note: this is a post-submission form. To create and customize other types of forms, like registration forms and contact forms, check out the other USP Form Demos, located on the USP Forms menu in the WP Admin Area. You can also make combo forms, as explained in this tutorial for making a combo contact, submit, and register form. One more note: if you try submitting this Starter Form without completing the required fields, an error message for each required field will be displayed at the top of the screen. You can customize these errors in the USP More settings, in the “Primary Field Errors” section. Learn more. If you notice any typos or errors in this Starter Form, please report them. Thank you!