- 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。（詳細）
「テンプレートタグ/get permalink」の版間の差分
(訳の修正) |
(→説明) |
||
| 3行目: | 3行目: | ||
[[Glossary#PHP|PHP]] で使う用途の、投稿または固定ページの [[Glossary#パーマリンク|パーマリンク]] を取得します。このタグはパーマリンクを出力'''しません'''。[[ループ]] の外で使うことができます。失敗した場合は <code>false</code> を返します。 | [[Glossary#PHP|PHP]] で使う用途の、投稿または固定ページの [[Glossary#パーマリンク|パーマリンク]] を取得します。このタグはパーマリンクを出力'''しません'''。[[ループ]] の外で使うことができます。失敗した場合は <code>false</code> を返します。 | ||
| − | + | In a Plugin or Theme, it can be used as early as the [[Plugin_API/Action_Reference/setup_theme|setup_theme]] Action. Any earlier usage, including [[Plugin_API/Action_Reference/plugins_loaded|plugins_loaded]], generates a Fatal Error. | |
| + | |||
| + | IDパラメーターを指定せずに一覧ページ（インデックスやアーカイブなど）のループの外側で使用した場合、現在の表示しているページのパーマリンク'''ではなく'''ループの一番最後の投稿のURLを返すことに注意してください。参照: http://core.trac.wordpress.org/ticket/9963 | ||
== 使い方 == | == 使い方 == | ||
2014年9月23日 (火) 23:28時点における版
目次
説明
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 ); ?>
引数
- $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 （最新版との差分）
