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

# Introduction

> Send request logs from your WordPress site to Agent Analytics for advanced traffic analysis

<Warning>
  The wordpress plugin can have limited functionality by nature of the WordPress platform. Please read the [limitations](/agent-analytics/wordpress/limitations) page to understand more.
</Warning>

## Overview

The Agent Analytics WordPress plugin provides a seamless integration for WordPress sites to send HTTP request logs to the Profound Analytics platform. The plugin is designed with performance and privacy in mind, capturing only public visitor traffic while excluding all administrative and system activity.

<CardGroup cols={2}>
  <Card title="Zero Performance Impact" icon="gauge-high">
    Asynchronous queue system ensures page delivery is never blocked. Adds less than 1ms to request processing.
  </Card>

  <Card title="Public Traffic Only" icon="users">
    Automatically excludes WordPress admin, REST API, and system paths. Only tracks real visitor traffic.
  </Card>

  <Card title="Privacy Controls" icon="shield">
    Redacts sensitive query parameters and excludes login pages. No cookies or client-side tracking.
  </Card>

  <Card title="Enterprise Ready" icon="building">
    Supports environment variables for Log Ingestion Tokens and includes circuit breaker protection for reliability.
  </Card>
</CardGroup>

## How It Works

The plugin operates using a lightweight, non-blocking architecture:

1. **Capture** - Essential HTTP metadata is captured during request processing
2. **Queue** - Data is immediately stored in a local database queue with minimal overhead
3. **Batch** - Background process sends logs in efficient batches (up to 1,000 per request)
4. **Retry** - Failed sends are automatically retried with exponential backoff
5. **Protect** - Circuit breaker prevents cascade failures if the API is unavailable

## System Requirements

* WordPress 6.0 or higher
* PHP 7.4 or higher
* MySQL 5.7+ or MariaDB 10.2+
* Outbound HTTPS connectivity
* WordPress Cron enabled (or system cron configured)
* Sodium PHP extension (recommended for Log Ingestion Token encryption)

## Hosting Compatibility

The plugin is tested and optimized for:

* **Managed WordPress Hosts**: WP Engine, Kinsta, Flywheel
* **Cloud Platforms**: AWS, Google Cloud, Azure
* **Traditional Hosts**: SiteGround, Bluehost, GoDaddy
* **Local Development**: LocalWP, MAMP, XAMPP

<Tip>
  The plugin automatically detects and handles reverse proxy headers used by managed WordPress hosts and CDNs to ensure accurate IP detection.
</Tip>

## Next Steps

<CardGroup cols={3}>
  <Card title="Security & Privacy" icon="gear" href="/agent-analytics/wordpress/security">
    Configure Log Ingestion Tokens, privacy settings, and filtering options
  </Card>

  <Card title="Plugin Limitations" icon="bullhorn" href="/agent-analytics/wordpress/limitations">
    Understand the limitations of the WordPress plugin when used with a CDN for caching
  </Card>

  <Card title="Installation Guide" icon="download" href="/agent-analytics/wordpress/installation">
    Step-by-step instructions for installing and activating the plugin
  </Card>
</CardGroup>

***