CRITICAL PERFORMANCE UPDATE! Fixes massive database query issues that caused slow page loads. Reduces queries by up to 90%. If you experienced performance problems with previous versions, this update is essential. Highly recommended for all users!<\/p>","1.0.2":"
Major update! New centralized admin page for managing all user profile pictures from one place. Upload from media library, search users, and manage avatars with beautiful UX. Highly recommended upgrade!<\/p>","1.0.1":"
Important security and usability improvements. Recommended upgrade for all users.<\/p>","1.0.0":"
Initial release with profile picture upload and cropping functionality.<\/p>"},"ratings":{"1":1,"2":0,"3":0,"4":0,"5":2},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3335047,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.gif":{"filename":"icon-256x256.gif","revision":3336659,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3335047,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3335047,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{"blueprint.json":{"filename":"blueprint.json","revision":3527168,"resolution":false,"location":"assets","locale":"","contents":"{\"landingPage\":\"\\\/wp-admin\\\/profile.php\",\"preferredVersions\":{\"wp\":\"latest\",\"php\":\"8.0\"},\"plugins\":[\"custom-profile-picture\"],\"steps\":[{\"step\":\"login\",\"username\":\"admin\"},{\"step\":\"installPlugin\",\"pluginData\":{\"resource\":\"wordpress.org\\\/plugins\",\"slug\":\"custom-profile-picture\"},\"options\":{\"activate\":true}}]}"}},"all_blocks":[],"tagged_versions":["1.0.1","1.0.2","1.0.3","1.0.4"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Centralized admin page showing all users in a beautiful grid layout","2":"Hover over avatars to reveal change\/remove buttons","3":"Individual user profile upload interface with media library option","4":"Interactive image cropping modal for perfect avatars","5":"Search and filter users easily","6":"Mobile-responsive interface"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[129,9280,127,7894,9246],"plugin_category":[44],"plugin_contributors":[225950],"plugin_business_model":[],"class_list":["post-226265","plugin","type-plugin","status-publish","hentry","plugin_tags-avatar","plugin_tags-custom-avatar","plugin_tags-gravatar","plugin_tags-profile-picture","plugin_tags-user-profile","plugin_category-discussion-and-community","plugin_contributors-ifatwp","plugin_committers-ifatwp"],"banners":{"banner":"https:\/\/ps.w.org\/custom-profile-picture\/assets\/banner-772x250.png?rev=3335047","banner_2x":"https:\/\/ps.w.org\/custom-profile-picture\/assets\/banner-1544x500.png?rev=3335047","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/custom-profile-picture\/assets\/icon-128x128.png?rev=3335047","icon_2x":"https:\/\/ps.w.org\/custom-profile-picture\/assets\/icon-256x256.gif?rev=3336659","generated":false},"screenshots":[],"raw_content":"\n
Custom Profile Picture<\/strong> is the easiest way to replace WordPress default Gravatar avatars with custom profile pictures. Upload images directly or choose from your media library \u2013 managing user avatars has never been this simple!<\/p>\n\n 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.<\/p>\n\n \ud83d\udcf8 Dual Upload Methods<\/strong>\n* Upload images directly from your device\n* Choose from WordPress Media Library\n* Both methods available on individual user profiles<\/p>\n\n \ud83c\udf10 Frontend Shortcode<\/strong>\n* Add \u26a1 Centralized Management Dashboard<\/strong>\n* Manage ALL user profile pictures from one page\n* Beautiful grid view of all users\n* Hover to change or remove pictures instantly\n* AJAX-powered updates \u2013 no page refresh needed\n* Search users by name, email, or username\n* Pagination for sites with many users<\/p>\n\n \ud83c\udfa8 Professional Image Cropping<\/strong>\n* Built-in interactive cropping tool\n* Real-time crop preview\n* Maintains perfect square aspect ratio\n* Mobile-friendly interface<\/p>\n\n \ud83d\udd12 Security First<\/strong>\n* Proper nonce verification\n* Capability checks for user permissions\n* Secure AJAX handling\n* Sanitized and validated inputs<\/p>\n\n \ud83d\udcf1 Fully Responsive<\/strong>\n* Works perfectly on desktop, tablet, and mobile\n* Touch-friendly controls\n* Responsive admin interface<\/p>\n\n \u2699\ufe0f Developer Friendly<\/strong>\n* Clean, object-oriented code\n* Proper WordPress coding standards\n* Namespaced classes\n* Well-documented code\n* Extensible architecture<\/p>\n\n Method 1: Individual User Profiles<\/strong>\n1. Go to Users \u2192 Your Profile (or edit any user)\n2. Scroll to \"Profile Picture\" section\n3. Click \"Choose from Media Library\" OR upload directly\n4. Image automatically replaces Gravatar everywhere<\/p>\n\n Method 2: Bulk Management (Admin)<\/strong>\n1. Go to \"Profile Pictures\" in admin menu\n2. See all users in a beautiful grid layout\n3. Hover over any user's avatar\n4. Click \"Change\" to select from media library\n5. Click \"Remove\" to revert to Gravatar<\/p>\n\n Unlike other avatar plugins, Custom Profile Picture offers:\n* No configuration needed<\/strong> \u2013 works out of the box\n* Dual interface<\/strong> \u2013 individual and bulk management\n* Media library integration<\/strong> \u2013 use existing images\n* Beautiful UX<\/strong> \u2013 modern, intuitive design\n* Lightweight<\/strong> \u2013 no bloat, just what you need\n* 100% WordPress compatible<\/strong> \u2013 uses standard avatar system<\/p>\n\n Need help? Check out our:\n* Documentation<\/a>\n* Support Forum<\/a><\/p>\n\n Place this shortcode on any page or post to give logged-in users a self-service profile picture uploader on the public-facing site.<\/p>\n\n Features:<\/strong>\n* Displays the user's current avatar (custom or Gravatar)\n* \"Upload New Picture\" triggers a built-in crop tool (square aspect ratio)\n* \"Remove Picture\" reverts the avatar back to Gravatar\n* AJAX-powered \u2014 no page reload needed\n* Guests or logged-out visitors see a prompt to sign in<\/p>\n\n Example:<\/strong><\/p>\n\n You can place it inside any page, post, or widget area that supports shortcodes.<\/p>\n\n 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.\nCustom Profile Picture \u2013 Replace Gravatar with Your Own Images uses Appsero<\/a> SDK to collect some telemetry data upon user's confirmation. This helps us to troubleshoot problems faster & make product improvements.<\/p>\n\n Appsero SDK does not gather any data by default.<\/strong> The SDK only starts gathering basic telemetry data when a user allows it via the admin notice<\/strong>. We collect the data to ensure a great user experience for all our users.<\/p>\n\n Integrating Appsero SDK DOES NOT IMMEDIATELY<\/strong> start gathering data, without confirmation from users in any case.<\/strong><\/p>\n\n Learn more about how Appsero collects and uses this data<\/a>.<\/p>\n\n We welcome contributions! Visit our GitHub repository<\/a> to report issues or submit pull requests.<\/p>\n\n Custom Profile Picture is built with:\n* Object-oriented PHP\n* WordPress coding standards\n* Proper namespacing (Ifatwp\\CustomProfilePicture)\n* Action and filter hooks\n* AJAX for dynamic updates\n* WordPress Media Library API\n* Clean, documented code<\/p>\n\n Filters available:\n* Custom hooks coming in future versions<\/p>\n\n For questions, customizations, or feature requests, please visit the support forum.`<\/p>\n\n\n For Individual Users (Admin):<\/strong>\n1. Navigate to Users \u2192 Your Profile\n2. Find \"Profile Picture\" section\n3. Upload or choose from media library\n4. Save changes<\/p>\n\n For Frontend Users via Shortcode:<\/strong>\n1. Add the For Administrators:<\/strong>\n1. Go to \"Profile Pictures\" in WordPress admin menu\n2. View all users in grid layout\n3. Hover over user avatars to manage\n4. Use search to find specific users<\/p>\n\n\n Yes! The plugin replaces Gravatar with custom images. If no custom image is uploaded, the default Gravatar will still show.<\/p><\/dd>\n All standard web formats: JPEG, JPG, PNG, and GIF.<\/p><\/dd>\n We recommend 150\u00d7150 pixels for optimal display across all devices.<\/p><\/dd>\n Yes! Users can upload their own pictures from their profile page. Admins can manage all user pictures from the centralized dashboard.<\/p><\/dd>\n No! The plugin is lightweight and only loads on relevant admin pages. Images are stored in WordPress media library using WordPress's own optimization.<\/p><\/dd>\n Yes! Use the \"Profile Pictures\" admin page to manage multiple users quickly from one interface.<\/p><\/dd>\n Yes, if they use WordPress's standard Absolutely! Just click the \"Remove\" button on the admin page or delete it from the user's profile page. The avatar will revert to Gravatar.<\/p><\/dd>\n Yes! All strings are translatable using WordPress's translation system.<\/p><\/dd>\n Yes! The plugin is multisite compatible.<\/p><\/dd>\n\n<\/dl>\n\n\n NEW:<\/strong> Dedicated frontend CSS ( FIXED:<\/strong> Massive database query optimization - eliminated expensive This update addresses user concerns about excessive database queries. If you experienced slow page loads with previous versions, this update will significantly improve performance.<\/p>\n\n Major Update \u2013 New Features & Improvements<\/strong><\/p>\n\n\ud83d\ude80 Why Choose Custom Profile Picture?<\/h4>\n\n
\u2728 Key Features<\/h4>\n\n
[custom_profile_picture]<\/code> to any page or post\n* Logged-in users can upload, crop, and remove their own picture directly on the frontend\n* Interactive crop tool \u2014 no page reload required\n* Works without giving users access to the admin area<\/p>\n\n\ud83d\udca1 Perfect For<\/h4>\n\n
\n
\ud83c\udfaf How It Works<\/h4>\n\n
\ud83c\udf1f What Makes This Plugin Special?<\/h4>\n\n
\ud83d\udd27 Technical Details<\/h4>\n\n
\n
get_avatar()<\/code> function<\/li>\n\ud83d\udcda Documentation & Support<\/h4>\n\n
Shortcodes<\/h3>\n\n
[custom_profile_picture]<\/h4>\n\n
[custom_profile_picture]\n<\/code><\/pre>\n\nAdditional Information<\/h3>\n\n
Credits<\/h4>\n\n
\n
Privacy Policy<\/h4>\n\n
Want to Contribute?<\/h4>\n\n
Love This Plugin?<\/h4>\n\n
\n
For Developers<\/h4>\n\n
Automatic Installation<\/h4>\n\n
\n
Manual Installation<\/h4>\n\n
\n
Usage<\/h4>\n\n
[custom_profile_picture]<\/code> shortcode to any page or post\n2. Logged-in users will see their current profile picture with \"Upload New Picture\" and (if set) \"Remove Picture\" buttons\n3. Clicking \"Upload New Picture\" opens a built-in crop tool \u2014 save to update immediately, no page reload needed\n4. Guests or logged-out users see a polite sign-in prompt<\/p>\n\n\n
Does this work with Gravatar?<\/h3><\/dt>\n
What image formats are supported?<\/h3><\/dt>\n
What's the recommended image size?<\/h3><\/dt>\n
Can users upload their own profile pictures?<\/h3><\/dt>\n
Will this affect my site's performance?<\/h3><\/dt>\n
Can I bulk upload profile pictures?<\/h3><\/dt>\n
Does it work with BuddyPress or other profile plugins?<\/h3><\/dt>\n
get_avatar()<\/code> function. The plugin integrates with WordPress's core avatar system.<\/p><\/dd>\nCan I remove a custom profile picture?<\/h3><\/dt>\n
Is the plugin translation ready?<\/h3><\/dt>\n
Does it work with multisite?<\/h3><\/dt>\n
1.0.5<\/h4>\n\n
\n
get_avatar_url<\/code> and pre_get_avatar_data<\/code> filters now correctly resolve any $id_or_email<\/code> value (integer ID, email string, or WP_Comment object), so custom avatars display properly on the frontend in all contexts.<\/li>\n[custom_profile_picture]<\/code> shortcode \u2014 lets logged-in users upload, crop, and remove their own profile picture on any public page without admin access.<\/li>\ncustprofpic_frontend_remove_picture<\/code>).<\/li>\nfrontend-profile.css<\/code>) and JS (frontend-upload.js<\/code>) \u2014 loaded only on pages that contain the shortcode.\nAdded \u2013 Appsero insight vendor<\/strong>\nCritical Performance Update \u2013 Highly Recommended<\/strong><\/p><\/li>\nattachment_url_to_postid()<\/code> calls<\/p><\/li>\n1.0.2 \u2013 January 8, 2026<\/h4>\n\n
\n
1.0.1 \u2013 July 21, 2025<\/h4>\n\n
\n
1.0.0 \u2013 Initial Release<\/h4>\n\n
\n