関数リファレンス/get attached media

説明

過去の投稿に添付されたメディアを読み出す関数です。get_children() 関数を用います。

使用法

<?php get_attached_media( $type, $post_id ) ?>

パラメータ

$type

（string） （必須） 所望するメディアの種類 (MIME)。

初期値： なし

$post_id

（integer） （optional） 投稿 ID。デフォルトでは現在の投稿 ID。

初期値： 0

戻り値

(array) 

読み出されたメディアの WP_Post オブジェクト。

使用例

今の投稿にある添付画像を取得する場合。

$media = get_attached_media( 'image' );

ID が102番の投稿から、 mime-type が 'audio' の添付を取得する場合。

$media = get_attached_media( 'audio', 102 );

改訂履歴

• 3.6.0 にて導入されました。

ソースファイル

get_attached_media() は wp-includes/media.php にあります。

関連項目

オーディオ: wp_audio_shortcode(), wp_get_audio_extensions(), get_attached_audio(), get_attached_media(), get_embedded_audio(), get_embedded_media(), wp_embed_handler_audio(), wp_mediaelement_fallback(), wp_read_audio_metadata(), wp_add_id3_tag_data(), the_post_format_audio(), get_the_post_format_media(), get_content_audio(), get_content_media()

ビデオ: wp_video_shortcode(), wp_get_video_extensions(), get_attached_video(), get_attached_media(), get_embedded_video(), get_embedded_media(), wp_embed_handler_video(), wp_mediaelement_fallback(), wp_read_video_metadata(), wp_add_id3_tag_data(), the_post_format_video(), get_the_post_format_media(), get_content_video(), get_content_media()

関数リファレンス、テンプレートタグ目次もご覧ください。

最新英語版： WordPress Codex » get attached media （最新版との差分）