One User Avatar | User Profile Picture

First, choose a theme that has avatar support. In your theme, you have a choice of manually replacing get_avatar with get_wp_user_avatar , or leaving get_avatar as-is. Here are the differences:

Allows you to use the values “original”, “large”, “medium”, or “thumbnail” for your avatar size. Doesn’t add a fixed width and height to the image if you use the aforementioned values. This will give you more flexibility to resize the image with CSS. Allows you to use custom image sizes registered with add_image_size (fixed width and height are added to the image). Optionally adds CSS classes “alignleft”, “alignright”, or “aligncenter” to position your avatar. Shows nothing if the user has no One User Avatar image. Shows the user’s Gravatar avatar or Default Avatar only if “Show Avatars” is enabled in your One User Avatar settings.

Requires you to enable “Show Avatars” in your One User Avatar settings to show any avatars. Accepts only numeric values for your avatar size. Always adds a fixed width and height to your image. This may cause problems if you use responsive CSS in your theme. Shows the user’s Gravatar avatar or Default Avatar if the user doesn’t have a One User Avatar image. (Choosing “Blank” as your Default Avatar still generates a transparent image file.) Requires no changes to your theme files if you are currently using get_avatar . Read more about get_avatar in the WordPress Function Reference .

In your One User Avatar settings, you can upload your own Default Avatar.

In your One User Avatar settings, you can select “Disable Gravatar — Use only local avatars” to disable all Gravatar avatars on your site and replace them with your Default Avatar. This will affect your registered users and non-registered comment authors.

Yes, if you enable “Allow Contributors & Subscribers to upload avatars” in the One User Avatar settings. These users will see a slightly different interface because they are allowed only one image upload.

Yes, for registered users. Non-registered comment authors will show their Gravatar avatars or Default Avatar.

Yes!

No, BuddyPress has its own custom avatar functions and One User Avatar will override only some of them. It’s best to use BuddyPress without One User Avatar.

For Administrators, One User Avatar adds a column with avatar thumbnails to your Users list table. If “Show Avatars” is enabled in your One User Avatar settings, you will see avatars to the left of each username instead of in a new column.

Yes, you can use the [avatar_upload] shortcode to put a standalone uploader in 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 to change the user’s avatar.

[avatar_upload user="admin"]

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="96" align="left" link="file" /]

Outputs:

<a href="{fileURL}" class="wp-user-avatar-link wp-user-avatar-file"> <img src="{imageURL}" width="96" height="96" class="wp-user-avatar wp-user-avatar-96 alignleft" /> </a>

If you have a caption, the output will be similar to how WordPress adds captions to other images.

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

Outputs:

<div style="width: 106px" class="wp-caption alignleft"> <a href="{fileURL}" class="wp-user-avatar-link wp-user-avatar-file"> <img src="{imageURL}" width="96" height="96" class="wp-user-avatar wp-user-avatar-96" /> </a> <p class="wp-caption-text">Photo Credit: Your Name</p> </div>

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]

One User Avatar will add the CSS classes “wp-user-avatar” and “wp-user-avatar-{size}” to your image. If you add an alignment, the corresponding alignment class will be added:

<?php echo get_wp_user_avatar($user_id, 96, 'left'); ?>

Outputs:

<img src="{imageURL}" width="96" height="96" class="wp-user-avatar wp-user-avatar-96 alignleft" />

Note: “alignleft”, “alignright”, and aligncenter” are common WordPress CSS classes, but not every theme supports them. Contact the theme author to add those CSS classes.

If you use the values “original”, “large”, “medium”, or “thumbnail”, no width or height will be added to the image. This will give you more flexibility to resize the image with CSS:

<?php echo get_wp_user_avatar($user_id, 'medium'); ?>

Outputs:

<img src="{imageURL}" class="wp-user-avatar wp-user-avatar-medium" />

Note: WordPress adds more CSS classes to the avatar not listed here.

If you use the [avatar] shortcode, One User Avatar will add the CSS class “wp-user-avatar-link” to the link. It will also add CSS classes based on link type.

• Image File: wp-user-avatar-file
• Attachment: wp-user-avatar-attachment
• Custom URL: wp-user-avatar-custom [avatar user=”admin” size=”96″ align=”left” link=”attachment” /]

Outputs:

<a href="{attachmentURL}" class="wp-user-avatar-link wp-user-avatar-attachment"> <img src="{imageURL}" width="96" height="96" class="wp-user-avatar wp-user-avatar-96 alignleft" /> </a>

get_wp_user_avatar_src : retrieves just the image URL has_wp_user_avatar : checks if the user has a One User Avatar image See example usage here