从上一篇介绍WordPress函数的文章用好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,用来设置每个链接前后的文字,默认的是
和 标记。
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为某数字的标签。