WordPress友情链接函数wp_list_bookmarks调用

有些时候,我们并不想要某个友情链接在全站页面都体现,而是想实现类似的效果:只在首页显示一部分的友链,然后其它的都体现在“友情链接页面”,而普通的文章页和列表页之类则是不再显示。

实现过程并不复杂,调用链接时稍微自定义一下就可以实现这样的效果,我们可以运用wp_list_bookmarks函数来实现个性化的友情链接调用。

首先,要对友情链接进行分类处理,然后使用类似下面的代码单独调用该分类的链接:

代码含义:显示分类id为2的所有链接,以链接的ID排序,并且不显示链接分类目录名。

需要按分类显示全部链接的地方,则可以加入以下代码调用:

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:字符串型,链接分类的排序方式,按照名称(name)或者ID。

category_order:字符串型,链接分类的升序(ASC,默认)降序(DESC)显示方式。

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

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

show_private:布尔型,是否显示私有链接。

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

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

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

进行排序:

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

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

show_images:布尔型,是否允许显示 Blogroll 下链接的对应图片。

show_description:布尔型,是否允许显示每个链接的描述。

show_rating:布尔型,是否允许显示链接的等级。

show_updated:布尔型,是否允许显示最近更新后的时间戳。

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

理解这些参数的用途之后,就可以十分灵活的调用链接, 只需要再用CSS美化一下显示结果。