{"id":73,"date":"2017-06-22T15:22:29","date_gmt":"2017-06-22T15:22:29","guid":{"rendered":"https:\/\/userswp.io\/docs\/?p=73"},"modified":"2019-11-02T17:56:37","modified_gmt":"2019-11-02T17:56:37","slug":"userswp-form-builder","status":"publish","type":"docs","link":"https:\/\/userswp.io\/docs\/core-plugin\/userswp-form-builder\/","title":{"rendered":"Form Builder"},"content":{"rendered":"


\nIntroduction<\/a>
\nRegister Form<\/a>
\nAccount Form<\/a>
\nAdd Custom Fields<\/a>
\nSettings<\/a><\/span><\/p>\n

Introduction<\/a><\/h3>\n

The Form Builder for UsersWP<\/a> is where you can add custom fields to the Account and Register forms.
\n\"\"
\n\"\"<\/p>\n

Register Form<\/a><\/h3>\n

The Register form is where your site visitors sign up for an account on your site. You can use the custom field options to display new fields on the Register form, the Account form, or both. All fields must be added to the account form first, but each field has settings to allow it to be shown on the Register form, too.<\/p>\n

Many site managers have found that keeping the Register form as “simple” as possible encourages users to finish filling the form and request their account. It is therefore recommend that the registration form be as short as possible, only requiring email address, username and password. The quicker the form, the higher the percentage of your visitors will finish registration and come back to fill in more information in their Account.
\n\"\"<\/p>\n

Account Form<\/a><\/h3>\n

The Account form is only visible to a logged in user of the website. UsersWP supplies a link in the UsersWP section of the custom menu to “Account” that links to this form. It is the same form set in the UsersWP – General settings for “Account”. Note – All custom fields will show on the Account form.
\n\"\"<\/p>\n

Add a Custom Field<\/a><\/h3>\n

Account and Register forms for UsersWP are powered by the Form Builder.<\/p>\n

New fields must first be added to the account form. Within the field options, you can choose to display the field on the Register form.<\/p>\n

To add a new custom field, use the following steps:<\/p>\n

    \n
  1. Select the Account form (default).<\/li>\n
  2. Select the field type.<\/li>\n
  3. Configure the field settings.<\/li>\n
  4. Adjust “Include this field in the register form” to Yes if you want the field to show up in the Register form.<\/li>\n
  5. Save the field.<\/li>\n
  6. Drag and drop fields to change their order in the form.<\/li>\n<\/ol>\n

    Show the field in the Register Form<\/strong>
    \n\"\"
    \nIf the new field is to be shown in the Register form, one or both of the following options must be selected.
    \n\"\"
    \nThe final step is to set the field into the Register form. By adjusting the settings above, the field is available to the Register form, but additional steps are needed to show the field in the form:<\/p>\n

      \n
    1. Select the Register form (default).<\/li>\n
    2. Find the new field in the list of Available Fields.<\/li>\n
    3. Select the field to add it to the Register form.<\/li>\n
    4. Drag and drop fields to change their order in the form.<\/li>\n<\/ol>\n

      Settings<\/a><\/h3>\n

      Each field has a number of possible settings. Read more about each one in detail, here.
      \n\"\"<\/p>\n

      Label:<\/strong>
      \nThis will be the label for the field and displayed all over the site.
      \nForm Label:<\/strong>
      \nIf your form label is different, then you can fill this field. Ex: You would like to display “What is your age?” in Form Field but would like to display “DOB” in site. In such cases “What is your age?” should be entered here and “DOB” should be entered in previous field. Note: If this field not field, then the previous field will be used in Form
      \nHTML variable name:<\/strong>
      \nThis is a unique identifier used in the HTML, it MUST NOT contain spaces or special characters
      \nIs active?<\/strong>
      \nIf no is selected then the field will not be displayed anywhere.
      \nIs Public?<\/strong>
      \nIf no is selected then the field will not be visible to other users.
      \nDefault value:<\/strong>
      \nA default value for the field, usually blank. (for “link” this will be used as the link text)
      \nIs required?<\/strong>
      \nSelect yes to set field as required
      \nRequired message:<\/strong>
      \nEnter text for the error message if the field is required and has not fulfilled the requirements
      \nUpload icon:<\/strong>
      \nUpload icon using media and enter its url path, or enter font awesome class eg:”fa fa-home”
      \nCSS class:<\/strong>
      \nThis will be css class. uwp_social is the reserved class. If you use that class and the field type is URL, then it will be displayed as social buttons
      \nShow in what locations?<\/strong>
      \nSelect in what locations you want to display this field
      \nYou can choose the following locations.<\/p>\n

        \n
      1. Users Page<\/li>\n
      2. More info tab<\/li>\n
      3. Profile page own tab<\/li>\n
      4. Profile Side<\/li>\n<\/ol>\n

        Include this field in register form<\/strong>
        \nWhen this option enabled field will ALSO appear in register form
        \nInclude this field ONLY in register form<\/strong>
        \nWhen this option enabled field will ONLY appear in register form<\/p>\n","protected":false},"featured_media":0,"parent":290,"menu_order":1,"comment_status":"open","ping_status":"open","template":"","doc_tag":[],"amp_validity":null,"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/userswp.io\/docs\/wp-json\/wp\/v2\/docs\/73"}],"collection":[{"href":"https:\/\/userswp.io\/docs\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/userswp.io\/docs\/wp-json\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/userswp.io\/docs\/wp-json\/wp\/v2\/comments?post=73"}],"version-history":[{"count":0,"href":"https:\/\/userswp.io\/docs\/wp-json\/wp\/v2\/docs\/73\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/userswp.io\/docs\/wp-json\/wp\/v2\/docs\/290"}],"next":[{"title":"Settings","link":"https:\/\/userswp.io\/docs\/core-plugin\/userswp-main-settings\/","href":"https:\/\/userswp.io\/docs\/wp-json\/wp\/v2\/docs\/72"}],"prev":[{"title":"Menus","link":"https:\/\/userswp.io\/docs\/core-plugin\/userswp-menus\/","href":"https:\/\/userswp.io\/docs\/wp-json\/wp\/v2\/docs\/75"}],"wp:attachment":[{"href":"https:\/\/userswp.io\/docs\/wp-json\/wp\/v2\/media?parent=73"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/userswp.io\/docs\/wp-json\/wp\/v2\/doc_tag?post=73"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}