10up/simple-local-avatars
Stars: 173
Forks: 38
Pull Requests: 143
Issues: 93
Watchers: 57
Last Updated: 2023-09-14 09:29:56
Adds an avatar upload field to user profiles. Generates requested sizes on demand just like Gravatar!
License: GNU General Public License v2.0
Languages: JavaScript, PHP, Shell
Simple Local Avatars
Adds an avatar upload field to user profiles. Generates requested sizes on demand just like Gravatar!
Features
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
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: http://codex.wordpress.org/Function_Reference/get_avatar
You can also use get_simple_local_avatar() (with the same arguments) to retreive local avatars a bit faster, but this will make your theme dependent on this plug-in.
Support Level
Stable: 10up is not planning to develop any new features for this, but will still respond to bug reports and security concerns. We welcome PRs, but any that include new features should be small and easy to integrate and should not include breaking changes. We otherwise intend to keep this tested up to the most recent version of WordPress.
Contributing
Please read CODE_OF_CONDUCT.md for details on our code of conduct and CONTRIBUTING.md for details on the process for submitting pull requests to us.
Like what you see?
OPEN ISSUES
See all- Option to prevent media deletion by @jeffpaul
- Apply a proper maximum file size restriction by @Shirkit
- Avatar support when moving hosts / changing domains by @jeffpaul
- Crop area does not appear sometimes. by @faisal-alvi
- The plugin does not respect the user profile language setting in the backend by @lllopo
- Migrate to Cypress 11 by @iamdharmesh
- 'assign_new_user_avatar' exception when passing url as $url_or_media_id with php 8 by @lllopo
- Add a Cypress test to insure Avatars loaded at FE without errors by @faisal-alvi
- Export/Import Data (feature request) by @aharonium
- Adding customer upload avatars to woocommerce My-Account page. by @ImaEternal
- Move 'simple_local_avatar_deleted' action in 'avatar_delete' by @lllopo
- PHP warnings due to wrong param type by @dkotter
- The default avatar is displayed as a broken for all users when the custom image option is selected. by @ankitguptaindia
- Avatar getting updated without updating the settings/profile data. by @ankitguptaindia
- Missing Check for File Type Before Uploading Media for Avatar by @ankitguptaindia