=== iiTech Global Language & Timezone ===
Contributors: mkb23
Tags: wordpress language plugin, wordpress timezone plugin, language switcher, timezone switcher, locale manager
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

WordPress language and timezone plugin with frontend language switcher, visitor timezone detection, and per-user locale control.

== Description ==

iiTech Global Language & Timezone is a flexible and lightweight WordPress language and timezone plugin designed for websites serving a global audience.

If your visitors come from different regions or your team works across multiple timezones, accurate language and time handling is essential. This plugin gives you centralized control over WordPress locale and timezone settings — without modifying WordPress core.

Perfect for:

* International businesses  
* Multilingual WordPress websites  
* Event-based platforms  
* Global communities  
* Remote teams  
* Developers needing precise locale control  

= Core Features =

✔ Unified WordPress language and timezone settings page  
✔ Frontend language switcher (UI only)  
✔ Visitor timezone detection using modern browser APIs  
✔ Per-user admin language and timezone preferences  
✔ Timezone-aware shortcodes  
✔ Developer helper functions  
✔ Multisite support  
✔ Lightweight and WordPress standards compliant  

= Unified Settings Panel =

Manage everything from:

Settings → Locale & Timezone

Configure:

• Site Language (WordPress locale)  
• Site Timezone (uses WordPress core options)  

No core modification. No external APIs. No tracking.

= Per-User Overrides =

Users can set preferred language and timezone in their profile.

When enabled:

• Admin UI switches using switch_to_locale()  
• Admin date/time reflects user timezone  
• Falls back to site defaults when not configured  

Ideal for distributed teams working globally.

= Visitor Timezone Detection =

The plugin detects visitor timezone using the browser Intl API and stores it in a cookie.

This allows:

• Localized date and time display  
• Better global user experience  
• Accurate event scheduling  

= Shortcodes =

Display timezone-aware information anywhere:

[wpltm_time datetime="2026-02-15 10:00:00"]  
[wpltm_timezone]  
[wpltm_language_switcher]

= Developer Functions =

Available helpers:

wpltm_get_effective_timezone()  
wpltm_get_effective_locale()  
wpltm_format_datetime()

Perfect for theme and plugin integration.

= What This Plugin Does NOT Do =

• Does NOT translate post or page content  
• Does NOT override WordPress core timezone per visitor  
• Does NOT modify server timezone  
• No ads, tracking, or upsells  

== Installation ==

1. Upload the `iitech-global-language-timezone` folder to `/wp-content/plugins/`
2. Activate via the WordPress Plugins screen
3. Go to Settings → Locale & Timezone
4. Configure language and timezone preferences

== Frequently Asked Questions ==

= Does this plugin translate my content? =

No. This plugin manages WordPress language (locale) and timezone display only. For translating content, use a translation plugin such as WPML or Polylang.

= Does this change WordPress core timezone per visitor? =

No. WordPress core timezone remains unchanged. The plugin only affects how dates and times are displayed when using its shortcodes or helper functions.

= How do I display a date in the visitor’s timezone? =

Use:

[wpltm_time datetime="2026-02-15 10:00:00"]

Or in PHP:

<?php echo esc_html( wpltm_format_datetime( get_the_date( 'Y-m-d H:i:s' ) ) ); ?>

= Is this compatible with multilingual plugins? =

Yes. It works alongside major multilingual WordPress plugins.

= Does it work with WordPress Multisite? =

Yes. Network-level defaults are supported.

= Is it performance friendly? =

Yes. The plugin is lightweight, uses proper WordPress APIs, and does not load unnecessary assets.

== Screenshots ==

1. Settings → Locale & Timezone – General tab
2. User profile – Locale & Timezone preferences section
3. Frontend shortcode output example

== Changelog ==

= 1.0.1 =
* Improved visitor timezone detection accuracy
* Performance optimization for frontend language switcher
* Enhanced compatibility with multilingual plugins
* Minor UI improvements in WordPress language and timezone settings panel
* Code quality and security enhancements

= 1.1.0 =
* Added optional browser-based auto language detection with safe locale validation and fallback behavior
* Added dynamic Gutenberg block `iitech/local-time` for localized datetime rendering
* Improved timezone fallback handling with locale-to-timezone mapping when visitor detection is unavailable
* Optimized script loading and frontend inline script handling with WordPress APIs
* Added uninstall cleanup for new options and site locale setting

= 1.0.0 =
* Initial release
* Unified language and timezone management
* Per-user admin overrides
* Visitor timezone detection
* Shortcodes: [wpltm_time], [wpltm_timezone], [wpltm_language_switcher]
* Developer helper functions
* Multisite support

== Upgrade Notice ==

= 1.1.0 =
Adds auto language detection, localized time Gutenberg block, and timezone fallback improvements.

== Support ==

For support, please use the WordPress.org support forum:
https://wordpress.org/support/plugin/iitech-global-language-timezone/

== License ==

This plugin is licensed under GPL v2 or later.