Обзор
Функция add_row() добавляет новую строку данных в существующее поле повторителя.
История изменений
- Добавлено в v5.3.2
Параметры
add_row( $selector, $value, $post_id )
- $selector (строка) (обязательное) Имя поля повторителя, которое необходимо изменить
- $value (массив) (обязательное) Новое значение для добавления
- $post_id (число) (необязательное) ID поста. По умолчанию текущий пост
Возвращает
Функция возвращает новое значение количества строк в случае успеха и false при неудаче.
Примеры
Базовый
В этом примере показано, как добавить новую строку данных в существующее поле повторителя под названием «images». Это поле повторителя содержит 3 подполя (‘image’, ‘alt’, ‘link’).
<?php
$row = array(
'image' => 123,
'alt' => 'Another great sunset',
'link' => 'http://website.com'
);
add_row('images', $row);
?>
Базовый (используя ключи)
В этом примере показано, как добавить новую строку данных в существующее поле повторителя, используя поля вместо имен. Поле повторителя аналогичное представленному выше.
Так же как и в функции update_field(), использование ключа поля вместо его имени позволяет ACF правильно определить поле, если существующее значение не было сохранено. Другими словами, если значение поля повторителя не существует, эта функция завершится неудачей.
<?php
$row = array(
'field_560389746a525' => 123,
'field_560389746a524' => 'Another great sunset',
'field_560389746a528' => 'http://website.com'
);
add_row('field_560389746a51f', $row);
?>
Похожие
- Функция: add_sub_row()
- Функция: update_sub_row()