WordPress主题开发教程手册 — 模板文件

模板术语

在WordPress主题中,术语「模版」以几种不同方式使用:

  • 模板文件存在于主题中,表示您的网站的显示方式。
  • 页面模板在单页面中使用,用来更改某个页面的外观,可以应用于某个页面或文章。
  • 模板标签是 WordPress 的内置功能,我们可以使用模版标签来获取和显示数据(例如 the_title(),the_content() )。 
  • 模板层次结构是 WordPress 用于确定使用哪个主题模板文件的逻辑,具体取决于所请求的内容。

WordPress主题由模板文件组成,这些模板文件是包含 HTML,模板标签和 PHP代码的 PHP 文件 。

模版文件

构建主题时,我们使用模板文件来实现网站各个部分的布局和设计。例如,我们可以使用 header.php模板设计网站页头,使用 comments.php模板来设计文章评论。

用户访问我们网站中的某个页面时,WordPress 会根据用户访问的页面加载模板。模板文件显示的内容由与模板文件相关的文章类型确定。模板层次结构描述了WordPress 将根据请求的类型加载哪个模板文件,以及模板是否存在于主题中。 然后,服务器解析模板中的 PHP 并将生成的 HTML 内容返回给访问者。

最关键的模板文件是 index.php ,如果在模板层次结构中找不到更具体的模板,那么所有请求最终都会被发送到这个模板上。虽然只有 index.php 模板就可以工作,但是主题通常会包含一些其他模板,以便在不同的上下文中环境中显示不同的内容。

模板片段

模版片段是用来包含在其他模版中的一种模版,例如 header.php。模板片段可以嵌入到多个模板中,从而简化了主题开发。常见的模板片段有:

  • header.php: 用于显示网站页头
  • footer.php:用于显示网站页脚
  • sidebar.php:用于显示网站侧边栏

虽然模版片段只是模版的一部分,但是我们可以创建任意数量的模板片段,并将其包含在其他模板文件中。

常见的 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中,我们可以包含其他文件:

下面是使用模版函数在一个模版中包含其他模版片段的示例:

<?php get_sidebar(); ?>
<?php get_template_part( 'featured-content' ); ?>
<?php get_footer(); ?>

更多有关模版标签的信息,我们可以在模板标签章节找到。

有关包含模版片段的更多信息, 请参阅模版文件包含章节。

主样式文件

style.css 是每个WordPress主题所必需的样式表(CSS)文件。它控制网站页面的外观(视觉设计和布局)。

文件位置

为了方便 WordPress 高效的识别主题,style.css 文件需要位于主题的根目录中,而不是子目录中。

有关如何在主题中包含 style.css 文件的更详细说明,请参阅包含 CSS 和 JavaScript 文件的「样式表」部分 。

基本结构

WordPress 使用 style.css 的头注释部分在外观(主题)仪表板面板中显示有关主题的信息。

示例

这是 style.css 的文件头注释的示例。

/*
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主题仓库使用此文件中“版本”之后的数字来确定主题是否有可用的新版本。
  • Theme Name(*):主题名称 。
  • Theme URI :主题介绍 URL,用户可以在其中找到有关主题的更多信息。
  • Author(*):开发主题的个人或组织的名称,建议使用主题作者的wordpress.org 用户名。
  • Author URI :创作个人或组织的 URL。
  • Description (*):主题的简短描述。
  • Version (*):版本,以 XX 或 XXX 格式编写。
  • Licence (*):主题的许可证。
  • Licence URI (*):主题许可证的 URL。
  • Text Domain (*):用于 textdomain 的字符串转换。
  • Tags:允许用户使用标签过滤器查找主题的单词或短语,完整的标签列表位于 主题评审手册中 
  • Domain Path:用来在主题被禁用时,指定在何处查找翻译,默认为 /languages 

在必需的标题部分之后,style.css 可以包含常规 CSS 文件所具有的任何内容。

子主题的 Style.css

如果您的主题是子主题,则需要在 style.css 的头注释中添加 Template 信息。

/*
Theme Name: My Child Theme
Template: Twenty Seventeen
*/

有关创建子主题的更多信息,请访问子主题页面。

本站提供 WordPress主题定制开发服务

本站长期承接 WordPress主题、插件、基于 WooCommerce 的商店商城开发业务。 我们有 8 年WordPress开发经验,如果你想 用WordPress开发网站, 请联系 QQ: 470266798,或邮箱: 4626395@gmail.com 咨询。

发表评论

您的电子邮箱地址不会被公开。 必填项已用*标注

*