WordPress友情链接函数wp_list_bookmarks使用方法举例详解

调用方法

  1. <h3>友情链接:</h3>
  2. <ul><?php wp_list_bookmarks($args); ?></ul>

默认参数

  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>' ); 
  20. ?>

orderby 字符串型,Blogroll 的排列方式(默认是根据名称排序,除非将这个值留空)
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 (不允许)

应用举例

1、调用当前的友情链接

  1. <?php wp_list_bookmarks(); ?>

2、随机显示10条链接:

  1. <?php wp_list_bookmarks('orderby=rand&limit=10'); ?>

3、显示所有链接,但不包括默认标题(去掉“书签”这个标题)

  1. <?php wp_list_bookmarks('title_li=&categorize=0'); ?>

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

  1. <?php wp_list_bookmarks('title_li=&category_before=&category_after='); ?>

5、显示所有链接,但不包括默认标题。

  1. <?php wp_list_bookmarks('title_li=&categorize=0'); ?>

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

  1. <?php wp_list_bookmarks('categorize=0&category=2&before=<span>&after=</span>&show_images=1&show_description=0&orderby=url'); ?>

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

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

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

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

小结

1、wp_list_bookmarks函数的用法和wp_list_categories极为类似 。

2、参数太多,使用灵活,但未必是你想要的,阅读以下 wpdb和get_results读取数据库打造个性友情链接教程

3、官方原文 https://codex.wordpress.org/Function_Reference/wp_list_bookmarks


发布日期:

所属分类: WordPress 函数 标签:  


没有相关文章!