现在的大多WordPress 博客的友情链接调用标签使用的是<?php get_links_list(); ?>,其实还有一个友情链接调用函数,而且与之相比参数更多,扩展性更强,博客吧的友情链接使用的调用函数便是它,本篇博客吧将介绍该blogroll调用函数及其相关参数<?php wp_list_bookmarks();?>
友情链接调用标签:
- categorize
布尔型,设置友情链接是否以分类的方式显示:
1 (默认,根据链接的分类显示)
0 (不按照分类,显示全部) - category
字符串型,后面就直接 “=链接分类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 的 Blogroll 的分类链接,各个 ID 之间用半角的 “,” 分开。默认显示所有的 Blogroll 分类。 - exclude
字符串型,将指定 ID 的 Blogroll 分类链接从整个链接列表中排除,各个 ID 之间用半角的 “,” 分开。默认是什么都不排除。 - orderby
字符串型,Blogroll 的排列方式(默认是根据名称排序,除非将这个值留空),即根据我们在 WP 后台链接设置界面下的那些参数来进行排序:- ‘id’
- ‘url’
- ‘name’
- ‘target’
- ‘description’
- ‘owner’
- ‘rating’
- ‘updated’
- ‘rel’ – 按设定的关系排列
- ‘notes’
- ‘rss’
- ‘length’ – 连接名称的长度设定
- ‘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 (不允许)
博客吧当前友情链接调用标签实例演示:
1 | <?php wp_list_bookmarks('show_description=1&title_li=&categorize=0&category=67'); ?> |
该调用代码显示链接的描述,不按照分类目录显示,显示链接分类ID为67下的友情链接。
提醒:每一个参数结束到下一个参数开始的中间要用&符号。
感谢:http://vl99.com/web/wordpress/wordpress-wplistbookmarks-links-label/收集并分享以上标签函数
» 转载请注明出处: 博客吧