Обзор
Управляйте тем, нужно ли автоматически добавлять изображение записи в вывод JSON-LD.
Описание
По умолчанию ACF автоматически включает изображение записи в вывод JSON-LD как ImageObject. Этот фильтр позволяет отключить такое поведение для отдельных записей или типов записей.
История изменений
- Добавлено в версии 6.8.0
Параметры
apply_filters( 'acf/schema/auto_add_image', $add_image, $post, $post_type );
$add_image(bool) Добавлять ли изображение записи. По умолчанию:true$post(WP_Post) Объект записи$post_type(string) Имя типа записи
Возвращаемое значение
(bool) Добавлять ли изображение записи в вывод JSON-LD.
Пример
В этом примере отключается автоматическое добавление изображения для товаров (вместо этого используется собственное поле изображения ACF).
/**
* Отключаем автоматическое изображение для товаров.
*
* @param bool $add_image Добавлять ли изображение записи.
* @param WP_Post $post Объект записи.
* @param string $post_type Тип записи.
* @return bool Добавлять ли изображение записи.
*/
function my_acf_schema_disable_product_image( $add_image, $post, $post_type ) {
if ( $post_type === 'product' ) {
return false;
}
return $add_image;
}
add_filter( 'acf/schema/auto_add_image', 'my_acf_schema_disable_product_image', 10, 3 );
В этом примере изображения добавляются только для записей, у которых задано изображение записи.
/**
* Добавляем изображение только если существует изображение записи.
*
* @param bool $add_image Добавлять ли изображение записи.
* @param WP_Post $post Объект записи.
* @param string $post_type Тип записи.
* @return bool Добавлять ли изображение записи.
*/
function my_acf_schema_require_featured_image( $add_image, $post, $post_type ) {
if ( ! has_post_thumbnail( $post->ID ) ) {
return false;
}
return $add_image;
}
add_filter( 'acf/schema/auto_add_image', 'my_acf_schema_require_featured_image', 10, 3 );
Обновлено: 02.06.2026