POM Cache

Changelog

Changelog

All notable changes to POM Cache are documented in this file.

Changes pending release tag

  • feat: Add opt-in HTML query variants with finite parameter values, separate cache entries, request-time expiry and PHP delivery after plugins load.

  • fix: Include approved query variants when clearing an individual HTML URL, without clearing unrelated pages or JSON.

  • docs: Document the query-variant filter, its safety limits and its distinction from ignored tracking parameters.

  • fix: Reuse canonical static HTML for Google's _gl linker URLs while preserving functional query parameters and session exclusions.

  • fix: Allow signed shared 404 generation to complete when a CDN strips custom request headers, while preserving anonymous-request and response validation.

  • feat: Show the last unsuccessful shared 404 generation result in Cache tools, including connection, response validation, and file-writing failures.

  • fix: Generate shared 404 documents at POM Translate's canonical base-language URL while preserving its public language preference and bypassing other response cookies.

  • feat: Reuse one anonymous static 404 document per site after WordPress resolves a missing page, enabled by default with HTML caching and protected from regular purges.

  • feat: Add a dedicated Delete 404 Cache settings action with independent status, safe generation, and dynamic fallback.

  • docs: Explain shared 404 generation, exclusions, HTTP status preservation, and manual regeneration.

  • docs: Document exact HTML invalidation and paired publication guard hooks for external content owners.

  • feat: Add exact HTML URL invalidation with failure reporting for externally managed content, without purging archives or JSON.

  • feat: Let content owners guard atomic HTML publication against concurrent removal.

  • fix: Calculate cache generation time without undefined array keys when the early timer is missing or uses a numeric timestamp.

  • chore: Require explicit owner approval before deleting, renaming, or moving existing documentation to preserve published URLs.

  • Changes included in version 1.0.3.

New features

  • Added targeted post-change HTML invalidation for the edited single across configured POM Translate languages while preserving the existing defaults and site-wide behavior.
  • Added a persisted early country-pricing safety gate and a web-server sentinel for universal shared WooCommerce HTML.
  • Add a request-scoped WP-CLI diagnostic that reports exact static HTML eligibility and filesystem write outcomes without requiring WordPress debug mode.

Fixed

  • Prevented WP-CLI, cron, administration, REST, and authenticated requests from promoting the persisted country-pricing cache gate without observing the public proxy path.
  • Kept shared HTML fail-closed while legacy country-pricing plugins are active and across explicit POM country-pricing rollout transitions.
  • Excluded REST, Store API, Faceted Search, country-price resolution, Composite, and AJAX commerce traffic from static HTML delivery.
  • Added conservative site-wide invalidation for country-zone configuration, regional product prices, compatibility options, plugin state, and theme changes.

Performance

  • Avoided rewriting the country-pricing web-server safety sentinel on every unchanged WordPress request.
  • Enabled one neutral product-page cache entry across country zones when the complete integration gate is safe.

Documentation

  • Documented universal country-pricing eligibility, dynamic route exclusions, Apache rules, and origin and CDN invalidation.
  • Document anonymous cache generation tracing, direct-origin requests, result interpretation, and security boundaries.
  • Add the documentation manifest that defines article order for POM Docs Sync.
  • Give every POM Cache documentation directory and article a globally unique product-scoped name and update all internal links.
  • Enforce numbered documentation topics with no root Markdown files and complete index pages for every topic directory.
  • Complete a cross-chapter review of the POM Cache manual, correcting first-hit verification, single-site guidance, navigation, CDN examples, and orphaned documentation assets.
  • Rewrite the tools, developer reference, and help chapters as distinct code-verified guides to diagnostics, public extension APIs, and safe troubleshooting.
  • Rewrite the progressive JSON and invalidation chapters as distinct runtime-verified guides to generation, layered delivery, freshness, clearing scope, multisite isolation, and CDN coordination.
  • Rewrite the Apache, WebP, compression, and CDN chapters as distinct guides with verified origin, edge, negotiation, and invalidation boundaries.
  • Rewrite the caching concepts and static HTML chapters as distinct, runtime-verified guides to request safety, generation, delivery, isolation, and diagnostics.
  • Rewrite the getting-started chapter as distinct, code-verified installation, licensing, interface, validation, and maintenance guides.
  • Add complete reader-focused cache documentation under numbered POM Docs Sync terms.
  • Clarify that public documentation must be reader-focused and exclude internal operational material.
  • Standardize numbered screenshot placeholders for public Markdown documentation.

Build

  • Preserve direct-access protection when exporting product and shared knowledge documentation.
  • Synchronize the recursive POM Knowledge Markdown tree to wp-content/docs/pom-knowledge during local release builds while excluding hidden and non-Markdown files.
  • Update POM Framework so managed file reads are cached per request and OPcache remains an optional acceleration layer.
  • Align the bundled POM Framework revision across the coordinated product releases.
  • Changes included in version 1.0.2.

Internal

  • Published a maintenance release to verify private update detection on WordPress multisite.
  • Changes included in version 1.0.1.

New features

  • Added the network-aware missing/invalid license admin notice and subscription cost info on the License tab.
  • Added the License tab to the existing settings page (Settings > POM Cache > License); license checks are admin-only and never run in advanced-cache.php, cache delivery, writes, or invalidation paths.

Fixed

  • Clarified that POM Cache uses a renewable zero-price subscription while retaining checkout, license, domain, and private-update enforcement.
  • Added the signed v2 local fallback updater and an always-visible multisite subsite message explaining the main-site requirements for automatic updates.

Documentation

  • Required complete production-facing documentation maintenance and the canonical access-denying .htaccess in repository agent guidance.
  • Replaced unauthenticated v1 release verification with a signed v2 license, domain, one-time token, and SHA-256 package check.
  • Standardized pending and historical release notes under the current categorized changelog format.
  • Updated the release procedure to require dated changelog headings.

Build

  • Centralized plugin documentation under wp-content/docs/pom-cache during local release builds and excluded the docs tree from ZIP artifacts.
  • Sourced manifest release notes from versioned changelog sections and rejected invalid changelog structures during builds.
  • Accepted mandatory ISO release dates in versioned changelog headings when generating manifests.

Internal

  • Standardized incremental changelog maintenance and required CHANGELOG.md in release packages.
  • Changes included in version 1.0.

Internal

  • Established the existing release baseline before adoption of the incremental changelog workflow.

The entries below reconstruct unversioned or previously undocumented development before this repository adopted incremental release notes. Each active month consolidates its non-merge Git commits; merge-only, version-number-only, and internal tracking-only commits are omitted.

2026-06

New features

  • Releases: added private release pipeline.

Security

  • Security: POM Framework - Harden settings AJAX and dependency toolchain.

Changed

  • Framework: POM Framework - Rename Pomatio Framework.
  • Testing: removed test infrastructure.

2026-05

New features

  • Cache: new plugin, initial commit.
  • Cache: improved htaccess rules and added AGENTS.md file.
  • Progressive archives: POM Theme and POM Cache - Add progressive JSON archive rendering.

Fixed

  • Progressive Json: POM Theme and POM Cache - Harden archive JSON rollout.
  • Progressive archives: POM Theme/POM Cache - Serve batched REST JSON payloads.
  • Cache: made automatic purges opt-in.
  • Progressive archives: POM Theme and POM Cache - Align progressive JSON rendering.
  • Pom Cache: show delete cache admin bar button on mobile.

Documentation

  • Updated AGENTS.md file.