get_page_link:WordPress私的マニュアル

get_page_link

(1.5.0以降)
get_page_link - 固定ページのパーマリンクURLを取得する

説明

string get_page_link( [ mixed $post = false [ , bool $leavename = false [ , bool $sample = false ] ] ] )

固定ページのパーマリンクURLを取得する。

パラメータ

$post
固定ページまたはその投稿情報ID（省略時はfalseとなり、現在の投稿情報を調べる）。
$leavename
投稿名およびページ名を除外する場合はfalse、有効にする場合はtrueを指定（省略時はfalseとなり、投稿名およびページ名を有効にする）。
$sample
サンプル用パーマリンクの場合はtrue、通常のパーマリンクの場合はfalseを指定（省略時はfalse）。

返り値

固定ページのパーマリンクURLを返す。

注意

対象の固定ページが「フロントページ」に指定されている（get_option( 'show_on_front' )が'page'でget_option( 'page_on_front' )が対象の固定ページのID）場合、パーマリンクURLはhome_url( '/' )になる。

使用例

$pageで指定した固定ページのパーマリンクURLを取得する。
<?php $url = get_page_link( $page ); ?>

フィルター

パーマリンクURLを返す直前に'page_link'フィルターを呼び出す。$linkにはパーマリンクURL、$post_idには固定ページのID、$sampleは同名パラメータの値が格納される。

return apply_filters( 'page_link', $link, $post_id, $sample );

アクション

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

ソースファイル

/wp-includes/link-template.php

参考

Code Reference: get_page_link

お勧めコンテンツ

もうquery_postsは呼ばない（2011年9月27日登録）

トップページやカテゴリーページで標準の条件に少し手を加えた投稿情報を表示するケースがある。そんな時、テンプレートファイルの先頭でquery_posts関数を呼び出して投稿情報を再抽出していたのだが、フィルター処理をうまく使えばquery_posts関数を呼び出さなくても大丈夫みたいだ。

子カテゴリのアーカイブページを親カテゴリ用のテンプレートファイルで表示しよう（2011年12月8日登録）

少し前に投稿した「適切なテンプレートファイルを用意してテンプレート内の振り分け処理を無くす」で説明した通り、特定のカテゴリ専用のテンプレートとしてcategory-○○.phpを用意することで、category.phpやarchive.php内で振り分けを行う必要がなくなる。ただ、すべてのカテゴリ分を用意するのは効率的ではないし、特に子カテゴリについては親カテゴリと共通内容になるケースが多いのではないだろうか。ここでは、子カテゴリの個別テンプレートファイルを作らず、親カテゴリのテンプレートを利用する方法を紹介する。

テキストエディタの文字を変更する（2016年8月30日登録）

テキストエディタ（投稿ページの「テキスト」タブのエディタ）に標準では備わっていない機能を追加する自作プラグイン「html entities button」がほぼ1年ぶりにアップデート。ここではバージョン2.0.0で追加したテキストエディタのフォント切り替え機能について紹介する。

先週のこと、「Login rebuilder」のユーザから「wp_login_url関数のように第2ログインページのURLを取得できないか」という問い合わせがありました。その時点ではそのような関数やメソッドを用意していなかったのですが、まあニーズがあるなら作ってみようと思い、対応するメソッドを追加したLogin rebuilderバージョン1.4.3をリリースしました。

時代はWP_Queryなのか（2011年8月1日登録）

WordPressのテーマ作成において、メインの投稿記事とは別に特定の条件を指定した投稿内容を表示することが多々ある。つい最近までget_posts関数を使用することが多かったのだが、最近はWP_Queryクラスを使用することが多くなってきた。