=== Basis LLMs.txt File Generator ===
Contributors: roehler
Tags: llm, ai, content, generator, machine-learning
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Author: roehler
Author URI: https://www.roehler.nrw

Generates and maintains an llms.txt file for AI training data documentation following the llms.txt specification.

== Description ==

A comprehensive WordPress plugin that generates and maintains an `llms.txt` file for your website, following the [llms.txt specification](https://llmstxt.org/) for AI training data documentation.

= Features =

= Core Functionality =
- **Automatic llms.txt Generation**: Creates and maintains an `llms.txt` file in your website's root directory
- **llms.txt Specification Compliance**: Follows the official llms.txt format for AI training data documentation
- **Dynamic Content Updates**: Automatically updates the file when content changes (configurable)
- **URL Rewriting**: Serves llms.txt content via `/llms.txt` URL with proper headers

= Admin Interface =
* Comprehensive Settings Page: Easy-to-use admin interface in WordPress dashboard
* File Status Display: Shows current file status, size, last modified date, and generation timestamp
* Content Configuration: Select which post types, taxonomies, and metadata to include
* Real-time Preview: View your current llms.txt file directly from the admin interface

= Content Management =
* Post Type Selection: Choose which post types to include (posts, pages, custom post types)
* Taxonomy Integration: Include categories, tags, and custom taxonomies
* Content Filtering: Configure publication status, date ranges, and content limits
* Metadata Options: Include/exclude author information, publish dates, excerpts, etc.
* Content Limits: Set maximum posts per type and word limits for excerpts

= Cache Management =
* Performance Optimization: Built-in caching system for improved performance
* Configurable Cache Duration: Set custom cache expiration times
* Manual Cache Control: Refresh or clear cache on demand
* Cache Status Monitoring: View cache size, age, and status in admin interface

= Technical Features =
* WordPress Standards Compliance: Follows WordPress coding standards and best practices
* Security First: Proper input sanitization, validation, and nonce verification
* Extensible Architecture: Hooks and filters for developers to extend functionality
* Multisite Compatible: Works with WordPress multisite installations
* Clean Uninstall: Removes all data and files when plugin is deleted

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`
2. Or install via WordPress admin: Plugins → Add New → Upload Plugin
3. Go to Plugins in your WordPress admin
4. Find "LLMs TXT File Generator" and click "Activate"
5. Navigate to Settings → LLMs TXT File Generator
6. Configure your content preferences
7. Save settings to generate your first llms.txt file

== Configuration ==

= Content Settings =

* Post Types: Select which post types to include in your llms.txt file
* Content Options: Configure maximum posts per type, excerpt length, meta information
* Update Frequency: Choose immediate, hourly, daily, or manual updates
* Cache Management: Enable caching, set duration, and monitor cache status

== Usage ==

Once configured, your llms.txt file will be available at: `https://yourwebsite.com/llms.txt`

= Sample Output =

```markdown
# My WordPress Website

> A comprehensive blog about web development, WordPress tutorials, and digital marketing strategies.

This WordPress website contains the following types of content:

- Posts: 150 published items
- Pages: 25 published items
- Portfolio: 12 published items

## Posts

- [Getting Started with WordPress Development](https://yoursite.com/getting-started-wordpress-development?format=md): A comprehensive guide for beginners looking to start developing with WordPress...
- [Advanced Custom Fields Tutorial](https://yoursite.com/advanced-custom-fields-tutorial?format=md): Learn how to use ACF to create custom content types and fields...
- [WordPress Security Best Practices](https://yoursite.com/wordpress-security-best-practices?format=md): Essential security measures every WordPress site owner should implement...

## Pages

- [About Us](https://yoursite.com/about?format=md): Learn about our company history, mission, and team...
- [Services](https://yoursite.com/services?format=md): Comprehensive overview of our web development and consulting services...
- [Contact](https://yoursite.com/contact?format=md): Get in touch with our team for project inquiries...

## Optional

- [Categories](https://yoursite.com/category/): Available categories and tags
- [Tags](https://yoursite.com/tag/): Available categories and tags
```

== Frequently Asked Questions ==

= What is llms.txt? =
llms.txt is a proposed standard for providing LLM-friendly content from websites. It helps AI models understand and use your website's content more effectively.

= Will this affect my website's performance? =
No, the plugin includes built-in caching and is designed for minimal performance impact. The llms.txt file is generated in the background and cached for fast delivery.

= Can I customize what content is included? =
Yes, the plugin provides extensive customization options for post types, taxonomies, metadata, and content limits.

= Is the plugin secure? =
Yes, the plugin follows WordPress security best practices with proper sanitization, validation, and permission checks.

= What happens when I deactivate the plugin? =
The llms.txt file remains but won't be updated. When you delete the plugin, all data and files are completely removed.

== Developer Information ==

The plugin provides several hooks for developers:

= Actions =
* `llms_txt_file_generator_before_generate` - Before llms.txt content is generated
* `llms_txt_file_generator_after_generate` - After llms.txt content is generated
* `llms_txt_file_generator_before_cache_clear` - Before cache is cleared

= Filters =
* `llms_txt_file_generator_content` - Modify llms.txt content before output
* `llms_txt_file_generator_post_entry` - Modify post entry format
* `llms_txt_file_generator_cache_duration` - Modify cache duration

== Changelog ==

= 1.0.0 =
* Initial release
* Core llms.txt generation functionality
* Admin settings interface
* Cache management system
* WordPress hooks and filters
* Complete uninstall cleanup
