WordPress – Social Login

Contents

Overview

The Janrain Social Login plugin for WordPress enables integration of Janrain Social Login features on your WordPress site. This plugin requires a Janrain Social Login account.

This topic describes the installation of the Social Login integration. If you are using Janrain Registration, refer to WordPress – Registration.

Note: The Janrain Social Login plugin for WordPress was previously referred to as RPX and Engage. Those legacy terms may still appear in the WordPress module UI.

Installation

Requires PHP 5.3 and WordPress 3.5 or higher.

  1. Download the Janrain Social Login plugin from wordpress.org.
  2. Unzip the file and copy the rpx directory and its contents to your /wp-content/plugins/ directory (or use the plugin installer built into WordPress).
  3. Use the WordPress Plugins menu to activate the Janrain Social Login plugin.
  4. Enable user registrations:
    1. Navigate to Settings > General.
    2. Select the Membership, Anyone can register box.
    3. Click Save at the bottom of the page.
  5. Go to the Janrain Engage configuration page by selecting Janrain Engage from the navigation menu. Follow the instructions on the page to complete your installation.
    • If you don’t already have a Social Login account and API key, go here to sign up.
    • If you have already created an account and site for your WordPress blog, enter your API key into the box and click Save.
  6. Once you enter the API key, configuration options are displayed. If you have not yet configured your Janrain Social Login solution, detailed instructions are available here.
  7. Due to the email address requirements in WordPress 3, users will be prompted for an email address if the identity provider does not supply one. If the chosen provider’s settings do not include email as a profile option, the plugin will require the user to enter an email address.

Common Questions / Issues

How do I enable Facebook, Twitter, Myspace, and Live ID authentication?

  1. Go to https://dashboard.janrain.com/signin and sign in.
  2. Click the Provider Configuration link on your application dashboard.
  3. Toggle between each provider on the right-side panel.
  4. Click the blue Configure button for instructions to enable each provider. All four of these providers require you to obtain an API key and secret for your individual site and accept the developer terms of service.

The plugin works, but authentication fails when the token is returned.

Using custom port numbers is one possible cause.

The plugin strips port numbers from URLs, and this behavior will cause an error when Janrain attempts to return a token to a URL. For example, localhost:1234. Either add the path to your host file to avoid using a port number or add the URL directly to the code.

To add the URL to the code:

  1. Open the rpx_v.php file in the wp-content/plugins/rpx directory.
  2. On line 407, replace the variable value in the janrain.settings.tokenURL function with the URL.
    Replace:

    with: