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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(訳の修正)
1行目: 1行目:
 
== 説明 ==
 
== 説明 ==
  
[[Glossary#PHP|PHP]] で使う投稿または固定ページの [[Glossary#パーマリンク|パーマリンク]] を取得します。このタグはパーマリンクを出力しませんが、[[ループ]] の外で使うことが出来ます。
+
[[Glossary#PHP|PHP]] で使う用途の、投稿または固定ページの [[Glossary#パーマリンク|パーマリンク]] を取得します。このタグはパーマリンクを出力'''しません'''。[[ループ]] の外で使うことができます。失敗した場合は <code>false</code> を返します。
It does NOT display the permalink and can be used outside of [[ループ]]。失敗した場合は <code>false</code> を返します。
+
  
IDパラメーターなしに投稿ページ(インデックスやアーカイブなど)のループの外側で使用した場合、現在のパーマリンク''ではなく''ループの一番最後の投稿のURLを返すことに注意してください。参照: http://core.trac.wordpress.org/ticket/9963
+
IDパラメーターを指定せずに一覧ページ(インデックスやアーカイブなど)のループの外側で使用した場合、現在のパーマリンク'''ではなく'''ループの一番最後の投稿のURLを返すことに注意してください。参照: http://core.trac.wordpress.org/ticket/9963
  
 
== 使い方 ==
 
== 使い方 ==
  
<?php $permalink = get_permalink( $id ); ?>  
+
<pre><?php $permalink = get_permalink( $id ); ?></pre>
  
 
== 引数 ==
 
== 引数 ==
  
{{Parameter|$id|mixed|投稿または固定ページのID(数値型)、あるいは投稿オブジェクト|optional|[[ループ]]内で使用した場合、表示中の投稿のID。}}
+
{{Parameter|$id|複合|投稿または固定ページの整数型のID、あるいは投稿オブジェクト|オプション|[[ループ]]内で使用した場合、表示中の投稿のID。}}
{{Parameter|$leavename|bool|投稿名あるいは固定ページ名(注:%postname%)を保持するかどうか。<tt>true</tt>の場合、構造的なリンクではなく実際のURIを返します。 例: <tt><nowiki>http://www.example.com/%postname%</nowiki></tt> の代わりに <tt><nowiki>http://www.example.com/my-post</nowiki></tt>|optional|<tt>false</tt>}}
+
{{Parameter|$leavename|論理値|投稿名あるいは固定ページ名(注:%postname%)を保持するかどうか。<tt>true</tt>の場合、実際のURIではなく構造的なリンクを返します。 例: <tt><nowiki>http://www.example.com/my-post</nowiki></tt>ではなく<tt><nowiki>http://www.example.com/%postname%</nowiki></tt>|オプション|<tt>false</tt>}}
  
 
== 戻り値 ==
 
== 戻り値 ==
; (string|bool) : パーマリンクURLまたは <tt>false</tt> (ページが存在しない場合)。
+
; (文字列|論理値) : パーマリンクURLまたは <tt>false</tt> (ページが存在しない場合)。
  
 
== 用例 ==
 
== 用例 ==
  
<a href="<?php echo get_permalink( 268 ); ?>">My link to a post or page</a>
+
<pre><a href="<?php echo get_permalink( 268 ); ?>">My link to a post or page</a></pre>
  
 
=== デフォルトの使い方 ===
 
=== デフォルトの使い方 ===
  
(ループ内で使用される)現在のポストのパーマリンク。このタグはパーマリンクを出力しないので、この例ではPHPのechoコマンドを使用しています。
+
(ループ内で使用される)現在の投稿のパーマリンク。このタグはパーマリンクを出力しないので、この例ではPHPのechoコマンドを使用しています。
  
 +
<pre>
 
  Permalink for this post:
 
  Permalink for this post:
 
  <?php echo get_permalink(); ?>
 
  <?php echo get_permalink(); ?>
 +
</pre>
  
 
=== 特定の投稿へのリンク ===
 
=== 特定の投稿へのリンク ===
  
インフォメーションリストの中のハイパーリンクとして、2つの特定の投稿(post IDが1と10)のパーマリンクを返します。上記のようにこのタグはパーマリンクを出力しないので PHP の echo コマンドを使用しています。
+
関連情報の一覧の中のハイパーリンクとして、2つの特定の投稿(post IDが1と10)のパーマリンクを返しています。上記のようにこのタグはパーマリンクを出力しないので PHP の echo コマンドを使用しています。
  
&lt;ul&gt;
+
<pre>
&lt;li&gt;MyBlog info:
+
<ul>
    &lt;ul&gt;
+
<li>MyBlog info:
    &lt;li&gt;&lt;a href="<?php echo get_permalink(1); ?>"&gt;About MyBlog&lt;/a&gt;&lt;/li&gt;
+
    <ul>
    &lt;li&gt;&lt;a href="<?php echo get_permalink(10); ?>"&gt;About the owner&lt;/a&gt;&lt;/li&gt;
+
    <li><a href="<?php echo get_permalink(1); ?>">About MyBlog</a></li>
    &lt;/ul&gt;
+
    <li><a href="<?php echo get_permalink(10); ?>">About the owner</a></li>
&lt;/li&gt;
+
    </ul>
&lt;/ul&gt;
+
</li>
 +
</ul>
 +
</pre>
  
 
=== IDの代わりに投稿のオブジェクトを渡す ===
 
=== IDの代わりに投稿のオブジェクトを渡す ===

2014年5月18日 (日) 10:06時点における版

説明

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


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