the_permalink()についてWordPressテンプレートタグ解説
概要
<?php the_permalink(); ?> は、現在の投稿やページの個別ページのURL(パーマリンク)を出力するテンプレートタグです。リンクを生成したい場面で使われます。
基本的な使い方
<a href="<?php the_permalink(); ?>">記事タイトル</a>
上記のように、投稿へのリンクを自動的に出力したい場合によく使います。the_permalink() はエスケープされた URL を返すため、そのまま href 属性に使用できます。
出力される内容の例
https://example.com/blog/sample-post
役割とメリット(定義リスト形式)
- リンク生成
- 投稿タイトルや「続きを読む」リンクなどに、投稿のURLを挿入するのに使います。
- 動的出力
- ループ内で使用すれば、各投稿のURLを動的に取得できます。
- セキュリティ
- URLは自動的にエスケープされて出力されるため、セキュリティ的にも安心です。
注意点
- 単体で使ってもURLが出力されるだけで、リンクにならない点に注意(
<a href="...">などで囲む必要があります)。 - the_permalink() は基本的に WordPress ループ内で使用されます。ループ外では期待通りに動作しないことがあります。
まとめ
<?php the_permalink(); ?> は、投稿やページの URL を取得して表示するための基本的な関数です。特に一覧表示やカード型レイアウトなど、投稿へのリンクを動的に生成したい場合に必須のタグです。
