最火下载站首页
手机版
最火下载站
关注公众号
最火下载站

当前位置:首页 > 网络知识 > Web前端 > 工具与技巧> wordpress博客wp_list_bookmarks

wordpress博客wp_list_bookmarks

文章作者:网友投稿 发布时间:2009-03-17 15:48:03 来源:网络

烈火建站网(LieHuo.Net)文章简介:wp_list_bookmarks 函数详解. Wp_list_bookmarks 函数详解。 Wordpress 2.1 版本启用了一个新函数来代替以前常用的 Blogroll 的两个函数 get_links_list() 和 get_links() ,这2个函

烈火建站学院(LieHuo.Net)文章简介:wp_list_bookmarks 函数详解.

wp_list_bookmarks 函数详解。

Wordpress 2.1 版本启用了一个新函数来代替以前常用的 Blogroll 的两个函数 get_links_list() 和 get_links() ,这2个函数可能会在以后的版本中被弃用,所以以后在调用 Blogroll 的时候最好用:

1
('arguments'); ?>

其实这个函数的用法和 wp_list_categories 基本相同,自定义的参数全部都写在了 “(’ ‘)” 里面,并且参数之间用 “&” 连接。
下面是这个函数的默认参数:

1
2
3
4
5
$defaults = array('orderby' => 'name', 'order' => 'ASC', 'limit' => -1, 'category' => '',
  'category_name' => '', 'hide_invisible' => 1, 'show_updated' => 0, 'echo' => 1,
  'categorize' => 1, 'title_li' => __('Bookmarks'), 'title_before' => '

', 'title_after' => '

'
, 'category_orderby' => 'name', 'category_order' => 'ASC', 'class' => 'linkcat', 'category_before' => '
  • ', 'category_after' => '
  • '
    );

    相关参数:

    categorize

    1. 布尔型,用于设置连接是否按照各自的分类显示: 1 (默认,根据链接的分类显示)
    2. 0 (不按照分类,显示全部)

    categorize
    字符串型,后面就直接 “=链接的分类ID号” ,那么就显示这个分类下的链接。如果没有指定的话就显示所有的链接。

    category_name
    字符串型,如果后面 “=某个链接分类的名称” 那么就会在该链接分类前显示分类的名称,如果这里留空的话则会显示所有链接分类的分类名称(即默认的形式)。(个人觉得这个参数不常用,一般不用管它)

    category_before
    字符串型,位于链接分类之前的文字或代码。默认的设置是:

    1
    
    <li id="[category id]" class="linkcat">

    category_after
    字符串型,位于链接分类之后的文字或代码。默认的设置是:

    </li>

    其实这上面2个属性就是用来定义每个连接分类的样式,可以理解成下面这种形式:

    1
    2
    3
    
    <li id="[category id]" class="linkcat">
    单个链接分类下的链接列表
    </li>

    class
    字符串型,每一个链接的分类都会有一个 “class” 属性(从上面的代码就能看出),默认是:linkcat

    category_orderby
    1. 字符串型,链接分类的排序方式,按照名词或者ID。 ‘name‘ (默认)
    2. ‘id‘

    category_order
    1. 字符串型,链接分类的升降序排列方式: ASC (默认)
    2. DESC

    title_li
    字符串型,链接标题的头文字或代码,默认是:Bookmarks,并且它控制连接是否按照列表的方式排列。

    title_before 和 title_after
    顾名思义,它们就是连接标题头前后的文字或代码,默认是 h2 标签

    上面这2组参数,实际定义的是 Blogroll 上面的头标题,即这个“ Blogroll 分类列表”上的类名。这些大的分类默认是被 li 标签套起来的,然后各个大分类下的链接列表则是套用在 ul 下的 li 进行排列。(是不是看不懂我在说什么?看不懂就跳过…)

    show_private
    1. 布尔型,是否显示私有链接。 1 (是)
    2. 0 (不是 - 默认)

    include
    字符串型,输出指定 ID 的 Blogroll 的分类链接,各个 ID 之间用半角的 “,” 分开。默认显示所有的 Blogroll 分类。

    exclude
    字符串型,将指定 ID 的 Blogroll 分类链接从整个链接列表中排除,各个 ID 之间用半角的 “,” 分开。默认是什么都不排除。#p#副标题#e#

    orderby
    字符串型,

    orderby
    1. 字符串型,Blogroll 的排列方式(默认是根据名称排序,除非将这个值留空),即根据我们在 WP 后台链接设置界面下的那些参数来进行排序: ‘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
    1. 字符串型,设置升降序的排列方式 ASC (默认)
    2. DESC

    limit
    整型,设置输出链接条数的最大值。默认值是“-1”,输出全部。

    before 和 after
    字符串型,Blogroll 里每一条连接前面和后面的文字或代码,默认是 li 标签。

    category_before 和 category_after
    字符串型,各个 Blogroll 分类前后的文字或代码,默认也是 li 标签。

    between
    字符串型,每个连接、图片和描述之间的文字或代码,默认是 “\n” 换行。

    show_images
    1. 布尔型,是否允许显示 Blogroll 下链接的对应图片。 1 (允许 - 默认)
    2. 0 (不允许)

    show_description
    1. 布尔型,是否允许显示每个链接的描述。 1 (允许)
    2. 0 (不允许 - 默认)

    show_rating
    1. 布尔型,是否允许显示链接的等级。 1 (允许)
    2. 0 (不允许 - 默认)

    show_updated
    1. 布尔型,是否允许显示最近更新后的时间戳。 1 (允许)
    2. 0 (不允许 - 默认)

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

    echo
    1. 布尔型,是否允许显示连接 or return them for use by PHP(怎么翻译?!) (FALSE)。默认允许。 1 (允许 - 默认)
    2. 0 (不允许)

    下面是几个例子:
    最简单的 Blogroll 列表:
    显示所有链接,Blogroll 的标题为 h2 标签下的 “Bookmarks”,链接套在 li 标签内

    1
    
    ('title_li=&category_before=&category_after='); ?>

    显示根据 URL 排序的,指定分类的链接:
    显示链接分类为2的 Blogroll ,并给每个连接一个 span 的属性,显示连接图片,不显示描述,根据 url 进行排序。

    1
    
    ('categorize=0&category=2&before=&after=&show_images=1&show_description=0&orderby=url'); ?>

    显示分级和时间戳:
    显示所有链接,描述另起一行,不显示图片,根据链接的 ID 排序,并显示链接分级和最近更新的时间戳。

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

    在了解了 wp_list_bookmarks 函数后,会不会觉得新建一个丰富的“友情链接”的页面也是一件很容易的事情了呢?

    上一篇: 给Wordpress首页的每篇日志添加图片

    下一篇: 网页设计理论:注意力、到流的起因和结果

    共有0条评论网友评论
    游戏排行榜