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
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/cclintw/cc-custom-avatar/archive/refs/heads/main.zip

Readme

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

Read the full README on GitHub →