開發自訂 WordPress 主題係掌握 WordPress 核心功能嘅最佳方法。同用子主題或者頁面構建器唔同，由零開始構建令你有完全嘅控制權，能夠創建出性能卓越、符合特定需求而且獨一無二嘅網站。呢個指南會帶你完成由環境搭建到主題發佈嘅完整流程。
WordPress 主題基礎同檔案結構
一個 WordPress 主題本質上係一個喺 /wp-content/themes/ 目錄下嘅資料夾，包含一系列必需同可選嘅檔案。理解呢啲檔案嘅作用係開發嘅第一步。
核心模板文件嘅作用
每個主題都必須包含兩個核心文件：style.css 同埋 index.php。
style.css 唔單止係樣式表，佢嘅檔案頭部註解仲承載住主題嘅元數據。而 index.php 係預設嘅模板檔案，當WordPress搵唔到更特定嘅模板時，就會用到佢。
推薦閱讀 WordPress主題開發嘅核心概念。
除咗呢兩個檔案，你可以透過加多啲模板檔案嚟精準控制網站唔同部分嘅展示。例如，header.php 負責輸出網頁嘅頭部（好似doctype、head標籤、網站標題同導航），footer.php 負責輸出底部內容，而 single.php 用嚟渲染單篇文章頁面。
主題資訊同函數檔案嘅初始化
在 style.css 嘅頭部，你需要定義主題嘅關鍵資訊，呢啲係WordPress辨認你主題嘅依據。
/*
Theme Name: 我的自定义主题
Theme URI: https://example.com/my-theme
Author: 你的名字
Author URI: https://example.com
Description: 这是一个为学习目的而创建的自定义 WordPress 主题。
Version: 1.0.0
License: GPL v2 or later
Text Domain: my-custom-theme
*/另一個至關重要嘅檔案係 functions.php。佢唔係模板檔案，而係主題嘅「功能引擎」。用嚟添加主題支援、登記選單、側邊欄，同埋引入腳本同樣式。你大部分自訂嘅PHP代碼都會寫喺呢度。一個好嘅做法係喺檔案開頭就定義文字域，用嚟之後嘅翻譯準備。
開發環境搭建同核心模板製作
喺開始編碼之前，建立一個本地開發環境（例如用 Local、XAMPP 或者 Docker）係好重要嘅。咁樣可以令你安全噉進行測試同除錯。
構建主題頭部同底部
將重複嘅代碼模組化係高效開發嘅關鍵。創建 header.php 文件，包含 HTML 文件嘅開頭部分，並用 WordPress 函數動態輸出資訊。
推薦閱讀 WordPress 主題開發入門：從零開始構建你嘅第一款自訂主題。
<!DOCTYPE html>
<html no numeric noise key 1007>
<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 1004>
<?php wp_body_open(); ?>
<header class="site-header">
<h1 class="site-title"><a href="/yue/</?php echo esc_url( home_url( '/' ) ); ?>"><?php bloginfo( 'name' ); ?></a></h1>
<p class="site-description"><?php bloginfo( 'description' ); ?></p>
</header>對應嘅 footer.php 文件就關閉同埋標籤，同埋一定要調用 wp_footer() 函數，呢個係插件同主題腳本正確加載所必需嘅。
在 index.php 入面，你可以用 get_header() 同埋 get_footer() 函數嚟引入佢哋。
開發索引同文章頁面模板
index.php 係你嘅主要模板。一個典型嘅做法係包含一個循環（The Loop），呢個係 WordPress 用嚟顯示文章嘅機制。
<?php get_header(); ?>
<main class="site-main">
<?php if ( have_posts() ) : ?>
<?php while ( have_posts() ) : the_post(); ?>
<article no numeric noise key 1010>
<h2><a href="/yue/</?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
<div class="entry-content">
<?php the_excerpt(); ?>
</div>
</article>
<p><?php esc_html_e( '暂无文章。', 'my-custom-theme' ); ?></p>
<?php endif; ?>
</main>對於單篇文章，你需要創立 single.php。其結構同索引好似，但通常用 the_content() 嚟輸出全文，同埋可能會包含評論模板 comments_template()。
主題功能增強同埋樣式整合
透過 functions.php 檔案，你可以為你嘅主題啟動一系列現代化功能，並正確管理前端資源。
註冊選單同側邊欄
首先，用 add_theme_support() 函數聲明主題支援嘅功能，例如文章縮略圖（特色圖像）同 HTML5 標記。跟住，用 register_nav_menus() 函數嚟註冊導航菜單位置。
推薦閱讀 WordPress 主題開發入門：從零開始構建你嘅第一個響應式主題。
function my_theme_setup() {
add_theme_support( 'post-thumbnails' );
add_theme_support( 'html5', array( 'search-form', 'comment-form', 'comment-list', 'gallery', 'caption' ) );
register_nav_menus( array(
'primary' => __( '主导航菜单', 'my-custom-theme' ),
'footer' => __( '底部菜单', 'my-custom-theme' ),
) );
}
add_action( 'after_setup_theme', 'my_theme_setup' );要創建小工具區域（側邊欄），用 register_sidebar() 函數。然後喺模板入面，通過 dynamic_sidebar() 嚟顯示佢。
正確載入腳本同樣式
千祈唔好直接喺模板度硬性連結 CSS 或者 JS 檔案。應該用 wp_enqueue_style() 同埋 wp_enqueue_script() 功能,並將佢哋安裝到 wp_enqueue_scripts 掛咗喺個鈎上面。咁樣可以確保依賴關係啱晒，同埋避免重複載入。
function my_theme_scripts() {
// 加载主题主样式表
wp_enqueue_style( 'my-theme-style', get_stylesheet_uri(), array(), '1.0.0' );
// 加载主 JavaScript 文件
wp_enqueue_script( 'my-theme-script', get_template_directory_uri() . '/js/main.js', array('jquery'), '1.0.0', true );
}
add_action( 'wp_enqueue_scripts', 'my_theme_scripts' );模板層級同進階功能
理解 WordPress 嘅模板層級係創建靈活主題嘅關鍵。WordPress 會根據而家瀏覽緊嘅頁面類型，自動揀選最特定嘅模板檔案。
利用模板層級建立特定頁面
例如，當訪問一篇 ID 為 5 嘅文章時，WordPress 會按順序搵：single-post-5.php -> single-post.php -> single.php -> singular.php -> index.php。你可以為特定分類或頁面建立模板，例如 category-news.php 或 page-about.php。
實現搜尋表單同頁面導航
喺主題度整合搜尋功能好簡單。整一個 searchform.php 檔案，入面包含一個符合主題風格嘅搜尋表單。跟住喺任何需要嘅地方透過 get_search_form() 函數調用佢。
至於分頁，除咗用 the_posts_navigation()，你亦可以用 the_posts_pagination() 嚟生成有數字頁碼嘅連結，通常對用戶體驗同 SEO 更加友好。
添加主題定制器支援
為咗等用戶可以喺後台「外觀 -> 自訂」度調整一啲設定（例如 Logo、顏色），你可以用 WordPress 自訂器 API。呢個涉及喺 functions.php 入面用 $wp_customize 物件度加設定、控制項同部分。
function my_theme_customize_register( $wp_customize ) {
// 添加一个“主题选项”板块
$wp_customize->add_section( 'theme_options', array(
'title' => __( '主题选项', 'my-custom-theme' ),
'priority' => 130,
) );
// 在板块中添加一个“页脚文本”设置
$wp_customize->add_setting( 'footer_text', array(
'default' => __( '版权所有', 'my-custom-theme' ),
'sanitize_callback' => 'sanitize_text_field',
) );
$wp_customize->add_control( 'footer_text', array(
'label' => __( '页脚文本', 'my-custom-theme' ),
'section' => 'theme_options',
'type' => 'text',
) );
}
add_action( 'customize_register', 'my_theme_customize_register' );然後喺 footer.php 入面，用 get_theme_mod( 'footer_text' ) 嚟輸出用戶設定嘅數值。
摘要
由零開始整一個 WordPress 主題係一個系統性嘅工程，涵蓋咗由項目結構規劃、PHP 模板開發、功能函數編寫到前端資源管理嘅各個方面。核心在於理解模板層級、靈活運用 WordPress 嘅內置函數同掛鉤，並跟隨最佳實踐（例如正確排隊腳本、支援翻譯）。透過親手整一個主題，你唔單止可以得到一個完全符合自己需求嘅網站外觀，仲可以深入理解 WordPress 嘅運作機制，為開發更複雜嘅插件或應用打下堅實基礎。記住，不斷測試、睇官方手冊同參考核心主題代碼係提升技能嘅最佳途徑。
常見問題
整 WordPress 主題一定要掌握邊啲技術？
你需要掌握基礎嘅 PHP 知識，用嚟編寫模板邏輯同功能函數。同時，要熟識 HTML 同 CSS 嚟構建頁面結構同樣式。對 JavaScript（特別係 jQuery）嘅基本了解有助於增加互動功能。最緊要係，要學習 WordPress 特有嘅模板標籤、鈎子（Actions & Filters）同循環（The Loop）嘅用法。
主題開發完成之後點樣發布俾其他人用？
喺發布之前，一定要做全面測試，包括喺唔同環境、唔同屏幕尺寸下嘅兼容性測試，同確保跟從 WordPress 主題開發標準。之後，你可以將主題文件夾壓縮成 .zip 檔案，透過 WordPress 後台直接上傳安裝。如果想提交到 WordPress 官方主題目錄，需要符合更嚴格嘅代碼審查標準，包括安全性、代碼風格同國際化等要求。
自訂主題點樣保障將來嘅更新兼容性？
為咗確保兼容性，應該避免直接修改 WordPress 核心文件。盡量使用 WordPress 提供嘅函數同掛鉤嚟添加功能。喺代碼入面，始終對輸出到前端嘅數據使用轉義函數（如 esc_html， esc_url），對從用戶接收嘅數據使用清理函數（如 sanitize_text_field）。保持對 WordPress 主要版本更新嘅關注，並及時測試你嘅主題。
子主題同自訂主題應該點樣揀？
如果你只係想修改現有主題（例如顏色、佈局微調），咁建立子主題會係更快捷同安全嘅選擇，咁樣可以喺父主題更新嘅同時保留你嘅修改。如果你需要一個有獨特設計、全新功能或者特定內容類型嘅網站，而現有主題冇辦法通過簡單修改滿足，咁從零開始創建自訂主題會係更合適嘅選擇。咁樣可以俾你有最大嘅靈活性同控制權。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。