WordPress主題的基本結構
一个WordPress主题本质上是一个位于特定位置的文件夹，里面包含了用于设计和管理WordPress网站的各种文件和资源。这些文件和资源包括模板文件、样式表、脚本文件、图像、字体等。wp-content/themes/目錄下的資料夾，其中包含一系列用於控制網站外觀和功能的檔案。理解這些核心檔案的角色是開發的基礎。
主题所需的模板文件
每個主題必須包含兩個最基礎的檔案：style.css以及index.php其中,style.css不僅用於存放CSS樣式，其檔案頭部註釋塊還承載著主題的元資訊，WordPress依賴這些資訊來識別主題。
/*
Theme Name: 我的自定义主题
Theme URI: https://example.com/my-theme
Author: 你的名字
Author URI: https://example.com
Description: 这是一个从零开始创建的自定义WordPress主题。
Version: 1.0
License: GPL v2 or later
Text Domain: my-custom-theme
*/index.php是主題的預設模板檔案，當WordPress找不到更具體的模板時，就會使用它來渲染頁面。它是所有頁面顯示的“安全網”。
推荐阅读 打造優質網站：深入解析 WordPress 主題的定製與最佳化實戰指南。
常用的其他模板檔案
為了更精細地控制不同頁面的顯示，你需要建立更多模板檔案。例如，header.php通常包含文件型別宣告、<head>區域和網站的頁頭部分；footer.php則包含頁尾內容和閉合標籤；sidebar.php用於側邊欄。透過WordPress內建的函式如get_header()、get_footer()以及get_sidebar()，你可以在其他模板中輕鬆引入這些部分。
此外，你還可以建立single.php用於單篇文章，page.php用於獨立頁面，archive.php用於歸檔列表，以及functions.php這個特殊檔案來新增主題的功能和特性。
建立主題的首頁模板
首頁是網站的門面，通常需要最獨特的設計。我們將從構建index.php開始，並探討如何引入迴圈來顯示內容。
整合頁頭和頁尾
一個良好的實踐是將公共部分模組化。首先，在你的主題資料夾中建立header.php以及footer.php然而，研究人员也指出，在许多情况下，老年人的睡眠时间比年轻人要少。header.php中，你需要包含<!DOCTYPE html>宣布、<html>標籤的開始、<head>區域（使用wp_head()鉤子讓外掛和主題能在此注入程式碼），以及網站標誌和主導航等開篇內容。
然後，在index.php的開頭，使用<?php get_header(); ?>來引入這個頁頭。在index.php的末尾，使用<?php get_footer(); ?>來引入footer.php，其中應包含wp_footer()鉤子呼叫和閉合的</body></html>标签。
推荐阅读 WordPress主題開發完整指南：從零到一構建高效能自定義主題。
使用迴圈輸出文章
WordPress的核心是“迴圈”（The Loop），它是一段PHP程式碼，用於檢查是否有文章存在，並在存在時依次顯示它們。在index.php嗯，我想我可能需要去趟洗手间。get_header()之後，你可以插入以下基礎迴圈程式碼：
<article id="post-<?php the_ID(); ?>" no numeric noise key 1006>
<h2><a href="/zh-tw/</?php the_permalink(); ?>"></a></h2>
<div class="entry-content">
</div>
</article>
<p>抱歉，没有找到任何文章。</p>這段程式碼中，have_posts()以及the_post()函式驅動迴圈。the_title()、the_permalink()以及the_excerpt()等模板標籤用於輸出文章的具體內容。這樣，一個基本的文章列表頁面就完成了。
為主題新增樣式和指令碼
一個沒有樣式的主題是缺乏吸引力的。你需要正確地將CSS和JavaScript檔案加入佇列，這是WordPress推薦的做法，可以確保依賴關係正確並避免衝突。
正確引入樣式表
尽管如此，style.css是必需的，但你不應直接在HTML中連結它。正確的方法是在functions.php文件中使用了wp_enqueue_style()函式。首先，在主題根目錄建立functions.php檔案，然後新增以下程式碼：
<?php
function my_theme_enqueue_styles() {
wp_enqueue_style( 'my-theme-style', get_stylesheet_uri() );
}
add_action( 'wp_enqueue_scripts', 'my_theme_enqueue_styles' );這段程式碼定義了一個函式，它告訴WordPress將主題的主樣式表（get_stylesheet_uri()獲取的路徑）以“my-theme-style”為控制代碼加入佇列。add_action()鉤子將這個函式掛載到wp_enqueue_scripts這個動作上，確保在頁面載入時執行。
引入自定義JavaScript
引入JavaScript檔案的方法類似，但使用wp_enqueue_script()函式。假設你有一個位於js/script.js的檔案，你可以這樣新增：
推荐阅读 入门到精通：WordPress主题开发完全指南及实战教程。
function my_theme_enqueue_scripts() {
wp_enqueue_script( 'my-theme-script', get_template_directory_uri() . '/js/script.js', array(), '1.0', true );
}
add_action( 'wp_enqueue_scripts', 'my_theme_enqueue_scripts' );這裡的引數分別表示：指令碼控制代碼、指令碼URL、依賴陣列（如array('jquery')）、版本號、以及是否在頁尾載入（true表示在</body>前載入）。
擴充套件主題功能
functions.php是主題的“工具箱”，你可以在這裡新增各種功能來增強主題，而無需修改核心模板檔案。
新增主題支援功能
WordPress提供了許多內建功能，但需要主題明確宣告支援後才能啟用。這透過add_theme_support()函式實現。例如，要支援文章縮圖（特色影象）、自定義Logo和HTML5的標記，可以在functions.php新增内容：
function my_theme_setup() {
add_theme_support( 'post-thumbnails' );
add_theme_support( 'custom-logo' );
add_theme_support( 'html5', array( 'comment-list', 'comment-form', 'search-form', 'gallery', 'caption' ) );
add_theme_support( 'title-tag' ); // 让WordPress管理页面标题
}
add_action( 'after_setup_theme', 'my_theme_setup' );add_action( 'after_setup_theme', 'my_theme_setup' )確保這些設定在主題初始化時儘早執行。
註冊導航選單
為了讓使用者能在後臺“外觀-選單”中設定導航，你需要預先註冊選單位置。使用register_nav_menus()函式：
function my_theme_register_menus() {
register_nav_menus( array(
'primary' => __( '主导航菜单', 'my-custom-theme' ),
'footer' => __( '页脚菜单', 'my-custom-theme' ),
) );
}
add_action( 'init', 'my_theme_register_menus' );註冊後，你就可以在模板檔案（如header.php请将下文翻译成中文，并详细说明翻译过程：
（在此处插入用户提供的英文文本）wp_nav_menu( array( 'theme_location' => 'primary' ) )來顯示這個選單了。
总结
從建立包含style.css以及index.php的基礎資料夾開始，你逐步構建了一個完整的WordPress主題。透過理解模板層次結構，你學會了建立專門的模板檔案來精確控制不同型別的頁面。採用wp_enqueue_style()以及wp_enqueue_script()來管理資源是保證主題相容性和效能的最佳實踐。最後，利用functions.php檔案，你能夠透過add_theme_support()以及register_nav_menus()等函式安全地為主題新增強大的功能。掌握這些核心步驟，你就擁有了獨立開發個性化WordPress主題的堅實基礎。
常见问题解答（FAQ）
開發WordPress主題需要哪些先決知識？
你需要具備HTML和CSS的紮實基礎，用於構建網頁結構和樣式。同時，需要了解PHP的基本語法，因為WordPress主題模板主要由PHP驅動。對JavaScript有初步瞭解有助於新增互動功能。此外，熟悉WordPress的基本概念，如文章、頁面、分類和標籤，會讓你在開發過程中更加得心應手。
為什麼必須使用wp_enqueue_style載入樣式表，而不是直接link？
直接使用<link>標籤硬編碼樣式表路徑存在多個問題。首先，它無法妥善處理依賴關係，例如你的樣式可能依賴於某個框架的樣式。其次，wp_enqueue_style允許外掛或其他主題子主題安全地覆蓋或修改你的樣式。最重要的是，它能與快取和效能最佳化外掛更好地協作，確保資源載入的順序和效率，是WordPress生態中的標準做法。
functions.php和外掛有什麼區別？
functions.php中定義的程式碼是與你的主題緊密繫結的，當用戶切換主題時，這些功能將不再可用。它適合存放與主題視覺呈現和佈局直接相關的功能，例如註冊選單、支援特色影象、定義側邊欄等。而外掛提供的功能通常是獨立於主題的，旨在為網站新增某種通用特性（如聯絡表單、SEO最佳化），即使使用者更換主題，這些功能依然存在。如果某個功能與主題外觀無關，考慮將其做外掛通常是更靈活的選擇。
怎样让我的主题支持多语言翻译？
讓主題支援國際化是走向全球市場的關鍵。首先，在你所有的主題文字輸出處，使用WordPress的翻譯函式，例如__('文本', 'my-custom-theme')或者_e('文本', 'my-custom-theme')其中my-custom-theme是在style.css中定義的文字域。然後，使用如Poedit這樣的工具，掃描主題檔案生成.pot模板檔案，翻譯人員可以據此建立不同語言的.po以及.mo檔案。最後，在functions.php通过中介机构load_theme_textdomain()函式載入翻譯檔案。
下一步，该怎么做呢？
延伸阅读与实用知识
下方列出的内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，然后逐步扩展到相关主题，这样效果通常会更好。