## 链接到核心主题文件
正如你所学到的,WordPress主题是从许多不同的模板文件构建的。 至少这通常会包含一个sidebar.php,header.php和footer.php。 这些被称为使用模板标签,例如:
- get_header();
- get_footer();
- get_sidebar();
您可以通过命名文件sidebar-{your_custom_template} .php,header-{your_custom_template} .php和footer-{your_custom_template} .php来创建这些文件的自定义版本。 然后,您可以使用模板标签与自定义模板名称作为唯一的参数,如下所示:
- get_header( 'your_custom_template' );
- get_footer( 'your_custom_template' );
- get_sidebar( 'your_custom_template' );
WordPress通过组合各种文件创建页面。 除了标题,页脚和侧边栏的标准文件外,您可以创建自定义模板文件,并使用get_template_part()在页面中的任何位置调用它们。 要在主题中创建自定义模板文件,请为文件提供适当的名称,并使用与标题,侧边栏和页脚文件相同的自定义模板系统:
```
slug-template.php
```
例如,如果要创建自定义模板来处理您的帖子内容,您可以创建一个名为content.php的模板文件,然后通过将文件名扩展为content-product.php来为产品内容添加特定的内容布局。 然后,您将在主题中加载此模板文件,如下所示:
```
get_template_part( 'content', 'product' );
```
如果您想添加更多的组织到您的模板,您可以将它们放置在您的主题目录中的自己的目录中。 例如,假设您为配置文件和位置添加了一些更多的内容模板,并将它们分组在其名为content-templates的目录中。
称为my-theme的主题的主题层次结构可能如下所示。 style.css和page.php都包含在上下文中。
- themes
- my-theme
- content-templates
- content-location.php
- content-product.php
- content-profile.php
- style.css
要包括您的内容模板,请将目录名称添加到slug参数中,如下所示:
```
get_template_part( 'content-templates/content', 'location' );
get_template_part( 'content-templates/content', 'product' );
get_template_part( 'content-templates/content', 'profile' );
```
## 链接到主题目录
要链接到主题的目录,您可以使用以下功能:
```
get_theme_file_uri();
```
If you are not using a child theme, this function will return the full URI to your theme’s main folder. You can use this to reference sub-folders and files in your theme like this:
```
echo get_theme_file_uri( 'images/logo.png' );
```
如果您使用的是一个子主题,那么该函数将返回您的子主题中的文件的URI(如果存在)。 如果您的子主题中找不到文件,该函数将返回父主题中的文件的URI。 在分发主题或其他情况下,儿童主题可能活动或可能不活跃时,这一点特别重要。
要访问主题目录中文件的路径,可以使用以下功能:
```
get_theme_file_path();
```
像get_theme_file_uri()一样,如果子主题存在,它将访问该文件的路径。 如果在子主题中找不到文件,该函数将访问父主题中文件的路径。
在子主题中,您可以使用以下功能链接到父主题目录中的文件URI或路径:
- get_parent_theme_file_uri();
- get_parent_theme_file_path();
与get_theme_file_uri()一样,您可以参考这样的子文件夹和文件:
```
echo get_parent_theme_file_uri( 'images/logo.png' );
//or
echo get_parent_theme_file_path( 'images/logo.png' );
```
引用可能不存在的文件时要小心,因为这些函数将返回URI或文件路径,无论文件是否存在。 如果文件丢失,这些功能将返回一个断开的链接。
>[warning] 注意:在WordPress 4.7中引入了函数get_theme_file_uri(),get_theme_file_path(),get_parent_theme_file_uri(),get_parent_theme_file_path()。
对于以前的WordPress版本,请使用get_template_directory_uri(),get_template_directory(),get_stylesheet_directory_uri(),get_stylesheet_directory()。
>[warning] 请注意,较新的4.7函数作为检查过程的一部分运行较旧的功能,因此在可能时使用较新的功能是有意义的。
## 模板中的动态链接
无论您的永久链接设置如何,您可以通过参考其唯一的数字ID(在管理界面的几个页面中)动态链接到页面或发布页面
```
<a href="<?php echo get_permalink($ID); ?>">This is a link</a>
```
这是创建页面菜单的便捷方式,因为您可以稍后更改页面段,而不会中断链接,因为ID将保持不变。 但是,这可能会增加数据库查询。
- 简介
- 主题开发
- 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
- 添加自定义端点
- 自定义内容类型
- 修改回应
- 模式
- 词汇表
- 路由和端点
- 控制器类