wp_get_archives

パラメータ

• $args
  表示条件を指定する文字列（または連想配列）。文字列の場合はname=valueの形式で指定し、複数の条件はname1=value1&name2=value2のように'&'の後に続ける。主なキーワードは次の通り。

  キーワード	省略時の値	意味
  type	'monthly'	アーカイブ種別を指定（'daily'、'weekly'、'monthly'、'yearly'、'postbypost'、'alpha'など）
  limit	''	表示件数（正数）
  format	'html'	表示形式を指定（'html'、'link'、'option'など）
  before	''	リンク名の前に連結する文字列
  after	''	リンク名の後に連結する文字列
  show_post_count	false	投稿件数を表示する場合はtrue、表示しない場合はfalse
  echo	1	表示する場合は1、文字列として取得する場合は0
  order	'DESC'	降順は'DESC'、昇順は'ASC'を指定
  post_type	'post'	[4.4.0]投稿タイプを指定
  year	get_query_var('year')	[5.2.0]年を指定
  monthnum	get_query_var('monthnum')	[5.2.0]月（1～12）を指定
  day	get_query_var('day')	[5.2.0]日（1～31）を指定
  w	get_query_var('w')	[5.2.0]曜日（1～53）を指定

返り値

注意

[4.4.0]'post_type'パラメータが追加され、任意の投稿タイプのアーカイブ情報を取得できるようになった。

[5.2.0]'year'、'monthnum'、'day'、'w'パラメータが追加され、プルダウンメニュー（option要素）のselected属性を指定できるようになった。

[7.0.0]本関数が受け取った$argsに適用される'wp_get_archives_args'フィルターが追加された。

使用例

• アーカイブリンクを表示する。
  <?php wp_get_archives( ); ?>
• アーカイブリンクのプルダウンメニューを表示する。

  <select id="archives" name="archives">
  <?php wp_get_archives( array( 'format' => 'option', 'year' => 2018, 'monthnum' => 12 ) ); ?>
  </select>
  

フィルター

$args = apply_filters( 'wp_get_archives_args', $args );

$where = apply_filters( 'getarchives_where', $where, $r );

$join = apply_filters( 'getarchives_join', $join, $r );

$text = strip_tags( apply_filters( 'the_title', $post_title, $post_id ) );

アクション

ソースファイル