Description
A more flexible way to attach and display a photo for a WordPress user profile.
Some users might not have or want to have a gravatar account or other universal avatar account. They simply may want to use a one-time specified photo to represent them on your WordPress site. This plugin solves that use case.
With the ability to upload a photo to a user profile via the WordPress Media Uploader or by specifying an external URL to an image, your users and/or authors can have a personalized photo specific to your website.*
This plugin will add a custom set of fields to the user profile page which will allow for the use of a custom profile photo.
You can add/change/edit uploaded photos directly from the user profile page. The external option allows you to provide a URL to the external image or remove it.
As of v0.4, the plugin now filters the get_avatar() function found in most WordPress themes.
Simply go to the users section and select a user or select “Your Profile” depending on your permission level. The new fields are added to the bottom of the user profile page. Choose which type of photo you want to use. Upload an image or add an external url. Then press the Update Profile button.
If you require a customized approach or your theme does not support the get_avatar() hook, use the example below.
To retrieve the photo on the front-end use the following example on your template page(s).
<?php
// Retrieve The Post's Author ID
$user_id = get_the_author_meta('ID');
// Set the image size. Accepts all registered images sizes and array(int, int)
$size = 'thumbnail';
// Get the image URL using the author ID and image size params
$imgURL = get_cupp_meta($user_id, $size);
// Print the image on the page
echo '<img src="'. $imgURL .'" alt="">';
?>
You will need to place the code above in each area of your theme where you wish to add and retrieve your theme’s custom avatar image. This can include but is not limited to single.php, page.php, and comments.php.
*Future Updates to this plugin include allowing other roles to access this feature, a settings page to allow a custom default image and other options.
Translations
- English – default, always included
- Dutch
- Hungarian
- Spanish
Credits
Thanks to Olaf Lederer, Harkály Gerg?, sqhendr, SOMTIJDS, David Pérez
Screenshots
The new fields that are added to the user profile page.
After uploading and saving your selected image.
On hover, Edit or Remove an uploaded image.
On hover, Remove a URL to an external image.
An example of getting this new image to display on the front-end.
Installation
- Upload
custom-user-profile-photofolder to the/wp-content/plugins/directory - Activate the plugin through the ‘Plugins’ menu in WordPress
- Place
<?php get_cupp_meta($user_id, $size); ?>in your templates
FAQ
-
Who can upload and manage these images?
-
Currently, only a user with the upload_files capability can use this option.
Editors and Admins can upload and edit files.
Authors can only upload files.
Subscribers and Contributors cannot do either so an Admin will need to do this for them. -
I installed the plugin but I want to customize the output and placement of the image. Is this possible?
-
Yes, you can still customize the output by using the get_cupp_meta() function. Please reference the code snippet below or on the Description tab.
Where the $user_ID is the users ID number and the size is a registered image size like ‘thumbnail’ or an array like
array(50,50).
Reviews
Contributors & Developers
“Custom User Profile Photo” is open source software. The following people have contributed to this plugin.
Contributors
“Custom User Profile Photo” has been translated into 1 locale. Thank you to the translators for their contributions.
Translate “Custom User Profile Photo” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.5.3
- Addressed an issue where an object being passed into
cupp_get_user_by_id_or_emailcould potentially be the WP_Comment object.
0.5.2
- Fixed issue with a PHP warning when getting the user with the WP_User object.
0.5.1
- Fixed issue with
update_user_attribute.
0.5
- Major Update – please be sure to backup your site and db.
- Replaced
update_user_metawithupdate_user_attributeper WordPress VIP Standards. - Replaced
get_home_urlwithget_site_urlfor users where the edit image link was returning a 404. Credit: SOMTIJDS - Fixed textdomain loading issue.
- Added Spanish translation. Credit: David Pérez
- Updated and formatted code per PHPCS. Credit: jmichaelward
- Refactored multiple functions and variables for simplicity and compatibility. Credit: jmichaelward
0.4
- Major Update – please be sure to backup your site and db.
- The plugin now overrides the WordPress avatar by filtering the get_avatar() hook.
- The get_cupp_meta() function still exists and can be used to customize the output (this will eventually be deprecated).
0.3
- Changed the function which gets the attachment post ID by GUID to the WordPress core function attachment_url_to_postid() for better reliability. (Props to sqhendr).
0.2.7
- Added Hungarian Translation (Thanks to Harkály Gerg?)
0.2.6
- Fixed a bug where the save function required a different capability than the upload function (courtesy of douglas_johnson).
0.2.5
- Tested with WordPress v4.1
- Fixed a bug where the external URL option would not return the URL with get_cupp_meta().
- Fixed a bug where the saved image did not correspond to the selected radio button.
- Replaced depricated update_usermeta with update_user_meta.
- Improved image selection functionality.
- Images now show immediately after selecting an uploaded item or entering an external URL.
- Added Dutch translation – Thanks Olaf Lederer
0.2.4
- Tested with WordPress v3.8
- Updated description text. Better explanation of how to quickly use this plugin.
0.2.3
- Beta version release.