説明
string get_archives_link( string $url, string $text [ , string $format = 'html' [ , string $before = '' [ , string $after = '' ] ] ] )
アーカイブページのリンクテキストを取得する。
パラメータ
- $urlURLを指定。
- $textカテゴリー名などのリンク名を指定。
- $format'html'、'link'、'option'などを指定（省略時は'html'）。
- $beforeリンク名の前に連結されるテキストを指定（省略時は''）。
- $afterリンク名の後に連結されるテキストを指定（省略時は''）。
返り値
パラメータ$formatで指定されたリンクテキストを返す。注意
パラメータ$formatと返されるリンクテキストの書式は次の通り。'html'を指定した場合はliタグで囲まれたものになる。| $formatの値 | リンクテキスト |
|---|---|
| 'html' | "\t<li>$before<a href='$url' title='$title_text'>$text</a>$after</li>\n" |
| 'link' | "\t<link rel='archives' title='$title_text' href='$url' />\n" |
| 'option' | "\t<option value='$url'>$before $text $after</option>\n" |
| 上記以外 | "\t$before<a href='$url' title='$title_text'>$text</a>$after\n" |
使用例
- カテゴリ1のアーカイブページのリンクテキストを取得する。<?php $out = get_archives_link( 'http://localhost/category/category1', 'カテゴリ1' ); ?>
- カテゴリ1のプルダウメニューテキストを取得する。<?php $out = get_archives_link( 'http://localhost/category/category1', 'カテゴリ1', 'option' ); ?>
フィルター
[2.6.0]リンクテキストを返す直前にget_archives_linkフィルターが実行される。$link_htmlには、生成されたリンクテキストの内容が格納されている。[4.5.0]$url、$text、$format、$before、$afterが追加され、それぞれ本関数が受け取った内容が格納されている。
return apply_filters( 'get_archives_link', $link_html, $url, $text, $format, $before, $after );
アクション
実行するアクションはありません。ソースファイル
/wp-includes/general-template.php最終更新 : 2016年05月22日 16:00
関連
お勧め
query_posts（WP_Queryクラス）で投稿タグを絞り込む（2011年9月14日 更新）
投稿タグの絞り込みは、カテゴリーに似ているけど微妙に違っている。今日は、昨日投稿した「query_posts（WP_Queryクラス）でカテゴリーを絞り込む」の続きとして、投稿タグの絞り込みついてまとめてみる。管理者ページに文言を表示する（2012年4月19日 更新）
お客様向けに管理者ページをカスタマイズする機会が増えてきている。カスタマイズするページや表示場所、表示内容によっていくつかの手段があるが、今回はページの冒頭部分に任意の文言を表示する方法を紹介する。oEmbedについて考えてみた（2018年5月27日 更新）
本サイト向けにテーマをリニューアルしようと思い一から作っている最中、ふと生成されているHTMLの中にあるoEmbedの記述が目についた。「この記述いつからだっけ」くらいに思いながらリンク先を開き、ちょっとモヤモヤしてしまった。
ショートコードを含んだページを表示する前に何か処理する（2014年5月28日 更新）
固定ページまたは投稿ページに独自のフォームを埋め込む。入力→登録の2段階のフォームなら著名なプラグイン「Contact Form 7」を利用すればいいのだが、クライアントの依頼は入力→確認→登録の3段階で組み込む要素が特化していたので、独自の実装方法を考えることになった。
WP_Postオブジェクトで投稿情報を直感的に使う（2012年10月4日 更新）
WordPress 3.5で登場するであろう WP_Postクラス。WordPressの投稿情報は、投稿情報本体のほか、カテゴリーや投稿タグ、カスタムフィールドなど、いくつかに分散して記録され、それぞれの情報を取得する際は、いくつかの関数をしていた。新しいWP_Postクラスにより、その習慣とおさらばできるかもしれない。