The Janrain Engage module (formerly RPX) integrates Drupal sites with the powerful Janrain Engage service.
Using Janrain Engage, Drupal sites can authenticate new and existing users with popular social networks, map user profile data from these websites to Drupal fields, and share Drupal content with a user's friends on their social networks.
In particular, the module helps Drupal websites quickly and seamlessly integrate with 21 social networks and service providers.
This includes Facebook, Twitter, Google, Yahoo!, LinkedIn, Myspace, AOL, PayPal, and Windows Live (see the complete list below).
Instead of having to integrate with each of these sites on your own (and manage API changes over time), Janrain Engage does the heavy lifting for you. Using this module, you can get setup in under 10 minutes. The result is an accelerated user registration process, an enhanced ability to gather user data, and increased site traffic from the viral promotion of your content.
Features in the 2.1 version
The 2.1 version of the module includes numerous feature enhancements, user interface improvements, and bug fixes. Here's a quick summary of some notable features:
- LOGIN AND REGISTRATION: Allow site visitors to register and login with one of their existing accounts at popular social networks such as Facebook, Google, Yahoo!, Twitter and LinkedIn. Support is included for both the Drupal user login block and the user login page. Quickly and easily converting anonymous site visitors into active registered users.
- DATA MAPPING: With permission of the user, you can map a user's social profile data to specific Drupal fields. A variety of fields are supported, including User fields, old-style core Profile fields (for those upgrading from Drupal 6), and Profile2 contributed module fields.
- IMPORT PROFILE PICTURE: Import profile photos from a user's social network account and use it as the Drupal profile picture.
- SOCIAL SHARING: Make it easy for users to share their Drupal content and comments with friends and followers on other social networks. A "Share" button or link may be included on specific content types, which triggers the Janrain Engage social sharing widget. When a user submits a comment, this widget can be automatically triggered (suggesting to the user that he/she should share the comment).
- LINKED ACCOUNT MANAGEMENT: A "Linked accounts" tab is provided to the end user (who has the appropriate module permission). Using this tab, a user can add, remove, or otherwise manage the social network accounts connected to his/her Drupal site account.
- RULES INTEGRATION: For those using the popular Rules module, you can configure the full range of Rules-based actions to occur (change a role, send an e-mail, etc.) whenever a user adds or removes a linked account via Janrain Engage. You can also configure the Janrain Engage social sharing widget to launch on various Rule-based events.
- VIEWS INTEGRATION: If you use the Views module, you can easily create various views that include such data as linked account ID's, provider information and icon, as well as a link to delete the account. These can be used, for example, to create site-wide analytics about the number of linked accounts of a given type that have been created.
- CAPTCHA INTEGRATION: Now you can use any of the popular captcha modules (Mollom, Captcha and its submodules) alongside Janrain Engage. While regular sign-ups will still be required to go through captcha verification, sign-ups via Engage will be automatic.
All of these features have been implemented in a modular fashion so that you only need to enable the specific features that you need.
The 2.x series is developed and actively maintained by Janrain.
To make it easy for you to evaluate this module and also test the latest stable code, we maintain a demo site at the following address:
On the demo site, you can login both as a regular Drupal site user and as an administrative user (so that you can see the module configuration settings).
Supported Social Networks and Identity Providers
The Janrain Engage module (and service) currently supports the following social networks and service providers:
- Windows Live
Because new providers are added on a regular basis, you can view the most current list of providers at: https://rpxnow.com/docs/providers
Quick Installation and Configuration Guide
For Drupal 7:
- Download the module's tarball, extract its contents, and move the resulting "rpx" directory into your site's "modules" directory.
- Visit admin/modules and enable the "Janrain Engage Core," "Janrain Engage UI," and "Janrain Engage Widgets" modules.
- Visit admin/people/permissions and configure available module permissions (including the "Administer Janrain Engage settings" and "Manage own 3rd party identities" permissions.
- If you want users to create their own accounts using Janrain Engage, visit admin/config/people/accounts and select "Visitors" under "Who can register accounts?"
- Visit admin/config/people/rpx and enter your Janrain Engage API key.* This API key must be entered for the module to function properly.
- Also at admin/config/people/rpx, configure other module settings related to the user interface, authentication, social sharing, and verification e-mails.
- Visit admin/config/people/rpx/profile and configure Field Mapping if you would like third-party profile data to be mapped to Drupal fields.
* NOTE: If you don't yet have a Janrain Engage API Key, please visit the following link to create a Janrain Engage account: http://www.janrain.com/products/engage/get-janrain-engage
You will be able to choose from a Basic (free), Plus, Pro, or Enterprise level account. All account types are supported by this module.
For more detailed installation instructions, see the module's README.txt file.
For Drupal 6:
- Install the module as usual in your sites/all/modules folder and enable it from the Administer > Site building > Modules.
- You will need to register your website at Janrain.com, but this registration process can be initiated from the module settings page by going to Administer > User management > Janrain Engage.
For both the Drupal 6 and 7 versions of this module, you must enable the OpenSSL extension for PHP. Most servers will have this extension enabled by default.
If you are upgrading from 6.x-1.x to 7.x-2.x, please upgrade to the latest version of 6.x-2.x before upgrading your core Drupal installation.
Development and Bug Reports
We are striving to make this module the best it can be. We welcome your comments, suggestions, bug reports, patches, and feature requests.
The best place to submit this is in the module's issue queue (which we actively monitor and maintain). We look forward to hearing from you!