Обзор
Эта функция удаляет подполе существующего поля повторителя или гибкого содержимого. Эта функция отличается от 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_row()
- Функция: add_sub_row()
- Функция: update_sub_row()
- Функция: update_sub_field()