WordPress友情链接 wp_list_bookmarks 函数详解

2012年03月18日15:23:20 发表评论 热度1,297 ℃

WordPress友情链接 wp_list_bookmarks 函数详解

WordPress友情链接使用wp_list_bookmarks函数。该标签函数允许用户更改链接的排列顺序和显示方式,它取代了已弃用标签get_links_list()与get_links()。

下面是详细的使用说明:

wp_list_bookmarks 函数的默认参数是:

  1. <?php $args = array(
  2.     'orderby'          => 'name',
  3.     'order'            => 'ASC',
  4.     'limit'            => -1,
  5.     'category'         => ' ',
  6.     'exclude_category' => ' ',
  7.     'category_name'    => ' ',
  8.     'hide_invisible'   => 1,
  9.     'show_updated'     => 0,
  10.     'echo'             => 1,
  11.     'categorize'       => 1,
  12.     'title_li'         => __('Bookmarks'),
  13.     'title_before'     => '<h2>',
  14.     'title_after'      => '</h2>',
  15.     'category_orderby' => 'name',
  16.     'category_order'   => 'ASC',
  17.     'class'            => 'linkcat',
  18.     'category_before'  => '<li id=%id class=%class>',
  19.     'category_after'   => '</li>' ); ?>

默认情况下的用法:

* 链接被划分为不同类别,每个类别有一个名称

* 包含所有链接,无论是链接的分类名称还是ID

* 按名称排列链接列表

* 如果有图片,包含图片

* 图片和链接文本间应有空格

* 显示链接的描述

* 不显示链接等级

* 无限制,显示所有链接

* 显示所有链接

参数的用途:

categorize

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

category

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

category_name

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

category_before

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

category_after

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

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 (不允许)

例如:

随机显示分类ID为1的链接:


随机显示10条链接:


瓜皮猪

发表评论

:?: :razz: :sad: :evil: :!: :smile: :oops: :grin: :eek: :shock: :???: :cool: :lol: :mad: :twisted: :roll: :wink: :idea: :arrow: :neutral: :cry: :mrgreen: