get_page_link

説明

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

最終更新 : 2014年06月17日 15:36



お勧め

wp_titleからwp_get_document_titleへ(2015年11月15日 更新)

先週、WordPress 4.4 beta1(以降4.4 beta1)が公開されました。この4.4 beta1では新テーマ「Twenty Sixteen」が追加されたほか、wp-includesディレクトリ以下のファイルが大幅に変更された感じです。

Paste JSON text:プラグイン作ってみました(2014年1月6日 更新)

動作検証用のサーバーと本番サーバーで投稿データの同期作業(コピー&ペースト)を支援するプラグインです。動作検証用のサーバーで投稿記事をJSONテキストに変換してクリップボードにコピー。本番サーバーの新規投稿ページでクリップボードにコピーしたJSONテキストをペーストして、投稿記事のコピー&ペーストを実現します。複数サーバー間で投稿記事の同期を行っている方は、お試しあれ。

「投稿に挿入」時のタグをちょっとカスタマイズ(2011年7月29日 更新)

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

投稿情報を連想配列で参照する(2014年11月17日 更新)

投稿情報は、タイトルや本文、投稿日時といったいくつかのデータが含んでおり、多くの場合オブジェクトになっている。これを連想配列で扱いたい場合はキャストして型変換することが多かった。基本的にはキャストで問題ないのだが、ふと目に留まったto_arrayメソッドが興味深かったのでメモとして残しておく。

oEmbed対応サイトを整理した(2017年11月18日 更新)

投稿記事にTwitterやYouTubeのURL(アドレス)を記述したとき、表示されるページにはリンクとしてではなく、埋め込んだURLの内容が表示される。この仕組み(機能)はoEmbedというもので、対応サイトは随時バージョンアップしている。