当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

「関数リファレンス/get attached media」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(和訳完了。)
(和訳をクリーンアップ。原文リンク、言語間リンクを追記。)
 
(2人の利用者による、間の4版が非表示)
2行目: 2行目:
 
== 説明 ==
 
== 説明 ==
 
</div>
 
</div>
過去の投稿に添付されたメディアを読み出す関数です。[[Function_Reference/get_children|get_children()]] 関数を用います。
+
指定された投稿に添付されたメディアを読み出す関数です。[[関数リファレンス/get_children|get_children()]] 関数を用います。
  
 
<div id="Usage">
 
<div id="Usage">
== 使用法 ==
+
== 使い方 ==
 
</div>
 
</div>
 
  <?php get_attached_media( $type, $post_id ) ?>
 
  <?php get_attached_media( $type, $post_id ) ?>
12行目: 12行目:
 
== パラメータ ==
 
== パラメータ ==
 
</div>
 
</div>
{{Parameter|$type|string|所望するメディアの種類 (MIME)。}}
+
{{Parameter|$type|文字列|所望するメディアの種類(MIME タイプ)。}}
{{Parameter|$post_id|integer|投稿 ID。デフォルトでは現在の投稿 ID。|optional|0}}
+
{{Parameter|$post_id|整数|投稿 ID。|オプション|0 &mdash; 現在の投稿}}
  
 
<div id="Return">
 
<div id="Return">
 
== 戻り値 ==
 
== 戻り値 ==
 
</div>
 
</div>
{{Return||array|読み出されたメディアの [[Class_Reference/WP_Post|WP_Post]] オブジェクト。}}
+
{{Return||配列|読み出されたメディアの [[クラスリファレンス/WP_Post|WP_Post]] オブジェクト。}}
  
<div id="Example">
+
<div id="Examples">
== 使用例 ==
+
== 用例 ==
 
</div>
 
</div>
今の投稿にある添付画像を取得する場合。
+
現在の投稿に添付された画像を取得します:
 
<pre>
 
<pre>
 
$media = get_attached_media( 'image' );
 
$media = get_attached_media( 'image' );
 
</pre>
 
</pre>
  
ID が102番の投稿から、 mime-type が 'audio' の添付を取得する場合。
+
ID が 102 番の投稿から、mime-type が 'audio' の添付メディアを取得します:
 
<pre>
 
<pre>
 
$media = get_attached_media( 'audio', 102 );
 
$media = get_attached_media( 'audio', 102 );
 
</pre>
 
</pre>
  
<div id="Change Log">
+
<div id="Change_Log">
== 改訂履歴 ==
+
== 変更履歴 ==
 
</div>
 
</div>
 
* [[Version 3.6|3.6.0]] にて導入されました。
 
* [[Version 3.6|3.6.0]] にて導入されました。
  
<div id="Source File">
+
<div id="Source_File">
 
== ソースファイル ==
 
== ソースファイル ==
 
</div>
 
</div>
48行目: 48行目:
 
{{Audio Tags}}
 
{{Audio Tags}}
 
{{Video Tags}}
 
{{Video Tags}}
 +
{{Attachment Tags}}
 
{{Tag Footer}}
 
{{Tag Footer}}
  
{{原文| get attached media |134555}}<!-- 12:49, 15 August 2013 Djkaz 版 -->
+
{{原文|Function_Reference/get_attached_media|151041}} <!-- 20:16, 21 April 2015 Tomauger 版 -->
  
[[Category:Functions]]
+
{{DEFAULTSORT:Get_attached_media}}
 +
[[Category:添付ファイル]]
 +
[[Category:wp3.6]]
 +
 
 +
[[en:Function Reference/get attached media]]

2015年5月19日 (火) 22:38時点における最新版

指定された投稿に添付されたメディアを読み出す関数です。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最新版との差分