• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

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

提供: WordPress Codex 日本語版
移動先: 案内検索

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

使い方

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

パラメータ

$type
文字列) (必須) 所望するメディアの種類(MIME タイプ)。
初期値: なし
$post_id
整数) (オプション) 投稿 ID。
初期値: 0 — 現在の投稿

戻り値

(配列) 
読み出されたメディアの 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()


添付ファイル関数: get_children(), get attached media(), the_attachment_link(), get_attachment_link(), wp_get_attachment_link(), wp_get_attachment_image(), wp_get_attachment_image_src(), wp_get_attachment_url(), wp_get_attachment_thumb_file(), wp_get_attachment_thumb_url(), is_attachment(), wp_get_attachment_metadata()


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


最新英語版: WordPress Codex » Function_Reference/get_attached_media最新版との差分