Profound Agent Analytics for WordPress

Complete IP Tracking: Captures full IP addresses for accurate traffic analysis and reverse DNS lookups (required for bot detection)

Sensitive Data Protection: Automatically redacts passwords, tokens, and credit card information from query parameters

Public Traffic Only: Excludes all WordPress admin, REST API, and system paths – only tracks public visitor traffic

Encrypted Storage: API keys are encrypted using WordPress salts when Sodium extension is available

No Cookie Tracking: Server-side only – does not use cookies or client-side tracking

Performance Optimized

Adds less than 1ms to request processing time

Efficient database operations with proper indexing

Automatic cleanup of old log entries

Memory-aware batching to prevent large payloads

Configurable queue size limits

Privacy Policy This plugin sends data to Profound’s analytics service (https://artemis.api.tryprofound.com). The data sent includes:

– Full IP addresses (required for bot detection and traffic analysis)

– Request URLs from public pages only (admin and system paths are excluded)

– HTTP headers (user agent, referer)

– Response metadata (status code, size, duration)

– Query parameters (with sensitive values redacted)

The plugin only tracks public visitor traffic. WordPress admin activity, user actions, and system operations are not collected. All data is processed in accordance with Profound’s privacy policy available at https://tryprofound.com/privacy-policy

System Requirements

WordPress 6.0 or higher

PHP 7.4 or higher

MySQL 5.7+ or MariaDB 10.2+

Ability to make outbound HTTPS requests

WP-Cron enabled (or real cron configured)

Sodium PHP extension (recommended for encryption)

Development & Testing This plugin includes a .wp-env.json configuration for local testing using wp-env. This requires Docker (or OrbStack) and Node.js.

Running Compatibility Tests

Start the environment:

npx @wordpress/env start

Verify the plugin activates without errors:

npx @wordpress/env run cli wp plugin deactivate agent-analytics-wp-plugin

npx @wordpress/env run cli wp plugin activate agent-analytics-wp-plugin

Verify all classes instantiate and core functionality works:

npx @wordpress/env run cli wp eval ‘new AgentAnalytics\Settings(); new AgentAnalytics\Queue(); echo “OK”;’

Check for PHP errors, warnings, or deprecation notices (WP_DEBUG is enabled):

npx @wordpress/env run cli cat /var/www/html/wp-content/debug.log

If the file does not exist, there are no errors.

Stop the environment:

npx @wordpress/env stop

To test against a different WordPress version, edit the core value in .wp-env.json (e.g. "WordPress/WordPress#7.0") and restart.

Deploying to WordPress.org See DEPLOY.md for instructions on publishing releases and updating the “Tested up to” value via SVN.

Support For support, please contact support@tryprofound.com