get_children

get_children()は、親記事によって可能な、添付ファイル、リビジョン、またはサブページを取得します。get_posts()と同様な動作をします。

get_children() retrieves attachments, revisions, or sub-Pages, possibly by post parent. It works similarly to get_posts().

概要

[php]array|false $children =& get_children( mixed $args = “”, constant $output = OBJECT);[/php]

戻り値

配列キーとして投稿IDを持つ投稿の連想配列（$outputパラメータによって設定された変数の型の）、または投稿が見つからない場合は、空の配列を返します。

Returns an associative array of posts (of variable type set by $output parameter) with post IDs as array keys, or an empty array if no posts are found.

前のバージョン2.9は、戻り値が子が見つからなかったときにfalseとなります。

Prior to Version 2.9, the return value would be false when no children found.

例

添付ファイルを取得あるいは表示したい場合は、恐らく少し簡単にget_posts()の代わりに使用する事ができます。

If you just want to get or display attachments, it’s probably a little easier to use get_posts() instead.

[php]$images =& get_children( ‘post_type=attachment&post_mime_type=image’ );

$videos =& get_children( ‘post_type=attachment&post_mime_type=video/mp4’ );

if ( empty($images) ) {
// no attachments here
} else {
foreach ( $images as $attachment_id => $attachment ) {
echo wp_get_attachment_image( $attachment_id, ‘full’ );
}
}

// If you don’t need to handle an empty result:

foreach ( (array) $videos as $attachment_id => $attachment ) {
echo wp_get_attachment_link( $attachment_id );
}[/php]

記事に関連付けられている最初の画像を表示する方法

この関数は、記事に関連付けられた最初の画像を取得します。

This function retrieves the first image associated with a post

[php]function echo_first_image ($postID)
{
$args = array(
‘numberposts’ => 1,
‘order’=> ‘ASC’,
‘post_mime_type’ => ‘image’,
‘post_parent’ => $postID,
‘post_status’ => null,
‘post_type’ => ‘attachment’
);

$attachments = get_children( $args );

//print_r($attachments);

if ($attachments) {
foreach($attachments as $attachment) {
$image_attributes = wp_get_attachment_image_src( $attachment->ID, ‘thumbnail’ ) ? wp_get_attachment_image_src( $attachment->ID, ‘thumbnail’ ) : wp_get_attachment_image_src( $attachment->ID, ‘full’ );

echo ‘