User Registration Extras 1.0.7

• Brand New Dashboard to see your registration stats
• Login and Registration Popup Form
• Whitelisted Domain Registration
• HoneyPot Spam Protection
• Auto-Generated Password
• More features to be added soon

Introduction

The User Registration Extras Add-On integrates with any form to allow you to register users on your website. If you are familiar with the MailChimp, Campaign Monitor, and FreshBooks Add-Ons, you should have no problems getting started with the User Registration Add-On.

Pre-Requisites

• User Registration Extras
• A recent version of WordPress
• Setup the User Registration Add-On
• A form with the Username and Email fields

Create Your Form

The first step in integrating the User Registration Extras Add-On is going to be creating the form you would like to use. This can include existing forms. The only required fields a User Registration Extras must contain to be compatible with the User Registration Extras are the Username and Email fields. Here are the steps used to create an optimal User Registration form.

1. In your WordPress admin dashboard go to New Form under the Forms navigation or choose an existing form from Edit Forms.
2. Add the following fields to your form:
   • Username (required)
     Add a Username Field (under Advanced Fields). This will be used to map the Username for user registration.
   • First Name & Last Name
     Add a Name field (under Advanced Fields). This will be used to map both the first and last name for user registration.
   • Email (required)
     Add an Email field (under Advanced Fields); used to map the Email Address for user registration.
   • Password
     Add a Password field (under Advanced Fields). This field will only be available after the User Registration Add-on is installed and activated. This field will be mapped to the Password field for user registration.
   • Additional Fields
     You can add as many additional fields as you require. These fields can then be mapped to various User Meta fields available in the User Registration feed.
3. Save your form.

Create Your Feed

You notification feed does the heavy lifting, and is used to determine exactly what should happen after someone submits your form. For information on setting up User Registration feeds, see the following: Creating a Feed for the User Registration Add-On

Custom Registration Page

If you would like to use a custom registration page, please create and publish a new WordPress Page and embed your registration form there.

1. Go to Forms > Settings > User Registration, and check the box Enable Custom Registration Page.
2. Once checked, you will be presented with a drop down of all the Pages on your site. Select the Page you created as your custom registration form.
3. Click the Update Settings button. This will redirect any visitors who try to access your site’s /wp-login.php?action=register page to the page on your site which holds your User Registration form.

Limitations

The User Registration Add-On does not automatically add custom meta fields to the WordPress user profile page. If you need to display the data, take a look at Justin Tadlock’s custom user meta post. There are also some third-party plugins you can use like the Extra User Details.

The User Registration Add-On does not automatically create Roles & Capabilities in WordPress, nor does it provide any form of content restriction on your website based on Roles & Capabilities.

If you need to create and manage Roles & Capabilities and restrict content on particular pages or posts, take a look at Members or User Role Editor, which both integrate directly with Gravity Forms Roles & Capabilities.

PayPal Standard Integration

The User Registration Extras integrates with the User Registration Extras Standard Add-On to provide the following options:

• Register user only when a payment is received.
  When this option is enabled, the user will not be registered until the PayPal payment has been received.
• Update user when subscription is canceled.
  When this option is enabled, the user’s role will be adjusted based on the drop down selected to the right.

BuddyPress Integration

The User Registration Add-On integrates with the BuddyPress (BP) Plugin allowing you to populate BP profile fields from Gravity Form fields. The BP Meta section of the User Registration feed functions almost identically to the Custom Meta section with the exception of not having an Add Custom option. To add new BP meta options, you must add additional BP profile fields on the BP Profile Field Setup page.

The User Registration Add-On is designed to work with BP v1.2.7.

Mapping BuddyPress Profile Fields

Some User Registration Extrasfields require special consideration when mapping to Gravity Form fields on your User Registration Feed. Below is a list of these fields and the requirements for mapping them correctly.

• Checkboxes
  A BP checkboxes field must be mapped to a checkbox field. Mapping to other field types will have varied results. In addition, the BP checkboxes field values should match your GF checkbox field values. Only matched values will be added to BP user profile data correctly.
• Multi Select Box
  A BP Multi Select Box field must be mapped to a checkbox field. Mapping to other fields types will have varied results.

User Registration Extras Hooks

The User Registration Extras provides an assortment of hooks that can be used to modify the default functionality or extend it. For more information, review the User Registration Add-On Hooks.