Jacek Labudda

<p>DockTHOR integrates WordPress with the THOR monitoring platform and automatically reports PHP errors and uncaught exceptions.</p>
<p>The plugin is designed to work silently in the background and has no admin interface. After installation you only need to configure your THOR project credentials.</p>
<h3>Features:</h3>
<ul>
<li>Automatic reporting of PHP errors and uncaught exceptions</li>
<li>Support for custom error filtering</li>
<li>Optional user context information</li>
<li>Customizable configuration via WordPress constants and filters</li>
<li>Minimal performance overhead</li>
</ul>
<p>This plugin is intended for developers and teams who want to monitor errors occurring in WordPress installations.</p>
<p>Installation</p>
<ol>
<li>Upload the plugin files to the <code>/wp-content/plugins/dockthor</code> directory, or install the plugin through the WordPress plugins screen.</li>
<li>Activate the plugin through the <strong>Plugins</strong> menu in WordPress.</li>
<li>Configure your THOR credentials in <code>wp-config.php</code>.</li>
</ol>
<p>Example configuration:<br />
    <code>php<br />
define( 'DOCK_THOR_TOKEN', 'YOUR_THOR_TOKEN' );<br />
define( 'DOCK_THOR_PRIVATE_KEY', 'YOUR_PRIVATE_KEY' );</code><br />
Once configured, the plugin will automatically begin reporting PHP errors.</p>
<p>Configuration</p>
<p>Add the following constants to your <code>wp-config.php</code> file.</p>
<h3>DockTHOR Token</h3>
<p><code>php<br />
define( 'DOCK_THOR_TOKEN', 'YOUR_THOR_TOKEN' );<br />
    `<h3>Private Key</h3></code>php<br />
define( ‘DOCK_THOR_PRIVATE_KEY’, ‘YOUR_PRIVATE_KEY’ );<br />
    `</p>
<h3>Error Types (optional)</h3>
<p>“`php<br />
define( ‘DOCK_THOR_ERROR_TYPES’, E_ALL & ~E_DEPRECATED & ~E_NOTICE & ~E_USER_DEPRECATED );<br />
    <code>Define which PHP errors should be captured.<h3>Send Default PII (optional)</h3><br />
If enabled, additional context such as the logged-in user and IP address will be attached to the event.</code>php<br />
define( ‘DOCK_THOR_SEND_DEFAULT_PII’, true );<br />
    <code><h3>Site Version (optional)</h3><br />
Define the version of your website. This can help track which version of the site generated an error.</code>php<br />
define( ‘DOCK_THOR_VERSION’, ‘v1.0.0’ );<br />
    <code><h3>Environment (optional)</h3><br />
Define the current environment.</code>php<br />
define( ‘DOCK_THOR_ENV’, ‘production’ );<br />
    `</p>
<p>Filters</p>
<p>DockTHOR provides several filters that allow developers to customize behavior.</p>
<h3>dock_thor_user_context</h3>
<p>Allows extending the user context sent to THOR.</p>
<p>Example:<br />
    <code>php<br />
add_filter( 'dock_thor_user_context', function ( array $user ) {<br />
    return array_merge( $user, ['custom_meta' => 'value'] );<br />
});</code></p>
<p>Note: These values may be exposed publicly when used in JavaScript trackers.</p>
<h3>dock_thor_token</h3>
<p>Allows overriding the THOR token.</p>
<p>Example:<br />
    <code>php<br />
add_filter( 'dock_thor_token', function ( $token ) {<br />
    return 'xxxxxxxxxxxxxxxxxxxx';<br />
});</code><br />
Using the <code>DOCK_THOR_TOKEN</code> constant is recommended instead.</p>
<h3>dock_thor_scope</h3>
<p>Allows modifying the THOR scope before events are sent.</p>
<p>Example:<br />
    <code>php<br />
add_filter( 'dock_thor_scope', function ( \Dock\Thor\State\Scope $scope ) {<br />
    $scope->setTag('custom-tag', 'value');<br />
    return $scope;<br />
});</code></p>
<h3>dock_thor_options</h3>
<p>Allows customizing THOR SDK options.</p>
<p>Example:<br />
    <code>php<br />
add_filter( 'dock_thor_options', function ( \Dock\Thor\Options $options ) {<br />
    $options->setSampleRate(0.9);<br />
    return $options;<br />
});</code></p>
<p>Advanced Usage</p>
<h3>High volume of notices</h3>
<p>Some plugins generate large amounts of PHP notices. You can filter them out:<br />
    <code>php<br />
define( 'DOCK_THOR_ERROR_TYPES', E_ALL & ~E_NOTICE );</code></p>
<h3>Capturing handled exceptions</h3>
<p>If you want to report handled exceptions:<br />
    <code>php<br />
try {<br />
    myMethodThatCanThrowAnException();<br />
} catch ( \Exception $e ) {<br />
    if ( function_exists( 'dock_thor_safe' ) ) {<br />
        dock_thor_safe( function ( \Dock\Thor\State\HubInterface $client ) use ( $e ) {<br />
            $client->captureException( $e );<br />
        });<br />
    }<br />
    wp_die( 'An error occurred.' );<br />
}</code></p>
<p>Frequently Asked Questions</p>
<h4>Does this plugin have an admin panel?</h4>
<p>No. DockTHOR works automatically after configuration in <code>wp-config.php</code>.</p>
<h4>Will this slow down my site?</h4>
<p>The plugin is designed to have minimal performance impact. Error events are sent asynchronously when possible.</p>
<h4>Can I disable certain errors?</h4>
<p>Yes. You can configure the error types captured using the <code>DOCK_THOR_ERROR_TYPES</code> constant.</p>


DockTHOR

DockTHOR is a lightweight WordPress integration for sending PHP errors and exceptions to the THOR monitoring platform.

Freemius

Oleksandr Lysyi

<p>Debug Log Viewer: Your Essential WordPress Debugging Tool</p>
<p>Tired of struggling to access and understand your WordPress debug.log file?  Debug Log Viewer simplifies WordPress debugging by providing a user-friendly interface to view, search, and manage your debug.log directly within your WordPress admin area.  It’s the perfect solution for WordPress developers, site administrators, and anyone needing to quickly identify and resolve website issues.</p>
<p>Gain Real-Time Insights into Your WordPress Site Health</p>
<p>This plugin is designed to provide you with instant visibility into the inner workings of your WordPress website. By tracking errors, warnings, and deprecated function notices in real-time, Debug Log Viewer empowers you to proactively maintain a healthy and stable WordPress environment.</p>
<p>Key Features for Efficient WordPress Debugging:</p>
<ul>
<li>Real-Time Log Viewer:  Monitor your WordPress debug.log file in real-time, directly from your WordPress dashboard. No more hunting for files via FTP or cPanel!</li>
<li>Easy Debug Log Access:  Access and view your full WordPress debug log within a clean and intuitive interface.</li>
<li>Search and Filtering: Quickly find specific log entries with powerful search and filtering options. Filter by error type, keywords, or date (future feature) to pinpoint issues fast.</li>
<li>Pagination: Navigate through large debug logs with ease using pagination, ensuring smooth performance even with extensive logs.</li>
<li>Email Alerts for Critical Errors:  Get immediate email alerts when new errors are logged, allowing you to address critical issues before they impact your users (future feature: configurable severity levels).</li>
<li>Flexible Settings Panel:
<ul>
<li>Control WP_DEBUG Constants:  Enable or disable WP_DEBUG and WP_DEBUG_LOG constants directly from the plugin settings, without editing wp-config.php.</li>
<li>Customize Logging Options: Configure your debug log settings to match your specific needs.</li>
<li>Tailor Your Error Tracking:  Personalize your debugging experience through plugin settings.</li>
</ul>
</li>
<li>Custom Log Path Support:  If you’ve defined a custom path for your debug.log file (e.g., using define( ‘WP_DEBUG_LOG’, ABSPATH . ‘wp-content/logs/debug.log’ );), Debug Log Viewer automatically detects and reads from it.</li>
<li>Automatic Log Cleanup:  Schedule automatic cleanup to prevent your debug.log from growing too large and consuming disk space. Keep your site running smoothly with automatic maintenance at 50MB threshold.</li>
</ul>
<p>Benefits of Using Debug Log Viewer:</p>
<ul>
<li>Save Time and  Effort: Stop wasting time manually accessing and parsing your debug log file. Debug Log Viewer puts all the information you need at your fingertips within WordPress admin.</li>
<li>Faster Error Detection: Real-time monitoring and email alerts help you catch errors as they happen, minimizing potential downtime.</li>
<li>Simplified WordPress Troubleshooting:  Quickly identify the source of errors and warnings to streamline your WordPress troubleshooting process.</li>
<li>Improved Website Stability: Proactive error monitoring and resolution contribute to a more stable and reliable WordPress website.</li>
<li>User-Friendly Interface:  No coding skills required!  Debug Log Viewer is designed for ease of use, making debug log management accessible to everyone.</li>
</ul>
<p>Debug Log Viewer Pro Features:</p>
<p>Upgrade to Pro for advanced debugging capabilities:</p>
<ul>
<li>Advanced Email Alert Customization: Choose specific error levels to monitor and reduce notification noise.</li>
<li>CSV Export: Export debug log data for analysis, reporting, or sharing with team members.</li>
<li>Custom Date Range Filtering: Filter log entries by specific time periods for targeted troubleshooting.</li>
</ul>
<p>Who is Debug Log Viewer For?</p>
<ul>
<li>WordPress developers</li>
<li>Website administrators</li>
<li>Freelancers managing client sites</li>
<li>Anyone who wants an easy way to monitor WordPress errors and improve website health</li>
</ul>
<h3>Tested up to</h3>
<p>WordPress Version: 6.9<br />
PHP Version: 8.3.9</p>


Debug Log Viewer

Effortlessly view, search, filter and manage your WordPress debug.log in the admin dashboard. Real-time monitoring and email alerts

DockTHOR vs Debug Log Viewer