Mustang WPO (Web Performance Optimization) helps you audit, view, and manage your site's performance without leaving WordPress.
IMPORTANT: This plugin requires a valid Google Cloud API Key with the PageSpeed Insights API enabled to function. The plugin will not work without this API key.
Key Features
- PageSpeed Performance Scores in List Tables - View mobile and desktop PageSpeed Performance scores directly in your post/page list tables
- Block Editor Integration - Run PageSpeed audits and view results in the Gutenberg editor sidebar
- Performance Budgets - Set performance budgets per content type
- Global Audit - Audit all your content at once with batched processing
How It Works
- Install and Activate - Install the plugin and activate it
- Configure API Key - Add your valid Google Cloud API Key with the PageSpeed Insights API enabled in Mustang WPO > Integrations
- Set Budgets - Configure performance budgets for different content types
- Run Audits - Use the editor sidebar or global audit to measure performance
- Monitor Results - View scores in list tables
Performance Budgets
Set performance budgets for each content type:
- Max Load Time (LCP) - Largest Contentful Paint in seconds
- Max CLS - Cumulative Layout Shift (unitless)
- Max INP - Interaction to Next Paint in milliseconds
- Max Page Weight - Total page size in MB
API Integration
Mustang WPO integrates with Google PageSpeed Insights API v5:
- Required API Key - A valid Google PageSpeed Insights API key is mandatory
- Supports both mobile and desktop strategies
- Handles API quotas and rate limiting (240 requests/minute)
- Graceful error handling for network issues
- Secure API key storage with encryption
Installing the plugin
- In your WordPress admin panel, go to Plugins > Add Plugin, search for Mustang WPO and click "Install now"
- Alternatively, download the plugin and upload the contents of
mustang-wpo.zip to your plugins directory, which usually is /wp-content/plugins/.
- Activate the plugin
- Get API Key - If you don't have an API key, visit Google Cloud Console to create one
- Configure API Key - Navigate to Mustang WPO > Integrations and add your Google PageSpeed Insights API key
- Start managing the performance of your site!
API Key Setup Instructions
Step 1: Get Your API Key
- Visit Google Cloud Console
- Create a new project or select an existing one
- Enable the PageSpeed Insights API
- Create credentials (API key)
-
Restrict the API key to your domain for security (Recommended)
Step 2: Configure in WordPress
-
Go to Mustang WPO > Integrations in your WordPress admin
- Paste your API key in the "Google PageSpeed Insights API Key" field
- Click "Save Changes"
-
The plugin will validate your API key
Important Notes:
-
The API key is required for the plugin to function
- Your API key is encrypted and stored securely
- API requests are rate-limited to 240 requests per minute
1.0.1
Release date: 2025-12-12
Enhancements
- Added WordPress admin notices after audit completion (success/warning/error)
- Improved progress tracking accuracy during global audits
- Enhanced error messages for timeout and Cloudflare errors
- Better retry logic with exponential backoff for gateway errors
-
Added PHP execution time limit warning on audit page
Bugfixes
-
Fixed 504/524 Cloudflare timeout errors by reducing batch size
- Fixed progress indicators not updating during audit processing
- Fixed incomplete batch processing when timeouts occurred
-
Fixed "Non-JSON response" errors when Cloudflare timeout pages were returned
Other
-
Reduced batch size from 10 to 1 post per batch for better reliability
- Removed configurable batch size setting (now hardcoded to 1 post)
- Removed "Processing batch X of Y" progress text from top of page
1.0.0
Release date: 2025-12-09
Features
- Initial release
- PageSpeed Performance scores in post/page list tables
- Block editor sidebar integration
- Performance budgets per content type
- Global audit functionality
- Rate limiting and error handling
- Secure API key encryption and storage