Spintax

Changelog

1.5.0

• Add: plural agreement primitive {plural <count>: form1|form2|form3} — pick the correct grammatical form by count. RU/UK/BE = 3 forms (one|few|many); EN/ES/PT/DE etc. = 2 forms (one|many). Count is a %var% reference or literal integer (resolved after variable expansion, so helper-var patterns via #set work). Locale comes from per-template post meta _spintax_locale or the WordPress site locale. Lenient at runtime: malformed constructs render verbatim with fullwidth braces instead of crashing the page. First spintax engine to treat plural as a first-class primitive.
• Add: validator surface for plural blocks — structural check (form slot rejects nested {}, []) always on; arity check (RU expects 3, EN expects 2) when locale is known.
• Internal: 74 PHPUnit cases mirroring the canonical TS implementation (spintax-plurals.test.ts in casino-platform). Engine classes Plurals, PluralArityError, PluralFormError ship alongside Conditionals from 1.4.0.

1.4.0

• Add: conditional syntax {?VAR?then|else} — render a branch based on whether a variable is set/non-empty (also {?!VAR?then} for inverted, optional else). Resolves both before and after %var% expansion, so conditionals inside variable values work too.
• Add: single-token abbreviation whitelist in post-processing — known shorthands like соц., эл., Mr., Inc. no longer trigger sentence-end capitalisation of the next word. Covers Russian editorial/address/unit shorthands plus English titles and business suffixes.
• Fix: #set directive with an empty value (#set %x% =) no longer silently swallows the next directive on the following line.
• Fix: HTML start tags inside permutation alternatives (e.g. [<li>item</li>|<li>...]) are no longer mis-parsed as a <config> block.
• Improve: cache description in template meta box and global settings now explains that visitors see the same generated variant per runtime context until expiry or regeneration.
• Internal: regression tests for IDN domains flanked by Cyrillic letters and for randomisation behaviour across renders.

1.1.0

• Add: per-element permutation separators — assign custom separator to each element via < sep > before |
• Add: auto-spacing for purely alphabetic word separators (e.g. <and>, <или>)
• Security: sanitize raw spintax input with custom sanitize_spintax() — strips invalid UTF-8, null bytes, and control characters while preserving angle-bracket syntax

1.0.1

• Fix: permutation minsize/maxsize logic when only one parameter is specified
• Fix: preview rendering no longer strips spintax config from template input
• Fix: child templates no longer inherit parent’s local #set variables
• Improve: global variables editor now uses #set textarea (paste full blocks)
• Improve: validation errors displayed on template edit screen with line numbers
• Improve: “Regenerate Public Cache” now forces fresh subtree render
• Add: demo template created on first activation
• Add: SECURITY.md with responsible disclosure policy
• Add: Privacy Policy and External Services sections in readme.txt
• Code: PHPCS 0 errors, full WP.org review compliance

1.0.0

• Initial release
• GTW-compatible spintax engine with nested enumerations and permutations
• Template CPT with code editor and admin preview
• Shortcode and PHP rendering API
• Object cache with versioned keys and cascade invalidation
• Per-template cron regeneration
• Global and local variable scopes
• Settings page with global variables editor