get_permalink

(1.0.0以降)
get_permalink - 投稿情報のパーマリンクを取得する

説明

string get_permalink( [ int $id = 0 [ , bool $leavename = false ] ] )
現在の投稿情報（グローバル変数$post）または指定した投稿情報のパーマリンクを取得する。

パラメータ

  • $id
    投稿情報ID（省略時は0となり、現在の投稿情報を調べる）。
  • $leavename
    投稿名およびページ名を除外する場合はfalse、有効にする場合はtrueを指定（省略時はfalseとなり、投稿名およびページ名を有効にする）。

返り値

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

注意

特にありません。

使用例

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

フィルター

'page'と'attachment'以外の標準投稿タイプの場合、'pre_post_link'フィルターを呼び出す。パラメータ$permalinkにはget_option( 'permalink_structure' )の内容が、$postには投稿情報が、パラメータ$leavenameの内容が格納される。 
$permalink = apply_filters( 'pre_post_link', $permalink, $post, $leavename );
'page'と'attachment'以外の標準投稿タイプでパーマリンクを返す直前に'post_link'フィルターを呼び出す。パラメータ$permalinkには作成されたパーマリンクが、$postには投稿情報が、パラメータ$leavenameの内容が格納される。 
$permalink = apply_filters( 'post_link', $permalink, $post, $leavename );

アクション

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

ソースファイル

/wp-includes/link-template.php

関連

参考

Code Reference: get_permalink

お勧めコンテンツ

カスタムフィールド関連関数のおさらい（2012年6月22日 登録）

カスタムフィールドは、投稿記事の拡張情報としてよく利用されている。投稿ページで登録した情報をアーカイブや投稿ページで表示しているが、投稿ページを表示する際にカスタムフィールドの値を更新して、サイドバーのようなページ内要素に利用したりしている。

決まった値を返すだけの関数群（2015年7月15日 登録）

WordPressのソースコードを眺めているとフィルター関数名で'__return_○○'が指定されている部分を時々見かけます。それらの関数定義を見てみると、すべて決まった値を単純に返すだけでした。これらの関数がちょっと気になったので、まとめてみました。

ショートコードを含んだページを表示する前に何か処理する（2014年5月28日 登録）

固定ページまたは投稿ページに独自のフォームを埋め込む。入力→登録の2段階のフォームなら著名なプラグイン「Contact Form 7」を利用すればいいのだが、クライアントの依頼は入力→確認→登録の3段階で組み込む要素が特化していたので、独自の実装方法を考えることになった。

さくらのVPSでKUSANAGI（2017年5月15日 登録）

請け負っていた業務が一段落したので、「さくらのVPS」で「KUSANAGI」を試してみました。推奨環境はメモリ4GBとなっているが、今回は実験的な利用なので、SSD 2GBプランでトライしました。

各種リンクを取得する関数一覧（2014年6月12日 登録）

サイト設計において、ページ間の相互リンクは重要である。WordPressでは各種ページのリンク（パーマリンク）を取得する関数を用意しており、それらを一通り把握しておくべきだろう。

最終更新日時 : 2014-11-16 17:40