=== WP User Profile Avatar ===
Contributors: wpeventmanager,ashokdudhat,hiteshmakvana Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=55FRYATTFLA5N Tags: avatar, user profile, gravatar,custom profile photo, custom profile picture, profile photo, profile picture, author image, author photo Requires at least: 5.8 Tested up to: 6.5.4 Stable tag: 1.0.3 Requires PHP: 8.0.2 License: GNU General Public License v3.0 License URI: https://www.gnu.org/licenses/gpl-3.0.html
== Description ==
P User Profile Avatar allows you to change the default WordPress avatar or User profile picture. You can use any photos uploaded into your Media Library or use a custom photo URL as an avatar instead of using Gravatar.
Plugin Features
Set new user profile avatar from admin panel.
Go Admin Dashboard -> Users -> All Users --> Select any user profile you would like to edit.
Find "WP User Profile Avatar" section, You can give new avatar url path or you can upload avatar using media library.
Update User.
Display new user profile avatar at frontend side.
To retrieve the user avatar/photo on the front-end use one of the following approach in your template page(s).
1. Using shortcode and pass parameters based on your need.
Shortcode: [user_profile_avatar]
Parameters: userid, size, align, link, target and caption.
userid : id of the user.
size: original,medium,large,thumbnail.
align: alignleft,aligncenter,alignright.
link: image, attachment, custom.
target: _blank, self,
caption: you can give any text value in between shortcode bracket and it will display below user avtar profile.
1.1 Display default avatar using visual editor.
You can use the following shortcode in any page and it will show default avatar of the plugin.
[user_profile_avatar]
1.2 Display avatar for the perticular user using visual editor.
if you want to show user profile for the user id 1.
[user_profile_avatar user_id="1"]
You can also set other parameters like size, align, link, target and caption in this shortcode.
Example:
[user_profile_avatar user_id="1" size="original" align="aligncenter" link="image" target="_blank"] Display Name [/user_profile_avatar]
1.3 if you want to assign dynamic user id in shortocde without using visual editor`<?php //for the logged user, Current user object $user = wp_get_current_user();
echo do_shortcode('[user_profile_avatar user_id="<?php $user->id ?>" size="original" align="aligncenter" link="image" target="_blank"]'. $user->display_name .'[/user_profile_avatar]');?>`
2. Using the function wpupa_get_url.
You will need to place below code in each area of your theme where you wish to add and retrieve your theme’s custom avatar image.
2.1 At Author page
-------------------`<?php
// Get The Post's Author ID
$authorID = get_the_author_meta('ID');
$authorname = get_the_author_meta('display_name', $authorID);
// Set the image size. Accepts all registered images sizes and array(int, int)
$size = 'thumbnail';
$imgURL='';
// Get the image URL using the author ID and image size params
if (function_exists('wpupa_get_url'))
$imgURL = wpupa_get_url($authorID, ['size' => $size]);
// display image on the page
echo '<img src="https://github.com/wpeventmanager/wp-user-profile-avatar/raw/master/'. $imgURL .'" alt="'. $authorname .'">';?>`
2.2 Except Author page
----------------------`<?php
// Current user object
$user = wp_get_current_user();
// Set the image size. Accepts all registered images sizes and array(int, int)
$size = 'thumbnail';
$imgURL='';
// Get the image URL using the author ID and image size params
if (function_exists('wpupa_get_url'))
$imgURL = wpupa_get_url($user->id, ['size' => $size]);
// display image on the page
echo '<img src="https://github.com/wpeventmanager/wp-user-profile-avatar/raw/master/'. $imgURL .'" alt="'. $user->display_name .'">';?>`
You will need to place above code in each area of your theme where you wish to add and retrieve your theme's custom avatar image.
= Be a contributor =
If you want to contribute, go to our WP User Profile Avatar GitHub Repository and see where you can help.
You can also add a new language via translate.wordpress.org. We've built a short guide explaining how to translate and localize the plugin.
Thanks to all of our contributors.
= Feedback =
= More =
= Connect With US =
To stay in touch and get latest update about WP User Profile Avatar's further releases and features, you can connect with us via:
== Installation ==
= Automatic installation =
Automatic installation is the easiest option as WordPress handles the file transfers itself and you don't even need to leave your web browser. To do an automatic install, log in to your WordPress admin panel, navigate to the Plugins menu and click Add New.
In the search field type "WP User Profile Avatar" and click Search Plugins. Once you've found the plugin you can view details about it such as the the point release, rating and description. Most importantly of course, you can install it by clicking Install Now.
= Manual installation =
The manual installation method involves downloading the plugin and uploading it to your web server via your favorite FTP application.
Download the plugin file to your computer and unzip it
Using an FTP program, or your hosting control panel, upload the unzipped plugin folder to your WordPress installation's wp-content/plugins/ directory.
Activate the plugin from the Plugins menu within the WordPress admin.
== Frequently Asked Questions ==
= How I can set new user profile avatar from admin panel? =
Go Admin Dashboard -> Users -> All Users --> Select any user profile you would like to edit.
Find "WP User Profile Avatar" section, You can give new avatar url path or you can upload avatar using media library.
Update User.
= How I can display new user profile avatar at frontend side? =
You can show user profile avatar two ways.
1. Using shortcode and pass parameters based on your need.
Shortcode: [user_profile_avatar]
Parameters: userid, size, align, link, target and caption.
userid : id of the user.
size: original,medium,large,thumbnail.
align: alignleft,aligncenter,alignright.
link: image, attachment, custom.
target: _blank, self,
caption: you can give any text value in between shortcode bracket and it will display below user avtar profile.
1.1 Display default avatar using visual editor.
You can use the following shortcode in any page and it will show default avatar of the plugin.
[user_profile_avatar]
1.2 Display avatar for the perticular user using visual editor.
if you want to show user profile for the user id 1.
[user_profile_avatar user_id="1"]
You can also set other parameters like size, align, link, target and caption in this shortcode.
Example:
[user_profile_avatar user_id="1" size="original" align="aligncenter" link="image" target="_blank"] Display Name [/user_profile_avatar]
1.3 if you want to assign dynamic user id in shortocde without using visual editor
//for the logged user, Current user object
$user = wp_get_current_user();
echo do_shortcode('[user_profile_avatar user_id="<?php $user->id ?>" size="original" align="aligncenter" link="image" target="_blank"]'. $user->display_name .'[/user_profile_avatar]');2. Using the function wpupa_get_url.
You will need to place below code in each area of your theme where you wish to add and retrieve your theme’s custom avatar image.
2.1 At Author page
-------------------
// Get The Post's Author ID
$authorID = get_the_author_meta('ID');
$authorname = get_the_author_meta('display_name', $authorID);
// Set the image size. Accepts all registered images sizes and array(int, int)
$size = 'thumbnail';
$imgURL='';
// Get the image URL using the author ID and image size params
if (function_exists('wpupa_get_url'))
$imgURL = wpupa_get_url($authorID, ['size' => $size]);
// display image on the page
echo '<img src="https://github.com/wpeventmanager/wp-user-profile-avatar/raw/master/'. $imgURL .'" alt="'. $authorname .'">';
2.2 Except Author page
----------------------
// Current user object
$user = wp_get_current_user();
// Set the image size. Accepts all registered images sizes and array(int, int)
$size = 'thumbnail';
$imgURL='';
// Get the image URL using the author ID and image size params
if (function_exists('wpupa_get_url'))
$imgURL = wpupa_get_url($user->id, ['size' => $size]);
// display image on the page
echo '<img src="https://github.com/wpeventmanager/wp-user-profile-avatar/raw/master/'. $imgURL .'" alt="'. $user->display_name .'">';= How to allow Contributors & Subscribers can upload avatar? =
Go Admin Dashboard -> Users -> Profile Avatar Settings.
Find "Allow Contributors & Subscribers to upload avatars", check it.
Save Changes.
== Screenshots ==
Settings.
Default Gavatars & set custom default avatar.
Set custom avatar for user profile example 1.
Set custom avatar for user profile example 2.
Display avatar & upload avatar shortcode icon for Visual Editor.
Generate display user profile avatar shortcode.
Generate user profile avatar upload shortcode.
Upload shortcode GUI for the frontend side.
After uploading avatar successfully, show undo option.
After refreshing page, remove option show instead of undo option for uploaded avatar.
After removing uploaded avatar, show message successfully removed avatar.
== Credits == 1.WP Event Manager wants to give credit to GoogleAPIs as we are using GoogleAPIs to support users using their Google+ profile links on our plugin.
== Changelog ==
= 1.0.3 [June 11th, 2024] =
Fixed: The security issue of the plugin has been resolved. Fixed: The issue of displaying a corrupted author image at the backend has been resolved. Fixed: The remove image button is now visible. Fixed: The issue related to displaying the profile image on the event, organizer, and venue pages is now resolved. Fixed: The image URL avatar is now set. Fixed: The user dropdown box now displays the default text.
= 1.0.2 [Feb 22nd, 2023] =
Fixed: User section text is now displayed properly. Fixed: The Mystery Man image is now set at the user section. Fixed: The text related to the biographical info in Elementor is now displayed at the correct place. Fixed: All the options are set for the default user profile avatar. Fixed: Now p tags are created with social media options. Fixed: Space is added to the author box. Fixed: The “choose” button in the default avatar section is now working properly. Fixed: The user avatar size reduction option is now working. Fixed: The security issue is now resolved. Fixed: The profile image display related issue is now resolved. Fixed: Now custom default profile avatar can be set after disabling the default gravatar. Added: The option to hide the Bio Info Author Box is added.
= 1.0.1 [Dec 15th, 2023] =
Fixed : No error message is shown while updating the username from the admin panel Fixed : Security issues are resolved in the profile avatar settings. Fixed : Security vulnerability issue in the profile avatar plugin is resolved. Fixed : The title of a settings option is rectified. Fixed : Proper user profile avatar description is added. Fixed : The active license option is removed from Profile Avatar. Fixed : User profile menu options are now available. Fixed : Issue related to the URL image size in the Elementor is resolved now. Fixed : Biographical info is removed from the venue and organizer section. Fixed : Profile Avatar is now visible on the event details page. Fixed : The warning message that appears in the backend is removed. Fixed : The profile avatar size issue in the Elementor is resolved. Fixed : The issue related to uploading an image in profile avatar in elementor has been resolved. Fixed : Additional tooltip display issue in the profile icon is resolved now. Fixed : Profile icon alignment issue is resolved. Fixed : Profile Avatar banner is improved in wordpress.org. Fixed : Fields are removed after uninstalling the plugin. Fixed : Username label in profile avatar is rectified. Fixed : Issue related to the plugin activation is resolved. Fixed : Images on the All user page are now properly displayed. Fixed : Administrator’s media library access is restricted for other users. Fixed : Issue related to controlling the file size is now resolved. Fixed : Homepage error is resolved. Fixed : Authorbox is now available with a Social media link. Fixed : The plugin is now compatible with bbpress. Fixed : Shortcode avatar button is added to the visual editor.
= 1.0 [May 23th, 2020] =
First stable release of User Profile Avatar.