The Users extension 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 extension 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 extension.

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’

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 extension. 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.