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 );