=== Global Time Ghost – Local Time Converter ===
Contributors: aacers
Donate link:       https://pluginjoy.com/product/global-time-ghost-pro/
Tags: scheduled posts, post scheduling, future posts, content calendar, editorial calendar, time zone, multi timezone, recurring posts, content automation
Requires at least: 5.8
Tested up to:      6.9
Stable tag: 2.5.2
Requires PHP:      7.4
License:           GPLv2 or later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Show every visitor your event, sale and deadline times in their own timezone — automatically. Works with all caches & CDNs. Gutenberg block + shortcode. ~4 KB.

== Description ==

The lightest, fastest and most beautiful local-time plugin for WordPress. Drop one shortcode and every visitor instantly sees your dates in **their own timezone** — including automatic daylight-saving handling.

`[gtg_time date="2025-12-25 15:00:00"]` → December 25, 2025 at 3:00 PM (their local time)
`[gtg_time date="2025-08-20 14:00:00" format="g:i A (T)"]` → 4:00 PM (CEST)

= Perfect for =

* Flash sales & limited offers
* Webinars & live streams
* Course launches
* Event sites
* Global WooCommerce stores
* Webinar landing pages

= Free features (everything you need to get started) =

* `[gtg_time]` and `[local_time]` shortcodes
* Full Gutenberg block ("Local Time")
* Beautiful purple badge with hover effect (or plain text)
* Automatic timezone detection via the browser (Intl API + cookie)
* Real conversion + unique-timezone stats on the admin dashboard
* Works perfectly with WP Rocket, LiteSpeed, Cloudflare, SiteGround, Kinsta — all caches & CDNs
* No JavaScript loaded on pages without the shortcode (~4 KB total)
* Zero configuration — works out of the box

= Pro version — premium AI included =

[Global Time Ghost Pro](https://pluginjoy.com/product/global-time-ghost-pro/) builds on the free plugin with AI-powered scheduling and deep WooCommerce / Events Calendar / LearnDash integration.

* **AI Optimal Posting Times** — per-timezone publish recommendations (powered by Claude Sonnet 4.6)
* **AI Smart Scheduling** — auto-schedule posts at the right local time for each region
* **AI Multi-Region Variants** — region-aware copy generation for sales, events and webinars
* **WooCommerce auto-convert** — order, sale and deadline times in every visitor's clock
* **The Events Calendar + LearnDash** — full auto-conversion across event and course pages
* **Custom badge colors** + **timezone dropdown widget** + **conversion analytics**
* **Premium AI credits** included with every Pro plan (50 / 200 / 1000 per month). Credits are shared with [SiteFix Pro](https://wordpress.org/plugins/a11y-enhancer/) and [Clarity SEO Pro](https://wordpress.org/plugins/clarity-seo/).
* **Priority support** — 24-hour response on business days
* **30-day money-back guarantee**

[View Pro Features & Pricing →](https://pluginjoy.com/product/global-time-ghost-pro/)

== Installation ==

1. Upload to `/wp-content/plugins/` or install via WordPress.
2. Activate the plugin.
3. Drop `[gtg_time date="2025-12-25 15:00:00"]` anywhere in your content, or use the "Local Time" Gutenberg block.
4. Done. No settings required.

== Frequently Asked Questions ==

= Does this work with page caching? =

Yes — Global Time Ghost was built specifically for cached sites. Times are rendered on the server in UTC, then localised in the visitor's browser via a tiny JavaScript snippet (~4 KB) and a cookie. WP Rocket, LiteSpeed, Cloudflare, SiteGround, Kinsta — all work flawlessly.

= Does it handle daylight saving time? =

Yes. The browser reports the IANA timezone (e.g. `Europe/Amsterdam`) and PHP's `DateTimeZone` handles the DST math automatically.

= Will visitors see the wrong time on the first page load? =

No. The first render uses UTC; once the timezone cookie is set the displayed time updates instantly. Most users never notice — and the badge degrades gracefully even with JavaScript disabled.

= How do I display only the time, not the date? =

Use the `format` attribute: `[gtg_time date="2025-08-20 14:00:00" format="g:i A"]`

= Does it support The Events Calendar / WooCommerce / LearnDash? =

Auto-conversion of plugin-managed dates (Events Calendar, WooCommerce, LearnDash, EDD) is a Pro feature. The free plugin works on any date you pass to the shortcode or block.

= Where is my data stored? =

Locally — only the visitor's selected timezone is stored, and only in a first-party cookie (`gtg_user_tz`). Conversion counts are stored as anonymous totals in the WordPress options table. Nothing is sent to PluginJoy.

= How do I remove the badge styling? =

Add `style="plain"` to the shortcode: `[gtg_time date="2025-08-20 14:00:00" style="plain"]`

== Screenshots ==

1. Beautiful purple badge with hover effect — works anywhere on your site.
2. Modern admin dashboard with real conversion stats.
3. Gutenberg "Local Time" block — full visual editor support.
4. Pro: per-timezone optimal posting times powered by Claude Sonnet 4.6.

== Changelog ==

= 2.5.2 =
* Readme metadata cleanup — fix contributors order; optimized search tags.

= 2.5.1 =
* Hotfix: align readme Stable tag with main PHP Version header.

= 2.4.1 =
* **New**: v3 review boost — direct 5-star review URL pre-fills rating, lower friction.
* **New**: Subtle review prompt on the post-edit screen — most users live in Gutenberg, not on plugin admin pages.
* **New**: \`gtg_user_won\` action hook — fires the review prompt immediately after a real success event.
* **Improved**: Activation time backfill so older installs see the prompt instead of waiting another 7 days.

= 2.4.0 =
* New: Real conversion + unique-timezone tracking on the admin dashboard (replaces the placeholder counters).
* New: 5-star review reminder banner — appears once after 7 days, fully dismissable, with "I already reviewed" option.
* New: "Get Pro" link added to the plugins-page action row.
* Updated: Pro upsell card refreshed with the new subscription model and AI features (replaces the legacy lifetime $39 messaging).
* Updated: readme refreshed for Pro Subscription + Premium AI credits + shared-pool messaging across SiteFix Pro / Clarity SEO Pro.
* Tested up to WordPress 6.9.

= 2.3.0 =
* Performance: ~4 KB total payload, only loaded on pages that use the shortcode or block.
* Improved: badge hover effect.
* Improved: cache + CDN compatibility (WP Rocket, LiteSpeed, Cloudflare, SiteGround, Kinsta).

= 2.2.0 =
* Added: Gutenberg "Local Time" block.
* Improved: shortcode parsing.

== Upgrade Notice ==

= 2.4.0 =
Real conversion stats + dismissable review reminder + refreshed Pro upsell. Safe upgrade — no breaking changes.
