Apr12

WordPress标签云用法 wp_tag_cloud

wp_tag_cloud

标签云(Tag Cloud)是用以表示一个网站中的内容标签,标签的排列顺序一般按照热门程度确定字体的大小和颜色。这样,依照热门程度来寻找信息便成为可能。标签通常是超链接,指向分类页面。

首先使用标签云的是照片共享网站Flickr,标签云的设计者是交互设计师Stewart Butterfield。之后,标签云被诸如del、Technorati等网站采纳。

wp_tag_cloud 作为 WordPress 内置函数,可以方便地实现标签云。相关参数说明:

smallest:使用次数最少的标签的字号大小(单位由unit参数决定),默认值为8,一般要小一些。

largest:使用次数最多的标签的字号大小(单位由unit参数决定),默认值为22,一般要大一些(将这两个值设为相同时,标签显示为同等大小,在一些位置使用也不错,比如标题栏下方,整齐的一排)。

unit:(字符串)对smallest与largest值的测量单位,如pt, px, em, %,默认值为’pt’。

number:显示标签数量,值为’0′时显示所有标签,默认值为45。

format:(字符串)所显示标签云的格式。’flat’ (默认值)标签被“separator”参数所定义的空格分隔;’list’ 标签与class=’wp-tag-cloud’ 共同在UL中;’array’ 标签在数组中,函数以数组方式返回标签云,以用在PHP中。

separator:(字符串)标签之间的文本/空格。默认值:’/n’ (空格)

orderby:(字符串)标签的排列顺序的方式,’name’ (默认值,按名称排列),’count’ (按使用次数排列)。

order:(字符串)排列顺序(升序或降序),‘ASC’ ——默认值;‘DESC’;‘RAND’ 随机排列。

exclude:(字符串)不显示的标签(term_id)的ID,各ID用逗号隔开,如 ‘exclude=1,2′表示不显示id为1和2的标签,默认全显示。

include:(字符串)选择要显示的标签(term_id)列表,各ID用逗号隔开,例如, ‘include=3,4′ 表示只显示id为3和4的标签,默认全显示。

link:(字符串)设置链接,允许编辑某个指定标签,‘view’ (默认值)‘edit’

taxonomy:(字符串)用以生成云的分类法。‘post_tag’ —— (默认值)将文章标签当作云的来源;‘category’ —— 用文章分类生成云;‘link_category’ —— 用链接分类目录生成云。

echo:(布尔型)显示结果,或将结果保留在变量中,默认值为true(显示标签云),1 (true) —— 默认值,0 (false)

具体调用代码:

<?php
wp_tag_cloud('smallest=8&largest=14&number=12&order=RAND');
?>

更多细节请参考http://codex.wordpress.org/Function_Reference/wp_tag_cloud。有任何疑问欢迎留言。

Comments are closed.