Система Отладки.

Инструмент, который позволит вам подробно исследовать процессы выполнения PHP скриптов Плагинов и Тем.
В том числе, удаленно, не имея прямого доступа к администрированию целевого сайта.

= Возможности =
* Легко встраивать в любые PHP Скрипты.
* Легкое Управление.
* Любое количество Процессов.
* Детализация по каждой Переменной или Объекту, значения которых вам необходимо знать.
(Метка Времени, Название Процесса, Название Функции, Строка в файле)
* Выбор Процессов для исследования.
* Общий Стрим Процесс.
* Сохранение Лога в Файлы по каждому из Процессов.
* Файлы с меткой Дата-Время.
* Индивидуальные Файлы для каждого Пользователя.
* Общая Статистика Файлов.
* Возможность дистанционно удалить Лог от текущей даты для конкретного Источника Данных. (Использование: www.yoursite.com?clear_debug=DataSourceName)

Текущая версия: 1.9 (2026.02.08) можно загрузить с этого сайта.

Download “WPGear Debugger” wpgear-debugger_v1.9.zip – Downloaded 484 times – 17 KB

В Официальном Репозитории WordPress – этого плагина нет!
Модераторы WordPress Plugin Review Team официально отказали в публикации.
Причина: “Your plugin has been rejected because we no longer accepting frameworks, boilerplates, and libraries as stand-alone plugins…”
“…I can understand that this is a tool for developers, and that’s great, but that’s not something that this directory is accepting because of the reasons – in our review process, we look for plugins that provide direct functionality to end users rather than serving as a library.”

== Инсталяция ==

Обычная автоматическая установка.
или:
1. Загрузите папку ‘wpgear-debugger’ в папку: ‘/wp-content/plugins/’.
2. Активируйте ‘WPGear Debugger’ через Админ-Меню ‘Плагины’ в консоли WordPress.
3. Откройте вкладку ‘Настройка’: ‘WPGear Debugger’. Настройте нужные вам опции.
4. Если возникнут какие-нибудь проблемы или вопросы – спрашивайте на Форуме Поддержки.

== Часто Задаваемые Вопросы ==

Что нужно сделать, чтобы начать этим пользоваться?

1.Название Источника Данных.
Каждый Плагин или Тема, которые вы хотите исследовать – это Источник Данных. Придумайте для него осмысленное имя.
Например: Плагин “Hello Dolly”:
(пример плагина “Hello Dolly” со всеми работающими примерами находится в папке “sample”)

Назовем Источник Данных для него: “Hello_Dolly”. Все Лог-Процессы этого Источника Данных будут содержать метку “Hello_Dolly”.

2. Добавляем Функцию для Debugger.Нужно вставить в Основной Файл исследуемого Плагина – небольшую Функцию с уникальным для каждого Источника названием.
(А если – это Тема, то в файл “functions.php”)

Для нашего примера Плагин “Hello Dolly”, добавим Функцию: “HelloDolly_Debugger”.

Укажем придуманное Название Источника:
$Source = ‘Hello_Dolly’;

вот как это выглядит:

/* Debugger. 
----------------------------------------------------------------- */
function HelloDolly_Debugger ($Content, $Subject = null, $Process = null, $Function = '', $Line = '') {
   if (function_exists( 'WPGear_Debugger' )) {
      $Source = 'Hello_Dolly';
      $TimeStamp = true;

      $Parameters = array(
         'source' => $Source,
         'content' => $Content,
         'subject' => esc_html( $Subject ),
         'process' => esc_html( $Process ),
         'function' => esc_html( $Function ),
         'timestamp' => $TimeStamp,
         'line' => esc_html( $Line ),
     );

     WPGear_Debugger ($Parameters);
   }
}

3. Добавляем Название Процесса.
В каждую Отдельную Функцию, можно добавлять разные осмысленные Названия Процессов.
Например, для Функции “hello_dolly()” из плагина “Hello Dolly”:

$debug_process = ‘get_random_sublyric’;

4. Добавляем Контрольные Точки.
Для каждой Переменной, Значение которой нам надо отслеживать (например: $chosen), нужно на новой строке добавить вызов функции Debugger.

HelloDolly_Debugger ($chosen, ‘$chosen’, $debug_process, __FUNCTION__, __LINE__);

вот как это выглядит на примере Функции “hello_dolly()” плагина “Hello Dolly”:

function hello_dolly() {
   $debug_process = 'get_random_sublyric';

   $chosen = hello_dolly_get_lyric();
   HelloDolly_Debugger ($chosen, '$chosen', $debug_process, __FUNCTION__, __LINE__);

   $lang = '';
   if ( 'en_' !== substr( get_user_locale(), 0, 3 ) ) {
      $lang = ' lang="en"';
   }

   printf(
      '<p id="dolly"><span class="screen-reader-text">%s </span><span dir="ltr"%s>%s</span></p>',__( 'Quote from Hello Dolly song, by Jerry Herman:', 'hello-dolly' ),$lang,$chosen);
}

5. Результат
Вот, что будет записано в Файле “/wp-content/uploads/wpgear_debugger/hello_dolly/2025.02.27-2_hello_dolly.get_random_sublyric”:

---- 2025.02.27 17:21:48 ---- 
"get_random_sublyric", "hello_dolly", Line:58
$chosen: 'I can tell, Dolly'

== Скриншоты ==

1. 1. screenshot-1.png Страница “Настройки” в Админке.