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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(説明)
(01:48, 27 August 2014 Adiant 差分追加)
1行目: 1行目:
 +
{{NeedTrans|一部}}
 
== 説明 ==
 
== 説明 ==
  
9行目: 10行目:
 
== 使い方 ==
 
== 使い方 ==
  
<pre><?php $permalink = get_permalink( $id ); ?></pre>
+
<code><?php $permalink = get_permalink( $id, $leavename ); ?></code>
  
 
== 引数 ==
 
== 引数 ==
63行目: 64行目:
 
{{Permalink Tags}}
 
{{Permalink Tags}}
  
{{原文|Function Reference/get_permalink|132252}}<!-- 17:17, 18 June 2013 JD55 版 -->
+
{{原文|Function Reference/get_permalink|146138}}<!-- 01:48, 27 August 2014 Adiant 版 -->
  
 
{{Tag Footer}}
 
{{Tag Footer}}

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


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