模板文件

模板術(shù)語

在處理WordPress主題時(shí)，術(shù)語“模板”以不同的方式使用：

• 模板文件存在于主題中，并表示網(wǎng)站的顯示方式。
• 頁面模板是僅 用來改變頁面外觀的模板。頁面模板可以應(yīng)用于單個(gè)頁面、頁面部分或一類頁面。
• 模板標(biāo)簽是WordPress的內(nèi)置功能，您可以在模板文件中使用它來檢索和顯示數(shù)據(jù)（例如the_title()和the_content()）。
• 模板層次結(jié)構(gòu)是WordPress根據(jù)所請求的內(nèi)容來決定使用哪個(gè)主題模板文件的邏輯。

模板文件

WordPress主題由模板文件組成。它們是一些PHP文件，包含HTML、模板標(biāo)簽和PHP代碼。

構(gòu)建主題時(shí)，將使用模板文件來影響網(wǎng)站不同部分的布局和設(shè)計(jì)。例如，您將使用header.php模板創(chuàng)建頁眉，或使用comments.php模板引入評論。

當(dāng)有人訪問您網(wǎng)站上的頁面時(shí)，WordPress會根據(jù)請求來加載模板。模板文件顯示的內(nèi)容類型由模板文件關(guān)聯(lián)的文章類型確定。模板層次描述了WordPress 將根據(jù)請求的類型加載哪個(gè)模板文件，以及模板是否存在于主題中。 然后，服務(wù)器解析模板中的PHP，并將HTML返回給訪問者。

最關(guān)鍵的模板文件是index.php，如果在模板層次結(jié)構(gòu)中找不到更具體的模板，那么所有請求最終都會被發(fā)送到這個(gè)模板上 。盡管主題僅需要一個(gè)  index.php模板，但通常主題包含許多模板，以便在不同的上下文中環(huán)境中顯示不同的內(nèi)容 。

模板片段

模板片段是用來包含在其他模版中的一種模板。模板片段可以嵌入多個(gè)模板中，從而簡化主題創(chuàng)建。常見的模板部分包括：

• header.php 用于生成網(wǎng)站的頁眉
• footer.php 用于生成頁腳
• sidebar.php 用于生成側(cè)邊欄

盡管以上模板文件僅適用于頁面的一部分，但是您可以創(chuàng)建任意數(shù)量的模板片段，并將其包括在其他模板文件中。

常用WordPress模板文件

以下是WordPress可以識別的一些主題模板和文件列表。

• index.php：主模板文件，所有主題都需要這個(gè)文件。
• style.css：主樣式文件，包含主題的信息，所有主題都需要這個(gè)文件。
• rtl.css：從右向左閱讀的樣式文件，如果站點(diǎn)語言是從右向左閱讀的，主題會自動(dòng)包含此文件。
• comments.php：主題評論模板文件。
• front-page.php：首頁模板文件，無論閱讀設(shè)置中的首頁設(shè)置為什么總是，優(yōu)先選擇此文件模板作為首頁模板文件。
• home.php：如果閱讀設(shè)置中設(shè)置為靜態(tài)頁面，選擇此文件作為首頁模板文件。
• header.php：網(wǎng)站頁頭模板文件，通常包含您網(wǎng)站的文檔類型、元信息、樣式表、腳本鏈接以及其他數(shù)據(jù)。
• singular.php：單頁面模板，未找到 single.php 或 page.php 時(shí)，使用此文件作為這些文章類型的單頁面模板文件。
• single.php：「文章」的詳情頁模板文件。
• single-{post-type}.php：「post-type」文章類型的詳情頁模板文件。
• archive-{post-type}.php：「post-type」文章類型的存檔頁模板文件。
• page.php：「頁面」文章類型的詳情頁模板文件。
• page-{slug}.php：別名為「slug」的頁面詳情頁模板文件。
• category.php：分類目錄存檔模板文件。
• tag.php：標(biāo)簽存檔模板文件。
• taxonomy.php：自定義分類法存檔模板文件。
• author.php：作者存檔頁模板文件。
• date.php：日期存檔頁模板文件。
• archive.php：默認(rèn)存檔頁默模板文件。
• search.php：搜索結(jié)果頁模板文件。
• attachment.php：單個(gè)附件頁面模板文件。
• image.php：圖像頁面模板文件。
• 404.php：頁面找不到時(shí)，顯示的 404 錯(cuò)誤頁面模板文件。

使用模板文件

在WordPress模板中，您可以使用模板標(biāo)簽動(dòng)態(tài)顯示信息，包括其他模板文件或以其他方式自定義您的網(wǎng)站。

例如，您可以在 index.php 中包含其他文件：

• 要包含頁眉，請使用get_header()
• 要包含側(cè)邊欄，請使用get_sidebar()
• 要包含頁腳，請使用get_footer()
• 要包含搜索表單，請使用get_search_form()
• 要包含自定義主題文件，請使用get_template_part()

這是一個(gè)WordPress模板標(biāo)簽示例，可將特定模板包含到您的頁面中：

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

您可以在“ 模板標(biāo)簽”上找到所有內(nèi)容，以了解所有相關(guān)信息。

有關(guān)模板包含的更多信息，請參考主題文件和目錄部分。

主要樣式表（style.css）

style.css是每個(gè)WordPress主題所需的樣式表文件。它控制網(wǎng)站頁面的呈現(xiàn)（視覺設(shè)計(jì)和布局）。

位置

為了使WordPress將主題模板文件集識別為有效主題，style.css文件必須位于主題的根目錄中，而不是子目錄中。

有關(guān)如何在主題中包含style.css文件的更多詳細(xì)說明，請參見“?使腳本和樣式入隊(duì)”中的“樣式表”部分。

基本結(jié)構(gòu)

WordPress使用style.css的頭部注釋部分在外觀（主題）儀表板面板中顯示有關(guān)主題的信息。

示例

這是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主題庫使用此文件中“Version”之后的數(shù)字來確定主題是否有可用的新版本。

• Theme Name?(*): 主體名稱
• Theme URI: 主題介紹信息所在的網(wǎng)址， 用戶可以在其中找到有關(guān)主題的更多信息
• Author?(*): 制作主題的個(gè)人或組織的名稱。建議使用主題作者在wordpress.org注冊的用戶名
• Author URI: 制作者的網(wǎng)址
• Description?(*): 主題簡介
• Version?(*): 主題版本，格式為 X.X 或 X.X.X
• License?(*): 主題授權(quán)許可
• License URI?(*): 主題授權(quán)許可的網(wǎng)址
• Text Domain?(*): 用于翻譯的 文本域 字符串
• Tags: 允許用戶使用標(biāo)簽過濾器查找主題的單詞或短語。標(biāo)簽的完整列表在“?主題審查手冊” 中。
• Domain Path: 用于啟用主題后，WordPress可以在哪里找到翻譯。默認(rèn)為 ?/languages

其中，帶星號（*）的項(xiàng)目是WordPress主題庫中要求的。

在所需的頭部之后，style.css可以包含常規(guī)CSS樣式代碼。

子主題的 Style.css

如果你的主題是個(gè)子主題，則style.css頭部必須包含 Template 行 。

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

有關(guān)創(chuàng)建子主題的更多信息，請?jiān)L問“子主題”頁面。