A shortcode for displaying paginated lists of users.
Other plugins output paginated lists of users, but I needed to be able to customize and style this list to fit my theme. So I created this plugin to use templates that can be overridden and customized by theme developers.
Place this shortcode anywhere you'd like to display a full list of all your blog's users.
By default the plugin will split the users up based on the "Posts per Page" setting under Settings->Reading.
Simple User Listing supports most of the parameters of the
WP_User_Query class as parameters for the shortcode. For example you can pass it a role defining which type of users you'd like to list. You can also adjust the number of users displayed per page.
[userlist role="author" number="5"]
As of version 1.2 you can now sort the user list by and of the sort parameters supported by
WP_User_Query(). For example, the following would list your users based on number of posts written, with the highest first.
[userlist orderby="post_count" order="DESC"]
As of version 1.4 you can now list users by a meta key. Be careful with this as this is not exactly an efficient query.
[userlist meta_key="foo" meta_value="widgets"]
As of version 1.4.2 you can now include and exclude users with a comma separated list of IDs.
The whole reason I wrote this was that other similar plugins had too much control over the output. You can style the output anyway you'd like by adding your own template parts to your theme.
Copy the files you wish to modify from the
/templates folder of the plugin and paste them into a
simple-user-listing folder in your theme. Now you can change the markup any way you please. It will be similar to template parts for post loops, except you will have access to each user's $user object instead of the $post object.
Requires: 3.5 or higher
Compatible up to: 3.7.1
Last Updated: 2013-12-2
4 of 6 support threads in the last two months have been resolved.
Got something to say? Need help?