=== LLMs.txt Builder ===
Contributors: nutttaro
Donate link: https://buymeacoffee.com/nutttaro
Tags: llms, ai, seo, sitemap, content-discovery
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Generate an LLMs.txt file that helps AI models and large language models understand your WordPress website structure and content.

== Description ==

**LLMs.txt Builder** creates spec-compliant `/llms.txt` and `/llms-full.txt` endpoints (similar to robots.txt) that help AI models and large language models (LLMs) understand your website structure and content. The standard endpoint lists all published content with titles and URLs; the full variant adds post excerpts for richer context.

= Key Features =

* **Two Endpoints**: `/llms.txt` (titles + URLs) and `/llms-full.txt` (titles + URLs + excerpts)
* **Post and Page Support**: Automatically includes pages, posts, categories, and tags
* **WooCommerce Support**: Automatically includes product pages, categories, and tags
* **Custom Post Types**: Configurable support for any custom post types
* **Custom Taxonomies**: Includes all public taxonomies and their terms
* **Block Editor Support**: Native sidebar panel in the block editor; classic meta box fallback for the classic editor
* **Admin Settings Page**: Easy configuration with live preview through WordPress admin
* **Caching System**: LLMs.txt content is cached for 24 hours with automatic invalidation on content changes
* **WordPress 7.0 Abilities API**: Registers llms.txt as a discoverable ability for AI agents (backward-compatible with older WordPress versions)

= What is LLMs.txt? =

LLMs.txt is a file format designed to help AI models and large language models understand how to interact with your codebase more effectively. It's similar in concept to `robots.txt` for web crawlers, but specifically for AI assistants.

The file provides context and instructions to AI models about your project, helping them:

* Understand your project structure and conventions
* Know which files are important vs. generated/ignored
* Follow your coding standards and patterns
* Understand the purpose and architecture of your codebase
* Provide more relevant and contextual assistance

= WooCommerce Integration =

When WooCommerce is active, the plugin automatically includes:

* **Product Pages**: All published products
* **Product Categories**: All product category pages
* **Product Tags**: All product tag pages
* **Shop Page**: The main WooCommerce shop page

= Custom Post Types and Taxonomies =

The plugin automatically detects and allows configuration for:

* All public post types (excluding attachments)
* All public taxonomies
* Custom post types and taxonomies from other plugins

= Caching =

The LLMs.txt content is cached for 24 hours by default. This improves performance and reduces server load. The cache is automatically cleared when:

* Plugin settings are updated
* A post with cache clearing enabled is updated
* Manual cache clearing is triggered

== Installation ==

1. Upload the `nt-llms-txt-builder` folder to your `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to Settings > LLMs.txt Builder to configure the plugin

== Frequently Asked Questions ==

= What is LLMs.txt? =

LLMs.txt is a file format designed to help AI models and large language models understand your website structure and content. It's similar to robots.txt but specifically for AI assistants.

= Where can I find my LLMs.txt file? =

Once activated, your LLMs.txt file will be available at `https://yourdomain.com/llms.txt`

= Does this plugin work with WooCommerce? =

Yes! The plugin automatically detects WooCommerce and includes all products, product categories, and product tags in the LLMs.txt file.

= Can I customize which content is included? =

Yes! Go to Settings > LLMs.txt Builder to configure which post types, taxonomies, pages, and archives are included in your LLMs.txt file.

= How often is the LLMs.txt file updated? =

The content is cached for 24 hours by default. You can manually regenerate it anytime from the settings page, or it will automatically update when you modify the plugin settings.

= Does this affect my website's performance? =

No, the plugin uses efficient caching and only generates content when needed. The LLMs.txt file is served as a static text file.

= Can I clear the cache manually? =

Yes! There's a "Clear Cache" button in the plugin settings page, and you can also set individual posts to clear the cache when they're updated.

== Screenshots ==

1. Plugin settings page showing configuration options
2. Example LLMs.txt output in browser
3. Meta box on post edit screen for cache management

== Changelog ==

= 1.2.0 =
* New: WordPress 7.0 compatibility — tested up to 7.0
* New: Block editor sidebar panel (PluginDocumentSettingPanel) replaces classic meta box in Gutenberg, preserving collaboration mode
* New: Post meta registered with REST API (show_in_rest) for block editor support
* New: Classic meta box kept as fallback for the classic editor via __back_compat_meta_box
* New: WordPress 7.0 Abilities API integration — registers llms.txt content as a discoverable ability for AI agents (backward-compatible with WP < 7.0)
* Fix: Cache action button icons not vertically aligned with text
* Fix: Uninstall now cleans up per-post meta from wp_postmeta

= 1.1.0 =
* New: llms.txt spec-compliant output with markdown titles and links
* New: /llms-full.txt endpoint with post excerpts
* New: Rewrite rules replace REQUEST_URI check for better performance
* New: Auto-invalidate cache when tracked posts or terms change
* New: Redesigned settings page with card layout, live preview panel, and cache status indicator
* New: Copy-to-clipboard buttons for endpoint URLs
* New: Select All / None toggles for post type and taxonomy checkboxes
* New: Permalink flush detection with guidance notice on fresh installs
* New: PHPUnit test infrastructure with content generation and cache invalidation tests
* Fix: Cache duration documented as 1 hour but was 24 hours — README corrected
* Fix: Regenerate button showing [object Object] instead of success message
* Fix: Live preview not loading due to cached old JavaScript
* Fix: Endpoint action button icons not vertically centered
* Fix: Content Selection checkboxes styled as clean bordered list with item counts
* Fix: Asset versioning uses filemtime for automatic cache busting
* Fix: Tested up to bumped to WordPress 6.9
* Fix: Plugin check issues — translators comments, test bootstrap prefixing, .distignore

= 1.0.0 =
* Initial release
* Basic LLMs.txt generation
* WooCommerce support
* Admin settings page
* Caching system
* Meta box integration
* Custom post types and taxonomies support
* AJAX-powered generation and cache clearing

== Upgrade Notice ==

= 1.2.0 =
WordPress 7.0 support: block editor sidebar panel replaces classic meta box (classic editor still supported), Abilities API integration for AI agent discoverability.

= 1.1.0 =
Major update: spec-compliant output, /llms-full.txt endpoint, redesigned settings UI with live preview, auto-cache invalidation, and rewrite rules for better performance. Visit Settings > Permalinks and click Save after updating.

= 1.0.0 =
Initial release of NT LLMs.txt Builder plugin.

== Requirements ==

* WordPress 6.0 or higher
* PHP 7.4 or higher
* WooCommerce 3.0 or higher (for WooCommerce features)

== Support ==

For support, feature requests, or bug reports, please contact the developer.

== Credits ==

Developed for the WordPress community to help AI models better understand website content and structure.

== License ==

This plugin is licensed under the GPL v2 or later.
