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.

Repeater Template

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.


Shortcode Parameters

The following shortcode parameters are available with the Users add-on.

usersEnable infinite scrolling of  WordPress users. (true/false). Default = ‘false’
users_roleThe user role to display. Default = null
users_includeShow specific users. Default = null
users_excludeExclude specific users.. Default = null
users_per_pageThe number of users to display with each query. Default = ‘5’
users_orderThe order of the displayed users. Default = ‘ASC’
users_orderbySort retrieved users by parameter. Default = ‘login’

Shortcode Builder

The following screenshot illustrates the process of building a Users shortcode with the Ajax Load More Shortcode Builder.

Users Shortcode Builder Options

Example Shortcode[ajax_load_more users="true" users_role="Subscriber" users_per_page="2" repeater="template_10" seo="true"]

FAQs

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.

How do I access the current user/author data in my Repeater Template?

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.

How do I access meta data for an user in my Repeater Template?

To access author meta you must pass the $user->ID to the author_meta() function as follows:

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.


Installation

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.

License Activation

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:

  1. Visit the Licenses section within the Ajax Load More plugin.
  2. Enter the product key and click Activate License.
  3. If the status indicator turns green your add-on has been successfully activated (example below).
License Key Example

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 contact form on this website.