=== Currency.Wiki World Clock – Time Zones & Clock Widget ===
Contributors: currencywiki
Tags: world clock, time zone, clock widget, timezone, clock
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

World clock and time zone widget for WordPress. Five clock widget styles, no API key, no tracking. Works out of the box.

== Description ==

Add a **world clock** to your WordPress site in seconds. Choose from five clock widget styles — a digital clock, an analog clock, a multi-city world clock, a spinning 3D globe, or a date card. Every clock updates in real time in the visitor's own browser, so there is **no API key, no server calls, and nothing to configure to get started**.

Show a single **time zone**, or up to eight cities side by side — useful for remote teams, travel sites, international stores, and anyone whose readers are not in one place.

[View the Visual Builder](https://currency.wiki/time-widget)

= Key Features =

* **5 clock widget styles** — Digital, Analog, World Clock, Spinning Globe, Date Card
* **No API key** — times are computed in the browser; nothing to sign up for
* **World clock** — show up to 8 cities across time zones at once
* **Spinning globe** — a glowing vector Earth with live city times orbiting it
* **Gutenberg block** — native block editor with a live preview
* **Shortcode** — use `[cwiki_time]` in any post, page, or text widget
* **Themes & colors** — Light, Dark, or Auto, plus any accent color
* **12 / 24 hour** — automatic per locale, or force one
* **Localized dates** — weekday and month names in 40+ languages
* **Lightweight** — loads asynchronously, no impact on page speed
* **Privacy-friendly** — no cookies, no personal data collected
* **Credit link you control** — switch it off site-wide or per embed

= Widget Styles =

1. **Digital** (240x152) — clean digital time + date
2. **Analog** (200x210) — classic analog face
3. **World Clock** (264x288) — multiple cities, live
4. **Spinning Globe** (280x292) — vector Earth with orbiting city times
5. **Date Card** (240x230) — big date with day of week

= Usage =

**Gutenberg Block:**
Add a block, search for "World Clock", and adjust the settings in the sidebar. A live preview updates as you type.

**Shortcode:**

`[cwiki_time]`

With options:

`[cwiki_time style="globe" theme="dark" accent="f59e0b"]`
`[cwiki_time style="digital" tz="Asia/Tokyo" city="Tokyo" format="24"]`
`[cwiki_time style="world" zones="America/New_York~New York,Europe/London~London,Asia/Tokyo~Tokyo"]`

= Shortcode Attributes =

* `style` — digital, analog, world, globe, date (default: digital)
* `theme` — auto, light, dark (default: auto)
* `accent` — hex color without # (default: 2563eb)
* `format` — auto, 12, 24 (default: auto)
* `seconds` — 1 or 0 (default: 1)
* `date` — 1 or 0 (default: 1)
* `tz` — IANA timezone for single-clock styles, e.g. Asia/Tokyo (default: visitor's local time)
* `city` — label shown under a single clock
* `zones` — cities for world/globe styles: `tz~Label,tz~Label`
* `lang` — language code for weekday/month names (default: your site language)
* `branding` — 1 or 0 (default: 1) — show the optional credit link on this embed

== External services ==

This plugin relies on an external service to render the clock widget: **Currency.Wiki**, operated by CurrencyWiki Technologies LLC.

**What the service is and what it is used for**

The clock itself is drawn by a small JavaScript widget hosted at `widget.currency.wiki`. The plugin does not bundle that script; it builds an embed URL and loads the widget from the service. This is what allows the plugin to stay small and to receive style and localization improvements without a plugin update.

**What data is sent, and when**

* **On every page view where a clock is displayed**, the visitor's browser requests the widget script from `https://widget.currency.wiki/time/v3/script.js`. That request carries the display settings you configured (style, theme, accent color, hour format, time zone or city list, language) as URL parameters, plus a `source=wp` marker indicating the request came from the WordPress plugin. As with any web request, the visitor's IP address and user agent are visible to the server.
* **No personal data is collected, and no cookies are set.** The current time is computed in the visitor's own browser from the operating system clock and the standard `Intl` time zone database — it is never requested from the server.
* **In the WordPress admin**, the settings screen makes no request to the service — it only links to the online builder. The block editor is the exception: while you are configuring a block it loads a live preview from `https://widget.currency.wiki/time/v3/embed` (flagged `preview=1` so it is not counted as a site using the widget), which sends the same display settings listed above.

**Terms and privacy**

* Terms of Service: https://currency.wiki/terms-of-service
* Privacy Policy: https://currency.wiki/privacy-policy

== Frequently Asked Questions ==

= Do I need an API key? =

No. The time is computed in the visitor's browser using the standard `Intl` timezone database. There is nothing to sign up for.

= Does it slow down my site? =

No. The widget loads asynchronously and is only a few kilobytes. It does not block page rendering.

= Does it collect any data? =

No. The widget sets no cookies and collects no personal data from your visitors. See the "External services" section above for exactly what is requested and when.

= Does it add a link to my site? =

Only a small "Powered by Currency.Wiki" credit under the clock. You can switch it off for the whole site under **World Clock → Settings**, or per embed with `branding="0"`. The widget looks and works exactly the same either way.

= Can I show several cities at once? =

Yes. Use the **World Clock** style (up to 8 cities) or the **Spinning Globe** style (up to 5 cities).

= Which timezones are supported? =

All IANA time zones (e.g. `America/New_York`, `Europe/London`, `Asia/Tokyo`).

== Screenshots ==

1. Digital and analog clock styles
2. World clock with multiple cities
3. Spinning globe with live city times
4. Gutenberg block with live preview
5. Dark theme with a custom accent color

== Changelog ==

= 1.0.0 =
* Initial release: digital, analog, world clock, spinning globe, and date card styles; Gutenberg block and `[cwiki_time]` shortcode.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
