tuhin18003/wp-compat-tester

A CLI tool to scan WordPress plugins for compatibility with the latest WordPress versions.

v1.0.0 2025-06-30 12:30 UTC

Requires

• php: >=7.2.5

MIT

• M.Tuhin

README

A CLI tool to scan your WordPress plugin code for compatibility issues with the latest WordPress version.

Features

• Detects your local WordPress version
• Fetches the latest WordPress version from wordpress.org
• Scans plugin PHP files for deprecated functions (based on official GitHub source)
• Warns about improper usage of plugins_loaded for translations in WP 6.7+

Installation (in your plugin project)

Inside your plugin project folder:

composer require --dev tuhin18003/wp-compat-tester

Usage

Option 1: Manually

Run the CLI tool directly:

vendor/bin/wp-check.php -- ./my-plugin-folder

Or scan multiple paths:

vendor/bin/wp-check.php -- ./my-plugin.php ./core

Option 2: Add to composer scripts

In your plugin project's composer.json:

"scripts": {
  "check:compat": "vendor/bin/wp-check.php -- ./my-plugin.php ./core"
}

Then run:

composer run check:compat

Output Example

🔍 Scanning plugin at: ./my-plugin.php
Local WP Version:  6.7.0
Latest WP Version: 6.7.2

⚠️  Deprecated function `get_page_by_title()` found in plugin.php (deprecated since WP 6.2.0)
⚠️  Detected 'plugins_loaded' hook usage in plugin.php. Use 'init' instead for translations in WP >= 6.7.
✅ Scan complete.

License

MIT