Simple User Listing vs Top Authors

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. To customize any of the templates, copy the file from the plugin’s “templates” folder to your themes “simple-user-listing” folder. Usage Place this shortcode anywhere you’d like to display a full list of all your blog’s users. [userlist] By default the plugin will print out the users based on the “Posts per Page” setting under Settings->Reading, but this and many other settings can be changed via the shortcode’s parameters. Support If after reading the FAQ you still need help, support is handled in the WordPress forums. Please note that support is limited and does not cover any custom implementation of the plugin. Please report any bugs, errors, warnings, code problems to Github

Top authors allows yoy to list your top authors with plenty of options. You can set the following in each widget: Widget title Roles to exclude Post types to include Authors to show 4 Preset display templates Custom display template that allows you to create a completely custom structure and modify the output before and after the list. Archive (category/tag/taxonomy) specific author lists For a more detailed description of how you can set up custom author lists take a look at the other notes section. The plugin also has some developer friendly features, take a look at the other notes section for more. Thanks Seb Van Dijk for donating this plugin to me for free, I owe you one 🙂 Font Awesome for the plugin icon Usage Most of the options for the plugin are self explanatory, I thought I’d highlight the archive specific authors and the display template. If Archive specific authors is checked the plugin will handle authors differently on category, tag and taxonomy archive pages. It will narrow the posts down to only those in the given archive. Practically this means the following: Say John wrote 10 posts on the website and Jill wrote 5. On normal pages John would be listed first, Jull would be listed second. However, John wrote 3 posts in the “Food” category while Jill wrote 4. On the archive page for the “Food” category – if Archive specific authors is checked – Jill will be shown first with 4 posts and John second with 3. When you select “Custom Structure” as the preset display you should see three new fields: Display Template, Before List and After List. These fields can be used to control the HTML display of your authors. To make sure you can use the data retireved by the widget I’ve added placeholders which will be replaced by real data: %posts_url%: The URL to the user’s post archive page %website_url%: The URL to the user’s website %gravatar_SIZE%: The gravatar of the user at the given size. For example, to display a 50px Gravatar your would use %gravatar_50% %firstname%: The user’s first name %lastname%: The user’s last name %displayname%: The user’s display name %username%: The user’s username %post_count%: Number of posts %meta_FIELD%: Displays the given meta field. If you store a user’s Twitter name in the ‘twitter’ meta field you could use %meta_twitter% to display it. As of 1.0.9 there is also a custom ID field. This is for advanced use, mainly for developers. It allows for custom CSS stylings and even custom queries on a widget-to-widget basis. For Developers Currently there are three filters you can use to control the options available in the widget. ta/usable_roles allows you to change the roles that can be selected. It should return an array of roles in the form of slug=>name ta/usable_opst_types allows you to change the post_types that can be selected. It should return an array of post type objects ta/post_query allows you to modify the arguments of the WP_Query which retrieves the posts that we look up the authors for. Modify the arguments if you want to force category-specific top authors on single post pages, or other similar uses