Описание
Фильтрует значение поля $value после его загрузки.
Журнал изменений
- Добавлено в версии 4.0.0
Параметры
apply_filters( 'acf/load_value', $value, $post_id, $field );$value(mixed) Значение поля.$post_id(int|string) ID записи, где сохраняется значение.$field(array) Массив поля, содержащий все настройки.
Модификаторы
Этот фильтр позволяет использовать модификаторы для выбора конкретных полей. Доступны следующие имена фильтров:
acf/load_valueПрименяется ко всем полям.acf/load_value/type={$type}Применяется ко всем полям определенного типа.acf/load_value/name={$name}Применяется ко всем полям с определенным именем.acf/load_value/key={$key}Применяется ко всем полям с определенным ключом.
Пример
В этом примере показано, как изменить значение поля.
functions.php
function my_acf_load_value( $value, $post_id, $field ) {
if( is_string($value) ) {
$value = str_replace( 'Название старой компании', 'Название новой компании', $value );
}
return $value;
}
// Применить ко всем полям.
add_filter('acf/load_value', 'my_acf_load_value', 10, 3);
// Применить к полям textarea.
// add_filter('acf/load_value/type=textarea', 'my_acf_load_value', 10, 3);
// Применить к полям с именем "hero_text".
// add_filter('acf/load_value/name=hero_text', 'my_acf_load_value', 10, 3);
// Применить к полю с ключом "field_123abcf".
// add_filter('acf/load_value/key=field_123abcf', 'my_acf_load_value', 10, 3);Обновлено: 02.06.2026