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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(01:48, 27 August 2014 Adiant 差分追加)
(用例)
22行目: 22行目:
 
== 用例 ==
 
== 用例 ==
  
<pre><a href="<?php echo get_permalink( 268 ); ?>">My link to a post or page</a></pre>
+
<pre>
 +
<a href="<?php echo get_permalink( 268 ); ?>">My link to a post or page</a>
 +
</pre>
  
 
=== デフォルトの使い方 ===
 
=== デフォルトの使い方 ===

2014年9月23日 (火) 23:41時点における版

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

説明

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

In a Plugin or Theme, it can be used as early as the setup_theme Action. Any earlier usage, including plugins_loaded, generates a Fatal Error.

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

使い方

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

引数

$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最新版との差分


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