WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Справочник по функциям/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.

См. также содержание справочника по функциям и список тегов шаблонов.