=== MHADAD Smart Messages ===
Contributors: merajhadad
Donate link: https://mhadad.ir/
Tags: messages, notification, bubble, persian, farsi
Requires at least: 6.7
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 5.2.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display lightweight, non-intrusive smart messages in a fixed bubble at the bottom center of your WordPress site.

== Description ==

MHADAD Smart Messages is a lightweight WordPress plugin for displaying short, helpful messages in a fixed bottom-center bubble.

Version 5.2.3 features:

* A fixed bottom-center message bubble that cannot be dragged by visitors.
* Six ready-to-use visual presets: Pearl Light, Night Dark, Glass Lavender, Calm Mint, Soft Peach, and Ocean Blue.
* Live preview of the selected preset and quick previews of all six presets in the admin area.
* Font selection: system font, Tahoma, Arial, Dirooz, and Vazir.
* Messages remain on one line and automatically fit smaller screens and different font widths.
* Configurable number of messages displayed per page: 5, 10, 15, 20, 30, or 50.
* Messages are randomly selected for each page view, and duplicate messages are removed when saved.
* Persian, Arabic, and Latin digits, plus #, $, %, and & characters, are removed from messages when they are saved.
* A separate scroll guidance message can be enabled or disabled and its text can be customized.
* Removing the default messages does not remove the separate scroll guidance message.
* Very large legacy message lists are automatically migrated to the current message set during an upgrade.
* Save, reset, and delete operations use WordPress nonce and capability checks.
* Ten built-in SVG icons are available for main messages; the scroll guidance message intentionally has no icon.
* The admin interface is responsive and available in Persian RTL.
* The plugin is designed for WordPress 6.7+ and PHP 8.0+.
* Plugin styles and scripts are loaded using the standard WordPress enqueue APIs.

== Installation ==

1. Upload the plugin ZIP from Plugins > Add New Plugin, or extract the plugin folder into wp-content/plugins/.
2. Activate MHADAD Smart Messages from the Plugins screen.
3. Open Tools > Smart Messages in the WordPress admin area.
4. Choose the visual preset, font, message count, and scroll guidance settings, then save your changes.

== Fonts ==

The plugin includes the Dirooz and Vazir font files shipped with this project for local use. The plugin does not load fonts from an external third-party service.

== Screenshots ==

1. Smart Messages entry under the WordPress Tools menu.
2. Main plugin settings and scroll guidance settings.
3. Six visual presets with live previews.
4. Font selection and configurable message count.
5. Default message management, reset, and delete controls.

== Changelog ==

= 5.2.3 =
* Updated the WordPress.org documentation to English.
* Moved the plugin admin page under Tools to preserve the WordPress admin hierarchy.
* Loaded admin CSS and JavaScript through WordPress enqueue APIs.
* Removed direct script and style blocks from the plugin page output.
* Improved compatibility with WordPress.org plugin review requirements.

= 5.2.2 =
* Prepared the plugin documentation for WordPress.org submission.
* Updated the stable tag and plugin version.
* Adjusted readme tags to meet WordPress.org limits.
* Completed documentation for the 5.2.x feature set and screenshots.

= 5.2.0 =
* Redesigned the dark preset with a cleaner, more readable appearance.
* Added independent settings for the scroll guidance message.
* Removing default messages no longer removes the scroll guidance message.
* Added automatic migration of very large legacy message lists.
* Updated the current message set after duplicate cleanup.

= 5.1.5 =
* Corrected the ZIP structure for standard WordPress installation.

= 5.1.4 =
* Added configurable random message counts: 5, 10, 15, 20, 30, or 50.
* Added a second save button at the bottom of the settings page.
* Removed digits and #, $, %, and & characters when saving messages.
* Added controls for deleting and restoring default messages.
* Improved the dark preset.
* Added the MHADAD.IR footer link.

= 5.1.3 =
* Clicking Smart Messages opens the settings page directly.
* Added ten SVG icons for main messages.
* Improved one-line message fitting.
* Added the admin footer branding.

= 5.1.0 =
* Removed manual color selection.
* Added six ready-to-use visual presets.
* Added Dirooz and Vazir as bundled fonts.
* Improved admin menu readability and one-line message fitting.
