wordpress CMS主题 微信
Home > wordpress主题常用函数 > wordpress常用函数详解12:wp_list_bookmarks()

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

高时银博客 wordpress主题常用函数 点击: 1,751 次 0 0

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>'。

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

目前还没有评论。赶快来坐沙发吧。

发表评论