WordPress主題開發環境設定
要開始開發WordPress主題，首先需要一個穩定高效嘅本地開發環境。咁樣可以令你喺唔影響線上網站嘅情況下進行編碼、測試同除錯。主流嘅選擇包括使用XAMPP、MAMP、Local by Flywheel或者Docker等工具。呢啲工具會一鍵安裝PHP、MySQL同網頁伺服器（例如Apache或者Nginx），為你構建一個同真實線上伺服器環境高度一致嘅沙箱。
跟住，你需要喺本地環境度安裝一個全新嘅WordPress。從官方網站下載最新嘅WordPress安裝包，將佢解壓到本地伺服器嘅網站根目錄（例如XAMPP嘅htdocs資料夾）。然後透過瀏覽器訪問本地地址，跟住指引完成數據庫配置同管理員帳戶創建。一個純淨嘅WordPress安裝係理想嘅學習同開發起點。
最後，你需要準備合適嘅代碼編輯器。Visual Studio Code、PhpStorm或者Sublime Text都係流行嘅選擇，佢哋提供語法高亮、代碼自動補全同除錯功能，可以極大提升開發效率。建議安裝一啲針對WordPress開發嘅擴展插件，例如PHP Intelephense或者WordPress相關嘅代碼片段庫。
推薦閱讀 從零開始：WordPress主題開發完整指南與最佳實踐。
主題基礎結構與核心檔案
一個最簡化嘅WordPress主題至少需要兩個檔案：樣式表style.css同主模板檔案index.php。style.css嘅作用唔單止係定義樣式，佢檔案頭部嘅註解區塊更加係主題嘅「身份證」，用嚟向WordPress系統聲明主題嘅元資料。
下面係一個style.css文件头部嘅示例：
/*
Theme Name: 我的第一个主题
Theme URI: https://example.com/my-first-theme
Author: 你的名字
Author URI: https://example.com
Description: 这是一个用于学习的自定义WordPress主题。
Version: 1.0
License: GPL v2 or later
Text Domain: my-first-theme
*/Text Domain用於國際化（i18n），係後續加載翻譯文本域嘅關鍵標識。而index.php係主題嘅默認模板，當冇其他更具體嘅模板可用時，WordPress就會用佢來渲染頁面。
隨住主題功能複雜化，你需要跟從WordPress模板層級結構來創建更多模板文件。例如，header.php用嚟擺放網站頭部（例如DOCTYPE、<head>標籤同導航菜單），footer.php用嚟擺放網站底部，sidebar.php用嚟擺側邊欄。喺index.php入面，你可以用get_header()、get_footer()同埋get_sidebar()呢啲模板函數用嚟引入呢啲部分，實現代碼重用。
另一個至關重要嘅檔案係functions.php。佢唔係用嚟直接輸出內容嘅，而係作為主題嘅功能增強檔案。你可以喺呢度添加主題支援功能、註冊菜單同側邊欄小工具區域、引入CSS同JavaScript檔案，以及定義各種自訂函數。佢係主題嘅「大腦」，控制住主題嘅行為同功能擴展。
推薦閱讀 WordPress主題開發入門：從零開始構建你嘅第一款網站皮膚。
模板標籤同循環機制
WordPress嘅核心魅力在於其動態內容生成能力，而呢個主要透過「模板標籤」同「主循環」實現。模板標籤係WordPress提供嘅PHP函數，用喺模板檔案度輸出動態內容，例如網誌標題、文章內容、發佈時間等等。
最核心嘅概念係「The Loop」（主循環）。呢段係一段標準嘅PHP代碼結構，用嚟檢查當前頁面有冇「文章」（泛指任何文章類型，例如博客文章、頁面等）需要顯示，如果有，就會循環輸出每一篇。以下係index.php一個典型循環嘅示例：
<article>
<h2><a href="/yue/</?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
<div class="entry-meta">
发布于： | 作者：
</div>
<div class="entry-content">
<?php the_excerpt(); ?>
</div>
</article>
<p>對唔住，搵唔到任何文章。</p>
<?php endif; ?>喺呢個循環入面，have_posts()同埋the_post()函數控制循環嘅進程。the_title()、the_permalink()、the_excerpt()等模板標籤喺循環體內輸出每篇文章嘅具體信息。理解同熟練運用循環係開發任何內容型模板嘅基礎。
除咗文章列表，你仲需要處理單篇文章同獨立頁面。呢個時候就需要建立single.php（用於單篇文章）同page.php（用於獨立頁面）。喺呢啲模板入面，你通常會用the_content()嚟輸出完整嘅文章內容，同埋可能會加評論模板（透過comments_template()調用）comments.php）。
為主題加入高級功能
當基本佈局同內容展示完成之後，你可以透過functions.php為主題注入更強大嘅功能。首先係為主題加入對WordPress核心功能嘅支援，呢個係透過add_theme_support()函數實現。
例如，啟用文章縮略圖（特色圖像）功能係現代主題嘅標準配置：
推薦閱讀 WordPress主題開發完全指南：由入門到精通嘅實戰教學。
add_action( 'after_setup_theme', 'mytheme_setup' );
function mytheme_setup() {
add_theme_support( 'post-thumbnails' );
// 还可以添加其他支持，如自定义Logo、文章格式等
add_theme_support( 'custom-logo' );
add_theme_support( 'html5', array( 'comment-list', 'comment-form', 'search-form', 'gallery', 'caption' ) );
}註冊導航菜單位置等用戶可以喺後台「外觀」->「選單」度管理選單。你喺functions.php度聲明菜單位置，然後喺模板檔案（通常係header.php）度調用佢。
// 在 functions.php 中注册菜单
register_nav_menus( array(
'primary' => __( '主导航菜单', 'my-first-theme' ),
'footer' => __( '页脚菜单', 'my-first-theme' ),
) );
// 在 header.php 中显示主导航菜单
wp_nav_menu( array(
'theme_location' => 'primary',
'menu_class' => 'primary-menu',
) );引入樣式表同腳本檔案必須跟返WordPress嘅規範，用wp_enqueue_style()同埋wp_enqueue_script()函數，同埋將呢啲操作掛上wp_enqueue_scripts喺呢個鉤子上面。咁樣確保咗依賴關係得到正確處理，同埋避免重複加載。
add_action( 'wp_enqueue_scripts', 'mytheme_scripts' );
function mytheme_scripts() {
// 引入主样式表
wp_enqueue_style( 'mytheme-style', get_stylesheet_uri() );
// 引入自定义JavaScript文件
wp_enqueue_script( 'mytheme-script', get_template_directory_uri() . '/js/main.js', array(), '1.0', true );
}最後，你仲可以通過創建sidebar.php同埋註冊側邊欄小工具區域，等用戶可以自由噉透過後台「小工具」介面拖拽組件嚟定制側邊欄內容，呢樣大大增強咗主題嘅靈活性。
摘要
WordPress主題開發係一個將創意、設計同技術融合嘅過程。由搭建本地環境開始，你逐步構建咗包含核心文件（style.css, index.php, functions.php)嘅主題框架。透過理解同運用模板層級結構同主循環，你實現咗動態內容嘅精準輸出。最後，透過functions.php整合選單、小工具、特色圖像等高級功能，你將一個靜態嘅HTML模板轉化成一個功能完整、用戶友好嘅動態WordPress主題。持續學習模板標籤、掛鉤（Hooks）同最佳實踐，你將能夠創建出更強大、更專業嘅主題。
常見問題
### 開發主題係咪一定要識PHP？
係呀，PHP係WordPress嘅伺服器端編程語言，主題嘅模板檔案（.php）主要用PHP混合HTML嚟編寫。你需要掌握PHP基礎語法、函數使用同埋WordPress特有嘅模板標籤同函數。同埋HTML同CSS就係前端表現層嘅基礎，三者缺一不可。
點樣令我嘅主題支援多語言？
為咗令個主題支援多語言（國際化），你需要喺style.css嘅頭部正確設定Text Domain，並喺functions.php中調用load_theme_textdomain()函數嚟載入翻譯檔案。喺模板檔案入面，所有需要翻譯嘅文字都一定要用WordPress嘅翻譯函數包裝，例如__( '文本', 'my-theme-textdomain' )或_e( '文本', 'my-theme-textdomain' )。
主題同插件有咩分別？
主題（Theme）主要控制網站嘅外觀同展示層，包括版面、樣式、模板結構等等。插件（Plugin）就係用嚟為網站加特定功能，呢啲功能應該獨立於主題設計，例如聯絡表格、SEO優化、快取等等。一個好嘅做法係：同視覺呈現密切相關嘅程式碼放喺主題入面，而獨立嘅功能性程式碼就應該整成插件，咁樣就算轉咗主題，核心功能都仲喺度。
點樣調試開發過程中出現嘅錯誤？
建議開啟WordPress嘅除錯模式。你可以喺網站嘅wp-config.php檔案入面，將WP_DEBUG常數嘅值設定為true。咁樣，PHP錯誤、警報同通知就會直接顯示喺頁面上面。同時，結合瀏覽器嘅開發者工具（Console、Network、Elements面板）進行前端調試，可以快速定位同解決CSS、JavaScript同埋網絡請求相關問題。開發完成之後，一定要記得閂返個調試模式。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。