WordPress VIP – Registration

Contents

Overview

The Janrain WordPress VIP Registration plugin accelerates the time required to integrate Janrain Registration into your WordPress VIP sites.

Note: The VIP version of WordPress does not offer local user storage, unlike the open source WordPress version. User data is hosted by Janrain in the cloud.

Prerequisites

Installation and Configuration

1. Install plugin

Contact your Automattic representative to add Janrain Registration to your site.

2. Configure required Janrain Registration settings

  1. Log in to your WordPress admin dashboard.
  2. Navigate to Janrain Capture > Janrain Capture.
  3. Configure the following settings:
    1. Application UrlYour Janrain Registration application domain.
    2. Application IDYour Janrain Registration application ID from the Janrain Dashboard.
    3. API Client IDAn API client ID from the Janrain Dashboard. Always use a client with the login_client feature. See the Registration documentation for more information on API clients.
    4. API Client SecretThe client secret for the previously-entered API client.
    5. PackagesSelect capture and login.
    6. Engage Application UrlYour Social Login application domain. This is available from your Janrain Dashboard (in your Social Login application, on the Settings page under the Application Info section). It is listed as the Application Domain.
  4. Skip the Federate Settings and Backplane Settings sections unless asked to do so by your Janrain representative. (See step 7 for instructions.)
  5. Click Save Changes.

3. Upload Registration screen files to the correct location

The Janrain Capture 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 to your Registration flow, your Janrain representative will give you a new set of screens to implement with the plugin.

  1. Select Janrain Capture > UI Settings.
  2. Load Capture screens to the appropriate folder (as instructed on the UI Settings page).

You will return here in step 5 to complete the required settings on this page.

Note: If you are using a child theme, you may see a “screens not found” message, but you can ignore it. The plugin will find your files in the child theme.

4. Create pages for edit profile, password reset, and email verification

  1. Configure the Edit Profile page:
    1. Select Pages > Add New.
    2. Enter a title (for example, “Edit Profile”).
    3. Place the following WordPress short code on the page: [janrain_capture action="edit_profile"]
    4. Publish the page and note the permalink (you will need this in step 5). For example: http://<yoursite.com>/edit-profile
    5. Do not add the page to the WordPress navigation.
  2. Configure the Password Reset page:
    1. Select Pages > Add New.
    2. Enter a title (for example, “Password Reset”).
    3. Publish the page and note the permalink (you will need this in step 6). For example: http://<yoursite.com>/password-reset
    4. Do not add the page to the WordPress navigation.
  3. Configure the Email Verification page:
    1. Select Pages > Add New.
    2. Enter a title (for example, “Verify Email”).
    3. Publish the page and note the permalink (you will need this in step 6). For example: http://<yoursite.com>/verify-email
    4. Do not add the page to the WordPress navigation.

5. Configure required UI settings

  1. Navigate to Janrain Capture > UI Settings.
  2. Configure the Url for load.js file setting. Use the appropriate option below for your site’s protocol and replace <Engage App> with the name of your Social Login application. Refer to your Capture Dashboard settings for the rpx_realm or rpx_custom_realm setting.
    • http://widget-cdn.rpxnow.com/load/<Engage App>
    • https://rpxnow.com/load/<Engage App>
  3. Click Save Changes.

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 the beginning of the URL before the query parameters with the permalinks created in step 4. See the Registration documentation for more information on API clients and settings.

7. Configure optional features

Social Sharing

Configure these settings to add buttons for sharing activities with users using social networks (or email):

  1. Navigate to Janrain Capture > UI Settings.
  2. Select the Enable Social Sharing box.
  3. Under Share Providers to Display, select the providers to be offered as share options to your users. Note: These must be configured in the Janrain Dashboard, and not all providers offer sharing as a feature.
  4. Click Save Changes.

Single Sign-on

For users also implementing Single Sign-on (SSO) to share authentication with other sites:

  1. Navigate to Janrain Capture > Janrain Capture.
  2. Select the Enable SSO box.
  3. Enter the SSO Application Domain provided by Janrain.
  4. Click Save Changes.

Note: The plugin will generate all required settings and pages. You can safely ignore any other Janrain developer documentation regarding SSO.

Backplane Protocol Support

For users adding Backplane support:

  1. Navigate to Janrain Capture > Janrain Capture.
  2. Click the Enable Backplane box.
  3. Enter the Server Base URL provided by Janrain (usually backplane1.janrainbackplane.com).
  4. Enter the Backplane Bus Name provided by Janrain.
  5. For Backplane Version, always select version 1.2.
  6. Click Save Changes.