﻿=== WhatAvatar - Custom Avatar Builder for WordPress ===
Contributors: rubengc, eneribs, dioni00
Tags: avatar, upload, user, photo, picture
Requires at least: 5.0
Tested up to: 7.1
Stable tag: 1.0.0
License: GPLv3
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Turn user profile pictures into customizable, privacy-first avatars that boost member engagement!

== Description ==

[WhatAvatar](https://whatavatar.com "WhatAvatar") is a powerful, customizable avatar editor for WordPress that lets your users create their own unique identity without uploading personal photos.

Replace traditional avatar uploads with a creative avatar builder that puts customization in your users hands while giving you full control over the available options and unlocking system.

Protect user privacy, prevent inappropriate image uploads and offer a fun avatar editor tailored for online communities, e-learning platforms (LMS), membership sites and child-safe environments.

👉 [Live Demo](https://whatavatar.com "Live Demo") 👈

= 🚀 Why WhatAvatar? =

Say goodbye to moderation headaches and generic avatars. WhatAvatar brings users creative freedom over their digital identity while gives site owners absolute control over design and security.

* 🎨 **Creative Freedom:** Let users mix and match hairs, outfits, accessories and colors using a modern avatar editor.
* 🛡️ **Safe & Privacy-First:** Protect your site from explicit, copyrighted, or inappropriate image uploads. Perfect for minors, schools (LMS) and communities.
* 🏆 **Boost Engagement:** Lock avatar parts behind points, course completions, or store purchases to keep interest high and boost user participation.
* 🔌 **Seamless Integrations:** Integrates into the profile editing areas and replaces avatar uploads across top plugins with a few clicks.

= 🔥 Features =

🎛️ **Fully Customizable Avatar Builder**
Customize available parts, disable unwanted parts (e.g., disable certain eyes, noses or beards) and configure the default avatars for users without one.

🎮 **Gamified Unlocks with GamiPress**
Turn avatars into status symbols! Restrict specific clothing, or rare accessories behind GamiPress points, achievements and ranks. Give your members a reason to keep coming back and earning.

⚡ **Automate Avatar Unlocks with AutomatorWP**
Unlock avatar items using AutomatorWP automations and connect avatar unlocks to over 300+ plugins and external services.

* **WooCommerce:** Unlock exclusive outfits when a user purchases a product.
* **TutorLMS:** Award special hat when a user completes a course.
* **BBForms:** Grant unique items when a user fills a form.

= ⚙️ Integrations =

WhatAvatar integrates flawlessly into the profile editing areas of your favorite plugins. You can also disable image uploads and replacing them with the WhatAvatar editor. The supported plugins are:

- bbPress
- BuddyPress
- BuddyBoss
- TutorLMS
- FluentCommunity
- PeepSO
- Ultimate Member
- LifterLMS

= ⭐ Premium version available =

Take the avatar customization experience to the next level with WhatAvatar PRO, designed for growing networks, creators, and enterprise learning portals.

- 👑 **Premium Avatar Parts:** Bring your users the most exclusive, cutting-edge designs.
- 📦 **Themed Part Bundles:** Access seasonal and thematic avatar parts (Christmas, Jobs, ...).
- 🌈 **Custom Color Palettes:** Customize the color palettes to bring diversity self-expression.
- 🎨 **Advanced Color Picker:** Add a color picker to allow members to fine-tune exact color.
- 🌙 **Dark Mode & Custom UI Themes:** Match the avatar editor seamlessly with your site’s aesthetic, including dark mode and color scheme customization.
- 📥 **High-Res Avatar Downloads:** Allow users to export their avatars for external profile pictures or social media sharing.
- 🛠️ **Enhanced Editor Tooling:** Customize which controls are visible inside the editor.

= ♥️ More plugins from the WhatAvatar team =

🕹️ [GamiPress](https://wordpress.org/plugins/gamipress/) - Gamification plugin to boost engagement by rewarding users with points, achievements, badges & ranks.
🤖 [AutomatorWP](https://wordpress.org/plugins/automatorwp/) - Automator plugin that connects +300 plugins, platforms and sites together with support to webhooks.
🔗 [ShortLinks Pro](https://wordpress.org/plugins/shortlinkspro/) - Link management plugin for shortened URLs & branded affiliate links.
📋 [BBForms](https://wordpress.org/plugins/bbforms/) - Code form plugin designed to help you build multipurpose forms in seconds!

== Installation ==

= From WordPress backend =

1. Navigate to Plugins -> Add new.
2. Click the button "Upload Plugin" next to "Add plugins" title.
3. Upload the downloaded zip file and activate it.

= Direct upload =

1. Upload the downloaded zip file into your `wp-content/plugins/` folder.
2. Unzip the uploaded zip file.
3. Navigate to Plugins menu on your WordPress admin area.
4. Activate this plugin.

== Screenshots ==

1. Let users mix and match hairs, outfits, accessories and colors using a modern avatar editor.
2. Lock avatar parts behind points, course completions, or store purchases to keep interest high and boost user participation.
3. Manage available avatar parts and lock them behind the requirements of your choice.
4. Easily customize the default avatars for users without their own.
5. WhatAvatar integrates flawlessly into the profile editing sections of your favorite plugins.

== Frequently Asked Questions ==

= What is WhatAvatar? =

WhatAvatar is a flexible avatar plugin that brings a powerful, customizable avatar editor to WordPress profile pages, allowing users to create and personalize their own digital identity.

It can also replace Gravatar and profile picture uploads with custom-created avatars, helping protect user privacy and prevent inappropriate images from being uploaded and displayed across your website.

= Can WhatAvatar disable Gravatar? =

Yes, you can disable it from your admin dashboard by navigating to Settings > WhatAvatar > Integrations > WordPress > Disable Gravatar.

Additionally, WhatAvatar lets you configure default avatars for users who haven't created their own yet.

= Can WhatAvatar disable image uploads from other plugins? =

Yes, you can disable it from your admin dashboard by navigating to Settings > WhatAvatar > Integrations > and you will find options for each plugin.

= Can users unlock additional avatar parts? =

Yes. You can offer different ways for users to unlock avatar parts thanks to GamiPress & AutomatorWP, creating more opportunities for engagement and progression.

= Can I customize the available avatar parts? =

Yes. You can manage the avatar parts available to your users, giving you full control over the customization options.

In your admin dashboard, navigate to Settings > WhatAvatar > Editor to configure them.

= Can I set default avatars for new users? =

Yes. You can fully configure default avatars for new members or guest users who haven't yet customized their avatar.

In your admin dashboard, navigate to Settings > WhatAvatar > Default Avatars to configure them.

= Can I display the avatar editor? =

Yes, you can use the WhatAvatar Block or the ´[whatavatar]´ shortcode to display the user's avatar along with the avatar editor.

= Can I display the user avatar? =

Yes, simply use the WhatAvatar Block & ´[whatavatar]´ Shortcode and disable the "avatar editor" options.

To display only the avatar using the shortcode, use: ´[whatavatar editor="no"]´

= Is WhatAvatar safe for websites with minors or educational platforms? =

Yes, absolutely. Because users build their identity using pre-approved graphical elements rather than uploading external images, WhatAvatar protects your users privacy, prevents exposure to inappropriate content, and ensures full compliance in school, LMS, and youth community environments.

= Will WhatAvatar slow down my site? =

No. WhatAvatar is engineered with performance in mind.

Its assets and scripts are extremely lightweight and are only loaded on pages where the avatar editor is actively embedded or rendered.

= Is WhatAvatar compatible with any WordPress theme? =

Yes. WhatAvatar is designed to work with any standard-compliant WordPress theme.

Additionally, it has been rigorously tested and optimized across a wide range of popular WordPress themes.

== Changelog ==

= 1.0.0 =

* Initial Release.
