WordPress主題係網站外觀同功能嘅核心。同用現成主題唔同，掌握主題開發技能即係話你可以完全掌控網站設計嘅每一個細節，整出獨一無二、性能優異而且完全符合業務需求嘅網站。呢個指南會帶你由最基本嘅環境搭建開始，逐步深入至高級功能開發，最後實現獨立構建一個功能完整嘅自訂主題。
開發環境與基礎結構搭建
喺開始寫第一行程式碼之前，一個高效嘅本地開發環境係必不可少嘅。我哋推薦用 Local by Flywheel、XAMPP 或者 MAMP 呢啲工具快速搭建包含 PHP、MySQL 同 Apache/Nginx 嘅本地伺服器。
創建主題嘅必要檔案
一個 WordPress 主題最基本嘅檔案結構始於兩個核心檔案。第一個係樣式表檔案 style.css，佢唔單止係定義主題樣式嘅檔案，佢嘅檔案頭註解更加係WordPress識別主題嘅「身份證」。第二個係核心模板檔案 index.php，佢係主題嘅默認入口檔案，當其他更具體嘅模板檔案唔存在嗰陣，WordPress會用佢嚟渲染頁面。
推薦閱讀 WordPress主題開發終�極指南：從零開始構建自訂模板。
一個典型嘅 style.css 檔案頭示例如下：
/*
Theme Name: 我的第一个自定义主题
Theme URI: https://example.com/my-theme
Author: 你的名字
Author URI: https://yourwebsite.com
Description: 这是一个用于学习 WordPress 主题开发的自定义主题。
Version: 1.0
License: GPL v2 or later
Text Domain: my-custom-theme
*/理解模板層級結構
WordPress採用一套精密嘅模板層級系統嚟決定為唔同類型嘅請求用邊個模板檔案。例如，當訪問一篇博客文章嗰陣，WordPress會按順序搵 single-post.php、single.php，最後先係 index.php。理解呢個層級關係（首頁、文章頁、頁面、分類歸檔頁等對應嘅模板檔案）係高效開發嘅關鍵，佢容許你為唔同嘅內容類型創建特定嘅佈局。
核心模板檔案同主題循環
主題嘅功能主要透過一系列 PHP 模板檔案實現。每個檔案負責網站嘅一個特定部分。
構建網站頭部同底部
將每個頁面共用嘅代碼模組化係專業開發嘅第一步。header.php 檔案通常包含文檔類型聲明、 區域（引入 CSS、JS 檔案，設定元標籤）同網站頂部嘅公共區域（例如 Logo 同主導航）。你可以用 get_header() 函數喺任何模板度引入佢。
同理，footer.php 檔案包含網站底部嘅公共內容（例如版權資訊、底部菜單）同埋結束嘅 、 標籤，透過 get_footer() 函數引入。
推薦閱讀 WordPress主題開發完全指南：由零開始打造專業網站主題。
掌握 WordPress 主循環
主循環（The Loop）係 WordPress 主題嘅心臟，佢用嚟從數據庫度檢索同顯示文章內容。其基本結構如下：
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<h2><?php the_title(); ?></h2>
<div class="entry-content">
<?php the_content(); ?>
</div>
<?php endwhile; else : ?>
<p><?php _e( '抱歉，没有找到任何内容。', 'my-custom-theme' ); ?></p>
<?php endif; ?>喺循環入面，你可以用一系列模板標籤（Template Tags）嚟輸出文章資訊，例如 the_title() 輸出標題，the_content() 輸出完整內容，the_excerpt() 輸出摘要，the_permalink() 攞文章連結，the_post_thumbnail() 輸出特色圖像等。
主題功能與自訂功能開發
一個優秀嘅主題唔單止要有美觀嘅介面，仲要提供強大嘅後台可配置性。
啟用主題核心功能
透過 add_theme_support() 函數，你可以為你嘅主題聲明支援邊啲 WordPress 核心功能。呢樣通常喺 functions.php 檔案入面完成。例如，啟用文章特色圖像同自訂 Logo 嘅代碼如下：
function my_theme_setup() {
add_theme_support( 'post-thumbnails' );
add_theme_support( 'custom-logo', array(
'height' => 100,
'width' => 400,
) );
add_theme_support( 'title-tag' ); // 让 WordPress 管理页面标题
}
add_action( 'after_setup_theme', 'my_theme_setup' );建立選單同側邊欄區域
WordPress 容許用戶透過後台視覺化咁管理導航選單。你需要喺 functions.php 入面用 register_nav_menus() 用函數嚟註冊菜單位置，例如「主導航」同「底部導航」。然後，喺模板檔案（例如 header.php）入面用 wp_nav_menu() 函數嚟顯示佢。
側邊欄（或者叫「小工具區域」）同樣需要註冊。用 register_sidebar() 函數定義區域，之後用戶就可以喺「外觀->小工具」後台向呢啲區域拖放唔同嘅小工具。喺模板中，用 dynamic_sidebar() 函數嚟輸出小工具區域嘅內容。
推薦閱讀 從零到一：WordPress主題開發全流程指南與實戰技巧。
引入腳本同樣式表
正確嘅資源引入方式至關重要。千祈唔好直接喺模板檔案度寫死 或 標籤。應該將你嘅 CSS 同 JavaScript 檔案透過 wp_enqueue_scripts 掛鉤進行排隊引入。咁樣可以確保依賴關係正確，而且唔會同其他插件產生衝突。
function my_theme_scripts() {
wp_enqueue_style( 'my-theme-style', get_stylesheet_uri() );
wp_enqueue_script( 'my-theme-navigation', get_template_directory_uri() . '/js/navigation.js', array(), '1.0', true );
}
add_action( 'wp_enqueue_scripts', 'my_theme_scripts' );進階主題特性同自訂功能
當基礎功能齊全之後，你可以用更高級嘅技術去提升主題嘅專業性同靈活性。
開發自訂頁面範本
你可以為特定頁面創建獨特嘅版面設計。只要喺任何範本檔案嘅頂部加一段特定註解，WordPress 後台喺創建或編輯頁面嗰陣就會將佢識別為一個可選嘅範本。例如，創建一個叫做「全寬頁面」嘅範本：
<?php
/**
* Template Name: 全宽页面
* Description: 一个没有侧边栏的全宽度页面模板
*/
get_header(); ?>
// ... 全宽布局的代码 ...
<?php get_footer(); ?>實現文章格式同自訂文章類型
文章格式（Post Formats）好似「日誌」、「圖庫」、「影片」咁，可以為唔同類型嘅網誌文章提供差異化嘅樣式。用 add_theme_support( ‘post-formats’, array( ‘aside’, ‘gallery’ ) ) 嚟啟用，並喺模板度配合 get_post_format() 同條件標籤進行樣式控制。
對於更複雜嘅內容，例如「產品」、「作品集」，你需要建立自訂文章類型（Custom Post Types）。呢樣通常透過 register_post_type() 函數喺插件或者主題嘅 functions.php 入面完成，佢可以將全新嘅內容管理模組加到 WordPress 後台。
整合自訂器 API
WordPress 自訂器（Customizer）提供咗即時預覽嘅主題選項設定介面。透過自訂器 API，你可以為你嘅主題加入顏色選擇器、上傳控件、下拉選擇等設定選項，等用戶唔使掂到代碼就可以調整網站外觀。核心係使用 $wp_customize->add_setting() 同埋 $wp_customize->add_control() 方法。
摘要
WordPress 主題開發係一個由結構到樣式、由基礎功能到高級定制嘅系統化過程。由搭建環境、創建基礎檔案開始，逐步深入到模板層級、主循環同核心功能支援。之後，透過註冊菜單、小工具區域同正確引入資源來增強主題嘅可用性。最終，利用自訂頁面模板、文章格式、自訂文章類型以及自訂器 API，你可以建構出功能強大、高度靈活且用戶體驗極佳嘅專業級主題。持續實踐，並參考官方文檔同優質代碼，係精通呢門技能嘅最佳途徑。
常見問題
主題開發係咪一定要識 PHP 先得？
係呀，PHP 係 WordPress 嘅核心編程語言，主題嘅模板檔案主要都係由 PHP 程式碼構成。你需要掌握 PHP 嘅基礎語法、函數、條件語句同埋迴圈，先至能夠理解同編寫主題程式碼。HTML 同 CSS 係構建前端介面嘅必備技能，而 JavaScript 就用喺互動功能度。
點解我嘅主題修改喺更新之後唔見咗？
咁係因為你直接修改咗正在使用嘅第三方主題檔案。當該主題推出新版本嗰陣，你所有嘅修改都會被覆蓋晒。正確嘅做法係創建一個子主題（Child Theme）。子主題只包含你自定義嘅 style.css、functions.php 同模板檔案，佢會繼承父主題嘅所有功能，而且更新父主題嗰陣，你嘅自定義內容都可以保留到。
functions.php 檔案有咩特別作用？
functions.php 檔案係你主題嘅「功能中心」。佢唔係一個必須被調用嘅函式庫，而係喺主題初始化時自動被 WordPress 載入。你喺度加嘅程式碼（例如啟用主題功能、註冊選單、排隊腳本、定義自訂函數等）會全局生效，用嚟擴展同修改主題同 WordPress 嘅核心行為。
點樣令我嘅主題支援多語言？
令主題支援多語言（國際化同本地化）係一個好習慣。你需要做好兩件事：首先，喺主題中所有需要翻譯嘅字串處，使用 WordPress 嘅翻譯函數（如 __()、_e()）進行包裹，並為佢哋指定喺 style.css 中定義嘅文字域（Text Domain）。其次，使用 Poedit 呢類工具，根據程式碼中嘅翻譯字串生成 .pot 模板文件，並由此創建唔同語言嘅 .po 同埋 .mo 翻譯檔案。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。