ACF - add

Обзор

Функция 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_row()