get_the_permalink:WordPress私的マニュアル

get_the_permalink

(3.9.0以降)
get_the_permalink - 現在の投稿情報のパーマリンクを取得する

説明

string get_the_permalink( [ mixed $id = 0 [ , bool $leavename = false ] ] )

現在の投稿情報のパーマリンクを取得する。

パラメータ

$id
投稿IDまたは投稿情報を指定（省略時は0）。
$leavename
投稿名およびページ名を除外する場合はfalse、有効にする場合はtrueを指定（省略時はfalse）。

返り値

投稿情報のパーマリンクを返す。

注意

get_permalink関数のエイリアス関数。現在の投稿情報の何かを取得するget_the_titleやget_the_dateなどのget_theシリーズ関数のネーミングルールに合わせるために作られた（たぶん）。

パラメータ$idに投稿IDまたは投稿情報を指定することで、任意の投稿情報のパーマリンクを取得できる。

使用例

現在の投稿情報のパーマリンクを取得する。
<?php $path = get_the_permalink(); ?>
投稿IDが10の投稿情報のパーマリンクを取得する。
<?php $path = get_the_permalink( 10 ); ?>

フィルター

直接実行するフィルターはありません。

アクション

直接実行するアクションはありません。

ソースファイル

/wp-includes/link-template.php

参考

Code Reference: get_the_permalink

お勧めコンテンツ

headタグのmeta（generator）タグを取り除く（2011年2月18日登録）

標準的なWordPressのテーマで出力されるHTMLには、headタグ内に次のようなmetaタグが出力されている。

<meta name="generator" content="WordPress 3.0.5" />

4.2の「アクティビティ」ウィジェットに投稿以外の情報も表示する（2015年5月13日登録）

ダッシュボードの「アクティビティ」ウィジェットは「投稿（post）」の状況を表示し、固定ページ（page）やカスタム投稿タイプの投稿記事の状況については標準では表示されない。このことに対して以前『3.8の「アクティビティ」ウィジェットに投稿以外の情報も表示する』を紹介したのだが、4.2では新しいフィルターが追加され、カスタマイズが少し容易になった。

「投稿に挿入」時のタグをちょっとカスタマイズ（2011年7月29日登録）

投稿画面において、画像をアップロードし投稿に挿入するすると、imgタグをaタグで囲んだものが挿入される（キャプションを指定した場合はタグも）。それらの画像をLightBox（JavaScriptライブラリ）で表示する場合、aタグにrel属性を追加するのだが、その作業を毎回投稿に挿入した後で行うのがちょっと面倒。というわけで、自動的にrel属性を追加するようにしてみました。

同じ名前のメタ情報をまとめて削除する（2014年3月21日登録）

WordPressには、投稿情報、コメント情報、ユーザ情報のそれぞれを拡張できるメタ情報の仕組みが用意されている。投稿情報のメタ情報は「カスタムフィールド」として投稿画面に用意されているので投稿者自身が随時操作できるほか、テーマやプラグインからの操作も容易である。今回の中身はそんなメタ情報の一括削除の話だ。

投稿ページでユニークなテンプレートを選択しよう（2016年12月19日登録）

4.7の変更点に「投稿タイプテンプレート」がある。これは従来固定ページ（'page'）向けに任意のテンプレートを適用できる機能が拡張されたもので、投稿ページ（'post'）はもちろんカスタム投稿タイプのページにも適用可能になっている。