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标签输出内容,默认以

  • 列表输出。

    • html:以
    • 列表输出;
    • option:以输出,需要自己添加标签;
    • 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

    文章类型

    函数使用示例

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

     'yearly',
    		'show_post_count' => true
    	);
    	wp_get_archives( $args );
    ?>
    

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

    
    

    扩展阅读

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

    原创文章,作者:,如若转载,请注明出处:https://ce.771633.xyz/1499.html

  • Like (0)
    Previous 2025年3月8日
    Next 2025年3月8日

    相关推荐

    发表回复

    您的邮箱地址不会被公开。 必填项已用 * 标注