Description
On October 14, 2015, LinkedIn converted all groups to private,
which has made the groups display functionality of this plug-in
impossible. However, the Sign in with Linked functionality still
works perfectly fine. The associated sign-in and registration hooks
offer great flexibility for utilizing user data in custom coding.
This plugin is deprecated. Please use RDP Linkedin Login.
RDP inGroups+ provides:
- Login button shortcode – shows a Sign in with LinkedIn button when logged out
- Member Count shortcode, with the ability to designate a link URL
- Ability to register a visitor with the WordPress installaton
- Logged-in session security using nonces and client IP address
- OOP with hooks and filters for easy integration and customization
- Ability to add a list of company IDs that a registered user will automatically follow
Warning About Caching
This plug-in will not work if caching is enabled on a web site.
Sponsor
This plug-in brought to you through the generous funding of Laboratory Informatics Institute, Inc.
Usage
LinkedIn Group Discussions
RDP inGroups+ is implemented using the shortcode [rdp-ingroups-group]. It accepts the following arguments:
- id: (required) a group ID
Examples:
[rdp-ingroups-group id=2069898]
This will display discussions of the designated group to site visitors. The shortcode will display a Sign in with LinkedIn button if the user is not logged in.
LinkedIn Group Member Count
For a display of a group’s member count, use the [rdp-ingroups-member-count] shortcode. It accepts the following arguments:
- id: (required) a group ID
- link: a url to make the member count a hyperlink
- new: make the link open in a new tab
- prepend: text to add to the front of the member count
- append: text to add to the end of the member count
Examples:
[rdp-ingroups-member-count id=209217]
[rdp-ingroups-member-count id=209217 link=http://example.com]
[rdp-ingroups-member-count id=209217 link=http://example.com new]
[rdp-ingroups-member-count id=209217 link=http://example.com new prepend=’Join our’ append=’TODAY!’]
LinkedIn Sign In Button
To display a Sign in with LinkedIn button, use the [rdp-ingroups-login] shortcode.
External Scripts Included
- jQuery Cookie Plugin v1.4.1 under MIT License
- jQuery.PositionCalculator v1.1.2 under MIT License
- Query Object v2.1.8 under WTFPL License
- URL v1.8.6 under MIT License
Hook Reference:
rdp_lig_before_user_login
- Param: JSON object representing a LinkedIn Person containing firstName, lastName, emailAddress, pictureUrl, publicProfileUrl, and id
- Fires before any user is logged into the site via LinkedIn.
rdp_lig_after_insert_user
- Param: WP User Object
- Fires after a new user is registered with the site. (Register New Users? must be enabled)
rdp_lig_after_registered_user_login
- Param: WP User Object
- Fires after a registered user is logged into the site. (Register New Users? must be enabled)
rdp_lig_registered_user_login_fail
- Param: JSON object representing a LinkedIn Person containing firstName, lastName, emailAddress, pictureUrl, publicProfileUrl, and id
- Fires after a failed attempt to log registered user into the site. (Register New Users? must be enabled)
rdp_lig_after_user_login
- Param: RDP_LIG_DATAPASS object
- Fires after any user is logged into the site via LinkedIn.
rdp_lig_after_scripts_styles
- Param: none
- Fires after enqueuing plug-in-specific scripts and styles
Filter Reference:
rdp_lig_render_header_top
- Param 1: String containing opening div and wrapper HTML for header section
- Param 2: String containing status – ‘true’ if user is logged in, ‘false’ otherwise
- Return: opening HTML for header section
rdp_lig_render_header
- Param 1: String containing the body HTML for header section
- Param 2: String containing status – ‘true’ if user is logged in, ‘false’ otherwise
- Return: body HTML for header section
rdp_lig_render_header_bottom
- Param 1: String containing closing wrapper and div HTML for header section
- Param 2: String containing status – ‘true’ if user is logged in, ‘false’ otherwise
- Return: closing HTML for header section
rdp_lig_render_main_container_header
- Param 1: String containing HTML for main container header section
- Param 2: String containing status – ‘true’ if user is logged in, ‘false’ otherwise
- Return: HTML for main container header section
- Default behavior is to render the group profile logo and name
rdp_lig_render_member_count
- Param 1: String containing HTML for member count
- Param 2: Array containing shortcode attributes
- Return: HTML for member count.
rdp_lig_render_paging
- Param 1: String containing HTML for paging section
- Param 2: String containing status – ‘true’ if user is logged in, ‘false’ otherwise
- Param 3: String containing the location – ‘top’ of main container section, ‘bottom’ of main container section
- Return: HTML for paging section. For infinity paging, location ‘top’ is not rendered.
rdp_lig_render_login
- Param 1: String containing log-in HTML for the [rdp-ingroups-login] shortcode
- Param 2: String containing status – ‘true’ if user is logged in, ‘false’ otherwise
- Return: log-in HTML for the [rdp-ingroups-login] shortcode
rdp_lig_before_insert_user
- Param 1: Boolean indicating if user exists based on result of WordPress username_exists() function, using supplied email address
- Param 2: JSON object representing a LinkedIn Person containing firstName, lastName, emailAddress, pictureUrl, publicProfileUrl, and id
- Return: Boolean indicating if user exists
rdp_lig_before_registered_user_login
- Param 1: Boolean indicating if user is logged in based on result of WordPress is_user_logged_in() function
- Param 2: String containing email address of user
- Return: Boolean indicating if user is logged in
rdp_lig_custom_menu_items
- Param 1: Array to hold custom link data
- Param 2: String containing status – ‘true’ if user is logged in, ‘false’ otherwise
- Return: Array of links, where the link text is the key and the link URL is the value
Javascript Function Reference:
rdp_lig_login_onClose
- Param: redirect URL
- Fires upon successful login, just before the login popup window closes.
Redirect Code Example
In this example, all links with class rdp_jb_must_sign_in are assigned an event listener that sets a cookie, with the cookie value derived from the link’s href attribute.
When the popup login window executes its close script, the cookie is read, and the parent window is redirected to the appropriate URL.
Code in custom sign-in JavaScript file
var $j=jQuery.noConflict();
// Use jQuery via $j(...)
$j(document).ready(rdp_sign_in_onLoad);
function rdp_sign_in_onLoad(){
$j('#rdp-jb-main').on( "click", '.title.rdp_jb_must_sign_in' , function(event){
event.preventDefault();
var redirectURL = $j(this).attr('href');
jQuery.cookie('rdp_lig_login_redirect', redirectURL, { path: '/' })
});
}//rdp_sign_in_onLoad