> ## Documentation Index
> Fetch the complete documentation index at: https://docs.llmtag.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation Guide

> Complete installation guide for the LLMTAG - AI Bot Protection WordPress plugin

## Overview

The **LLMTAG - AI Bot Protection** plugin is the premier WordPress implementation of the LLMTAG protocol. It provides comprehensive AI protection through both passive declaration (llmtag.txt) and active blocking of AI agents.

<Card title="Plugin Features" icon="star" horizontal>
  **60+ AI agents blocked** • **Automatic llmtag.txt generation** • **Real-time analytics** • **Granular protection modes** • **Developer API**
</Card>

## System Requirements

### WordPress Requirements

* **WordPress Version**: 5.0 or higher
* **PHP Version**: 7.4 or higher
* **MySQL Version**: 5.6 or higher

### Server Requirements

* **Memory**: 128MB minimum (256MB recommended)
* **Disk Space**: 10MB for plugin files
* **Web Server**: Apache or Nginx
* **SSL Certificate**: Recommended for security

<Info>
  The plugin is designed to work with all major WordPress hosting providers and is optimized for performance.
</Info>

## Installation Methods

### Method 1: WordPress Admin (Recommended)

<Steps>
  <Step title="Access WordPress Admin">
    Log into your WordPress admin dashboard and navigate to **Plugins > Add New**.
  </Step>

  <Step title="Search for the Plugin">
    In the search box, type "LLMTAG" or "AI Bot Protection" and press Enter.
  </Step>

  <Step title="Install the Plugin">
    Click **Install Now** next to "LLMTAG - AI Bot Protection" in the search results.
  </Step>

  <Step title="Activate the Plugin">
    After installation, click **Activate** to enable the plugin.
  </Step>
</Steps>

### Method 2: Manual Upload

<Steps>
  <Step title="Download the Plugin">
    Download the plugin ZIP file from the WordPress.org repository or our website.
  </Step>

  <Step title="Access WordPress Admin">
    Log into your WordPress admin dashboard and navigate to **Plugins > Add New**.
  </Step>

  <Step title="Upload the Plugin">
    Click **Upload Plugin** and select the downloaded ZIP file.
  </Step>

  <Step title="Install and Activate">
    Click **Install Now** and then **Activate Plugin**.
  </Step>
</Steps>

### Method 3: FTP Upload

<Steps>
  <Step title="Download and Extract">
    Download the plugin ZIP file and extract it to your local computer.
  </Step>

  <Step title="Connect via FTP">
    Connect to your website using an FTP client (FileZilla, WinSCP, etc.).
  </Step>

  <Step title="Upload to Plugins Directory">
    Upload the extracted plugin folder to `/wp-content/plugins/` on your server.
  </Step>

  <Step title="Activate in WordPress">
    Log into WordPress admin and activate the plugin from **Plugins > Installed Plugins**.
  </Step>
</Steps>

## Initial Setup

### First-Time Configuration

After activation, you'll be redirected to the plugin's setup wizard:

<Steps>
  <Step title="Welcome Screen">
    The setup wizard will guide you through the initial configuration process.
  </Step>

  <Step title="Choose Protection Mode">
    Select your preferred protection mode:

    * **Basic**: Simple llmtag.txt generation
    * **Standard**: llmtag.txt + basic AI agent blocking
    * **Advanced**: Full protection with analytics and custom rules
  </Step>

  <Step title="Configure AI Policies">
    Set your AI content usage policies:

    * Training data permissions
    * Usage type restrictions
    * Agent-specific rules
  </Step>

  <Step title="Enable Protection">
    Review your settings and enable AI protection for your website.
  </Step>
</Steps>

### Quick Setup Options

<Tabs>
  <Tab title="Blog/Personal Site">
    **Recommended Settings:**

    * AI Training Data: **Disallow**
    * AI Use: **Search Indexing, Generative Synthesis**
    * Protection Mode: **Standard**

    ```txt theme={null}
    # Generated llmtag.txt
    spec_version: 3.0
    ai_training_data: disallow
    ai_use: search_indexing, generative_synthesis
    ```
  </Tab>

  <Tab title="News/Media Site">
    **Recommended Settings:**

    * AI Training Data: **Disallow**
    * AI Use: **Search Indexing, Generative Synthesis**
    * Protection Mode: **Advanced**
    * Block Commercial AI: **Yes**

    ```txt theme={null}
    # Generated llmtag.txt
    spec_version: 3.0
    ai_training_data: disallow
    ai_use: search_indexing, generative_synthesis

    User-agent: CommercialAI
    ai_training_data: disallow
    ai_use: search_indexing
    ```
  </Tab>

  <Tab title="E-commerce Site">
    **Recommended Settings:**

    * AI Training Data: **Allow** (for product discovery)
    * AI Use: **All types**
    * Protection Mode: **Advanced**
    * Premium Content: **Protected**

    ```txt theme={null}
    # Generated llmtag.txt
    spec_version: 3.0
    ai_training_data: allow
    ai_use: search_indexing, generative_synthesis, commercial_products

    Path: /premium/
    ai_training_data: disallow
    ai_use: search_indexing
    ```
  </Tab>

  <Tab title="Educational Site">
    **Recommended Settings:**

    * AI Training Data: **Allow** (for educational purposes)
    * AI Use: **All types**
    * Protection Mode: **Standard**
    * Research Focus: **Yes**

    ```txt theme={null}
    # Generated llmtag.txt
    spec_version: 3.0
    ai_training_data: allow
    ai_use: search_indexing, generative_synthesis, research
    ```
  </Tab>
</Tabs>

## Verification

### Test Your Installation

<Steps>
  <Step title="Check llmtag.txt Generation">
    Visit `https://yourdomain.com/llmtag.txt` to verify the file is generated correctly.
  </Step>

  <Step title="Verify Plugin Activation">
    In WordPress admin, go to **LLMTAG > Dashboard** to confirm the plugin is active.
  </Step>

  <Step title="Test AI Agent Blocking">
    Use a tool like User-Agent Switcher to test if AI agents are being blocked.
  </Step>

  <Step title="Check Analytics">
    Visit **LLMTAG > Analytics** to see if the monitoring is working.
  </Step>
</Steps>

### Common Issues and Solutions

<AccordionGroup>
  <Accordion title="llmtag.txt file not accessible">
    **Possible causes:**

    * File permissions issues
    * Server configuration problems
    * Caching issues

    **Solutions:**

    * Check file permissions (should be 644)
    * Clear any caching plugins
    * Verify .htaccess rules
    * Contact your hosting provider
  </Accordion>

  <Accordion title="Plugin not blocking AI agents">
    **Possible causes:**

    * Protection mode not enabled
    * AI agent list not updated
    * Server configuration issues

    **Solutions:**

    * Enable protection in plugin settings
    * Update AI agent database
    * Check server error logs
    * Verify .htaccess modifications
  </Accordion>

  <Accordion title="Analytics not showing data">
    **Possible causes:**

    * No AI agents accessing the site
    * Database issues
    * Plugin configuration problems

    **Solutions:**

    * Wait for AI agent traffic
    * Check database connectivity
    * Verify plugin settings
    * Test with simulated requests
  </Accordion>
</AccordionGroup>

## Post-Installation

### Recommended Next Steps

<CardGroup cols={2}>
  <Card title="Configure Protection Modes" icon="shield" href="/wordpress/features/protection-modes">
    Set up granular protection for different content types and AI agents.
  </Card>

  <Card title="Set Up Analytics" icon="chart-line" href="/wordpress/features/analytics">
    Monitor AI agent activity and blocked requests in real-time.
  </Card>

  <Card title="Customize AI Agent Blocking" icon="user-robot" href="/wordpress/features/ai-agent-blocking">
    Fine-tune which AI agents to block or allow.
  </Card>

  <Card title="Explore Developer API" icon="code" href="/wordpress/features/developer-api">
    Integrate with external systems and customize functionality.
  </Card>
</CardGroup>

### Performance Optimization

<Note>
  The plugin is designed to have minimal impact on your website's performance. However, you can optimize further by:
</Note>

* **Enable caching** for the llmtag.txt file
* **Use CDN** for static assets
* **Optimize database queries** in analytics
* **Monitor server resources** during peak traffic

### Security Considerations

<Warning>
  Always keep the plugin updated to the latest version for security patches and new features.
</Warning>

* **Regular updates**: Enable automatic updates for security patches
* **Backup before updates**: Always backup your site before major updates
* **Monitor logs**: Regularly check server logs for suspicious activity
* **Strong passwords**: Use strong passwords for WordPress admin access

## Support and Resources

### Getting Help

<CardGroup cols={2}>
  <Card title="Documentation" icon="book" href="/wordpress">
    Complete plugin documentation and guides.
  </Card>

  <Card title="Community Support" icon="users" href="/resources/community">
    Get help from the community and other users.
  </Card>

  <Card title="Professional Support" icon="headset" href="mailto:support@llmtag.org">
    Contact our support team for technical assistance.
  </Card>

  <Card title="Feature Requests" icon="lightbulb" href="/resources/contributing">
    Suggest new features and improvements.
  </Card>
</CardGroup>

### Troubleshooting Resources

* **FAQ**: Common questions and answers
* **Troubleshooting Guide**: Step-by-step problem resolution
* **Server Requirements**: Detailed system requirements
* **Compatibility**: Plugin compatibility with other WordPress plugins