WordPress主題開發基礎概念
喺開始寫代碼之前，理解WordPress主題嘅基本構成係至關重要嘅。一個主題本質上係一個文件夾，入面包含一系列文件，呢啲文件一齊決定咗網站嘅外觀同部分功能。WordPress系統透過讀取呢啲文件嚟渲染網頁內容。
一個最基本嘅主題至少需要兩個文件：style.css同埋index.php。其中，style.css唔單止負責樣式，其文件頭部嘅註釋塊仲承載住主題嘅元信息，例如主題名稱、作者、描述、版本號等。呢個係WordPress識別主題嘅入口。
WordPress採用模板層級系統嚟決定唔同頁面使用邊個模板文件。例如，當訪問一篇單獨嘅文章時，WordPress會優先搵single.php；訪問博客文章列表頁時，會搵index.php或home.php；訪問頁面嗰陣，就搵page.php。理解呢個層級關係，可以幫你喺啱嘅位置寫程式碼。
推薦閱讀 從零到一：現代網站建設全流程核心技術詳解與最佳實踐。
主題核心文件嘅作用
functions.php呢個文件係主題嘅功能中樞。佢唔係一個必要文件，但幾乎所有現代主題都會用到佢。你可以喺度加主題支援嘅功能、登記菜單同側邊欄、引入腳本同樣式表，同埋定義各種自訂函數。呢個文件喺主題初始化嗰陣就會自動載入，係擴展主題能力嘅關鍵。
另一個關鍵檔案係header.php，佢通常包含文件類型聲明、區域（引入CSS、JS）同網站頁頭嘅共同部分。footer.php就包含頁腳嘅共同內容同埋結束標籤。透過WordPress函數get_header()同埋get_footer()，你可以喺其他模板檔案入面輕鬆引入佢哋，保持代碼嘅模組化同可維護性。
搭建本地開發環境同創建主題結構
喺將主題部署上線伺服器之前，建立一個本地開發環境係最高效同安全嘅方式。你可以用XAMPP、MAMP、Local by Flywheel或者Docker等工具，喺本地電腦快速安裝Apache、MySQL同PHP，然後運行WordPress。
環境準備好之後，就可以開始創建你嘅第一個主題。首先，進入WordPress安裝目錄下嘅wp-content/themes文件夾。喺呢度新開一個文件夾，用你嘅主題名命名，例如「my-first-theme」。所有主題文件都會放喺呢個文件夾入面。
跟住，創建上面提到嘅基礎文件。首先係style.css，個檔案嘅頭部必須包含特定嘅樣式表資訊。
推薦閱讀 打造專業網站：全方位 WordPress 主題開發與客製化終極攻略。
/*
Theme Name: My First Theme
Theme URI: https://example.com/my-first-theme/
Author: Your Name
Author URI: https://example.com/
Description: 这是一个用于学习的入门级WordPress主题。
Version: 1.0
License: GPL v2 or later
Text Domain: my-first-theme
*/然後，創建最基本嘅index.php檔案。最初，佢可以好簡單，只係為咗確保主題能夠俾WordPress識別同啟動。
<!DOCTYPE html>
<html no numeric noise key 1004>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<meta name="viewport" content="width=device-width, initial-scale=1">
<?php wp_head(); ?>
</head>
<body no numeric noise key 1001>
<h1>你好呀，WordPress主題開發！有咩可以幫到你？想問主題製作、功能修改，定係有代碼上嘅疑問呢？</h1>
<?php wp_footer(); ?>
</body>
</html>呢個時候，登入WordPress後台嘅「外觀」->「主題」頁面，你應該會見到你嘅主題已經出現。啟動佢之後，再訪問網站首頁，就會見到上面代碼輸出嘅簡單資訊。到呢一步，你嘅第一個空白主題框架就成功搭建好喇。
建立主題範本同循環
主題嘅核心任務係展示內容，而WordPress內容嘅展示依賴於「循環」。循環係WordPress中用嚟從數據庫檢索文章（包括頁面、自定義文章類型等）並喺頁面上顯示嘅PHP代碼結構。
理解同實現主循環
最基本嘅循環結構如下所示，通常放置喺index.php或single.php等模板文件中：
<!-- 在这里输出每篇文章的内容 -->
<h2><?php the_title(); ?></h2>
<div><?php the_content(); ?></div>
<p>搵唔到任何文章。</p>
<?php endif; ?>have_posts()函數檢查係咪有文章需要顯示，the_post()函數就設定當前文章嘅數據，等模板標籤（例如the_title()、the_content()）調用。
創建常用模板檔案
為咗令主題可以專業地處理唔同頁面，你需要創建一系列模板檔案。除咗index.php呢個最終後備模板，仲應該創建：
推薦閱讀 WordPress主題開發完整指南：從入門到精通實戰教程。
header.php： 提取公共頭部代碼。footer.php: 提取公共底部代碼。single.php： 用嚟顯示單篇文章。page.php： 用嚟顯示單一頁面。archive.php: 用於顯示分類、標籤、作者等存檔頁。
然後，你需要重構index.php，使用WordPress嘅函數來引入模組化嘅部分：
<main>
<?php while ( have_posts() ) : the_post(); ?>
<article>
<h2><a href="/yue/</?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
<?php the_excerpt(); ?>
</article>
<?php endwhile; ?>
</main>噉樣，頁面嘅頭同尾由獨立嘅檔案管理，主模板檔案只係專注喺該頁面特有嘅內容邏輯，結構清晰，易於維護。
使用functions.php增強主題功能
functions.php係你主題嘅「工具箱」。喺度加代碼，可以安全噉修改同擴展WordPress核心功能，而唔使修改核心檔案。
註冊主題支援嘅功能
透過add_theme_support()函數，你可以聲明主題支援嘅各種功能。例如，令主題支援文章特色圖像、自訂Logo同文章摘要。
function my_first_theme_setup() {
// 让主题支持文章和页面的特色图像功能
add_theme_support( 'post-thumbnails' );
// 支持自定义Logo
add_theme_support( 'custom-logo', array(
'height' => 100,
'width' => 400,
'flex-height' => true,
'flex-width' => true,
) );
// 支持文章格式（可选）
add_theme_support( 'post-formats', array( 'aside', 'gallery', 'quote' ) );
// 为文章和页面开启HTML5标记支持
add_theme_support( 'html5', array( 'comment-list', 'comment-form', 'search-form', 'gallery', 'caption', 'style', 'script' ) );
}
add_action( 'after_setup_theme', 'my_first_theme_setup' );注意，我哋將函數掛載咗喺after_setup_theme呢個動作鈎子上。呢個係WordPress載入主題之後執行嘅一個標準鈎子，係進行主題初始化嘅正確位置。
註冊選單同埋樣式腳本
註冊導航選單位置，容許用戶喺後台「外觀」->「選單」中管理選單。
function my_first_theme_menus() {
register_nav_menus(
array(
'primary' => __( '主导航菜单', 'my-first-theme' ),
'footer' => __( '底部菜单', 'my-first-theme' ),
)
);
}
add_action( 'init', 'my_first_theme_menus' );喺模板文件度，你可以用wp_nav_menu( array( ‘theme_location’ => ‘primary’ ) )嚟顯示呢個菜單。
最後，必須正確噉引入CSS同JavaScript檔案，呢個係最佳實踐。
function my_first_theme_scripts() {
// 引入主题的主要样式表
wp_enqueue_style( 'my-first-theme-style', get_stylesheet_uri(), array(), wp_get_theme()->get( ‘Version’ ) );
// 引入自定义的JavaScript文件
wp_enqueue_script( ‘my-first-theme-script’, get_template_directory_uri() . ‘/js/script.js’, array(‘jquery’), ‘1.0’, true );
}
add_action( ‘wp_enqueue_scripts’, ‘my_first_theme_scripts’ );使用wp_enqueue_style()同埋wp_enqueue_script()函數，並且掛載到wp_enqueue_scripts掛鈎（Hooks），係WordPress官方推薦嘅方式。佢能夠處理依賴關係，避免重複載入，同埋確保喺插件等環境中兼容。
摘要
從創建一個包含style.css同埋index.php嘅資料夾起步，到理解模板層級同「循環」機制，再到利用functions.php檔案為主題添加豐富功能，你已經行過咗WordPress主題開發嘅核心路徑。開發主題嘅關鍵在於模組化思維：將重複嘅部分（例如頁頭、頁尾）分離成獨立檔案，喺functions.php集中管理功能，並跟從WordPress嘅模板層級規則嚟組織內容展示邏輯。掌握咗呢啲基礎知識之後，你就擁有咗打造個人化網站嘅基石，可以進一步探索小工具區域、自訂文章類型、主題定制器API等更高級嘅主題，不斷深化你嘅WordPress開發技能。
常見問題
改咗主題之後，網頁冇即刻更新點算？
呢個通常係因為瀏覽器緩存或者WordPress嘅緩存機制導致嘅。首先，試吓喺瀏覽器度按Ctrl+F5（或者Cmd+Shift+R）進行強制重新整理。如果問題依然存在，請檢查吓你有冇用緩存插件或者伺服器端緩存，同埋試吓清空所有緩存。對於CSS同JS檔案，喺wp_enqueue_style同埋wp_enqueue_script函數入面，你可以畀版本號參數設定一個動態值（例如time()）開發嗰陣要避免用緩存，但上線之前應該改返做固定版本號。
點解我個主題喺後台唔顯示？
首先請檢查你個主題資料夾係咪放喺正確嘅路徑：wp-content/themes/。其次，要確保style.css檔案頂部嘅註釋區塊格式要完全正確，特別係「Theme Name:」呢一行係必不可少嘅。最後，要確認主題文件夾同入面啲檔案嘅權限設定正確，Web服務器（例如Apache）有權限讀取呢啲檔案。
點樣可以幫我個主題加側邊欄？
加側邊欄分為兩步。首先，喺functions.php入面用register_sidebar()函數註冊一個或多個小工具區域。然後，喺你希望顯示側邊欄嘅模板文件（如sidebar.php）入面，使用dynamic_sidebar()函數嚟調用佢。同時，你喺主模板文件（如index.php）入面用get_sidebar()嚟引入側邊欄模板。
開發主題嗰陣，點樣確保佢同插件嘅兼容性？
遵循WordPress編碼標準係確保兼容性嘅基礎。對於外掛可能添加嘅內容，要確保你嘅佈景主題適當地調用wp_head()同埋wp_footer()函數，因為好多外掛都依賴呢兩個掛鈎來插入必要嘅程式碼（例如統計程式碼、CSS/JS）。另外，喺輸出文章內容嗰陣，一定要用the_content()函數而唔係直接存取資料庫，呢個函數會應用外掛透過「the_content」篩選器添加嘅所有修改。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。