wordpress二次开发:WordPress函数wp_list_bookmarks详解

2013-06-20 14:27 阅读 481 次 评论关闭

WordPress友情链接函数wp_list_bookmarks,该函数特点是只有一个参数,但是功能非常强大,这是因为它允许你写一个很长的参数组合。

默认参数:

‘orderby’ => ‘name”order’ => ‘ASC”limit’ => -1′category’ => ”’category_name’ => ”’hide_invisible’ => 1′show_updated’ => 0′echo’ => 1′categorize’ => 1′title_li’ => __(‘Bookmarks’)’title_before’ => ‘
”title_after’ => ‘

”category_orderby’ => ‘name”category_order’ => ‘ASC”class’ => ‘linkcat”category_before’ => ‘
”category_after’ => ‘‘

参数用途:

categorize

用于设置连接是否按照各自的分类显示:

1 (默认,根据链接的分类显示)

0 (不按照分类,显示全部)

category

友情链接的分类ID,将只显示该友情链接分类下的链接,不填默认显示所有链接。

category_name

友情链接分类名称,也就是别名,必须用英文。不填默认显示所有链接。

category_before

位于链接分类之前的文字或代码。默认的设置是:
category_after

位于链接分类之后的文字或代码。默认的设置是:

class

每一个链接的分类都会有一个 “class” 属性,默认是:linkcat

category_orderby

链接分类的排序方式,按照名词或者ID。

‘name’ (默认)

‘id’

category_order

链接分类的升降序排列方式:

ASC (默认)

DESC

title_li

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

title_before 和 title_after

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

show_private

是否显示私有链接。

1 (是)

0 (不是 – 默认)

include

输出指定 ID 的 Blogroll 的分类链接,各个 ID 之间用半角的 “,” 分开。默认显示所有的 Blogroll 分类。

exclude

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

orderby

Blogroll 的排列方式(默认是根据名称排序,除非将这个值留空),即根据我们在 WP 后台链接设置界面下的那些参数来进行排序:

1.’id’

2. ‘url’

3. ‘name’

4. ‘target’

5. ‘description’

6. ‘owner’

7. ‘rating’

8. ‘updated’

9. ‘rel’ – 按设定的关系排列

10. ‘notes’

11. ‘rss’

12. ‘length’ – 连接名称的长度设定

13. ‘rand’ – 随机排列显示

order

设置升降序的排列方式

ASC (默认)

DESC

limit

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

between

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

show_images

是否允许显示 Blogroll 下链接的对应图片。

1 (允许 – 默认)

0 (不允许)

show_description

是否允许显示每个链接的描述。

1 (允许)

0 (不允许 – 默认)

show_rating

是否允许显示链接的等级。

1 (允许)

0 (不允许 – 默认)

show_updated

是否允许显示最近更新后的时间戳。

1 (允许)

0 (不允许 – 默认)

hide_invisible

是否显示所有的链接,甚至是被管理员设为不可见的链接,默认允许显示。

1 (允许 – 默认)

0 (不允许)

举例说明:

<?phpwp_list_bookmarks(‘title_li=&categorize=0&orderby=rand&&category=2limit=10′); ?> 随机显示链接分类目录ID为2下的所有链接。

更多wordpress二次开发教程:

版权声明:本文著作权归原作者所有,欢迎分享本文,谢谢支持!
转载请注明:wordpress二次开发:WordPress函数wp_list_bookmarks详解 | 猎微网

评论已关闭!