在主题制作中,wp_list_bookmarks是比较常用的WordPress函数,在主题中调用友情链接的时候,通常都要用到。下面就对这个WordPress友情链接函数wp_list_bookmarks()做一下详细的介绍。
注:wp_list_bookmarks()已经取代了之前的老函数get_links_list() 和 get_links()。
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>' ); ?>
默认情况下(没有添加任何参数)的用法:
链接被划分为不同类别,每个类别有一个名称
包含所有链接,无论是链接的分类名称还是ID
按名称排列链接列表
如果有图片,包含图片
图片和链接文本间应有空格
显示链接的描述
不显示链接等级
无限制,显示所有链接
显示所有链接
wp_list_bookmarks()参数详解
categorize
(布尔型)是否所有链接都应该显示在相应的分类目录下。
1 (true)——默认值
0(false)
category
(字符串)将要显示的链接分类目录的ID,用逗号隔开。如果没有指定分类,显示所有含有链接的链接分类。
exclude_category