友情链接(wp_list_bookmarks())函数用法详解

转载 2013年11月10日 15:07:40

该标签显示管理面板>链接菜单中的所有链接。该标签允许用户更改链接的排列顺序和显示方式。如:优搜网

注意:wp_list_bookmarks()取代了已弃用标签get_links_list()与get_links()。

用法

<?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
  • 按名称排列链接列表
  • 如果有图片,包含图片
  • 图片和链接文本间应有空格
  • 显示链接的描述
  • 不显示链接等级
  • 无限制,显示所有链接
  • 显示所有链接

参数

categorize

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

  • 1 (true)——默认值
  • 0(false)

category

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

exclude_category

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

category_name

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

category_before

(字符串)放置在每个链接分类目录前的文本。默认值为'<li id="[category id]" class="linkcat">'。

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字符串,那么categorycategory_nameexclude参数将被忽略。默认值为(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'); ?>

显示链接等级和时间标记

以数字编号列表形式显示所有链接,各链接下另起一行填写链接说明,不适用链接图片,按ID排列链接,显示链接等级和最新更新的时间。

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

用图片取代标题

从主题目录中选择一个图片代替普通文本作为链接列表标题。

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

历史记录

  • 始见于WordPress 2.1.0版本
  • WP 2.2.0 版本新增class参数
  • WP 2.7.0 版本新增link_before、link_after与show_name参数

源文件

wp_list_bookmarks()位于 wp-includes/bookmark-template.php

wp_list_bookmarks友情链接函数详解

在帮tianti.org做友情链接模块不显示图片的时候在网上搜索,找到了这片文章,很不错,转载作为资料。 最后用的分类不显示图片的代码是: 这个函数又是比较强大的一个WP标签。wp_l...
  • cloudday
  • cloudday
  • 2012年07月23日 16:32
  • 379

友情链接函数wp_list_bookmarks()全析

友情链接函数wp_list_bookmarks()全析 2010年7月2日发表评论阅读评论 友情链接 互惠互利 随着我的精心照顾,不得言博客终于得到了不断...
  • dengwenquan2011
  • dengwenquan2011
  • 2011年10月27日 19:44
  • 601

WordPress友情链接函数wp_list_bookmarks调用

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

DIV+CSS实操二:经管系网页添加导航栏和友情链接栏

接着DIV+CSS实操一:经管系网页总体模块布局这篇博客继续,实现添加导航栏和友情链接栏,导航栏的下拉 菜单我们后续会加上。          先来HTML代码: 经管系 Dream...
  • erlian1992
  • erlian1992
  • 2015年11月20日 12:55
  • 2748

DEDE5.7友情链接分类调用代码

DEDE5.7友情链接分类调用代码 2012-09-04   DEDEcms的友情链接标签flink用于获取友情链接,其对应后台文件为"includetaglibflink.lib.php"...
  • forest_fire
  • forest_fire
  • 2016年03月21日 10:51
  • 875

下拉菜单select友情链接自动跳转做法

转载自:http://www.bhcode.net/article/20100803/12676.html 当页,直接跳转: Java代码    BHCODE   素材网  ...
  • kalision
  • kalision
  • 2015年06月29日 12:32
  • 3393

wordpress不用友情链接插件添加友情链接

一般情况下小松不喜欢使用wordpress插件,插件多了网站速度更不上,我的主题没有添加外链的功能,下面使用现有的功能添加一个友情链接的板块出来 首先在后台找到小工具中的文件,下面提示可以添加任意文本...
  • a454213722
  • a454213722
  • 2016年02月04日 12:00
  • 4416

友情链接常用代码

友情链接 西安市   咸阳市   安康市
  • u011518709
  • u011518709
  • 2014年04月18日 11:07
  • 2739

织梦调用友情链接的调用及样式,文件位置为:\\include\\taglib\\flink.lib.php

织梦调用友情链接的文件位置为:\include\taglib\flink.lib.php 调用标签为:{dede:flink titlelen='24=' row='20' type='text'} ...
  • forest_fire
  • forest_fire
  • 2016年03月21日 10:54
  • 1836

在新版CSDN博客添加友情链接

自从CSDN博客改版之后,很多功能都消失了。。。。我以前没用过CSDN,满心欢喜的来到这,期待着漂亮的皮肤,顺畅的操作、飞一般的速度。可是事实恰恰相反。。。。。       言归正传,简单说一下怎么...
  • yangyuankp
  • yangyuankp
  • 2011年10月06日 16:31
  • 1259
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:友情链接(wp_list_bookmarks())函数用法详解
举报原因:
原因补充:

(最多只允许输入30个字)