WordPress友情链接函数wp_list_bookmarks()参数设置详解

与前面介绍的wp_list_cats函数一样,wp_list_bookmarks 这个函数也是灰常强大的,比以前的函数get_links_list()和get_links()更加强大,它也有很多参数。使用的时候,参数和参数之前用”&”分隔就可以了。

下面详细的讲解一下每个参数作用:

1.categorize布尔型,用于设置连接是否按照各自的分类显示:1(默认,根据链接的分类显示);0(不按照分类,显示全部)。

2.category字符串型,后面就直接 “=链接分类ID号”,那么就显示这个分类下的链接。如果没有指定的话就显示所有的链接。

3.category_name字符串型,如果后面 “=某个链接分类的名称” 那么就会在该链接分类前显示分类的名称,如果这里留空的话则会显示所有链接分类的分类名称(即默认的形式)。

4.category_before字符串型,位于链接分类之前的文字或代码。默认的设置是:<li id=”[category id]” class=”linkcat”>。

5.category_after

字符串型,位于链接分类之后的文字或代码。默认的设置是:</li>。

6.class字符串型,每一个链接的分类都会有一个 “class” 属性(从上面的代码就能看出),默认是:linkcat。

7.category_orderby字符串型,链接分类的排序方式,按照名词或者ID。取值为’name’ (默认) 或’ id’。

8.category_order字符串型,链接分类的升降序排列方式:ASC (默认)或DESC。

9.title_li字符串型,链接标题的头文字或代码,默认是:Bookmarks,并且它控制连接是否按照列表的方式排列。

10.title_before 和 title_after顾名思义,它们就是连接标题头前后的文字或代码,默认是 h2 标签。

11.show_private布尔型,是否显示私有链接。取值为1 (是)或0 (不是 – 默认)

12.include:字符串型,输出指定 ID 的 Blogroll 的分类链接,各个 ID 之间用半角的 “,” 分开。默认显示所有的 Blogroll 分类。

13.exclude字符串型,将指定 ID 的 Blogroll 分类链接从整个链接列表中排除,各个 ID 之间用半角的 “,” 分开。默认是什么都不排除。

14.orderby字符串型,Blogroll 的排列方式(默认是根据名称排序,除非将这个值留空),即根据WP 后台链接设置界面下的那些参数来进行排序。常用的有’id’-按ID排序; ‘name’-按名称排序;’rel’-按设定的关系排列;’length’-连接名称的长度设定;’rand’-随机排列显示。

15.order字符串型,设置升降序的排列方式。取值为ASC (默认)DESC。

16.limit整型,设置输出链接条数的最大值。默认值是”-1″,输出全部。

17.between字符串型,每个连接、图片和描述之间的文字或代码,默认是 “n” 换行。

18.show_images:布尔型,是否允许显示 Blogroll 下链接的对应图片。取1为(允许 – 默认),0为(不允许)。

19.show_description布尔型,是否允许显示每个链接的描述。取1为(允许),0为(不允许 – 默认)。

20.show_rating布尔型,是否允许显示链接的等级。取1为(允许),0为(不允许 – 默认)。

21.show_updated布尔型,是否允许显示最近更新后的时间戳。取1为(允许),0为(不允许 – 默认)。

22.hide_invisible布尔型,是否显示所有的链接,甚至是被管理员设为不可见的链接,默认允许显示。取1为(允许 – 默认),0为(不允许)

例如:

随机显示10条链接:

<?php wp_list_bookmarks('orderby=rand&limit=10'); ?>

剩下的大家可以自己发挥去吧。还是那句话,妹妹你大胆的往前走啊往前走

 » 本站地址:http://www.gomoth.com

标签: