Display lists of user avatars using widgets or shortcodes. With Gutenberg support.
This plugin makes it easy to display lists of user avatars, grouped by user roles, on your (multiuser) site. It also allows you to insert single avatars for blog users or any email address into a post or page – great for displaying an image of someone you’re talking about.
It makes use of built-in WordPress (core) functions to retrieve user information and get avatars.
Avatar lists can be inserted into your sidebar by adding a widget or into posts/pages by using a shortcode. The plugin comes with a tinymce editor plugin which makes inserting shortcodes very easy.
This also provides Gutenberg Block for use with the Gutenberg editor.
Please help with the plugin Translations at https://translate.wordpress.org/projects/wp-plugins/author-avatars.
Both the shortcode and widget and Gutenberg Block can be configured to:
Additionally, single user avatars can be inserted using the show_avatar shortcode and configured to:
Please report bugs and provide feedback in the wordpress support forum.
Plugin support: In 2011, Ben stepped down as maintainer of the Plugin, handing over ownership to co-author Paul Bearne, who continues to provide support and drive the development of new features.
author-avatars
folder to the /wp-content/plugins/
directoryLook at this page to find out how to use the [authoravatars] shortcode.
You can find information for developers on this page.
A shortcode is a tag like [authoravatars]
which you can insert into a page or post to display a list of users on that post/page. You can read more about shortcodes in general in the wordpress codex, for example here or here.
As of version 0.6 the plugin comes with a tinymce plugin which makes it very easy to insert shortcode(s).
If you’d like to do it manually it’s still simple: just add [authoravatars]
into your post and hit save! There’s a large number of parameters available.
The plugin comes with two shortcodes: [authoravatars]
for lists of avatars and [show_avatar]
for single avatars.
Make sure you have enabled the “blog filter” in Site Admin / Author Avatars for the blog on which you are trying to use this feature on. By default this is only enabled for the root blog (blog id = 1).
And you are running WordPress MU (or respectively WordPress 3 in multi-site mode), right?
No, the Author Avatars List plugin only provides ways of displaying user avatars.
The plugin uses the WordPress Core Template function get_avatar()
to retrieve the actual avatar images. In order to display custom images you need to look for plugins which use/override WordPress’ avatar features and provide respective upload features…
Have a look at the User Photo Plugin (turn on option “Override Avatar with User Photo”) or the Add Local Avatar Plugin.
This can happens when you’ve choosen to link users to their “author page” and the user has not written any posts on a blog. There are two things that you should do in this situation:
To prevent the 404 page from showing up install the Show authors without posts Plugin. This forces WordPress to always show the user page if the user exists.
If not already there add a custom user/author template to your theme. Otherwise if a user has no posts their user page is going to be quite empty by default…
You can find a tutorial on Author Templates as well as a Sample Template File in the WordPress Codex.
WordPress Core unfortunately strips all html from the user biography field when entered. Install the plugin Weasel’s HTML Bios if you want to use html…
The styling of the widget is controlled by the styles defined in css/widgets.css, avatars on posts/pages (using the shortcode) are styled by code in css/shortcode.css.
You can override the styles in that file by copying a style block to your theme’s style.css
and adjusting respectively. For example add the following to remove the padding from avatars displayed in a widget:
html .widget_author_avatars .author-list .user { padding: 0; }
demo edit
2.1.20
fix to display attr in Blocks @props @joergliwa
2.1.19
2.1.18
Fixed an additional input
reported by Ngô Thiên An (ancorn_)
2.1.17
Fixed lack of escaping on the shortcode
reported by Ngô Thiên An (ancorn_)
2.1.16
Fixed duplicate query when sorting by posts
2.1.15
“wp-editor” script should not be enqueued notice fixed
2.1.14
php 8.1 fix
2.1.13
wp version bump
2.1.11
added missing files
2.1.10
Fixed color picker cashing in editor
Added border options
2.1.8
Fix for PHP 8 thanks to @editpostok for reporting
2.1.5
Stopped not needed css from loading
2.1.4
Removed .live in js
2.1.3
Added filter for last post link text
2.1.2
fix object type for Gutenberg block
2.1.1
added preview and block.json
2.0.8
fixed the detection for bbPress plugin
2.0.7
Fixed block not setting the user_id dropdown on page reload
2.0.6
Fixed trim function
2.0.5
added more lang for TinyMCE plugin
2.0.4
trim $atts so , don’t break short code
refactoring code (start)
2.0.3
removed PHP 7 return type
2.0.2
Fixed padding in Gutenberg sidebar
2.0.1
Added missing files
2.0.0
Gutenberg support added 🙂
PHP 7.3 errors
https://wordpress.org/support/topic/php-7-3-17/
bumped WP version
fixed name not loading in ajax paging calls
Added filter aa_user_final_css to filter the classes on the user div
added name-{first_letter} class
Added span wrape around post count brackets
Added nickname what could be show
refactored [show_avatar] to use display
added implode to xprofile content if array
Fixed the JS in the TinyMCE popup
added nonce to check_admin_referer
fixed PHP7 Deprecated constructors
Added does class exists for BP xprofile code
fixed typo
fixed filter name
fixed advance option not showing in widget form
Added Filter aa_user_raw_list
Added filter aa_user_show_last_post_query
Added the ability to use any URL in the profile contact section as a link
Added the ability for user_link to accept a comma-separated list as fall through if a URL is not found in first selection
Added contact_links to the short-code
readme update
removed php 4 constructors
Added sorting by white list values
Added white list for users
renamed function causing redeclare error
Added aa_user_show_last_post_type filter to allow setting of post type for last post link
added defaulted to author page if no last post is returned
fixed problem with WP 4.4 and widgets not saving
Add help translate link
set the page count to start at 1 not 0
Added support for UM profiles links
replaced parent::WP_Widget() with parent::__construct to remove php 4 constructors
remove extract( $args, EXTR_SKIP and replaced with direct extracts
Added user id to CSS
Fixed Co_Author Plus listings
Added Hungarian Translation (by Otto Radics: Webmenedzser.hu – http://www.webmenedzser.hu)
Added filter (aa_user_level_for_editor) to allow control of who can see the tinyMCE editor button
Added last_post_filter option to link options
Fix the truncating of bio in single avatars
Changed AA in filter names to aa
Fixed a problem with upgrading if you had bios
Set the bios to maintain line breaks
Fixed the random order if not logged in
deploy script failed to add new file