首页 > php > WordPress友情链接函数wp_list_bookmarks详细说明

WordPress友情链接函数wp_list_bookmarks详细说明

2010年8月12日 亲亲宝宝 发表评论 阅读评论

想要做个性的wordpress的友情链接,需要了解一下wp_list_bookmarks函数。常见调用方式如:

<?php wp_list_bookmarks(‘categorize=0&orderby=rating’); ?>

上面表示显示所有分类,按照等级排序;

注意:wp_list_bookmarks()取代了已弃用标签get_links_list()与get_links()。该标签允许用户更改链接的排列顺序和显示方式。

默认用法

<?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

* 按名称排列链接列表

* 如果有图片,包含图片

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

* 显示链接的描述

* 不显示链接等级

* 无限制,显示所有链接

* 显示所有链接

参数

categorize

(布尔型)是否所有链接都应该显示在相应的分类目录下。

* 1 (true)——默认值

* 0(false)

category

(字符串)将要显示的链接分类目录的ID,用逗号隔开。如果没有指定分类,显示所有含有链接的链接分类。

exclude_category

(字符串)将被排除的链接分类目录的ID,用逗号隔开。默认值为 (no categories excluded)(不排除任何链接分类)。

category_name

(字符串)将要显示的链接所属分类的名称。如果没有指定分类,显示所有含有链接的链接分类。默认值为 (all Categories)(所有链接)。

category_before

(字符串)放置在每个链接分类目录前的文本。默认值为'<li>’。

category_after

(字符串)放置在链接分类目录后的文本。默认值为'<‘/li>’。

class

(字符串)链接分类列表所在类。默认值为’linkcat’。(该参数引入于WP 2.2)

category_orderby

(字符串)用以排列链接分类的值。有效值包括:

* ‘name’ ——默认值

* ‘id’

* ‘slug’

* ‘count’

* ‘term_group’ (不再使用)

category_order

(字符串)排列的顺序,以升序或降序排列category_orderby参数值。有效值包括:

* ASC ——默认值

* DESC

title_li

(字符串)链接列表的标题。默认值为 ‘__(‘Bookmarks’)’,显示标题为“Bookmarks”(the_(‘ ‘)用于本地化。)只有将categorize设为0(false)时,才可使用该参数(否则将使用分类名称)。若将title_li设为空(0),则不显示列表标题,且链接列表不会被 <ul>, </ul>标签围绕(要确保将categorize选项设为0,以使title_li生效)。

title_before

(字符串)’categorize’值为1(true)时显示在每个链接类别前的文本,或’categorize’值为0(false)时在’title_li’中定义的文本。 默认值为'<h2>’。

title_after

‘categorize’值为1(true)时显示在每个链接类别后的文本,或’categorize’值为0(false)时在’title_li’中定义的文本。 默认值为'</h2>’。

show_private

(布尔型)是否应显示某个链接分类(即使该分类被认为是私密的)。忽略管理面板的设置,显示私密链接分类(TRUE),或者不显示私密链接分类(FALSE)。

* 1 (true)

* 0(false)——默认值

include

(字符串)在结果中包含的数值型链接ID列表,各ID用逗号隔开。例如, ‘include=1,3,6’ 表示返回或响应ID为1、3、6的链接。如果使用include字符串,那么 category、category_name、exclude参数将被忽略。默认值为 (all Bookmarks)(所有链接)。

exclude

(字符串)将要被排除的链接的ID,各ID用逗号隔开。如 ‘exclude=4,12’表示不返回ID为4和12的链接。默认值为 (exclude nothing)(不排除任何链接)。

orderby

(字符串)以何顺序为链接排序。这可能是一份各个值的列表,各值由逗号隔开。默认值为’name’,除非你传递’ ‘(空)值给该参数,此时参数值为’id’。有效值包括:

* ‘id’

* ‘url’

* ‘name’ ——默认值

* ‘target’

* ‘description’

* ‘owner’ —— 通过连接管理器添加链接的用户

* ‘rating’

* ‘updated’

* ‘rel’ —— 链接关系(XFN)

* ‘notes’

* ‘rss’

* ‘length’ —— 链接名称的长度,范围从最短的名称到最长的名称

* ‘rand’ —— 以任意顺序显示链接

order

(字符串)根据’orderby’参数中的设置为分类目录排序(升序或降序)。有效值包括:

* ASC ——默认值

* DESC

limit

(整数)可以显示的最大链接数。默认值为-1(所有链接)。

before

(字符串)放置在链接前的文本。默认值为'<li>’。

after

(字符串)放置在链接后的文本。默认值为'</li>’。

link_before

(字符串)超链接代码中链接文本前的文字。无默认值。(该参数引入于WP 2.7)

link_after

(字符串)超链接代码中链接文本后的文字。无默认值。(该参数引入于WP 2.7)

between

(字符串)链接/图片与其说明之间的文本。默认值为’\n’(换行)。

show_images

(布尔型)是(TRUE)否(FALSE)显示链接的图片

* 1 (true)——默认值

* 0(false)

show_description

(布尔型)是(TRUE)否(FALSE)显示链接说明。该参数用于show_images为FALSE时或未定义链接图片时。

* 1 (true)

* 0(false)——默认值

show_name

(布尔型)显示链接文本(TRUE)。该参数用于show_images为TRUE时。(该参数引入于WP 2.7)

* 1 (true)

* 0(false)——默认值

show_rating

(字符串)是(TRUE)否(FALSE)显示链接的级别。

* 1 (true)

* 0(false)——默认值

show_updated

(布尔型)是(TRUE)否(FALSE)显示最近更新的时间标记。

* 1 (true)

* 0(false)——默认值

hide_invisible

(布尔型)是否显示公开度为“不公开”的链接。是(TRUE)否(FALSE)遵循管理面板中的设置。

* 1 (true)——默认值

* 0(false)

echo

(布尔型)显示结果(TRUE),或将结果保留以供PHP使用(FALSE)。

* 1 (true)——默认值

* 0(false)

示例

简单的链接列表

显示所有链接,标题为“Bookmarks”,各链接项包围在<li>标签中,标题则用<h2>标签。

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

没有标题的简单列表

按上一个例子的条件显示所有链接,但不包括默认标题。

<?php wp_list_bookmarks(‘title_li=&categorize=0’); ?>

显示某个分类下的所有链接

显示ID为2的链接分类下的所有链接,使用链接图片,不显示链接说明,按URL排列链接。

<?php wp_list_bookmarks(‘categorize=0&category=2&before=<span>&after=</span>&show_images=1&

show_description=0&orderby=url’); ?>

分类: php 标签: 6,904 次阅读
原文链接:http://www.wenhq.com/article/view_646.html
欢迎转载,请注明出处:亲亲宝宝
  1. 2010年8月12日23:06 | #1

    太详细了
    不过我准备写个插件来处理
    链接关系

    [回复]

    admin 回复:

    @阳光网志, 写插件也是用wp_list_bookmarks方法,没这个灵活,插件多了不好管理,我现在是用这个函数改的模板,换了模板又得重改,各有利弊了。

    [回复]

  2. 2010年8月14日12:02 | #2

    有点复杂。

    [回复]

  3. 2010年8月14日21:03 | #3

    高深莫测啊
    慢慢学习

    [回复]

  4. 2010年8月16日23:45 | #4

    输出所有分类 随机排序

    [回复]

  5. 2010年12月4日15:04 | #5

    谢谢博主的分享,我会常来你这做客的,哈哈

    [回复]

  6. 2011年2月28日13:51 | #6

    怕升级WP,怕多用插件,特别 wp 2.x 到 3.x 或者以后的 大跨度的升级 …… 挺担心的 3.x 不就是改了标签……

    [回复]

  7. 2012年2月25日11:03 | #7

    写的很不错。网上搜了很多,都不怎么详细。捣鼓了好久,看了你才知道,还需要模板这么个东东。哎,看来俺对wp的了解和认识还差的太远太多啊!~谢你拉,有空再多写一些,帮帮想我们这些wp的小白们吧。呵呵!

    [回复]

  8. 2014年1月1日23:44 | #8

    学习学习,有点复杂的样子

    [回复]

  1. 本文目前尚无任何 trackbacks 和 pingbacks.