wp_get_archives

wp_get_archives 函数是用来输出 WordPress 文章归档链接的一个函数，可以按月、按年、按周来归档你的文章，甚至是你可以将每一篇文章输出到页面中。

描述

官方文档原文

This function displays a date-based archives list. This tag can be used anywhere within a template.

译文：
wp_get_archives是一个可以再模板任何位置使用的模板标签（函数），可以以日期为基础显示文章归档列表的函数。

使用

<?PHP
   wp_get_archives( $args ); 
 ?>

$args往下看

参数默认值

$args=array(
	'type'=>'monthly',
	'limit'=>,
	'format'=>'HTML',
	'before'=>,
	'after'=>,
	'show_post_count'=>false,
	'echo'=>1
);

参数设置

1. type
   归档类型设置。
   可选值：
   ‘yearly’ 按年
   ‘monthly’按月
   ‘daily’按日
   ‘weekly’按周
   ‘postbypost’罗列每一篇文章（以日期排序）
   ‘alpha’ 罗列每一篇文章（以文章名排序）
2. limit
   文章数量限制，即归档的最大文章数量。
3. format
   归档输出格式。
   可选值：
   ‘html’ -以html代码格式输出，即一个 li 列表
   ‘option’ – 在 select 标签中以选择列表的形式输出
   ‘link’ – 在link标签中输出归档地址
   ‘custom’ – 自定义，即使用after和before来包裹每一个项目。
4. before
   在每一条项目之前显示的文字，只在 format 被设置为’html’或’custom’时可用。
5. after
   在每一条项目之后显示的文字，只在 format 被设置为’html’或’custom’时可用。
6. show_post_count
   布尔值，是否显示文章数量，在 type 被设置为’postbypost’或’alpha’时不可用。
7. echo
   布尔值，是否显示，不显示则返回给变量。

使用实例

//按月输出最近12个月的文章归档链接
wp_get_archives ( 'type=monthly&limit=12' ); 
// 按天输出，最近15天的文章归档链接
wp_get_archives('type=daily&limit=15');
//按日期输出每一篇文章的链接，可以用作网站地图。
wp_get_archives('type=postbypost');?>
//在 select 标签中的演示
//这个例子很有实用价值。
<select name="archive-dropdown" onchange="document.location.href=this.options[this.selectedIndex].value;">
	<option value=""><?php echo esc_attr( __( 'Select Month' ) ); ?></option> 
    <?php wp_get_archives( 'type=monthly&format=option&show_post_count=1' ); ?>
</select>