=== Kaia Timestamp Free ===
Contributors: kaia-shamyue
Tags: timestamp, time zone, pdf, record, shortcode
Requires at least: 6.0
Requires PHP: 7.4
Stable tag: 1.0.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A lightweight visitor-local timestamp component for WordPress, designed to work independently or as a data source for compatible Kaia Spec plugins.

== Description ==

Kaia Timestamp Free records a visitor-local first timestamp when the component is first loaded and allows one replaceable button-press timestamp during a 10-hour recording window. Each timestamp keeps the browser-reported IANA time zone.

== Features ==

* Visitor-local timestamp format: `YYYY.MM.DD HH:MM:SS`
* Browser-reported IANA time zone stored with each timestamp
* First timestamp preserved during the active local record
* One replaceable button-press timestamp
* Radio-button selection between the recorded values
* 10-hour window for recording new button-press timestamps
* Reload-resistant local state in the same browser
* Standalone shortcode: `[kaia_timestamp]`
* Integration surface for compatible Kaia Spec plugins
* WordPress gettext internationalization support
* Record-button color picker with automatic readable black/white text color
* Responsive button/label handling for longer translated text

== Important Notes ==

* The time zone is reported by the visitor's browser/device. It is not location verification.
* Browser-local storage preserves timestamp state. Clearing site data, changing browser/profile/device, or privacy restrictions can remove or prevent that local state.
* Kaia Timestamp Free records time information; it is not an identity, location, ownership, or legal-certification system.

== Installation ==

1. Install and activate Kaia Timestamp Free.
2. Open Settings > Kaia Timestamp.
3. Copy the shortcode `[kaia_timestamp]`.
4. Place the shortcode in a supported WordPress content area.

== How To ==

The plugin settings include a link to the Kaia Timestamp Guide:
https://www.kaiaspec.com/kaia-timestamp-guide/

== Internationalization ==

* Text domain: `kaia-timestamp`
* Domain path: `/languages`
* English is the source language and fallback.
* A Japanese translation is bundled.
* `languages/kaia-timestamp.pot` is included for additional locale packs.
* Timestamp formatting and IANA time-zone identifiers are data formats and are not translated.

== Upgrade Path ==

Kaia Timestamp Free is the base edition of the Kaia Timestamp product line. Higher editions are designed as in-place upgrades using the same plugin identity.

== License ==

Kaia Timestamp Free is distributed under the GNU General Public License, version 2 or later.

Copyright (C) 2026 Kaia & Shamyue

== Changelog ==

= 1.0.6 =
* Added Serial to Related Shortcodes: `[kaia_serial id="N"]`, completing the shared four-shortcode set.
* Preserved the existing Free behavior and read-only RECORD-button palette linking to the matching Kaia Counter Refill.

= 1.0.5 =
* Added shared runtime ID support with `[kaia_timestamp id="N"]`.
* Added Binder / Refill context and Related Shortcodes when Kaia Counter is active.
* Isolated browser timestamp storage and per-Refill Timestamp settings by runtime ID while preserving standalone ID 1.
* Linked the RECORD button color read-only to the matching Kaia Counter Refill palette, with standalone fallback when Counter is unavailable.

= 1.0.4 =
* Final packaging audit: synchronized internal version metadata and translation headers.
* Preserved multilingual responsive button/label handling.

= 1.0.3 =
* Added responsive handling for longer translated button and label text.

= 1.0.2 =
* Rebuilt the Japanese translation catalog for the button-color settings.

= 1.0.1 =
* Added the record-button color picker and automatic readable text color.
* Added Kaia Timestamp product icons.

= 1.0.0 =
* First product-ready Free build.
