Skip to content
  • Log In
  • Register
WordPress.org

Sardu

  • Themes
  • Plugins
  • News
  • About
  • Get WordPress
Get WordPress

Plugins

  • My Favorites
  • Beta Testing
  • Developers

This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Download

User Profile Picture

By Cozmoslabs
  • Details
  • Reviews
  • Installation
  • Development
Support

Description

Set or remove a custom profile image for a user using the standard WordPress media upload tool.

View Documentation and Examples

Users must have the ability to upload images (typically author role or greater). You can use the plugin Profile Builder 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.

Documentation and Feedback

See the documentation on GitHub.

Please Rate the Plugin.

Screenshots

  • Profile page options.
  • Media upload dialog.
  • Gutenberg settings back-end
  • Gutenberg profile front-end

Blocks

This plugin provides 2 blocks.

  • User Profile Picture
  • User Profile Picture

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 <?php mt_profile_img() ?> 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:

<?php
//Assuming $post is in scope
if (function_exists ( 'mt_profile_img' ) ) {
    $author_id=$post->post_author;
    mt_profile_img( $author_id, array(
        'size' => 'thumbnail',
        'attr' => array( 'alt' => 'Alternative Text' ),
        'echo' => true )
    );
}
?>

Since 2.2.0, you can add a profile author box using function mt_author_box.

<?php
mt_author_box( $post->post_author, array(
    'theme'              => 'tabbed',
    'profileAvatarShape' => 'round',
    'showWebsite'        => true,
    'website'            => 'https://www.ronalfy.com',
    'showSocialMedia'    => true,
    'socialMediaOptions' => 'brand',
    'socialWordPress'    => 'https://profiles.wordpress.org/ronalfy',
    'socialFacebook'     => 'https://facebook.com/mindefusement',
) );

View the code on GitHub.

The REST API is currently supported for versions of WordPress 4.4 and up.

FAQ

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.

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.

Reviews

love this plugin

EleanorR Greenawalt September 10, 2022
I like this plugin so much! very user friendly

profile photo is a must

doncomputing July 11, 2022
How do I make sure that the profile photo is must for the registration process?

Working perfectly

djrandypanama January 15, 2022
The plugin works perfect

Easy-peasy lemon squeezy

windleydaoust May 27, 2021
Simple, lightweight, does exactly what it says. Thanks!

Beautiful plugin

nyawindler May 7, 2021
Beautiful plugin, everything easy and works great!

Quick and Easy

Zahir Rahman September 25, 2020
This plugin works easy. It does what it says without any issues. Tested on Zahirrahman.com on wordpress 5.5.1 Thanks Dev
Read all 56 reviews

Contributors & Developers

“User Profile Picture” is open source software. The following people have contributed to this plugin.

Contributors
  • cozmoslabs
  • Ronald Huereca
  • Alaa Alsalehi

“User Profile Picture” has been translated into 12 locales. Thank you to the translators for their contributions.

Translate “User Profile Picture” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

2.6.0

  • Released 2021-06-25
  • Fixed a security flaw where a user can change others profile picture.

2.5.0

  • Released 2021-02-18
  • Medium level (6.5) security fix. Please update as soon as possible.
  • Cleaned up REST user data so only pertitent information is returned to prevent user data leakage to roles with the upload_files capability.

2.4.0

  • Released 2020-11-17
  • Fixing REST issues.
  • Cleaning up dist scripts.
  • General code cleanup.

2.3.11

  • Released 2020-02-29
  • Added option to disable image sizes.

2.3.10

  • Released 2019-12-29
  • Added new hook for add-on capability.

2.3.9

  • Released 2019-12-06
  • Removing adverts for User Profile Picture Enhanced.

2.3.8

  • Released 2019-10-30
  • Removing top-level navigation.

2.3.7

  • Released 2019-10-23
  • Fixing options not being saved properly.

2.3.6

  • Released 2019-10-09
  • Updating compatibility with WordPress 5.3
  • Fixing JavaScript error in WordPress 5.3

2.3.5

  • Released 2019-09-17
  • Added option in Gutenberg block to customize the View Posts and View Website text.

2.3.2

  • Released 2019-07-14
  • Adding more filters for third-party plugin integration.

2.3.0

  • Released 2019-07-06
  • Gutenberg blocks are now in the User Profile Picture category.
  • New filters for add-on extensibility
  • Added Options page so you can disable the Gutenberg blocks if you so desire.
  • Bug fix: Adding user display name to post title when User Profile Picture creates the user page.

2.2.8

  • Released 2019-06-11
  • New REST API endpoint for changing profile pictures.

2.2.7

  • Released 2019-06-11
  • Fixing permissions in REST API

2.2.6

  • Released 2019-06-10
  • Fixing permissions in REST API

2.2.5

  • Released 2019-06-02
  • Code cleanup.
  • Leaner Gutenberg JavaScript.
  • Gutenberg improvements.
  • Security improvements.

2.2.0

  • Released 2019-05-12
  • Added template tags for displaying an author box

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.

Meta

  • Version: 2.6.0
  • Last updated: 2 years ago
  • Active installations: 60,000+
  • WordPress Version: 4.6 or higher
  • Tested up to: 5.8.6
  • PHP Version: 5.6 or higher
  • Languages:

    Albanian, Czech, Dutch, English (Canada), English (US), French (France), German, Italian, Persian, Russian, Spanish (Spain), Spanish (Venezuela), and Swedish.

    Translate into your language

  • Tags:
    avatarblocksgravataruser profileusers
  • Advanced View

Ratings

See all
  • 5 stars 49
  • 4 stars 0
  • 3 stars 3
  • 2 stars 1
  • 1 star 3
Log in to submit a review.

Contributors

  • cozmoslabs
  • Ronald Huereca
  • Alaa Alsalehi

Support

Issues resolved in last two months:

1 out of 1

View support forum

Donate

Would you like to support the advancement of this plugin?

Donate to this plugin

  • About
  • News
  • Hosting
  • Donate
  • Swag
  • Documentation
  • Developers
  • Get Involved
  • Learn
  • Showcase
  • Plugins
  • Themes
  • Patterns
  • WordCamp
  • WordPress.TV
  • BuddyPress
  • bbPress
  • WordPress.com
  • Matt
  • Privacy
  • Public Code
WordPress.org
WordPress.org

Sardu

  • Visit our Facebook page
  • Visit our Twitter account
  • Visit our Instagram account
  • Visit our LinkedIn account
Code is Poetry.