当前位置:首页 WordPress 正文

WordPress:wp_list_bookmarks 友情链接函数说明

2012年07月13日 | 作者: 米豆网 - 1000seo | 分类: WordPress | 

用于显示在后台链接里添加的所有连接,这个模板Tag允许用控制友情链接的显示和排序;

在较早的WordPress中用 get_links 函数实现友情链接,目前这个函数已经被新函数取代了,那就是:wp_list_bookmarks。该函数的特点是只有一个参数,但功能超级强大,这归因于它有众多的可选参数.

注意: wp_list_bookmarks() 替代了旧版里 get_links_list()get_links()

用法

< ?php wp_list_bookmarks( $args ); ?>

参数

categorize
(布尔型) 用于设置连接是否按照各自的分类显示.

  • 1 (True) – 默认,根据链接的分类显示
  • 0 (False) – 不按照分类,显示全部
category
(字符串型)后面就直接 “=链接分类ID号”,那么就显示这个分类下的链接。如果没有指定的话就显示所有的链接。
exclude_category
(字符串型) 用于设置显示时被排除的链接类别,默认没有类别被排除.
category_name
(字符串型) 如果后面 “=某个链接分类的名称” 那么就会在该链接分类前显示分类的名称,如果这里留空的话则会显示所有链接分类的分类名称(即默认的形式)。
category_before
(字符串型) 位于链接分类之前的文字或代码。默认的设置是:<li id=”[category id]” class=”linkcat”>.
category_after
(字符串型) 位于链接分类之后的文字或代码。默认的设置是:</li>.
class
(字符串型) 每一个链接的分类都会有一个 “class” 属性,默认是:linkcat. (这个参数在Version 2.2被添加)
category_orderby
(字符串型) 链接分类的排序方式:

  • ‘name’- 默认
  • ‘id’
  • ‘slug’
  • ‘count’
  • ‘term_group’ (not used yet)
category_order
(字符串型) 链接分类的升降序排列方式:

  • ASC – 默认
  • DESC
title_li
(字符串型) 链接标题的头文字或代码,默认是:Bookmarks,并且它控制连接是否按照列表的方式排列。
title_before
(字符串型) 连接标题头前的文字或代码,默认是 <h2> 标签.
title_after
(字符串型) 连接标题头后的文字或代码,默认是 </h2> 标签.
show_private
(布尔型) 是否显示私有链接.

  • 1 (True)
  • 0 (False) – 默认
include
(字符串型) 输出指定 ID 的分类链接,各个 ID 之间用半角的 “,” 分开。默认显示所有的分类。
exclude
(字符串型) 将指定 ID 的分类链接从整个链接列表中排除,各个 ID 之间用半角的 “,” 分开。默认是什么都不排除。
orderby
(字符串型) 排序方式(默认是根据名称排序,除非将这个值留空),即根据我们在 WP 后台链接设置界面下的那些参数来进行排序:

  • id
  • url
  • name – 默认
  • target
  • description
  • owner
  • rating
  • updated
  • rel- 按设定的关系排列
  • notes
  • rss
  • length- 连接名称的长度设定
  • rand- 随机排列显示
order
(字符串型) 设置升降序的排列方式:

  • ASC- 默认
  • DESC
limit
(整型) 设置输出链接条数的最大值。默认值是”-1″,输出全部。
before
(字符串型) 每个链接前的文本默认<li>
after
(字符串型) 每个链接后的文本默认</li>
link_before
(字符串型) 在每个链接的文本前添加的文本,该文本位于链接内部,没有默认值. (这个参数在Version 2.7被添加)
link_after
(字符串型)在每个链接的文本后添加的文本,该文本位于链接内部,没有默认值. (这个参数在Version 2.7被添加)
between
(字符串型) 每个连接、图片和描述之间的文字或代码,默认是 “\n” 换行).
show_images
(布尔型) 是否允许显示链接的对应图片

  • 1 (True) – 默认
  • 0 (False)
show_description
(布尔型) 是否允许显示每个链接的描述。

  • 1(True)
  • 0 (False) – 默认
show_name
(布尔型) 显示链接文本当设置为TRUE时. 仅当 show_images设置为TRUE时. (这个参数在Version 2.7被添加)

  • 1 (True)
  • 0(False) – 默认
show_rating
(布尔型)) 是否允许显示链接的等级.

  • 1 (True)
  • 0 (False) – 默认
show_updated
(布尔型) 是否允许显示最近更新后的时间戳.

  • 1 (True)
  • 0(False) – 默认
hide_invisible
(布尔型)是否显示所有的链接,甚至是被管理员设为不可见的链接,默认允许显示.

  • 1(True) – 默认
  • 0 (False)
echo
(布尔型) 前台输出链接还是存入php变量供调用,默认为ture,前台输出.

  • 1(True) – 默认
  • 0 (False)

例如:

随机显示10条链接:

<?php wp_list_bookmarks(‘orderby=rand&limit=10′); ?>

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

<?php wp_list_bookmarks(‘orderby=rand&category=1′); ?>

本文章由 米豆网 - 1000seo 于2012年07月13日发布在WordPress分类下,您可以发表评论,并在保留原文地址及作者的情况下引用到你的网站或博客。
+复制链接 转载请注明:WordPress:wp_list_bookmarks 友情链接函数说明-米豆网
关键字:, , , ,

好文章就要一起分享!

更多

发表评论

你的大名(必填)

你的邮箱(必填)

你的网站(选填)

评论内容(必填)

icon_wink.gif icon_neutral.gif icon_mad.gif icon_twisted.gif icon_smile.gif icon_eek.gif icon_sad.gif icon_rolleyes.gif icon_razz.gif icon_redface.gif icon_surprised.gif icon_mrgreen.gif icon_lol.gif icon_idea.gif icon_biggrin.gif icon_evil.gif icon_cry.gif icon_cool.gif icon_arrow.gif icon_confused.gif icon_question.gif icon_exclaim.gif