=== 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.3
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 recorded timestamp keeps the browser-reported IANA time zone, such as `Asia/Tokyo` or `America/New_York`.

The visitor can choose the first timestamp or the latest button-press timestamp. The selected timestamp and time zone are exposed through a small integration surface for compatible Kaia Spec plugins.

== Features ==

* Visitor-local timestamp format: `YYYY.MM.DD HH:MM:SS`
* Browser-reported IANA time zone stored with each timestamp
* First timestamp is preserved during the active local record
* One replaceable button-press timestamp
* Radio-button selection between the two 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

== Important Notes ==

* The time zone is reported by the visitor's browser/device. It is not location verification.
* Browser-local storage is used to preserve the timestamp state. Clearing site data, using another browser/profile/device, or browser 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 the page, post, or other supported WordPress content area where the timestamp should appear.

== How To ==

The plugin settings include a link to the Kaia Timestamp Guide:

https://www.kaiaspec.com/kaia-timestamp-guide/

The guide is maintained separately from the plugin so that instructions can be updated without requiring a plugin release.

== Support ==

Please check the Kaia Timestamp Guide first. If the guide does not resolve the problem, use the Kaia Spec Support page.

== 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 as the canonical translation template for additional locale packs.
* Timestamp formatting and IANA time-zone identifiers are data formats and are not translated.

== Upgrade Path ==

Kaia Timestamp Free is designed as the Free edition of the Kaia Timestamp product line. Future editions may add presentation controls while preserving the timestamp component's focused role.

== License ==

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

Copyright (C) 2026 Kaia & Shamyue

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

== Changelog ==

= 1.0.1 =
* Added a WordPress color picker for the record-button background.
* Added automatic black/white button-text selection based on contrast.
* Added Kaia Timestamp product icons.

= 1.0.0 =
* First product-ready Free build.
* Added browser-reported IANA time-zone capture for first and button-press timestamps.
* Added WordPress gettext internationalization structure and bundled Japanese translation.
* Fixed the permanent plugin directory/main-file identity for future in-place updates.
* Added settings-page shortcut, shortcode copy control, and Kaia Timestamp Guide link.
* Preserved the tested first/button selection, 10-hour recording window, and reload-resistant local state.
