=== AI VisRank WordPress JSON-LD ===
Contributors: aivisrank
Tags: json-ld, schema.org, article, webpage, faq, ai readiness, seo
Requires at least: 5.2
Tested up to: 6.9
Requires PHP: 5.6
Stable tag: 0.3.5
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds complement Schema.org JSON-LD and an admin-only AI Readiness Layer for
WordPress content pages.

== Description ==

AI VisRank WordPress JSON-LD preserves existing JSON-LD emitted by the theme,
WordPress core or SEO plugins. It reads already rendered page HTML, indexes
existing Schema.org nodes, and adds only missing entities.

The module can add:

* Organization and WebSite with SearchAction
* WebPage / CollectionPage
* Article with articleBody for published single posts
* BreadcrumbList
* ItemList for archive, blog, search and listing pages
* FAQPage from visible FAQ blocks, details, definition lists and Q/A text
* WebPageElement for visible H1/H2/H3 content sections

The admin-only AI Readiness Layer is disabled by default. When enabled, the
storefront receives only an inert loader for an authenticated administrator with
a signed 24-hour preview cookie. The visible panel is built in the browser only
after a no-store same-origin authorization check. Public visitors receive only
JSON-LD.

AI Readiness is a simple rule-based diagnostic layer:

* primary page schema
* FAQ readiness
* Brand entity
* Citation readiness
* Structured content
* Schema completeness

The result is informational. It does not guarantee AI visibility, rankings,
indexing, traffic, sales or recommendations.

== Developer and Support ==

Developed by AI VisRank service.
Website: https://aivisrank.com

License: free of charge.
Support: contact AI VisRank service.

Update manifest:
https://aivisrank.com/schema-markup-modules/manifest.json

== Compatibility Guarantee ==

The module is guaranteed to work only on a clean WordPress core installation
from WordPress 5.2 through WordPress 6.9 and PHP 5.6 through PHP 8.2 using
standard public rendering hooks.

Clean core means WordPress core without modified core files and without
conflicts introduced by third-party themes, third-party plugins, server-side
cache layers, minifiers, security filters, SEO schema rewriters, custom routing,
headless mode, or multisite-specific changes.

Compatibility outside this clean-core environment is not guaranteed.

== Liability Terms ==

The module is provided free of charge as is. AI VisRank service and the authors
are not liable for direct, indirect, incidental, special, consequential,
business, SEO, financial, reputational, data-loss, downtime, indexing, ranking,
traffic, revenue, or integration damages caused by installing, configuring,
using, updating, disabling, or removing the module.

Site owners are responsible for backups, staging tests, cache clearing and
validation of generated structured data before production use.

== Installation ==

1. Upload the plugin ZIP in WordPress Admin: Plugins -> Add New -> Upload Plugin.
2. Activate "AI VisRank WordPress JSON-LD".
3. Open AI VisRank in the WordPress admin menu.
4. Validate representative pages with a structured data validator.

== Changelog ==

= 0.3.5 =
Tightens rendered HTML parsing for mixed WordPress themes: arbitrary question-like
article headings are no longer converted into FAQPage unless there is explicit
FAQ context. Promo, subscription, giveaway and related-content headings are
filtered from WebPageElement extraction. Article schema now includes the cleaned
stored article body for single posts.

= 0.3.1 =
Settings are saved on the dedicated AI VisRank admin page through a scoped
admin-post handler. The module no longer sends administrators to the generic
WordPress options page after changing the AI Readiness Layer checkbox.

= 0.3.2 =
Makes the AI Readiness Layer cache-safe for LiteSpeed and similar page caches.
When the admin Layer setting is enabled, the page may contain only an inert
loader. Public visitors do not see the panel; the visible panel is rendered only
after the same-origin no-store endpoint confirms the administrator cookie and
capability.

= 0.3.3 =
Prevents LiteSpeed and similar optimizers from delaying the inert Layer loader
by adding no-optimize attributes. The status endpoint now authorizes through the
signed admin-preview cookie, so the frontend check does not depend on WordPress
auth-cookie path quirks.

= 0.3.4 =
Hardens admin preview cookies for WordPress installations in subdirectories.
The preview and hint cookies are issued for root, site, admin and plugin paths,
and the Layer endpoint request includes a cache-busting timestamp to avoid stale
`allowed:false` responses from page caches.

= 0.3.0 =
Rewritten by analogy with the CS-Cart AI Readiness Layer:
complement JSON-LD, final rendered HTML parsing, FAQ/WebPageElement extraction,
admin-only browser-side AI Readiness Layer, update manifest reminders and
private install telemetry.

= 0.2.0 =
Adds AI Readiness diagnostics and update manifest checks.

= 0.1.0 =
Initial public installable plugin.
