模板标签-wp_get_archives()

0条评论

说明

该标签以与get_archives()(已停止使用)同样的方式显示一个基于日期的存档列表。唯一的不同在于,参数变量以查询字符串形式传递给该标签。wp_get_archives()可用在模板中的任何位置。

用法

<?php wp_get_archives( $args ); ?> 

默认用法

<?php $args = array(
    'type'            => 'monthly',
    'limit'           => ,
    
'format'          => 'html'
    
'before'          => ,
    'after'           => ,
    
'show_post_count' => false,
    
'echo'            => ); ?>

默认情况下的显示状态:

  • 按月显示存档链接
  • 显示所有存档文章(没有数量限制)
  • 以<li>HTML列表形式显示存档
  • 存档链接前后不显示任何内容
  • 不显示存档下的文章总数

参数

type

(字符串)将要显示的存档列表的类型。默认遵循WordPress的设置。有效值包括:

  • yearly
  • monthly ——默认值
  • daily
  • weekly
  • postbypost (以发表日期为顺序排列日志)
  • alpha (与postbypost相同,但以日志标题为顺序排列日志)

limit

(整数)可获取的存档数量。默认为无限制。

format

(字符串)存档列表的格式。有效值包括:

  • html —— 在HTML 列表(<li>)标签与beforeafter字符串内。默认值。
  • option —— 在选择符(<select>)或下拉式选项(<option>)标签中。
  • link —— 在链接(<link>)标签中
  • custom list—— 使用beforeafter字符串的自定义列表

before

(字符串)当format值为html或custom时,放在链接前的文字。无默认值。

after

(字符串)当format值为html或custom时,放在链接后的文字。无默认值。

show_post_count

(字符串)是否显示存档中的文章总数。用于'postbypost'外所有类型。

  • 1 (true)
  • 0(false)——默认值

echo

(布尔型)显示结果或返回。

  • 1 (true)——默认值
  • 0(false)

示例

最近12个月的存档

按月显示最近12个月的文章存档列表

<?php wp_get_archives('type=monthly&limit=12'); ?>

最近十五天的文章存档

按日期显示最近十五天的文章存档

<?php wp_get_archives('type=daily&limit=15'); ?>

最近二十篇文章存档

按文章标题为顺序,显示最近二十篇文章的存档列表。

<?php wp_get_archives('type=postbypost&limit=20&format=custom'); ?>

下拉式菜单

以下拉式菜单形式显示月份文章存档,在<select>标签中,显示文章总数。

<select name="archive-dropdown" onChange='document.location.href=this.options[this.selectedIndex].value;'> 
  <option value=""><?php echo attribute_escape(__('Select Month')); ?></option> 
  <?php wp_get_archives('type=monthly&format=option&show_post_count=1'); ?> </select>

历史记录

  • 始见于WordPress 2.1.0版本

源文件

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