Funkce get_children vrací podstránky, revize a přílohy, tedy attachment, jako jsou obrázky a jiné soubory přiložené k postu. Funguje podobně jako get_posts a do verze 3.6 byla jediným způsobem, jak získat obrázky přiřazené k článku.
Použití:
$children = get_children( $args = "", $output = OBJECT);
Parametry:
$arg – seznam argumentů pro výpis, podobné jako u WP_Query a get_posts.
Příklad:
$defaults = array(
'post_parent' => 0,
'post_type' => 'any',
'numberposts' => -1,
'post_status' => 'any'
);
Nejdůležitějším je post_mime_type, který určuje o jaký druh přiloženého souboru jde. Je samozřejmě závislý na post_type, které musí být attachment. Můžete tak vypsat image, video, audio. Pro seznam všech typů hledejte post_mime_type v Codexu WordPressu.
$output – určuje, zda bude vrácen objekt, nebo pole, defaultně OBJECT. Může nabývat těchto hodnot OBJECT, ARRAY_A, ARRAY_N.
Příklad pro výpis prvního obrázku, přiřazeného k postu. Dá se využít jako náhrada za thumbnail image, pokud si nejste jisti, zda jsou vložené.
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 );
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 'ID ) . '" class="current">';
}
}
}