David Pullin

A WordPress plugin to provide general tools to assist with WordPress development and maintenance. Each tool within this collection is pluggable, allowing you full control, over which ones are loaded.
Main features include:-
<ul>
<li>Internal Developer Log (database table with viewer) that can be called from code to log message, debug details etc.</li>
<li>Send A Test Email</li>
<li>List Cookies (client side)</li>
<li>Clear WordPress’ Core Updater Lock & Increase PHP execution time to assist with timeout issues</li>
</ul>
<h3>Deactivation</h3>
When deactivating this plugin from WordPress’ Plugins maintenance any option relating to deactivating will be adhered to even if that tool is disabled (as 
long as the tool’s physical file is still present).
For example, even if you disable the loading of the Development Logging Support tool, when this plugin is deactivated, if the Logging Support’s tool option to drop the log table on deactivation is set, the database table will still be deleted.
<h3>Pluggable</h3>
Each tool is in itself pluggable and can be removed or disabled from your WordPress installation.
You may wish to do this to limit which tools are available on your live site.
There are two different methods of disabling a tool.
<h4>Removing via Administration Options</h4>
On the main general settings screen you are able to choose which tools are active. By default tools are active and by default any new tools in 
future updates of this plugin will default to active. You can also change this behaviour by turning off the option to activate new tools by default.
<h4>Removing via Physical File Deletion</h4>
Each tool exists within the tools\ sub-directory. You can disable a tool simply by deleting the file or rename it so it is no longer prefixed with zhu_dt_.
Please note, if you apply an update to this plugin the removed file will be placed back as part of the update process. Upon restoring the file it will be treated as a newly detected tool which may be enabled depending on the option to activate new tools by default. You can find this option on the general settings screen.
<h3>The Tools</h3>
<ol>
<li>Tool Activator & Client Development Toolbar</li>
<li>Generic development log database table</li>
<li>Quick email test</li>
<li>Cookie viewer</li>
<li>Update Assist</li>
</ol>
<h3>1. Tool Activator & Client Development Toolbar</h3>
This tool provides UI support on the general settings screen to allow you to enable and disable other tools.
You cannot disable this tool via the UI but like the other files in the tool directory you can remove the file zhu_dt_activator.class.php to disable UI support.
<h3>Client Development Toolbar</h3>
Some tools provide features to be available on the client side (i.e. your website not the admin area of WordPress). If there are no tools enabled that provide client side features the toolbar will not be displayed.
To prevent the toolbar being displayed for everyone, i.e. public, it is also restricted to the specified user as per its settings. This however, will only work when that user is logged into WordPress and viewing their site.
However, there may be times, when you wish to use these tools when visiting your site as a member of the public and therefore you will not be logged into WordPress. To achieve this, the toolbar has an option to create a browser cookie containing an Activation ID. This ID is then matched with the ID that you will need to enter into the tool’s settings. If matched then the toolbar is rendered on the system with the matching cookie value.
The toolbar hooks into WordPress wp_body_open action to inject required HTML. wp_body_open was introduced into WordPress 5.2.0 which should be triggered via your theme after the open body html tag. As such, if your theme does not support this then the client toolbar will not be displayed.
<h3>2. Generic development log database table</h3>
Tool filename: zhu_dt_log.class.php
Provides a public function to call via your code to record a log into the database
<pre><code>public function zhu_log( string $content) {}
E.g. zhu_log(‘testing my feature ‘ . $mode);
</code></pre>
This function records, with a date a time stamp, into the database table [wp]_zhu_log. Where [wp] is your site’s database table prefix. Entries in this table can be viewed via this plugin’s log viewer which is accessible from the Administration Menu.
The log can be truncated at anytime via the truncate button found on this plugin’s options page.
In the event that this tool has been disabled or zhu_dt_log.class.php has been removed any calls to zhu_log() within your own code will not fail. However no logging will take place as zhu_log() simply becomes a do nothing function. This allows you to keep your logging code in place, if required, and enable/disable the actual recording to the database by enabling and disabling this tool as required.
<h3>3. Email Test</h3>
Tool filename: zhu_dt_send_test_email.class.php
Provides, within this plugin’s options screen, a quick test to send an email using WordPress’ wp_mail() function.
The email address, subject and body of the email are remembered for next time. If an error is detected its details are displayed on screen.
<h3>4. Cookie Viewer</h3>
Tool filename: zhu_dt_cookie_viewer.class.php
When enabled, this tool adds an icon to the main site’s floating toolbar. The feature allows you to view cookies used by the site. Detection is performed bia locally running JavaScript.
This pop-up viewer also provides an easy method of deleting individual cookies.
<h3>5. Update Assist</h3>
Tool filename: zhu_dt_cookie_viewer.class.php
This tool provides a simple button to remove WordPress’s Core Updater Lock. This will remove WordPress’s internal “lock” that is used by WordPress to indicate that a core update is taking place. Whan a core update fails, for example, due to a timeout issue when downloading, the lock may still be present. As such, when you try again WordPess displays the message “Another Update in Progress”.
This tool also allows you to set the value of PHP’s max_execution_time. This may assist with timeout issues when downloading updates. After enabling this option and pressing save the tool will inform you as best it can with the results of applying the change. Please note, that some hosting providers configure their systems so changing this value has no effect even even if PHP reports the change was successful.

Zhu Development Tools for WordPress

A WordPress plugin to provide general tools to assist with WordPress development and maintenance. Each tool within this collection is pluggable, allow …

Eli Hanna

⚠️ Important: Development Environment Only
This plugin is designed for development environments like LocalWP, XAMPP, or self-hosted servers. It will not work on most managed hosting providers (WP Engine, Kinsta, SiteGround, etc.) due to security restrictions that disable the <code>exec()</code> function and limit access to PHP binaries.
How It Works
This plugin leverages <a href="https://github.com/squizlabs/PHP_CodeSniffer" rel="nofollow ugc">PHP_CodeSniffer</a> with the <a href="https://github.com/PHPCompatibility/PHPCompatibility" rel="nofollow ugc">PHPCompatibility</a> standard to perform deep static analysis of your PHP code.
Core Components:
<ol>
<li>Bundled Dependencies: Includes PHP_CodeSniffer and PHPCompatibility ruleset</li>
<li>Batch Processing: Scans files in configurable batches (10-100 files) to manage memory usage</li>
<li>Command Execution: Executes PHPCS via PHP’s <code>exec()</code> function with specific parameters</li>
<li>Server-Side State: Stores file lists in WordPress options to optimize AJAX requests</li>
<li>Progressive UI: Real-time batch results with stop/start controls</li>
</ol>
How to Use:
<ol>
<li>Navigate to Tools → PHP Compatibility Scanner</li>
<li>Review the System Check section to ensure your environment is compatible</li>
<li>Select the plugins and/or themes you want to scan by checking their boxes</li>
<li>Configure your scan options:
<ul>
<li>Target PHP Version: Choose the PHP version you want to test against (7.4 – 8.4)</li>
<li>Batch Size: Select how many files to process at once (default: 50 files)</li>
<li>Skip Vendor Directory: Keep checked to skip third-party dependencies</li>
</ul>
</li>
<li>Click Start Scan to begin the compatibility check</li>
<li>View results in real-time as each plugin/theme is scanned</li>
<li>Review any errors (❌) or warnings (⚠️) found in your code</li>
<li>Click on any target to expand and see detailed compatibility issues</li>
</ol>
Why It Requires Development Environments
<ul>
<li><code>exec()</code> Function: Required to run PHPCS binary – disabled on managed hosts</li>
<li>PHP Binary Access: Needs access to PHP executable – restricted on shared hosting</li>
<li>Composer Dependencies: Requires vendor directory with PHPCS installation</li>
<li>File System Access: Creates temporary files for batch processing</li>
<li>Memory/Time Limits: Long-running scans need relaxed execution limits</li>
</ul>
Supported Environments
<ul>
<li>LocalWP (recommended)</li>
<li>XAMPP/MAMP</li>
<li>Docker WordPress setups</li>
<li>Self-hosted VPS/dedicated servers</li>
<li>Development environments with shell access</li>
</ul>
Unsupported Environments
<ul>
<li>WP Engine (exec() disabled)</li>
<li>Kinsta (security restrictions)</li>
<li>SiteGround (managed hosting limitations)</li>
<li>GoDaddy Managed WordPress (function restrictions)</li>
<li>WordPress.com (no plugin uploads)</li>
<li>Most shared hosting providers</li>
</ul>
<h3>Contributing</h3>
This plugin is actively developed for WordPress development environments. Contributions are welcome, especially:
<ul>
<li>Additional PHP version compatibility rules</li>
<li>Performance optimizations</li>
<li>UI/UX improvements</li>
<li>Hosted environment compatibility solutions</li>
</ul>
<h3>Technical Details</h3>
Dependencies
<ul>
<li>PHP_CodeSniffer: ^3.13 (static analysis engine)</li>
<li>PHPCompatibility: dev-develop (compatibility ruleset)</li>
</ul>
License
GPLv2 or later – same as WordPress core.

Eli's PHP Compatibility Scanner


Good quality plugin and fast support!



Super! Thanks!


Excellent!

A comprehensive WordPress plugin that scans your plugins and themes for PHP version compatibility issues using the  PHPCompatibility ruleset.

Zhu Development Tools for WordPress vs Eli's PHP Compatibility Scanner