WordPress 友情链接调用标签wp_list_bookmarks

WordPress教程 9793

现在的大多WordPress 博客的友情链接调用标签使用的是<?php get_links_list(); ?>，其实还有一个友情链接调用函数，而且与之相比参数更多，扩展性更强，博客吧的友情链接使用的调用函数便是它，本篇博客吧将介绍该调用函数及其相关参

函数用法：
1

<?php wp_list_bookmarks( $args ); ?>
函数参数：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

<?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>' ); 
?>
友情链接调用标签：
  • categorize
    布尔型，设置友情链接是否以分类的方式显示：
    1 （默认，根据链接的分类显示）
    0 （不按照分类，显示全部）
  • category
    字符串型，显示指定ID链接分类下的链接，后面就直接 “=链接分类ID号”，那么就显示这个分类下的链接，如果没有指定的话就显示所有的链接，多个分类ID用英文逗号隔开。
  • exclude_category

    字符串型，排除指定ID链接分类目录的链接，多个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 的链接，各个 ID 之间用半角的 “,” 分开。默认显示所有的 Blogroll 分类。
  • exclude
    字符串型，排除指定 ID 的链接，各个 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_name
    布尔型，是否允许显示 Blogroll 下链接的对应名称。如果show_images为1时，则不显示，2.7版本开始支持的。
    1 (允许)
    0 (不允许-默认)
  • show_images
    布尔型，是否允许显示 Blogroll 下链接的对应图片。
    1 (允许 – 默认)
    0 (不允许)
  • show_description
    布尔型，是否允许显示每个链接的描述。
    1 (允许)
    0 (不允许 – 默认)
  • show_rating
    布尔型，是否允许显示链接的等级。
    1 (允许)
    0 (不允许 – 默认)
  • show_updated
    布尔型，是否允许显示最近更新后的时间戳。
    1 (允许)
    0 (不允许 – 默认)
  • hide_invisible
    布尔型，是否显示所有的链接，甚至是被管理员设为不可见的链接，默认允许显示。
    1 (允许 – 默认)
    0 (不允许)

博客吧当前友情链接调用标签实例演示：

1

<?php wp_list_bookmarks('show_description=1&title_li=&categorize=0&category=67'); ?>

该调用代码显示链接的描述，不按照分类目录显示，显示链接分类ID为67下的友情链接。

提醒：每一个参数结束到下一个参数开始的中间要用&符号。

精品推荐：