通俗易懂的WordPress函数简明教程

（四）

从上一篇开始，我们就转而介绍了经常用于WordPress主题侧边栏的一些函数，比如query_posts()、get_posts()、get_calendar()等等。本文，月夜 接上文继续为朋友们介绍WordPress侧边栏常用的一些函数。

25.wp_list_bookmarks()

该函数用来显示博客的友情链接，并可以使用各种参数来控制显示的数量、种类以及样式等等。

形如wp_list_bookmarks(’title_li=&categorize=0&orderby=rand&include=41,40,37,54′);的形式，意义解释如下：

title_li=&categorize=0是一种通常使用的组合，意为不显示WordPress后台控制面板中设置的友情链接标题，但所有友链都按照设置的分类显示出来；单独的一个title_li=还可以用来设置被显示友链的类别名称；

orderby=rand设置友链的显示方式为随机顺序，当然，还可以设置为其他的方式，比如id、url、name等等；

include=41,40,37,54表示只显示ID为这四个数字的四个友链；与此对应，还支持使用exclude，表示不显示ID为多少的友链。

此外，该函数还经常用到的参数有before和after，用来设置每个链接前后的文字，默认的是<li>和</li>标记。

26.get_links()、wp_get_links()

这两个函数实现和25.wp_list_bookmarks()相同的功能，不过此二函数已在WordPress升级的过程中为25.wp_list_bookmarks()所取代。

27.wp_list_pages()

该函数以页面名称的超链接形式显示WordPress博客内的所有页面，经常用来建立顶端导航页面，或用来修饰侧边栏。

形如wp_list_pages(’title_li=&sort_column=menu_order&include=12,25,38,57&depth=1&’);的函数调用，各参数意义如下：

title_li=用来设置所有显示页面的一个总名称；后面没有参数值时，表示不显示名称；

sort_column=menu_order用来设置页面的显示顺序，表示按照WP后台设置的各页面顺序显示，其他的常用顺序设置可能还包括post_title、post_date、ID等等；

include=12,25,38,57表示只显示ID为这四个数值的四个页面；同样，可以使用exclude来排除相应ID的页面；

depth=1表示只显示父页面，对所有子页面不予显示；其他数值还包括默认的0，表示显示所有页面（子页面有缩进）；-1显示所有页面（子页面无缩进）；等等。

此外，该函数可能会用到的属性还包括link_before和link_after，用于设置显示的页面链接前后的字符。

28.wp_tag_cloud()

顾名思义，wp_tag_cloud()函数用来显示WordPress博客的标签云。

一种形如wp_tag_cloud(’smallest=8&largest=22&number=30&orderby=count’);的函数调用，各参数的意义如下：

smallest=8用来设置标签云中显示出来的所有标签中，计数最少（最少文章使用）的标签的字体大小为8；

largest=22用来设置标签云的所有标签中，计数最多（最多文章使用）的标签的字体大小为22；

number=30设置标签云中显示的最多标签数量为30；

orderby=count设置标签云中标签的排序方式为计数（默认），而不是名称（相应参数为name，widget调用时的默认值）。

其他常用的参数还包括include和exclude，用来设置在标签云中是否包含或去除ID为某数字的标签。

继续阅读下页