=== Admin Toolbar Live Clock ===
Contributors: araoufi
Tags: admin-bar, clock, time, timezone, calendar
Requires at least: 5.2
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.1.1
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Live clock for the WordPress admin bar with multi-calendar, per-user timezone, and optional analog & floating modes.

== Description ==

**Admin Toolbar Live Clock** keeps the current time and date always in view while you work in wp-admin.

It’s ideal for editors and admins who constantly check scheduled content, cron jobs, moderation timestamps, or who manage sites across different time-zones.

> Designed for daily professional use: lightweight, clean UI, no clutter — and optional “Minimal mode” when you want the plugin at its simplest.

### Who benefits?

* Editors coordinating global content releases
* Support agents logging activity against a consistent time source
* Developers verifying scheduled tasks (WP-Cron / Action Scheduler)
* Multisite admins overseeing sites across regions

### Feature highlights

* **Live ticking** — updates every second (no page reloads, no Ajax polling)
* **Display modes** — choose **Digital** or the new **Analog** clock mode
* **Analog clock (new)**
	* Multiple themes (including **Tomanify**)
	* Size options (**Small / Large**)
	* Optional date display inside the analog face
* **Floating clock (new)** — show the clock as a floating widget in wp-admin  
	* **Analog mode uses the floating view automatically**
* **Draggable position (new)** — drag the floating clock and it remembers its position for next visits
* **Minimal mode (new)** — disables advanced styling/options and keeps only the core settings
* **Calendars** — Gregorian, Persian (Jalali), Islamic (Hijri), Hebrew, Buddhist (Thai) and Japanese
* **Plugin language** — choose the plugin language independently from the WordPress site language
    * Languages bundled – en_US, fa_IR, ar, es_ES, fr_FR, he_IL, hi_IN, ja, th_TH, de_DE, ru_RU, tr_TR, ps_AF, uk_UA, pl_PL, ro_RO, zh_CN, ko_KR (+ fully translatable via PO/MO)
* **Time formats** — 12-hour or 24-hour
* **Timezone** — use the site timezone or pick any IANA timezone
* **Colour controls** — clock & date colours (where applicable)
* **Tabbed settings UI (new)** — cleaner settings screen with **General / Style / About**
* **Admin-only** — visible only in wp-admin (never on the front-end)
* **Clean uninstall** — removes plugin options on **Delete** via `uninstall.php`

Find the settings page at **Settings → Toolbar Clock**.

== Installation ==

*From the WordPress plugin directory (recommended)*

1. Go to **Plugins → Add New**
2. Search for **“Admin Toolbar Live Clock”**
3. Click **Install Now**, then **Activate**
4. Open **Settings → Toolbar Clock** and configure the plugin

*Manual upload*

1. Upload the plugin folder to `/wp-content/plugins/`
2. Activate it via **Plugins → Installed Plugins**
3. Open **Settings → Toolbar Clock**, adjust options, then click **Save Changes**

== Frequently Asked Questions ==

= Will front-end visitors see the clock? =
No. The clock is for wp-admin only.

= Where is the settings page? =
Go to **Settings → Toolbar Clock**.

= How do I enable Analog mode? =
Open **Settings → Toolbar Clock → Style** and switch **Display mode** to **Analog**.  
Analog mode uses the floating clock automatically.

= How do I move the floating clock? =
Enable **Drag & remember position**, then drag the floating clock to your preferred spot.  
Position is saved per browser (via local storage), so each device/browser can have its own placement.

= I dragged it off-screen — how do I reset the position? =
Disable dragging and re-enable it, or clear the browser’s site storage for wp-admin.

= Can I translate the plugin? =
Yes. The plugin is fully translatable via PO/MO files (text-domain: `admin-toolbar-live-clock`).  
You can also choose the plugin language directly from the settings screen.

== Screenshots ==

1. Digital clock in the admin toolbar (live time & date).
2. Analog clock (floating) with theme + size options.
3. Settings screen (tabbed UI: General / Style / About).
4. Floating clock dragged to a custom position in wp-admin.

== Changelog ==

= 1.1.1 =
* Hotfix: corrected release packaging and restored missing asset files.
* Ensured stable build for all users updating from version 1.1.0.

= 1.1.0 =
* Added Analog clock mode with selectable themes, optional date display, and size options.
* Added Floating clock mode in wp-admin (Analog mode automatically uses floating view).
* Added Drag & remember position for the floating clock.
* Added Minimal mode to keep only core settings and disable advanced styling options.
* Rebuilt settings UI into tabs: General / Style / About (About includes project info and License & Credits modal).
* Improved UX: keep the selected tab after saving settings; show disabled fields instead of hiding them in Minimal mode.
* Fixed Analog initialization flicker.
* Restructured assets into standard WordPress folders.
* WPCS and Plugin Check improvements.
* Added bundled translations: German, Russian, Turkish, Pashto, Ukrainian, Polish, Romanian, Chinese (Simplified), and Korean.

= 1.0.2 =
* Added “Settings” link to plugin list on Plugins screen.
* Added option: “Make clock clickable” to open plugin settings via the admin-bar clock.
* Minor improvements to toolbar rendering logic for consistent ID targeting.

= 1.0.1 =
* Switched inline `<script>`/`<style>` blocks to proper `wp_enqueue_*` calls.
* Added dedicated admin stylesheet and settings script.
* Added colour-picker values sanitised via `sanitize_hex_color()`.
* Minor WPCS / PHPCS fixes.

= 1.0.0 =
* Initial public release:
	* Real-time JavaScript clock
	* Multiple calendar systems
	* Time format selection (12h/24h)
	* Timezone override
	* Native WP colour-picker
	* Clean uninstall routine

== Upgrade Notice ==

= 1.1.1 =
Recommended update that ensures a stable and complete plugin installation.

= 1.1.0 =
Major update: adds Analog mode, floating/draggable clock, Minimal mode, and a redesigned tabbed settings screen. Recommended for improved usability and features.

== Author ==

Developed by Amin Raoufi.
