> WordPress开发手册 > wp_get_archives

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>

上一篇:
下一篇: