=== Time.now Clock Widget ===
Contributors: timenow, chrisyau83
Tags: clock, time, widget, timezone, world clock, word clock
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed beautiful, customizable clock widgets from Time.now on your WordPress site — text, word, digital, and analog clocks. Any timezone, accurate to the second.

== Description ==

Display live, accurate clocks on your WordPress site without writing any JavaScript. Choose from four widget styles and customize colors, fonts, timezone, and format. The clock updates every second and respects daylight-saving transitions automatically.

= Widget types =

* **Text Clock** — Plain-text format ("The time in London is currently 14:32:08 BST"). Great for inline use in posts and pages.
* **Digital Clock** — Bold digital readout. Configurable size, color, 12/24h, optional date.
* **Word Clock** — The classic 11×10 letter grid that spells out the time ("IT IS HALF PAST NINE").
* **Analog Clock** — Traditional clock face with hour, minute, and second hands.

= How to use =

Three ways to embed:

1. **Gutenberg block** — Add the "Time.now Clock" block in the editor. Configure via the block sidebar.
2. **Shortcode** — `[time_now_clock type="text-clock" iana_timezone="Europe/Paris"]` anywhere posts or pages support shortcodes.
3. **Classic widget** — Drop "Time.now Clock" into any widget area via Appearance > Widgets.

= Privacy =

The plugin embeds an `<iframe>` pointing at `https://time.now/widget/<type>/render/`. No JavaScript runs on your site. No analytics or tracking scripts are loaded by the plugin itself. The Time.now widget endpoint logs standard HTTP request information (IP, user agent, referer) for abuse prevention and aggregate stats — see https://time.now/info/terms-privacy for details.

= Attribution =

By default the plugin renders only the iframe — no visible "Powered by" link is shown. If you want to credit Time.now (which helps support the free service), enable the "Show attribution" option on any embed. The attribution is a single `nofollow` link to https://time.now/ below the clock.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install via the WordPress plugin browser.
2. Activate through the "Plugins" menu in WordPress.
3. Add a Time.now Clock block, shortcode, or widget anywhere you want a clock to appear.

== Frequently Asked Questions ==

= Which timezones are supported? =

Any IANA timezone identifier (e.g. `Europe/London`, `America/New_York`, `Asia/Tokyo`). The full list is at https://en.wikipedia.org/wiki/List_of_tz_database_time_zones.

= Will it slow down my site? =

No. The plugin renders a single lightweight `<iframe>` and the widget itself loads asynchronously from Time.now's CDN. No JavaScript or external scripts are added to your site.

= Can I customize colors and fonts? =

Yes — every embed supports background color, text color, font family, and font size. Configure via the block sidebar, shortcode attributes, or widget form.

= Does it work in the Gutenberg block editor? =

Yes. Search for "Time.now Clock" in the block inserter.

= Is the attribution mandatory? =

No. Attribution is off by default and can be enabled per-embed if you want to credit Time.now.

== Screenshots ==

1. Gutenberg block in the editor, configuring a text clock with a timezone.
2. The four widget types previewed on a published page.
3. Classic widget configuration in Appearance > Widgets.

== Changelog ==

= 1.0.1 =
* Attribution default changed to off (explicit opt-in required).
* Fixed privacy policy URL.
* Removed load_plugin_textdomain (handled by WordPress.org since 4.6).
* Removed directory asset images from plugin zip.

= 1.0.0 =
* Initial release.
* Four widget types: text, digital, word, analog.
* Gutenberg block + shortcode + classic widget.
* Optional attribution (default off).
* Localization-ready.

== Upgrade Notice ==

= 1.0.0 =
First release.
