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 を取得して表示するための基本的な関数です。特に一覧表示やカード型レイアウトなど、投稿へのリンクを動的に生成したい場合に必須のタグです。