The Users add-on will provide additional functionality for lazy loading WordPress Users with Ajax Load More.
Query and display a listing of WordPress users by role (Authors, BuddyPress Users, Subscribers etc) using a WP_User_Query and Ajax Load More – view example.
How It Works
The Users add-on works by providing a connection point between the WP_User_Query class and Ajax Load More – this core WordPress class is used for querying users by specific roles.
With the Users add-on activated you can create infinite scrolling list of subscribers, authors, BuddyPress users or any custom role on your site and display information about each user like you would a standard WordPress post or custom post type.
When building a custom users shortcode you may choose to display all users or select a specific user_role from the list.
Note: For security and privacy reasons the users_role parameter is encrypted before any user query is run by Ajax Load More. This extra measure will prevent data manipulation of the Ajax $_GET request URL.
When Ajax Load More runs a WP_User_Query the results of the query can be accessed in Repeater Templates by referencing the $user object.
<?php echo get_avatar( $user->ID, 72 ); ?>
<h3><?php echo $user->display_name; ?></h3>
<a href="<?php the_author_meta('user_url', $user->ID); ?>">
<?php the_author_meta('user_url', $user->ID); ?>
<p><?php the_author_meta('description', $user->ID); ?></p>
The following shortcode parameters are available with the Users add-on.
|users||Enable infinite scrolling of WordPress users. (true/false). Default = ‘false’|
|users_role||The user role to display. Default = null|
|users_include||Show specific users. Default = null|
|users_exclude||Exclude specific users.. Default = null|
|users_per_page||The number of users to display with each query. Default = ‘5’|
|users_order||The order of the displayed users. Default = ‘ASC’|
|users_orderby||Sort retrieved users by parameter. Default = ‘login’|
The following screenshot illustrates the process of building a Users shortcode with the Ajax Load More Shortcode Builder.
Example Shortcode[ajax_load_more users="true" users_role="Subscriber" users_per_page="2" repeater="template_10" seo="true"]
Below are common questions regarding the Users add-on. If you have a question and don’t see the answer, please visit the support page and submit your request.
The current user can be accessed in an object called $user.
The $user object hold very high level data about the user and in most cases you will need to extract the $user->ID to access additional data.
$ID = $user->ID;
To access author meta you must pass the $user->ID to the author_meta() function as follows:
<?php the_author_meta('description', $user->ID); ?>
Here is a complete list of available author_meta parameters.
Note: $user will always the object variable name returned from Ajax Load More for each user.
Upon purchase of this add-on you will receive a confirmation/purchase receipt email. Your receipt will contain a direct link for downloading your copy of Ajax Load More: Users and a license key.
After downloading the add-on, upload the unzipped files to your /wp-content/plugins/ directory or visit your plugins dashboard and upload the downloaded .zip under Add New.
To activate your add-on and receive updates directly in your WordPress plugins dashboard users are required to enter the license key that was included with their purchase receipt.
To activate a license key:
- Visit the Licenses section within the Ajax Load More plugin.
- Enter the product key and click Activate License.
- If the status indicator turns green your add-on has been successfully activated (example below).
If you did not receive your confirmation/purchase receipt email and license key, please check your spam/junk folder and if you still cannot locate the email please contact me at darren [at] connekthq.com or use the Product Support form on the website.