Фильтр acf/schema/debug

Обзор

Включает HTML-комментарии отладки, показывающие шаги обработки JSON-LD.

Описание

Этот фильтр включает режим отладки для вывода JSON-LD. Когда он включен, ACF выводит HTML-комментарии, показывающие каждый шаг обработки JSON-LD, включая то, какие типы записей проверяются, какие поля найдены и почему вывод может быть пропущен.

Это полезно для поиска и устранения неполадок, когда JSON-LD не отображается ожидаемым образом.

Журнал изменений

  • Добавлено в версии 6.8.0

Параметры

apply_filters( 'acf/schema/debug', $debug );
  • $debug (bool) Выводить ли комментарии отладки. По умолчанию: false

Возвращает

(bool) Включен ли режим отладки.

Пример

Этот пример включает режим отладки.

add_filter( 'acf/schema/debug', '__return_true' );

Этот пример включает режим отладки только для администраторов.

/**
 * Включить режим отладки JSON-LD только для администраторов.
 *
 * @param bool $debug Включен ли режим отладки.
 * @return bool Изменённая настройка отладки.
 */
function my_acf_schema_debug_for_admins( $debug ) {
    if ( current_user_can( 'manage_options' ) ) {
        return true;
    }
    return $debug;
}
add_filter( 'acf/schema/debug', 'my_acf_schema_debug_for_admins' );

Вывод отладки

Когда включено, вы увидите такие HTML-комментарии:

<!-- ACF AI JSON-LD: Проверка типа записи: recipe -->
<!-- ACF AI JSON-LD: Найдено 8 полей ACF -->
<!-- ACF AI JSON-LD: Обработка поля 'prep_time' с schema_property 'prepTime' -->

Или когда вывод пропущен:

<!-- ACF AI JSON-LD: У типа записи 'post' не включен JSON-LD -->

Обновлено: 02.06.2026