说明

该标签以与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’            => 1 ); ?>

默认情况下的显示状态：

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

参数

type

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

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

limit

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

format

（字符串）存档列表的格式。有效值包括：

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

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

分类：中文手册