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

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

テンプレートタグ/get archives

提供: WordPress Codex 日本語版
移動先: 案内検索

このテンプレートタグは WordPress 2.1 から非推奨となりました。後継となる新しいテンプレートタグが作られたか、動作対象外となり、WordPress の将来のバージョンで削除される見込みです。 このタグを使っていた場合は、後継の wp_get_archives に切り替えてください。


  • 書式: <?php get_archives('type', 'limit', 'format', 'before', 'after', show_post_count); ?>
  • 説明: 月別、日別、週別、個別記事アーカイブへのリンクを出力。
  • 位置: ループ内・外
  • 引数:
    • type (規定値)- 取得するアーカイブの種類。
      • monthly(デフォルト。月別アーカイブ)
      • daily(日別アーカイブ)
      • weekly(週別アーカイブ)
      • postbypost(個別記事アーカイブ)
    • limit (整数)- 取得するアーカイブ記事の数。無制限にしたいときは空の値を指定。
    • format (規定値)- 取得したリンクの出力形式。
      • html(デフォルト。取得した各項目を
      • 要素内に出力)
      • option(各項目をドロップダウンメニュー<option>要素内に出力)
      • link(各項目を<link>要素内に出力。XMLデータ用の形式)
      • custom(「before」「after」で指定したカスタム形式で出力)
    • before (文字列)- format引数で「html」か「custom」を選択した場合、項目の直後に出力するコードやテキスト。
    • after (文字列)- format引数で「html」か「custom」を選択した場合、項目の直前に出力するコードやテキスト。デフォルト値は空。
    • show_post_count (true/false)- 月別アーカイブでアーカイブ内の記事数を出力するかどうか。
      • true(記事数を出力)
      • false(デフォルト。記事数を出力しない)
  • コード記述例:
<ul>
  <?php get_archives('daily', '10', 'html', '', '', true); ?>
</ul>
  • 出力例:
<ul>
  <li><a href="http://example.com/?m=20060529" title="2006/5/29 月曜日">2006/5/29 月曜日</a></li
  <li><a href="http://example.com/?m=20060528" title="2006/5/28 日曜日">2006/5/28 日曜日</a></li
  <li><a href="http://example.com/?m=20060527" title="2006/5/27 土曜日">2006/5/27 土曜日</a></li>
</ul>