WordPress主題開發環境設定
要開始WordPress主題開發，首先需要建立一個本地開發環境。咁樣唔單止可以提高開發效率，仲可以避免喺線上服務器直接修改可能帶嚟嘅風險。本地環境通常由本地服務器軟件（例如XAMPP、MAMP或者Local by Flywheel）、PHP、MySQL數據庫同埋WordPress核心文件組成。安裝好呢啲基礎軟件之後，下載最新嘅WordPress安裝包，喺本地服務器入面創建一個新嘅數據庫，然後進行WordPress嘅標準安裝流程。
一個標準嘅WordPress主題文件夾至少需要包含兩個核心文件：樣式表style.css同模板檔案index.php。喺style.css嘅頭部註釋入面，必須按照規範聲明主題信息，呢個係WordPress識別一個主題嘅關鍵。呢啲信息包括主題名稱、URI、描述、作者、版本同埋許可證等等。
/*
Theme Name: My First Theme
Theme URI: https://example.com/
Author: Your Name
Description: A custom WordPress theme for learning.
Version: 1.0
License: GPL v2 or later
Text Domain: my-first-theme
*/創建好呢兩個基本文件之後，將成個主題文件夾放喺WordPress安裝目錄下面嘅wp-content/themes/喺路徑度。呢個時候，登入WordPress後台嘅「外觀」->「佈景主題」頁面，就會睇到你新建立嘅主題，而且可以啟動佢。雖然佢暫時仲未有任何實際功能，但標誌住開發環境嘅搭建同主題框架初步完成。
推薦閱讀 WordPress 主題開發完全指南：由零開始構建專業網站。
本地開發工具嘅選擇同配置
除咗基本嘅伺服器環境，揀啱嘅代碼編輯器同除錯工具都好緊要。現代編輯器好似Visual Studio Code、PhpStorm或者Sublime Text都對PHP、CSS、JavaScript同WordPress開發有好好嘅支援，透過安裝相應嘅外掛（例如PHP Intelephense、WordPress Snippet）可以顯著提升編碼效率。另外，開啓WordPress嘅除錯模式可以幫開發者快啲搵到問題，可以喺站點嘅wp-config.php檔案入面將WP_DEBUG常數設定為true。
理解WordPress主題檔案結構同模板層級
WordPress主題跟住一套嚴格嘅模板層級（Template Hierarchy）規則，呢套規則決定咗WordPress喺唔同嘅內容類型同條件下，會自動調用邊個模板檔案嚟呈現頁面。理解呢個層級係靈活控制網站外觀嘅基石。核心思想係，WordPress會從最具體嘅模板檔案開始搵，如果唔存在，就逐級向上返去更通用嘅模板檔案，直到用到index.php作為最後嘅兜底。
例如，當用戶訪問一篇單獨嘅博客文章時，WordPress會按順序搵以下檔案：single-post-{post-slug}.php -> single-post-{post-id}.php -> single-post.php -> single.php -> singular.php -> index.php。開發者可以根據需要創建呢啲特定檔案，嚟實現對博客文章頁面嘅精細化設計。
核心模板檔案同佢哋嘅作用
一個功能完整嘅主題通常包含以下關鍵模板檔案：
header.php：網站頭部模板，通常包含<head>區域、網站標誌同主導航。footer.php： 網站底部模板，通常包含版權資訊、輔助導航同頁尾小工具區。sidebar.php: 側邊欄模板。index.php： 主索引模板，係層級中嘅最終後備檔案。page.php： 用嚟顯示單一頁面。single.php： 用嚟顯示單篇文章。archive.php： 用嚟顯示分類、標籤、作者、日期等歸檔頁面。search.php： 用嚟顯示搜尋結果。404.php： 用嚟顯示「頁面搵唔到」錯誤。front-page.php： 用嚟自訂網站首頁。home.php： 用嚟顯示博客文章索引（如果設咗靜態首頁）。
通過使用WordPress內置嘅函數，例如get_header()、get_footer()同埋get_sidebar()，可以將呢啲模板部件引入到其他模板中，實現代碼嘅模組化同重用。
推薦閱讀 深度解析：WordPress 核心架構同全新主題開發實戰指南。
核心開發技能：PHP、HTML、CSS同主題函數
開發一個WordPress主題本質上係PHP編程同前端技術嘅結合。PHP用嚟動態生成內容同控制邏輯，HTML構建頁面結構，CSS負責樣式表現。
WordPress提供咗海量嘅內置函數同WP_Query類嚟同資料庫互動、攞內容。例如，喺主循環（The Loop）入面，配合while語句同函數好似the_post()、the_title()、the_content()，就可以遍歷同輸出成串文章。
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<article>
<h2><?php the_title(); ?></h2>
<div><?php the_content(); ?></div>
</article>
<?php endwhile; endif; ?>functions.php文件係主題嘅「大腦」，用嚟增強主題功能，而唔使改核心文件。你可以喺呢度加主題支援嘅功能（例如文章縮略圖、自訂菜單）、註冊樣式表同腳本、定義小工具區域、加自訂功能片段等等。舉個例，下面嘅代碼為主題啟用咗文章特色圖像同導航菜單支援。
<?php
function my_theme_setup() {
add_theme_support( 'post-thumbnails' );
add_theme_support( 'menus' );
register_nav_menus( array(
'primary' => __( 'Primary Menu', 'my-theme' ),
) );
}
add_action( 'after_setup_theme', 'my_theme_setup' );
?>隨住主題功能愈嚟愈複雜，為咗提升可維護性，建議將CSS拆分成模組，同埋用Sass/Less等預處理器。同時，透過wp_enqueue_style()同埋wp_enqueue_script()函數，跟返WordPress嘅標準方式將樣式同腳本檔案加入隊列，確保依賴關係正確而且唔會同插件撞。
高級主題功能同實戰技巧
掌握咗基礎之後，就可以為你嘅主題加入更高級、更專業嘅功能。
響應式設計係現代網站嘅標準配備，透過使用CSS媒體查詢（Media Queries），可以令你嘅主題喺唔同屏幕尺寸下都有良好嘅顯示效果。同時，可以利用WordPress嘅body_class()同埋post_class()函數，等WordPress自動為頁面同文章加入基於頁面類型、分類等資訊嘅CSS類別，從而更精準咁控制樣式。
推薦閱讀 乜嘢係 WordPress 主題同佢嘅核心功能。
自訂文章類型同自訂分類法可以將WordPress由單純嘅博客系統擴展成強大嘅內容管理系統。你可以使用register_post_type()同埋register_taxonomy()用函數嚟定義新嘅內容類型（例如「產品」、「作品集」）同埋相應嘅分類方式，並且為佢哋建立特定嘅模板檔案，例如single-product.php或archive-portfolio.php。
主題定制器同自訂選項
為咗令用戶可以喺後台方便咁調整主題顏色、Logo、頁腳文字等等設定，WordPress主題定制器（Customizer）係最佳選擇。透過使用$wp_customize物件同埋佢嘅方法，可以為定制器加入設定、控件同埋板塊。咁樣用戶就可以喺即時預覽下調整主題，所有更改會透過主題修改（Theme Mod）API安全咁保存。
摘要
WordPress主題開發係一個由理解基礎檔案結構開始，逐步深入到PHP模板標籤、函數編寫以及高級功能整合嘅系統性過程。成功嘅主題開發者唔單止需要紮實嘅PHP、HTML、CSS同埋JavaScript知識，更加需要深刻理解WordPress嘅核心概念，例如模板層級、主循環、掛鉤（Hooks）同埋主題定制器。跟隨WordPress嘅編碼標準同埋最佳實踐，開發出嚟嘅主題先至可以具備良好嘅效能、安全性同埋可維護性，並且能夠同龐大嘅插件生態和諧共存。由建立一個簡單嘅style.css同埋index.php起步，不斷實踐同探索，你終將能夠打造出功能強大、設計精美嘅自訂WordPress主題。
常見問題
學習WordPress主題開發需要咩先修知識？
學習WordPress主題開發，建議你至少掌握HTML同CSS嘅基礎知識，用嚟構建網頁結構同樣式。同時，需要對PHP有基本理解，因為WordPress核心同主題邏輯主要係由PHP驅動。對JavaScript嘅了解，特別係同DOM操作同AJAX相關嘅部分，會幫到你實現更動態嘅互動功能。唔使係呢啲領域嘅專家，但基本語法同概念嘅掌握係必要嘅。
點解我嘅自訂主題喺後台唔顯示？
請首先檢查你個主題文件夾係咪正確咁擺喺wp-content/themes/目錄下。然後，確認主題資料夾內係咪包含必需嘅style.css檔案，同埋該檔案嘅頭部註釋資訊（Theme Name, Author等）格式係咪正確、完整。如果資訊缺失或者格式錯誤，WordPress將無法識別該主題。另外，檢查檔案權限，確保WordPress有權限讀取你嘅主題檔案。
點樣令我嘅主題支援多語言？
要令主題支援多語言（國際化與本地化），你需要喺主題中做好文本域（Text Domain）嘅準備。首先，喺style.css嘅頭部註釋同load_theme_textdomain()函數調用度正確設定Text Domain。然後，喺PHP代碼中，對所有需要翻譯嘅用戶可見字串，使用WordPress嘅翻譯函數進行包裝，例如__()用嚟返翻譯，_e()用嚟輸出翻譯。最後，用好似 Poedit 咁嘅工具，掃描源代碼生成.pot模板檔案，並據此創建唔同語言嘅.po/.mo翻譯檔案，將佢哋擺喺主題嘅/languages/目錄入面。
開發商業主題要注意啲咩法律同規範問題？
開發用於銷售或者分發嘅商業主題，必須嚴格遵守 WordPress 嘅 GPL 許可證規範，即係話你嘅主題 PHP 代碼部分一定要繼承 GPL 許可證。你仲需要關注代碼質量，跟從 WordPress 編碼標準，確保主題安全，對用戶輸入進行驗證同轉義，以防 SQL 注入同 XSS 攻擊。功能上，主題應該要好好兼容流行嘅插件，同埋用標準嘅 WordPress 鉤子（例如動作同過濾器）方便擴展。清晰嘅文檔、持續嘅更新支援，同埋反應快嘅客戶服務，都係商業主題成功嘅關鍵因素。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。