模板标签-wp_list_bookmarks()

说明

该标签显示管理面板>链接菜单中的所有链接。该标签允许用户更改链接的排列顺序和显示方式。

注意:wp_list_bookmarks()取代了已弃用标签get_links_list()与get_links()。

用法

<?phpwp_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
  • 按名称排列链接列表
  • 如果有图片,包含图片
  • 图片和链接文本间应有空格
  • 显示链接的描述
  • 不显示链接等级
  • 无限制,显示所有链接
  • 显示所有链接

参数

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'。(该参数引入于WP 2.2

category_orderby

(字符串)用以排列链接分类的值。有效值包括:

  • 'name' ——默认值
  • 'id'
  • 'slug'
  • 'count'
  • 'term_group' (不再使用)

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字符串,那么 categorycategory_nameexclude参数将被忽略。默认值为 (all Bookmarks)(所有链接)。

exclude

(字符串)将要被排除的链接的ID,各ID用逗号隔开。如 'exclude=4,12'表示不返回ID为4和12的链接。默认值为 (exclude nothing)(不排除任何链接)。

orderby

(字符串)以何顺序为链接排序。这可能是一份各个值的列表,各值由逗号隔开。默认值为'name',除非你传递' '(空)值给该参数,此时参数值为'id'。有效值包括:

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

(字符串)超链接代码中链接文本前的文字。无默认值。(该参数引入于WP 2.7

link_after

(字符串)超链接代码中链接文本后的文字。无默认值。(该参数引入于WP 2.7

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时。(该参数引入于WP 2.7

  • 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)

示例

简单的链接列表

显示所有链接,标题为“Bookmarks”,各链接项包围在<li>标签中,标题则用<h2>标签。

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

没有标题的简单列表

按上一个例子的条件显示所有链接,但不包括默认标题。

<?php wp_list_bookmarks('title_li=&categorize=0');?>

显示某个分类下的所有链接

显示ID为2的链接分类下的所有链接,使用链接图片,不显示链接说明,按URL排列链接。

<?php wp_list_bookmarks('categorize=0&category=2&before=<span>&after=</span>&show_images=1&show_description=0&orderby=url');?>

显示链接等级和时间标记

以数字编号列表形式显示所有链接,各链接下另起一行填写链接说明,不适用链接图片,按ID排列链接,显示链接等级和最新更新的时间。

<ol>  <?php wp_list_bookmarks('between=<br />&show_images=0&orderby=id&show_rating=1&show_updated=1');?>  </ol>

用图片取代标题

从主题目录中选择一个图片代替普通文本作为链接列表标题。

<?php wp_list_bookmarks('categorize=0&title_li=<img src="'.get_bloginfo "stylesheet_directory").'/images/blogroll.gif" alt="blogroll" />');?>  

历史记录

  • 始见于WordPress 2.1.0版本
  • WP 2.2.0 版本新增class参数
  • WP 2.7.0 版本新增link_before、link_after与show_name参数

源文件

wp_list_bookmarks()位于 wp-includes/bookmark-template.php

人吐槽 人点赞

猜你喜欢

  • 欧盟重罚谷歌背后 两种互联网行业惯例受挑战(图)
  • 中国游客不听劝阻意大利景区吃冰淇淋 或被公诉(图)
  • 他用镜头剥下无数女孩衣服 被奉为摄影大师(组图)
  • 10亿张银行卡可免密刷3000 银行、银联不告诉你(图)
  • Iptables防火墙
  • 一文彻底解决Ubuntu上PHP的安装以及版本切换
  • 01_搭建Linux虚拟机(下)_我的Linux之路
  • 在Ubuntu 16.04上安装Nginx
  • CentOS下安装RabbitMQ教程
  • centOs6.5配置jdk及其注意事项
  • linux目录及文件命令学习
  • 腾讯云服务器 ubuntu 设置允许root用户登录
  • Nginx-场景实践篇
  • CentOS 7命令行安装图形界面(GNOME、KDE等)
  • redhat 6.8 x64升级OpenSSH到OpenSSH_7.7p1
  • Linux下磁盘分区和挂载
  • centos7初上手1-安装mysql数据库
  • centos7 安装拼音输入法
  • Linux用户和权限管理
  • JavaSE ImageIO编写的验证码在linux上的tomcat显示不出来的问题解决
  • SSH内网穿透——linux穿linux、windows穿linux
  • Linux部署Apache ActiveMQ 5.14.1
  • Linux如何去设置TC参数
  • linux+Rabbitmq安装
  • VMware Linux虚拟主机双路由的一种配置方式
  • 在linux下安装配置rabbitMQ详细教程
  • Linux学习填坑 修改SSH默认端口及禁用ROOT账户
  • Linux学习填坑 修改SSH默认端口及禁用ROOT账户
  • linux Apache服务管理
  • linux SCP命令
  • linux-ubuntu使用shadowsocks客户端配置
  • 【Linux】虚拟机和Linux操作系统零基础安装(附:软件下载链接、图)
  • 老男孩Linux高端运维课程-linux系统文件权限体系实战讲解
  • linux系统启动流程及Grub2018-5-20
  • Linux学习笔记如何发布一个简单网站一服务器多路由设置(二)
  • Linux信号基础
  • linux下安装vsftpd
  • Linux常用基本命令:三剑客命令之-awk输入输出分隔符
  • linux上maven+nexus创建个人的私人仓库
  • linux服务器修改ftp默认21端口方法
  • Linux 内核升级步骤
  • linux SELinux介绍
  • Linux学习笔记之ACL
  • Linux Python3安装部署和pip安装
  • linux搭建SVN服务器
  • 关于linux make时出现错误 /bin/sh: 1: Syntax error: "(" unexpected
  • 轻松一刻,Linux 娱乐命令整理
  • 关于linux‘RedHat6.9在VMware虚拟机中的安装步骤
  • linux ./a.sh 命令 与sh a.sh的区别是什么
  • 在服务器高并发情况下,有关linux内核的优化
  • 基于linux下的apache服务
  • redis如何在Linux上安装,以及怎么在window上连接Linux的服务一:在虚拟机上输入命令:wget http://download.redis.io/releases/redis-2.8.
  • Linux--环境配置,基本设置
  • CentOS 7 上安装vim(默认未安装)
  • Linux 访问 Dell IDRAC7 vnc [备忘]
  • linux下安装fastdfs
  • linux系统http服务器部署
  • wslconfig设置默认linux子系统。
  • Linux/Centos Mondo 一键部署、镜像恢复,快速部署
  • linux上面是否有安装redis,redis启动
  • linux6.7下搭建jumpserver开源堡垒机
  • Linux---使用命令行接口配置firewalld的管理
  • 集群10-linux下nginx编译安装
  • 集群10-linux下nginx编译安装
  • Linux--Apache服务命
  • Apache的安装与AWstats分析系统
  • Docker CE部署
  • 【Linux】多块Nvidia显卡之间切换默认显卡
  • centos 7 linux系统默认ftp安装配置和部署(详细讲解)【转载】
  • Linux IntelliJ IDEA 2018 版本 SVN配置
  • Linux日常运维管理技巧(二)
  • centos 7 linux系统默认ftp安装配置和部署(详细讲解)【转载】
  • linux,ubuntu,redhat安装JDK
  • 单机版Mongodb在Linux下的安装和启动
  • Linux_firewalld服务
  • Linux下通用打印系统CUPS使用教程
  • SIGPIPE信号--解决Linux socket中接收端退出导致发送端send退出问题
  • Linux安装redis
  • Linux SIGINT捕获
  • Linux SIGUSR1和SIGUSR2 捕获
  • 杨泽业:linux远程桌面连接软件xshell和ftp软件xftp安装图文教程
  • 【Linux环境搭建】——Centos7下安装配置单机版RabbitMQ
  • linux上运行php目录不可写问题
  • Hadoop2.7.6_06_mapreduce参数优化
  • Linux 的安装
  • Linux引用自定义的动态链接库
  • Linux学习之SELinux
  • linux禁用IPv6
  • Liquibase的简单使用
  • 第一个:Linux系统性能优化
  • linux crontab定时任务
  • 修改CentOS默认yum源为国内yum镜像源
  • linux shell 中的 2>&1 用法说明
  • Supervisor安装与配置(Linux/Unix进程管理工具)
  • 如何彻底解决MySQL更改默认字符集以及字符乱码问题!!!
  • Linux学习-权限管理之ACL权限04
  • nginx的403 Forbidden解决的办法(权限文件和文件不存在、SElinux 开启)
  • mysql之全球化和本地化:字符集、校对集、中文编码问题
  • Centos 7安装MYSQL
  • pythonlinux配置环境变量
  • MySQL多实例的环境下,服务器端本地连接到指定实例的问题(sock方式连接)
  • Linux文件服务器实战(匿名用户)
  • MySQL test数据库的权限
  • MySQL写入用户微信名
  • MySQL新参数log_error_verbosity
  • mysql-8.0.11-winx64.zip安装教程
  • mysql/mariadb学习过程中出现的问题与解决
  • linux文件和目录管理
  • Linux学习-文件系统常用命令
  • Mysql-数据类型
  • MySql 5.7.21免安装版本win10下的配置
  • Linux系统救援模式应用:单用户模式找回密码
  • mysql、oracle默认事务隔离级别
  • mysql、oracle默认事务隔离级别
  • navicate 12 连接 mysql8.0 使用日志
  • mysql压缩包配置遇到的一系列问题
  • Linux系统 Centos6 安装
  • 杨泽业:linux远程桌面连接软件xshell和ftp软件xftp安装图文教程
  • Linux下iptables安全配置
  • linux环境上anaconda的安装与卸载
  • linux 之查找指令 locate模糊查找;数据库查找;find 精确查找;实时较慢的查找
  • python3向Mysql插入中文数据
  • MySql Engine
  • linux centos yum mysql5.7
  • hibernate 5 与 mysql 5.4 以上 版本的 坑
  • linux安装及网卡设置
  • MySQL企业常见架构与调优经验分享
  • Linux:用户权限管理
  • MySQL 安装、登陆及卸载
  • MYSQL自定义函数
  • Mysql5.7.22-win64安装体会
  • ZooKeeper系列(4):ZooKeeper的日志和快照
  • Linux 中yum的配置
  • ZooKeeper系列(3):ZooKeeper的配置文件详解
  • Linux安装ftp组件
  • Linux从0到1:安装Linux操作系统
  • Linux:用户管理几个重要的命令
  • Linux:Centos7 升级内核
  • linux c http下载文件
  • linux使用FIO测试磁盘的iops
  • Mysql 如何设置字段自动获取当前时间
  • Linux vsftpd的安装与配置
  • awk命令详解
  • linux目录细读
  • MySQL(二)
  • Centos7下Mysql5.7的安装
  • CentOS7 64位下MySQL5.7安装与配置(YUM)
  • MySQL的下载、配置
  • Linux(centos)连接云主机的PPTP(***)服务
  • Linux环境下添加Oracle的Scott用户
  • Linux 学习笔记-route
  • FTP的主动与被动模式,及linux服务端的配置
  • Linux head/tail命令详解
  • MySQL定位慢查询步骤
  • linux基础02
  • 如何卸载干净mysql
  • MySQL优化技术(二)
  • MySQL数据导入导出(一)
  • MySQL创建数据库时判断是否存在,mysql create database 指定utf-8编码
  • Win10 mysql8.0.11压缩包安装教程
  • Can't connect to local MySQL server through socket
  • Mysql5.7.20的下载与安装
  • python2.7安装mysql-python
  • CentOS7安装mysql5.7
  • 安装MySQL8.0.11
  • 将mysql的data目录独立分区
  • CentOS 7 LNMP 环境搭建(三、MySQL 安装)
  • 解决mysql连接10038和ftp出现timeout
  • MySQL的基本操作
  • CentOS7 64位下MySQL5.7安装与配置(YUM)
  • mysql建库建表约束
  • Mysql8.0 安装教程
  • MySQL
  • centos安装MySQL
  • CentOS 7.3 安装mysql 5.6版本数据库
  • Linux下非ROOT权限安装MySQL
  • ERROR 1148 (42000): The used command is not allowed with this MySQL version
  • 六项约束
  • 阿里云java+nginx_tomcat_mysql_jdk
  • 完成Ubuntu桌面版的Apache+php+mysql(手动配置LAMP)的全过程及实现细节
  • MySQL安装
  • CentOS 7.0 安装MySQL 5.7并修改初始密码
  • CentOS7 64位下MySQL5.7安装与配置(YUM)
  • CentOS7.4中安装了Mysql5.7之后如何查看默认密码
  • ubuntu 命令:sudo apt-get install mysql 安装mysql,修改密码总结
  • MYSQL8.0 windows X64 zip包安装教程
  • MySQL--排序检索数据
  • 《win10系统安装mysql8.0.11》
  • MySQL数据导入和导出
  • MySQL常用命令
  • Django连接Mysql数据库
  • MYSQL指令2:约束
  • mysql 事务处理
  • centos数据mysql和MariaDB的问题
  • Python3 pymysql读取中文数据时问号
  • MySQL-mysql 8.0.11安装教程
  • Linux安装Mysql8.0
  • windows下安装压缩版mysql
  • MySQL5.5安装步骤
  • centos7 安装mysql5.6
  • Centos 离线安装mysql 详细步骤
  • Mysql 如何设置字段自动获取当前时间
  • mysqldump的锁表的问题
  • mysql字符集(mysql学习笔记)
  • center os 6.5 安装mysql8
  • Ambari 安装配置 MySql
  • Ubuntu搭建lnmp:Nginx+Mysql5+Php7开发环境(非lnmp包安装)
  • Mysql 如何设置字段自动获取当前时间
  • centos7下mysql5.7的安装
  • mysql-8.0.11-winx64.zip安装教程
  • 网站、mysql、ftp、ssh、https 默认端口号
  • win10下MySQL8.0.11安装
  • CentOS7 64位下MySQL5.7安装与配置(YUM)
  • mysql 开发基础系列2
  • Win10安装mysql-8.0.11-winx64详细步骤
  • Mysql8.0.11安装以及注意事项
  • linux下mysql 查看默认端口号与修改端口号方法
  • centos7安装mysql
  • 关于mysql安装时出现的问题《错误1067:进程意外终止》的解决方法
  • Mysql远程连接报错:authentication plugin caching_sha2
  • yum安装mysql-5.7及以上版本
  • mysql5.7.22 初始化密码 Access denied for user 'root'@'localhost' (using password: YES
  • MySQL-mysql 8.0.11安装教程
  • Xshell连接mysql数据库乱码问题解决思路总结
  • Linux(CentOS 7)环境下安装MySQL
  • mysql 开发基础系列9 存储引擎 MyISAM 介绍
  • 在命令行下,Mysql显示各个端所使用的字符集命令
  • mysql 开发基础系列8 表的存储引擎
  • ckeditor + ckfinder + oss存储
  • ckeditor + ckfinder + oss存储
  • [日常] nginx反代websocket
  • mac下nginx搭配php-fpm解析php文件
  • 11.14/11.15 Apache和PHP结合 11.16/11.17 Apache默认虚拟主机
  • php.ini设置文件上传大小限制
  • thinkphp5.0 路由学习(一)
  • PHP发送邮件功能
  • ThinlPHP5之控制器
  • php form表单post提交获取不到数据,而使用get提交能获取到数据 的解决办法
  • php date_default_timezone_set!时区设置
  • [扩展推荐] Laravel 中利用 GeoIP 获取用户地理位置信息
  • PHP时区设置,PHP时间问题
  • phpstorm配置使用svn
  • PhpStorm更换主题
  • php preg_match_all 字符长度限制
  • PHP 毫秒级时间戳生成
  • 织梦默认编辑器换成kindEditor实操教程
  • php-fpm的配置和优化
  • xml方式封装数据方法
  • Thinkphp5中异常处理不返回页面返回Json格式的字符串
  • PHP创建的csv文件在windows上乱码的问题
  • PHP入门学习——WAMP Server
  • PHP常用功能组件方法---代码块
  • Apache2.4+PHP5.6配置教程和问题Apache服务无法启动以及php配置文件不生效等的解决
  • phpstorm自动上传配置
  • 多级分类展示PHP递归
  • centos+flask+uwsgi+nginx 的搭建
  • 详解nginx的基本配置及nginx.conf文件配置示例
  • 利用同一Nginx服务器对来自不同的域名请求转发到不同的服务器集群处理
  • 腾讯云centos7 环境搭建(2)nginx安装
  • Ubuntu 安装Nginx
  • nginx指令
  • LNMP架构(2)Nginx安装,默认虚拟主机,Nginx用户认证,Nginx域名重定向
  • centos6+ 将程序 注册到 service进行启动 停止 重启等:以nginx为例,添加nginx脚本
  • centos6+ 将程序 注册到 service进行启动 停止 重启等:以nginx为例,添加nginx脚本
  • 更改nginx服务器404返回页面
  • CentOS7安装nginx(二)配置https
  • nginx.conf 配置文件解释
  • 通过HTTP服务访问FTP服务器文件(配置nginx+ftp服务器)
  • CentOS中使用yum安装nginx
  • Nginx 安装{{1034}}
  • [Nginx] – 性能优化 – 配置文件优化 [一]
  • Nginx安装与优化
  • Nginx的安装与部署
  • Nginx 设置已经解析的域名,在nginx中没有定义相应server时的默认访问
  • vue打包后放在 nginx部署时候的配置文件
  • 使用nginx后如何在web应用中获取用户ip及原理解释
  • nginx 配置
  • 服务器搭建nginx
  • yum安装Nginx
  • nginx使用记录
  • 常用函数-get_categories()
  • 常用函数-get_pages()
  • 常用函数-get_terms()
  • 常用函数-validate_current_theme()
  • 模板标签-wp_list_pages()
  • 常用函数-get_bookmarks()
  • 模板标签-comment_reply_link()
  • 模板标签-posts_nav_link()
  • 模板标签-get_bookmarks()
  • 模板标签-previous_comments_link()
  • 模板标签-next_comments_link()
  • 模板标签-next_image_link()
  • 模板标签-the_content_rss()
  • 模板标签-wp_dropdown_pages()
  • 模板标签-wp_get_archives()
  • 模板标签之如何传递模板标签参数
  • 模板标签-wp_link_pages()
  • Gravatar头像
  • WordPress管理面板菜单介绍之:设置>撰写
  • WordPress屏幕截图
  • 模板标签-wp logout url
  • 5个夜店厕所的激战体位 最火辣诱惑让他先射在裤子里
  • [已解决]帝国CMS搜索结果界面在哪里修改tempid
  • 帝国cms自定义页面模板添加函数自动获取当前自定义页面链接地址
  • 水墨印象V1.0 文通博客WordPress主题发布
  • 发表评论

    用户名: 密码:
    验证码: 匿名发表

    你可以使用这些语言

    查看评论:模板标签-wp_list_bookmarks()