Обзор
Фильтрация объектов полей перед обработкой записи.
Описание
Этот фильтр позволяет изменять или заменять объекты полей, обрабатываемые для вывода JSON-LD у записей. Верните ненулевое значение, чтобы переопределить получение полей по умолчанию через get_field_objects().
Это полезно для добавления пользовательских источников данных, исключения определённых полей или предоставления данных полей из альтернативных источников.
История изменений
- Добавлено в версии 6.8.0
Параметры
apply_filters( 'acf/schema/post_field_objects', $field_objects, $post, $post_type );
$field_objects(array|null) Массив объектов полей или null для использования получения данных по умолчанию$post(WP_Post) Объект записи$post_type(string) Имя типа записи
Возвращаемое значение
(array|null) Изменённый массив объектов полей или null для использования поведения по умолчанию.
Пример
Этот пример добавляет виртуальное поле для вычисляемых данных.
/**
* Добавляет вычисляемое поле в вывод JSON-LD.
*
* @param array|null $field_objects Массив объектов полей.
* @param WP_Post $post Объект записи.
* @param string $post_type Тип записи.
* @return array Изменённый массив объектов полей.
*/
function my_acf_schema_add_calculated_field( $field_objects, $post, $post_type ) {
// Получает объекты полей по умолчанию, если они ещё не заданы
if ( null === $field_objects ) {
$field_objects = get_field_objects( $post->ID, false );
}
if ( ! is_array( $field_objects ) ) {
$field_objects = array();
}
// Добавляет вычисляемое общее время для рецептов
if ( $post_type === 'recipe' ) {
$prep_time = get_field( 'prep_time', $post->ID );
$cook_time = get_field( 'cook_time', $post->ID );
$field_objects['total_time'] = array(
'value' => $prep_time + $cook_time,
'schema_property' => 'totalTime',
'type' => 'number',
);
}
return $field_objects;
}
add_filter( 'acf/schema/post_field_objects', 'my_acf_schema_add_calculated_field', 10, 3 );
Этот пример исключает определённые поля из вывода JSON-LD.
/**
* Исключает внутренние поля из вывода JSON-LD.
*
* @param array|null $field_objects Массив объектов полей.
* @param WP_Post $post Объект записи.
* @param string $post_type Тип записи.
* @return array Изменённый массив объектов полей.
*/
function my_acf_schema_exclude_internal_fields( $field_objects, $post, $post_type ) {
if ( null === $field_objects ) {
$field_objects = get_field_objects( $post->ID, false );
}
if ( ! is_array( $field_objects ) ) {
return $field_objects;
}
// Удаляет поля, начинающиеся с символа подчёркивания
foreach ( $field_objects as $key => $field ) {
if ( strpos( $key, '_' ) === 0 ) {
unset( $field_objects[ $key ] );
}
}
return $field_objects;
}
add_filter( 'acf/schema/post_field_objects', 'my_acf_schema_exclude_internal_fields', 10, 3 );
Обновлено: 30.09.2026