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

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

「関数リファレンス/is attachment」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(Djkazトーク)による第5549版を取り消し)
(誤って、wp_get_attachment_imagesの内容を貼り付けてしまったため取り消します。 Djkazトーク)による第5548版を取り消し)
2行目: 2行目:
 
== 説明 ==
 
== 説明 ==
 
</div>
 
</div>
添付が存在する場合は、添付ファイルのページにHTMLのイメージエレメントを、無い場合は空の文字列を返します。
+
 
 +
この [[条件分岐タグ|条件分岐タグ]] は、添付が表示されているかどうかをチェックします。添付とはアップロードユーティリティーからアップロードされたイメージや他のファイルを指します。添付は「ページ」またはテンプレートの上に表示されます。詳しくは、[[イメージとファイル添付を使う方法]]を参照してください。
 +
 
 +
これはboolean関数なので、戻り値は''TRUE''か''FALSE''です。
  
 
<div id="Usage">
 
<div id="Usage">
 
== 使い方 ==
 
== 使い方 ==
 
</div>
 
</div>
  <?php wp_get_attachment_image( $attachment_id, $size, $icon, $attr ); ?>
+
  <?php is_attachment(); ?>
 
+
<div id="Default_usage">
+
== デフォルトの使い方 ==
+
</div>
+
<?php echo wp_get_attachment_image( 1 ); ?>
+
 
+
もし添付がイメージである場合、指定されたサイズのイメージを返します。
+
その他の添付の場合、<var>$icon</var> パラメーターが <tt>true</tt> に指定されている場合、関数はメディアアイコンを返します。
+
 
+
テンプレートの中に添付IDをダイナミックに取得する場合は、 [[テンプレートタグ/get_posts|get_posts('post_type=attachment')]] などを用います。
+
  
 
<div id="Parameters">
 
<div id="Parameters">
 
== パラメータ ==
 
== パラメータ ==
 
</div>
 
</div>
{{Parameter|$attachment_id|integer|所望する添付のID。}}
 
  
{{Parameter|$size|文字列または配列|イメージの大きさ。文字列のキーワード (thumbnail, medium, large, full)または2つのアイテムを持つ配列が幅と高さをピクセルで、<tt>array(32,32)</tt>という形で表します。[[Version 2.5]]以降、このパラメーターはメディアアイコンの大きさを変えることができなくなりました。これは常に元の大きさで表示されるためです。|Optional|'thumbnail'}}
+
<div id="Return_Values">
 
+
== 戻り値 ==
全てのイメージサイズをチェックする必要がある文字列の代わりに、<code>add_image_size</code> を用いてサイズを登録することを考慮すると良いでしょう。これによって切り抜かれた版が生成されます。これは、最も近いサイズのイメージを探すより、遥かに効率的なやり方です。
+
</div>
 
+
; <tt>(boolean)</tt> : 添付を表示している場合は <tt>true</tt>,それ以外は <tt>false</tt>
{{Parameter|$icon|boolean|添付を表すメディアアイコンを使用する。|Optional|'False'}}
+
:* <tt>1 (True)</tt>  
+
:* <tt>0 (False)</tt> - デフォルト
+
 
+
{{Parameter|$attr|属性の文字列または配列|検索文字列または配列|Optional}}
+
<pre>
+
$default_attr = array(
+
'src' => $src,
+
'class' => "attachment-$size",
+
'alt'  => trim(strip_tags( get_post_meta($attachment_id, '_wp_attachment_image_alt', true) )),
+
);
+
</pre>
+
 
+
<tt>$attr</tt>の引数はWordPressのデフォルト引数に統合され、<tt>wp_get_attachment_image_attributes</tt>フィルタを通して渡されます。
+
  
 
<div id="Examples">
 
<div id="Examples">
 
== 用例 ==
 
== 用例 ==
 
</div>
 
</div>
<div id="Display_all_images_as_a_list">
+
<pre>
=== 全てのイメージをリストとして表示する場合 ===
+
&lt;?php
</div>
+
if ( is_attachment() ) {
ページに添付されている全てのイメージとタイトルを表示し、箇条書きのリストとして表示する場合は、以下を用います。
+
// show adv. #1
<pre><ul>
+
} else {
<?php if ( have_posts() ) : while ( have_posts() ) : the_post();  
+
// show adv. #2
 +
}
 +
?&gt;
 +
</pre>
  
$args = array(
+
<div id="Notes">
  'post_type' => 'attachment',
+
== ==
  'numberposts' => -1,
+
  'post_status' => null,
+
  'post_parent' => $post->ID
+
  );
+
 
+
  $attachments = get_posts( $args );
+
    if ( $attachments ) {
+
        foreach ( $attachments as $attachment ) {
+
          echo '<li>';
+
          echo wp_get_attachment_image( $attachment->ID, 'full' );
+
          echo '<p>';
+
          echo apply_filters( 'the_title', $attachment->post_title );
+
          echo '</p></li>';
+
          }
+
    }
+
 
+
endwhile; endif; ?>
+
</ul></pre>
+
 
+
<div id="Return_value">
+
== 戻り値 ==
+
 
</div>
 
</div>
HTMLの<tt>img</tt>エレメントもしくは、失敗した場合は空の文字列が返されます。
+
* [[関数リファレンス/is singular|is_singular()]]も参照してください。
 +
* より特定の添付をチェックするためには、[[関数リファレンス/wp attachment is image]]を参照してください。
  
<div id="Change_log">
+
<div id="Change_Log">
 
== 変更履歴 ==
 
== 変更履歴 ==
 
</div>
 
</div>
2.5.0にて導入されました。
+
* 2.0.0より導入
  
<div id="Source_file">
+
<div id="Source_File">
 
== ソースファイル ==
 
== ソースファイル ==
 
</div>
 
</div>
<tt>wp_get_attachment_image()</tt> は {{Trac|wp-includes/media.php}}にあります。
+
<!-- Need links to current source code files -->
 +
<tt>is_attachment()</tt>は{{Trac|wp-includes/query.php}}に含まれています。
  
 +
<div id="Related">
 
== 関連資料 ==
 
== 関連資料 ==
 
</div>
 
</div>
{{Attachment Tags}}
+
 
 +
{{Conditional Tags}}
  
 
{{Tag Footer}}
 
{{Tag Footer}}
{{原文|Function Reference/wp get attachment image|125179}}<!-- 23:30, 29 December 2012 SergeyBiryukov -->
+
{{原文|Function Reference/is attachment|126756}}<!-- 21:27, 6 February 2013 Bcworkz -->
 +
[[Category:条件分岐タグ]]
 
[[Category:関数]]
 
[[Category:関数]]
[[Category:New page created]]
 

2013年6月22日 (土) 18:48時点における版

この 条件分岐タグ は、添付が表示されているかどうかをチェックします。添付とはアップロードユーティリティーからアップロードされたイメージや他のファイルを指します。添付は「ページ」またはテンプレートの上に表示されます。詳しくは、イメージとファイル添付を使う方法を参照してください。

これはboolean関数なので、戻り値はTRUEFALSEです。

使い方

<?php is_attachment(); ?>

パラメータ

戻り値

(boolean) 
添付を表示している場合は true,それ以外は false

用例

<?php
if ( is_attachment() ) {
	// show adv. #1
} else {
	// show adv. #2
}
?>

変更履歴

  • 2.0.0より導入

ソースファイル

is_attachment()wp-includes/query.phpに含まれています。

条件分岐タグis_404(), is_admin(), is_admin_bar_showing(), is_archive(), is_attachment(), is_author(), is_category(), is_comments_popup(), is_date(), is_day(), is_feed(), is_front_page(), is_home(), is_local_attachment(), is_main_query, /is_multi_author, is_month(), is_new_day(), is_page(), is_page_template(), is_paged(), is_plugin_active(), is_plugin_active_for_network() /en, is_plugin_inactive() /en, is_plugin_page() /en, is_post_type_archive(), is_preview() /en, is_search(), is_single(), is_singular(), is_sticky(), is_tag(), is_tax(), is_taxonomy_hierarchical(), is_time(), is_trackback(), is_year(), in_category(), in_the_loop(), is_active_sidebar(), is_active_widget(), is_blog_installed() /en, is_rtl(), is_dynamic_sidebar(), is_user_logged_in(), has_excerpt(), has_post_thumbnail(), has_tag(), pings_open(), email_exists(), post_type_exists(), taxonomy_exists(), term_exists(), username_exists() /en, wp_attachment_is_image(), wp_script_is()



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

最新英語版: WordPress Codex » Function Reference/is attachment最新版との差分