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

最終更新 : 2018年05月27日 10:49



お勧め

meta_compare_key使ってみた(2019年3月19日 更新)

ブロックエディターの登場により、標準のカスタムフィールドを使う機会はかなり減った気がする。そんな中、5.1.0で追加されたのが、カスタムフィールド名(メタキー)に含まれる文字列を指定する'meta_compare_key'キーだ。

WP_List_Tableクラスの「一括操作」フォームを使ってみた(2018年5月27日 更新)

今回は「WP_List_Tableクラスを使ってみた」の続き。投稿一覧やプラグインページなどにある「一括操作」(Bulkアクション)フォーム対応に関するメモである。

テーマから投稿画像のサイズを指定する(2012年3月15日 更新)

投稿記事に挿入する画像サイズは、サムネイル(150×150)、中サイズ(300×300)、大サイズ(1024×1024)がデフォルトだが、テーマによっては別のサイズを指定したい場合はある。基本的には、「設定」-「メディア」の「メディア設定」ページで指定できるが、テーマ内のfunctions.phpで設定しておくとちょっと便利かもしれない。

ログインページを変える(2014年9月12日 更新)

WordPressの標準的な不正ログイン対策としては、ログインIDは'admin'を避けるパスワードはユニークで長くする、場合によってはアクセスできるIPアドレスを制限する、といった具合だろう。これらの他に何かできないものだろうかと、ちょっと考えてみた。

新規投稿時の本文プレースホルダーテキストを変える(2021年9月9日 更新)

ブロックエディターに影響を与えるフィルターは多数存在する。今回紹介するフィルターはその1つで、新規投稿時の本文ブロックのプレースホルダーテキストを変更するものだ。