Mustang WPO – See Your Performance Clearly

Description

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

  • Dashboard Widget – At-a-glance performance overview on your WordPress dashboard showing Mobile and Desktop scores
  • 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 post type
  • Global Audit – Audit all your content at once with batched processing

How It Works

  1. Install and Activate – Install the plugin and activate it
  2. Configure API Key – Add your valid Google Cloud API Key with the PageSpeed Insights API enabled in Mustang WPO > Integrations
  3. Set Budgets – Configure performance budgets for different content types
  4. Run Audits – Use the editor sidebar or global audit to measure performance
  5. 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

Support

For support, feature requests, or bug reports, please visit the WordPress.org support forums.

Privacy Policy

Data Collection and Usage:

Mustang WPO requires a Google API key to function. Here’s what data is collected and how it’s used:

Data Sent to Google:
* URLs of your website pages (for performance analysis)
* No personal data, user information, or content is transmitted
* API requests include your website URL and strategy (mobile/desktop)

Data Stored Locally:
* PageSpeed audit results are stored in your WordPress database
* Your API key is encrypted and stored securely in your database
* No data is sent to third parties other than Google PageSpeed Insights API

Google’s Privacy Policy:
This plugin uses Google PageSpeed Insights API. Google’s collection and use of information is governed by Google’s Privacy Policy.

API Key Security:
* Your API key is encrypted using WordPress security salts
* The full API key is never displayed in plain text
* API key is stored in your WordPress database, not transmitted to external servers

Rate Limiting:
The plugin enforces a rate limit of 240 requests per minute to prevent abuse and comply with Google’s API terms.

Screenshots

  • Dashboard widget showing performance overview across mobile and desktop devices.
  • Settings page to define your audit post types.
  • Integrations page to add your Google PageSpeed Insights API Key (A valid key is required).
  • Budgets page to set your performance budgets for each post type.
  • Audit page before running an audit.
  • Audit page running a global audit.
  • Audit page after running an audit.
  • Performance column with scores and tooltip for Pages post type after running an audit.
  • Performance column tooltip for Pages that are not published yet.
  • Document settings for a draft page.
  • Document settings during a single audit.
  • Document settings after running a single audit.

Installation

Installing the plugin

  1. In your WordPress admin panel, go to Plugins > Add Plugin, search for Mustang WPO and click “Install now
  2. Alternatively, download the plugin and upload the contents of mustang-wpo.zip to your plugins directory, which usually is /wp-content/plugins/.
  3. Activate the plugin
  4. Get API Key – If you don’t have an API key, visit Google Cloud Console to create one
  5. Configure API Key – Navigate to Mustang WPO > Integrations and add your Google PageSpeed Insights API key
  6. Start managing the performance of your site!

API Key Setup Instructions

Step 1: Get Your API Key
1. Visit Google Cloud Console
2. Create a new project or select an existing one
3. Enable the PageSpeed Insights API
4. Create credentials (API key)
5. Restrict the API key to your domain for security (Recommended)

Step 2: Configure in WordPress
1. Go to Mustang WPO > Integrations in your WordPress admin
2. Paste your API key in the “Google PageSpeed Insights API Key” field
3. Click “Save Changes”
4. 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

FAQ

Do I need a Google PageSpeed Insights API key?

Yes, a valid Google PageSpeed Insights API key is required for the plugin to function. The plugin will not work without this API key. You can get a free API key from Google Cloud Console.

How do I get a Google PageSpeed Insights API key?

  1. Visit Google Cloud Console
  2. Create a new project or select an existing one
  3. Enable the PageSpeed Insights API
  4. Create credentials (API key)
  5. Restrict the API key to your domain for security (recommended)

Is my API key secure?

Yes, your API key is encrypted using WordPress security salts and stored securely in your database.

What happens if I don’t have an API key?

The plugin will not function without a valid API key. You’ll see warning notices on all pages directing you to configure the API key in Mustang WPO > Integrations.

How often should I run audits?

For most sites, running audits weekly or after major content changes is sufficient. The plugin includes rate limiting to prevent overwhelming the API.

What if I hit API quotas?

The plugin handles quota exceeded errors gracefully and will show clear messages. Consider adding an API key or reducing audit frequency.

Can I audit custom content types?

No, the free version of the plugin only supports Pages and Posts.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Mustang WPO – See Your Performance Clearly” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.2

Release date: 2025-12-22

Enhancements
* NEW: Dashboard widget – “Mustang WPO Overview” provides at-a-glance performance scores on your WordPress dashboard
* Dashboard widget shows separate Mobile and Desktop performance breakdowns
* Intelligent verdict system with clear recommendations (e.g., “Mobile performance is holding back overall site performance”)
* Directional hints when one device needs attention
* Tooltips on performance bars showing score ranges and counts
* Empty state messages with helpful CTAs for fresh installs

Other
* Updated terminology from “Content Types” to “Post Types” per WordPress standards
* Added device status classification system (Strong/Mixed/Weak)
* Improved overall verdict logic covering all Mobile vs Desktop combinations

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