理解WordPress主題的基本結構
一個WordPress主題不僅僅是一套控制網站外觀的樣式表，它是一個由一系列遵循特定標準的檔案組成的集合。這些檔案協同工作，告訴WordPress如何呈現網站的內容。一個最簡單的主題僅包含兩個檔案：style.css 以及 index.php，但功能強大的主題會包含數十個模板檔案、函式檔案和資產檔案。
核心檔案及其作用
每個WordPress主題都必須包含一個 style.css 檔案。這個檔案不僅是定義網站樣式的核心，其檔案頭部註釋還包含了主題的元資料，如主題名稱、作者、描述和版本。這是WordPress識別一個有效主題的關鍵。
另一個基礎檔案是 index.php，它是主題的預設模板檔案。當WordPress無法為當前請求找到更具體的模板檔案時，就會回退到使用 index.php。
推荐阅读 WordPress主題開發終極指南：從零到精通構建自定義網站。
模板層次結構
WordPress的主題系統遵循一個強大的“模板層次結構”規則。這意味著當訪問一個特定頁面時，WordPress會按照一個預定義的順序去尋找最匹配的模板檔案。例如，當訪問一篇部落格文章時，WordPress會優先尋找 single-post.php，如果不存在，則尋找 single.php最后才使用它。 index.php。理解這個層次結構是進行高階自定義的基礎。
建立你的第一個基礎主題
從零開始建立一個主題是理解其工作原理的最佳方式。我們首先在WordPress的 wp-content/themes 目錄下建立一個新的資料夾，例如命名為“my-first-theme”。
編寫樣式表頭部資訊
在這個資料夾內，建立 style.css 檔案，並輸入以下基本頭部資訊：
/*
Theme Name: My First Theme
Theme URI: https://example.com/my-first-theme
Author: Your Name
Author URI: https://example.com
Description: 这是我开发的第一个WordPress主题，用于学习。
Version: 1.0
License: GNU General Public License v2 or later
Text Domain: my-first-theme
*/構建基礎索引模板
接著，建立 index.php 檔案。這是一個最基本的模板，它使用WordPress核心函式來獲取並顯示網站標題和文章迴圈。
<!DOCTYPE html>
<html no numeric noise key 1014>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<meta name="viewport" content="width=device-width, initial-scale=1">
</head>
<body no numeric noise key 1011>
<header>
<h1><a href="/zh-tw/</?php echo esc_url( home_url( '/' ) ); ?>"></a></h1>
<p></p>
</header>
<main>
<article>
<h2><a href="/zh-tw/</?php the_permalink(); ?>"></a></h2>
<div></div>
</article>
<p></p>
</main>
</body>
</html>此時，你就可以在WordPress後臺的“外觀 > 主題”中看到並啟用這個基礎主題了。
推荐阅读 《WordPress主题开发完全实战指南：从零到一构建自定义主题》。
利用模板檔案與鉤子進行自定義
要讓主題功能豐富且結構清晰，你需要善用模板檔案和WordPress的鉤子系統。
拆分模板為模組化元件
一個專業的主題不會將所有程式碼都堆在 index.php 中。我們使用 get_header()， get_footer()， get_sidebar() 等函式來拆分模板。首先，將 index.php 中頭部和尾部的HTML結構分別移入新建立的 header.php 以及 footer.php 檔案，然後修改 index.php 如下：
<main>
<article>
<h2><a href="/zh-tw/</?php the_permalink(); ?>"></a></h2>
<div></div>
</article>
<p></p>
</main>透過函式檔案新增功能
functions.php 檔案是主題的“大腦”，用於新增特色功能、註冊選單、小工具區域以及排入樣式表和指令碼。建立它，並新增以下基礎程式碼來註冊一個導航選單：
<?php
function my_first_theme_setup() {
// 注册一个导航菜单位置
register_nav_menus( array(
'primary' => __( 'Primary Menu', 'my-first-theme' ),
) );
// 添加文章缩略图支持
add_theme_support( 'post-thumbnails' );
}
add_action( 'after_setup_theme', 'my_first_theme_setup' );
// 排入样式表和脚本
function my_first_theme_scripts() {
wp_enqueue_style( 'main-style', get_stylesheet_uri() );
wp_enqueue_script( 'main-js', get_template_directory_uri() . '/js/main.js', array(), null, true );
}
add_action( 'wp_enqueue_scripts', 'my_first_theme_scripts' );
?>然後，你可以在 header.php 请将下文翻译成中文，并详细说明翻译过程： wp_nav_menu() 函式來顯示這個選單。
實現響應式設計與子主題開發
現代網站必須適配各種裝置螢幕。同時，為了安全地更新父主題而不丟失自定義修改，子主題是必備技能。
應用響應式設計原則
关于 style.css 中，使用CSS媒體查詢來建立響應式佈局。例如，為平板和手機裝置設定不同的樣式規則：
推荐阅读 WordPress主题开发完全指南：从零开始搭建自定义网站。
/* 基础样式 */
.container { width: 100%; max-width: 1200px; margin: 0 auto; }
/* 平板设备 (宽度小于 768px) */
@media (max-width: 768px) {
.container { padding: 0 15px; }
.sidebar { display: none; }
}
/* 手机设备 (宽度小于 480px) */
@media (max-width: 480px) {
h1 { font-size: 1.5em; }
}建立子主題覆蓋父主題
子主題允許你修改或擴充套件另一個主題（父主題）的功能。建立一個新資料夾，例如“my-first-theme-child”，並在其中建立 style.css，其頭部資訊必須包含“Template”行來指定父主題目錄名：
/*
Theme Name: My First Theme Child
Template: my-first-theme
Version: 1.0
*/然後，在子主題的 functions.php 中，你需要排入父主題和子主題的樣式表：
<?php
add_action( 'wp_enqueue_scripts', 'my_child_theme_scripts' );
function my_child_theme_scripts() {
// 排入父主题样式表
wp_enqueue_style( 'parent-style', get_template_directory_uri() . '/style.css' );
// 排入子主题样式表，位于父主题样式之后
wp_enqueue_style( 'child-style', get_stylesheet_uri(), array( 'parent-style' ) );
}
?>之後，你可以透過在子主題中建立同名模板檔案（如 header.php）來覆蓋父主題的對應檔案，或者新增新的CSS規則來改變外觀。
总结
WordPress主題開發是一個從理解核心結構開始，逐步實踐建立基礎主題，再到利用高階特性（如模板層次、鉤子、響應式設計和子主題）進行深度自定義的過程。透過遵循標準化的檔案結構和開發實踐，你可以構建出功能強大、易於維護且外觀專業的主題。核心在於動手實踐，從修改一個簡單的 index.php 以及 style.css 開始，逐步建立起對WordPress主題系統的全面掌控。
常见问题解答（FAQ）
一個WordPress主題最少需要幾個檔案？
一個WordPress主題最少需要兩個檔案：style.css 以及 index.php。
其中,style.css 的頭部註釋必須包含正確的主題元資料，這是WordPress識別和應用主題的關鍵。而 index.php 作為預設的模板檔案，負責處理沒有更具體模板匹配的請求。
如何自定義單個文章頁面的顯示？
要自定義單篇文章的顯示，你需要根據WordPress的模板層次結構建立一個 single.php 檔案，或者為了更精確的控制，建立針對特定文章型別的模板，如 single-post.php。
在這個檔案中，你可以自由組織文章標題、內容、元資料（如作者、釋出時間、分類）和評論區域的佈局。你可以使用WordPress提供的模板標籤，如 the_title()， the_content()， the_author() 等來輸出內容。
functions.php 檔案的作用是什麼？
functions.php 是主題的核心功能檔案，它扮演著類似外掛的角色，用於為主題新增功能、鉤子和過濾器。
它的主要作用包括：初始化主題功能（如註冊選單、小工具區域、新增特色影象支援）、排入CSS樣式表和JavaScript指令碼、定義自定義短程式碼、修改預設的WordPress行為（透過鉤子），以及設定主題特定的配置選項。它將在主題載入時自動被WordPress呼叫。
使用子主題有什麼好處？
使用子主題的最大好處是允許你安全地修改和自定義一個父主題，而無需直接編輯父主題的原始檔。
這意味著當父主題釋出安全更新或功能更新時，你可以直接更新父主題，而你透過子主題所做的所有自定義修改（樣式、模板檔案、功能增強）都會得到保留，不會被覆蓋。這極大地提高了網站維護的效率和安全性，是WordPress開發中的最佳實踐。
下一步，该怎么做呢？
延伸阅读与实用知识
下方列出的内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，然后逐步扩展到相关主题，这样效果通常会更好。