说明
该标签以与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
分类:中文手册