=== M7tawa Seasonal Icons ===
Contributors: aymanabdullahdev
Tags: seasonal, icons, snow, ramadan, effects
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.2.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Lightweight seasonal and occasion icons using images from the WordPress Media Library.

== Description ==
M7tawa Seasonal Icons lets administrators save multiple occasions and activate one at a time. Each occasion can use its own Media Library image, density, movement, optional icon size, and optional start/end dates.

For the cleanest appearance, transparent PNG or WebP images are recommended.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/m7tawa-seasonal-icons` directory, or install the plugin through the WordPress Plugins screen.
2. Activate M7tawa Seasonal Icons through the Plugins screen in WordPress.
3. Open the Seasonal Icons settings page in the WordPress dashboard.
4. Add an occasion, choose an image from the Media Library, configure its display options, and save your changes.
5. Activate the occasion when you want it to appear on the site.

== Frequently Asked Questions ==

= Can I save more than one occasion? =

Yes. You can save multiple occasions and keep their settings for later use. Only one occasion is displayed at a time.

= Can I schedule an occasion? =

Yes. Each occasion can have an optional start date and end date.

= Can I show the icons only on the front page? =

Yes. The display scope can be set to the entire site or the front page only.

= Which image formats work best? =

Transparent PNG or WebP images are recommended for the cleanest appearance.

= Can I control the icon density, movement, and size? =

Yes. Each occasion can have its own density, movement style, and optional icon size.

== Screenshots ==

1. Seasonal Icons settings page with saved occasions and activation controls.
2. Occasion settings including image, density, movement, icon size, display scope, and optional dates.
3. Seasonal icons displayed on the front end using the selected occasion image.

== Changelog ==

= 1.2.3 =
* Added GPL license metadata to the main plugin header for WordPress.org compliance.
* No functional changes.

= 1.2.2 =
* Prepared all user-facing source strings for WordPress.org translation.
* Removed hard-coded interface strings from JavaScript.
* Preserved all functionality from 1.2.0 and 1.2.1.

= 1.2.1 =
* Repository-preparation maintenance release.
* No functional changes from 1.2.0.

= 1.2.0 =
* Added unsaved-changes warning.
* Added occasion status: active, scheduled, expired, or inactive.
* Added display scope: entire site or front page only.
= 1.1.0 =
* Added multiple saved occasions.
* Only one occasion can be active at a time.
* Added optional Auto, Small, Medium and Large icon sizes.
* Added per-occasion image preview and transparent-image guidance.
* Added settings footer with author, M7tawa link and version.
* Preserved v1.0.0 settings through automatic legacy migration.

= 1.0.0 =
* Initial release.
