Описание
Фильтрует значение поля $value после его загрузки шаблонной функцией, такой как get_field().
История изменений
- Добавлен в версии 5.0
- Ранее назывался "acf/format_value_for_api" в версии 4.0
Параметры
apply_filters( 'acf/format_value', $value, $post_id, $field );$value(mixed) Значение поля.$post_id(int|string) ID записи, где сохранено значение.$field(array) Массив поля, содержащий все настройки.
Модификаторы
Этот фильтр предоставляет модификаторы для выбора конкретных полей. Доступны следующие имена фильтров:
acf/format_valueПрименяется ко всем полям.acf/format_value/type={$type}Применяется ко всем полям определённого типа.acf/format_value/name={$name}Применяется ко всем полям с определённым именем.acf/format_value/key={$key}Применяется ко всем полям с определённым ключом.
Пример
Этот пример показывает, как изменить значение поля при загрузке шаблонной функцией.
functions.php
<?php
function my_acf_format_value( $value, $post_id, $field ) {
// Рендерить шорткоды во всех значениях textarea.
return do_shortcode( $value );
}
// Применить ко всем полям.
// add_filter('acf/format_value', 'my_acf_format_value', 10, 3);
// Применить к полям textarea.
add_filter('acf/format_value/type=textarea', 'my_acf_format_value', 10, 3);
// Применить к полям с именем "hero_text".
// add_filter('acf/format_value/name=hero_text', 'my_acf_format_value', 10, 3);
// Применить к полю с ключом "field_123abcf".
// add_filter('acf/format_value/key=field_123abcf', 'my_acf_format_value', 10, 3);Обновлено: 02.06.2026