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

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

「テンプレートタグ/get attachment link」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(英語版をコピペ)
 
1行目: 1行目:
== Description ==
+
<div id="Description">
 +
== 説明 ==
 +
</div>
 +
[[Templates_Hierarchy#Attachment_display|添付ページ]]の URI を返す関数。
  
Returns the URI of [[Templates_Hierarchy#Attachment_page|the page for an attachment]].
+
<div id="Usage">
 +
== 使い方 ==
 +
</div>
  
== Usage ==
+
<?php $attachment_page = get_attachment_link($id); ?>
  
%%% <?php $attachment_page = get_attachment_link($id); ?> %%%
+
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
 +
{{Parameter|$id|整数|[[Using_Image_and_File_Attachments|添付]]のID|optional|[[ループ]]内で使われる場合は現状の投稿ID}}
  
== Parameters ==
+
<div id="Examples">
{{Parameter|$id|integer|The numeric ID of the [[Using_Image_and_File_Attachments|attachment]].|optional|The current post ID, when used in [[The Loop]].}}
+
== 用例 ==
 +
</div>
  
== Examples ==
+
<div id="Default_usage">
 
+
=== デフォルトの使い方 ===
=== Default Usage ===
+
</div>
 
+
タグはパーマリンクを表示しないので、この例ではPHPの <tt>echo</tt> コマンドを使用します。
As the tag does not display the permalink, the example uses the PHP echo command. 
+
  
 
<pre><?php  
 
<pre><?php  
$attachment_id = 1; // ID of attachment
+
$attachment_id = 1; // 添付のID
 
$attachment_page = get_attachment_link( $attachment_id );  
 
$attachment_page = get_attachment_link( $attachment_id );  
 
?>
 
?>
 
<a href="<?php echo $attachment_page; ?>"><?php echo get_the_title( $attachment_id ); ?></a></pre>
 
<a href="<?php echo $attachment_page; ?>"><?php echo get_the_title( $attachment_id ); ?></a></pre>
  
=== Display attached images and titles as a list ===
+
<div id="Display attached images and titles as a list">
 
+
=== 添付イメージとタイトルをリストとして表示させる ===
To display the images attached to a certain page and display them as a list of bullets you can use the following:
+
</div>
 +
特定のページに貼られた画像を表示し、それを箇条書きで表示させるには以下を用います。
  
 
<pre><ul>
 
<pre><ul>
50行目: 59行目:
 
</ul></pre>
 
</ul></pre>
  
== Return value ==
+
<div id="Return_value">
 
+
== 戻り値 ==
Under a [[Using_Permalinks#mod_rewrite:_.22Pretty_Permalinks.22|"pretty" permalink structure]], the function returns something like <tt><nowiki>http://wp.example.net</nowiki>/<var>path_to_post</var>/<var>post_name</var>/<var>attachment_name</var></tt>.
+
</div>
 +
[[Using_Permalinks#mod_rewrite:_.22Pretty_Permalinks.22|"pretty" なパーマリンク構造]]では、関数は以下の様な形式を返します。
 +
* <tt><nowiki>http://wp.example.net</nowiki>/<var>path_to_post</var>/<var>post_name</var>/<var>attachment_name</var></tt>
  
Under [[Using_Permalinks#Default:_.22Ugly.22|the default permalink structure]] — or if Wordpress can't construct a pretty URI — the function returns something like <tt><nowiki>http://wp.example.net</nowiki>/?attachment_id=<var>n</var></tt>, where <var>n</var> is the attachment ID number.
+
[Using_Permalinks#Default:_.22Ugly.22|デフォルトの "Ugly" なパーマリンク構造]]、もしくはWordPressが "pretty" なURIを作ることが出来なかった場合、関数は以下の様な形式を返します。
 +
* <tt><nowiki>http://wp.example.net</nowiki>/?attachment_id=<var>n</var></tt>
  
== Notes ==
+
この時、 <var>n</var> は添付のIDを表します。
  
You can change the output of this function through the <tt>[[Plugin_API/Filter_Reference#Link_Filters|attachment_link]]</tt> filter.
+
<div id="Notes">
 +
== 注釈 ==
 +
</div>
  
If you want a direct link to the attached file (instead of the attachment page), you can use the function <tt>[[Function_Reference/wp_get_attachment_url|wp_get_attachment_url]](<var>id</var>)</tt> instead.
+
この関数の出力は <tt>[[Plugin_API/Filter_Reference#リンク関連のフィルター|attachment_link]]</tt> フィルターを通して変更することができます。
  
'''Note''': that <tt>get_attachment_link</tt> actually returns an URI, whereas <tt>[[Function_Reference/wp_get_attachment_link|wp_get_attachment_link()]]</tt> returns an HTML hyperlink.
+
添付ページの代わりに添付ファイルへの直リンクが必要な場合、<tt>[[Function_Reference/wp_get_attachment_url|wp_get_attachment_url]](<var>id</var>)</tt> をを用いてください。
  
== Source File ==
+
'''注''': <tt>[[Function_Reference/wp_get_attachment_link|wp_get_attachment_link()]]</tt> がHTMLのハイパーリンクを返すのに対して、<tt>get_attachment_link</tt> はURIを返します。
  
<tt>get_attachment_link()</tt> is located in {{Trac|wp-includes/link-template.php|tags/3.4.2|292}}.
+
<div id="Source_file">
 +
== ソースファイル ==
 +
</div>
 +
<tt>get_attachment_link()</tt> {{Trac|wp-includes/link-template.php}} にあります。
  
 
[[Category:Attachments]]
 
[[Category:Attachments]]
 
[[Category:Template_Tags]]
 
[[Category:Template_Tags]]
  
== Related ==
+
<div id="Related">
 +
== 関連資料 ==
 +
</div>
 
{{Attachment Tags}}
 
{{Attachment Tags}}
 +
{{原文|Function Reference/get attachment link|123379}}<!-- 13:56, 25 November 2012 M0r7if3r  -->
  
 
[[Category:Attachments]]
 
[[Category:Attachments]]
 
[[Category:Template_Tags]]
 
[[Category:Template_Tags]]

2013年6月30日 (日) 07:56時点における版

添付ページの URI を返す関数。

使い方

<?php $attachment_page = get_attachment_link($id); ?>

パラメータ

$id
整数) (optional添付のID
初期値: ループ内で使われる場合は現状の投稿ID

用例

デフォルトの使い方

タグはパーマリンクを表示しないので、この例ではPHPの echo コマンドを使用します。

<?php 
$attachment_id = 1; // 添付のID
$attachment_page = get_attachment_link( $attachment_id ); 
?>
<a href="<?php echo $attachment_page; ?>"><?php echo get_the_title( $attachment_id ); ?></a>

添付イメージとタイトルをリストとして表示させる

特定のページに貼られた画像を表示し、それを箇条書きで表示させるには以下を用います。

<ul>
<?php if ( have_posts() ) : while ( have_posts() ) : the_post();    

 $args = array(
   'post_type' => 'attachment',
   'numberposts' => -1,
   'post_status' => null,
   'post_parent' => $post->ID
  );

  $attachments = get_posts( $args );
     if ( $attachments ) {
        foreach ( $attachments as $attachment ) {
           echo '<li>';
           the_attachment_link( $attachment->ID, true );
           echo '<p>';
           echo apply_filters( 'the_title', $attachment->post_title );
           echo '</p></li>';
          }
     }

 endwhile; endif; ?>
</ul>

戻り値

"pretty" なパーマリンク構造では、関数は以下の様な形式を返します。

  • http://wp.example.net/path_to_post/post_name/attachment_name

[Using_Permalinks#Default:_.22Ugly.22|デフォルトの "Ugly" なパーマリンク構造]]、もしくはWordPressが "pretty" なURIを作ることが出来なかった場合、関数は以下の様な形式を返します。

  • http://wp.example.net/?attachment_id=n

この時、 n は添付のIDを表します。

注釈

この関数の出力は attachment_link フィルターを通して変更することができます。

添付ページの代わりに添付ファイルへの直リンクが必要な場合、wp_get_attachment_url(id) をを用いてください。

: wp_get_attachment_link() がHTMLのハイパーリンクを返すのに対して、get_attachment_link はURIを返します。

ソースファイル

get_attachment_link()wp-includes/link-template.php にあります。

添付ファイル関数: 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 attachment link最新版との差分