WordPress模板文件
模板术语
在处理WordPress主题时，术语“模板”以不同的方式使用：
- 模板文件存在于主题中，并表示网站的显示方式。
- 页面模板是仅 用来改变页面外观的模板。页面模板可以应用于单个页面、页面部分或一类页面。
- 模板标签是WordPress的内置功能，您可以在模板文件中使用它来检索和显示数据（例如
the_title()和the_content()）。 - 模板层次结构是WordPress根据所请求的内容来决定使用哪个主题模板文件的逻辑。
模板文件
WordPress主题由模板文件组成。它们是一些PHP文件，包含HTML、模板标签和PHP代码。
构建主题时，将使用模板文件来影响网站不同部分的布局和设计。例如，您将使用header.php模板创建页眉，或使用comments.php模板引入评论。
当有人访问您网站上的页面时，WordPress会根据请求来加载模板。模板文件显示的内容类型由模板文件关联的文章类型确定。模板层次描述了WordPress 将根据请求的类型加载哪个模板文件，以及模板是否存在于主题中。 然后，服务器解析模板中的PHP，并将HTML返回给访问者。
最关键的模板文件是index.php，如果在模板层次结构中找不到更具体的模板，那么所有请求最终都会被发送到这个模板上 。尽管主题仅需要一个 index.php模板，但通常主题包含许多模板，以便在不同的上下文中环境中显示不同的内容 。
模板片段
模板片段是用来包含在其他模版中的一种模板。模板片段可以嵌入多个模板中，从而简化主题创建。常见的模板部分包括：
header.php用于生成网站的页眉footer.php用于生成页脚sidebar.php用于生成侧边栏
尽管以上模板文件仅适用于页面的一部分，但是您可以创建任意数量的模板片段，并将其包括在其他模板文件中。
常用WordPress模板文件
以下是WordPress可以识别的一些主题模板和文件列表。
- index.php：主模板文件，所有主题都需要这个文件。
- style.css：主样式文件，包含主题的信息，所有主题都需要这个文件。
- rtl.css：从右向左阅读的样式文件，如果站点语言是从右向左阅读的，主题会自动包含此文件。
- comments.php：主题评论模板文件。
- front-page.php：首页模板文件，无论阅读设置中的首页设置为什么总是，优先选择此文件模板作为首页模板文件。
- home.php：如果阅读设置中设置为静态页面，选择此文件作为首页模板文件。
- header.php：网站页头模板文件，通常包含您网站的文档类型、元信息、样式表、脚本链接以及其他数据。
- singular.php：单页面模板，未找到 single.php 或 page.php 时，使用此文件作为这些文章类型的单页面模板文件。
- single.php：「文章」的详情页模板文件。
- single-{post-type}.php：「post-type」文章类型的详情页模板文件。
- archive-{post-type}.php：「post-type」文章类型的存档页模板文件。
- page.php：「页面」文章类型的详情页模板文件。
- page-{slug}.php：别名为「slug」的页面详情页模板文件。
- category.php：分类目录存档模板文件。
- tag.php：标签存档模板文件。
- taxonomy.php：自定义分类法存档模板文件。
- author.php：作者存档页模板文件。
- date.php：日期存档页模板文件。
- archive.php：默认存档页默模板文件。
- search.php：搜索结果页模板文件。
- attachment.php：单个附件页面模板文件。
- image.php：图像页面模板文件。
- 404.php：页面找不到时，显示的 404 错误页面模板文件。
使用模板文件
在WordPress模板中，您可以使用模板标签动态显示信息，包括其他模板文件或以其他方式自定义您的网站。
例如，您可以在 index.php 中包含其他文件：
- 要包含页眉，请使用get_header()
- 要包含侧边栏，请使用get_sidebar()
- 要包含页脚，请使用get_footer()
- 要包含搜索表单，请使用get_search_form()
- 要包含自定义主题文件，请使用get_template_part()
这是一个WordPress模板标签示例，可将特定模板包含到您的页面中：
|
1 2 3 |
<?php get_sidebar(); ?> <?php get_template_part( 'featured-content' ); ?> <?php get_footer(); ?> |
您可以在“ 模板标签”上找到所有内容，以了解所有相关信息。
有关模板包含的更多信息，请参考主题文件和目录部分。
主要样式表（style.css）
style.css是每个WordPress主题所需的样式表文件。它控制网站页面的呈现（视觉设计和布局）。
位置
为了使WordPress将主题模板文件集识别为有效主题，style.css文件必须位于主题的根目录中，而不是子目录中。
有关如何在主题中包含style.css文件的更多详细说明，请参见“ 使脚本和样式入队”中的“样式表”部分。
基本结构
WordPress使用style.css的头部注释部分在外观（主题）仪表板面板中显示有关主题的信息。
示例
这是style.css头部的示例。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
/* Theme Name: Twenty Seventeen Theme URI: https://wordpress.org/themes/twentyseventeen/ Author: the WordPress team Author URI: https://wordpress.org/ Description: Twenty Seventeen brings your site to life with immersive featured images and subtle animations. With a focus on business sites, it features multiple sections on the front page as well as widgets, navigation and social menus, a logo, and more. Personalize its asymmetrical grid with a custom color scheme and showcase your multimedia content with post formats. Our default theme for 2017 works great in many languages, for any abilities, and on any device. Version: 1.0 License: GNU General Public License v2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Text Domain: twentyseventeen Tags: one-column, two-columns, right-sidebar, flexible-header, accessibility-ready, custom-colors, custom-header, custom-menu, custom-logo, editor-style, featured-images, footer-widgets, post-formats, rtl-language-support, sticky-post, theme-options, threaded-comments, translation-ready This theme, like WordPress, is licensed under the GPL. Use it to make something cool, have fun, and share what you've learned with others. */ |
WordPress主题库使用此文件中“
Version”之后的数字来确定主题是否有可用的新版本。
- Theme Name (*): 主体名称
- Theme URI: 主题介绍信息所在的网址， 用户可以在其中找到有关主题的更多信息
- Author (*): 制作主题的个人或组织的名称。建议使用主题作者在wordpress.org注册的用户名
- Author URI: 制作者的网址
- Description (*): 主题简介
- Version (*): 主题版本，格式为 X.X 或 X.X.X
- License (*): 主题授权许可
- License URI (*): 主题授权许可的网址
- Text Domain (*): 用于翻译的 文本域 字符串
- Tags: 允许用户使用标签过滤器查找主题的单词或短语。标签的完整列表在“ 主题审查手册” 中。
- Domain Path: 用于启用主题后，WordPress可以在哪里找到翻译。默认为
/languages
其中，带星号（*）的项目是WordPress主题库中要求的。
在所需的头部之后，style.css可以包含常规CSS样式代码。
子主题的 Style.css
如果你的主题是个子主题，则style.css头部必须包含 Template 行 。
|
1 2 3 4 |
/* Theme Name: My Child Theme Template: Twenty Seventeen */ |
有关创建子主题的更多信息，请访问“子主题”页面。
from:https://www.wpdaxue.com/docs/theme-handbook/basics/template-files