【函数介绍】

wp_list_bookmarks()是用来获取友情链接的函数。
注:目前很多获取友链的函数都是 get_links_list()或者是get_links(),但未来获取友情链接将被wp_list_bookmarks()函数取代,相较而言wp_list_bookmarks()函数的功能会更强大些。

【使用方法】

<?php wp_list_bookmarks( $args ); ?>

【默认使用】

<?php $args = array(   
'orderby'          => 'name',   
'order'            => 'ASC',   
'limit'            => -1,   
'category'         => ,   
'exclude_category' => ,   
'category_name'    => ,   
'hide_invisible'   => 1,   
'show_updated'     => 0,   
'echo'             => 1,   
'categorize'       => 1,   
'title_li'         => __('Bookmarks'),   
'title_before'     => '<h2>',   
'title_after'      => '</h2>',   
'category_orderby' => 'name',   
'category_order'   => 'ASC',   
'class'            => 'linkcat',   
'category_before'  => '<li id=%id class=%class>',   
'category_after'   => '</li>' 
);  

【函数调用】

  • 友链的标题为默认标题
  • 包含所有分类的链接
  • 按照链接名称排序
  • 如果包含图像,则显示之
  • 在图像和文字之间有空格
  • 显示链接的描述
  • 不显示链接分级
  • 显示所有的链接

【参数说明】

orderby

(字符串)链接列表的标题文本。
默认值为'__('Bookmarks')',其中显示 "Bookmarks" (the __('') 用于本地化。
只有进行分类时使用都设置为 0 [false] (其他类别名称,将使用相反)。
如果 'title_li' 设置为 null (0) 值,则不显示标题,则列表将不会结束与<ul> </ul> (一定要传递给 0 [false],则此选项才生效的分类选项) 的标签。


order

(字符串)将文本放置在每个类别说明之前,如果 '分类' 1 [true],或在文本中定义"title_li"如果 '分类' 是 0 [false]。默认值为<h2>.


limit

(字符串)将文本放置每个类别的描述后,如果 '分类' 1 [true] 或文本定义在"title_li"如果 '分类' 是 0 [false]。默认值为' </h2> '.


category

(字符串)放置在每个书签之前的文本。默认值为<li>.


exclude_category

(字符串)放置后每个书签的文本。默认值为</li>.


category_name

r(字符串)每个书签的文本后放置文本。没有设置的默认值。(此参数添加了与版本 2.7)之间(字符串)每个书签/图像和它的描述之间放置文本。默认值为'\n' (换行符)。

show_images
(布尔)应为书签的图像显示 (TRUE) 还是不 (FAUSE).
1(True)-默认
0( False)
show_description
(布尔)描述应显示或不显示 (TRUE) (FALSE)。Show_images是虚假的或未定义图像时有效。
1(True)
0(False)-默认
show_name
(布尔)显示链接的文本时 (TRUE)。当为TRUE时show_images的作品。(此参数添加了与版本 2.7)
1(True)
0(False)-默认
show_rating
(布尔)应评级星星/字符显示或不显示 (TRUE) (FAUSE).
1(True)
0(False)-默认
show_updated
(布尔)上次更新时间戳应显示或不显示 (TRUE) (FALSE)。
请注意,link_updated 不会跟踪的本地修改。它跟踪链接无论指向 pingomatic 的远程请求通过更新时。
1(True)
0(False)-默认
hide_invisible
(布尔)应书签显示即使有可见的设置是号管理员设置 (TRUE) 遵守或不会没有遵守管理设置 (FAUSE).
1(True)-默认
0( False)
echo
(布尔)显示书签 (TRUE) 或返回他们使用 php (FAUSE).
1(True)-默认
0(False)

【使用示例】

简单的列表
显示”链接”的标题和裹在

标记的项目的所有书签。标题被包在 h2 标记。

<?php wp_list_bookmarks('title_li=&category_before=&category_after='); ?>  

无标题的简单列表
显示所有链接上面一样,但不包括默认的标题。

<?php wp_list_bookmarks('title_li=&amp;categorize=0'); ?>

特定类别按 URL 进行排序
显示书签的类别 ID 2 在 span 标记中,使用图像的书签,并不显示说明,按照书签 URL 进行排序。

<?php wp_list_bookmarks('categorize=0&amp;category=2before=<span>after=</span>show_images=1show_description=0&amp;orderby=url'); ?>;  

显示评级和时间戳
显示带有描述的新行的排序列表中的所有书签、 不使用图像的书签,按照排序书签 id、 链接级别和最后更新时间戳 (注意上次更新的时间戳不跟踪的本地修改。它跟踪链接无论指向 pingomatic 的远程请求通过更新时。)

<ol>
<?php wp_list_bookmarks('between=<br />show_images=0&orderby=idshow_rating=1show_updated=1'); ?>;   
</ol>

替换图像标题
从主题文件夹,而不是纯文本中使用的图像。

<?php wp_list_bookmarks('categorize=0title_before=title_after=title_li=<img src="'.get_bloginfo("stylesheet_directory").'/images/blogroll.gif" alt="blogroll" />'); ?>