get_post_permalink

説明

string get_post_permalink( [ int $id = 0 [ , bool $leavename = false [ , bool $sample = false ] ] ] )
カスタム投稿タイプの投稿ページのパーマリンクを取得する。

パラメータ

  • $id
    投稿IDを指定(省略時は0)。
  • $leavename
    投稿名を保持する場合はtrueを指定(省略時はfalse)。
  • $sample
    サンプルパーマリンクの場合はtrueを指定(省略時はfalse)。

返り値

カスタム投稿タイプのパーマリンクを返す。投稿IDが無効の場合はfalseを返す。

注意

通常シングルページのパーマリンクは get_permalink関数で取得でき、この関数も内部で呼び出されている。固定ページのパーマリンクを取得する get_page_linkと同様のパラメータを持ち、使い方も似ている。

使用例

  • 現在のカスタム投稿タイプの投稿ページのパーマリングを取得する。
    <?php $url = get_post_permalink(); ?>
  • カスタム投稿タイプの投稿IDが101のパーマリングを取得する。
    <?php $url = get_post_permalink( 101 ); ?>

フィルター

[3.0.0]パーマリンクを返す直前に'post_type_link'フィルターを呼び出す。パラメータ$linkにはパーマリンクが、その他のパラメータには本関数が受け取った値が格納されている。
return apply_filters( 'post_type_link', $post_link, $post, $leavename, $sample );

アクション

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

ソースファイル

/wp-includes/link-template.php

最終更新 : 2014年06月12日 09:16



お勧め

日本語名のユーザーを登録する(2018年5月27日 更新)

標準のログインID(ユーザー名)は、英数字と一部の記号の組み合わせで構成されている。一般的なシステムのログインIDはおおむねこんな感じだが、ふと「インターネット環境ならログインIDに日本語が使用できてもいいんじゃないか」と思い、実現できるか調べてみた。

query_posts(WP_Queryクラス)でカテゴリーを絞り込む(2011年9月14日 更新)

久しぶりに query_posts関数を見直してみると、見知らぬパラメータがいくつか追加されていた。気になったのでカテゴリー関係の指定を'tax_query'パラメータを交えて整理してみた。

wp_titleからwp_get_document_titleへ(2018年5月27日 更新)

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

投稿ページでユニークなテンプレートを選択しよう(2018年5月27日 更新)

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

同じ名前のメタ情報をまとめて削除する(2014年3月21日 更新)

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