Custom Profile Picture – Replace Gravatar with Your Own Images vs One User Avatar | User Profile Picture

Custom Profile Picture is the easiest way to replace WordPress default Gravatar avatars with custom profile pictures. Upload images directly or choose from your media library – managing user avatars has never been this simple! 🚀 Why Choose Custom Profile Picture? Tired of relying on Gravatar for user avatars? Want complete control over your site’s user profile pictures? This plugin gives you the freedom to upload custom profile pictures without depending on external services. ✨ Key Features 📸 Dual Upload Methods * Upload images directly from your device * Choose from WordPress Media Library * Both methods available on individual user profiles 🌐 Frontend Shortcode * Add [custom_profile_picture] to any page or post * Logged-in users can upload, crop, and remove their own picture directly on the frontend * Interactive crop tool — no page reload required * Works without giving users access to the admin area ⚡ Centralized Management Dashboard * Manage ALL user profile pictures from one page * Beautiful grid view of all users * Hover to change or remove pictures instantly * AJAX-powered updates – no page refresh needed * Search users by name, email, or username * Pagination for sites with many users 🎨 Professional Image Cropping * Built-in interactive cropping tool * Real-time crop preview * Maintains perfect square aspect ratio * Mobile-friendly interface 🔒 Security First * Proper nonce verification * Capability checks for user permissions * Secure AJAX handling * Sanitized and validated inputs 📱 Fully Responsive * Works perfectly on desktop, tablet, and mobile * Touch-friendly controls * Responsive admin interface ⚙️ Developer Friendly * Clean, object-oriented code * Proper WordPress coding standards * Namespaced classes * Well-documented code * Extensible architecture 💡 Perfect For Community websites Membership sites Corporate intranets Educational platforms Any site wanting custom user avatars Sites not wanting to depend on Gravatar 🎯 How It Works Method 1: Individual User Profiles 1. Go to Users → Your Profile (or edit any user) 2. Scroll to “Profile Picture” section 3. Click “Choose from Media Library” OR upload directly 4. Image automatically replaces Gravatar everywhere Method 2: Bulk Management (Admin) 1. Go to “Profile Pictures” in admin menu 2. See all users in a beautiful grid layout 3. Hover over any user’s avatar 4. Click “Change” to select from media library 5. Click “Remove” to revert to Gravatar 🌟 What Makes This Plugin Special? Unlike other avatar plugins, Custom Profile Picture offers: * No configuration needed – works out of the box * Dual interface – individual and bulk management * Media library integration – use existing images * Beautiful UX – modern, intuitive design * Lightweight – no bloat, just what you need * 100% WordPress compatible – uses standard avatar system 🔧 Technical Details Integrates seamlessly with WordPress avatar system Works with get_avatar() function Replaces avatars site-wide automatically Stores images in WordPress media library Clean database structure with user meta No external dependencies (except Cropper.js for cropping) 📚 Documentation & Support Need help? Check out our: * Documentation * Support Forum Shortcodes [custom_profile_picture] Place this shortcode on any page or post to give logged-in users a self-service profile picture uploader on the public-facing site. Features: * Displays the user’s current avatar (custom or Gravatar) * “Upload New Picture” triggers a built-in crop tool (square aspect ratio) * “Remove Picture” reverts the avatar back to Gravatar * AJAX-powered — no page reload needed * Guests or logged-out visitors see a prompt to sign in Example: [custom_profile_picture] You can place it inside any page, post, or widget area that supports shortcodes. Additional Information Credits Cropper.js library for image manipulation WordPress core team for the amazing platform Privacy Policy This plugin does not collect, store, or transmit any user data outside your WordPress installation. All images are stored in your WordPress media library. No external services are used. Custom Profile Picture – Replace Gravatar with Your Own Images uses Appsero SDK to collect some telemetry data upon user’s confirmation. This helps us to troubleshoot problems faster & make product improvements. Appsero SDK does not gather any data by default. The SDK only starts gathering basic telemetry data when a user allows it via the admin notice. We collect the data to ensure a great user experience for all our users. Integrating Appsero SDK DOES NOT IMMEDIATELY start gathering data, without confirmation from users in any case. Learn more about how Appsero collects and uses this data. Want to Contribute? We welcome contributions! Visit our GitHub repository to report issues or submit pull requests. Love This Plugin? Leave a review – it helps others find this plugin! Donate – support continued development For Developers Custom Profile Picture is built with: * Object-oriented PHP * WordPress coding standards * Proper namespacing (Ifatwp\CustomProfilePicture) * Action and filter hooks * AJAX for dynamic updates * WordPress Media Library API * Clean, documented code Filters available: * Custom hooks coming in future versions For questions, customizations, or feature requests, please visit the support forum.`

WordPress currently only allows you to use custom avatars that are uploaded through Gravatar. One User Avatar enables you to use any photo uploaded into your Media Library as an avatar. This means you use the same uploader and library as your posts. No extra folders or image editing functions are necessary. This plugin is a fork of WP User Avatar v2.2.16. One User Avatar also lets you: Upload your own Default Avatar in your One User Avatar settings. Show the user’s Gravatar avatar or Default Avatar if the user doesn’t have a One User Avatar image. Disable Gravatar avatars and use only local avatars. Use the [avatar_upload] shortcode to add a standalone uploader to a front page or widget. This uploader is only visible to logged-in users. Use the [avatar] shortcode in your posts. These shortcodes will work with any theme, whether it has avatar support or not. Allow Contributors and Subscribers to upload their own avatars. Limit upload file size and image dimensions for Contributors and Subscribers. Copyright One User Avatar Copyright (c) 2023 One Designs https://onedesigns.com/ License: GPLv2 Source: https://github.com/onedesigns/one-user-avatar One User Avatar is based on WP User Avatar v2.2.16 Copyright (c) 2020-2021 ProfilePress https://profilepress.net/ Copyright (c) 2014-2020 Flippercode https://www.flippercode.com/ Copyright (c) 2013-2014 Bangbay Siboliban http://bangbay.com/ License: GPLv2 Source: https://github.com/profilepress/wp-user-avatar One User Avatar is distributed under the terms of the GNU GPL This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. Advanced Settings Add One User Avatar to your own profile edit page You can use the [avatar_upload] shortcode to add a standalone uploader to any page. It’s best to use this uploader by itself and without other profile fields. If you’re building your own profile edit page with other fields, One User Avatar is automatically added to the show_user_profile and edit_user_profile hooks. If you’d rather have One User Avatar in its own section, you could add another hook: do_action( 'edit_user_avatar', $current_user ); Then, to add One User Avatar to that hook and remove it from the other hooks outside of the administration panel, you would add this code to the functions.php file of your theme: function my_avatar_filter() { // Remove from show_user_profile hook remove_action( 'show_user_profile', array( 'wp_user_avatar', 'wpua_action_show_user_profile' ) ); remove_action( 'show_user_profile', array( 'wp_user_avatar', 'wpua_media_upload_scripts' ) ); // Remove from edit_user_profile hook remove_action( 'edit_user_profile', array( 'wp_user_avatar', 'wpua_action_show_user_profile' ) ); remove_action( 'edit_user_profile', array( 'wp_user_avatar', 'wpua_media_upload_scripts' ) ); // Add to edit_user_avatar hook add_action( 'edit_user_avatar', array( 'wp_user_avatar', 'wpua_action_show_user_profile' ) ); add_action( 'edit_user_avatar', array( 'wp_user_avatar', 'wpua_media_upload_scripts' ) ); } // Loads only outside of administration panel if ( ! is_admin() ) { add_action( 'init','my_avatar_filter' ); } HTML Wrapper You can change the HTML wrapper of the One User Avatar section by using the functions wpua_before_avatar and wpua_after_avatar. By default, the avatar code is structured like this: Avatar Edit Image Original Size Thumbnail Default Avatar Undo To strip out the div container and h3 heading, you would add the following filters to the functions.php file in your theme: remove_action( 'wpua_before_avatar', 'wpua_do_before_avatar' ); remove_action( 'wpua_after_avatar', 'wpua_do_after_avatar' ); To add your own wrapper, you could create something like this: function my_before_avatar() { echo ' '; } add_action( 'wpua_before_avatar', 'my_before_avatar' ); function my_after_avatar() { echo ' '; } add_action( 'wpua_after_avatar', 'my_after_avatar' ); This would output: Edit Image Original Size Thumbnail Default Avatar Undo