=== GioContextAi ===
Contributors: giovannibevacqua
Tags: ai, llms.txt, seo, chatgpt, content optimization
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Open your WordPress site to AI crawlers and LLMs. Automatically generates llms.txt, llms-full.txt, and ai.txt files to feed AI models cleanly.

== Description ==

**GioContextAi** is the ultimate WordPress plugin designed to bridge your website with Artificial Intelligence crawlers, Large Language Models (LLMs), and autonomous AI agents.

As the web shifts towards AI-driven discovery, standard sitemaps aren't always enough. GioContextAi automatically structures and exposes your content through standard protocols like `llms.txt`, `llms-full.txt`, and `ai.txt`, allowing LLMs to read your pages, posts, and documentation in a clean, Markdown-friendly format without parsing messy HTML.

GioContextAi offers both a robust **Free (Lite) version** for essential AI readiness and a powerful **PRO version** for total control, custom branding, and crawler analytics.

---

## 🚀 Key Features (Free Version)

With **GioContextAi (Lite)**, your site becomes instantly ready for AI discovery:

* **Automatic llms.txt & llms-full.txt Generation:** Creates core virtual endpoint files dynamically to help AI crawlers easily discover your resources and content.
* **ai.txt Support:** Automatically serves standard bot instructions (`User-agent: *`, `Allow: /`, and sitemap reference).
* **Flexible Post Type Inclusion:** Choose which custom post types or standard posts/pages to include in your context files.
* **Smart Noindex Handling:** Automatically filters out posts and pages marked as `noindex` by major SEO plugins (Yoast, RankMath, SEOPress).
* **System Page Safeguards:** Intentionally excludes sensitive core and e-commerce system pages (such as WooCommerce Cart, Checkout, My Account, and Privacy Policy) to keep private user data safe.
* **Per-Post & Per-Term Controls:** Use built-in meta boxes to easily exclude specific pages or sections from AI context files.
* **AI Readiness Score (Preview):** Get a quick overview of your site's structural preparation for AI crawlers.

---

## 💎 GioContextAi PRO - Unlock Maximum Optimization

Upgrade to **GioContextAi PRO** to take full command over how AI models perceive your brand and content:

* **Global Brand Voice Definition:** Define your custom business tone, voice, and core identity so LLMs accurately represent your company when talking to users.
* **Custom AI Instructions:** Inject specific behavioral rules or structural guidelines directly into crawler files for advanced AI control.
* **Configurable Posts Limit:** Remove standard limits and include up to 100+ resources (or custom configurations) inside your context files.
* **Taxonomies Inclusion:** Extend your context coverage by including Categories, Tags, and Custom Taxonomies.
* **Per-Post Custom Instructions & Notes:** Add tailored guidance notes to individual pages or your front page.
* **Live Crawler Analytics & Logs:** Track visits and activities from prominent AI bots like GPTBot, ClaudeBot, and Perplexity.
* **Full AI Readiness Audit (100-point score):** Comprehensive breakdown of your site's AI optimization health with actionable improvement steps.
* **Priority Support & Updates:** Direct assistance from our expert engineering team.

---

## ⚙️ How It Works

Once installed and activated, GioContextAi handles the magic behind the scenes. It sets up clean virtual endpoints (`/llms.txt`, `/llms-full.txt`, and `/ai.txt`) natively through WordPress rewrite rules. When an AI crawler requests these URLs, the plugin compiles your published content into clean Markdown lists and feeds it securely.

*Note: If you ever encounter a 404 error on these virtual files, simply head to **Settings > Permalinks** in your dashboard and click "Save Changes" to flush the rewrite rules.*

---

== Installation ==

1. Upload the `giocontextai` folder to the `/wp-content/plugins/` directory of your WordPress site, or install it directly via the WordPress plugins upload screen.
2. Activate the **GioContextAi** plugin through the 'Plugins' menu in your WordPress dashboard.
3. Go to **Settings > GioContextAi** to configure your included post types and preview your generated files.
4. (Important) Go to **Settings > Permalinks** and click "Save Changes" once to initialize the virtual endpoint rewrite rules.

== Screenshots ==

1. Settings Page with endpoint previews and configuration options.
2. Analytics and AI Readiness Score preview dashboard.
3. Pro Features and License Management screen.
4. Per-post Meta Box settings to exclude items or add custom instructions.

== Frequently Asked Questions =

= What are llms.txt and llms-full.txt? =
They are emerging standard markdown files placed at the root of a website to provide AI models and LLMs with a clean, concise index of the site's contents and documentation, bypassing heavy HTML parsing.

= Does the plugin expose private user data or passwords? =
No. GioContextAi automatically strips password-protected posts, items marked as noindex, and sensitive e-commerce system pages (such as Cart, Checkout, and Account pages) out of the box.

= Do I need to manually create physical txt files on my server? =
No, GioContextAi generates these files dynamically and virtually on the fly, ensuring your content is always up to date without extra disk space usage.

= What should I do if the files return a 404 error? =
This happens when WordPress rewrite rules haven't refreshed yet. Simply navigate to **Settings > Permalinks** in your admin dashboard and click the **Save Changes** button.

== Changelog ==

= 1.0.0 =

* Initial release of GioContextAi Lite.
* Introduced dynamic generation of `llms.txt`, `llms-full.txt`, and `ai.txt` virtual files.
* Added automatic integration with Yoast, RankMath, and SEOPress noindex rules.
* Added built-in security filters for WooCommerce and WordPress system pages.
* Implemented per-post exclusion meta boxes.
* Added AI Readiness preview score and settings panel.