=== Janrain Engage ===
Contributors: forestb
Donate link: http://www.janrain.com/products/engage/
Tags: rpx, janrain, engage, janrain engage, authentication, facebook, facebook connect, facebookconnect, openid, twitter, google, yahoo, api, oauth, myspace, linkedin, windows live, login, registration, register, social api, social apis, widget, community, sharing, share, publish, publishing, share button, share widget, social widget, tweet, status update, news feed, newsfeed, social login, social sharing, social sign-on, social sign-in
Requires at least: 3.1.0
Tested up to: 3.2.1
Stable tag: 1.0.7

Janrain Engage - Social Login and Social Sharing with multiple providers including Facebook, Twitter, Google, Yahoo! and OpenID

== Description ==
[Janrain Engage](http://www.janrain.com/products/engage/ "Janrain Engage") increases site 
registrations and generates referral traffic to your site by allowing users to easily 
register and login via an existing account with Facebook, Google, Twitter, Yahoo!, 
LinkedIn and other social platforms. Users also can publish their comments or activities 
from your site to multiple social networks simultaneously.

= Registration & Login via Preferred Social Network/Email Provider: =
 Give your visitors the option to sign-in to your site with their existing social 
network such as Facebook, Google, Twitter, Yahoo!, LinkedIn, Windows Live, MySpace, 
AOL and others (18 Supported Networks).

= Optional Displays: =
*  Login buttons displayed on standard WordPress registration and login screen
*  Login buttons displayed next to login prompt for comments
*  Login buttons displayed anywhere within your specified widget area
*  Share button at beginning or end of posts
*  Share button on each comment
*  Share button customization
*  Show social provider photo as avatar

= Collects Email Address: =
Prompts users to enter an email address if the provider used for login does not pass a 
verified email address (WordPress Requirement). 

= Legacy Account Mapping: = 
If your user has an existing account with your site, Janrain Engage will map profile data 
received at login with the existing account (via verfiedEmail only).

= Social Sharing: =
A customizable widget for your users to share your articles to multiple social networks 
simultaneously. Users can select up to four social communities such as Facebook, Twitter, 
LinkedIn and Yahoo for sharing. On average this will generate nine referral clicks back 
to your site for each article that is shared.

= Social Provider Comment Icons: =
Each comment from a user signed in through a social provider gets an icon to the provider 
that links to their profile page for that provider.

= Connect a provider to an existing account: =
Users can connect a provider to their account through the profile page or the widget.
They can also change the provider in the profile page.

= Automatic user registration: =
Register new users automatically from a simple provider sign in.
This optional feature lowers the barrier for new user registration.

= More Information: =
*  [Janrain Engage Plugin - Demo Site](http://plugins.janrain.com/wordpress/ "Demo Site")
*  [Janrain Engage Plugin - Basic Setup Video](http://www.youtube.com/watch?v=Qz79cZyBhIE "Basic Setup Video")
*  [Janrain Engage Plugin - Support](https://support.janrain.com/ "Support")(Login Required)
*  [Get a Janrain Engage Account](http://www.janrain.com/products/engage/get-janrain-engage "Get a Janrain Engage Account")
*  [Learn More About Janrain Engage - Video Demo](http://www.janrain.com/products/engage/video "Video Demo")
*  [Janrain Website](http://www.janrain.com/ "Janrain Website")

Follow us on [Twitter](http://twitter.com/janrain "Twitter") and on [Facebook](http://janrain.com/facebook "Facebook") to keep up with the latest updates.

== Installation ==

Requires PHP 5.2 (with JSON) or newer and Wordpress 3.1
(The plugin is all new please test it before deployment on a live site.)

1. Copy the 'rpx' directory and its contents to your `/wp-content/plugins/` directory or use the plugin installed built in to Wordpress.

2. Activate the Janrain Engage plugin through the 'Plugins' menu in WordPress

3. You will need to allow user registrations. Go to General Settings and 
turn on "Membership,  Anyone can register."

4. Visit the Janrain Engage configuration page by going to 'Settings' ->
'Janrain Engage' and follow the instructions to finish your installation.
If you don't already have an Engage account and API key, you may click
[Get a Janrain Engage Account Now](http://www.janrain.com/products/engage/get-janrain-engage "Get a Janrain Engage Account Now") to sign up. 
If you have already created an Engage account and site for your 
WordPress blog, just enter your API Key into the box and click "Save."

5. Due to the new email address requirements in Wordpress 3 users will be 
prompted for an email address if the provider does not deliver one.
If the provider settings does not show email as a profile option 
the plugin will require the user to enter an email address.

== Frequently Asked Questions ==

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

Go to http://www.janrain.com/login and sign-in. Click the 
"Provider Configuration
 link on your application dashboard and toggle between 
each provider on the right side panel.  Click the blue "Configure" button for 
instructions to enable each provider.  All four require you to obtain an API key and 
secret for your individual site, and approve their developer terms of service. 

= Help! The plugin doesn't work = 

The plugin is currently only tested with Twenty Ten theme and a few other themes.
You may have problems with another theme please test it before deployment.

Please test it before deployment on a live site.

Note: Using the most current version of PHP (and JSON) and WordPress (with a current theme) 
will fix many problems, so please make sure you are up to date.

Vist https://support.janrain.com/ to search for solutions. There is a Wordpress plugin 
specific discussion at [Janrain Engage Plugin - Support](https://support.janrain.com/ "Support")(Login Required)

== Changelog ==

= Version 1.0 =
*  This is an all new plugin that replaces all previous versions for users of Wordpress 3.

= Version 1.0.0a =
*  First round of bug fixes for 1.0.1

= Version 1.0.0b =
*  Adds IE7 support
*  Added configuration for comment action hook
*  Improved performance, faster page loads
*  Improved widget/theme compatibility
*  Improved Share button design
*  Improved admin settings screen
*  Fixed redirect to permalink (removed)

= Version 1.0.1a =
*  Just an experimental relase for WPMS

= Version 1.0.1b =
*  WPMS that works in at least one config type
*  Output buffering with error detection
*  Fixed bug that blocked admin panel if cURL detect failed
*  Independent email address collection UI
*  Link for admin cleanup on old incomplete accounts(experimental)

= Version 1.0.1 =
*  WPMS support (beta)
*  Social sharing for comments with option in admin screen.
*  Provider icons for comments.
*  Fixed defect where profile was not being updated when user switched providers.
*  Cleaned up admin screen.
*  Icons on wp-login.php are sprites.

= Version 1.0.2 =
* BuddyPress support (beta, requires automatic registration to be disabled)
* Existing users can add a provider or change the provider.
* Eliminated dependency on wp-login.php
* Eliminated last cURL dependency.
* Completed provider icon comment feature.
* Errors display in a light-box style.

= Version 1.0.3 =
* Adds ability to pull provider list to set icons to match enabled providers.
* Added instruction for token URL "whitelist" for admin panel.
* Corrected URL and wording in admin panel.
* Other minor bug fixes.

= Version 1.0.4 =
* CSS and JS system reworked to enable server side caches and improve page loads.
* Various minor fixes.

= Version 1.0.5 =
* More CSS fixes and it's now tested against multiple templates.
* Added the new Engage providers and improved icon art.
* Wordpress 3.1.3 tested and supported.
* Now has it's own settings category.
* Built in help!
* Interface to edit common strings for localization or customization.
* Share button preferences and new look.
* Improved compatability with other WP plugins.
* Shortcodes added for custom template integration.

= Version 1.0.6 =
* Sign on provider list updates on every save of the settings.
* Optional feature to allow users to disconnect the social account.
* Increased FB share summary text size to 128 characters.
* Option to require automatically registered users to select username. (Related: Expert EULA feature.)
* Moved all rpx.conf.php options into the UI as Expert Settings.
* Some bugs where fixed.
* Tested to 3.1.4

= Version 1.0.7 =
* New share button look.
* Share button can show share counts.
* Tested for 3.2.0

== Upgrade Notice ==

Version 1.0.7 adds new share button with count option.

== Screenshots ==

1. The Janrain Engage sign-in widget.  You can fully customize which identity providers to support, and the order in which they appear on the widget.
2. Example of the return user sign-in experience with Janrain Engage.  Janrain Engage remembers the user's preferred network.
3. Comments enabled through Janrain Engage.  Clicking on the icons in the comments section allows users to sign-in via the Janrain Engage interface.
4. The login icons can be configured to show up even if anonymous commenting is enabled.
5. The Janrain Engage button on the login page.
6. The Janrain Engage log in widget.
7. The social share link for articles.
8. The social share link on comments, and provider icons for commenters. 
9. The social sharing widget.
