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

Real-time clock for the admin toolbar with multi-calendar, per-user timezone and colour controls.

== Description ==

**Admin Toolbar Live Clock** keeps the current *site* time always in view while you work.

> Perfect for distributed editorial teams, agencies running sites in different time-zones, or any admin who regularly checks cron jobs, comment timestamps or scheduled posts.

### Who benefits?

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

### Feature highlights

* **Live ticking** – updates every second; no page reloads, no Ajax polling  
* **Calendars** – Gregorian, Persian (Jalali), Islamic (Hijri), Hebrew, Buddhist (Thai) and Japanese  
* **Languages bundled** – en_US, fa_IR, ar_SA, he_IL, th_TH, ja_JP (+ fully translatable)  
* **Time formats** – 12-hour or 24-hour  
* **Per-user timezone** – keep the site setting or pick any IANA timezone  
* **Colour-picker** – separate, native WP colour-picker fields for clock & date  
* **Admin-only & WPCS** – assets load only in wp-admin for users with *manage_options*; codebase follows WordPress-Coding-Standards  
* **Clean uninstall** – removes all options on **Delete** via `uninstall.php`  

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

== Installation ==

*From the WordPress plugin directory (recommended)*  

1. Search **“Admin Toolbar Live Clock”** under *Plugins → Add New*, click **Install Now**, then **Activate**.

*Manual upload*  

1. Upload the folder to `/wp-content/plugins/`.  
2. Activate via *Plugins → Installed Plugins*.  

Finally, open **Settings → Toolbar Clock**, adjust options and click **Save Changes**.

== Frequently Asked Questions ==

= Will front-end visitors see the clock? =  
No. Assets load only in wp-admin for roles that can *manage_options* (typically Administrators).

= Can I translate the plugin? =  
Yes — create a PO/MO for text-domain **admin-toolbar-live-clock** and drop it in `wp-content/languages/plugins/`.

= How do I switch calendars? =  
Choose a calendar system from the **Calendar** dropdown and save.

= Time looks off — what now? =  
Untick **Use site timezone**, pick your local timezone, save, and the clock will adjust instantly.

== Screenshots ==

1. Clock in action – live time & date on the admin-toolbar. (screenshot-1.png)  
2. Settings screen – calendar, format, colour & timezone options. (screenshot-2.png)

== Changelog ==

= 1.0.1 =
* Switched all inline `<script>`/`<style>` blocks to proper `wp_enqueue_*` calls  
  – added dedicated stylesheet **atlc-admin.css** and enqueued `atlc-admin.js`.
* Added colour-picker values sanitised via `sanitize_hex_color()`.
* Updated readme: correct Contributors slug and stable tag.
* Minor WPCS / PHPCS fixes.

= 1.0.0 =
* Initial public release  
    * Real-time JavaScript clock  
    * 6 calendar systems  
    * Per-user timezone override  
    * Native WP colour-picker  
    * Uninstall routine and full WPCS compliance  

== Upgrade Notice ==

= 1.0.1 =
Recommended update – replaces inline assets with properly enqueued files, and improves security/compatibility.