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

「テンプレートタグ/the permalink」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(Version 4.4.0 にて$postパラメータが追加されました。)
 
(3人の利用者による、間の8版が非表示)
1行目: 1行目:
 
== 説明 ==
 
== 説明 ==
  
Displays the [[Glossary#URI and URL|URL]] for the [[Glossary#Permalink|permalink]] to the post currently being processed in [[The Loop]]. This tag must be within [[The Loop]], and is generally used to display the permalink for each post, when the posts are being displayed. Since this template tag is limited to displaying the permalink for the post that is being processed, you cannot use it to display the permalink to an arbitrary post on your weblog. Refer to [[Template_Tags/get_permalink|get_permalink()]] if you want to get the permalink for a post, given its unique post id.
+
[[ループ]] の中で処理されている投稿の [[Glossary#パーマリンク|パーマリンク]] [[Glossary#URI and URL|URL]] を表示します。このタグは [[ループ]] 内で使用されなければならず、一般的に各投稿のパーマリンクを表示するときに利用します。このテンプレートタグは処理されている投稿のパーマリンクを表示するだけです。そのため、あなたのブログにある任意の投稿のパーマリンクを表示するために使用することは出来ません。もしもユニークな投稿 ID を与えて投稿のパーマリンクを取得したいのなら、[[テンプレートタグ/get_permalink|get_permalink()]] を参照してください。
  
 
== 使い方 ==
 
== 使い方 ==
  
  <?php the_permalink(); ?>
+
  <?php the_permalink( $post ); ?>
  
== 引数 ==
+
== パラメータ ==
  
なし
+
{{Parameter|$post|複合|投稿または固定ページの整数型の ID、あるいは投稿オブジェクト|オプション|[[ループ]]内で使用した場合、表示中の投稿の ID。}}
  
 
== 用例 ==
 
== 用例 ==
  
=== Display Post URL as Text ===
+
=== テキストとして投稿のURLを表示 ===
  
Displays the URL to the post, without creating a link:
+
リンクせずに投稿の URL を表示。
  
 
  This address for this post is: &lt;?php the_permalink(); ?&gt;
 
  This address for this post is: &lt;?php the_permalink(); ?&gt;
  
=== As Link With Text ===
+
=== テキストを使ったリンク ===
  
You can use whatever text you like as the link text, in this case, "permalink".
+
リンクテキストとしてあなたの好きな文字列を使用することができます。この例では "permalink" です。
  
  &lt;a href="&lt;?php the_permalink(); ?&gt;"&gt;permalink&lt;/a&gt;
+
  <a href="<?php the_permalink(); ?>">permalink</a>
  
=== Used as Link With Title Tag===
+
=== タイトルタグを使ったリンク ===
  
Creates a link for the permalink, with the post's title as the link text. This is a common way to put the post's title.
+
投稿のタイトルをリンクテキストとしてパーマリンクを作成します。投稿のタイトルに使う一般的な方法です。
  
 
  <a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>"><?php the_title(); ?></a>
 
  <a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>"><?php the_title(); ?></a>
33行目: 33行目:
 
== 変更履歴 ==
 
== 変更履歴 ==
  
* Since: [[Version 1.2|1.2.0]]
+
* 導入: [[Version 1.2|1.2.0]]
* Originally defined in {{Trac|wp-includes/template-functions-links.php|tags/1.5|3}}
+
* 最初は {{Trac|wp-includes/template-functions-links.php}} の中で定義されていました。[[Version 1.5|1.5]] のときです。
* File renamed to {{Trac|wp-includes/link-template.php|tags/2.1|4}} in [[Version 2.1|2.1]]
+
* ファイル名が {{Trac|wp-includes/link-template.php}} へ変更されました。[[Version 2.1|2.1]] のときです。
 +
* [[Version 4.4.0|4.4.0]] のときに、$postパラメータが追加されました。
 +
 
  
 
== ソースコード ==
 
== ソースコード ==
  
<tt>the_permalink()</tt> is located in {{Trac|wp-includes/link-template.php}}.
+
<tt>the_permalink()</tt> {{Trac|wp-includes/link-template.php}} にあります。
  
 
== 関連項目 ==
 
== 関連項目 ==
  
 
{{Permalink Tags}}
 
{{Permalink Tags}}
 
{{原文|Function Reference/the permalink|140477}}<!-- 22:59, 9 January 2013 Outis 版 -->
 
  
 
{{Tag Footer}}
 
{{Tag Footer}}
 +
 +
{{原文|Function Reference/the permalink|145560}}<!-- 05:32, 14 August 2014 Hunterhogan 版 -->
 +
 +
{{DEFAULTSORT:The_permalink}}
 +
[[Category:テンプレートタグ]]
 +
 +
[[en:Template Tags/the_permalink]]

2017年1月4日 (水) 20:04時点における最新版

説明

ループ の中で処理されている投稿の パーマリンクURL を表示します。このタグは ループ 内で使用されなければならず、一般的に各投稿のパーマリンクを表示するときに利用します。このテンプレートタグは処理されている投稿のパーマリンクを表示するだけです。そのため、あなたのブログにある任意の投稿のパーマリンクを表示するために使用することは出来ません。もしもユニークな投稿 ID を与えて投稿のパーマリンクを取得したいのなら、get_permalink() を参照してください。

使い方

<?php the_permalink( $post ); ?>

パラメータ

$post
複合) (オプション) 投稿または固定ページの整数型の ID、あるいは投稿オブジェクト
初期値: ループ内で使用した場合、表示中の投稿の ID。

用例

テキストとして投稿のURLを表示

リンクせずに投稿の URL を表示。

This address for this post is: <?php the_permalink(); ?>

テキストを使ったリンク

リンクテキストとしてあなたの好きな文字列を使用することができます。この例では "permalink" です。

<a href="<?php the_permalink(); ?>">permalink</a>

タイトルタグを使ったリンク

投稿のタイトルをリンクテキストとしてパーマリンクを作成します。投稿のタイトルに使う一般的な方法です。

<a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>"><?php the_title(); ?></a>

変更履歴


ソースコード

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

関連項目

get_permalink(), the_permalink(), post_permalink(), permalink_anchor(), permalink_single_rss()


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


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