Simple Local Avatars

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!

1. Stores avatars in the “uploads” folder where all of your other media is kept.
2. Has a simple, native interface.
3. Fully supports Gravatar and default avatars if no local avatar is set for the user – but also allows you turn off Gravatar.
4. Generates the requested avatar size on demand (and stores the new size for efficiency), so it looks great, just like Gravatar!
5. Lets you decide whether lower privilege users (subscribers, contributors) can upload their own avatar.
6. Enables rating of local avatars, just like Gravatar.

[2.7.5] – 2023-05-12

• 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 webpack from 5.75.0 to 5.76.1 (props @dependabot, @faisal-alvi via #207).

2.7.4 – 2023-02-23

• Fixed: Support passing WP_User to get_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-git from 3.15.1 to 3.16.0 (props @dependabot, @faisal-alvi via #191).
• Security: Bump http-cache-semantics from 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_limit to 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_ratings as it’s not required anymore (props @dkotter, @lllopo, @faisal-alvi, @jeffpaul via #175).
• Security: Bump json5 from 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 zip GitHub Action (props @peterwilsoncc, @faisal-alvi via #168).
• Changed: Set plugin defaults on wp_initialize_site instead of deprecated action wpmu_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/env from 4.9.0 to 5.2.0 and got from 10.7.0 to 11.8.5 (props @dependabot, @faisal-alvi via #153).
• Security: Bump loader-utils from 2.0.2 to 2.0.3 (props @dependabot, @faisal-alvi via #160).
• Security: Bump loader-utils from 2.0.3 to 2.0.4 (props @dependabot, @peterwilsoncc via #162).
• Security: Bump simple-git from 3.9.0 to 3.15.1 (props @dependabot via #176).

2.6.0 – 2022-09-13

Note that this release bumps the minimum required version of WordPress from 4.6 to 5.7 and PHP from 5.6 to 7.4.

• Added: If a default avatar image is used, ensure that outputs alt text. This will either be default text (Avatar photo) or the alt text from the uploaded default image (props @dkotter, @faisal-alvi via #147)
• Added: Two hooks, simple_local_avatar_updated and simple_local_avatar_deleted, (props @t-lock, @faisal-alvi, @dkotter via #149)
• Changed: Bump minimum required version of WordPress from 4.6 to 5.7 (props @vikrampm1, @faisal-alvi, @cadic via #143).
• Changed: Bump minimum required version of PHP from 5.6 to 7.4 (props @vikrampm1, @faisal-alvi, @cadic via #143).
• Changed:The plugin is now available via Composer without any additional steps required (props @faisal-alvi, @kovshenin, @jeffpaul via #145)
• Security: Bump terser from 5.14.1 to 5.14.2 (props @dependabot, @faisal-alvi via #142)

2.5.0 – 2022-06-24

• Added: Skip cropping button (props @dkotter, @faisal-alvi, @cadic, @jeffpaul, @dinhtungdu via #130)!
• Added: Updated the button name from “Skip Crop” to “Default Crop” only on the edit profile page (props @faisal-alvi, @peterwilsoncc via #136).
• Added: If an image used for a local avatar has alt text assigned, ensure that alt text is used when rendering the image (props @dkotter, @pixelloop, @faisal-alvi via #127).
• Added: Support for bbPress by loading the JS at FE on the profile edit page (props @foliovision, @faisal-alvi, @iamdharmesh via #134).
• Added: Cypress E2E tests (props @faisal-alvi, @vikrampm1, @Sidsector9 via #115).
• Fixed: Broken avatar URLs for network-configured shared avatars with non-standard thumbnail sizes (props @vladolaru, @faisal-alvi via #125).
• Fixed: HTTP_REFERER is null and causing PHP warning (props @alireza-salehi, @faisal-alvi, @peterwilsoncc via #129).

2.4.0 – 2022-05-10

• Added: Ability to set a default avatar. (props @mehulkaklotar, @jeffpaul, @dinhtungdu, @faisal-alvi via #96).
• Fixed: Correct plugin name in changelog. (props @grappler, @jeffpaul via #117).
• Fixed: Avatar cache not being cleared. (props @thefrosty, @jeffpaul, @faisal-alvi, @peterwilsoncc via #118 & #120).
• Security: Dev dependency @wordpress/scripts upgraded to resolve deeper level dependency security issues. (props @jeffpaul, @faisal-alvi, @cadic via #119).

2.3.0 – 2022-04-25

• Added: Crop screen (props @jeffpaul, @helen, @ajmaurya99, @Antonio-Laguna, @faisal-alvi).
• Added: Avatar preview for Subscribers (props @ankitguptaindia, @dinhtungdu, @dkotter).
• Added: More robust multisite support and shared avatar setting (props @adamsilverstein, @helen, @jeffpaul, @dkotter, @faisal-alvi, @holle75).
• Added: Settings link to plugin action links (props @rahulsprajapati, @jeffpaul, @iamdharmesh).
• Added: Dashboard setting and WP-CLI command to migrate avatars from WP User Avatar (props @jeffpaul, @claytoncollie, @helen, @faisal-alvi).
• Added: Option to clear cache of user meta to remove image sizes that do not exist (props @jeffpaul, @ituk, @dinhtungdu, @sparkbold, @thrijith).
• Added: Package file (props @faisal-alvi, @jeffpaul, @claytoncollie, @cadic).
• Added: PHP Unit Tests (props @faisal-alvi, @iamdharmesh).
• Added: “No Response” GitHub Action (props @jeffpaul).
• Changed: Bump WordPress “tested up to” version to 5.9 (props @jeffpaul, @ankitguptaindia, @dinhtungdu, @phpbits).
• Changed: Bump WordPress “tested up to” version to 6.0 (props @ajmaurya99 via #110).
• Changed: Format admin script (props @thrijith, @dinhtungdu).
• Fixed: Media ID as string in REST API (props @diodoe, @dinhtungdu, @dkotter).
• Fixed: Avatar rating text is not translated properly if a user has a custom language Set (props @ActuallyConnor, @faisal-alvi).
• Security: PHP 8 compatibility (props @faisal-alvi, @dkotter, @Sidsector9).
• Security: Bump rmccue/requests from 1.7.0 to 1.8.0 (props dependabot@).
• Security: Bump nanoid from 3.1.28 to 3.2.0 (props dependabot@).
• Security: Bump minimist from 1.2.5 to 1.2.6 (props dependabot@).

2.2.0 – 2020-10-27

• Added: $args parameter to get_simple_local_avatar function (props @dinhtungdu, @heyjones, @dkotter, @sumnercreations, @dshanske).
• Added: Simple_Local_Avatars::get_avatar_data(), Simple_Local_Avatars::get_simple_local_avatar_url(), and Simple_Local_Avatars::get_default_avatar_url() methods (props @dinhtungdu, @heyjones, @dkotter, @sumnercreations, @dshanske).
• Added: Ability to retrieve avatar with WP_Post object (props @oscarssanchez, @blobaugh).
• Added: class and ID to Avatar section on Profile Page to allow easier styling (props @dinhtungdu).
• Added: WP Acceptance test coverage (props @dinhtungdu).
• Changed: Switched to pre_get_avatar_data filter (props @dinhtungdu, @heyjones, @dkotter, @sumnercreations, @dshanske).
• Changed: assign_new_user_avatar function to public (props @tripflex).
• Changed: Split the main class into its own file, added unit tests, and set up testing GitHub action (props @dinhtungdu, @helen, @stevegrunwell).
• Changed: New plugin banner and icon (props @JackieKjome).
• Changed: Bump WordPress version “tested up to” 5.5 (props @Waka867, @tmoorewp, @jeffpaul, @dinhtungdu).
• Changed: GitHub Actions from HCL to YAML workflow syntax (props @jeffpaul).
• Changed: Documentation updates (props @jeffpaul).
• Fixed: Initialize Simple_Local_Avatars on the $simple_local_avatars global, enabling bundling plugin with composer (props @pauldewouters, @adamsilverstein).
• Removed: get_avatar function that overrides the core function (props @dinhtungdu, @heyjones, @dkotter, @sumnercreations, @dshanske).

2.1.1 – 2019-05-07

• Fixed: Do not delete avatars just because they don’t exist on the local filesystem. This was occasionally dumping avatars when WordPress uploads were stored elsewhere, e.g. a cloud service.

2.1 – 2018-10-24

• New: All avatar uploads now go into the media library. Don’t worry – users without the ability to upload files cannot otherwise see the contents of your media library. This allows local avatars to respect other functionality your site may have around uploaded images, such as external hosting.
• New: REST API support for getting and updating.
• New: Use .org language packs rather than bundling translations.
• Fixed: Avoid an ArgumentCountError.
• Fixed: A couple of internationalization issues.

2.0 – 2013-06-02

• Choose or upload an avatar from the media library (for users with appropriate capabilities)!
• Local avatars are rated for appropriateness, just like Gravatar
• A new setting under Discussion enables administrators to turn off Gravatar (only use local avatars)
• Delete the local avatar with a single button click (like everywhere else in WordPress)
• Uploaded avatar file names are appended with the timestamp, addressing browser image caching issues
• New developer filter for preventing automatic rescaling: simple_local_avatars_dynamic_resize
• New developer filter for limiting upload size: simple_local_avatars_upload_limit
• Upgraded functions deprecated since WordPress 3.5
• Fixed translations not working on front end (although translations are now a bit out of date…)
• Hungarian translation added (needs further updating again with new version)
• Assorted refactoring / improvements under the hood

1.3.1 – 2011-12-29

• Brazilian Portuguese and Belarusian translations
• Bug fixes (most notably correct naming of image files based on user display name)
• Optimization for WordPress 3.2 / 3.3 (substitutes deprecated function)

1.3 – 2011-09-22

• Avatar file name saved as “user-display-name_avatar” (or other image extension)
• Russian localization added
• Assorted minor code optimizations

1.2.4 – 2011-07-02

• Support for front end avatar uploads (e.g. Theme My Profile)

1.2.3 – 2011-04-04

• Russian localization

1.2.2 – 2011-03-25

• Fix for avatars uploaded pre-1.2.1 having a broken path after upgrade

1.2.1 – 2011-01-26

• French localization
• Simplify uninstall code

1.2 – 2011-01-26

• Fix path issues on some IIS servers (resulting in missing avatar images)
• Fix rare uninstall issues related to deleted avatars
• Spanish localization
• Other minor under the hood optimizations

1.1.3 – 2011-01-20

• Properly deletes old avatars upon changing avatar
• Fixes “foreach” warning in debug mode when updating avatar image

1.1.2 – 2011-01-18

• Norwegian localization

1.1.1 – 2011-01-18

• Italian localization

1.1 – 2011-01-18

• All users (regardless of capabilities) can upload avatars by default. To limit avatar uploading to users with upload files capabilities (Authors and above), check the applicable option under Settings > Discussion. This was the default behavior in 1.0.
• Localization support; German included

1.0 – 2011-01-18

• Initial release.