WordPress主題開發基礎同埋環境搭建
要開始WordPress主題開發，首先需要理解其基本結構同埋搭建合適嘅開發環境。一個標準嘅WordPress主題係一個包含特定文件嘅文件夾，位於/wp-content/themes/目錄下。最基礎嘅主題只需要兩個文件就可以運行：style.css同埋index.php。其中，style.css唔單止提供樣式，佢文件頭部嘅註釋仲承載咗主題嘅元信息，例如主題名稱、作者、描述同版本號。
核心模板文件嘅作用
index.php係主題嘅預設模板檔案，當WordPress搵唔到更特定嘅模板檔案時，就會用佢嚟渲染頁面。除咗呢個基礎檔案，主題開發仲涉及一系列其他模板檔案。例如，header.php負責輸出網頁嘅頭部（包括<head>區域同頁眉），footer.php負責輸出頁腳，而sidebar.php就用嚟側邊欄。透過get_header()、get_footer()同埋get_sidebar()呢啲模板函數，可以喺其他模板檔案度輕鬆引入呢啲公共部分。
對於本地開發環境，推薦使用XAMPP、MAMP或者Local by Flywheel等工具嚟搭建一個集成了PHP、MySQL同Apache/Nginx嘅本地伺服器。同時，一個功能強大嘅代碼編輯器（好似VS Code或者PHPStorm）同瀏覽器開發者工具係必不可少嘅。啟用WordPress嘅WP_DEBUG模式對於開發階段排查錯誤至關重要，呢個可以喺wp-config.php檔案度進行設定嚟實現。
推薦閱讀 WordPress 插件開發完全指南：由入門到實戰打造自訂功能。
主題檔案結構與模板層次
理解WordPress嘅模板層次係開發靈活主題嘅關鍵。模板層次係一套規則，決定咗WordPress針對唔同類型嘅請求（例如文章頁、頁面、分類存檔）會優先使用邊個模板檔案。咁樣可以俾開發者為目標頁面創建高度定制化嘅佈局。
由通用到特定嘅查找規則
WordPress嘅模板查找跟從由通用到特定嘅原則。以博客文章頁面為例，佢嘅查找順序可能係：single-post-{slug}.php -> single-post-{id}.php -> single-post.php -> single.php -> singular.php -> index.php。即係話你可以為某篇特定文章（透過別名或者ID）整一個獨一無二嘅模板，亦都可以為所有文章整一個通用模板。
一個功能齊全嘅主題通常包含以下核心模板檔案：
* index.php：最後嘅後備模板。
* header.php / footer.php / sidebar.php：結構組件。
* front-page.php: 靜態首頁。
* home.php: 博客文章索引頁。
* single.php: 單篇博客文章頁。
* page.php: 單頁面。
* archive.php：分類、標籤、作者等存檔頁面。
* search.php：搜尋結果頁面。
* 404.php：404錯誤頁面。
* functions.php：主題功能檔案。
主題功能檔案嘅角色
functions.php檔案係主題嘅「大腦」，佢用嚟添加主題功能、註冊選單、側邊欄，同埋整合其他PHP函數。佢唔係透過include被呼叫，而係由WordPress核心自動載入。喺呢度，你可以用add_theme_support()函數嚟聲明主題對特色圖像、文章格式等功能嘅支援。
核心開發技術：PHP、HTML同CSS
WordPress主題開發本質上係伺服器端嘅動態網頁開發，主要技術棧係PHP、HTML同CSS。PHP用嚟從數據庫攞內容同控制邏輯，HTML構建頁面結構，而CSS就負責視覺表現。
推薦閱讀 WordPress主題嘅核心構成。
使用模板標籤輸出動態內容
WordPress提供咗大量嘅模板標籤（Template Tags），佢哋本質上係PHP函數，用喺模板檔案度輸出動態內容。例如，the_title()用嚟輸出當前文章或者頁面嘅標題，the_content()用嚟輸出主內容，the_permalink()用嚟攞連結，而the_post_thumbnail()用嚟輸出特色圖像。呢啲函數通常喺WordPress主循環（The Loop）入面用。
主循環係主題模板入面用while ( have_posts() ) : the_post();結構去遍歷當前頁面文章嘅代碼塊。佢係輸出多篇文章（例如喺首頁、歸檔頁）或者單篇文章內容嘅基礎。
樣式表嘅組織同引入
現代主題開發強調CSS嘅組織性同可維護性。除咗主style.css，通常會將樣式按模組拆分，並透過functions.php入面嘅wp_enqueue_style()函數排隊引入。對於響應式設計，需要使用CSS媒體查詢（Media Queries）嚟確保網站喺唔同設備上都有良好嘅顯示效果。同時，掌握Flexbox或者Grid佈局能夠極大噉提升開發效率。
以下係一個喺functions.php一個簡單嘅例子，展示點樣註冊導航菜單同引入樣式/腳本：
function my_theme_setup() {
// 注册一个导航菜单位置
register_nav_menus( array(
'primary' => __( '主导航菜单', 'my-theme' ),
) );
// 支持文章特色图像
add_theme_support( 'post-thumbnails' );
}
add_action( 'after_setup_theme', 'my_theme_setup' );
function my_theme_scripts() {
// 引入主题主样式表
wp_enqueue_style( 'main-style', get_stylesheet_uri() );
// 引入一个自定义的CSS文件
wp_enqueue_style( 'custom-style', get_template_directory_uri() . '/css/custom.css', array(), '1.0' );
// 引入一个JavaScript文件
wp_enqueue_script( 'main-js', get_template_directory_uri() . '/js/main.js', array('jquery'), '1.0', true );
}
add_action( 'wp_enqueue_scripts', 'my_theme_scripts' );進階主題功能同實戰技巧
掌握咗基礎之後，可以透過一啲進階功能去打造更專業、更靈活嘅主題。
創建自訂文章類型同分類法
對於需要展示非標準內容（例如產品、作品集、團隊成員）嘅網站，預設嘅「文章」同「頁面」可能唔夠用。呢個時候，可以用register_post_type()函數創建自訂文章類型，並用register_taxonomy()函數為佢創建自訂分類法（好似分類同標籤咁）。呢樣嘢通常喺functions.php或者一個獨立嘅插件入面完成，咁就可以將內容結構化管理。
推薦閱讀 聚焦實戰：從零到一掌握現代 WordPress 主題開發核心技能。
小工具同主題定制器整合
小工具（Widget）容許用戶透過拖放方式喺側邊欄、頁腳等小工具區域加內容塊。用register_sidebar()函數可以登記新嘅小工具區域。WordPress主題自訂器（Customizer）就提供即時預覽嘅主題設定介面。透過用$wp_customize->add_setting()同埋$wp_customize->add_control()等API，你可以為主題加顏色選擇、圖片上傳、文字輸入等設定選項，並俾用戶即時睇到更改效果。
子主題開發同效能優化
千祈唔好直接修改第三方主題嘅核心檔案，正確做法係創建子主題。子主題只包含一個style.css同可能用到嘅模板檔案，佢會繼承父主題所有功能。當父主題更新時，你嘅自訂修改唔會消失。呢個係定制現有主題嘅標準做法。
性能係網站成功嘅關鍵。主題開發中應該注重優化：壓縮CSS同JavaScript檔案、使用適當嘅圖片尺寸（透過add_image_size()）、確保代碼跟隨WordPress編碼標準，並盡量減少數據庫查詢。利用WordPress嘅瞬態（Transients）API緩存耗時查詢嘅結果，可以顯著提升網站速度。
摘要
WordPress主題開發係一個由理解基礎檔案結構開始，逐步深入到模板層次、PHP動態數據調用，最終掌握自訂功能同性能優化嘅系統過程。成功嘅開發者唔單止需要熟練運用PHP、HTML同CSS，更加需要深刻理解WordPress嘅核心機制，例如主循環、模板標籤同掛鉤函數。遵循最佳實踐，例如用子主題進行定制、透過定制器提供用戶選項、同埋時刻關注代碼效率同性能，係打造出既強大又易用嘅專業級主題嘅保證。記住，持續學習同埋動手實踐係掌握呢門技能嘅唯一途徑。
常見問題
開發WordPress主題係咪一定要精通PHP？
冇錯，PHP係WordPress嘅伺服器端編程語言，係主題開發嘅核心。你需要理解PHP基礎語法、函數、循環同條件判斷，先至可以動態調用同輸出WordPress數據庫入面嘅內容。雖然頁面構建器可以降低門檻，但要實現深度定制同高效開發，PHP知識係必不可少嘅。
點樣為我新開發嘅主題加一個自訂頁面模板？
首先，喺你嘅主題目錄入面開一個新嘅PHP檔案，例如my-custom-template.php。喺呢個檔案嘅最頂部，加一段特殊嘅註釋嚟定義模板名稱。然後，你就可以好似其他模板檔案咁樣編寫呢個頁面嘅HTML同PHP代碼喇。建立頁面嗰陣，喺「頁面屬性」嘅「模板」下拉選單入面就可以揀你建立嘅呢個模板。
點解我嘅主題修改喺更新之後唔見咗？
呢個極有可能係因為你直接修改咗從WordPress官方目錄或者第三方市場下載嘅主題檔案。當呢個主題發佈新版本嗰陣，WordPress會自動覆蓋你嘅修改。正確嘅做法係創建一個子主題。子主題獨立於父主題，你所有嘅自定義程式碼都寫喺子主題入面，咁樣既可以繼承父主題嘅功能，又能夠喺父主題更新嗰陣保證你嘅修改安全無虞。
點樣令我嘅主題支援多語言翻譯？
你需要做好主題嘅國際化（i18n）準備。即係話喺主題嘅所有文本字串（如('Read More', 'my-theme-textdomain')）中使用WordPress嘅翻譯函數，例如()、_e()，同埋為佢哋設定一個唯一嘅文本域（Text Domain）。跟住，用好似Poedit咁樣嘅工具來創建.pot翻譯模板檔案，並讓翻譯人員生成對應語言（例如中文）嘅.po同埋.mo文件。最後，喺functions.php入面用load_theme_textdomain()函數嚟載入翻譯。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。