=== Author Avatars List/Block === Contributors: pbearne, bforchhammer Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=MZTZ5S8MGF75C&lc=CA&item_name=Wordpress%20Development%20%2f%20Paul%20Bearne&item_number=AuthorAvatarsList%20Plugin¤cy_code=CAD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHosted Tags: block, Avatar, Author, Image, Profile Requires at least: 3.0 Tested up to: 6.6.2 Stable tag: 2.1.23 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html
Display lists of user avatars using widgets or shortcodes. With Gutenberg support.
== Description ==
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.
Integrates with: Gutenberg, BuddyPress, xprofile, Multisite, Wpmu, BBPress, co-authors.
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.
== Installation ==
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.
== Upgrade Notice ==
Breaking change in 1.8.0 in CSS .multiwidget_author_avatars is now .widget_author_avatars. This is caused by a library change in-order to support the jetpack visibility option.
If you have added CSS to your theme you may have to update it for this upgrade (do a find and replace).
== Screenshots ==
[authoravatars] shortcode can do.== Changelog ==
2.1.23 Addjusted where the late escaping happened for the avatar name
2.1.22 Added late escaping to avatar name
2.1.21 Fix an enqueuing issue @props @ryanwelcher
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 :-)
= 1.18 = PHP 7.3 errors https://wordpress.org/support/topic/php-7-3-17/
= 1.17 = bumped WP version
= 1.16 = fixed name not loading in ajax paging calls
= 1.15 = 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
= 1.14 = Added nickname what could be show refactored [show_avatar] to use display
= 1.13 = added implode to xprofile content if array
= 1.12 = Fixed the JS in the TinyMCE popup
= 1.11 = added nonce to check_admin_referer
= 1.10 = fixed PHP7 Deprecated constructors Added does class exists for BP xprofile code
= 1.9.9 = fixed typo fixed filter name fixed advance option not showing in widget form
= 1.9.8 = Added Filter aa_user_raw_list
= 1.9.7 = 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
= 1.9.6 = readme update removed php 4 constructors
= 1.9.5 = Added sorting by white list values
= 1.9.4 = Added white list for users
= 1.9.3 = renamed function causing redeclare error
= 1.9.2 = 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
= 1.9 = fixed problem with WP 4.4 and widgets not saving Add help translate link
= 1.8.8 = set the page count to start at 1 not 0 Added support for UM profiles links
= 1.8.7 = 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
= 1.8.6.6 = Added Hungarian Translation (by Otto Radics: Webmenedzser.hu - http://www.webmenedzser.hu)
= 1.8.6.5 = 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
= 1.8.6.4 = Fixed a problem with upgrading if you had bios
= 1.8.6.3 = Set the bios to maintain line breaks
= 1.8.6.2 = Fixed the random order if not logged in
= 1.8.6.1 = deploy script failed to add new file
= 1.8.6.0 =
= 1.8.4.2 =
= 1.8.4.1 =
= 1.8.4 =
= 1.8.3 =
= 1.7.1 =
= 1.7.0 =
= 1.6.3 =
= 1.6.2 =
= 1.6.1 =
= 1.6.0 =
= 1.5.1 =
= 1.5 =
= 1.4 =
= 1.2 =
= 1.1 =
= 1.0 =
= 0.9 =
= 0.8 =
= 0.7.4 =
= 0.7.3 =
= 0.7.2 =
= 0.7.1 =
= 0.7 =
= 0.6.2 =
= 0.6.1 =
= 0.6 =
= 0.5.1 =
= 0.5 =
= 0.4 =
= 0.3 =
= 0.2 =
== Frequently asked questions ==
= Shortcode, huh? =
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.
= How do I use the author avatar shortcode? =
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.
= I can't get my widget to show users from multiple blogs! =
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?
= Can I upload custom pictures for users? =
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.
= I get a "404 Page not found" error when I click on the avatar of a user! =
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.
= Can I use html in user biographies? =
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...
= How can I change the styling of the avatar lists? =
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