=== Kaia Counter Standard ===
Contributors: kaia-shamyue
Tags: counter, supporter, campaign, number, event
Requires at least: 6.0
Requires PHP: 7.4
Stable tag: 1.1.0
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.


== Changelog ==

= 1.1.0-dev9-ui-refine1 =
* Refines the Standard Designer workspace using WordPress-admin typography and spacing as the visual baseline.
* Aligns Preview and Custom Colors work surfaces at both top and bottom while remaining translation-safe.
* Restores Japanese gettext resources for ordinary admin/Designer UI. The linked Shortcodes block intentionally remains English.
* Preserves Kaia Memoria series metadata and CNT-22 / KS-0048 / KS-0049 socket contracts.

= 1.1.0-dev6-ui-socket =
* Added CNT-22 / KS-0049-CNT-22 shared UI color reference output.
* Resolves Standard palette, exact-color overrides, and color links before exposing the button background/text pair.


= 1.1.0-dev5-socket1 =
* Adds CNT-22 / KS-0048-CNT-22 grade-neutral Counter Shared Socket provider endpoints.
* Adds Counter Standard Registry identity block.
* Fixes the dev4 undefined admin instance variable warning.
* Keeps historical Free-named compatibility sockets unchanged for migration testing.


= 1.1.0-dev4 =
* Fresh Standard reconstruction candidate based on the current looseleaf/multi-instance foundation.
* Standard display settings are stored independently for each runtime Counter ID.
* Maximum digit count is 10 and frontend digits are forced to one row.
* Restored Standard layout controls, exact HEX colors, Link Colors, and Before/After preview.
* Restored safe Display HTML with approximately 250 visible characters plus markup overhead; simple tables are allowed.
* User images, uploaded fonts, Auto Stop end features, and arbitrary executable markup are not included.
* Standard Refill capacity, Free carry-up, locked overflow, downgrade preservation, and common Free-named sibling sockets remain in place.

=
= 1.1.0-dev3 (historical) =
* Rebased Standard on the Free 1.1.1 looseleaf/runtime foundation.
* Standard capacity: base 1 + Refill up to 15 = 16 usable sheets.
* Standard includes +3 Refill on first Standard initialization.
* Added locked Creative carryover attic up to +3 for valid over-cap Refill delivery.
* Added shared Standard Refill delivery socket for +3 / +9 / +12 products.

= 1.1.0 =
* Production package for Kaia Counter Standard.
* Registered Design Book parent KS-0050-CNT-23 and Standard branch KS-0051-CNT-23 / CNT-23.
* Standard includes one Design Book storage slot with explicit overwrite confirmation.
* Capacity display reports owned sheet entitlement; usage/materialization does not change ownership.
* Locked overflow remains hidden unless overflow exists and is displayed as current / maximum.
* Preserves CNT-22 shared sockets, resolved UI colors, native Preview sizing, and the proven sticky Preview corridor.

= 1.1.0-dev21-design-book-registry1 =
* Registered the tested Standard Design Book implementation as KS-0050-CNT-23 / CNT-23.
* No Design Book runtime/UI behavior changed from dev20.

= 1.1.0-dev20-design-book-ui1 =
* Refined ownership copy and Design Book controls/modal.

= 1.1.0-dev19-design-book1 =
* Capacity display now reports owned sheet entitlement rather than materialized sheet count.
* Removed the grade-specific normal Refill fraction from the top capacity display.
* Locked overflow is hidden normally and shown only when overflow actually exists, with an explicit bounded total.
* Replaced a stale grade-specific capacity-reached label with grade-neutral copy.
* Preserves the dev17 native Preview architecture and the proven sticky corridor unchanged.

= 1.1.0-dev12-preview-follow1 =
* Keeps the Preview outer work surface aligned with Custom Colors while allowing the actual Preview contents to follow within that surface during long color editing.
* Preserves the temporary LEGO boundary markers introduced in dev10.
