wp_list_bookmarks 显示友情链接

评论(1)

wp_list_bookmarksWordPress 中用来显示友情链接的一个函数,本文主要讲解该函数的参数设置和使用。目前大部分主题都用 wp_list_bookmarks 这个函数来显示友情链接,而目前一些中文的文档不管是翻译还是讲解的都不是很合本人的胃口,所以打算将之重新整理一翻。

wp_list_bookmarks函数的作用

用来按照使用者的意图,来显示友情链接的一个函数。

wp_list_bookmarks 参数

 
$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>'
    );
 
wp_list_bookmarks($args);

参数详解

如果你对 WordPress 的常规参数命名不慎了解的话,
那么你可以继续往下看。
另外下面显示的都是参数的默认值,
也就是说没有特别要求的话,你可以不用设置这些参数,
只需要明确标出你需要改动的即可,其他的可以不用写。

        //按啥排序 
        'orderby' => 'name', 
        //升序、降序
        'order' => 'ASC',
        //输出多少条
        'limit' => -1, 
        //指定分类id
        'category' => '', 
        //排除分类id
        'exclude_category' => '',
        //指定要显示的分类名,貌似不好用版本3.4.1
        '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',
        //分类的css中的class值
        'class' => 'linkcat', 
        //分类前html代码%id和%class是系统默认占位符
        'category_before' => '<li id="%id" class="%class">',
        //分类后HTML代码
        'category_after' => '</li>'

wp函数中一般都有两种参数赋值方式,一种是数组形式的,另一种是字符串形式的,
因为结构清晰便于复用,所以我一般喜欢用数组形式来给参数赋值,
这样不但看起来省事,实际上也少一步php解析字符串的过程。

使用实例

下面贡献一段我自己主题的代码

<?php  wp_list_bookmarks(array(
        'orderby' => 'rand',//随机排序
        'category' => '2',//显示的分类ID
        'title_before' => '<div id="linkstitle">',
        'title_after' => '</div>',
        'category_before' => '',
        'category_after' => '',
    )); 
?>

总结

啥东西都经不起研究,所以 wordpress 里的函数基本上都是一通百通的,
所以想要玩透其实也没有那么麻烦,最重要的是要一步一步来,不要太消极。
近期工作调整,但是电脑还没到位,估计过几天电脑也就到位了,
再等上上网络,估计怎么也得8月底了吧,
到时候可要好好利用网络好好学习啊。哈哈。

手里压得东西已经不少了,答应做的东西还有两个没开始涅,哎。
另外严重鄙视伦敦奥运的裁判。尼玛这些人不会都是中超跳槽的那些裁判吧。

另另外,一些朋友麻烦你转载文章尊重一下我的心血,是不是稍稍的留个链接?





转载请注明转自: wp_list_bookmarks 显示友情链接

  1. Pingback: wp_list_categories|函数-WordPress