WordPress友情链接 wp_list_bookmarks函数详解只保留li

网站应用 - 三月 3, 2012 - 来源:单点日志 - No Comments -

WordPress友情链接调用的方法有很多,wp在升级过程中不段变化,因此存在不少函数可以使用,在后续wp提供了参数设计更多的 wp_list_bookmarks函数,参数太多,配合使用功能很多。个人希望只要保留li标签就可以,在wp官方举例中就有范例代码

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

Simple List without the Heading
Displays all bookmarks as above, but does not include the default heading.呵呵,上面语句就只有li标签了。


wp_list_bookmarks 函数中文说明,比以前的函数 get_links_list() 和 get_links() 更加强大,它有很多参数,参数和参数之前用”&”分隔。原版英文请参阅wordpress官网。

wp_list_bookmarks 函数的默认参数是:

‘orderby’ => ‘name’

‘order’ => ‘ASC’

‘limit’ => -1

‘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号”,那么就显示这个分类下的链接。如果没有指定的话就显示所有的链接。
category_name

字符串型,如果后面 “=某个链接分类的名称” 那么就会在该链接分类前显示分类的名称,如果这里留空的话则会显示所有链接分类的分类名称(即默认的形式)。
category_before

字符串型,位于链接分类之前的文字或代码。默认的设置是:<li id=”[category id]” class=”linkcat”>
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 的 Blogroll 的分类链接,各个 ID 之间用半角的 “,” 分开。默认显示所有的 Blogroll 分类。
exclude

字符串型,将指定 ID 的 Blogroll 分类链接从整个链接列表中排除,各个 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_images

布尔型,是否允许显示 Blogroll 下链接的对应图片。

1 (允许 – 默认)

0 (不允许)
show_description

布尔型,是否允许显示每个链接的描述。

1 (允许)

0 (不允许 – 默认)
show_rating

布尔型,是否允许显示链接的等级。

1 (允许)

0 (不允许 – 默认)
show_updated

布尔型,是否允许显示最近更新后的时间戳。

1 (允许)

0 (不允许 – 默认)
hide_invisible

布尔型,是否显示所有的链接,甚至是被管理员设为不可见的链接,默认允许显示。

1 (允许 – 默认)

0 (不允许)
例如:
随机显示10条链接:

<?php wp_list_bookmarks(‘orderby=rand&limit=10′); ?>
随机显示分类ID为1的链接:

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



无觅相关文章插件,快速提升流量

《WordPress友情链接 wp_list_bookmarks函数详解只保留li》由单点日志原创提供!
转载请注明:http://spoint.babyshoot.cn/archives/2012/03/wordpress-wp-li.html

No Comments│赶紧发话! »

发表评论

您必须登录后才能发表评论。
8