Description
Adds an avatar upload field to user profiles if the current user has media permissions. Generates requested sizes on demand just like Gravatar! Simple and lightweight.
Just edit a user profile, and scroll down to the new “Avatar” field. The plug-in will take care of cropping and sizing!
- Stores avatars in the “uploads” folder where all of your other media is kept.
- Has a simple, native interface.
- Fully supports Gravatar and default avatars if no local avatar is set for the user – but also allows you turn off Gravatar.
- Generates the requested avatar size on demand (and stores the new size for efficiency), so it looks great, just like Gravatar!
- Lets you decide whether lower privilege users (subscribers, contributors) can upload their own avatar.
- Enables rating of local avatars, just like Gravatar.
Screenshots
Avatar upload field on a user profile page
Installation
- Install easily with the WordPress plugin control panel or manually download the plugin and upload the extracted folder to the
/wp-content/plugins/directory - Activate the plugin through the ‘Plugins’ menu in WordPress
- If you only want users with file upload capabilities to upload avatars, check the applicable option under Settings > Discussion
- Start uploading avatars by editing user profiles!
Use avatars in your theme using WordPress’ built in get_avatar() function: https://codex.wordpress.org/Function_Reference/get_avatar
You can also use get_simple_local_avatar() (with the same arguments) to retrieve local avatars a bit faster, but this will make your theme dependent on this plug-in.
FAQ
-
Does Simple Local Avatars collect personal data of website visitors?
-
No. Simple Local Avatars neither collects, stores, nor sends any PII data of visitors or avatar users on the host site or to 10up or other services.
Reviews
July 7, 2024
I just realized that the avatars are looking good on the front end webpage, although not in the back end, like in the upper right side of the page after login or in the wordpress/users/username/avatar settings, image looks url broken. I hope you can understand what I’m trying to say, and hopefully check on that, other than that great plugin!
July 1, 2024
1 reply
This plugin sounded like just what I wanted: a simple solution for a minimalist blog site. Unfortunately, it just plain didn’t work. No avatar ever appeared anywhere, although it did upload images to my Media Library. I tried for support through WordPress.org and got what looked like a quick, comprehensive response, which asked a few more questions and didn’t actually help me otherwise. I answered the questions over a week ago. Now I’m joining others who didn’t actually get support and complained about it not working. This plugin is a good idea and may have once worked, but from my perspective all it did was burn my time and patience and ultimately fail me. Definitely not recommended.
May 14, 2024
4 replies
Until this latest version, I considered this a 5 star plug-in. Unfortunately the version 2.7.8 broke everything. None of the avatars were showing on my blog comments after the plug-in updated. When I deactivate the plug-in, they show up again. I admit that I’m not a software expert, I merely use software to bring the desired result. I’ll keep the plug-in disabled, and hope that when it’s upgraded again, it begins working for me as it did before.
Edit: a newer version, 2.7.9, has just been released to address this issue. I’ve installed it, and the avatars are back. This was a speedy and satisfying response to the problem. I’ve upgraded my initial review here from one to five stars as this plug-in has been perfect beyond this now-fixed hiccup. Thanks!
May 12, 2024
3 replies
Since the latest update, the avatar only gives Identicon-style avatars and the same one for all users. My settings for users are to use a generic avatar if a Gravatar isn’t associated with the email address. If I had a Gravatar avatar and a had different one uploaded from the Image Library, both could be displayed but this update replaces both with a generic Idention avatar. I have checked my Gravatar account and my avatars are all still active there–they just don’t show up when this updated plugin is installed. I deleted the plugin from another WordPress site I have and the Gravatar returned. I reported that it stopped working in the support forum and nothing has been done to fix it. Disappointed because it used to allow the option to use different avatars from the one registered for the email address. Now just the same generic one shows for everyone even if they have a registered Gravatar.
December 28, 2023
1 reply
This plugin does well in extending WordPress’ Avatar capabilities.
December 16, 2023
I like that it allows gravatar to continue to be used. If you set the local only option however all your existing avatars will be reset to the same avatar. People get used to their own avatars and these shouldn’t change, they should be copied locally from gravatar when the option is set if local copies don’t already exist. Croping also fails. Looks like I need to look for another plugin as this is no longer under development.
Contributors & Developers
“Simple Local Avatars” is open source software. The following people have contributed to this plugin.
Contributors
“Simple Local Avatars” has been translated into 20 locales. Thank you to the translators for their contributions.
Translate “Simple Local Avatars” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
2.7.10 – 2024-05-23
- Fixed: Fix Default Avatar Fallback (props @amirhossein7, @faisal-alvi, @dkotter, @qasumitbagthariya via #281).
- Security: Bump
expressfrom 4.18.2 to 4.19.2 (props @dependabot, @faisal-alvi via #269). - Security: Bump
follow-redirectsfrom 1.15.5 to 1.15.6 (props @dependabot, @faisal-alvi via #269). - Security: Bump
ipfrom 1.1.8 to 1.1.9 (props @dependabot, @faisal-alvi via #269). - Security: Bump
webpack-dev-middlewarefrom 5.3.3 to 5.3.4 (props @dependabot, @faisal-alvi via #269).
2.7.9 – 2024-05-14
- Fixed: Ensure default Gravatar avatars are shown correctly (props @faisal-alvi, @dkotter, @horrormoviesgr, @inpeaks, @lillylark, @rafaucau, @janrenn via #278).
2.7.8 – 2024-05-08
Note that this release bumps the minimum required version of WordPress from 5.7 to 6.3.
- Added: “Testing” section in the
CONTRIBUTING.mdfile (props @kmgalanakis, @jeffpaul via #274). - Changed: Bumped WordPress “tested up to” version 6.5 (props @sudip-md, @dkotter, @jeffpaul via #270).
- Changed: Move
simple_local_avatar_deletedaction toavatar_delete(props @lllopo, @faisal-alvi, @dkotter via #255). - Changed: Clean up NPM dependencies and update node to
v20(props @Sidsector9, @dkotter via #257). - Changed: Update
CODEOWNERSof the plugin (props @jeffpaul, @dkotter via #253). - Changed: Disabled auto sync pull requests with target branch (props @iamdharmesh, @jeffpaul via #263).
- Changed: Upgrade
download-artifactfrom v3 to v4 (props @iamdharmesh, @jeffpaul via #265). - Changed: Replaced
lee-dohm/no-responsewithactions/staleto help with closingno-response/staleissues (props @jeffpaul, @dkotter via #266). - Fixed: Broken default avatar when
Local Avatars Onlyis unchecked (props @faisal-alvi, @ankitguptaindia, @qasumitbagthariya via #260). - Fixed: Ensure high-quality avatar preview on profile edit screen (props @ocean90, @dkotter via #273).
- Fixed: Possible PHP warning (props @BhargavBhandari90, @dkotter via #261).
- Fixed: Fixed typos (props @szepeviktor, @dkotter via #268).
2.7.7 – 2023-12-13
- Fixed: Revert the Host/Domain support for local avatar URL (props @faisal-alvi, @jakejackson1, @leogermani, @dkotter via #247).
- Security: Bump
axiosfrom 0.25.0 to 1.6.2 and@wordpress/scriptsfrom 23.7.2 to 26.18.0 (props @dependabot, @faisal-alvi via #250).
2.7.6 – 2023-11-30
- Added: Check for minimum required PHP version before loading the plugin (props @kmgalanakis, @faisal-alvi via #226).
- Added:
pre_simple_local_avatar_urlfilter to allow an avatar image to be short-circuited before Simple Local Avatars processes it (props @johnbillion, @peterwilsoncc via #237). - Added: Repo Automator GitHub Action (props @iamdharmesh, @faisal-alvi via #228).
- Added: E2E test for checking the front end of avatars (props @Firestorm980, @iamdharmesh via #219).
- Changed: Bumped WordPress “tested up to” version 6.4 (props @zamanq, @ankitguptaindia, @faisal-alvi, @qasumitbagthariya via #230, #244).
- Changed: Update the Dependency Review GitHub Action to leverage our org-wide config file to check for GPL-compatible licenses (props @jeffpaul, @faisal-alvi via #215).
- Changed: Documentation updates (props @jeffpaul, @faisal-alvi via #242).
- Fixed: Address conflicts with other plugins and loading the media API (props @EHLOVader, @dkotter via #218).
- Fixed: Prevent PHP fatal error when switching from a multisite to single site installation (props @ocean90, @ravinderk, @faisal-alvi via #222).
- Fixed: Local avatar urls remain old after domain/host change (props @jayedul, @ravinderk, @jeffpaul, @faisal-alvi via #216).
- Security: Bump
word-wrapfrom 1.2.3 to 1.2.4 (props @dependabot, @faisal-alvi via #223). - Security: Bump
tough-cookiefrom 4.1.2 to 4.1.3 (props @dependabot, @faisal-alvi via #225). - Security: Bump
@cypress/requestfrom 2.88.10 to 3.0.0 (props @dependabot, @faisal-alvi via #225, #234). - Security: Bump
cypressfrom 11.2.0 to 13.2.0 (props @dependabot, @faisal-alvi, @iamdharmesh via #234, #236). - Security: Bump
postcssfrom 8.4.21 to 8.4.31 (props @dependabot, @faisal-alvi via #238). - Security: Bump
@babel/traversefrom 7.20.12 to 7.23.2 (props @dependabot, @faisal-alvi via #240). - Security: Bump
@10up/cypress-wp-utilsversion to 0.2.0 (props @iamdharmesh, @faisal-alvi via #236). - Security: Bump
@wordpress/envversion from 5.2.0 to 8.7.0 (props @iamdharmesh, @faisal-alvi via #236). - Security: Bump
cypress-mochawesome-reporterversion from 3.0.1 to 3.6.0 (props @iamdharmesh, @faisal-alvi via #236).
2.7.5 – 2023-05-15
- Added: Ajax loading animation during process of uploading and deleting local avatars (props @lllopo, @BhargavBhandari90, @faisal-alvi via #204).
- Changed: Avatar removal button text (props @jayedul, @jeffpaul, @dkotter, @faisal-alvi via #208).
- Changed: WordPress “tested up to” version 6.2 (props @jayedul, @faisal-alvi via #210).
- Changed: Run E2E tests on the zip generated by “Build release zip” action (props @jayedul, @iamdharmesh, @faisal-alvi via #205).
- Security: Bump
webpackfrom 5.75.0 to 5.76.1 (props @dependabot, @faisal-alvi via #207).
2.7.4 – 2023-02-23
- Fixed: Support passing
WP_Usertoget_avatar()(props @mattheu, @faisal-alvi via #193). - Fixed: Remove trailing commas in function calls (props @patrixer, @dkotter, @sekra24, @faisal-alvi via #196).
- Security: Bump
simple-gitfrom 3.15.1 to 3.16.0 (props @dependabot, @faisal-alvi via #191). - Security: Bump
http-cache-semanticsfrom 4.1.0 to 4.1.1 (props @dependabot, @faisal-alvi via #197).
2.7.3 – 2023-01-16
- Fixed: Issue causing fatal errors when avatars used on front end of site (props @Rottinator, @peterwilsoncc, @ravinderk, @faisal-alvi via #187).
- Fixed: Deprecation error in admin on PHP 8.0 and later (props @Rottinator, @peterwilsoncc, @ravinderk, @faisal-alvi via #187).
2.7.2 – 2023-01-13
- Added: Filter hook
simple_local_avatars_upload_limitto restrict image upload size & image file checking enhanced (props @Shirkit, @jayedul, @faisal-alvi, @jeffpaul via #171). - Added: GitHub Actions summary on Cypress e2e test runs (props @faisal-alvi, @jeffpaul, @iamdharmesh via #174).
- Changed: Cypress integration migrated from 9.5.4 to 11.2.0 (props @iamdharmesh, @jayedul, @faisal-alvi via #172).
- Fixed: PHP8 support for
assign_new_user_avatar(props @lllopo, @mattwatsoncodes, @faisal-alvi via #183). - Fixed: Fixed the user profile language not respected issue (props @dkotter, @lllopo, @faisal-alvi, @jeffpaul via #175).
- Removed: textdomain from the core strings and the function
update_avatar_ratingsas it’s not required anymore (props @dkotter, @lllopo, @faisal-alvi, @jeffpaul via #175). - Security: Bump
json5from 1.0.1 to 1.0.2 (props @dependabot, @faisal-alvi via #182).
2.7.1 – 2022-12-08
- Added: Added missing files from the last release and changed the readme file to fix the bullet points and added fullstops.
2.7.0 – 2022-12-08
- Added: Added
Build release zipGitHub Action (props @peterwilsoncc, @faisal-alvi via #168). - Changed: Set plugin defaults on
wp_initialize_siteinstead of deprecated actionwpmu_new_blog(props @kadamwhite, @faisal-alvi via #156). - Changed: Support Level from Active to Stable (props @jeffpaul, @dkotter via #159).
- Changed: Build tools: Allow PHPCS installer plugin to run without prompting user (props @peterwilsoncc, @jeffpaul via #164).
- Changed: WP tested up to version bump to 6.1 (props @peterwilsoncc, @faisal-alvi via #165).
- Fixed: Non admin users can not crop avatar (props @jayedul, @faisal-alvi, @zamanq, @dkotter, @jeffpaul via #155).
- Security: Bump
@wordpress/envfrom 4.9.0 to 5.2.0 andgotfrom 10.7.0 to 11.8.5 (props @dependabot, @faisal-alvi via #153). - Security: Bump
loader-utilsfrom 2.0.2 to 2.0.3 (props @dependabot, @faisal-alvi via #160). - Security: Bump
loader-utilsfrom 2.0.3 to 2.0.4 (props @dependabot, @peterwilsoncc via #162). - Security: Bump
simple-gitfrom 3.9.0 to 3.15.1 (props @dependabot via #176).