Обзор
Добавляет новую строку данных к существующему значению поля Repeater или Flexible Content.
Параметры
add_row($selector, $value, [$post_id])$selector(string) (Обязательный) Имя или ключ поля.$value(array) (Обязательный) Данные новой строки.$post_id(mixed) (Необязательный) ID записи, в которой сохраняется значение. По умолчанию используется текущая запись.
Возвращаемое значение
(int|false) Новое общее количество строк при успешном обновлении или false в случае ошибки.
Журнал изменений
- Добавлено в версии 5.3.2
Примеры
Добавление новой строки с использованием имён полей
В этом примере показано, как добавить новую строку данных в существующее поле repeater с именем ‘images’. Это поле repeater содержит 3 подчинённых поля (‘image’, ‘alt’, ‘link’).
$row = array(
'image' => 123,
'alt' => 'Ещё один прекрасный закат',
'link' => 'http://website.com'
);
add_row('images', $row);Добавление новой строки с использованием ключей полей
В этом примере показано, как добавить новую строку данных в существующее поле repeater, используя ключи вместо имён. Используется то же поле repeater, что и выше.
Как и в функции update_field(), использование ключа поля вместо его имени позволяет ACF правильно найти поле, если для него ещё не было сохранено значение.
$row = array(
'field_560389746a525' => 123,
'field_560389746a524' => 'Ещё один прекрасный закат',
'field_560389746a528' => 'http://website.com'
);
add_row('field_560389746a51f', $row);Обновлено: 30.09.2026