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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(英文をコピペ。)
 
(和訳完了。)
1行目: 1行目:
== Description ==
+
<div id="Description">
Retrieve media attached to the passed post. Uses [[Function_Reference/get_children|get_children()]].
+
== 説明 ==
 +
</div>
 +
過去の投稿に添付されたメディアを読み出す関数です。[[Function_Reference/get_children|get_children()]] 関数を用います。
  
== Usage ==
+
<div id="Usage">
%%% <?php get_attached_media( $type, $post_id ) ?> %%%
+
== 使用法 ==
 +
</div>
 +
<?php get_attached_media( $type, $post_id ) ?>
  
== Parameters ==
+
<div id="Parameters">
{{Parameter|$type|string|(Mime) type of media desired.}}
+
== パラメータ ==
{{Parameter|$post_id|integer|Post ID, by default the current post ID.|optional|0}}
+
</div>
 +
{{Parameter|$type|string|所望するメディアの種類 (MIME)}}
 +
{{Parameter|$post_id|integer|投稿 ID。デフォルトでは現在の投稿 ID。|optional|0}}
  
== Return ==
+
<div id="Return">
{{Return||array|[[Class_Reference/WP_Post]] objects of found attachments.}}
+
== 戻り値 ==
 +
</div>
 +
{{Return||array|読み出されたメディアの [[Class_Reference/WP_Post|WP_Post]] オブジェクト。}}
  
== Examples ==
+
<div id="Example">
Get image attachment(s) to the current Post:
+
== 使用例 ==
 +
</div>
 +
今の投稿にある添付画像を取得する場合。
 
<pre>
 
<pre>
 
$media = get_attached_media( 'image' );
 
$media = get_attached_media( 'image' );
 
</pre>
 
</pre>
  
Get attachment(s) of mime-type 'audio' to the Post with an ID of 102:
+
ID が102番の投稿から、 mime-type 'audio' の添付を取得する場合。
 
<pre>
 
<pre>
 
$media = get_attached_media( 'audio', 102 );
 
$media = get_attached_media( 'audio', 102 );
 
</pre>
 
</pre>
  
== Change Log ==
+
<div id="Change Log">
* Since: [[Version 3.6|3.6.0]]
+
== 改訂履歴 ==
 +
</div>
 +
* [[Version 3.6|3.6.0]] にて導入されました。
  
== Source File ==
+
<div id="Source File">
<tt>get_attached_media()</tt> is located in {{Trac|wp-includes/media.php}}.
+
== ソースファイル ==
 +
</div>
 +
<tt>get_attached_media()</tt> {{Trac|wp-includes/media.php}} にあります。
  
== Related ==
+
<div id="Related">
 +
== 関連項目 ==
 +
</div>
 
{{Audio Tags}}
 
{{Audio Tags}}
 
 
{{Video Tags}}
 
{{Video Tags}}
 +
{{Tag Footer}}
  
{{Tag Footer}}
+
{{原文| get attached media |134555}}<!-- 12:49, 15 August 2013 Djkaz 版 -->
  
 
[[Category:Functions]]
 
[[Category:Functions]]

2013年8月15日 (木) 23:05時点における版

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