About this plugin
WordPress currently only allows you to use custom avatars that are uploaded through Gravatar. WP 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.
WP User Avatar also lets you:
- Upload your own Default Avatar in your WP User Avatar settings.
- Show the user’s Gravatar avatar or Default Avatar if the user doesn’t have a WP 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.
ADD WP 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, WP User Avatar is automatically added to the show_user_profile and edit_user_profile hooks. If you’d rather have WP User Avatar in its own section, you could add another hook:
do_action('edit_user_avatar', $current_user);
php file of your theme:
HTML WRAPPER
You can change the HTML wrapper of the WP 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>
php file in your theme:
>
To add your own wrapper, you could create something like this:
php function my_before_avatar() { echo '<div id="my-avatar">'; } add_action('wpua_before_avatar', 'my_before_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>