USP Pro

Front-End Forms

Create unlimited custom forms and let visitors submit content, register, and much more from the front-end of your site.

Buy Now

USP Pro provides an abundance of settings to help you dial-in the perfect forms. In this Doc, we explore the primary plugin settings, which are all available via Settings > USP Pro. Note that secondary settings are available via shortcode attributes and other methods, as explained later in the Docs.

Note that the information presented here is based on the settings shown in the provided screenshots, which may or may not be different than actual settings in future versions of the plugin.

General Settings

General settings include options for basic configuration, users, anti-spam/captcha, category and tags. View General Settings »

Basic Settings

Basic settings for USP Pro. Please examine these settings before publishing any forms.

  • Auto Publish Posts – For submitted posts, you can always moderate (via Draft or Pending status), publish immediately, or publish after some number of approved posts. Default setting: Always Moderate
  • Custom Post Status – Name to use for Custom Post Status (valid only when “Auto Publish Posts” is set to “Always moderate via Custom Status”). Default setting: “Custom”
  • Redirect URL for Success – Where should the visitor go after successful submission? Enter any complete URL (e.g., http://example.com) or leave blank to redirect to the current page. Default: blank (current page) – See also: Custom Redirects
  • Redirect URL for Failure – Where should the visitor go after failed submission? Enter any complete URL (e.g., http://example.com) or leave blank to redirect to the current page. Note: this option is for advanced users; recommended to leave blank. See docs for more info. Default: blank (current page)
  • Redirect to Post – Redirect users to their submitted/published post. Requires that the option for “Auto Publish Posts” set to “Always publish immediately”. Default: unchecked/disabled
  • Enable Basic Statistics – Enable basic tracking of user data (e.g., IP, Referrer, Request, et al). When enabled, user stats will attached to submitted posts as custom fields. Default: unchecked/disabled
  • Minimum Character Limit – Specify the minimum number of characters allowed for the content-field. Leave set at “0” (without the quotes) for no minimum. Default: 0 (no minimum)
  • Maximum Character Limit – Specify the maximum number of characters allowed for the content-field. Leave set at “0” (without the quotes) for no maximum. Default: 0 (no maximum)
  • Unique Post Titles – Check this box to require Post Titles to be unique for submitted posts. Default: unchecked/disabled
  • Remember Form Values – Enable “remembering” of form-field values. This option enables use of a “remember me” checkbox field in USP Forms. Default: checked/enabled
  • Memory Strength – When “Remember Form Values” is enabled, how long should the data be preserved? Check the box to remember indefinitely (until the user clears the browser), or leave unchecked to remember form values only until successful submission (default).
  • Memory Default – Default state of the “remember me” checkbox field (checked or unchecked). Default: checked/enabled

User Settings

User settings determine how visitors and users and handled when submitting form content.

  • Default Assigned Author – Default author for user-submitted posts. Select from any registered user with any role. Default: primary admin
  • Default Assigned Role – Role that should be assigned when registering users. Default: subscriber
  • Use Registered Author – When this option is enabled: if the user is logged in, their username will be used as the post author. When this option is disabled: if the user is logged in, the “Default Assigned Author” will be used as the post author. In either case, if the user is logged out, the post author will be either the registered username (if the form is a registration form) or the “Default Assigned Author”. Default: unchecked/disabled
  • Replace Author – Always use the submitted author name, regardless of any other settings. When including the “Name” field on a USP Form, enable this setting to always use it as the Post Author. Example usage: when user-registration is disabled, this setting enables the user to specify their own author name. Tip: if also including the URL field on a USP Form, it will be automatically used for author archive and other links.

Anti-spam/Captcha

Here you may customize the optional antispam/challenge question.

  • Captcha Question – To prevent spam, enter a question that users must answer before submitting the form. Note that the captcha field must be included in the form in order for this to work. Default: “1 + 1 =”
  • Captcha Response – Enter the only correct answer to the challenge question. Default: “2”
  • Case-sensitivity – Check this box if you want the challenge response to be case-sensitive. Default: unchecked/disabled
  • reCAPTCHA Public – Use Google reCAPTCHA instead of challenge question. To enable, enter your Public Key and Private Key, or leave both fields blank to use the default challenge question.
  • reCAPTCHA Private – Use Google reCAPTCHA instead of challenge question. To enable, enter your Public Key and Private Key, or leave both fields blank to use the default challenge question.

Category Settings

Category settings determine how categories are handled with submitted content.

  • Category Menu – On the front-end, select how categories should be displayed: as a dropdown menu or as checkboxes (always allows users to select multiple categories). Default: dropdown menu
  • Allow Multiple Categories – Allow users to select multiple categories when using the dropdown menu. Default: unchecked/disabled
  • Nested Categories – Check this box to display nested categories for subcategories. Default: checked/enabled
  • Hide Category Field – Hide the Category input field (useful when assigning specific categories for submissions). Default: unchecked/disabled
  • Use Hidden Category – Use a hidden field to assign categories (see next option). Useful for assigning categories to all submitted posts. To assign form-specific categories, use the category shortcode. Default: unchecked/disabled
  • Use Hidden Category ID – Specify a category ID to use as the default category when using the “Use Hidden Category” option (separate multiple ID’s with commas). Default: empty/blank
  • Post Categories – Select which categories may be assigned to submitted posts (toggle show/hide category list). Default: Uncategorized

Tag Settings

Tag settings determine how tags are handled with submitted content.

  • Tag Menu – Select how tags should be displayed on the front-end: as dropdown menu, checkboxes, or text input. Default: dropdown menu
  • Allow Multiple Tags – Allow users to select multiple tags when using the dropdown menu. Default: unchecked/disabled
  • Hide Tags Field – Hide the Tags input field (useful when assigning specific tags for submissions). Default: unchecked/disabled
  • Tag Order – Select the order in which tags should be displayed: name, tag ID, or count (also ascending/descending). Default: name, ascending
  • Post Tags – Select which tags may be assigned to submitted posts (toggle show/hide category list). Default: none
  • Number of Tags – Enter the number of tags that should be displayed above (does not affect front-end display): Enter “all” or “-1” (without quotes) to display all. Note: any tags not shown will be deselected. Default: “-1”
  • Hide Empty Tags – Hide empty tags (i.e., tags with no associated posts) from the above list of tags (does not affect front-end display). Note: any tags not shown will be deselected. Default: unchecked/disabled

Return to Table of Contents

CSS & JavaScript

Customize the appearance (CSS) and behavior (JavaScript) of USP Forms. The settings included on the “CSS/JS” page cover CSS/styles, JavaScript, and some basic loading optimization. Note that these options apply to all USP Forms. To define per-post CSS/JS, use the usp-css and usp-js custom-fields (visit the Tools tab for more info). View JS/CSS Settings »

CSS/Styles

Here you may include an external CSS/stylesheet, select a set of CSS styles for all USP Forms, define your own custom styles, or disable styles.

  • Include USP Stylesheet – Include the external USP CSS file (disabled by default). Located @ /usp-pro/css/usp-pro.css. Note: this stylesheet is for testing purposes. It will be overwritten with each plugin upgrade, so not recommended for live sites. It is recommended to use inline CSS for customizing USP Pro (see next option). Default: unchecked/disabled
  • Select Form Style – Include the following CSS with all USP Forms. Note: any styles enabled here will be included via inline CSS and may be customized using the following several option/fields. Available style options: clean minimal, smaller form, larger form, custom styles, or disable. Default: clean minimal style
  • Minimal Style – CSS for “minimal” form style (edit as needed to fine-tune for your theme). Default: see option for complete default code
  • Smaller Form – CSS for “smaller” form style (edit as needed to fine-tune for your theme). Default: see option for complete default code
  • Larger Form – CSS for “larger” form style (edit as needed to fine-tune for your theme). Default: see option for complete default code
  • Custom Style – CSS for “custom” form style (edit as needed to fine-tune for your theme). Default: see option for complete default code

JavaScript/jQuery

Include the default USP JavaScript file, and/or add some custom JavaScript to be included with all USP Forms.

  • Include USP JavaScript – Include the external USP JavaScript file (enabled by default). Located @ /usp-pro/js/usp-pro.js. Note: this JS file contains scripts required for USP Pro. It will be overwritten with each plugin upgrade, so not recommended for live sites. It is recommended to use inline JS for customizing USP Pro (see next option). Default: checked/enabled
  • Custom JavaScript – Here you may add some custom JavaScript (included inline and separately from external JS file, leave blank to disable). Default: bank/disabled

Optimization

Here you can optimize site performance by specifying exactly which URLs require the external CSS and JavaScript files.

  • Targeted CSS/JS Loading – When enabled, external CSS & JavaScript files are loaded on every page. Here you may specify URL(s) for targeted loading of resources. Separate multiple URLs with a comma. Note: leave blank to load on all pages. Default: blank/disabled

Return to Table of Contents

Uploads

Uploads settings include options for file uploads, file limits, featured images, and auto-display. Note that further options for file uploads and other field inputs are available as attributes for related USP shortcodes. Visit the Tools tab for more info. View Uploads Settings »

File Uploads

Here are the main settings for file uploads. If in doubt with anything, go with the default option.

  • Auto-Display Images – Automatically display images in submitted posts? Note: applies only to uploaded images. Visit Tools > Shortcodes for alternate ways of displaying images and other file types. Options: display uploaded images before post content, after content, or disable. Default: before content
  • Minimum number of files – Specify the minimum number of files that may be uploaded. Default: 0 (no minimum)
  • Maximum number of files – Specify the maximum number of files that may be uploaded. Default: 3
  • Allowed File Types – Specify which file types should be allowed for uploads (comma-separated list). This list should contain all file types that will be allowed for any USP Form. This list of allowed file-types may be further restricted on a per-form basis using the [usp_files] shortcode. Visit Tools > Shortcodes for details. For a complete list of allowed types, visit the WP Codex. Default: bmp, gif, ico, jpe, jpeg, jpg, png, tif, tiff
  • Max file size – Specify a maximum size (in bytes) for uploaded files (applies to all file types). Default: 5242880 (= 5 MB)
  • Min file size – Specify a minimum size (in bytes) for uploaded files (applies to all file types). Default: 25600 (= 25 KB)
  • Min width for images – Specify a minimum width (in pixels) for uploaded images. Default: 0 (no minimum)
  • Max width for images – Specify a maximum width (in pixels) for uploaded images. Default: 1500
  • Min height for images – Specify a minimum height (in pixels) for uploaded images. Default: 0 (no minimum)
  • Max height for images – Specify a maximum height (in pixels) for uploaded images. Default: 1500
  • Featured Images – Set submitted images as Featured Images (aka Post Thumbnails) for posts. Note: your theme’s single.php file must include the_post_thumbnail() to display Featured Images. Default: checked/enabled
  • Featured Image Key – If “Featured Images” is enabled, which uploaded image do want to use for the featured image? Note: if the image doesn’t exist, no featured image will be set. Default: 1
  • File Names – Check this box to make uploaded file names unique. If enabled, the year-month-day and an unique ID will be prepended to the name of each uploaded file. When disabled, uploaded file names will not be changed, so uploading a file with the same name as an existing file will overwrite the existing file. Default: enabled/unique-filenames

Return to Table of Contents

Admin Settings

Admin setting include email settings, email alerts for admins/users, and contact form options. View Admin Settings »

Email Settings

Here are you may specify your email settings, which are used for email alerts when enabled.

  • Admin Mail To – Email address to be notified when a new post is submitted. Default: admin’s email address
  • Admin Mail From – Email address specified in the “From” header of email alerts. Default: admin’s email address
  • Admin Email Name – Name of email recipient to be notified when a new post is submitted. Default admin’s username

Email Alerts

Here are you may specify how email alerts should be sent. Note: “Disable email alerts” overrides individual settings for “Admin” and “User” (below). User-registration emails will not be overridden (can not be disabled) and will be sent automatically to the user and admin when “auto-registration” is enabled.

  • Email Alerts – Here are you may specify how email alerts should be sent. Note: “Disable email alerts” overrides individual settings for “Admin” and “User” (below). User-registration emails will not be overridden (can not be disabled) and will be sent automatically to the user and admin when “auto-registration” is enabled. Default: send via wp_mail

Email Alerts for Admin

Here are you may customize email alerts sent to the admin (based on previous “Email Settings”). Variables: Use any of the following shortcuts in your messages (submissions, approvals, and denied) to display dynamic bits of information. Note: %%post_date%% not available for submitted-post alerts. Variables:

blog url    = %%blog_url%%	
blog name   = %%blog_name%%
admin name  = %%admin_name%%
admin email = %%admin_email%%
user name   = %%user_name%%
user email  = %%user_email%%
post title  = %%post_title%%
post date   = %%post_date%%
post url    = %%post_url%%
post_id     = %%post_id%%
  • Send Post Alert to Admin – Send email alert to the admin when new posts are submitted. Default: checked/enabled
  • Send Approval Alert to Admin – Send email alerts to the admin when submitted posts are approved. Default: checked/enabled
  • Send Denied Alert to Admin – Send email alerts to the admin when submitted posts are denied (sent to Trash). Default: checked/enabled
  • Email Subject for Submissions – Subject line for email alerts sent to the admin (and to any cc’d addresses). Default: “New User Submitted Post!”
  • Email Message for Submissions – Message sent to admin for new submitted posts. Default: “New user-submitted post at Plugin Planet! URL: http://plugin-planet.com”
  • Email Subject for Approvals – Subject line for email alert sent to user when post is approved/published. Default: “Submitted Post Approved!”
  • Email Message for Approvals – Message for email alert sent to the admin when post is approved/published. Default: “Congratulations, a submitted post has been approved at {yoursite}! Visit your post @ %%post_url%%”
  • Email Subject for Denied Posts – Subject line for email alert sent to the admin when post is denied (sent to Trash). Default: “Submitted Post Denied”
  • Email Message for Denied Posts – Message for email alert sent to the admin when post is denied (sent to Trash). Default: “A submitted post has been denied at {yoursite}”
  • CC Post Alerts – List of email addresses that should be carbon-copied (Bcc) for submitted-post alerts (comma-separated list). Default: none (blank)
  • CC Approval Alerts – List of email addresses that should be carbon-copied (Bcc) when posts are approved (comma-separated list). Default: none (blank)
  • CC Denied Alerts – List of email addresses that should be carbon-copied (Bcc) when posts are denied (comma-separated list). Default: none (blank)

Email Alerts for User

Here are you may customize email alerts sent to the user/submitter. Note that if “auto-registration” is enabled, WordPress handles the registration emails sent to the admin and user. Variables: Use any of the following shortcuts in your messages (submissions, approvals, and denied) to display dynamic bits of information. Note: %%post_date%% not available for submitted-post alerts. Variables:

blog url    = %%blog_url%%	
blog name   = %%blog_name%%
admin name  = %%admin_name%%
admin email = %%admin_email%%
user name   = %%user_name%%
user email  = %%user_email%%
post title  = %%post_title%%
post date   = %%post_date%%
post url    = %%post_url%%
post_id     = %%post_id%%
  • Send Post Alert to User – Send email alerts to the user when submitted posts are submitted. Default: checked/disabled
  • Send Approval Alert to User – Send email alerts to the user when submitted posts are approved. Default: checked/disabled
  • Send Denied Alert to User – Send email alerts to the user when submitted posts are denied (sent to Trash). Default: checked/disabled
  • Email Subject for Submissions – Subject line for email alerts sent to the user. Default: “Thank you for your submitted post!”
  • Email Message for Submissions – Message sent to the user for new submitted posts. Default: “Thank you for your submission at Plugin Planet! If submissions require approval, you’ll receive an email once it’s approved.”
  • Email Subject for Approvals – Subject line for email alert sent to user when post is approved/published. Default: “Submitted Post Approved!”
  • Email Message for Approvals – Message for email alert sent to user when post is approved/published. Default: “Congratulations your submitted post has been approved at Plugin Planet!”
  • Email Subject for Denied Posts – Subject line for email alert sent to user when post is denied (sent to Trash). Default: “Submitted Post Denied”
  • Email Message for Denied Posts – Message for email alert sent to the user when post is denied (sent to Trash). Default: “Sorry, but your submission has been denied.”

Contact Form

Here are you may customize the contact form functionality that’s built-in to USP Pro. Usage information available from the “Tools” tab. Variables: Use any of the following shortcuts for “Custom Content” to display dynamic bits of information. Variables:

blog url    = %%blog_url%%	
blog name   = %%blog_name%%
admin name  = %%admin_name%%
admin email = %%admin_email%%
user name   = %%user_name%%
user email  = %%user_email%%
post title  = %%post_title%%
post date   = %%post_date%%
post url    = %%post_url%%
post_id     = %%post_id%%
  • Enable Contact Form – Enable the contact form by entering its ID or slug (separate multiple form IDs/slugs with commas). Any Forms listed here will send contents as email without posting to WP. Default: contact
  • Subject Line Prefix – Here you may enter some text to prepend to the Subject line. Leave blank to disable. Default: “Message sent from {yoursite}: ”
  • Subject Line – Default Subject Line for messages sent via contact form. This is used when a “Subject” input is not included in the form. Default: “Email Subject”
  • Email From – Email address to be specified as the “From” address (leave blank to use the submitted user address). Default: admin email
  • Custom Content – Custom content that should be included in email sent via contact forms (applies to all contact forms). Tip: you can use shortcut variables as described above. Default: none (blank)
  • CC Emails – List of email addresses that should be carbon-copied (Bcc) for messages sent via contact form (comma-separated list). Default: admin email
  • CC User – Auto-send a copy of the contact-form message to the sender? (via CC). Default: unchecked/disabled
  • CC User Message – Here you may customize the CC message that is displayed to the visitor (when the option “CC User” is enabled). Default: “A copy of this message will be sent to the specified email address.”
  • Include User Stats – Check this box to include user data (e.g., IP, Referrer, Request, et al) appended to messages sent via contact form (if enabled). Default: unchecked/disabled
  • Include Custom Fields – Include any custom field data in the form. Default: checked/enabled

Contact Form

By default, contact-form email is sent to the address specified under Admin > “Email Settings”. Here you may specify a custom “To” address (or multiple addresses) for any contact form. Just add <input name="usp-contact-ids" value="1,3" type="hidden" /> to any contact form, where 1 and 3 refer to fields #1 and #3 below. When this hidden field is included in a contact form, the email will be sent to the specified custom address(es).

  • Custom Address 1 – Email address to use for custom contact #1. Default: none (blank)
  • Custom Address 2 – Email address to use for custom contact #2. Default: none (blank)
  • Custom Address 3 – Email address to use for custom contact #3. Default: none (blank)
  • Custom Address 4 – Email address to use for custom contact #4. Default: none (blank)
  • Custom Address 5 – Email address to use for custom contact #5. Default: none (blank)

Return to Table of Contents

Advanced Settings

The Advanced settings include: form configuration, custom post types, before/after forms, custom error/success messages, primary form fields, user registration fields, and custom form fields, and possibly more. View Advanced Settings »

Form Configuration

Here are some key settings for configuring USP Forms, including resources, and various automatic functionality.

  • Enable auto-formatting – Apply WP’s auto-formatting to form content. Default: unchecked/disabled
  • Auto-include fieldsets – Automatically wrap form inputs with <fieldset> tags. Default: checked/enabled
  • Auto-generate form demos – Automatically regenerate the USP Form Demos. Default: checked/enabled
  • Auto-generate post demos – Automatically regenerate the USP Post Demos. Default: checked/enabled
  • Auto-include submit button – Automatically include a submit button to all USP Forms. Default: checked/enabled
  • Text for submit button – Text for submit button when “Auto-include submit button” option is enabled. Default: Submit Post
  • Allowed HTML in post – By default no HTML tags are allowed in submitted post content. Here you may enter any specific tags that should be allowed (comma-separated list of tag names without brackets). For example, some tags used in WP’s visual/rich-text editor include: <strong>, <em>, and <code>. To allow these three tags in submitted post content, this option should look like this: “strong, em, code” (without the quotes). You may allow any HTML you wish, but please only do so if you are aware of any security risks that may be involved. If at all in doubt, simply leave this option blank to disable all HTML tags in post content. Default: blank/disable all tags

Custom Post Type

Here you may customize options for USP Posts. The “USP Posts” option uses a custom post type provided by the USP Pro plugin, and works with the option “Slug for USP Post Type”. The “Existing Post Type” uses one of your own post types and works with the option “Specify Existing Post Type”. If in doubt, roll with the default option :)

  • Custom Post Type – Options: WP Posts, WP Pages, USP Posts, Other/existing post type. Default: WP Posts
  • Slug for USP Post Type – Enter the slug to use when “USP Posts (custom post type)” is selected for the option “Submitted Post Type”. Important: the slug must not be the same as that for any existing Page (e.g., don’t use “about” or “contact”). Also, after specifying this option and saving your changes, visit your Permalinks Settings to workaround a well-known WP bug). After that you should be good to go for custom post types. Default: usp_post
  • Specify Existing Post Type – If you selected “Existing Post Type” from the previous option “Submitted Post Type”, please enter an existing custom post type to use for submitted content. Note: this option does nothing unless “other” is selected in the previous option. Default: none
  • Roles for USP Post Types – Which user roles should have access to USP Posts (custom post types, when enabled): Admin, Editor, Author, Contributor. Note: other roles may appear on the list if they have been previously defined. Default: Admin
  • Roles for USP Form Types – Which user roles should have access to USP Forms (custom post types for forms): Default: Admin

Before/After USP Forms

Here you may specify any custom text and/or markup to appear before and after all USP forms. Leave blank to disable.

  • Custom Before Forms – Enter some text/markup to be included before all USP Forms. Default: <div class="usp-pro-form">
  • Custom After Forms – Enter some text/markup to be included after all USP Forms. Default: </div>

Customize Success Message

Here you may customize the various success messages and specify any custom content to be included before/after. Basic HTML/markup allowed. Leave the before/after fields blank to disable.

  • Register User – Message displayed when a user is registered successfully. Default: “Congratulations, you have been registered with the site.”
  • Submit Post – Message displayed when a post has been submitted successfully. Default: “Success! You have successfully submitted a post.”
  • Register and Submit – Message displayed when user is registered and post is submitted. Default: “Registration successful! Post Submission successful! You’re golden.”
  • Contact Form – Message to display when messages are sent successfully. Default: “Email sent! We’ll get back to you as soon as possible.”
  • Contact Form and Register – Message displayed when email is sent and user is registered. Default: “Registration successful! Email sent! We’ll get back to you as soon as possible.”
  • Contact Form and Post – Message displayed when email is sent and post is submitted. Default: “Post Submitted! Email sent! We’ll get back to you as soon as possible.”
  • Contact, Register, and Post – Message displayed when email is sent, user is registered, and post is submitted. Default: “Post Submitted! Registration successful! Email sent! We’ll get back to you as soon as possible.”
  • Custom Before Message – Custom text/markup to appear before the success message. Default: <div class="usp-success">
  • Custom After Message – Custom text/markup to appear after the success message. Default: </div>
  • Display Form on Success – Display the submission form with the success message? Default: unchecked/disabled

Customize Error Message

Here you may specify any custom text and/or markup to appear before and after the error message(s). Leave blank to disable. Note that individual errors may be customized further by setting their field names (see the “Primary Field Names” section below).

  • Custom Before Errors – Custom text/markup to appear before the listed errors. Default: <div class="usp-errors"><div class="usp-errors-heading"><strong>Important!</strong> Please fix the following issues:</div>
  • Custom After Errors – Custom text/markup to appear after the listed errors. Default: </div>

Primary Form Fields

Here you may customize input labels for primary form fields (i.e., those that have their own quicktag in the USP Form Editor). These names are used for contact-form custom-fields, and elsewhere. Note: to customize error messages for primary fields, visit the “More” settings.

  • Primary Fields 1 thru 15 – Here you may customize input labels for primary form fields (i.e., those that have their own quicktag in the USP Form Editor). These names are used for contact-form custom-fields and elsewhere. Defaults (in order): Your Name, Post URL, Post Title, Post Tags, Challenge Question, Post Category, Post Content, File(s), Email Address, Email Subject, Alt Text, Description, Taxonomy, Post Format

User-Registration Fields

Here you may customize input labels for the optional set of user-registration fields (available when the option to “auto-register users” is enabled). These names are used for contact-form custom-fields and elsewhere.

  • Nicename – Name for the “User Nicename” field. Default: “User Nicename”
  • Display Name – Name for the “User Display Name” field. Default: “User Display Name”
  • Nickname – Name for the “User Nickname” field. Default: “User Nickname”
  • First Name – Name for the “User First Name” field. Default: “User First Name”
  • Last Name – Name for the “User Last Name” field. Default: “User Last Name”
  • Description – Name for the “User Description” field. Default: “User Description”
  • Password – Name for the “User Password” field. Default: “User Password”

Custom Form Fields

Here you may specify the maximum number of custom fields that will be used by any form. The number specifed below is used for two things: 1) it determines how many custom fields are added to newly created forms, and 2) it determines how many options to generate for the next group of settings, “Custom Field Names”. So for example, if three custom form fields are enabled, all new forms will be equipped with three custom form fields, each with its own customizable field label (in the “Custom Field Names” settings). In this example, it would be possible manually to add a fourth custom field to a form, however its corresponding field label would not exist, causing the default label to be used for error messages and elsewhere. Best advice is to set the number of forms as low as possible, and then increase it as needed in the future. Note also that unused custom form fields are perfectly fine; the idea is to have them readily available as needed.

  • Custom Form Fields – Number of custom form fields to enable. Default: 3

Custom Field Names

Here you may specify names for the optional set of custom-field inputs. These names are used for error messages, contact-form custom-fields, and elsewhere.

  • Custom Fields 1 thru “n” – Here “n” is the number of custom fields specified in the previous setting, “Custom Form Fields”. Default: blank

Custom Field Prefix

Here you may specify a unique prefix to use for custom field names. For example, if you specify “foo_” for this setting, you can create unique custom fields by including the parameter “name#foo”. By default, the prefix is “usp-custom-“. Important: do not use “usp-” for the custom prefix.

  • Custom Prefix – Unique prefix to use for custom field names (leave blank to disable). Default: “prefix_”

Return to Table of Contents

More Settings

Customize error messages and more.

Before/After Errors

Here you may customize the text and markup used to display various error messages.

  • Error Separator – Text/markup to appear between each error (e.g., , or <span class="usp-error-sep">, </span>). Default: none (blank)
  • Before Taxonomy Error – Text/markup to appear before each taxonomy error. Default: <div class="usp-error">Required field:
  • After Taxonomy Error – Text/markup to appear after each taxonomy error. Default: </div>
  • Before Custom Field Error – Text/markup to appear before each custom field error. Default: <div class="usp-error">Required field:
  • After Custom Field Error – Text/markup to appear after each custom field error. Default: </div>

Primary Field Errors

Here you may customize the text and markup used to display error messages for primary form fields. Primary fields are form fields that have their own shortcodes, as described for each of the following settings.

  • Name – Text/markup for Name errors – when using shortcode [usp_name]. Default: <div class="usp-error">Required field: Your Name</div>
  • URL – Text/markup for URL errors – when using shortcode [usp_url]. Default: <div class="usp-error">Required field: Post URL</div>
  • Title – Text/markup for Title errors – when using shortcode [usp_title]. Default: <div class="usp-error">Required field: Post Title</div>
  • Tags – Text/markup for Tags errors – when using shortcode [usp_tags]. Default: <div class="usp-error">Required field: Post Tags</div>
  • Captcha – Text/markup for Captcha errors – when using shortcode [usp_captcha]. Default: <div class="usp-error">Required field: Challenge Question</div>
  • Category – Text/markup for Category errors – when using shortcode [usp_category]. Default: <div class="usp-error">Required field: Post Category</div>
  • Content – Text/markup for Content errors – when using shortcode [usp_content]. Default: <div class="usp-error">Required field: Post Content</div>
  • Files – Text/markup for File(s) errors – when using shortcode [usp_files]. Default: <div class="usp-error">Required field: File(s)</div>
  • Email Address – Text/markup for Email Address errors – when using shortcode [usp_email]. Default: <div class="usp-error">Required field: Email Address</div>
  • Email Subject – Text/markup for Email Subject errors – when using shortcode [usp_subject]. Default: <div class="usp-error">Required field: Email Subject</div>
  • Alt Text – Text/markup for Alt Text errors, when using shortcode [usp_custom_field] with attribute name#alt-{id}. Default: <div class="usp-error">Required field: Alt text</div>
  • Caption – Text/markup for Caption errors, when using shortcode [usp_custom_field] with attribute name#caption-{id}. Default: <div class="usp-error">Required field: Caption</div>
  • Description – Text/markup for Description errors, when using shortcode [usp_custom_field] with attribute name#desc-{id}. Default: <div class="usp-error">Required field: Description</div>
  • Taxonomy – Text/markup for Taxonomy errors, when using shortcode [usp_taxonomy]. Default: <div class="usp-error">Required field: Taxonomy</div>
  • Post Format – Text/markup for Post-Format errors (via custom field or hidden field). Default: <div class="usp-error">Required field: Post Format</div>

Form Submission Errors

Here you may customize the text and markup used to display error messages related to form submission. This includes several errors related to user registration and post-submission, as described below.

  • Username Error – Text/markup for Username errors (when using a form that registers users). Default: <div class="usp-error">Username already registered. If that is your username, please log in to submit posts. Otherwise, please choose a different username.</div>
  • User Email Error – Text/markup for User Email errors (when using a form that registers users). Default: <div class="usp-error">Email already registered. If that is your address, please log in to submit content. Otherwise, please choose a different email address.</div>
  • User Exists – Text/markup for User Exists errors (when using a form that registers users). Default: <div class="usp-error">You are already registered with this site, please log in to submit content.</div>
  • Registration Disabled – Text/markup for Registration Disabled errors (when using a form that registers users). Default: <div class="usp-error">User-registration is currently disabled. Please contact the admin for help.</div>
  • Post Required – Text/markup for Post Required errors (when using a form that submits posts). Default: <div class="usp-error">Post-submission required for user registration. Please try again.</div>
  • Duplicate Post – Text/markup for Duplicate Post errors (when using a form that submits posts). Default: <div class="usp-error">Duplicate post title detected. Please enter a unique post title.</div>
  • Name Restriction – Text/markup for illegal characters in the Name field. Default: <div class="usp-error">Restricted characters found in Name field. Please try again.</div>
  • Incorrect Captcha – Text/markup for incorrect response for the anti-spam captcha/challenge question. Default: <div class="usp-error">Incorrect response for the spam check. Please try again.</div>
  • Content Minimum – Text/markup for the Content field when the minimum number of characters is not met. Default: <div class="usp-error">Minimum number of characters not met in content field. Please try again.</div>
  • Content Maximum – Text/markup for the Content field when the minimum number of characters is not met. Default: <div class="usp-error">Number of characters in content field exceeds maximum allowed. Please try again.</div>
  • Address Restriction – Text/markup for illegal characters in the Email Address field. Default: <div class="usp-error">Restricted characters found in Email address. Please try again.</div>
  • Subject Restriction – Text/markup for illegal characters in the Email Subject field. Default: <div class="usp-error">Restricted characters found in Subject field. Please try again.</div>

File Submission Errors

Here you may customize the text and markup used to display error messages for file uploads.

  • Files Required – Text/markup for required files (multiple selected files). Default: <div class="usp-error">File(s) required. Please check any required file(s) and try again.</div>
  • File Required – Text/markup for required file (single selected files). Default: <div class="usp-error">File(s) required. Please check any required file(s) and try again.</div>
  • File Type Not Allowed – Text/markup for disallowed file types. Default: <div class="usp-error">File type not allowed. Please check the allowed file types and try again.</div>
  • File Dimensions – Text/markup for file width and height. Default: <div class="usp-error">Image dimensions (width/height) exceed set limits. Please check the requirements and try again.</div>
  • Maximum File Size – Text/markup for maximum file size. Default: <div class="usp-error">Maximum file-size limit exceeded. Please check the file requirements and try again.</div>
  • Minimum File Size – Text/markup for minimum file size. Default: <div class="usp-error">Minimum file-size not met. Please check the file requirements and try again.</div>
  • File Name Length – Text/markup for length of file name. Default: <div class="usp-error">Length of filename exceeds allowed limit. Please check the requirements and try again.</div>
  • Minimum Number of Files – Text/markup for minimum number of files. Default: <div class="usp-error">Please ensure that you have met the minimum number of required files, and that any specific requirements have been met (e.g., size, dimensions).</div>
  • Maximum Number of Files – Text/markup for maximum number of files. Default: <div class="usp-error">Please ensure that you have not exceeded the maximum number of files, and that any specific requirements have been met (e.g., size, dimensions).</div>

Custom Registration Errors

Here you may customize the text and markup used to display error messages for custom user-registration fields (Nicename, Display Name, Description, et al).

  • Nicename – Text/markup for the “User Nicename” field. Default: <div class="usp-error">Required field: User Nicename</div>
  • Display Name – Text/markup for the “User Display Name” field. Default: <div class="usp-error">Required field: User Display Name</div>
  • Nickname – Text/markup for the “User Nickname” field. Default: <div class="usp-error">Required field: User Nickname</div>
  • First Name – Text/markup for the “User First Name” field. Default: <div class="usp-error">Required field: User First Name</div>
  • Last Name – Text/markup for the “User Last Name” field. Default: <div class="usp-error">Required field: User Last Name</div>
  • Description – Text/markup for the “User Description” field. Default: <div class="usp-error">Required field: User Description</div>
  • Password – Text/markup for the “User Password” field. Default: <div class="usp-error">Required field: User Password</div>

Return to Table of Contents

Additional Tabs

In addition to the primary settings tabs, there are several additional tabs: Tools, About, and License.

Tools

Here you will find a quick-start guide, shortcodes, template tags, and other helpful resources. View Tools Screen »

  • Intro / Quick Start – Quick-start guide for using the plugin.
  • Shortcodes – Complete shortcode library at your service.
  • Template Tags – Descriptions of the most useful of USP Pro’s template tags.
  • Helpful Resources – Growing list of useful resources for working with USP Pro and WordPress.
  • Tips & Tricks – Growing collection of miscellaneous tips and tricks.

About

About USP Pro, WordPress, the server and current user.

  • Plugin Information – summary of current plugin infos
  • WordPress Information – summary of vital WordPress infos
  • WordPress Constants – list of key WordPress constants
  • Server Information – summary of vital server infos
  • User Information – snapshot of current user infos

License

Your purchase of USP Pro entitles you to free automatic updates according to the license terms. To enable this feature, visit the USP License Page to enter your License Key and activate the plugin. Note: to view your License Key at any time, log in to your account at Plugin Planet.

  • License Status – Displays current license status, either Active or Inactive.

To activate your license, click “Acitvate License”, enter your key, and click to save changes.

Return to Table of Contents