=== Authors List === Contributors: WPKube Tags: author, authors, list, grid, authors list, authors grid Requires at least: 4.7.0 Tested up to: 5.4 Requires PHP: 5.4 Stable tag: 1.1.5 Use a shortcode to display a list or grid of post authors and links to their post archives page. == Description == Easily display a list or grid of post authors and links to their post archives page using a shortcode. The shortcode is [authors_list] and accepts the following attributes. * style (1,2,3) * columns (2,3,4) * columns_direction ( horizontal, vertical ) * avatar_size (any number, example 500) * amount (any number, no limit by default) * show_title (yes,no) * show_count (yes,no) * show_bio (yes,no) * show_link (yes,no) * orderby ( post_count, post_date, ID, login, nicename, email, url, registered, display_name, first_name, last_name ) * order ( ASC, DESC ) * skip_empty ( yes, no ) * bio_word_trim ( any number, leave empty for no trim ) * only_authors ( yes, no ) * exclude ( user IDs separated by comma, example 1,3,4 ) * include ( user IDs separated by comma, example 1,3,4 ) * roles ( roles separated by comma, example administrator,editor ) * latest_post_after ( for example if set to 7 it will only show authors that have posts published in the past 7 days ) * name_starts_with ( limit to authors whose display name starts with specific characters ) * categories ( category IDs separated by comma, example 1,3,4 ) * terms ( term IDs separate by comma, example 1,3,4 ) * taxonomy ( name of a taxonomy, for example post_tag ) Example usage with attributes:
[authors_list style="2" columns="2" amount="4" show_count="no"]
There are additional attributes for custom content before and after each element: * before_avatar * before_title * before_count * before_bio * before_link * after_avatar * after_title * after_count * after_bio * after_link Example usage with attributes:
[authors_list before_title="My custom content"]
These before/after attributes also support dynamic user/author meta fields using
{al:INSERT_FIELD_NAME}
Example usage:
[authors_list before_title="My first name is {al:first_name}"]
They also support some dynamic output functionality. Currently supports displaying posts links and social links (Yoast SEO needed): Example usage for posts links:
[authors_list after_title="{alf:posts}"]
[authors_list after_title="{alf:posts type=plain amount=5}"]
Example usage for social links:
[authors_list after_title="{alf:social}"]
== Installation == - **WordPress Plugins Directory**: Navigate to *Plugins* → *Add New* in the WordPress admin and search “Authors List”. Click *Install* and then *Activate*. - **Zip Upload**: Navigate to *Plugins* → *Add New* → *Upload Plugin* in the WordPress admin. Browse to the .zip file containing the plugin on your computer and upload, then activate. - **Manual FTP Upload**: Upload the plugin folder to `/wp-content/plugins/`. Navigate to *Plugins* in the WordPress admin and activate. == Changelog == = 1.1.5 ( July 2nd, 2020 ) = * The "orderby" parameter now accepts the value "comment_count" which order by the comment count what posts made by that author received * The "link_to" parameter now accepts linking to buddypress profile (link_to="buddypress_profile") * The "link_to" parameter now accepts linking to custom meta (link_to="meta" link_to_meta_key="meta_key") * New dynamic output function added for showing follow/unfollow button from BuddyPress Followers plugin (after_title="{alf:buddypress_follow"}) = 1.1.4 ( June 12th, 2020 ) = * The "orderby" parameter now accepts the value "rand" to have a random order * New parameter "link_to" added to allow linking to bbPress profile ( link_to="bbpress_profile" ) * New parameter "pagination" added, set to "yes" to enable pagination = 1.1.3 ( May 30th, 2020 ) = * New shortcode attribute to allow only showing authors by the first letter (or more letters) of their display name = 1.1.2 ( April 21st, 2020 ) = * New shortcode attributes to allow including only authors with posts in specific taxonomy and terms * New orderby attribute value "post_date" to order authors by the date of their latest post = 1.1.1 ( April 6th, 2020 ) = * Fix for skip_empty option * Added link for "submit support request" in the plugin action links * Bump up WordPress compatibility to 5.4 = 1.1.0 ( March 18th, 2020 ) = * Option to include only authors who have posts in specific categories = 1.0.9 ( February 12th, 2020 ) = * Improvements for output of dynamic user/author meta fields = 1.0.8 ( January 28th, 2020 ) = * Links to social profiles for authors = 1.0.7 (January 14, 2020) = * Load CSS only on pages where the shortcode is used * Option to set to show only authors of specific post types * Option for a vertical direction column layout (like a newspaper layout) * Option to show only authors that have posts published today = 1.0.6 (December 16, 2019) = * Option to limit visibility by author's post date * Option to order by first name * Option to order by last name = 1.0.5 (December 2, 2019) = * Option to include specific users by ID * Option to include specific user roles * Option to set posts list to be plain ( divs ) instead of unordered list items * Compatibility with custom avatar plugins * Responsive fixes = 1.0.4 (November 23, 2019 ) = * Option to exclude specific users/authors * Ability to display posts of the specific author = 1.0.3 (November 12th, 2019) = * Option to include all users, not just authors = 1.0.2 (October 30th, 2019) = * Added biography words trim option * Added ability to add custom content before/after each element * Added ability to display custom field values * Added option to also show authors that do not have any posts * Fixed issue where some authors are not shown = 1.0.1 (October 21st, 2019) = * Added plugin URI (for "view details" link in the WordPress admin) * Options to change the authors order * Fixed issue with layout if images not the same height = 1.0.0 = * Initial Release