wordpress友情链接参数和函数详解

wordpress友情链接标签调用代码:<?php wp_list_bookmarks( $args ); ?>

默认情况下是如下写法:

<?php $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>' ); ?> 

默认情况下,友链标签显示如下内容:

  • 友链的标题为默认标题
  • 包含所有分类的链接
  • 按照链接名称排序
  • 如果包含图像,则显示之
  • 在图像和文字之间有空格
  • 显示链接的描述
  • 不显示链接分级
  • 显示所有的链接参数详解:

    categorize
    布尔型,用于设置连接是否按照各自的分类显示:
    1 (默认,根据链接的分类显示)
    0 (不按照分类,显示全部)
    category
    字符串型,后面就直接 “=链接分类ID号”,那么就显示这个分类下的链接。如果没有指定的话就显示所有的链接。
    category_name
    字符串型,如果后面 “=某个链接分类的名称” 那么就会在该链接分类前显示分类的名称,如果这里留空的话则会显示所有链接分类的分类名称(即默认的形式)。
    category_before
    字符串型,位于链接分类之前的文字或代码。默认的设置是:
    category_after
    字符串型,位于链接分类之后的文字或代码。默认的设置是:
    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 (不允许)

    举例:

    显示所有链接和有 <li>标签的链接,标题显示 <h2>标签。

    <?php wp_list_bookmarks('title_li=&category_before=&category_after='); ?>

    上述信息均来源于官方的说明文档,查看官方的友链参数详解。

0