Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/robertandrews/cwp-user-avatar-acf/archive/refs/heads/master.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Context WP User ACF Avatar
Description
📸 Use ACF field instead of Gravatar for user avatar.
🗄 Neatly store those images in a dedicated folder, with a matching filename.
Gravatar replacement
This plugin allows site owners to let their users utilise an uploaded image as a profile avatar, instead of WordPress' default Gravatar.
Image organisation
The uploaded images are added to the Media Library, as is normal for ACF Image uploads. There, they demand better organisation. So, the plugin performs two tasks:
1. Renames the upload file from the original to match the user's username (ie. for "John Doe", file "My photo (1).jpg" becomes "johndoe.jpg").
2. Moves this image out of the main uploads folder, into a dedicated avatars sub-directory of your choosing.
Together, these can reduce the size of the Media Library, and allow the site owner to manage user avatars more easily.
Setup
Gravatar bypass
You first need to add an Advanced Custom Fields Image field to the Edit User admin page (user-edit.php).
Create an ACF field group containing, at the least, a field of type Image.
In the