WordPress主題開發環境設定
喺開始開發WordPress主題之前，你需要建立一個合適嘅本地開發環境。咁樣可以令你喺冇網絡同伺服器風險嘅情況下，自由噉進行編碼、除錯同測試。首先，你需要安裝一個本地伺服器環境，例如用XAMPP、MAMP或者Local by Flywheel呢啲工具。呢啲工具集齊Apache、MySQL同PHP，一撳掣就可以搭建到同線上伺服器差唔多嘅環境。
跟住，將WordPress核心檔案下載同安裝到你嘅本地伺服器根目錄。安裝過程入面，你需要建立一個用嚟測試嘅數據庫。完成WordPress嘅初始化設定之後，你就可以開始創建主題喇。
創建主題嘅基礎結構
所有WordPress主題都喺/wp-content/themes/目錄下。請喺呢個目錄度開個新資料夾，例如my-first-theme。呢個資料夾嘅名就係你嘅主題識別符，建議用細楷字母同埋連字號。
推薦閱讀 點樣從零開始建立一個專業嘅WordPress主題：完整開發指南。
喺呢個新資料夾入面，你必須要整嘅第一個亦都係最重要嘅檔案係style.css。呢個檔案嘅頭部註釋唔單止用嚟定義樣式，更重要嘅係為WordPress提供識別主題所需嘅元資訊。
/*
Theme Name: My First Theme
Theme URI: https://yourwebsite.com/
Author: Your Name
Author URI: https://yourwebsite.com/
Description: 一个简洁的自定义主题。
Version: 1.0.0
License: GPL v2 or later
Text Domain: my-first-theme
*/
/* 从这里开始才是实际的CSS样式 */核心模板文件詳解
WordPress 主題開發跟住一套特定嘅模板層次結構。系統會根據用戶訪問嘅頁面類型（例如首頁、文章頁、分類頁）自動揀選對應嘅模板檔案嚟渲染。理解呢啲檔案係開發嘅核心。
主題必須包含嘅模板檔案
一個最基礎嘅 WordPress 主題只需要兩個檔案：style.css 同埋 index.php。index.php 係模板層次結構嘅最終回退檔案，當其他更具體嘅模板唔存在嗰陣，WordPress就會用到佢。
不過，為咗建立結構清晰、功能完善嘅網站，你應該建立以下幾個關鍵模板文件：
header.php：定義頁面嘅頭部區域，通常包含<head>部分、網站 LOGO 同主導航菜單。footer.php：定義頁面嘅底部區域，通常包含版權資訊、頁腳導航同小工具區域。sidebar.php: 定義側邊欄內容。index.php: 主模板檔案。single.php: 用於顯示單篇網誌文章或自訂文章類型嘅內容。page.php: 用於顯示靜態頁面。front-page.php: 如果存在呢個檔案，佢會作為網站嘅靜態首頁，優先級高過home.php。archive.php: 用嚟顯示分類、標籤、作者、日期等等歸檔列表。
模板檔案嘅引入同組合
WordPress 用特定嘅函數嚟組合呢啲模板檔案。喺index.php喺度，你會睇到咁樣嘅結構：
推薦閱讀 WordPress主題開發完全指南：從零到上線。
<?php get_header(); // 引入 header.php ?>
<main id="main">
<?php
if ( have_posts() ) :
while ( have_posts() ) : the_post();
// 输出文章内容
the_title( '<h1>', '</h1>' );
the_content();
endwhile;
else :
echo '<p>没有找到内容。</p>';
endif;
?>
</main>呢度，get_header()、get_sidebar()同埋get_footer()函數分別用嚟引入對應嘅模板檔案。
主題功能同自訂
一個強大嘅主題唔單止需要靚嘅外觀，仲需要完善嘅功能支援。呢啲功能通常透過主題嘅functions.php檔案嚟實現。
用functions.php增強主題
functions.php文件係你主題嘅「功能中心」，用嚟加自訂功能、登記菜單、小工具區域，同埋對主題進行初始設定。
__( '主导航菜单', 'my-first-theme' ),
] );
// 添加对 HTML5 标记的支持
add_theme_support( 'html5', [ 'search-form', 'comment-form', 'comment-list', 'gallery', 'caption' ] );
}
add_action( 'after_setup_theme', 'mytheme_setup' );
// 注册侧边栏小工具区域
function mytheme_widgets_init() {
register_sidebar([
'name' => __( '主侧边栏', 'my-first-theme' ),
'id' => 'sidebar-1',
'description' => __( '在此添加小工具。', 'my-first-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', 'mytheme_widgets_init' );
// 引入样式表和脚本文件
function mytheme_scripts() {
// 引入主样式表
wp_enqueue_style( 'mytheme-style', get_stylesheet_uri() );
// 引入自定义 JavaScript 文件
wp_enqueue_script( 'mytheme-navigation', get_template_directory_uri() . '/js/navigation.js', [], '1.0.0', true );
}
add_action( 'wp_enqueue_scripts', 'mytheme_scripts' );
?>創建自定義文章類型
當默認嘅「文章」同「頁面」唔夠用時，你可以透過代碼創建自訂文章類型。例如，為「作品集」創建一個新類型：
function mytheme_create_portfolio_cpt() {
register_post_type( 'portfolio',
[
'labels' => [
'name' => __( '作品集', 'my-first-theme' ),
'singular_name' => __( '作品', 'my-first-theme' )
],
'public' => true,
'has_archive' => true,
'menu_icon' => 'dashicons-portfolio',
'supports' => [ 'title', 'editor', 'thumbnail', 'excerpt' ],
'rewrite' => [ 'slug' => 'portfolio' ],
]
);
}
add_action( 'init', 'mytheme_create_portfolio_cpt' );主題開發進階同安全
完成基本功能同界面之後，你需要關注代碼嘅組織、性能、安全性同可維護性，令主題達到專業級水準。
使用子主題嚟做定制
直接改父主題（例如 Underscores 或者流行框架主題）係唔建議嘅，因為更新父主題嗰陣會冚唪唥覆蓋晒你啲改動。最佳做法係用子主題。子主題只係包含style.css、functions.php同你想覆蓋嘅父主題模板檔案，佢可以繼承父主題所有功能，仲可以俾你安全噉自訂。
推薦閱讀 WordPress主題開發全攻略：從零開始構建自訂網站。
子主題嘅style.css頭部需要註明父主題：
/*
Theme Name: My Child Theme
Template: parent-theme-folder-name
*/喺子主題嘅functions.php喺度，代碼會喺父主題嘅functions.php加載之前執行，你可以加啲新功能或者用鉤子修改父主題嘅行為。
跟返主題審查標準同安全
為咗確保主題質素、安全性同兼容性，你嘅主題應該大致跟返WordPress主題審查標準。呢個包括但唔限於：進行代碼安全轉義（使用esc_html(), esc_url()等函數）、對可翻譯字符串進行國際化處理（使用__()同埋_e()函數）、確保主題響應式設計、以及唔好硬編碼核心功能等等。
喺2026年嘅開發環境入面，仲要特別留意對新嘅Web技術（例如更廣泛嘅CSS Grid/Flexbox應用、原生懶加載等等）嘅支援，同埋對PHP新版本特性嘅安全使用。一定要確保你嘅主題代碼唔會產生PHP警告或者錯誤日誌。
摘要
WordPress主題開發係一個由基礎結構搭建到高級功能實現嘅系統性過程。你需要由理解模板層次結構開始，掌握核心嘅header.php、footer.php、single.php等文件嘅用法。透過強勁嘅functions.php文件，你可以為主題添加菜單、小工具、自定義文章類型等等豐富功能。喺開發後期，採用子主題策略進行定制、跟從主題開發標準同埋注重代碼安全同性能，係將你嘅主題提升到專業級別嘅關鍵步驟。實踐係學習嘅最佳途徑，建議由一個簡單嘅主題框架開始，逐步添加功能，最終創造出功能完善、設計精良嘅WordPress主題。
常見問題
開發WordPress主題需要學邊啲編程語言？
開發WordPress主題主要需要掌握HTML、CSS、PHP同基礎嘅JavaScript。HTML同CSS用嚟構建同美化前端界面。PHP係WordPress嘅核心語言，用嚟處理數據邏輯同調用WordPress嘅各種函數。JavaScript用嚟實現頁面嘅互動效果。另外，了解SQL基礎有助理解WordPress嘅數據操作。
點樣喺我嘅主題度加入自訂頁面模板？
首先，喺主題根目錄下創建一個新嘅PHP檔案，例如template-fullwidth.php喺呢個檔案嘅頂部，你需要加一個特別嘅模板名稱註解。然後，你可以好似編輯其他模板檔案咁樣編輯呢個檔案。完成之後，喺WordPress後台嘅頁面編輯器入面，你會發現「頁面屬性」嘅「模板」下拉選單度出現咗你創建嘅新模板選項。
<?php
/* Template Name: 全宽页面模板 */
get_header();
?>
<!-- 你的全宽页面内容 -->
<?php get_footer(); ?>點解我個主題更新之後自訂修改會消失？
呢個係因為你直接修改咗正在使用嘅主題檔案。當該主題發佈新版本，你透過後台點擊更新嗰陣，WordPress會用新檔案覆蓋舊檔案，導致你嘅自訂修改唔見咗。為咗避免呢種情況，強烈建議使用「子主題」嚟進行所有自訂修改。子主題獨立於父主題，即使父主題更新，你嘅自訂內容都會保留。
點樣可以令我嘅主題支援多語言（國際化）？
你需要使用WordPress嘅國際化（i18n）函數嚟包裹所有面向用戶嘅文字字串。喺PHP模板入面，使用__('文本', 'text-domain')嚟攞翻譯，用_e('文本', 'text-domain')直接出。喺JavaScript檔案入面，就要用wp_set_script_translations()函數。最後，用好似Poedit呢啲工具嚟整.pot翻譯模板檔案同埋.po/.mo語言包檔案。
我應該由零開始開發主題，定係用現成嘅主題框架？
呢個要睇你嘅目標、技能水平同埋項目需求。對於初學者或者想快啲上手嘅開發者，用一個輕量級嘅起步框架（例如Underscores）係一個絕佳選擇，佢提供符合標準嘅基礎代碼結構，等你可以專注喺設計同功能嘅實現。對於需要構建複雜、可擴展產品嘅專業開發者，由零開始可以帶嚟最大嘅彈性同控制力，但係需要投入更多時間。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。