• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

「テンプレートタグ/get permalink」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
1行目: 1行目:
 +
{{NeedTrans|一部}}
 
== 説明 ==
 
== 説明 ==
  

2014年5月17日 (土) 18:48時点における版

このページ「テンプレートタグ/get permalink」は一部未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

説明

Returns the permalink to a post or page for use in PHP. It does NOT display the permalink and can be used outside of The Loop. On failure returns false.

Note that when used outside The Loop on a posts page (index, archive, etc.) without the ID parameter, it will return the URL of the last post in The Loop, not the permalink for the current page. See: http://core.trac.wordpress.org/ticket/9963

使い方

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

引数

$id
mixed) (optional) 投稿または固定ページのID(数値型)、あるいは投稿オブジェクト
初期値: ループ内で使用した場合、表示中の投稿のID。
$leavename
bool) (optional) 投稿名あるいは固定ページ名(注:%postname%)を保持するかどうか。trueの場合、構造的なリンクではなく実際のURIを返します。 例: http://www.example.com/%postname% の代わりに http://www.example.com/my-post
初期値: false

戻り値

(string|bool) 
パーマリンク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最新版との差分


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