=== User Profile Picture ===
Contributors: ronalfy, Alaadiaa
Tags: users, user profile, gravatar, avatar, blocks, block
Requires at least: 3.5
Tested up to: 5.1
Stable tag: 2.1.3
Requires PHP: 5.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Donate link: https://mediaron.com/give/
Set a custom profile image (avatar) for a user using the standard WordPress media upload tool.
== Description ==
Set or remove a custom profile image for a user using the standard WordPress media upload tool.
https://www.youtube.com/watch?v=9icnOWWZUpA&rel=0
Users must have the ability to upload images (typically author role or greater). You can use the plugin Members to allow other roles (e.g. subscribers) the ability to upload images.
A template tag is supplied for outputting to a theme and the option to override a user's default avatar is also available.
== Gutenberg Compatibility ==
As of version 2.0.0, there is a Gutenberg block for outputting to a post.
As of version 2.1.0, the old block is deprecated but still supported. A new block supports themes, more output control, and better style support. You can see an overview in the video below. Sorry about the audio quality.
https://www.youtube.com/watch?v=k9bDmgunXvM&rel=0
== Documentation and Feedback ==
See the documentation on GitHub.
> Please Rate the Plugin or Give Back to show support.
== Installation ==
1. Upload `metronet-profile-picture` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Place `` in your templates (arguments and usage are below)
Arguments:
`/**
* mt_profile_img
*
* Adds a profile image
*
@param $user_id INT - The user ID for the user to retrieve the image for
@ param $args mixed
size - string || array (see get_the_post_thumbnail)
attr - string || array (see get_the_post_thumbnail)
echo - bool (true or false) - whether to echo the image or return it
*/
`
Example Usage:
`
post_author;
mt_profile_img( $author_id, array(
'size' => 'thumbnail',
'attr' => array( 'alt' => 'Alternative Text' ),
'echo' => true )
);
}
?>
`
View the code on GitHub.
The REST API is currently supported for versions of WordPress 4.4 and up.
== Frequently Asked Questions ==
= How do you set a user profile image? =
1. Visit the profile page you would like to edit.
2. Click on the profile picture to add, edit, or remove the profile picture.
= What role does a user have to be to set a profile image? =
Author or greater.
= How do I create specific thumbnail sizes? =
As of 1.5, three image sizes are created: profile_24, profile_48, and profile_96. You are not limited to these sizes, however.
= The image is cropped wrong. How do I fix this? =
We highly recommend the Post Thumbnail Editor plugin for cropping thumbnails, as you can custom-crop various image sizes without affecting other images.
= Does the plugin work with Multisite? =
Yes, but you'll have to set a new profile image per site. This is currently a limitation of the way the plugin stores its data. Ideas to overcome this are welcome.
== Screenshots ==
1. Profile page options.
2. Media upload dialog.
3. Gutenberg settings back-end
4. Gutenberg profile front-end
== Changelog ==
= 2.1.3 =
* Released 2019-02-16
* Added filter to get users in Gutenberg besides author
= 2.1.2 =
* Released 2019-01-26
* Resolving PHP notice for dirname
= 2.1.1 =
* Released 2018-12-20
* Adding white posts theme to the tabbed view block
* Fixing clearing for the tabbed view block
= 2.1.0 =
* Released 2018-12-19
* Old block deprecated, but still supported
* New block added with more control over appearance and includes themes.
= 2.0.2 =
* Released 2018-11-20
* Gutenberg fixes with alignment (center, right) on the front end.
* Gutenberg fixes with the toggle boxes defaulting back to nothing.
= 2.0.1 =
* Released 2018-11-20
* Fixing PHP 5.2 incompatibility
* Fixing Gutenberg block when there is no profile picture present on the front-end
* Updating translations file
= 2.0.0 =
* Released 2018-11-19
* Added Gutenberg block for easy outputting to posts
* Tested with WordPress 5.0
= 1.5.5 =
* Released 2018-08-19
* Enhancement: Loading image now shows between states for better UX
* Enhancement: Plugin attempts to override the default WordPress avatar in the User Profile page
* Enhancement: Plugin attempts to override the admin bar avatars if the users match
* Enhancement: Added Click to Edit bar to make it more obvious what to do with the profile picture
* Refactor: Plugin now uses wp_send_json instead of json_encode for more compatibility
= 1.5.1 =
* Released 2018-07-12
* Fixed a condition where a featured image was shown for the author instead of a blank gravatar
= 1.5.0 =
* Released 2018-07-11
* Support for AMP avatar has been added
* Two REST API endpoints have been added to facilitate better programatic avatar selection
= 1.4.3 =
* Released 2016-09-24
* Bug fix: Post featured image is being shown as user's profile picture when no avatar is selected.
= 1.4.1 =
* Released 2016-08-30 (Props @Monter)
* Fix select states in image modal
= 1.4.0 =
* Released 2016-08-29 (props kelderic)
* Bug fix: CSS Fixes to the trashcan icon and image placeholders
* Bug fix: Modal window was set to the wrong settings
* Enhancement: Avatar override is now the default option
= 1.3.1 =
* Released 2016-04-02
* Fixing thumbnail calls that could potential be inadvertently filtered and cause the profile picture to provide an erroneous callback. Props @Monter.
= 1.3.0 =
* Released 2016-03-28
* Adding REST API endpoint
= 1.2.7 =
* Updated 2015-08-20 for WP 4.3 compatibility
* Released 2015-06-10
* Bug fix: warning message saying missing argument for avatar_override
= 1.2.5 =
* Released 2015-06-06
* Bug fix: get_avatar override now accepts custom classes.
* Added `mpp_avatar_classes` filter to get_avatar override to allow global class overrides/additions.
= 1.2.3 =
* Released 2015-05-20
* Revised post type initialization to make sure post type is completely hidden.
* Refactored function mt_profile_img to use a different API call so that output isn't inadvertently filtered.
* Added new filter, mpp_thumbnail_html, to filter output.
= 1.2.2 =
* Released 2015-04-16
* Added compatibility to Advanced Custom Fields.
* Added increased capabilities check to Ajax calls.
* Ensuring WordPress 4.2 compatibility.
= 1.2.1 =
* Released 2015-03-03
* Fixed internationalization errors.
* Added Spanish translation.
= 1.2.0 =
* Released 2014-12-07
* Reducing clutter in the interface. Removed text option to upload. Added default image if no profile image is available. Added option to remove the profile image.
* Fixed internationalization bug in the JavaScript.
= 1.1.0 =
* Released 2014-11-11
* Added the ability to remove profile images (aside from deleting the image).
* Added better internationalization capabilities.
* Added compatibility with Theme My Login.
= 1.0.23 =
* Released 2014-10-20
* Added a new filter to allow the "Override Avatar" interface to be hidden (and turned on my default).
= 1.0.22 =
* Released 2014-09-02
* Added minor update to additional user meta for easier querying (props Solinx)
= 1.0.21 =
* Released 2013-09-09
* Fixed avatar override on options discussion page.
= 1.0.20 =
* Released 2013-05-13
* Added a filter for turning on "Override Avatar" by default.
= 1.0.19 =
* Added support for 2.0.x version of Post Thumbnail Editor
= 1.0.18 =
* Added basic multisite support
= 1.0.16 =
* Fixed a bug where only the profile image interface was showing for only authors and not editors and administrators.
= 1.0.15 =
* Built-in support for Post Thumbnail Editor
* Better integration with the new WP 3.5 media uploader
* Various bug fixes.
= 1.0.10 =
* Usability enhancements.
* Stripping out useless code.
* Updating documentation
= 1.0.9 =
* Adding support for the new 3.5 media uploader.
= 1.0.3 =
* Bug fix: Avatar classes in the comment section
= 1.0.2 =
* Bug fix: Error being shown in comment section
= 1.0.1 =
* Bug fix: Not able to "uncheck" Override Avatar.
* Bug fix: Deleting profile image and not reverting to normal avatar.
= 1.0.0 =
* Initial release.
== Upgrade Notice ==
= 2.1.3 =
Added filter to get users in Gutenberg besides author
= 2.1.2 =
Resolving PHP notice for dirname
= 2.1.1 =
Adding white posts theme to the tabbed view block. Fixing clearing for the tabbed view block.
= 2.1.0 =
Old block deprecated, but still supported. New block added with more control over appearance and includes themes.
= 2.0.2 =
Gutenberg fixes with alignment on the front end. Gutenberg fixes with the toggle boxes defaulting back to nothing.
= 2.0.1 =
Fixing PHP 5.2 incompatibility. Fixing Gutenberg front-end when there is no profile picture.
= 2.0.0 =
Added Gutenberg block for easy outputting to posts. Tested with WordPress 5.0 successfully.
= 1.5.5 =
Loading image now shows between states. New "Click to Edit" bar added to interface.
= 1.5.1 =
Fixed a condition where a featured image was shown for the author instead of a blank gravatar
= 1.5.0 =
AMP now supported. Two REST API Endpoints added.
= 1.4.3 =
Bug fix: Post featured image is being shown as user's profile picture when no avatar is selected.
= 1.4.1 =
Fix select states in image modal.
= 1.4.0 =
Avatar override is now a default option. Numerous bug fixes. Please see changelog.