【WordPressテンプレートタグ】get_permalink()：投稿または固定ページのパーマリンクを取得

概要

投稿または固定ページのパーマリンクを取得する。

書式

<?php get_permalink( id, leavename ); ?>

パラメーター

id: 記事ID(初期値：0)

leavename

投稿名または固定ページ名（%postname%）を取得するかどうか

true / 実際のURIではなく構造的なリンクを取得する
false / 構造的なリンクを取得しない(初期値)

位置

ループ内。記事IDを指定すれば、ループ外でも使用可能。

使用例

初期設定で使用する

<?php echo get_permalink(); ?>

または

<?php the_permalink(); ?>

表示例

http://kajico.kajilabo.net/get_permalink/

テキストにリンクを貼る

任意のテキストに記事のURLを貼る。

<a href="<?php echo get_permalink(); ?>">このページにリンク</a>

または

<a href="<?php the_permalink(); ?>">このページにリンク</a>

<a href="http://kajico.kajilabo.net/get_permalink/">このページにリンク</a>

表示例

このページにリンク

記事IDを指定して取得する

任意のテキストに記事のURLを貼る。

<a href="<?php echo get_permalink(10); ?>">利用規約</a>

<a href="http://kajico.kajilabo.net/kiyaku/">利用規約</a>

表示例

利用規約

リンク付きで記事タイトルを表示(一般的な手法)

記事タイトルをリンクテキストとしてパーマリンクを作成する。

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

<a title="get_permalink()：投稿または固定ページのパーマリンクを取得 " href="http://kajico.kajilabo.net/get_permalink/">get_permalink()：投稿または固定ページのパーマリンクを取得</a>

表示例

get_permalink()：投稿または固定ページのパーマリンクを取得

MEMO

the_permalinkタグはループ内でのみ利用可能でループ外では使えない。同じことをループ外で実現する場合は、get_permalinkタグにパラメーターでリンクしたい記事のIDを指定し、さらにecho命令での表示を行う必要がある。

<?php echo get_permalink( 10 ); ?>

傾向として、the_で始まるテンプレートタグは「出力を行う」「ループ内でのみ利用できる」のに対し、get_で始まるテンプレートタグは「出力を行わない」「パラメーターを指定すればループ外でも利用できる」ことが多いため、the_で始まる関数で対応できないような場合は、get_で始まる関数を探してみるとよい。