Справочник по функциям/get children
Описание
Функция get_children() получает вложения, ревизии записи (предыдущие версии) или ее подстраницы, если запись является родительской для других. Работает почти так же, как и функция get_posts()).
Использование
<?php $children =& get_children($args, $output); ?>
Параметры
Для ознакомления с полным списком параметров стоит посмотреть на фукнцию get_posts().
Начиная с Версии 2.6, вы должны использовать не пустое значение параметра post_type (attachment или page).
- $args
- (mixed) (optional) В качестве значения можно передать несколько параметров в стиле «query-string» или массив (как показано ниже). Если в качестве значения установить ID записи или ее объект, то функция получит подстраницы для этой записи. Передача пустого значения приведет к получению подстраниц к текущей записи или странице.
- Default: None
- $args['numberposts']
- (integer) (optional) Количество подстраниц, которое нужно получить. Если равно -1, то будут получены все подстраницы.
- Default: -1
- $args['post_parent']
- (integer) (optional) ID записи или страницы, подстраницы к которой нужно получить. Если передать null то можно получить любые подстраницы, независимо от родительской.
- Default: null
- $args['post_type']
- (string) (optional) Может принимать любое значение из столбца post_type таблицы записей (wp_posts). Например, attachment, page или revision или же ключевое слово any.
- Default: any
- $args['post_status']
- (string) (optional) Любое значение из столбца post_status таблицы записей ($prefix_posts). Например publish, draft, inherit или же ключевое слово any.
- Default: any
- $args['post_mime_type']
- (string) (optional) Полный или частичный mime-тип. Например, image, video, video/mp4.
- Default: None
- $output
- (constant) (optional) Формат возвращаемых функцией данных. Один из трех вариантов OBJECT, ARRAY_A или ARRAY_N
- Default: OBJECT
Возвращаемые значения
См. возвращаемые значения для функции get_posts().
Примеры
$images =& get_children( 'post_type=attachment&post_mime_type=image' );
$videos =& get_children( 'post_type=attachment&post_mime_type=video/mp4' );
if ( empty($images) ) {
// Нет вложенных изображений.
} else {
foreach ( $images as $attachment_id => $attachment ) {
echo wp_get_attachment_image( $attachment_id, 'full' );
}
}
// Если вы не хотите проверять наличие пустого результата:
foreach ( (array) $videos as $attachment_id => $attachment ) {
echo wp_get_attachment_link( $attachment_id );
}
Родственные функции
get_children() вызывает get_posts(), которая в свою очередь вызывает метод $WP_Query->get_posts(), wp_get_attachment_link()
Исходник
get children() объявляется в /wp-includes/post.php.