Описание
Фильтрует массив настроек $field после загрузки.
Поле загружается каждый раз, когда оно отображается или когда загружается его значение. Этот фильтр применяется как к полям, сохранённым в базе данных, так и к полям, зарегистрированным локально через PHP или JSON.
Журнал изменений
- Добавлен в версии 4.0.0
Параметры
<?php
apply_filters( 'acf/load_field', $field );$field(array) Массив поля, содержащий все настройки.
Модификаторы
Этот фильтр поддерживает модификаторы для обращения к конкретным полям. Доступны следующие имена фильтров:
acf/load_fieldПрименяется ко всем полям.acf/load_field/type={$type}Применяется ко всем полям определённого типа.acf/load_field/name={$name}Применяется ко всем полям с определённым именем.acf/load_field/key={$key}Применяется ко всем полям с определённым ключом.
Пример
Этот пример показывает, как изменить настройки конкретного поля.
functions.php
<?php
function my_acf_load_field( $field ) {
$field['required'] = true;
$field['choices'] = array(
'custom' => 'Мой пользовательский вариант',
'custom_2' => 'Мой пользовательский вариант 2'
);
return $field;
}
// Применить ко всем полям.
// add_filter('acf/load_field', 'my_acf_load_field');
// Применить к полям select.
// add_filter('acf/load_field/type=select', 'my_acf_load_field');
// Применить к полям с именем "custom_select".
add_filter('acf/load_field/name=custom_select', 'my_acf_load_field');
// Применить к полю с ключом "field_123abcf".
// add_filter('acf/load_field/key=field_123abcf', 'my_acf_load_field');Обновлено: 02.06.2026