wp_get_archives 输出文章归档

评论(4)

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往下看

参数默认值

 <?php $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
    布尔值,是否显示,不显示则返回给变量。

使用实例

<?php
//按月输出最近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>

总结

之前自己费了好半天劲去考虑生成一个网站地图,
结果今天看官方文档的时候发现这个至宝,
所以说官方文档还是要多看的。
另外大家不要小觑wp_开头的函数,如之前讲过的wp_list_bookmarks函数,wp_list_comments函数,
还有一个用法比较类似的 get_archives_link 函数,这里就不在赘述了,
也许有一天实在没东西写了,可能会写一写。
官方文档地址:
http://codex.wordpress.org/Function_Reference/get_bookmark_field





转载请注明转自: wp_get_archives 输出文章归档

  1. 如何禁用输出呢?

  2. 找了一下午终于让我找到了,谢了站长

  3. 快乐学习中,我想改一下显示呢。

  4. 支持翻译,每次做主题搜标签,总是会搜到很多热心朋友的文章