WP Manifestindependent plugin directory
manifest / users / cc-custom-avatar

CC Custom Avatar

This plugin allows users to set custom avatars, replacing the default WordPress avatar.

by Chance Lin · github.com/cclintw/cc-custom-avatar

★ 0stars

Install

Download source zip No release zip yet

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/cclintw/cc-custom-avatar/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/cclintw/cc-custom-avatar ↗

CC Custom Avatar is a lightweight WordPress plugin that lets users choose custom profile images from the WordPress Media Library.

It is designed for sites that prefer local custom avatars and do not want to rely only on external avatar services.

Features

  • Adds a custom avatar field to WordPress user profile screens
  • Uses the WordPress Media Library image picker
  • Generates local 50x50 and 300x300 avatar files
  • Uses AVIF or WebP output when supported by the server image editor
  • Falls back to WordPress's default mystery avatar
  • Stores generated avatars under /wp-content/uploads/cc-custom-avatar/
  • Nonce-protected profile save action
  • Translation ready with the cc-custom-avatar text domain

Installation

  1. Upload the plugin folder cc-custom-avatar to /wp-content/plugins/
  2. Activate the plugin in WordPress admin
  3. Go to Users > Profile
  4. Choose an avatar image from the WordPress Media Library

Notes

  • Generated avatar files are stored in the WordPress uploads directory
  • Removing a custom avatar deletes the generated avatar files
  • The original selected media item remains in the Media Library
  • This version replaces avatars only on WordPress admin user screens

Changelog

2.2

  • Store generated avatar files in the WordPress uploads directory
  • Add nonce validation and sanitized profile save handling
  • Improve i18n readiness and WordPress.org compliance
  • Clean plugin package files