get_post_permalink

（3.0.0以降）
get_post_permalink - カスタム投稿タイプの投稿ページのパーマリンクを取得する

説明

string | false get_post_permalink( [ int | WP_Post ~~$id~~$post = 0 [ , bool $leavename = false [ , bool $sample = false ] ] ] )

カスタム投稿タイプの投稿ページのパーマリンクを取得する。

パラメータ

~~$id~~$post
投稿IDまたは投稿情報を指定（省略時は0）。
$leavename
投稿名を保持する場合はtrueを指定（省略時はfalse）。
$sample
サンプルパーマリンクの場合はtrueを指定（省略時はfalse）。

返り値

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

注意

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

[6.1.0]パラメータ$postで指定された投稿が存在しない場合、falseを返すようになった。

使用例

現在のカスタム投稿タイプの投稿ページのパーマリングを取得する。
<?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

最終更新 : 2022年11月06日 14:12

参考

Code Reference: get_post_permalink

お勧め

公式サイトで公開しているプラグイン「Login rebuilder」をバージョンアップし、XML-RPCリクエストの管理機能を追加しました。Login rebuilderの主たる機能は、ログインページをサイト別にユニークなURLに変更し、ログインページへの不正アクセスを回避することです。WordPressのXML-RPCリクエストはピンバックや外部ツールやサイトなどとの連携に利用されていますが、今回追加した機能ではXML-RPCリクエストの処理に対していくつかの制限できるようにしています。

絵文字画像がPNGからSVGへ（2018年5月27日更新）

WordPressでは絵文字に対応していないブラウザ環境で絵文字を表示する仕組みをバージョン4.2から提供。絵文字に対応しているブラウザとそん色がない表示を実現する。

4.4では投稿ページも専用テンプレートが適用できる（2018年5月27日更新）

従来、特定の固定ページには専用テンプレートを適用できるのですが、投稿ページに適用させるためにはアクションやフィルターを利用する必要がありました。4.4では特定の投稿ページに標準で専用テンプレートを適用できるようになりそうです。

5.7の新機能：HTTPからHTTPSへの移行（2021年3月13日更新）

先週は「WordPress 5.7 Beta 2（以降Beta 2）」が公開され、正式版リリースへ一歩進みました。WordPress 5.7の注目ポイントの1つに「HTTPからHTTPSへの移行」を手助けする機能があり、それに関連する機能を含んだhttps-detection.phpファイルとhttps-migration.phpが追加されていた。

wp_titleからwp_get_document_titleへ（2018年5月27日更新）

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