WordPress – Registration

Contents

Overview

The Janrain WordPress Registration plugin accelerates the time required to implement Janrain Registration into your WordPress sites. The plugin overrides the native WordPress registration and sign-in screens and syncs Janrain customer profile data with your local WordPress user storage.

The Janrain WordPress Registration plugin supports the following platform capabilities:

Prerequisites

Installation and Configuration

1. Install and activate the Janrain Registration WordPress plugin

  1. From the administrative menu, select Plugins > Add New and search for Janrain Registration, or download the WordPress Janrain Registration plugin from https://wordpress.org/plugins/janrain-capture and add it to your plugins folder.
  2. On the administrative menu, select Plugins to activate the plugin.

2. Copy Registration screen files to the correct location

The Capture (Registration) plugin comes with a set of default screens that you may use to begin working on your WordPress integration. Once Janrain has completed any configuration changes for your Registration flow, Janrain will give you a new set of screens to implement with the plugin.

  1. Copy the janrain-capture-screens folder from inside the janrain-capture plugin folder to the main plugins folder. If you do not complete this step, your integration may be broken if you later upgrade the plugin and overwrite your customized screen files.from: /wp-content/plugins/janrain-capture/janrain-capture-screens
    to: /wp-content/plugins/janrain-capture-screens
  2. Replace the HTML, JavaScript, and CSS files in the /wp-content/plugins/janrain-capture-screens folder with the WordPress screens files provided by Janrain. These new files reflect the latest updates to server-side functionality.
  3. Delete the janrain-mobile.css file in the /wp-content/plugins/janrain-capture-screens/stylesheets folder. This file is provided for legacy versions (you do not need it for the current releases).

Note: The screen files provided for use with WordPress are formatted differently than the standard screen files that Janrain hosts at your reference implementation (provided by Janrain). The Capture plugin generates many of the settings that are required for Janrain Registration and looks for screens in specific file locations, so the Javascript and HTML components of Registration are broken up into multiple files as opposed to being available in a single file.

3. Add the Janrain profile page to a WordPress site

  1. Select Pages > Add New.
  2. Place the [janrain_capture action="edit_profile"] short code on the page.
  3. Publish the page and note the permalink. You will need this in step 4.

4. Configure required plugin settings

a. Configure the Capture version and the Engage application URL in WordPress

On Janrain Capture > Janrain Capture Settings, configure the following settings:

  1. Select Capture from the UI Type menu (Capture Legacy has been deprecated).
  2. In the Engage Application Url box, enter your Janrain Social Login application domain. Note that you must configure any social providers that you wish to use in the Janrain Dashboard.
  3. Click Save Changes.

b. Configure Capture application settings

On Janrain Capture > Capture Settings, configure the following settings:

c. Configure load file and screens folder locations

On Janrain Capture > Interface Settings, configure the following settings:

5. Add Janrain log-in links to a WordPress site

To add a Janrain log-in link to the WordPress site, use the [janrain_capture] short code. Place the [janrain_capture] short code on any WordPress page (except the Edit Profile page as set in Interface Settings) and a Janrain Sign In / Register link will be rendered.

6. Configure forgot password and verify email URLs in the Janrain Dashboard

In the Janrain Registration Dashboard you need to configure the URLs for the forgot password and email verification emails that Registration provides. The WordPress plugin requires these to be formatted differently than in a standard site integration. Configure the following settings for any API clients that you are using with the WordPress plugin with the format shown below, replacing <yoursite.com> with your site’s domain. See the Registration documentation for more information on API clients and settings. 

7. Configure optional plugin settings

a. Configure Federate (Single Sign-on) settings

The Janrain WordPress plugin will generate all JavaScript settings and pages required to enable Single Sign-on (SSO). See the Single Sign-On documentation for more information on how SSO works.

On Janrain Capture > Capture Settings, configure the following settings:

b. Configure Backplane settings

The Janrain WordPress plugin will generate all JavaScript settings required to enable Backplane.

On Janrain Capture > Capture Settings, configure the following settings:

c. Configure data mapping

On Janrain Capture > Data Mapping, enter the Janrain Registration (Capture) field names corresponding to standard WordPress fields. This enables mapping Janrain customer profile data to WordPress.

d. Add Social Share v2 to a WordPress site

To enable Social Sharing v2 on a WordPress site, you need to enable sharing in the plugin admin and place the sharing short code onto pages where you want to display the Janrain Social Sharing v2 UI.

On Janrain Capture > Janrain Capture Settings, configure the following settings:

Use the following short code to enable the Social Sharing UI on your WordPress site:

Troubleshooting