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

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

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

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

Download “WPGear Debugger” wpgear-debugger_v1.1.zip – Downloaded 0 times – 15 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 Страница «Настройки» в Админке.