=== Tick AI SEO ===
Contributors: tick20045
Tags: ai, llm, markdown, open knowledge format, geo
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Serve your published content as a live Open Knowledge Format bundle at /okf/ for AI agents and GEO readiness.

== Description ==

Tick AI SEO publishes your WordPress content as a structured, machine-readable bundle available at `yoursite.com/okf/`. The bundle is designed for AI agents, LLM retrieval pipelines, and Generative Engine Optimisation (GEO) — not for Google Search ranking.

**Important:** OKF is NOT a Google Search ranking signal. It does not affect how Googlebot crawls or ranks your pages. Its purpose is AI-agent readiness: making your content reliably available to large language model (LLM) retrieval systems and cited in AI-generated answers.

**What the plugin does**

* Generates an OKF bundle of your published posts and pages as Markdown-formatted concept files.
* Serves the bundle live at the `/okf/` permalink (pretty URL) or via a `?okf=index.md` query fallback.
* Keeps a local concepts table (`wp_tickaiseo_concepts`) for fast serving without page-load overhead.
* Stays in sync automatically via a scheduled cron job (`tickaiseo_reconcile`).

**Content filtering**

* Respects your SEO plugin's noindex directives — noindexed content is excluded from the bundle by default.
* Drafts, private posts, password-protected pages, and trashed content are always excluded.
* Supports a per-post/page metabox toggle to exclude individual items.
* Works with **Rank Math**, **Yoast SEO**, **All in One SEO (AIOSEO)**, and **SEOPress** out of the box.

**Knowledge graph**

An interactive knowledge graph on the OKF dashboard visualises internal-link relationships between your concepts, up to a configurable node limit.

== Installation ==

1. Upload the `tick-ai-seo` folder to `/wp-content/plugins/`.
2. Activate the plugin via the **Plugins** screen.
3. Go to **Tick AI SEO → Dashboard** and click **Generate bundle now**.
4. Your bundle is live at `yoursite.com/okf/`.

Optionally, visit **Tick AI SEO → Settings** to configure included post types, excluded IDs, bundle metadata, and the graph node limit.

== Frequently Asked Questions ==

= Does this improve my Google rankings? =

No. OKF is not a Google Search ranking signal and has no effect on how Googlebot indexes your site. It is designed for AI-agent and LLM retrieval readiness (Generative Engine Optimisation), not traditional SEO.

= How do I exclude a specific page from the bundle? =

You have two options:

1. Mark the page noindex in your SEO plugin (Rank Math, Yoast, AIOSEO, or SEOPress). OKF will skip it automatically when "Skip noindexed content" is enabled.
2. Open the page editor and tick **Exclude this from the OKF bundle** in the Open Knowledge Format metabox.

You can also list specific post IDs under **Tick AI SEO → Settings → Excluded IDs**.

= Where is my OKF bundle? =

Your bundle is served at `yoursite.com/okf/` (pretty permalink) or `yoursite.com/?okf=index.md` (query fallback). Both URLs are shown on the OKF Dashboard.

= Which SEO plugins are supported? =

Rank Math, Yoast SEO, All in One SEO (AIOSEO), and SEOPress. If none of these are active, OKF falls back to a null adapter that treats all published content as indexable.

= Will my data be deleted if I uninstall the plugin? =

Yes, by default. The plugin drops the `wp_tickaiseo_concepts` table and removes its options on uninstall. If you want to keep your data, enable **Keep data when uninstalling** under **Tick AI SEO → Settings → Advanced** before uninstalling.

== Privacy ==

Tick AI SEO is privacy-respecting and does not phone home. It collects no telemetry and sends no data to the plugin author.

* **Request analytics** are optional (off by default) and stored only in your own database — nothing is sent externally.
* **Webhooks** are optional: only when you set a webhook URL does the plugin POST a small JSON payload (bundle counts and your site's bundle URL) to *your* chosen endpoint when the bundle changes. No webhook fires unless you configure one.
* The bundle is generated entirely on your own server. The only bundled third-party library is league/html-to-markdown (MIT licensed).

== Screenshots ==

1. The Tick AI SEO dashboard: bundle status, content metrics, serving status, and the interactive knowledge graph of internal links between your concepts.
2. The settings screen: choose which post types and content are included in the OKF bundle, set bundle metadata, and configure the knowledge graph and uninstall behaviour.

== Changelog ==

= 0.1.0 =
* Initial release.
* Live OKF bundle served at `/okf/` with pretty-permalink and query-string fallback.
* Automatic sync via scheduled cron with inclusion/exclusion rules.
* SEO-plugin awareness: Rank Math, Yoast SEO, AIOSEO, SEOPress (noindex respected).
* Per-post metabox toggle to exclude individual items.
* Admin dashboard with concept counts, serving URLs, SEO integration status, and an interactive knowledge graph.
* Settings screen: included post types, excluded IDs, bundle metadata, graph node limit, keep-data-on-uninstall option.
