Integrate Gravity Forms with Janrain Engage social login to pre-fill forms.
Author: | janrain, goldenapples (profile at wordpress.org) |
WordPress version required: | 3.4 |
WordPress version tested: | 3.5.2 |
Plugin version: | 0.3 |
Added to WordPress repository: | 19-12-2012 |
Last updated: | 19-08-2013
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
|
Rating, %: | 0 |
Rated by: | 0 |
Plugin URI: | |
Total downloads: | 1 818 |
Active installs: | 10+ |
Click to start download
|
This plugin allows you to integrate your existing Janrain Engage sign-in
application with any form in Gravity Forms and use users' social profile data to
prefill fields.
After activating the plugin and entering your Engage app settings on the Forms >
Janrain Settings page, a "Social Login" field will be added to the list of
available fields in Gravity Forms. All other fields will have a new setting for
"Prefill from:", where you can elect to let that field be prefilled from the
social profile data, and choose which data to use as a prefill.
Works with the free Basic app available from Janrain - sign up at
http://rpxnow.com - although some extended profile data fields are only
available with the Plus level ($10/mo - see
Janrain Engage Pricing
for more information.)
Screenshots
The field added when you click the 'Social Login' field button (in the
"Advanced Fields" section.
To enable social prefill on a field, check the "Prefill this field" option
and select the data you wish to use to prefill it from the dropdown.
FAQ
I can’t find (Facebook/Twitter/other provider) in the list of available
providers.
Some providers require configuration in order to be available. To use Facebook
login through Janrain Engage, for example, you will have to create an app on
Facebook, and give those credentials to your Engage app.
Luckily, there are current step-by-step directions on the Engage dashboard. Go
to the “Setup Widget” page on your Janrain dashboard (find it under
Deployment > Sign-in for Web; open the Providers section of the
sidebar). Each of the providers which requires configuration will have a gray
gear icon next to it; click that icon and follow the wizard steps.
I want to be able to access a field that a provider offers, but it’s not
populating in my forms.
Some profile fields require requesting extended profile data. You can configure
the permissions your app requests of the user on an “a la carte” basis from your
rpxnow dashboard under Deployment > Provider Configuration. (Keep in mind
that asking users for too many permissions is more likely to scare them away –
don’t be a creeper!
NOTE: some extended profile fields are only available to Plus or higher
service levels.
How can I add more prefill fields beyond the default ones?
This plugin has been designed to be easy to extend. If you want to add more
fields, you will need to hook a function to the filter janrain_gforms_profile_data
that defines the name of the field you want to add, and the function to get its
data. This filter recieves the array of core fields as its argument, so if you
need to redefine one of the core fields, this is the place to do that as well.
For example, the following code will make a new field available called
“religion”; which pulls any data the user has entered as their “religion” on
Facebook (or any other provider that includes that field):
add_filter( 'janrain_gforms_profile_data', 'add_religion_field' );
function add_religion_field( $fields ) {
$fields['religion'] = array(
'name' => 'Religion',
'function' => 'religion_field'
);
return $fields;
}
function religion_field( $profile ) {
return $profile->merged_poco->religion;
}
ChangeLog
0.3
- Bugfixes: Fixed Javascript error that was making it impossible to update field settings
using Chrome browser in recent versions of WordPress
- Enhancements: Added more providers that have been added to the Janrain
product since this plugin was last updated, including Google+, Instagram,
XING, and MYDIGIPASS.COM.
- Updated some help text and links in admin settings pages.
0.2
- Bugfixes: typos in configuration settings prevented plugin from working with
any apps other than Janrain internal ones. (a pretty big problem)
- Enhancements: Minor display enhancements to plugin settings screen and help text.
0.1a