掌握WordPress主題開發係打造個人化網站嘅核心技能，佢令你能夠完全控制網站嘅外觀同功能，唔使再受現有主題限制。本文會系統性噉講解由零開始構建一個完整WordPress主題嘅全過程。
WordPress主題基礎概念
喺開始寫程式碼之前，理解WordPress主題嘅基本構成同運作原理好緊要。一個主題本質上係一個存放喺wp-content/themes/目錄下面嘅資料夾，入面包含一系列有特定作用嘅檔案。
主題嘅核心檔案結構
一個最基本嘅WordPress主題至少需要兩個檔案：style.css同埋index.php。其中，style.css不僅定義咗主題嘅樣式，佢個檔案頭註解仲承載住主題嘅元數據，好似主題名、作者、描述、版本號等等。呢份喺檔案頂部嘅註解係WordPress識別一個主題嘅關鍵。
推薦閱讀 從入門到精通：WordPress主題開發完整指南與實踐教程。
當主題逐漸複雜，就會引入更多模板檔案嚟構建唔同嘅頁面。例如，header.php負責網頁嘅頭部區域，footer.php負責底部區域，sidebar.php管理側邊欄，而functions.php就係一個功能強大嘅檔案，用嚟添加主題功能、註冊選單、小工具區域同埋引入腳本同樣式表。
模板層級同循環機制
WordPress用一套叫做「模板層級」嘅智能系統，嚟決定當前請求應該用邊個模板檔案嚟渲染頁面。佢嘅基本規則係由最具體嘅模板開始搵，如果唔存在，就退返去更通用嘅模板。例如，對於一篇ID係123嘅文章，WordPress會優先搵single-post-123.php，跟住係single-post.php，跟住係single.php，最後回退到singular.php，如果都唔存在，最終使用index.php。
貫穿所有內容顯示嘅核心係「循環」。循環係WordPress用嚟從數據庫中攞內容（例如文章、頁面）並顯示喺網頁上嘅PHP代碼結構。佢嘅基本形式如下：
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<!-- 在这里输出文章内容，例如： -->
<h2><?php the_title(); ?></h2>
<div><?php the_content(); ?></div>
<?php endwhile; endif; ?>透過模板函數如the_title()同埋the_content()，可以喺循環內輸出文章嘅各個部分。理解並熟練運用循環係主題開發嘅基石。
構建基礎主題框架
等我哋一齊動手，整一個叫做「MyFirstTheme」嘅極簡主題，嚟實踐核心概念。
推薦閱讀 打造獨具特色嘅網站：深入解析 WordPress 主題開發全流程。
創建樣式表同主文件
首先，喺wp-content/themes/目錄下創建文件夾myfirsttheme。跟住，喺呢個資料夾度開style.css檔案，同埋喺檔案開頭加返必要嘅註解資料。
/*
Theme Name: My First Theme
Theme URI: https://example.com/myfirsttheme
Author: Your Name
Author URI: https://example.com
Description: 一个用于学习的极简WordPress主题。
Version: 1.0
License: GPL v2 or later
Text Domain: myfirsttheme
*/跟住，創建主題嘅主檔案index.php。呢個係所有頁面嘅最終後備模板。一個最簡單嘅版本可以包含基本嘅HTML結構同循環。
<!DOCTYPE html>
<html no numeric noise key 1005>
<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 1002>
<?php
if ( have_posts() ) :
while ( have_posts() ) : the_post();
the_title( '<h1>', '</h1>' );
the_content();
endwhile;
else :
echo '<p>暂无内容。</p>';
endif;
?>
</body>
</html>wp_head()同埋wp_footer()兩個鈎子至關重要，佢哋容許WordPress核心、插件同其他腳本喺頁面<head>同埋</body>前面插入必要嘅代碼，好似樣式、腳本同元標籤咁。
引入功能文件同模板拆分
為咗令代碼更加模組化，我哋需要拆開模板。創建header.php，將<head>部分同頁面頂部嘅公共結構（例如導航選單）搬入去。創建footer.php，擺入頁腳內容。跟住喺index.php入面用get_header()同埋get_footer()函數引入佢哋。
同時，創建functions.php文件。呢個檔案係主題嘅「控制中心」。首先，我哋可以喺度為主題加返選單支援，同埋引入樣式表。
<?php
function myfirsttheme_setup() {
// 让主题支持导航菜单
register_nav_menus( array(
'primary' => __( '主导航菜单', 'myfirsttheme' ),
) );
// 为文章和评论RSS feed添加支持
add_theme_support( 'automatic-feed-links' );
// 让WordPress管理文档标题
add_theme_support( 'title-tag' );
}
add_action( 'after_setup_theme', 'myfirsttheme_setup' );
function myfirsttheme_scripts() {
// 引入主题的主样式表
wp_enqueue_style( 'myfirsttheme-style', get_stylesheet_uri() );
// 引入Google Fonts等外部资源
wp_enqueue_style( 'myfirsttheme-google-fonts', 'https://fonts.googleapis.com/css2?family=Roboto&display=swap', array(), null );
}
add_action( 'wp_enqueue_scripts', 'myfirsttheme_scripts' );
?>實現高級主題功能
基礎框架搭建好之後，可以開始整合更現代、更強大嘅功能，提升主題嘅專業性同易用性。
推薦閱讀 乜嘢係 WordPress 主題同佢嘅核心功能。
加入小工具支援同側邊欄
小工具係WordPress中可拖拽嘅內容區塊。要令主題支援小工具，需要喺functions.php中註冊一個或多個「小工具區域」，通常稱為側邊欄。
function myfirsttheme_widgets_init() {
register_sidebar( array(
'name' => __( '主侧边栏', 'myfirsttheme' ),
'id' => 'sidebar-1',
'description' => __( '在此添加小工具。', 'myfirsttheme' ),
'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', 'myfirsttheme_widgets_init' );註冊後，喺後台「外觀」->「小工具」度就可以睇到「主側邊欄」區域。要喺前端顯示佢，需要喺模板（例如sidebar.php或index.php）入面用dynamic_sidebar( 'sidebar-1' )函數調用
整合文章特色圖像同自訂Logo
現代主題普遍支援文章縮略圖（特色圖像）同自訂網站標識。透過add_theme_support()函數可以輕鬆啟用呢啲功能。
function myfirsttheme_theme_support() {
// 启用文章和页面的“特色图像”功能
add_theme_support( 'post-thumbnails' );
// 启用自定义Logo功能
add_theme_support( 'custom-logo', array(
'height' => 100,
'width' => 400,
'flex-height' => true,
'flex-width' => true,
) );
}
add_action( 'after_setup_theme', 'myfirsttheme_theme_support' );啟用後，喺文章編輯頁面會出現「特色圖像」元框，喺「自訂器」嘅「網站身份」部分會出現 Logo 上傳選項。喺模板度，可以用the_post_thumbnail()顯示特色圖像，用the_custom_logo()顯示Logo。
主題定制與優化實踐
開發完成並唔代表結束，確保主題嘅靈活性、可維護性同高性能係同樣重要嘅環節。
利用自訂義器添加主題選項
WordPress自訂器容許用戶即時預覽同修改主題設定。透過WP_Customize_Manager對象，可以為主題添加各種設定同控件。例如，添加一個修改網站標題顏色嘅選項。
function myfirsttheme_customize_register( $wp_customize ) {
// 添加一个设置（Setting）用于存储颜色值
$wp_customize->add_setting( 'site_title_color', array(
'default' => '#333333',
'transport' => 'postMessage', // 支持实时预览刷新
'sanitize_callback' => 'sanitize_hex_color',
) );
// 添加一个控件（Control）用于在定制器界面显示颜色选择器
$wp_customize->add_control( new WP_Customize_Color_Control( $wp_customize, 'site_title_color', array(
'label' => __( '网站标题颜色', 'myfirsttheme' ),
'section' => 'colors', // 放在已有的“颜色”板块
'settings' => 'site_title_color',
) ) );
}
add_action( 'customize_register', 'myfirsttheme_customize_register' );跟住，喺style.css或者透過wp_add_inline_style函數，輸出呢個動態樣式。
效能優化與安全實踐
優秀嘅主題必須具備良好嘅性能同安全基礎。性能方面，應確保所有CSS同JavaScript檔案通過wp_enqueue_style()同埋wp_enqueue_script()正確引入，並合理設定依賴同加載位置（例如腳本可以放喺頁尾）。對於圖片，應該確保響應式圖像支援，並鼓勵用戶優化圖片大小。
安全方面，所有從用戶或者數據庫攞到並輸出到頁面嘅動態數據都必須進行「轉義」。WordPress提供咗一系列轉義函數，例如輸出URL用esc_url()，輸出HTML屬性用esc_attr()，輸出文本區域內容用esc_textarea()。喺functions.php中，所有從定制器或選項獲取嘅值喺輸出前都必須經過轉義。
此外，為主題添加翻譯準備，使用__( ‘文本’, ‘myfirsttheme’ )同埋_e( ‘文本’, ‘myfirsttheme’ )嚟包裹所有用戶可見嘅字符串，並創建.pot語言檔案，可以令你嘅主題俾全世界嘅用戶使用。
摘要
WordPress主題開發係一個從理解核心概念（例如模板層級同循環）開始，逐步建立檔案結構、拆分模板、整合功能（例如選單、小工具、特色圖片）嘅實踐過程。深入掌握functions.php嘅運用同自訂器API，能夠極大噉增強主題嘅靈活性同專業性。最後，時刻留意程式碼嘅安全性、效能以及國際化，係成為一個專業主題開發者嘅關鍵。透過跟住呢啲步驟同最佳實踐，你將能夠創造出又靚又功能強大、又安全又高效嘅WordPress主題。
常見問題
整一個WordPress主題係咪一定要識PHP？
係呀，PHP係必須嘅。WordPress本身同佢嘅主題模板系統都係用PHP構建嘅。你需要掌握基礎嘅PHP語法，尤其係要識點樣喺HTML入面嵌入PHP程式碼，同埋點樣用WordPress提供嘅幾千個內建模板函數同掛鉤嚟動態輸出內容、循環文章同處理邏輯。HTML同CSS係建立外觀嘅基礎，而PHP就係實現動態功能嘅靈魂。
點解我個主題喺後台唔顯示
如果主題文件夾已經上傳到wp-content/themes/目錄，但喺WordPress後台嘅「外觀」->「主題」度見唔到，請首先檢查style.css文件頂部嘅主題信息註釋格式係咪正確。註釋區必須嚴格以/*開始，以*/結束，並且包含Theme Name:呢一行。另外，確保主題資料夾入面至少存在style.css同埋index.php呢兩個檔案。檔案權限問題亦都可能導致主題無法被讀取。
functions.php檔案同插件有咩分別
functions.php檔案係主題嘅一部分，佢嘅功能同而家啟用緊嘅主題綁埋一齊。通常用嚟加或者改同個主題視覺表現同功能好密切嘅特性，例如登記菜單位置、定義小工具區域、加主題支援選項、排入主題專屬嘅樣式同腳本。而插件提供嘅功能就係獨立於主題嘅，就算換主題，插件嘅功能通常都仲有效。一般嚟講，如果某個功能純粹係為咗提升網站能力而唔係改變外觀，就更適合整成插件；如果功能同主題嘅佈局、樣式同設計邏輯深度耦合，就應該擺喺functions.php入面。
點樣可以令我嘅主題支援子主題
令你嘅主題支援子主題係鼓勵用戶進行定制而唔會冇咗更新嘅最佳做法。呢個就叫做「父主題」。首先，要確保你嘅主題跟足良好嘅編碼標準，將模板檔案、函數同樣式組織得清清楚楚。最關鍵嘅一步係，喺style.css入面，用@import規則引入父主題樣式嘅方式已經過時。正確做法係，喺子主題嘅functions.php入面用wp_enqueue_scripts鉤子嚟排隊加載父主題嘅樣式表。作為父主題開發者，你只需保證代碼結構清晰，並喺文檔中說明如何創建子主題就得。用戶創建子主題後，WordPress會優先調用子主題中嘅檔案嚟覆蓋父主題嘅同名檔案。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。