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.
|
1 2 3 4 5 6 7 8 9 10 |
<div class="author"> <?php echo get_avatar( $user->ID, 72 ); ?> <h3><?php echo $user->display_name; ?></h3> <p> <a href="<?php the_author_meta('user_url', $user->ID); ?>"> <?php the_author_meta('user_url', $user->ID); ?> </a> </p> <p><?php the_author_meta('description', $user->ID); ?></p> </div> |
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.
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.
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.
|
1 2 3 4 |
<?php // print_r($user); $ID = $user->ID; ?> |
To access author meta you must pass the $user->ID to the author_meta() function as follows:
|
1 |
<?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.