acf/schema/render_script — хук действия

Обзор

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

Описание

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

Примечание: это хук действия, а не фильтр. Он не изменяет данные 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 Schema: ' . 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' );

Обновлено: 30.09.2026