当前浏览:首页 / WordPress函数 / get_archives_link()

get_archives_link( string $url, string $text, string $format = 'html', string $before = '', string $after = '', bool $selected = false )

根据预定义或自定义代码检索存档链接内容。

archive 存档

linkmore...


描述

格式可以是四种样式之一。head元素的“link”,在select元素中使用的“option”,在列表中使用的“html”(ol或ul html元素)。使用before和after参数也支持自定义内容。

“link”格式使用具有存档关系的<link>HTML元素。不使用前后参数。text参数用于描述链接。

“option”格式使用option HTML元素用于select元素。该值是url参数,在文本描述之间使用前后参数。

“html”格式是默认格式,在列表html元素中使用li html元素。before参数位于链接之前,after参数位于关闭链接之后。

自定义格式在链接(“a”HTML元素)之前使用before参数,在结束链接标记之后使用after参数。如果不使用格式的上述三个值,则假设为自定义格式。


参数

$url

(string) (必填) 存档的URL

$text

(string) (必填) 存档文本描述

$format

(string) (可选) 可以是“link”、“option”、“html”或自定义。

默认值: 'html'

$before

(string) (可选) 前置添加到描述的内容。

默认值: ''

$after

(string) (可选) 要附加到描述的内容。

默认值: ''

$selected

(bool) (可选) 如果当前页面是选定的存档页面,则设置为true。

默认值: false


返回

(string) 存档的HTML链接内容。



源码

查看源码 官方文档


更新日志

版本描述
5.2.0添加了$selected参数
1.0.0开始引入

用户贡献的笔记

  • 贡献者:Mahdi Yazdani

    在核心存档小工具中的post计数周围添加一个span。这样可以轻松设置计数的样式。

    /**
     * Adds a span around post counts in the archive widget.
     *
     * @param   string  $links      The comment fields.
     * @return  string
     */
    function wpdocs_archive_count_span( $links ) {
     	$links = str_replace( '</a>&nbsp;(', '<span class="count">', $links );
    	$links = str_replace( ')', '</span></a>', $links );
    	return $links;
    }
    add_filter( 'get_archives_link', 'wpdocs_archive_count_span' );