Обзор
Фильтрует доступные свойства Schema.org для типа поля.
Описание
Этот фильтр позволяет изменять список свойств Schema.org, доступных в выпадающем списке настроек поля. Свойства фильтруются по совместимости с типом поля и упорядочиваются по типу Schema.org.
Журнал изменений
- Добавлено в версии 6.8.0
Параметры
apply_filters( 'acf/schema/schema_properties', $properties, $field_type );
$properties(array) Иерархический массив свойств, сгруппированных по типу Schema.org$field_type(string) Тип поля ACF (например,text,number,image)
Возврат
(array) Изменённый массив свойств.
Пример
В этом примере добавляются пользовательские свойства для текстовых полей.
/**
* Добавляет пользовательские свойства Schema.org.
*
* @param array $properties Сгруппированный массив свойств.
* @param string $field_type Тип поля ACF.
* @return array Изменённые свойства.
*/
function my_acf_schema_add_properties( $properties, $field_type ) {
if ( $field_type === 'text' ) {
// Добавляем пользовательские свойства для текстовых полей
$properties['Custom'] = array(
'customProperty' => 'customProperty',
'internalCode' => 'internalCode',
);
}
return $properties;
}
add_filter( 'acf/schema/schema_properties', 'my_acf_schema_add_properties', 10, 2 );
В этом примере удаляются свойства, которые не следует использовать.
/**
* Удаляет устаревшие свойства Schema.org.
*
* @param array $properties Сгруппированный массив свойств.
* @param string $field_type Тип поля ACF.
* @return array Изменённые свойства.
*/
function my_acf_schema_remove_deprecated( $properties, $field_type ) {
// Удаляем устаревшие свойства из всех типов
foreach ( $properties as $type => &$props ) {
if ( is_array( $props ) ) {
unset( $props['deprecatedProperty'] );
}
}
return $properties;
}
add_filter( 'acf/schema/schema_properties', 'my_acf_schema_remove_deprecated', 10, 2 );
Обновлено: 02.06.2026