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/1xn/wp-avatar-filter/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
wp-avatar-filter
Overview
The wp-avatar-filter plugin for WordPress enables automatic user avatar assignment based on uploaded images. By simply uploading a file named username.jpg, the plugin dynamically sets it as the avatar for that user, eliminating the need for manual avatar selection.
This is particularly useful for bulk user creation, allowing administrators to quickly assign profile pictures via the WordPress media library.
Features
- Automatically assigns user avatars by matching images to usernames (e.g., johnsmith.jpg for user johnsmith).
- No manual avatar selection required—just upload the correctly named image.
- Works dynamically: updating an avatar is as simple as deleting an old image and uploading a new one.
- Tested with over 200 users for bulk assignment.
Installation
Download & Setup
1. Download the .zip file.
2. Edit the .php file inside the plugin folder and replace example.com with your own WordPress site URL.
3. Re-compress the edited plugin folder into a .zip file.
4. Upload the .zip file via the WordPress admin panel (Plugins Add New Upload Plugin).
5. Activate the wp-avatar-filter plugin.
6. Ensure that in WordPress Settings Media, the option "Or