acf/schema/render_script

Обзор

Action-хук, который вызывается перед рендерингом тега script с JSON-LD.

Описание

Этот action позволяет выполнить код непосредственно перед тем, как тег script с JSON-LD будет выведен на страницу. Это полезно для логирования, аналитики или добавления дополнительной разметки вокруг вывода JSON-LD.

Примечание: это action-хук, а не фильтр. Он не изменяет данные JSON-LD.

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

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

Параметры

do_action( 'acf/schema/render_script', $jsonld_data );
  • $jsonld_data (array) Массив данных JSON-LD, который будет выведен

Пример

В этом примере выполняется логирование вывода JSON-LD для отладки.

/**
 * Журналирование данных JSON-LD перед выводом.
 *
 * @param array $jsonld_data Массив данных JSON-LD.
 */
function my_acf_schema_log_output( $jsonld_data ) {
    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        error_log( 'ACF JSON-LD Output: ' . wp_json_encode( $jsonld_data ) );
    }
}
add_action( 'acf/schema/render_script', 'my_acf_schema_log_output' );

В этом примере перед JSON-LD добавляется комментарий для идентификации.

/**
 * Добавление идентифицирующего комментария перед JSON-LD.
 *
 * @param array $jsonld_data Массив данных JSON-LD.
 */
function my_acf_schema_add_comment( $jsonld_data ) {
    $type = $jsonld_data['@type'] ?? 'Unknown';
    echo '<!-- Схема ACF: ' . esc_html( $type ) . ' -->' . "\n";
}
add_action( 'acf/schema/render_script', 'my_acf_schema_add_comment' );

В этом примере отслеживается, какие типы схемы выводятся.

/**
 * Отслеживание использования типа схемы.
 *
 * @param array $jsonld_data Массив данных JSON-LD.
 */
function my_acf_schema_track_usage( $jsonld_data ) {
    if ( ! isset( $jsonld_data['@type'] ) ) {
        return;
    }

    // Отправка в аналитику
    if ( function_exists( 'my_analytics_track' ) ) {
        my_analytics_track( 'schema_rendered', array(
            'type'    => $jsonld_data['@type'],
            'post_id' => get_the_ID(),
        ) );
    }
}
add_action( 'acf/schema/render_script', 'my_acf_schema_track_usage' );

Обновлено: 02.06.2026