Web制作Labが運営するWPマニュアルサイトです

【テンプレートタグ】the_permalinkの使い方を紹介

the_permalinkはループ内で投稿のURLを表示したい時に使用する関数です。

PHP
the_permalink();

このタグはループ内で使用する必要があります。

パラメータ

PHP
the_permalink( $post );

「post」パラメータには「投稿 or 固定ページの整数型のID」もしくは「投稿オブジェクト」が入ります。
※デフォルトは$post(表示中の投稿情報)

海外版のCodexにデフォルトは$postと難しく書いてあったが、基本はループ内で現在の投稿URLを引っ張ってくる認識でOKかと。

また、ループ内であれば投稿ID(カーソル合わせると見れる数字)をパラメータに含めることで、指定の記事URLを表示できました。

テーマ開発での使用例

ループ内で記事ページにリンクを繋げるときに使用することが多いです。

PHP
<a href="<?php the_permalink(); ?>">
    <h3><?php the_title(); ?></h3>
</a>

関数の内部でエスケープ処理をしてくれるのでエスケープ処理は不要です。
※the_から始まるテンプレートタグはエスケープ処理不要なケースが多い