WordPress标签云标签:wp_tag_cloud

WordPress模板标签wp_tag_cloud用于输出标签云,标签的大小由该标签下的文章数量决定。

1
wp_tag_cloud( array $args = '' )

函数参数

$args

数组或字符串值

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
$args = array(
    'smallest'                  => 8,
    'largest'                   => 22,
    'unit'                      => 'pt',
    'number'                    => 45,  
    'format'                    => 'flat',
    'separator'                 => "\n",
    'orderby'                   => 'name',
    'order'                     => 'ASC',
    'exclude'                   => null,
    'include'                   => null,
    'topic_count_text_callback' => default_topic_count_text,
    'link'                      => 'view',
    'taxonomy'                  => 'post_tag',
    'echo'                      => true,
    'child_of'                  => null,
);

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

smallest

整数型,默认值:8

最小字号大小

largest

整数型,默认值:22

最大字号大小

unit

字符串值,默认值:pt

字号单位

number

整数型,默认值:45

显示的标签数量

format

字符串值,默认值:flat

列表的格式,可选值:

  • flat:空格;
  • list:UL列表;
  • array:数组;

separator

字符串值,默认值:\n

标签之间的文本

orderby

字符串值,默认值:name

排序规则,可选值:

  • name:按名称排序;
  • count:按文章数量排序;

order

字符串值,默认值:ASC

排序方式,可选值:

  • ASC:升序;
  • DESC:降序;
  • RAND:随机;

exclude

字符串值,默认值:null

提供标签ID,以排除显示这些标签,多个标签ID用半角逗号分隔

include

字符串值,默认值:null

提供标签ID,以显示这些标签,多个标签ID用半角逗号分隔

topic_count_text_callback

字符串值,默认值:default_topic_count_text

指定一个函数名称,该函数返回的值将作为链接的title属性值,默认输出文章数量,例如:28个话题

link

字符串值,默认值:view

链接的类型,可选值:

  • view:输出标签归档页面链接;
  • edit:当已登录且有编辑标签的权限时,输出编辑该标签的链接,否则输出首页链接;

taxonomy

字符串或数组,默认值:post_tag

指定分类法名称,可选值:

  • post_tag:文章标签;
  • category:文章分类;
  • link_category:友情链接分类;

echo

布尔值,默认值:true

是否输出返回结果

函数使用示例

1
2
3
4
5
6
<?php if ( function_exists( 'wp_tag_cloud' ) ) : ?>
    <h2>标签云集</h2>
    <ul>
        <li><?php wp_tag_cloud( 'smallest=8&largest=22' ); ?></li>
    </ul>
<?php endif; ?>

扩展阅读

wp_tag_cloud()函数位于:wp-includes/category-template.php

相关函数:

  • get_tag()
  • get_tag_link()
  • get_tags()
  • get_the_tag_list()
  • get_the_tags()
  • is_tag()
  • the_tags()
  • single_tag_title()
  • tag_description()
  • wp_generate_tag_cloud()
原文链接:https://xiaohost.com/2392.html,转载请注明出处。
0