Обзор
Обновляет строку данных в существующем значении поля Repeater или Flexible Content.
Параметры
update_row($selector, $row, $value, [$post_id])$selector(string) (Обязательный) Имя или ключ поля.$row(int) (Обязательный) Номер строки для обновления.$value(array) (Обязательный) Новые данные строки.$post_id(mixed) (Необязательный) ID записи, в которой сохраняется значение. По умолчанию используется текущая запись.
Возвращаемое значение
(bool) Возвращает true при успешном обновлении и false при ошибке.
История изменений
- Добавлена в версии 5.3.2
Примеры
Добавление новой строки с использованием имён полей
В этом примере показано, как обновить первую строку данных существующего поля repeater с именем «images». Это поле repeater содержит 3 подчинённых поля («image», «alt», «link»).
Дополнительную информацию об индексе см. в примечаниях ниже.
$row = array(
'image' => 123,
'alt' => 'Ещё один прекрасный закат',
'link' => 'http://website.com'
);
update_row('images', 1, $row);Примечания
Смещение индекса
При обращении к определённому номеру строки обратите внимание, что нумерация строк начинается с 1, а не с 0. Это означает, что первая строка имеет индекс 1, вторая — индекс 2 и так далее.
Чтобы начать нумерацию индексов с 0, используйте настройку row_index_offset следующим образом.
functions.php
add_filter('acf/settings/row_index_offset', '__return_zero');Обновлено: 30.09.2026