=== Asgaros Custom Icons ===
Contributors: AlexR80
Plugin URI: https://github.com/AlexR80/asgaros-custom-icons
Author: AlexR80
Author URI: https://github.com/AlexR80
Tags: asgaros, asgaros-forum, forum, icons, media-library
Requires at least: 6.5
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.4.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Requires Plugins: asgaros-forum

Replaces Asgaros Forum's FontAwesome icons with custom images chosen from the WordPress Media Library.

== Description ==

**Asgaros Custom Icons** is an add-on for the [Asgaros Forum](https://wordpress.org/plugins/asgaros-forum/) plugin.
It adds, on the forum's "Structure" admin screen, a picker that lets you choose an image from the
WordPress Media Library to replace each forum's default FontAwesome icon.

= Features =

* Image picker built directly into the Asgaros Forum admin screen ("Structure").
* Uses the native WordPress media library (`wp.media`) — no extra interface to learn.
* The custom icon is shown directly in the "Structure" list, in place of the FontAwesome icon,
  as soon as an icon has been chosen for a forum.
* Custom icons automatically replace FontAwesome icons on the front end (forum overview).
* Automatic cleanup of icons attached to forums that have been deleted.
* Settings page ("Custom Icons") to choose whether custom icons should be kept or deleted when
  the plugin is uninstalled.
* Configurable visual filter (grayscale, reduced opacity, etc.) automatically applied to a
  forum's custom icon when it has no new posts, matching what Asgaros does with its own
  FontAwesome icons.
* Server-side validation of the forum ID and file type before anything is ever saved.
* Full cleanup of stored data (options and cache) on uninstall, unless the user chose to keep
  the custom icons.
* Translation-ready (`.pot` template included, French and German `.po`/`.mo` translations included).

= Dependency =

This plugin **requires [Asgaros Forum](https://wordpress.org/plugins/asgaros-forum/) to be
installed and active**. Without it, Asgaros Custom Icons cannot be activated (and deactivates
itself automatically if Asgaros Forum is later deactivated).

== Installation ==

1. Install and activate the **Asgaros Forum** plugin first, if you haven't already.
2. Upload the `asgaros-custom-icons` folder to `/wp-content/plugins/`, or install the `.zip`
   archive directly from the **Plugins > Add New** screen in WordPress.
3. Activate the **Asgaros Custom Icons** plugin from the **Plugins** screen.
4. Go to **Forum > Structure**, open a forum for editing: a "Choose an image" button appears
   next to the usual icon field.

== Frequently Asked Questions ==

= Does the plugin work without Asgaros Forum? =

No. Asgaros Custom Icons entirely depends on Asgaros Forum and deactivates itself automatically
if it isn't active.

= What happens if I delete a forum that has a custom icon? =

The corresponding entry is automatically cleaned up the next time the Asgaros admin screen is
loaded. Since the list of existing forums is cached for 5 minutes, this cleanup may be delayed
by a few minutes after the forum is deleted.

= Is the data removed when I uninstall the plugin? =

By default, yes: the `asgaros_custom_forum_icons` option and the plugin's internal cache are
removed from the database on full uninstall (not on a simple deactivation). You can, however,
keep your custom icons by checking the corresponding option on the **Forum > Custom Icons**
page before uninstalling — useful if you plan to reinstall later.

= How does the visual filter for icons with no new posts work? =

On the **Forum > Custom Icons** page, you can choose an effect (grayscale, reduced opacity,
etc.) that is automatically applied to a forum's custom icon when it has no new posts — exactly
like Asgaros does by default with its FontAwesome icons. This filter only applies on the front
end (where Asgaros shows the read/unread state); it has no effect on the "Structure" admin
screen.

== Changelog ==

= 1.4.1 =
* Added: German (de_DE) translation.

= 1.4.0 =
* Added: new setting on the **Forum > Custom Icons** page to choose a visual filter (none,
  grayscale, reduced opacity, reduced brightness, or a combination) automatically applied to a
  forum's custom icon when it has no new posts, matching Asgaros's default FontAwesome behavior.

= 1.3.0 =
* Added: new **Forum > Custom Icons** settings page, with an option to choose whether custom
  icons should be kept or permanently deleted on uninstall (deleted by default, as in previous
  versions).

= 1.2.0 =
* Added: the custom icon is now shown directly in the Asgaros admin "Structure" list, in place
  of the FontAwesome icon, as soon as an icon has been chosen for a forum (previously it only
  appeared in the forum's edit form).
* The icon in the list now updates instantly when an image is chosen or removed, with no page
  reload.

= 1.1.0 =
* Security: the AJAX handler now verifies that the received `forum_id` matches an Asgaros forum
  that actually exists before saving anything (instead of a plain `intval()`).
* Performance: the list of existing forums is now cached (transient, 5 minutes) instead of being
  queried from the database on every load of the Asgaros admin screen.
* Hardening: added empty `index.php` files in the `assets/` and `languages/` folders to prevent
  directory listing on misconfigured servers.
* Consistency: `Requires at least` raised to 6.5 to match actual support for the
  `Requires Plugins` header.
* Translation: added the missing `.pot` (template) file; synced the French `.po`/`.mo` file.
* The existing-forums cache and the plugin's option are now removed on deactivation/uninstall.

= 1.0.0 =
* Initial release.
* Custom icon selection via the WordPress media library, stored by attachment ID.
* Automatic replacement of FontAwesome icons on the front end.
* Dependency check on Asgaros Forum (blocked activation / auto-deactivation).
* Automatic cleanup of orphaned icons and full data removal on uninstall.
* French translation included.

== Upgrade Notice ==

= 1.4.1 =
German (de_DE) translation added.

= 1.4.0 =
New setting: visual filter (grayscale, opacity...) for icons of forums with no new posts.

= 1.3.0 =
New option (Forum > Custom Icons) to keep your custom icons on uninstall.

= 1.2.0 =
The custom icon now also shows in the admin "Structure" list.

= 1.1.0 =
Security hardening (forum_id validation) and performance improvements (caching). Recommended update.

= 1.0.0 =
Initial release of the plugin.
