acf/load_fieldхук-фильтрACF 5.0.0

Позволяет изменить массив настроек любого поля после того, как они загружены.

Поле загружается всякий раз, когда оно отображается или запрашивается его значение. Этот фильтр применяется как к полям, сохраненным в базе данных, так и к полям, зарегистрированным локально через 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;
}

Использование

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(массив)
Массив всех настроек поля.

Примеры

0

#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');
0

#2 Преобразование шорткодов в полях в админке

Пример вынесен в отдельную заметку.

Список изменений

С версии 5.0.0 Введена.

Где вызывается хук

acf_get_field()
acf/load_field
acf/includes/acf-field-functions.php 58
$field = apply_filters( 'acf/load_field', $field );

Где используется хук в Advanced Custom Fields

Использование не найдено.