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

wordpress テンプレートタグ

概要

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

書式

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

パラメーター

id
記事ID(初期値:0)
leavename
投稿名または固定ページ名(%postname%)を取得するかどうか

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

位置

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

使用例

初期設定で使用する

<?php echo get_permalink(); ?>

または

<?php the_permalink(); ?>
yaji_w200h50

表示例

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

テキストにリンクを貼る

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

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

または

<a href="<?php the_permalink(); ?>">このページにリンク</a>
yaji_w200h50
<a href="http://kajico.kajilabo.net/get_permalink/">このページにリンク</a>

表示例

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

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

<a href="<?php echo get_permalink(10); ?>">利用規約</a>
yaji_w200h50
<a href="http://kajico.kajilabo.net/kiyaku/">利用規約</a>

表示例

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

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

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

表示例

MEMO

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

<?php echo get_permalink( 10 ); ?>

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

関連

コメント

タイトルとURLをコピーしました