• wordpress CMS主题:ssmay主题wordpress CMS主题:ssmay主题
  • 首页 > wordpress主题常用函数 > wordpress常用函数详解12:wp_list_bookmarks()

    wordpress常用函数详解12:wp_list_bookmarks()

    作者: 分类:wordpress主题常用函数 点击: 2,710 次
    wordpress CMS主题:ssmay主题

      wp_list_bookmarks()函数用来显示博客的友情链接,即显示管理面板>链接菜单中的所有链接。wp_list_bookmarks()函数可以通过各种参数来控制友情链接显示的数量、种类以及样式等。wp_list_bookmarks()函数完全取代了已弃用标签get_links_list()与get_links()。

      wp_list_bookmarks()函数语法结构

      wp_list_bookmarks('title_li=&categorize=0&orderby=rand&include=41,40,37,54');

      wp_list_bookmarks()函数参数的意思:

      • categorize:(布尔型)是否所有链接都显示在分类目录下。1 (true) ,0(false)。
      • category:(字符串)将要显示的链接分类目录的ID,用逗号隔开。如果没有指定分类,显示所有含有链接的链接分类。
      • exclude_category:(字符串)将被排除的链接分类目录的ID,用逗号隔开。默认值为 (no categories excluded) (不排除任 何链接分类)。
      • category_name:(字符串)将要显示的链接所属分类的名称。如果没有指定分类,显示所有含有链接的链接分类。默认值为 (all Categories) (所 有链接)。
      • category_before:(字符串)放置在每个链接分类目录前的文本。默认值为'<li id="[category id]" class="linkcat">'。
      • category_after:(字符串)放置在链接分类目录后的文本。默认值为'<'/li>'。
      • category_orderby:(字符串)用以排列链接分类的值。有效值包括:'name' (默认值)、'id'、'slug'、'count'。
      • category_order:(字符串)排列的顺序,以升序或降序排列category_orderby参数值。有效值包括:ASC 默认值、DESC。
      • title_li:(字符串)链接列表的标题。默认值为 '__('Bookmarks')',显示标题为“Bookmarks”(the_(' ')用于本地化。)只有将categorize设为0(false)时,才可使用该参数(否则将使用分类名称)。若将title_li设为空(0),则不显示列表标题,且链接列表不会被 <ul>, </ul>标签围绕(要确保将categorize选项设为0,以使title_li生效)。
      • title_before:(字符串)'categorize'值为1(true)时显示在每个链接类别前的文本,或'categorize'值为0(false)时在 'title_li'中定义的文本。 默认值为'<h2>'。
      • title_after:'categorize'值为1(true)时显示在每个链接类别后的文本,或'categorize'值为0(false)时在 'title_li'中定义的文本。 默认值为'</h2>'。
      • includ:(字符串)在结果中包含的数值型链接ID列表,各ID用逗号隔开。例如, 'include=1,3,6' 表示返回或响应ID为1、3、6的链接。如果使用include字符串,那么 category 、category_name 、exclude 参 数将被忽略。默认值为 (all Bookmarks) (所有链接)。
      • exclude:(字符串)将要被排除的链接的ID,各ID用逗号隔开。如 'exclude=4,12'表示不返回ID为4和12的链接。默认值为 (exclude nothing) (不排除任何链接)。
      • orderby:(字符串)以何顺序为链接排序。这可能是一份各个值的列表,各值由逗号隔开。默认值为'name',除非你传递' '(空)值给该参数,此时参数值为'id'。有效值包括:'id'、'url'、'name'默认值、'rand' 任意顺序显示。
      • order:(字符串)根据'orderby'参数中的设置为分类目录排序(升序或降序)。有效值包括:ASC 默认值、DESC。
      • limit:(整数)可以显示的最大链接数。默认值为-1(所有链接)。
      • before:(字符串)放置在链接前的文本。默认值为'<li>'。
      • after:(字符串)放置在链接后的文本。默认值为'</li>'。


      QQ二维码

    文章作者:高时银博客
    本文地址:http://wanlimm.com/77201403121429.html
    版权所有 © 转载时必须以链接形式注明作者和原始出处!

    上一篇:
    下一篇:
    wordpress CMS主题:ssmay主题

    或许你会感兴趣的文章:

    发表评论

    电子邮件地址不会被公开。 必填项已用*标注

    This site uses Akismet to reduce spam. Learn how your comment data is processed.