ACF - delete_sub

Обзор

Эта функция удаляет подполе существующего поля повторителя или гибкого содержимого. Эта функция отличается от delete_row(), которая удаляет строку родительского (основного) поля. Эту функцию можно использовать внутри или вне цикла have_rows() для выбора значения подполя, которое вы намерены изменить.

История изменений

Добавлено в v5.4.7

Параметры

delete_sub_row( $selector, $i, $post_id );

$selector (смешанный) (обязательное) Имя или ключ подполя, или массив родителей и номера строки
$i (число) (обязательное) Номер строки, который нужно изменить
$post_id (число) ID поста для которого будет сохраняться значение

Возвращает

Функция возвращает true в случае успеха и false при неудаче.

Примечания

Строки начинаются с 1 (не с 0). К примеру, первая строка значений будет $i = 1
Можно изменить индекс с которого начинаются строки. Для этого воспользуйтесь row_index_offset.

Примеры

В следующих примерах используется поле повторителя под названием «Parent», которое содержит дочерний повторитель. Вот иерархия подполей:

r1 (повторитель)
– r2 (повторитель)
— t1 (текст)
— t2 (текст)

Внутри цикла have_rows()

Этот пример будет обходит поле повторителя (r1) и удалять первую строку поля вложенного повторителя (r2).

<?php 

if( have_rows('r1') ) {

	while( have_rows('r1') ) {

		the_row();
		
		delete_sub_row('r2', 1);

	}

}

?>

Вне цикла have_rows()

В этом примере будет удалено значение подполя вне цикла has_rows(). Обратите внимание, что параметру $selector присваивается массив, содержащий комбинацию имен полей и номеров строк. Этот массив должен читать слева направо, отношения родителей с детьми, дополненные номером строки.

<?php 

// удаляем родительскую строку 1 => подполе 1
delete_sub_row( array('r1', 1, 'r2'), 1 );


// удаляем родительскую строку 2 => подполе 1
delete_sub_row( array('r1', 1, 'r2'), 2 );


// удаляем родительскую строку 2 => подполе 2
delete_sub_row( array('r1', 2, 'r2'), 1 );

?>

delete_sub_row()