WordPress Plugin
The MantleWP Connector plugin collects site health data and sends it to your dashboard. Zero frontend impact, under 50KB, and requires no ongoing maintenance.
Requirements
- WordPress 6.0 or higher
- PHP 8.0 or higher
- HTTPS enabled (data transmission requires secure connection)
Installation
- From your WordPress admin, go to Plugins > Add New
- Search for "MantleWP Connector"
- Click Install Now, then Activate
- A new menu item MantleWP appears under Tools
- Go to Tools > MantleWP and paste your API key (find it in Dashboard > Sites > [Site Name])
- Click Connect. The plugin will send an initial health check immediately
What Data Is Collected
The plugin collects only technical site metadata—no user content, no customer data, no private information.
| Data Point | Purpose |
|---|---|
| WordPress Version | Track core updates and deprecations |
| PHP Version | Monitor compatibility and security patches |
| Active Plugins | Inventory and update tracking |
| Active Theme | Monitor theme updates and changes |
| SSL Certificate Status | Verify HTTPS and expiration dates |
| Database Size | Track growth and optimization needs |
| WordPress Site Health Scores | Overall performance and security indicators |
| Uptime Pings | Monitor availability and response times |
How It Works
The plugin uses WordPress' built-in WP-Cron to send data every 6 hours. Each request includes your API key in the X-MantleWP-Key header and is encrypted over HTTPS.
Once connected, data appears in your MantleWP dashboard within seconds. Reports update automatically as new data arrives.
Troubleshooting
Connection Failed
- Check your API key: Copy it from Dashboard > Sites > [Site Name] and paste it exactly
- Verify HTTPS: The plugin requires a valid SSL certificate. HTTP sites cannot connect
- Check firewall rules: Some hosts block outbound connections. Contact your host if you see "connection timeout"
Data Not Showing in Dashboard
- Wait 5 minutes: The first data transmission may be queued by WP-Cron
- Check WP-Cron: If your site has WP-Cron disabled, install WP Crontrol to verify it's running
- Manually trigger: Go to Tools > MantleWP and click Send Health Check to test immediately
Plugin Not Appearing in Tools Menu
- Check PHP version: MantleWP requires PHP 8.0+. Go to Tools > Site Health to see your version
- Refresh admin: Deactivate and reactivate the plugin
- Check permissions: You must be logged in as an admin to see the Tools menu
Capabilities System
The plugin includes a capabilities array in its payload for future compatibility. This allows MantleWP to enable new features (like automated audits) without requiring a plugin update. Your site's current capabilities are visible in Dashboard > Sites > [Site Name] > Advanced.
Next Steps
Once your plugin is connected, explore the Getting Started guide to generate your first report. See Data Security for details on how we protect your information.