One User Avatar | User Profile Picture Plugin

WordPress currently only allows you to use custom avatars that are uploaded through Gravatar. One User Avatar enables you to use any photo uploaded into your Media Library as an avatar. This means you use the same uploader and library as your posts. No extra folders or image editing functions are necessary. This plugin is a fork of WP User Avatar v2.2.16.

One User Avatar also lets you:

• Upload your own Default Avatar in your One User Avatar settings.
• Show the user’s Gravatar avatar or Default Avatar if the user doesn’t have a One User Avatar image.
• Disable Gravatar avatars and use only local avatars.
• Use the [avatar_upload] shortcode to add a standalone uploader to a front page or widget. This uploader is only visible to logged-in users.
• Use the [avatar] shortcode in your posts. These shortcodes will work with any theme, whether it has avatar support or not.
• Allow Contributors and Subscribers to upload their own avatars.
• Limit upload file size and image dimensions for Contributors and Subscribers.

Copyright

One User Avatar
Copyright (c) 2023 One Designs https://onedesigns.com/
License: GPLv2
Source: https://github.com/onedesigns/one-user-avatar

One User Avatar is based on WP User Avatar v2.2.16
Copyright (c) 2020-2021 ProfilePress https://profilepress.net/
Copyright (c) 2014-2020 Flippercode https://www.flippercode.com/
Copyright (c) 2013-2014 Bangbay Siboliban http://bangbay.com/
License: GPLv2
Source: https://github.com/profilepress/wp-user-avatar

One User Avatar is distributed under the terms of the GNU GPL

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

Advanced Settings

Add One User Avatar to your own profile edit page

You can use the [avatar_upload] shortcode to add a standalone uploader to any page. It’s best to use this uploader by itself and without other profile fields.

If you’re building your own profile edit page with other fields, One User Avatar is automatically added to the show_user_profile and edit_user_profile hooks. If you’d rather have One User Avatar in its own section, you could add another hook:

do_action( 'edit_user_avatar', $current_user ); 

Then, to add One User Avatar to that hook and remove it from the other hooks outside of the administration panel, you would add this code to the functions.php file of your theme:

function my_avatar_filter() { // Remove from show_user_profile hook remove_action( 'show_user_profile', array( 'wp_user_avatar', 'wpua_action_show_user_profile' ) ); remove_action( 'show_user_profile', array( 'wp_user_avatar', 'wpua_media_upload_scripts' ) ); // Remove from edit_user_profile hook remove_action( 'edit_user_profile', array( 'wp_user_avatar', 'wpua_action_show_user_profile' ) ); remove_action( 'edit_user_profile', array( 'wp_user_avatar', 'wpua_media_upload_scripts' ) ); // Add to edit_user_avatar hook add_action( 'edit_user_avatar', array( 'wp_user_avatar', 'wpua_action_show_user_profile' ) ); add_action( 'edit_user_avatar', array( 'wp_user_avatar', 'wpua_media_upload_scripts' ) ); } // Loads only outside of administration panel if ( ! is_admin() ) { add_action( 'init','my_avatar_filter' ); } 

HTML Wrapper

You can change the HTML wrapper of the One User Avatar section by using the functions wpua_before_avatar and wpua_after_avatar. By default, the avatar code is structured like this:

<div class="wpua-edit-container"> <h3>Avatar</h3> <input type="hidden" name="wp-user-avatar" id="wp-user-avatar" value="{attachmentID}" /> <p id="wpua-add-button"> <button type="button" class="button" id="wpua-add" name="wpua-add">Edit Image</button> </p> <p id="wpua-preview"> <img src="{imageURL}" alt="" /> Original Size </p> <p id="wpua-thumbnail"> <img src="{imageURL}" alt="" /> Thumbnail </p> <p id="wpua-remove-button"> <button type="button" class="button" id="wpua-remove" name="wpua-remove">Default Avatar</button> </p> <p id="wpua-undo-button"> <button type="button" class="button" id="wpua-undo" name="wpua-undo">Undo</button> </p> </div> 

To strip out the div container and h3 heading, you would add the following filters to the functions.php file in your theme:

remove_action( 'wpua_before_avatar', 'wpua_do_before_avatar' ); remove_action( 'wpua_after_avatar', 'wpua_do_after_avatar' ); 

To add your own wrapper, you could create something like this:

function my_before_avatar() { echo '<div id="my-avatar">'; } add_action( 'wpua_before_avatar', 'my_before_avatar' ); function my_after_avatar() { echo '</div>'; } add_action( 'wpua_after_avatar', 'my_after_avatar' ); 

This would output:

<div id="my-avatar"> <input type="hidden" name="wp-user-avatar" id="wp-user-avatar" value="{attachmentID}" /> <p id="wpua-add-button"> <button type="button" class="button" id="wpua-add" name="wpua-add">Edit Image</button> </p> <p id="wpua-preview"> <img src="{imageURL}" alt="" /> <span class="description">Original Size</span> </p> <p id="wpua-thumbnail"> <img src="{imageURL}" alt="" /> <span class="description">Thumbnail</span> </p> <p id="wpua-remove-button"> <button type="button" class="button" id="wpua-remove" name="wpua-remove">Default Avatar</button> </p> <p id="wpua-undo-button"> <button type="button" class="button" id="wpua-undo" name="wpua-undo">Undo</button> </p> </div> 

1. Download, install, and activate the One User Avatar plugin.
2. On your profile edit page, click “Edit Image”.
3. Choose an image, then click “Select Image”.
4. Click “Update Profile”.
5. Upload your own Default Avatar in your One User Avatar settings (optional). You can also allow Contributors & Subscribers to upload avatars and disable Gravatar.
6. Choose a theme that has avatar support. In your theme, manually replace get_avatar with get_wp_user_avatar or leave get_avatar as-is. Read about the differences here.
7. You can also use the [avatar_upload] and [avatar] shortcodes in your posts. These shortcodes will work with any theme, whether it has avatar support or not.

Warning

If you are using One User Avatar to replace an existing installation of WP User Avatar, do not delete the old WP User Avatar plugin from the WordPress plugin administration screen, otherwise you will lose all your existing avatars. Instead, deactivate the WP User Avatar plugin and then manually delete it using FTP. If you can’t access your files directly, contact your hosting provider and ask them to delete it for you or simply leave the old plugin deactivated.

Example Usage

Posts

Within The Loop, you may be using:

<?php echo get_avatar( get_the_author_meta( 'ID' ), 96 ); ?> 

Replace this function with:

<?php echo get_wp_user_avatar( get_the_author_meta( 'ID' ), 96 ); ?> 

You can also use the values “original”, “large”, “medium”, or “thumbnail” for your avatar size:

<?php echo get_wp_user_avatar( get_the_author_meta( 'ID' ), 'medium' ); ?> 

You can also add an alignment of “left”, “right”, or “center”:

<?php echo get_wp_user_avatar( get_the_author_meta( 'ID' ), 96, 'left' ); ?> 

Author Page

On an author page outside of The Loop, you may be using:

<?php $user = get_user_by( 'slug', $author_name ); echo get_avatar( $user->ID, 96 ); ?> 

Replace this function with:

<?php $user = get_user_by( 'slug', $author_name ); echo get_wp_user_avatar( $user->ID, 96 ); ?> 

If you leave the options blank, One User Avatar will detect whether you’re inside The Loop or on an author page and return the correct avatar in the default 96×96 size:

<?php echo get_wp_user_avatar(); ?> 

The function get_wp_user_avatar can also fall back to get_avatar if there is no One User Avatar image. For this to work, “Show Avatars” must be checked in your One User Avatar settings. When this setting is enabled, you will see the user’s Gravatar avatar or Default Avatar.

Comments

For comments, you might have in your template:

<?php echo get_avatar($comment, 32); ?> 

Replace this function with:

<?php echo get_wp_user_avatar($comment, 32); ?> 

For comments, you must specify the $comment variable.

Other Available Functions

[avatar_upload] shortcode

You can use the [avatar_upload] shortcode to add a standalone uploader to a front page or widget. This uploader is only visible to logged-in users.

You can specify a user with the shortcode, but you must have edit_user capability for that particular user.

[avatar_upload user="admin"] 

[avatar] shortcode

You can use the [avatar] shortcode in your posts. It will detect the author of the post or you can specify an author by username. You can specify a size, alignment, and link, but they are optional. For links, you can link to the original image file, attachment page, or a custom URL.

[avatar user="admin" size="medium" align="left" link="file" /] 

You can also add a caption to the shortcode:

[avatar user="admin" size="medium" align="left" link="file"]Photo Credit: Your Name[/avatar] 

Note: If you are using one shortcode without a caption and another shortcode with a caption on the same page, you must close the caption-less shortcode with a forward slash before the closing bracket: [avatar /] instead of [avatar]

get_wp_user_avatar_src

Works just like get_wp_user_avatar but returns just the image src. This is useful if you would like to link a thumbnail-sized avatar to a larger version of the image:

<a href="<?php echo get_wp_user_avatar_src( $user_id, 'large' ); ?>"> <?php echo get_wp_user_avatar( $user_id, 'thumbnail' ); ?> </a> 

has_wp_user_avatar

Returns true if the user has a One User Avatar image. You must specify the user ID:

<?php if ( has_wp_user_avatar( $user_id ) ) { echo get_wp_user_avatar( $user_id, 96 ); } else { echo '<img src="my-alternate-image.jpg" />'; } ?> 

1. 

   One User Avatar admin settings.

2. 

   One User Avatar lets you upload your own Default Avatar.

2.4.0

• Add compatibility for WordPress 6.3
• Fix custom avatars not returning in REST API calls
• Fix mobile view of avatar library
• Fix unable to change the default avatar when the browser file uploader option is active
• Fix default avatar radio not showing as checked on the settings page
• Fix unit showing twice under maximum upload file size when using the browser uploader

2.3.9

• Escape, sanintize & validate data

2.3.8

• Pass $args parameter from get_avatar to custom avatar filter
• Replace png icon with svg icon in admin menu

2.3.7

• Fix XSS vulnerability

2.3.6

• Add option to replace custom avatar functionality in Ultimate Member plugin

2.3.5

• Fix “Choose Image” button not triggering media uploader on admin discussion page
• Remove jQuery UI dependency
• Prettify avatar library table

2.3.4

• Add option to force the file uploader in avatar upload shortcode

2.3.3

• Fix parse error in PHP 7

2.3.2

• Fix missing Portuguese translation

2.3.1

• Add Portuguese translation
• Add One_User_Avatar::plugin_dir_path() function
• Improve Dutch translation
• Remove redundant plural translation for ‘All %s’
• Make URLs translatable
• Remove obsolete translation strings
• Fix indentation
• Fix nested call to wp_nonce_url()

2.3.0

• Rename to One User Avatar
• Rewrite to conform with WordPress Coding Standards
• Add translations for Dutch, English (UK), French, German, Italian, Portuguese, Romanian, Spanish
• Prevent conflict with old WP User Avatar plugin
• Fix indentation
• Fix unescaped attributes
• Fix missing translation strings
• Fix headers already sent error when performing bulk actions
• Fix headers already sent error on when updating avatar using shortcode
• Fix TinyMCE deprecation notice
• Fix previev image not reverting when removing from user profile
• Remove unused images
• Remove MailOptin recommendation

2.2.16

• Fixed issue of low quality avatar.

2.2.15

• Fixed broken avatar in some edge cases.

2.2.14

• Added missing space before classes.

2.2.13

• Fixed broken avatar image.

2.2.12

• Fixed issue where contributors and subscribers could see posts in the backend.
• Fixed Persistent XSS via display name when avatar is displayed.

2.2.11

• Added classes passed to get_avatar function to avatar display
• Added avatar_defaults filter.
• Fix wpua_get_avatar_url not passing args further down.

2.2.10

• Fixed: Warning: Missing argument 2 for WP_User_Avatar.
• Re-added support for hook implementation eg on wp frontend.

2.2.9

• Fixed PHP Notice: Trying to get property ‘ID’ of non-object.
• Fixed Fatal Error: Cannot use string offset as an array.
• Fixed: Deprecated: whitelist_options is deprecated since version 5.5.0
• Increased the priority of user_profile_picture_description filter usage

2.2.8

• Fixed: Notice: Object of class WP_User could not be converted.
• Replace core Profile Picture in profile edit screen with One User Avatar.
• Replace ‘Avatar’ as a label with ‘Profile Picture’.
• Removed dashboard access restriction feature.
• Fixed contextual button display showing undo button on page load.

2.2.7

• Removed target blank from dismiss url of admin notice
• Code enhancements and improvements.

2.2.6

• Improve compatibility with latest WordPress version.

2.2.5

• Fix: Missing translation strings added.

2.2.4

• Fix: Warning Resolved on Avatar images.

2.2.3

• Fix: Broken Avatar in buddypress resolved.

2.2.2

• Fix: Broken avatars on comments section.

2.2.1

• Fix: get_avatar_url filter is defined.

2.2.0

• Fix: Fatel Error “Cannot use string offset as an array” resolved in PHP7.2.

2.1.9

• New: New filter ‘wpua_default_alt_tag’ added to modify default image alt tag And warning error resolved on stagging environment.

2.1.8

• Fix: Language Files are updated and warning error resolved on stagging environment.

2.1.7

• Fix: Default ALT tag added.

2.1.6

• Fix: Removed ads from the setting page.

2.1.5

• Fix: Translation bug resolved in class-wp-user-avatar-admin file in PHP 7.

2.1.4

• Fix: Remove Ads from dashboard and all other pages.

2.1.3

• Fix: Better Styling

2.1.2

• Fix: Tested up to 4.9.7

2.1.1

• Fix: Insecure content over https issue is fixed.

2.0.9

• New Shortcode: Use [avatar user=current] shortcode to show current logged in user avatar.

2.0.8

• Fix: Compatible with php 7.

2.0.7

• Improvement Fix: Removed languages files to be used from core wordpress language packs.

2.0.7

• Improvement Fix: Removed languages files to be used from core wordpress language packs.

2.0.6

• Improvement Fix: Broken Jquery files from UI is resolved.

2.0.5

• Improvement Fix: Broken JS files from UI is resolved.

2.0.4

• Improvement Fix: Activation warning in some cases is resolved.

2.0.3

• Improvement Fix: Added missing translation strings in English version of po file.

2.0.0

• Improvement Fix: Added missing translation strings in English version of po file.
• Bug Fix: Missing $user = $current_user is added in class-wp-user-avatar.php on line 156.

1.9.19

• Improvement Fix: Fixed add_query_arg() and remove_query_arg() usage to avoid XSS Vulnerability.

1.9.18

• Bug Fix: Removed cron job dependency for excellent performance.
• Bug Fix: Resolved gravatar was not showing on some special cases.
• Bug Fix: Resolved speed problem in case of large number of users for multisite, bbpress and buddy press.
• Bug Fix: Resolved display custom avatar problem when default and customer avatar is same choosen.

1.9.17

• Bug Fix: Removed the looping through all users on admin_init action.

1.9.16

• Bug Fix: lots of entries in wp_options table resolved.

1.9.15

• Bug Fix: Multiple Cron job added bug resolved.

1.9.14

• Bug Fix: Speed Issues due to check many times if gravatar exist.
• Bug Fix: Default gravatar issue for mustache and gravatar logo at front end and at buddypress pages
• Bug Fix: Avatar while adding for existing user.
• Bug Fix: UI issue when Gravatar option is enable/disable.

1.9.13

• Bug Fix: Load _load_wp_includes mostly only on front pages
• Bug Fix: Check for edit_posts capability before enabling filters for Subscribers

1.9.12

• Add: wpua_edit_user_redirect_url filter
• Add: wpua_edit_user_safe_redirect filter
• Bug Fix: Clean output buffer
• Update: Description field for widget

1.9.11

• Update: Disable resource manager until a better solution comes along

1.9.10

• Bug Fix: Check for TinyMCE version

1.9.9

• Bug Fix: TinyMCE not loaded

1.9.8

• Bug Fix: Check user permissions for displaying widget
• Update: Load resource manager only if NextGEN Gallery isn’t installed

1.9.7

• Bug Fix: Remove resource manager
• Bug Fix: User ID in shortcode

1.9.6

• Bug Fix: Load resource manager on front pages only
• Update: [avatar_upload] user variable
• Update: Documentation

1.9.5

• Add: Start documentation of functions
• Bug Fix: [avatar_upload] permalink and redirect

1.9.4

• Add: Widget for [avatar_upload]
• Add: wpua_before_avatar_admin and wpua_after_avatar_admin for admin pages
• Bug Fix: Load functions class on plugins_loaded
• Update: Allow non-numeric WPUA value

1.9.3

• Bug Fix: Missing php

1.9.2

• Add: Setup class
• Bug Fix: Give wpua_attachment_is_image filter two variables
• Bug Fix: Return [avatar_upload] instead of echo
• Remove: Unneccessary filters
• Update: Allow upload to overwrite avatar for Contributors & Subscribers
• Update: Move Edit Image link for Contributors & Subscribers
• Update: Move text from localize script to data attribute
• Update: Shorten variable names
• Update: Wrap all classes in init

1.9.1

• Bug Fix: Double underscore for options page title
• Bug Fix: Remove TinyMCE language pack
• Bug Fix: Wrong variables in get_wp_user_avatar filter

1.9

• Add: Filters throughout plugin
• Bug Fix: Die messages
• Update: Move public functions to class

1.8.10

• Add: Search and screen option in Media Library view
• Bug Fix: Bulk delete in Media Library view
• Bug Fix: Hide captions if “Show Avatars” is off
• Bug Fix: Update avatar metadata on removal
• Update: Choose Image text
• Update: Show only images in Media Library modal
• Update: Show upload tab if no One User Avatar image has been selected yet

1.8.9

• Bug Fix: Check for post object

1.8.8

• Bug Fix: Media upload scripts

1.8.7

• Bug Fix: Bad reference to wpua_is_author_or_above

1.8.6

• Bug Fix: Check for media upload scripts before setting post parent

1.8.5

• Add: Capability check in one function

1.8.4

• Bug Fix: Set avatar post parent to 0

1.8.3

• Bug Fix: Prevent attachment insert without image
• Update: Check for delete_posts capability instead of user role for Subscribers
• Update: Refactor and clean up

1.8.2

• Bug Fix: Edit avatar setting

1.8.1

• Bug Fix: Reattach scripts to profile action

1.8

• Add: Front page uploader
• Add: Media Library view of all avatars
• Bug Fix: Identify public static functions
• Update: Refactor code into separate classes
• Update: Translations

1.7.2

• Bug Fix: Files not committed properly in previous release

1.7.1

• Update: Error message handling for front pages

1.7

• Add: Caption for avatar
• Add: Polish translation
• Update: Error message handling

1.6.8

• Bug Fix: Shortcode without user

1.6.7

• Add: Undo button
• Bug Fix: Get original avatar

1.6.6

• Add: Donation message
• Bug Fix: Die page when image is too large
• Bug Fix: Resize images uploaded through plugin only
• Remove: Unused function
• Update: Refactor JavaScript

1.6.5

• Bug Fix: Use entire comment object instead of just e-mail address

1.6.4

• Bug Fix: Correct avatar not showing in widget
• Update: Check compatibility to 3.7.1

1.6.3

• Bug Fix: Checkbox value for “Crop avatars to exact dimensions”

1.6.2

• Bug Fix: Show Default Avatar if attachment doesn’t exist
• Bug Fix: manage_users_custom_column not returning values

1.6.1

• Bug Fix: Profile not saving without an avatar for Contributors & Subscribers

1.6.0

• Add: Filters to change profile HTML structure
• Add: Recognition of sizes registered with add_image_size
• Add: Resize image options for Contributors & Subscribers
• Bug Fix: Rerrange CSS class names

1.5.8

• Bug Fix: Add function exists checks to prevent redeclare errors
• Bug Fix: Page die if file upload is too big
• Bug Fix: Upload file with submit

1.5.7

• Bug Fix: Separate out JavaScript for Contributors & Subscribers
• Bug Fix: Subscriber uploader not finding error type

1.5.6

• Update: Use cache for wpua_has_gravatar

1.5.5

• Bug Fix: Hide “Edit Image” button if Contributors & Subscribers can’t edit avatar
• Bug Fix: Remove edit_posts capability if Subscribers can’t edit avatar

1.5.4

• Add: Option to enable avatar editing privilege for Contributors & Subscribers
• Add: Swedish translation
• Update: Move inline JavaScript to wp-user-avatar.js and wp-user-avatar-admin.js
• Update: Load JavaScript in footer
• Update: Translations

1.5.3

• Remove: Option to disable scripts in front pages
• Update: Load media upload scripts only on profile and avatar admin pages
• Update: Translations

1.5.2

• Bug Fix: Ability to disable scripts in front pages

1.5.1

• Add: Ability to disable scripts in front pages
• Update: Uninstall options
• Update: Translations

1.5

• Add: Ability to disable Gravatar avatars
• Add: Upload size limiter for Contributors & Subscribers
• Add: French, German, and Spanish translations

1.4.2

• Bug Fix: Include screen.php for get_current_screen function

1.4.1

• Bug Fix: Allow multipart data in form
• Bug Fix: Use wp_die for errors

1.4

• Add: Uploader for Contributors & Subscribers
• Add: Media states for avatar images
• Add: Plugin admin settings
• Update: Change support only to WP 3.4+

1.3.6

• Add: Target for link in shortcode
• Update: Clean up code and add more comments

1.3.5

• Bug Fix: Swap TinyMCE file locations

1.3.4

• Update: Change support only to WP 3.3+ because of jQuery 1.7.1 support

1.3.3

• Update: Shortcode checks for user ID, login, slug, or e-mail address
• Update: Move jquery to register_script for < WP 3.5

1.3.2

• Bug Fix: Check for user before setting name in alt tag
• Update: readme.txt

1.3.1

• Bug Fix: Rename usermeta only if found

1.3

• Add: Multisite support
• Bug Fix: Warnings if no user found
• Update: Enable action_show_user_profile for any class using show_user_profile hook

1.2.6

• Bug Fix: options-discussion.php page doesn’t show default avatars

1.2.5

• Bug Fix: Comment author showing wrong avatar
• Bug Fix: Avatar adds fixed dimensions when non-numeric size is used
• Update: Use local image for default avatar instead of calling image from Gravatar

1.2.4

• Bug Fix: Show default avatar when user removes custom avatar
• Bug Fix: Default Avatar save setting

1.2.3

• Bug Fix: Show default avatar when user removes custom avatar
• Bug Fix: Default Avatar save setting

1.2.2

• Add: Ability for bbPress users to edit avatar on front profile page
• Add: Link options for shortcode
• Bug Fix: Show One User Avatar only to users with upload_files capability

1.2.1

• Add: TinyMCE button
• Update: Clean up redundant code
• Update: Compatibility only back to WordPress 3.3

1.2

• Add: Default Avatar setting

1.1.8

• Bug Fix: Change update_usermeta to update_user_meta

1.1.6

• Bug Fix: Image not showing in user profile edit

1.1.5a

• Update: readme.txt

1.1.5

• Bug Fix: Remove stray curly bracket

1.1.4

• Bug Fix: Change get_usermeta to get_user_meta
• Bug Fix: Non-object warning when retrieving user ID

1.1.3

• Bug Fix: Comment author with no e-mail address

1.1.2

• Remove: Unused variables

1.1.1

• Bug Fix: Capabilities error in comment avatar

1.1

• Add: Add filter for get_avatar
• Add: CSS alignment classes
• Add: Replace comment author avatar
• Add: Shortcode
• Update: readme.txt

1.0.2

• Update: FAQ
• Remove: CSS that hides “Insert into Post”

1.0.1

• Add: CSS classes to image output

1.0

• Initial release