WordPress函数：wp_tag_cloud(标签云).doc

说明wp_tag_cloud() 函数的作用是用来标签云的，可以根据每个标签所关联的文章次数来定义字体大小、标签排序等属性。从 2.8 版本开始，添加了 分类法（taxonomy）参数，这就意味着，除了 标签（tags）以外，还可以将 分类（Categories） 或其他 自定义分类法（Custom Taxonomies）作为“云”显示。用法1默认用法1234567891011121314151617 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(see Note!); ?注： child_of 不是一个直接的 wp_tag_cloud 数组的键（Key），但由于这个函数使用 wp_parse_args() 和 get_terms() ，你可以通过 get_terms() 使用所有的数组键。默认情况下的输出内容：o smallest 最小的标签（使用次数最少）显示大小为8o largest 最大的标签（使用次数最多）显示大小为22o unit 最大值最小值的单位为pto number 至多显示45个标签o format 以平面形式显示所有标签（标签之间用空格隔开）o separator 显示标签之间的空格o orderby 按名称为标签排序o order 以升序排列o exclude 不排除任何标签o include 包括所有标签o topic_count_text_callback 使用函数 default_topic_count_texto link 可视o taxonomy 用文章的标签作为云基础o echo 输出结果参数smallest（整数）（可选）使用次数最少的标签的字号大小（单位由unit参数决定）默认值：8largest（整数）（可选）使用次数最多的标签的字号大小（单位由unit参数决定）默认值：22unit（字符串）（可选）对smallest与largest的值的测量单位。可以是任何CSS长度单位，如pt, px, em, %。默认值：ptnumber（整数）（可选）显示在云中的实际标签数。（值为0时显示所有标签）默认值：45format（字符串）（可选）所显示的云的格式。o flat （默认值）标签被“separator”参数所定义的空格分隔o list 标签与class=wp-tag-cloud 共同在UL中o array 标签在数组中，函数以数组方式返回标签云，以用在PHP中。注意：数组被返回，而非显示。separator（字符串）（可选）标签之间的文本/空格。默认值：n （空格）orderby（字符串）（可选）标签的排列依据。有效值包括：o name （默认值）o countorder（字符串）（可选）排列顺序（升序或降序）。有效值包括（必须大写）：o ASC 升序（默认值）o DESC 降序o RAND 随机exclude（字符串）（可选）将要被排除的标签（term_id）的ID，各ID用逗号隔开。如 exclude=5,27表示不显示term_id为5或27的标签。默认值为不排除任何标签。include（字符串）（可选）要包含的标签（term_id）列表，各ID用逗号隔开。例如， include=5,27 表示只显示term_id为5或27的标签。默认为包含所有链接。topic_count_text_callback（字符串）（可选）给出标签所关联的文章数，返回标签链接的用于 tooltip 的文本。默认值： default_topic_count_textlink（字符串）（可选）设置链接，允许编辑某个指定标签。有效值包括：o view （默认值）o edittaxonomy（字符串）（可选）用以生成云的分类法。o post_tag （默认值）将文章标签当作云的来源o category 用文章分类生成云o link_category 用链接分类目录生成云o 任何其他已注册的分类法o 或者一组 分类法 （注：此参数引入于 3.1 版本）echo（布尔型）（可选）显示结果，或将结果保留在变量中。默认值为true（显示标签云）。有效值包括：o 1 (true) 默认值o 0 (false)例子显示标题为Popular Tags的云12345678 Popular Tags 限制标签大小且以使用次数而非名称排列标签的云1以数组形式返回云，但不显示在变量$tag中包含标签云，以用在其它PHP代码中1 显示分类云使用分类法（taxonomy）参数定义显示分类云123 category ) ); ?显示 分类 和 标签 云使用分类法数组将分类和标签显示为云1234567 array(post_tag,category), ); wp_tag_cloud($args);?更改云链接的标题文本使用 topic_count_text_callback 参数传递一个新的返回函数。原始函数 default_topic_count_text() 位于 /wp-includes/category-template.php 。这个例子使用“pictures”替换默认的“topics”：1234567 my_tag_text_callback ) ); function my_tag_text_callback( $count ) return sprintf( _n(%s picture, %s pictures, $count), number_format_i18n( $count ) );?创建标签存档页面从 2.3 版本开始，标签云可以制作成一个标签存档页面。这就意味着，用户可以点击某个标签，然后查看到该使用该标签的所有文章。根据 模板层级（Template_Hierarchy），如果tag.php模板不存在，那么就使用archives.php模板。通过tag,php模板你可以自定义标签存档索引的样式，为方便导航，模板会在最上方包含标签云。要将标签云显示在模板上方，你需要将一个新模板添加到主题文件中。模板、模板层级 中有相关介绍。基础步骤包括：1. 用下面的内容创建一个文件，命名为tag.php2. 将新文件上传到主题目录下3. 如果你希望在页面导航中加入一个指向标签索引的链接，可进行第三步骤，否则点击某个标签时会使用新模板。o 用新模板新建一个空白页面，将页面命名为标签存档索引。对第三步的进一步阐述：WordPress可为不同页面使用不同页面模板。在 页面添加新页面 界面的最下方（或是侧边栏，取决于你安装的WordPress版本）有一个名为“页面模板”的下拉式菜单。你可以在这里选择显示某个页面所用的模板。12345678910111213141516171819202122Tag Archive a href= rel=bookmark title=Permanent Link to 注意：模板还没有添加样式。通过查看single.php主题文件可以了解你的主题所用的结构。函数历史o 3.1 添加传递分类法数组的功能参数o 2.9 添加 separator 参数o 2.8 添加 taxonomy 和 echo