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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(2006年8月に作成した翻訳データの流し込み(暫定版、要フォーマット))
 
(Version 4.4.0 にて$postパラメータが追加されました。)
 
(4人の利用者による、間の11版が非表示)
1行目: 1行目:
* 書式: <?php the_permalink(); ?>
+
== 説明 ==
* 説明: 記事のパーマリンクを出力。
+
 
* 位置: ループ内
+
[[ループ]] の中で処理されている投稿の [[Glossary#パーマリンク|パーマリンク]] の [[Glossary#URI and URL|URL]] を表示します。このタグは [[ループ]] 内で使用されなければならず、一般的に各投稿のパーマリンクを表示するときに利用します。このテンプレートタグは処理されている投稿のパーマリンクを表示するだけです。そのため、あなたのブログにある任意の投稿のパーマリンクを表示するために使用することは出来ません。もしもユニークな投稿 ID を与えて投稿のパーマリンクを取得したいのなら、[[テンプレートタグ/get_permalink|get_permalink()]] を参照してください。
* 引数: なし
+
 
* コード記述例: <code><nowiki><p><a href="<?php the_permalink(); ?>">この記事のパーマリンク</a></p></nowiki></code>
+
== 使い方 ==
* 出力例: <code><nowiki><p><a href="http://example.com/index.php?p=1">この記事のパーマリンク</a></p></nowiki></code>
+
 
 +
<?php the_permalink( $post ); ?>
 +
 
 +
== パラメータ ==
 +
 
 +
{{Parameter|$post|複合|投稿または固定ページの整数型の ID、あるいは投稿オブジェクト|オプション|[[ループ]]内で使用した場合、表示中の投稿の ID。}}
 +
 
 +
== 用例 ==
 +
 
 +
=== テキストとして投稿のURLを表示 ===
 +
 
 +
リンクせずに投稿の URL を表示。
 +
 
 +
This address for this post is: &lt;?php the_permalink(); ?&gt;
 +
 
 +
=== テキストを使ったリンク ===
 +
 
 +
リンクテキストとしてあなたの好きな文字列を使用することができます。この例では "permalink" です。
 +
 
 +
<a href="<?php the_permalink(); ?>">permalink</a>
 +
 
 +
=== タイトルタグを使ったリンク ===
 +
 
 +
投稿のタイトルをリンクテキストとしてパーマリンクを作成します。投稿のタイトルに使う一般的な方法です。
 +
 
 +
<a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>"><?php the_title(); ?></a>
 +
 
 +
== 変更履歴 ==
 +
 
 +
* 導入: [[Version 1.2|1.2.0]]
 +
* 最初は {{Trac|wp-includes/template-functions-links.php}} の中で定義されていました。[[Version 1.5|1.5]] のときです。
 +
* ファイル名が {{Trac|wp-includes/link-template.php}} へ変更されました。[[Version 2.1|2.1]] のときです。
 +
* [[Version 4.4.0|4.4.0]] のときに、$postパラメータが追加されました。
 +
 
 +
 
 +
== ソースコード ==
 +
 
 +
<tt>the_permalink()</tt> は {{Trac|wp-includes/link-template.php}} にあります。
 +
 
 +
== 関連項目 ==
 +
 
 +
{{Permalink Tags}}
 +
 
 +
{{Tag Footer}}
 +
 
 +
{{原文|Function Reference/the permalink|145560}}<!-- 05:32, 14 August 2014 Hunterhogan 版 -->
 +
 
 +
{{DEFAULTSORT:The_permalink}}
 +
[[Category:テンプレートタグ]]
  
 
[[en:Template Tags/the_permalink]]
 
[[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最新版との差分