=== Kaia Counter Standard ===
Contributors: kaia-shamyue
Tags: counter, supporter, campaign, number, event
Requires at least: 6.0
Requires PHP: 7.4
Stable tag: 1.0.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A customizable WordPress counter for supporter numbers, campaigns, events, and limited rewards.

== Description ==

Kaia Counter Standard is the standard edition of the Kaia Counter product line.

It is designed for people who want a normal, slightly more customized counter without commissioning a custom plugin.

== Standard Features ==

* Font preset selection
* Digit count: 1–10
* Adjustable lock time: 1–10,080 minutes
* Overall size: 50–200%
* Border width, style, and color
* Digit box radius
* Digit gap
* Inner padding
* Button width and height
* Button radius
* Digit placement
* Custom color controls with linked color groups
* Suggested matching colors are generated from the selected color.
* Selecting a palette loads its exact intended colors before any Standard fine-tuning.
* Linked groups preserve role-specific shades instead of forcing identical colors.
* Standard uses visual palette and suggested-color selection only; direct numeric color entry is reserved for Custom.
* Live preview with before/after issue states
* Live preview with all editable text fields
* Display HTML is included in the live preview
* Limited display-only HTML
* Shortcode: `[kaia_counter]`

== Display HTML ==

The Standard edition provides a small display-only HTML field for supplementary text and links.

== Color Customization ==

Standard keeps the ready-made palette system and adds manual color customization.

* Accent colors can be linked together by default for a coherent design.
* Surface colors can be linked together by default.
* Selecting a palette reloads its full intended color set before manual customization.
* Success background and success text remain independent to preserve contrast.
* Unlink a group when you want its colors to be changed independently.
* Button text and muted text remain independently adjustable.

* Maximum: 250 input characters
* Links are allowed
* Basic text formatting is allowed
* Line breaks and paragraphs are allowed
* Images are not allowed
* CSS is not allowed
* JavaScript and scripts are not allowed
* Forms and embeds / iframes are not allowed
* Event handlers are not allowed
* The HTML field does not control counter issuance, numbers, locking, or counter state

Advanced images, custom CSS, advanced HTML structures, and campaign automation are reserved for the Custom edition.

== Upgrade from Free ==

Standard is designed as a direct upgrade from Kaia Counter Free.

* Existing `[kaia_counter]` shortcodes remain valid.
* Existing Free text and palette settings are retained.
* Existing counter value is retained.
* Existing issue history is retained.
* Existing lock state continues from the same counter history.
* Existing pages do not need to be rebuilt just because the edition is upgraded.

Standard adds its additional customization controls on top of the existing counter.

== Installation ==

1. Install and activate Kaia Counter Standard.
2. Open the plugin's settings page.
3. Configure the available Standard options.
4. If upgrading from Free, existing `[kaia_counter]` shortcodes can continue to be used.
5. Place the shortcode in the page, post, or other supported WordPress content area where the counter should appear.

== How To ==

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

https://www.kaiaspec.com/kaiacounter/

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

== Support ==

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

== Product Line ==

Kaia Counter is provided in three editions:

* Free — simple counter use with basic text and color customization
* Standard — normal customization for people who want a slightly more elaborate counter
* Custom — advanced customization and campaign-specific functionality

== License ==

Kaia Counter Standard 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. See the GNU General Public License for more details.

== 1.0.1 ==

* Admin live preview now caps visual enlargement at 125% so 150–200% live sizes do not over-expand the settings screen. The actual counter still uses the configured 50–200% size.

== 1.0.2 ==

* Admin preview width is now capped at 560px on wide screens so the Preview column cannot stretch across spare admin-screen space.
* Preview content is constrained to the preview column and wraps instead of forcing the grid wider.
* The live counter size setting is unchanged and still supports 50–200%.

== 1.0.4 — WordPress i18n ==

* Fixed settings-screen UI uses the WordPress gettext internationalization API.
* Text domain: kaia-counter
* Domain path: /languages
* No Japanese-only DOM/JavaScript replacement layer is used.
* Bundled Japanese translation follows the current WordPress admin locale automatically.
* Unsupported/unbundled locales fall back to the English source strings.
* languages/kaia-counter.pot is included as the canonical translation template for additional locale packs.
* User-entered counter content is not automatically translated.

== 1.0.5 — responsive digit-row fix ==

* Keeps 1–10 digit boxes on one line without wrapping.
* Digit boxes shrink evenly when the available counter width is narrow.
* Digit-gap spacing also contracts on narrow layouts instead of forcing overflow.
* Mobile no longer reintroduces a hard 30px minimum digit width.
* The settings-page live preview follows the same no-wrap behavior.
* Repairs the preview button maxWidth JavaScript identifier damaged by an earlier translation conversion.
