WordPress归档列表标签:wp_get_archives

WordPress模板标签wp_get_archives用于显示一个基于日期的归档列表,这个标签可以用在任何模板,通常用来制作一个日期归档页。

wp_get_archives( array|string $args = '' )

函数参数

$args

数组或字符串值

wp_get_archives()函数$args参数默认的值如下:

$args = array(
	'type'				=> 'monthly',
	'limit'				=> '',
	'format'			=> 'html', 
	'before'			=> '',
	'after'				=> '',
	'show_post_count'	=> false,
	'echo'				=> 1,
	'order'				=> 'DESC',
	'post_type'			=> 'post'
);

wp_get_archives()函数$args参数可用的值如下:

type

字符串值,默认值:monthly

归档的方式,以年、月、日、周等归档

  • yearly:按年份归档
  • monthly:按月份归档
  • daily:按天归档
  • weekly:按周归档
  • postbypost:按发表日期列出所有文章
  • alpha:按文章标题排序列出所有文章

limit

整数型,默认为空

显示的数量,默认为无限

format

字符串值,默认值:html

以何种HTML标签输出内容,默认以<li>列表输出。

  • html:以<li>列表输出;
  • option:以<option>输出,需要自己添加<select>标签;
  • link:以<link>标签输出,rel值为archives;
  • custom:自定义包裹链接的标签,将使用before和after定义的值;

before

字符串值,默认为空

当format的值为custom时,before的值将在链接前输出,即包裹链接的开始标签。

after

字符串值,默认为空

当format的值为custom时,after的值将在链接后输出,即包裹链接的开始标签。

show_post_count

布尔值,默认值:false

显示文章数量,type的值不为postbypost或alpha时。

echo

布尔值,默认值:1

是否输出结果,如果为0则只返回结果而不是输出。

order

字符串值,默认值:ASC

排序方式

  • ASC:升序
  • DESC:降序

post_type

字符串值,默认值:post

文章类型

函数使用示例

按年份输出归档,并显示文章数量

<?php
	$args = array(
		'type' => 'yearly',
		'show_post_count' => true
	);
	wp_get_archives( $args );
?>

下面的代码输出一样的结果:

<?php wp_get_archives( 'type=yearly&show_post_count=1' ); ?>

扩展阅读

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

Typora