正在加载中……
最新消息:欢迎大家访问,导航分类不完善,如果找不到自己想要的文章,可以通过【关键词】来进行搜索,^_^!

WordPress模板标签-wp_tag_cloud()云标签函数详解

Linux专题 REKFAN.COM 7321浏览 1评论

更多


关于wp_tag_cloud()云标签
1.说明
该标签于WordPress 2.3版本投入使用,可在所谓的“标签云”中显示多个标签,所显示标签的大小取决于该标签的使用频率。WordPress 2.8中的wp_tag_cloud引入了taxonomy参数,使分类法被用作云的产生基础。这意味着,例如,你可以通过wp_tag_cloud向访问者展示文章的分类云。

2.用法

<?php wp_tag_cloud( $args ); ?>

3.默认用法

 <?php $args = array(
'smallest'  => 8,
'largest'   => 22,
'unit'      => 'pt',
'number'    => 45,
'format'    => 'flat',
'separator' => 'n',
'orderby'   => 'name',
'order'     => 'ASC',
'exclude'   => ,
'include'   => ,
'link'      => 'view',
'taxonomy'  => 'post_tag',
'echo'      => true ); ?>

4.默认情况下所显示的结果

    * smallest —— 最小的标签(使用次数最少)显示大小为8
* largest ——最大的标签(使用次数最多)显示大小为22
* unit —— 最大值最小值的单位为'pt'
* number —— 至多显示45个标签
* format —— 以平面形式显示所有标签(标签之间用空格隔开)
* separator —— 显示标签之间的空格
* orderby —— 按名称为标签排序
* order —— 以升序排列
* exclude —— 不排除任何标签
* include —— 包括所有标签
* link —— 可视
* taxonomy —— 用文章的标签作为云基础
* echo —— 响应结果

5.参数说明

smallest

(整数)(可选)使用次数最少的标签的字号大小(单位由unit参数决定)

默认值:8

largest

(整数)(可选)使用次数最多的标签的字号大小(单位由unit参数决定)

默认值:22

unit

(字符串)(可选)对smallest与largest的值的测量单位。可以是任何CSS长度单位,如pt, px, em, %。

默认值:'pt'

number

(整数)(可选)显示在云中的实际标签数。(值为'0'时显示所有标签)

默认值:45

format

(字符串)(可选)所显示的云的格式。

* 'flat' (默认值)标签被“separator”参数所定义的空格分隔
* 'list' 标签与class='wp-tag-cloud' 共同在UL中
* 'array' 标签在数组中,函数以数组方式返回标签云,以用在PHP中。注意:数组被返回,而非显示,引入于WordPress 2.5。

separator

(字符串)(可选)标签之间的文本/空格。注意:该参数引入于WordPress 2.9。

默认值:'/n' (空格)

orderby

(字符串)(可选)标签的排列顺序。有效值包括:

* 'name' (默认值)
* 'count'

order

(字符串)(可选)排列顺序(升序或降序)。有效值包括——必须大写:

* 'ASC' ——默认值
* 'DESC'
* 'RAND' —— 以任意顺序排列标签。注意:该标签引入于WordPress 2.5。

exclude

(字符串)(可选)将要被排除的标签(term_id)的ID,各ID用逗号隔开。如 'exclude=5,27'表示不显示term_id为5或27的标签。默认值为不排除任何标签。

include

(字符串)(可选)要包含的标签(term_id)列表,各ID用逗号隔开。例如, 'include=5,27' 表示只显示term_id为5或27的标签。默认为包含所有链接。

link

(字符串)(可选)设置链接,允许编辑某个指定标签。注意:该标签引入于WordPress 2.7。有效值包括:

* 'view' (默认值)
* 'edit'

taxonomy

(字符串)(可选)用以生成云的分类法。注意:该标签引入于WordPress2.8。

* 'post_tag' —— (默认值)将文章标签当作云的来源
* 'category' —— 用文章分类生成云
* 'link_category' —— 用链接分类目录生成云

echo

(布尔型)(可选)显示结果,或将结果保留在变量中。默认值为true(显示标签云)。注意:该标签引入于WordPress2.8。有效值包括:

* 1 (true) —— 默认值
* 0 (false)

6.实例

 显示常用标签标题的云

<?php if ( function_exists('wp_tag_cloud') ) : ?>
<li>
<h2>Popular Tags</h2>
<ul>
<?php wp_tag_cloud('smallest=8&largest=22'); ?>
</ul>
</li>
<?php endif; ?>

限制标签大小且以使用次数而非名称排列标签的云

<?php wp_tag_cloud('smallest=8&largest=22&number=30&orderby=count'); ?>

 以数组形式返回云,但不显示在变量$tag中包含标签云,以用在其它PHP代码中

 <?php $tag = wp_tag_cloud('format=array' );?>  

转载请注明:|REKFAN|系统运维| » WordPress模板标签-wp_tag_cloud()云标签函数详解

表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址

网友最新评论 (1)