テンプレートタグ/get permalink

説明

PHP で使う用途の、投稿または固定ページの パーマリンク を取得します。このタグはパーマリンクを出力しません。ループ の外で使うことができます。失敗した場合は false を返します。

IDパラメーターを指定せずに一覧ページ（インデックスやアーカイブなど）のループの外側で使用した場合、現在のパーマリンクではなくループの一番最後の投稿のURLを返すことに注意してください。参照: http://core.trac.wordpress.org/ticket/9963

使い方

<?php $permalink = get_permalink( $id ); ?>

引数

$id

（複合） （オプション） 投稿または固定ページの整数型のID、あるいは投稿オブジェクト

初期値： ループ内で使用した場合、表示中の投稿のID。

$leavename

（論理値） （オプション） 投稿名あるいは固定ページ名（注：%postname%）を保持するかどうか。trueの場合、実際のURIではなく構造的なリンクを返します。 例: http://www.example.com/my-postではなくhttp://www.example.com/%postname%

初期値： false

戻り値

(文字列|論理値) 

パーマリンクURLまたは false （ページが存在しない場合）。

用例

<a href="<?php echo get_permalink( 268 ); ?>">My link to a post or page</a>

デフォルトの使い方

（ループ内で使用される）現在の投稿のパーマリンク。このタグはパーマリンクを出力しないので、この例ではPHPのechoコマンドを使用しています。

 Permalink for this post:
 <?php echo get_permalink(); ?>

特定の投稿へのリンク

関連情報の一覧の中のハイパーリンクとして、2つの特定の投稿（post IDが1と10）のパーマリンクを返しています。上記のようにこのタグはパーマリンクを出力しないので PHP の echo コマンドを使用しています。

<ul>
<li>MyBlog info:
    <ul>
    <li><a href="<?php echo get_permalink(1); ?>">About MyBlog</a></li>
    <li><a href="<?php echo get_permalink(10); ?>">About the owner</a></li>
    </ul>
</li>
</ul>

IDの代わりに投稿のオブジェクトを渡す

投稿のIDの代わりにページタイトルを使ってパーマリンクを取得する方法です。

<a href="<?php echo esc_url( get_permalink( get_page_by_title( 'Monthly Events' ) ) ); ?>">Monthly Events</a>

変更履歴

Since: 1.0.0

ソースファイル

get_permalink() is located in wp-includes/link-template.php.

関連項目

get_permalink(), the_permalink(), post_permalink(), permalink_anchor(), permalink_single_rss()

最新英語版： WordPress Codex » Function Reference/get_permalink （最新版との差分）

関数リファレンス、テンプレートタグ目次もご覧ください。