WordPress主題開發基礎同埋環境搭建
喺開始構建一個自訂WordPress主題之前，必須理解其基本構成。一個最簡單嘅主題只需要兩個檔案：style.css同埋index.php。其中，style.css唔單止係樣式表，佢更加係一個主題嘅「身份證」，包含咗主題嘅名稱、作者、描述等元資訊。呢啲資訊透過特殊嘅註解區塊進行聲明，係WordPress識別一個主題嘅關鍵。
開發環境嘅準備係第一步。建議喺本地搭建一個測試環境，可以用好似Local by Flywheel、XAMPP或者MAMP呢類工具。咁樣就可以喺唔影響線上網站嘅情況下進行開發同調試。同時，準備一個代碼編輯器，好似VS Code或者PhpStorm，呢啲工具對PHP、HTML、CSS同JavaScript都有好好嘅語法高亮同代碼提示支援。
基本嘅主題結構除咗上述兩個必備檔案，隨住功能增加，仲會引入更多嘅模板檔案。例如，用嚟處理單篇文章頁面嘅single.php，用嚟歸檔頁面嘅archive.php，同埋用於頁面嘅page.php。跟住呢種模組化嘅檔案結構係WordPress主題開發嘅核心原則，佢容許開發者針對唔同嘅內容類型同頁面創建特定嘅佈局同樣式。
推薦閱讀 WordPress主題開發完全指南：從零開始構建自訂主題。
核心檔案結構同模板層次
WordPress採用一套精妙嘅模板層級系統嚟自動揀選最合適嘅模板檔案去渲染頁面。理解呢套系統對於高效開發至關重要。佢嘅工作原理簡單嚟講，就係當用戶訪問一個特定頁面嗰陣，WordPress會按照由最具體到最通用嘅順序去搵模板檔案。
例如，當訪問一篇ID係123嘅文章時，WordPress會依次查找：single-post-123.php > single-post.php > single.php > singular.php > index.php。開發者可以透過創建呢啲具體嘅檔案來精確控制唔同內容嘅顯示方式。
創建基礎主頁檔案係起點。index.php係主題嘅終極後備模板。一個最基本嘅index.php通常包含攞網站頭部、循環輸出文章內容同埋攞網站尾部嘅函數。
<article>
<h2><?php the_title(); ?></h2>
<div><?php the_content(); ?></div>
</article>呢段代碼示範咗WordPress嘅核心循環（The Loop），用嚟檢查有冇文章，並循環輸出每篇文章嘅標題同內容。get_header()同埋get_footer()函數就分別引入header.php同埋footer.php文件，係實現代碼重用嘅關鍵。
主題功能同WordPress循環
WordPress循環係驅動內容顯示嘅核心機制。佢係一個PHP代碼區塊，用嚟從數據庫度攞文章，同埋喺頁面度顯示佢哋。喺實際開發中，我哋成日需要定制循環嘅行為，例如只係顯示特定分類嘅文章或者改變文章排序。
推薦閱讀 WordPress主題開發終極指南：由概念到部署嘅完整流程。
定制文章查詢可以用WP_Query類。佢提供咗強大嘅參數嚟創建自定義嘅查詢循環。例如，下面嘅代碼創建一個只查詢「news」分類下嘅3篇文章嘅循環：
<?php
$custom_query = new WP_Query( array(
'category_name' => 'news',
'posts_per_page' => 3
) );
if ( $custom_query->have_posts() ) {
while ( $custom_query->have_posts() ) {
$custom_query->the_post();
// 输出文章内容
}
}
wp_reset_postdata();
?>用完成之後一定要調用wp_reset_postdata()嚟重置全局嘅$post變數，避免影響主循環或其他查詢。
整合主題自訂功能就依賴WordPress嘅主題自訂器API。透過佢，你可以為用戶提供一個可視化嘅介面嚟調整主題嘅顏色、logo、佈局等設定。呢個主要係透過functions.php檔案入面用add_action(‘customize_register’, $callback)掛鉤嚟實現。喺回呼函數入面，你可以用WP_Customize_Manager類別嚟加入設定、控件同部分。
添加樣式、腳本同選單支援
一個現代化嘅WordPress主題必須正確咁管理佢嘅樣式表同JavaScript檔案。正確嘅方式係透過functions.php檔案進行註冊同排隊載入，而唔係直接喺模板檔案入面用或者標籤。咁樣係為咗確保依賴關係正確，同埋跟返WordPress嘅最佳做法。
註冊同載入資源嘅核心操作係透過wp_enqueue_style()同埋wp_enqueue_script()函數完成嘅。呢啲操作應該掛載到wp_enqueue_scripts呢個鈎子上。例如，為你嘅主題註冊一個主樣式表：
function my_theme_enqueue_assets() {
// 加载主样式表
wp_enqueue_style( 'my-theme-style', get_stylesheet_uri() );
// 加载自定义JavaScript文件
wp_enqueue_script( 'my-theme-script', get_template_directory_uri() . '/js/main.js', array('jquery'), null, true );
}
add_action( 'wp_enqueue_scripts', 'my_theme_enqueue_assets' );呢段代碼入面，get_stylesheet_uri()攞到嘅係主題根目錄下嘅style.css，而get_template_directory_uri()用於獲取主題目錄嘅URI。腳本嘅最後一個參數「true」表示將腳本放喺頁面底部加載。
推薦閱讀 WordPress主題開發入門：從零構建你嘅第一個自訂主題。
添加導航選單支援係主題嘅基礎功能之一。呢個需要兩個步驟：首先喺functions.php入面用register_nav_menus()函數聲明主題支援邊啲選單位置，例如「主要選單」同「頁尾選單」。然後，喺模板檔案（例如header.php）入面需要用到wp_nav_menu()函數嚟調用同顯示特定位置嘅選單。WordPress後台嘅「外觀」->「選單」介面會自動出現相應嘅選項。
響應式設計同流動裝置優化係現代網頁設計嘅標準。即係話你嘅style.css必須包含媒體查詢（Media Queries）嚟確保主題喺唔同屏幕尺寸下都可以顯示得好。一個常見嘅做法係採用流動優先（Mobile First）嘅設計原則，先寫流動裝置嘅樣式，然後透過媒體查詢逐步增加大屏幕下嘅樣式覆蓋。
摘要
由零開始開發一個WordPress主題係一個系統性嘅學習過程，佢涵蓋咗由基礎嘅PHP、HTML、CSS知識到對WordPress核心架構嘅理解。關鍵在於掌握佢模組化嘅模板系統、靈活嘅動作同過濾器鈎子，以及標準化嘅資源載入方式。透過構建一個自訂主題，你唔單止可以打造一個完全符合設計需求嘅網站，更能深入理解WordPress嘅運作機制，為之後開發更複雜嘅插件或功能打下堅實基礎。切記要一直喺本地或測試環境中進行開發測試，並遵循WordPress官方嘅編碼標準。
常見問題
### 開發WordPress主題必須精通PHP嗎？
係嘅，熟練掌握PHP係進行WordPress主題深度開發嘅必要條件。因為所有嘅模板檔案同功能函數都係由PHP驅動嘅。你至少需要理解PHP基礎語法、函數、循環同條件判斷，以及同MySQL資料庫嘅基礎互動知識。
主題嘅樣式文件係咪只可以係style.css？
雖然主樣式信息必須喺style.css嘅註釋頭度聲明，但實際嘅CSS代碼可以分拆到多個文件入面。最佳做法係喺style.css入面只保留主題信息註釋同極簡嘅基礎樣式，然後將主要嘅樣式代碼寫入其他CSS文件（例如assets/css/main.css），並通過wp_enqueue_style()函數進行加載。呢個有助於代碼組織同維護。
點樣令我嘅主題支援多語言翻譯？
為咗令主題支援國際化（i18n），你需要使用WordPress提供嘅本地化函數。喺PHP模板文件入面，將所有需要翻譯嘅文本用()、_e()或esc_html()等函數包住。然後，用好似Poedit呢類工具掃描呢啲文本，生成.pot模板文件，並由此創建唔同語言嘅.po同埋.mo翻譯檔案。最後，在functions.php入面用load_theme_textdomain()函數加載翻譯。
點解我自訂嘅查詢會干擾頁面其他部分？
通常係因為冇正確重置查詢數據。當你用new WP_Query()或get_posts()進行自訂查詢之後，全域嘅$post變數會被修改。為咗防止干擾主循環或者後續查詢，你必須喺自訂循環結束之後立即調用wp_reset_postdata()函數。呢個函數會將全局嘅$post物件恢復為當前主查詢中嘅文章。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。