這個外掛並未在最新的 3 個 WordPress 主要版本上進行測試。開發者可能不再對這個外掛進行維護或提供技術支援,並可能會與更新版本的 WordPress 產生使用上的相容性問題。

KL Debug

外掛說明

Add a Debug Bar to your WordPress website to debug and develop your themes, plugins, etc…

With the plugin you can find every variables you want to debug in the same place and use debug functions to display them.

Prerequisites

To fully help you to debug your website you need to add some code to your wp-config.php file.

define( 'WP_DEBUG', true ); // PHP errors, notices and warnings will be displayed
define( 'SAVEQUERIES', true ); // Display queries in current page
define( 'WP_DISABLE_FATAL_ERROR_HANDLER', true ); // Disable WP Fatal error handler

Usage of the debug functions

To debug a simple variable you can use:

<?php dump( $var ); // Dump the variable(s) ?>

To debug a variable and stop the process after you can use:

<?php dd( $var ); // This will die after dumping the variable(s) ?>

Debug a variable in the debug bar

This is one of the main aspect of the plugin, to debug variables in a separate place.

The most difficult task when you debug a variable is to deal with container width, with the plugin you have a debug bar where you can add the variables of the current page.

To add a variable to the debug bar you can use the function bellow:

<?php kl_debug_add_var( $var ); ?>

You can add custom tabs in the debug bar to filter you variables:

<?php
kl_debug_add_var(
    $var, // The variable you want to debug
    'Your variable title', // If you want to name the variable
    'The section title', // The tab title
    'the-section-slug' // The tab slug
);
?>

What’s Whoops in the setting panel?

Whoops is the framework that we use to display error handling. (cf. Pretty error handler with stack frames)

螢幕擷圖

  • Debug bar open
  • Settings interface
  • Pretty error handler with stack frames(powered by Whoops)

安裝方式

Requirements

This plugin requires at least PHP 7.2.

How to install the plugin

  1. Upload the plugin files to the /wp-content/plugins/kl-debug directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the \’Plugins\’ screen in WordPress
  3. Use the Tools->KL Debug screen to configure the plugin

常見問題集

How to set which PHP errors are reported?

Simply add error_reporting(E_ALL & ~E_NOTICE); to the top of your theme functions.php file. This will only display errors that are not notices.

How can I deactivate the plugin if I can’t access the admin screen ?

Go to your FTP explorer and navigate to the plugin: wp-content>plugins. Rename the folder by adding an _ in the beginning of the folder name.

使用者評論

閱讀全部 1 則使用者評論

參與者及開發者

以下人員參與了開源軟體〈KL Debug〉的開發相關工作。

參與者

〈KL Debug〉外掛目前已有 1 個本地化語言版本。 感謝全部譯者為這個外掛做出的貢獻。

將〈KL Debug〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

1.0.5

  • [Added] Tested up to WordPress 6.0
  • [Updated] Composer dependencies

1.0.4

  • [Added] Tested up to WordPress 5.8.2

1.0.3

  • [Added] Tested up to WordPress 5.7.2

1.0.2

  • [Added] Optimize autoload.php
  • [Fixed] autoload.php require path that can cause error 500

1.0.1

  • [Fixed] jQuery error when plugin installed on WordPress 5.5

1.0

  • [Added] Initial release