acf/load_field
Позволяет изменить массив настроек любого поля после того, как они загружены.
Поле загружается всякий раз, когда оно отображается или запрашивается его значение. Этот фильтр применяется как к полям, сохраненным в базе данных, так и к полям, зарегистрированным локально через PHP или JSON.
Этот фильтр предоставляет модификаторы для определенных полей. Доступны следующие названия фильтров:
acf/load_field- Применяется ко всем полям.acf/load_field/type={$type}- Применяется ко всем полям определенного типа, например select (выпадающий список).acf/load_field/name={$name}- Применяется ко всем полям с определенным именем, например product_photo.acf/load_field/key={$key}- Применяется ко всем полям с определенным ключом, например field_123abcf.
Использование
add_filter( 'acf/load_field', 'wp_kama_acf_load_field_filter' );
/**
* Function for `acf/load_field` filter-hook.
*
* @param array $field The field array.
*
* @return array
*/
function wp_kama_acf_load_field_filter( $field ){
// filter...
return $field;
}
- $field(массив)
- Массив всех настроек поля.
Примеры
#1 Сделаем поле обязательным
function my_acf_load_field( $field ) {
$field['required'] = true;
return $field;
}
// Сделать все поля обязательными
// add_filter('acf/load_field', 'my_acf_load_field');
// Сделать обязательными только все выпадающие списки
// 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'); #2 Преобразование шорткодов в полях в админке
Пример вынесен в отдельную заметку.
Список изменений
| С версии 5.0.0 | Введена. |
Где вызывается хук
acf/load_field
acf/includes/acf-field-functions.php 58
$field = apply_filters( 'acf/load_field', $field );