=== 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.