=== Real Simple Avatar ===
Contributors: avsalexandra
Tags: avatar, user avatar, profile picture, upload avatar, custom avatar
Requires at least: 5.0
Tested up to: 6.9.4
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Upload avatar for users, preset avatars, and initials fallback.

== Description ==

**Real Simple Avatar** lets your users upload a custom profile photo or pick from a set of preset avatars. If no avatar is set, a colourful initials avatar is generated automatically — keeping your site looking polished without any extra effort from your users.

**Features**

* Shortcode `[rsava_avatar_form]` — place on any page or post so logged-in users can manage their avatar without going to the admin panel.
* AJAX upload — avatar updates happen instantly, without a page reload.
* Custom photo upload — users can upload their own image; it is cropped to a configurable square size (default 240 × 240 px). Only one file is stored in the Media Library per user (old file is deleted automatically on replacement or deletion).
* Initials fallback — if no avatar is set, a colourful SVG avatar made from the user's initials is shown everywhere WordPress displays an avatar.
* Preset avatars — choose from built-in preset images or replace them entirely with your own set via the plugin settings.
* Fine-grained settings:
  * Enable / disable custom photo upload in the shortcode.
  * Enable / disable the preset avatar grid in the shortcode.
  * Configure which image formats are accepted (PNG, JPG, JPEG, WebP, HEIC, HEIF, AVIF, GIF).
  * Set the maximum upload file size (MB).
  * Set the crop size in pixels (e.g. 240 for 240 × 240 px). Uploaded images are stored **only** at this size — no extra WordPress sub-sizes are generated.
  * Customise the background colours and text colour used for initials avatars.
* Admin profile page — admins can upload or remove a user's avatar directly from the Edit User screen.
* Clean uninstall — optionally delete all plugin settings and uploaded avatar media files when the plugin is deleted.
* Partial Russian translation included.

---

**Real Simple Avatar** — плагин для загрузки своего аватара. По умолчанию рандомный цвет + инициалы. А также на выбор готовые аватарки. При загрузке нового аватара медиафайл старого аватара удаляется.

- Шорткод `[rsava_avatar_form]` для загрузки аватара.
- Настройки плагина в **Настройки → Аватар**.
- Можно самостоятельно выбрать рандомные цвета и цвет инициалов в аватарке.
- Можно отключить загрузку аватара в шорткоде и оставить выбор только из готовых аватарок.
- Можно отключить готовые аватарки в плагине и добавить свои. То есть сделать свой пресет аватарок.
- В настройках можно ограничить до какого размера будут обрезаться аватарки. Например 240 × 240 px. Только этот размер медиафайла будет храниться в медиатеке.
- При загрузке нового аватара или удалении аватара медиафайл прошлого аватара будет всегда удаляться. Таким образом ваша медиатека WordPress будет всегда в порядке и чистоте.

== Installation ==

1. Download or clone the plugin.
2. Upload the plugin folder to `/wp-content/plugins/`.
3. Activate the plugin through the **Plugins** menu in WordPress Admin.
4. Go to **Settings → Avatar** to configure the plugin.
5. Add the shortcode `[rsava_avatar_form]` to any page or post where you want users to manage their avatar.

== Frequently Asked Questions ==

= Can I replace the built-in preset avatars with my own? =
Yes. In **Settings → Avatar → Preset Avatars**, uncheck "Show preset avatar grid in shortcode" (or leave it checked), then upload your own images. You can also disable the built-in presets entirely and show only your custom ones.

= Можно ли заменить встроенные пресеты аватаров своими? =
Да. В **Настройки → Аватар → Готовые аватары** снимите галочку «Показывать пресеты в шорткоде» (или оставьте), затем загрузите свои изображения. Также можно полностью отключить встроенные пресеты и показывать только свои.

= Can I stop users from uploading a custom photo and only let them choose from presets? =
Yes. In **Settings → Avatar → Media**, uncheck "Allow file upload". The upload button will be hidden and users can only pick from preset images.

= Можно ли запретить загрузку своего фото и оставить только выбор из пресетов? =
Да. В **Настройки → Аватар → Медиа** снимите галочку «Разрешить загрузку файлов». Кнопка загрузки скроется и пользователи смогут выбирать только из готовых аватарок.

= What image formats are supported? =
By default: PNG, JPG, JPEG, WebP, HEIC. You can add or remove formats (including AVIF and GIF) in **Settings → Avatar → Media**.

= Какие форматы изображений поддерживаются? =
По умолчанию: PNG, JPG, JPEG, WebP, HEIC. Вы можете добавить или убрать форматы (в том числе AVIF и GIF) в **Настройки → Аватар → Медиа**.

= Where is the avatar stored? =
Uploaded photos are stored in the WordPress Media Library as a regular attachment. Each user has at most one avatar attachment; the old one is deleted automatically when a new photo is uploaded or the avatar is removed.

= Где хранится аватар? =
Загруженные фото хранятся в медиатеке WordPress как обычные вложения. У каждого пользователя максимум один файл аватара — старый удаляется автоматически при замене или удалении аватара.

= What happens to avatar files when a user is deleted? =
The avatar attachment is automatically removed from the Media Library when a user account is deleted.

= Что происходит с аватаром при удалении пользователя? =
Файл аватара автоматически удаляется из медиатеки при удалении учётной записи пользователя.

= How do I completely remove all plugin data? =
In **Settings → Avatar → Advanced**, check "Delete data on uninstall", save, then delete the plugin from the Plugins screen. All plugin options and uploaded avatar media will be removed in batches.

= Как полностью удалить все данные плагина? =
В **Настройки → Аватар → Дополнительно** включите «Удалить данные при удалении плагина», сохраните, затем удалите плагин через страницу «Плагины». Все настройки и загруженные аватары будут удалены пакетами.

== Screenshots ==

1. Avatar upload shortcode on the front end.
2. Change avatar in admin.
3. Plugin settings page.
4. Avatar settings.

== Changelog ==

= 1.0.1 =
* Bug fixes and minor improvements. Plugin version updated to 1.0.1.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.1 =
Bug fixes and minor improvement.

= 1.0.0 =
First public release.

== Compatibility ==

Tested with PHP 7.4, 8.0, 8.1, 8.2, 8.3. Tested with WordPress 5.0 – 6.9.4

== License ==

This plugin is licensed under the GPLv2 or later.
