WordPress主题开发教程手册 — 主题基础
在第一章中,我们了解了什么是主题,以及如何开始开发主题。
在本章中,我们将开始学习如何正确地开发主题,我们将把主题拆分开,从各个方面学习怎么开发一个主题。首先,我们将通过模版文件和文章类型来了解主题的的组成部分 。然后,我们将学习如何在主题中保持文件的整齐有序。
除此之外,我们还将学习模版循环,该功能负责将内容从 WordPress 数据库中提取出来。
最后,我们将通过使用主题功能( 包含 CSS 和 JavaScript) ,利用 条件函数仅显示我们需要的内容,以及使用默认分类法和自定义分类法来了解怎么为主题添加功能的更多信息 。
组织模版文件
虽然WordPress主题在技术上只需要两个文件( index.php
和 style.css
),但它们通常由更多模版文件组成。这意味着他们很快就会变得杂乱无章!本节将向您展示如何把主题的模版文件整理得井井有条。
主题文件夹和文件结构
如前所述,默认的 Twenty 主题是经过良好组织好开发的最佳示例。例如在 Twenty Seventeen 主题中,模版文件的组织方式如下:
assets (dir) - css (dir) - images (dir) - js (dir) inc (dir) template-parts (dir) - footer (dir) - header (dir) - navigation (dir) - page (dir) - post (dir) 404.php archive.php comments.php footer.php front-page.php functions.php header.php index.php page.php README.txt rtl.css screenshot.png search.php searchform.php sidebar.php single.php style.css
我们可以看到,模板文件位于根目录中,而 JavaScript,CSS,图像放在 assets目录中,模板片段放在对应的子目录中,在主题中使用的核心功能放在 inc 目录中。
目前,在WordPress主题中没有必需的文件夹 。但是,默认情况下,WordPress会识别以下文件夹。
style.css
应该位于主题的根目录中,而不是 CSS 目录中。语言文件夹
为了让使用其他语言的用户可以使用我们的主题,将主题国际化是WordPress主题开发工作的一项最佳实践,其他贡献者可以将主题翻译成其他语言,让更多用户无障碍使用。默认主题包含一个languages
文件夹,其中有一个用于翻译的 .pot 文件和已翻译好的的 .mo 文件。虽然 languages
是此文件夹的默认名称,但是如果需要,我们可以使用 load_theme_textdomain() 修改这个文件夹的名称。