WordPress函数:wp_list_bookmarks()友情链接
在主题制作中,wp_list_bookmarks是比较常用的WordPress函数,在主题中调用友情链接的时候,通常都要用到。下面就对这个WordPress友情链接函数wp_list_bookmarks()做一下详细的介绍。
注:wp_list_bookmarks()已经取代了之前的老函数get_links_list() 和 get_links()。
wp_list_bookmarks()基本用法
<?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>' ); ?>
默认情况下(没有添加任何参数)的用法:
链接被划分为不同类别,每个类别有一个名称
包含所有链接,无论是链接的分类名称还是ID
按名称排列链接列表
如果有图片,包含图片
图片和链接文本间应有空格
显示链接的描述
不显示链接等级
无限制,显示所有链接
显示所有链接
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>’。
class
(字符串)链接分类列表所在类。默认值为’linkcat’。
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>’。
show_private
(布尔型)是否应显示某个链接分类(即使该分类被认为是私密的)。忽略管理面板的设置,显示私密链接分类(TRUE),或者不显示私密链接分类(FALSE)。
1 (true)
0(false)——默认值
include
(字符串)在结果中包含的数值型链接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’ (WP 3.2 及以后版本使用 ‘link_id’ )
‘url’
‘name’ ——默认值
‘target’
‘description’
‘owner’ —— 通过连接管理器添加链接的用户
‘rating’
‘updated’
‘rel’ —— 链接关系(XFN)
‘notes’
‘rss’
‘length’ —— 链接名称的长度,范围从最短的名称到最长的名称
‘rand’ —— 以任意顺序显示链接
order
(字符串)根据’orderby’参数中的设置为分类目录排序(升序或降序)。有效值包括:
ASC ——默认值
DESC
limit
(整数)可以显示的最大链接数。默认值为-1(所有链接)。
before
(字符串)放置在链接前的文本。默认值为'<li>’。
after
(字符串)放置在链接后的文本。默认值为'</li>’。
link_before
(字符串)超链接代码中链接文本前的文字。无默认值。
link_after
(字符串)超链接代码中链接文本后的文字。无默认值。
between
(字符串)链接/图片与其说明之间的文本。默认值为’n’(换行)。
show_images
(布尔型)是(TRUE)否(FALSE)显示链接的图片
1 (true)——默认值
0(false)
show_description
(布尔型)是(TRUE)否(FALSE)显示链接说明。该参数用于show_images为FALSE时或未定义链接图片时。
1 (true)
0(false)——默认值
show_name
(布尔型)显示链接文本(TRUE)。该参数用于show_images为TRUE时。
1 (true)
0(false)——默认值
show_rating
(字符串)是(TRUE)否(FALSE)显示链接的级别。
1 (true)
0(false)——默认值
show_updated
(布尔型)是(TRUE)否(FALSE)显示最近更新的时间标记。
1 (true)
0(false)——默认值
hide_invisible
(布尔型)是否显示公开度为“不公开”的链接。是(TRUE)否(FALSE)遵循管理面板中的设置。
1 (true)——默认值
0(false)
echo
(布尔型)显示结果(TRUE),或将结果保留以供PHP使用(FALSE)。
1 (true)——默认值
0(false)
wp_list_bookmarks()使用示例
简单的链接列表
显示所有链接,标题为“Bookmarks”,各链接项包围在<li>标签中,标题则用< h2 >标签。
<?php wp_list_bookmarks('title_li=&category_before=&category_after='); ?>
没有标题的简单列表
按上一个例子的条件显示所有链接,但不包括默认标题。
<?php wp_list_bookmarks('title_li=&categorize=0'); ?>
去掉UL LI 的纯链接列表
before=&after=& 设置为空即可。
<?php wp_list_bookmarks('before=&after=&title_li=&categorize=0&category=21&limit=24'); ?>
显示某个分类下的所有链接
显示ID为2的链接分类下的所有链接,使用链接图片,不显示链接说明,按URL排列链接。
<?php wp_list_bookmarks('categorize=0&category=2&before=<span>&after=</span>&show_images=1&show_description=0&orderby=url'); ?>
显示链接等级和时间标记
以数字编号列表形式显示所有链接,各链接下另起一行填写链接说明,不适用链接图片,按ID排列链接,显示链接等级和最新更新的时间。
<?php wp_list_bookmarks('between=<br />&show_images=0&orderby=id&show_rating=1&show_updated=1'); ?>
用图片取代标题
从主题目录中选择一个图片代替普通文本作为链接列表标题。
<?php wp_list_bookmarks('categorize=0&title_before=&title_after=&title_li=<img src="'.get_bloginfo(<span class="st0">"stylesheet_directory").'/images/blogroll.gif" alt="blogroll" />'); ?>
小结:
1.总的来说,要用好wp_list_bookmarks()函数,需要自己熟练掌握参数的用法,重要的是多多实践。
WordPress函数:wp_list_bookmarks()友情链接相关推荐
- php插入友情链接,PHP_详解WordPress中添加友情链接的方法,友情链接对于一个每个独立博 - phpStudy...
详解WordPress中添加友情链接的方法 友情链接对于一个每个独立博客来说可以说是必须的,有不少人选择在侧边栏加入友情链接栏目,但建立一个独立的友情链接页面也是一个不错的选择.用插件可以轻松做到这一 ...
- 详解WordPress中添加友情链接的方法
详解WordPress中添加友情链接的方法 友情链接对于一个每个独立博客来说可以说是必须的,有不少人选择在侧边栏加入友情链接栏目,但建立一个独立的友情链接页面也是一个不错的选择.用插件可以轻松做到这一 ...
- WordPress如何添加友情链接教程
做网站的朋友们,大多都会需要设置友情链接. 如何简单快速的添加友情链接? 确保后台菜单中有[链接]选项 WordPress默认是隐藏了后台菜单的[链接]选项的. 要显示它也非常简单,只需要在funct ...
- 升级WordPress后开启友情链接管理模块
3.5版本取消了链接管理,随着WordPress3.5 Beat1 发布的还有一款插件:Link Manager,这款插件可以重新激活链接管理.只需激活插件,之前熟悉的链接管理就又回来了. 下载解压后 ...
- WordPress制作圆形头像友情链接页面的方法
网上看见过很多种友情链接页面,我比较喜欢的是圆形头像的这种,先看看效果吧:传送门 就是这种上面是圆形的友链用户头像,下面是友链用户网站名,然后鼠标移上去头像会旋转,怎么实现这种效果呢?我在网上找了很多 ...
- wordpress友联_WordPress如何添加友情链接
WordPress从3.5版本开始后台将不再显示链接管理的功能,那么我要添加友情链接如何搞?提供以下两种方法供参考. 第一种代码法(推荐使用),只需要将以下代码添加到主题functions.php文件 ...
- WordPress调用自带的友情链接功能_只在首页显示
很多wordpress主题都会调用wordpress自带的友情链接功能,然后就可以在侧边栏小工具增加友情链接的模块:但是有些主题就没有带,比如我自己用的这款主题就没有,需要自行调用函数. 1.调用友情 ...
- wordpress友联_Wordpress进阶:个性化友情链接调用
有些时候,我们并不想要某个友情链接在全站页面都体现,而是想实现类似的效果:只在首页显示一部分的友链,然后其它的都体现在"友情链接页面",而普通的文章页和列表页之类则是不再显示. 实 ...
- wordpress友联_Wordpress 友情链接页面终极版 – Fatesinger
之前写过一篇带头像的友情链接页面,当时有朋友说怎么能支持分类,我让他仿照以前不带头像的旧方法修改下,以前旧方法是用SQL语句获取的分类,其实完全可以通过Wordpress 自带的函数来实现,原因你懂的 ...
最新文章
- 2022-2028年中国重油行业市场研究及前瞻分析报告
- 教你在Linux中如何归档和备份
- 境外 java 中文乱码_Java前后端交互中文出现乱码??
- gdb调试时查看内存
- mysql的innodb表生成的物理文件_MySQL innodb表使用表空间物理文件复制或迁移表
- linux操作系统之线程
- absolute和relative元素 设置百分比宽高的差异
- mysql 5.6 没死_MySQL 5.6不删空用户的影响
- dm数据库 linux版下载,linux环境搭建DM数据库
- Html代码打包后如何修改,html代码打包封装成APP教程
- and or not 优先级_我的家乡|我的侠客公测成就奖励大全 成就解锁优先级排名
- ros清华源_ROS操作系统学习(一)ROS安装
- .Net FW上线报错:The OwinStartup attribute discovered in assembly ‘AppName‘.
- [ZT]第14节:粮食战争(14)--我的评论:中国农业的必经之路?
- 凸包(Convex Hull)问题算法详解
- k8s使用的iptables,具体原理是什么?一学就会
- android 仿微信朋友圈发布动态功能
- 14.Adaptive AUTOSAR 架构-身份及访问管理(IAM)
- 关于自学编程,这些秒办法助你一臂之力(全文干货,建议收藏)
- java判断麻将听牌_和牌看听:麻将听牌种类大全
热门文章
- 红队版goby-poc,包含447个自定义goby-poc
- 30岁男销售、富士康员工,转行程序员,后来怎么样了?
- 传说中80后最牛的辞职信
- 阿里云centos 7 apache 配置虚拟站点
- Cannot find module ‘webpack-cli/bin/config-yargs 热更新失败
- sharding+druid 读写分离
- 树莓派串口2挂ESP32C3(推荐)
- office自动化,报错 ‘win32com.gen_py....‘ has no attribute ‘CLSIDToClassMap‘
- 不起眼的邀请有礼活动:为什么有这么多APP使用?如何完善这一方法?
- 初识MySQL(新手入门)