開發環境同項目初始化
喺開始構建自訂 WordPress 主題之前，建立一個高效嘅開發環境係至關重要嘅第一步。咁樣唔單止能夠確保程式碼嘅規範性，仲可以大大提升開發效率同埋除錯體驗。
本地開發環境嘅搭建
建議使用本地伺服器軟件，例如 Local by Flywheel、MAMP 或者 XAMPP，佢哋可以好快咁喺你部電腦度搭建一個包含 PHP、MySQL 同埋 Apache/Nginx 嘅運行環境。安裝好本地伺服器之後，下載同埋安裝最新版本嘅 WordPress。跟住，喺 WordPress 安裝目錄嘅 wp-content/themes 資料夾入面，創建一個新嘅資料夾，例如 my-custom-theme，呢個將會係你主題嘅根目錄。
主題核心檔案嘅創建
一個最基本嘅 WordPress 主題只需要兩個檔案：style.css 同埋 index.php。首先，建立 style.css 檔案，佢嘅作用唔單止係定義樣式，更重要嘅係透過檔案頭部嘅註解資訊向 WordPress 聲明你嘅主題。
推薦閱讀 WordPress主題開發終極指南：由零開始創建自訂WordPress網站主題。
/*
Theme Name: My Custom Theme
Theme URI: https://yourdomain.com/
Author: Your Name
Author URI: https://yourdomain.com/
Description: 一个从零开始构建的自定义 WordPress 主题。
Version: 1.0.0
License: GPL v2 or later
Text Domain: my-custom-theme
*/Text Domain 用於國際化，佢會作為後續翻譯文本嘅識別符。跟住，創建最基本嘅 index.php 檔案，可以暫時只包含一個簡單嘅 HTML 結構。完成呢兩個檔案之後，你就可以喺 WordPress 後台嘅「外觀」->「主題」度見到同啟用呢個空白嘅主題喇。
主題結構與模板層級
理解 WordPress 嘅模板層級係開發主題嘅核心。佢決定咗 WordPress 點樣根據唔同嘅請求（例如文章頁、頁面、分類存檔）自動揀選對應嘅模板檔案進行渲染。
核心模板檔案同佢哋嘅作用
WordPress 會跟特定嘅順序搵模板檔案。最基本嘅流程係由最具體嘅模板退返去最通用嘅模板。例如，當瀏覽一篇單獨嘅文章時，WordPress 會順次序搵：single-post-{id}.php, single-post.php, single.php… 最後 singular.php，如果都未搵到，就使用 index.php。同理，主頁會先搵 front-page.php，然後先至係 home.php。掌握呢個層級關係，就可以讓你透過建立特定嘅模板檔案，精確控制唔同頁面嘅佈局。
創建常用模板檔案
除咗 index.php，您應該逐步創建以下關鍵模板文件嚟構建完整嘅主題結構：
- header.php：網站頭部，包含 <head> 區域同頂部導航。
- footer.php: 網站底部。
- sidebar.php:側邊欄
- functions.php: 主題嘅功能文件，用於添加功能、註冊菜單、小工具區等。
- page.php：用嚟渲染單一頁面。
- single.php: 用嚟渲染單篇文章。
- archive.php：用嚟渲染分類、標籤、作者等存檔頁。
在 index.php 喺度，你可以用 get_header(), get_footer(), get_sidebar() 等模板標籤嚟引入呢啲模組化部分，實現代碼重用。
推薦閱讀 深入解析WordPress主題開發：由入門到精通嘅核心技術指南。
核心功能同主題選項
functions.php 文件係你主題嘅「大腦」，所有後端邏輯同功能增強都喺度進行。佢會喺主題初始化時自動載入。
加入主題支援同註冊功能
透過 add_theme_support() 函數，你可以聲明主題支援嘅各種功能。例如，啟用文章縮略圖（特色圖像）係現代主題嘅標準配備。
function my_theme_setup() {
// 添加文章和评论的 RSS feed 链接到 head
add_theme_support( 'automatic-feed-links' );
// 启用文章缩略图功能
add_theme_support( 'post-thumbnails' );
// 启用自定义菜单功能
add_theme_support( 'menus' );
// 让 WordPress 管理文档标题
add_theme_support( 'title-tag' );
// 启用对古腾堡编辑器的宽对齐和颜色支持
add_theme_support( 'align-wide' );
add_theme_support( 'editor-color-palette', array( /* ... */ ) );
}
add_action( 'after_setup_theme', 'my_theme_setup' );你仲需要註冊導航菜單位置同小工具區域（側邊欄）。
function my_theme_menus() {
register_nav_menus( array(
'primary' => __( '主导航菜单', 'my-custom-theme' ),
'footer' => __( '底部菜单', 'my-custom-theme' ),
) );
}
add_action( 'init', 'my_theme_menus' );
function my_theme_widgets_init() {
register_sidebar( array(
'name' => __( '主侧边栏', 'my-custom-theme' ),
'id' => 'sidebar-1',
'description' => __( '在此添加小工具。', 'my-custom-theme' ),
'before_widget' => '<section id="%1$s" class="widget %2$s">',
'after_widget' => '</section>',
'before_title' => '<h2 class="widget-title">',
'after_title' => '</h2>',
) );
}
add_action( 'widgets_init', 'my_theme_widgets_init' );引入樣式表同腳本檔案
正確嘅資源引入方式係通過 wp_enqueue_style() 同埋 wp_enqueue_script() 函數，將佢哋掛載到 wp_enqueue_scripts 掛咗鈎
function my_theme_scripts() {
// 引入主样式表
wp_enqueue_style( 'my-theme-style', get_stylesheet_uri(), array(), wp_get_theme()->get('Version') );
// 引入自定义 JavaScript 文件
wp_enqueue_script( 'my-theme-navigation', get_template_directory_uri() . '/js/navigation.js', array(), wp_get_theme()->get('Version'), true );
// 如果评论功能开启且是单篇文章/页面，加载评论回复脚本
if ( is_singular() && comments_open() && get_option( 'thread_comments' ) ) {
wp_enqueue_script( 'comment-reply' );
}
}
add_action( 'wp_enqueue_scripts', 'my_theme_scripts' );循環同模板標籤
“「循環」係WordPress用嚟從數據庫檢索內容同喺頁面顯示嘅默認機制。理解同正確使用循環係動態內容展示嘅基礎。
標準循環嘅結構
喺模板檔案入面，你成日會見到類似下面嘅代碼結構，呢個就係 WordPress 嘅主循環。
推薦閱讀 WordPress 主題開發入門到精通：從零開始構建自訂主題。
<article id="post-<?php the_ID(); ?>" no numeric noise key 1008>
<header class="entry-header">
<h2 class="entry-title"><a href="/yue/</?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
</header>
<div class="entry-content">
<?php the_content(); ?>
</div>
</article>
<p><?php _e( '抱歉，没有找到任何内容。', 'my-custom-theme' ); ?></p>
<?php endif; ?>have_posts() 同埋 the_post() 函數控制住循環嘅進行。the_title(), the_content(), the_permalink() 等模板標籤用嚟輸出當前文章嘅具體資料。喺循環外面，你可以用 is_home(), is_single(), is_page() 等條件標籤嚟判斷當前頁面類型，從而執行唔同嘅邏輯。
自訂查詢同循環
有時你需要顯示唔係主循環嘅內容，例如喺首頁顯示某個特定分類嘅文章。呢個時候可以用 WP_Query 類嚟創建自定義查詢。
<?php
$custom_query = new WP_Query( array(
'category_name' => 'featured',
'posts_per_page' => 3,
) );
if ( $custom_query->have_posts() ) :
while ( $custom_query->have_posts() ) : $custom_query->the_post();
// 输出文章内容...
endwhile;
wp_reset_postdata(); // 重置全局 $post 数据
endif;
?>摘要
從零開始開發一個WordPress主題係一個系統性嘅工程，佢涵蓋咗由環境搭建、結構規劃、功能實現到動態內容展示嘅全過程。核心在於理解模板層級機制，佢決定咗頁面嘅渲染邏輯；熟練運用 functions.php 嚟擴展主題功能；同埋掌握「循環」呢個基石嚟輸出數據。遵循WordPress編碼標準同最佳實踐，例如正確引入資源、使用翻譯函數、添加足夠嘅主題支援，將會確保你嘅主題穩健、高效同易於維護。透過呢篇指南嘅步驟實踐，你將能夠構建出一個結構清晰、功能完備嘅自定義主題，為更高級嘅開發打下堅實嘅基礎。
常見問題
開發WordPress主題必須掌握邊啲核心技術？
你需要掌握 PHP（用喺後端邏輯同埋模板）、HTML/CSS（用喺結構同埋樣式）、JavaScript（用喺互動）嘅基礎知識。最緊要係理解 WordPress 核心概念，例如模板層級、掛鈎（Hooks）、動作同過濾器（Actions & Filters）、循環（The Loop）同埋 WordPress 提供嘅各種函數同類。
點樣可以令我嘅主題支援古騰堡編輯器？
首先，喺 functions.php 入面用 add_theme_support() 啟用相關功能，例如 editor-styles、align-wide 同自訂顏色面板。其次，為編輯器創建專用嘅樣式表，並透過 add_editor_style() 函數引入，以確保後台編輯器嘅視覺體驗同前台一致。你仲可以創建塊樣式（Block Styles）或者自訂塊（Custom Blocks）嚟提供更豐富嘅編輯功能。
主题开发中點樣實現多語言支援？
WordPress 用緊 GNU gettext 框架做國際化（i18n）。喺代碼入面，所有需要翻譯嘅文本都應該用特定嘅函數包住，例如 () 用喺 PHP 入面翻譯，_e() 用嚟翻譯並直接顯示出嚟，esc_html() 用嚟翻譯同轉義 HTML。喺 JavaScript 入面就用 wp.i18n.__()。跟住，用 Poedit 呢啲工具提取呢啲文字生成 .pot 檔案，再翻譯成 .po 同 .mo 檔案。最後，喺 style.css 嘅頭部正確設定 Text Domain 同喺 functions.php 入面用 load_theme_textdomain() 加載翻譯檔案。
點樣為我嘅主題加自訂設定頁面？
對於簡單嘅選項，可以用 WordPress 內置嘅「自訂器」（Customizer）API，佢提供咗直觀嘅實時預覽介面。對於更複雜嘅需求，可以創建基於選項頁（Options Page）嘅設定介面。推薦使用 WordPress Settings API 來安全地註冊、驗證同保存設定。你亦都可以用高級自訂字段（ACF）或者 Carbon Fields 呢類第三方庫，佢哋可以極大簡化創建自訂字段同選項頁面嘅過程。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。