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