主题中使用模板标签来从数据库中检索内容。 内容可以是从博客标题到完整侧边栏的任何内容。 模板标签是将内容拉入主题的首选方法,因为:
- 他们可以打印动态内容;
- 它们可以用于多个主题文件; 和
- 他们将主题分为更小,更易理解的部分。
## 什么是模板标签?
模板标签只是一段代码,可以让WordPress从数据库中获取一些内容。 它分为三个组成部分:
- 一个PHP代码标签
- WordPress函数
- 可选参数
您可以使用模板标签来调用另一个主题文件或数据库中的某些信息。
例如,模板标签get_header()告诉WordPress获取header.php文件并将其包含在当前主题文件中。 同样,get_footer()告诉WordPress获取footer.php文件。
还有其他种类的模板标签:
- the_title() - 告诉WordPress从数据库中获取页面或帖子的标题,并将其包含。
- bloginfo('name') - 告诉WordPress将博客标题从数据库中取出并将其包含在模板文件中。
如果仔细观察最后一个例子,您还将看到括号之间有一个参数。 参数可以让你做两件事情:
要求具体的信息和
以某种方式格式化信息。
下面广泛的介绍了这些参数,但是请注意,您可以发送WordPress特定的说明,了解您希望显示数据的方式。
## 为什么要使用模板标签
通过封装特定内容块的所有代码,模板标签使得在主题文件中包含模板的各种部分以及维护主题非常容易。
创建一个header.php文件并拥有所有的主题模板,如single.php,page.php,front-page.php等,引用一个使用get_header()的主题文件比复制和粘贴代码更容易 进入每个主题文件。 它也使维护更容易。 每当您在header.php文件中进行更改时,更改将自动转移到所有其他主题文件中。
使用模板标签的另一个原因是显示动态数据,即来自数据库的数据。 在标题中,您可以手动添加标题标签,如下所示:
```
<title>My Personal Website<title>
```
但是,这样做意味着您随时要更改网站的标题时手动编辑主题。 相反,更容易地包含bloginfo('name')模板标签,该标签自动从数据库中提取站点标题。 现在,您可以在WordPress中更改您的网站的标题,而不必对主题模板进行硬编码。
## 如何使用模板标签
使用模板标签非常简单。 在任何模板文件中,您可以通过简单地打印一行php代码来调用模板标签来使用模板标签。 打印header.php文件很简单:
```
get_header();
```
## 参数
一些模板标签可以让您传递参数。 参数是确定从数据库检索到的内容的额外信息。
例如,bloginfo()模板标签允许你给它一个参数,告诉WordPress你想要的具体的信息。 要打印博客名称,您只需传递参数“name”,如下所示:
```
bloginfo( 'name' );
```
要打印博客正在运行的WordPress版本,您将传递一个参数“version”:
```
bloginfo( 'version' );
```
对于每个模板标签,参数不同。 可以在代码引用的特定模板标签页上找到参数列表以及可以做的工作。
## 在循环中使用模板标签
许多模板标签在WordPress循环中工作。 这意味着它们被包含在模板文件中,作为php“循环”的一部分,它根据循环内的指令生成用户看到的页面。
WordPress循环以:
```
if ( have_posts() ) :
while ( have_posts() ) :
the_post();
```
在循环中工作的模板标签必须位于以下循环结束部分之前的中间区域:
```
endwhile;
else :
_e( 'Sorry, no posts matched your criteria.', 'devhub' );
endif;
```
需要在循环内部的一些模板标签包括
- the_content()
- the_excerpt()
- next_post()
- previous_post()
某些功能需要循环的主要原因是因为它们需要设置全局后置对象。
如果要使用的模板标签不必在循环中
- wp_list_cats()
- wp_list_pages()
那么你可以把它放在你想要的任何文件中,例如在边栏,页眉或页脚模板文件中。
这些是通常不需要全局后置对象的函数。
## 附件
- [条件标签](themes/conditional-tags.md)
- [完整的模板标签列表](themes/list-of-template-tags.md)
- 简介
- 主题开发
- WordPress许可证
- 什么是主题
- 开发环境
- 主题开发示例
- 主题基础
- 模板文件
- 主样式表(style.css)
- 文章类型
- 规划主题文件
- 模板层级
- 模板标签
- 循环
- 主题函数
- 连接主题文件和目录
- 使用CSS和JavaScript
- 条件标签
- 类别,标签和自定义分类
- 模板文件
- 内容模板文件
- 页面模板文件
- 附件模板文件
- 自定义内容类型
- 部分和其他模板文件
- 评论模板
- 分类模板
- 404页面
- 主题功能
- 核心支持的功能
- 管理菜单
- 自定义Headers
- 自定义Logo
- 文章格式
- 置顶文章
- Sidebars
- Widgets
- 导航菜单
- 分页
- 媒体
- Audio
- Images
- Galleries
- Video
- 精选图片和缩略图
- 国际化
- 本地化
- 辅助功能
- 主题选项 – 自定义API
- 定制对象
- 改进用户体验的工具
- 定制JavaScript API
- JavaScript / Underscore.js渲染的自定义控件
- 高级用法
- 主题安全
- 数据消毒/逃避
- 数据验证
- 使用随机数
- 常见漏洞
- 高级主题
- 子主题
- UI最佳实践
- JavaScript最佳做法
- 主题单元测试
- 验证你的主题
- Plugin API Hooks
- 发布你的主题
- 所需的主题文件
- 测试
- 主题评论指南
- 写文档
- 提交你的主题到WordPress.org
- 参考文献
- 模板标签列表
- 条件标签列表
- 编码标准
- HTML编码标准
- CSS编码标准
- JavaScript编码标准
- PHP编码标准
- 插件开发
- 插件开发简介
- 什么是插件
- 插件基础
- 头部要求
- 包括软件许可证
- 启用 / 停用 Hooks
- 卸载方法
- 最佳做法
- 插件安全
- 检查用户功能
- 数据验证
- 保护输入
- 保护输出
- 随机数
- Hooks
- Actions
- Filters
- 自定义Hooks
- 高级主题
- 管理菜单
- 顶级菜单
- 子菜单
- 短代码
- 基本短码
- 封闭短码
- 带参数的短代码
- TinyMCE增强型短码
- 设置
- 设置API
- 使用设置API
- 选项API
- 自定义设置页面
- 元数据
- 管理帖子元数据
- 自定义元数据
- 渲染元数据
- 自定义文章类型
- 注册自定义文章类型
- 使用自定义文章类型
- 分类
- 使用自定义分类
- 在WP 4.2+中使用“split术语”
- 用户
- 创建和管理用户
- 使用用户元数据
- 角色和功能
- HTTP API
- JavaScript
- jQuery
- Ajax
- 服务器端PHP和入队
- Heartbeat API
- 概要
- 计划任务
- 了解WP-Cron计划
- 安排WP-Cron 事件
- 将WP-Cron挂接到系统任务计划程序中
- WP-Cron简单测试
- 国际化
- 本地化
- 如何国际化您的插件
- 国际化安全
- WordPress.org
- 详细插件指南
- 规划您的插件
- 如何使用Subversion
- 插件开发者常见问题
- 开发工具
- Debug Bar 和附加组件
- 辅助插件
- REST API手册
- 资源
- 文章
- 文章修订
- 文章类型
- 文章状态
- 类别
- 标签
- 页面
- 评论
- 分类
- 媒体
- 用户
- 设置
- 使用REST API
- 全局参数
- 分页
- 链接和嵌入
- 发现
- 认证
- 经常问的问题
- 骨干JavaScript客户端
- 客户端库
- 扩展REST API
- 添加自定义端点
- 自定义内容类型
- 修改回应
- 模式
- 词汇表
- 路由和端点
- 控制器类