WordPress模板函数wp_get_archives用于显示一个基于日期的归档列表，这个函数可以用在任何模板，通常用来制作一个日期归档页。

wp_get_archives( array|string $args = '' )

函数参数

$args

数组或字符串值

wp_get_archives()函数$args参数默认的值如下：

$args = array(
	'type'				=> 'monthly',
	'limit'				=> '',
	'format'			=> 'html', 
	'before'			=> '',
	'after'				=> '',
	'show_post_count'	=> false,
	'echo'				=> 1,
	'order'				=> 'DESC',
	'post_type'			=> 'post'
);

wp_get_archives()函数$args参数可用的值如下：

type

字符串值，默认值：monthly

归档的方式，以年、月、日、周等归档

• yearly：按年份归档
• monthly：按月份归档
• daily：按天归档
• weekly：按周归档
• postbypost：按发表日期列出所有文章
• alpha：按文章标题排序列出所有文章

limit

整数型，默认为空

显示的数量，默认为无限

format

字符串值，默认值：html

以何种HTML函数输出内容，默认以<li>列表输出。

• html：以<li>列表输出；
• option：以<option>输出，需要自己添加<select>函数；
• link：以<link>函数输出，rel值为archives；
• custom：自定义包裹链接的函数，将使用before和after定义的值；

before

字符串值，默认为空

当format的值为custom时，before的值将在链接前输出，即包裹链接的开始函数。

after

字符串值，默认为空

当format的值为custom时，after的值将在链接后输出，即包裹链接的开始函数。

show_post_count

布尔值，默认值：false

显示文章数量，type的值不为postbypost或alpha时。

echo

布尔值，默认值：1

是否输出结果，如果为0则只返回结果而不是输出。

order

字符串值，默认值：ASC

排序方式

• ASC：升序
• DESC：降序

post_type

字符串值，默认值：post

文章类型

函数使用示例

按年份输出归档，并显示文章数量

<?php
	$args = array(
		'type' => 'yearly',
		'show_post_count' => true
	);
	wp_get_archives( $args );
?>

下面的代码输出一样的结果：

<?php wp_get_archives( 'type=yearly&show_post_count=1' ); ?>

扩展阅读

wp_get_archives()函数位于：wp-includes/general-template.php