WordPress主題係構建網站外觀同功能嘅核心骨架。掌握其開發能力即係話你可以完全自訂網站嘅一切，擺脫預製主題嘅限制，實現獨特嘅設計構想同功能需求。從理解其基本概念同檔案結構開始，係踏上呢條路嘅第一步。
每個WordPress主題都係一個位於/wp-content/themes/目錄下嘅資料夾。一個最基本嘅功能性主題只需要兩個檔案：style.css同埋index.php。其中，style.css唔單止用嚟存放樣式，其檔案頭部註解仲承載住主題嘅元信息，呢個係WordPress識別一個主題嘅關鍵。
在style.css個頭部，你需要用特定嘅註釋嚟定義主題。一個典型嘅例子如下：
推薦閱讀 WordPress主題開發完整指南：從入門到精通的實戰教程。
/*
Theme Name: 我的第一个主题
Theme URI: https://example.com/my-first-theme
Author: 你的名字
Author URI: https://example.com
Description: 这是一个用于学习的自定义WordPress主题。
Version: 1.0
License: GPL v2 or later
Text Domain: my-first-theme
*/呢段資料會喺WordPress後台嘅「外觀 > 主題」列表入面出現。而index.php就係主題嘅主模板檔案，用喺其他更具體嘅模板唔存在嗰陣作為預設後備。隨住開發深入，你會慢慢用更具體嘅模板檔案嚟取代或者補充佢。
理解主題嘅模板層級結構
WordPress用一套好精細嘅模板層級系統，嚟決定對於任何一個特定嘅頁面請求，應該用邊個模板檔案嚟渲染。理解呢套層級係高效開發主題嘅基礎，佢可以令你知道喺創建特定頁面（例如博客文章詳情、分類目錄頁）嗰陣，應該俾檔案改咩名。
主要模板檔案嘅命名規則
模板層級跟從「由特殊到一般」嘅原則。舉個例，當訪問一篇ID係123嘅博客文章嗰陣，WordPress會按順序搵：single-post-123.php、single-post.php、single.php… 最後singular.php。如果呢啲都唔存在，先至會用index.php。
常用嘅核心模板文件包括：
- front-page.php：用嚟設定網站首頁。
- home.php: 博客文章索引頁。
- single.php：單篇博客文章或者自訂文章類型嘅單篇文章。
- page.php: 單頁面。
- archive.php：各類歸檔頁（分類、標籤、作者等）嘅通用模板。
- category.php：特定分類目錄頁。
- 404.php：404錯誤頁面。
- header.php、footer.php、sidebar.php：呢啲通常係局部模板片段嚟。
調用局部模板嘅常用函數
為咗保持代碼嘅模組化同可維護性，WordPress提供咗幾個關鍵函數嚟載入局部模板檔案。最核心嘅係get_header()、get_footer()同埋get_sidebar()。佢哋分別用於引入header.php、footer.php同埋sidebar.php。
推薦閱讀 WordPress主題開發嘅核心概念。
另一個至關重要嘅函數係get_template_part()。佢容許你以更靈活嘅方式引入任何模板片段。例如，喺博客文章循環入面，你可能想引入一個專門嘅文章內容模板：
<?php while ( have_posts() ) : the_post(); ?>
<?php get_template_part( 'template-parts/content', get_post_type() ); ?>
<?php endwhile; ?>呢段代碼會優先搵template-parts/content-post.php（假設文章類型係post），如果搵唔到，就載入template-parts/content.php。
利用核心函數同鉤子驅動功能
WordPress嘅強大功能來自佢龐大嘅函數庫同事件驅動嘅「鉤子」系統。喺主題開發入面，熟練使用核心函數同鉤子，係實現複雜功能、優化性能同安全性嘅關鍵。
獲取同輸出內容嘅基本函數
喺模板檔案入面，你會成日用一連串嘅函數嚟攞同顯示動態內容。例如，the_title()用嚟輸出當前文章或者頁面嘅標題，而the_content()就輸出經過格式化處理嘅主要內容。同直接輸出嘅函數相對應嘅係以get_開頭嘅函數，例如get_the_title()，佢哋會返數據俾你喺程式碼度進一步處理。
博客文章循環係WordPress模板嘅核心，佢嘅標準程式碼結構如下：
<!-- 在这里输出文章内容 -->
<h2><?php the_title(); ?></h2>
<div><?php the_content(); ?></div>
<?php endwhile; ?>
<!-- 这里可以放置分页导航 -->
<?php else : ?>
<!-- 如果没有找到文章，显示的内容 -->
<p>暫時冇內容。</p>
<?php endif; ?>透過掛鉤進行功能擴展
掛鉤分為「動作」同「過濾器」兩種。動作掛鉤容許你喺特定事件發生嗰陣插入自己嘅程式碼，例如喺wp_head鉤子中輸出額外嘅元標籤。你可以用add_action()函數嚟掛載自己嘅函數。
推薦閱讀 WordPress 主題開發入門:從零開始打造你嘅第一個自訂主題。
例如，喺主題嘅functions.php檔案入面加返Feed連結嘅支援：
add_action( 'after_setup_theme', 'mytheme_setup' );
function mytheme_setup() {
// 为文章和评论添加Feed链接到head中
add_theme_support( 'automatic-feed-links' );
}過濾器鉤子就准你修改數據。例如，用excerpt_length過濾器可以更改文章摘要嘅長度：
add_filter( 'excerpt_length', 'mytheme_custom_excerpt_length', 999 );
function mytheme_custom_excerpt_length( $length ) {
return 30; // 将摘要长度设置为30个单词
}functions.php文件係主題嘅「功能中心」，所有自訂函數、對掛鉤嘅調用同主題功能嘅聲明都應該放喺呢度。
聲明主題功能支援
使用add_theme_support()用函數嚟聲明你嘅主題支援邊啲WordPress核心功能，呢個係良好嘅開發實踐。咁樣唔單止啟用功能，仲可以確保同未來版本嘅兼容性。
常見嘅功能聲明包括：
add_action( 'after_setup_theme', 'mytheme_theme_support' );
function mytheme_theme_support() {
// 支持文章特色图像
add_theme_support( 'post-thumbnails' );
// 支持HTML5语义化标记
add_theme_support( 'html5', array( 'comment-list', 'comment-form', 'search-form', 'gallery', 'caption', 'style', 'script' ) );
// 支持自定义Logo
add_theme_support( 'custom-logo', array(
'height' => 100,
'width' => 400,
'flex-height' => true,
'flex-width' => true,
) );
}整合自訂樣式同腳本文件
一個現代化嘅主題必須正確咁管理佢嘅CSS樣式表同JavaScript腳本，以確保佢哋按需要載入、避免衝突，同埋符合前端效能優化嘅最佳實踐。
安全註冊同載入資源
千祈唔好喺模板檔案入面直接使用<link>或<script>標籤嚟硬編碼資源。正確嘅方法係使用wp_enqueue_scripts動作鉤子，配合wp_enqueue_style()同埋wp_enqueue_script()函數。
在functions.php入面，你需要定義一個函數嚟處理資源嘅排隊：
add_action( 'wp_enqueue_scripts', 'mytheme_enqueue_assets' );
function mytheme_enqueue_assets() {
// 加载主样式表
wp_enqueue_style( 'mytheme-style', get_stylesheet_uri(), array(), '1.0' );
// 加载Google字体
wp_enqueue_style( 'mytheme-google-fonts', 'https://fonts.googleapis.com/css2?family=Roboto:wght@400;700&display=swap', array(), null );
// 加载主JavaScript文件，并依赖jQuery，在页脚加载
wp_enqueue_script( 'mytheme-script', get_template_directory_uri() . '/assets/js/main.js', array( 'jquery' ), '1.0', true );
// 如果需要传递PHP变量到JS，可以使用wp_localize_script
wp_localize_script( 'mytheme-script', 'myThemeData', array(
'ajax_url' => admin_url( 'admin-ajax.php' ),
'home_url' => home_url(),
));
}呢種方式確保咗依賴關係正確，避免咗重複加載，而且容許插件同其他主題透過佢哋嘅依賴聲明進行管理。
為古騰堡編輯器加入樣式支援
隨住區塊編輯器嘅普及，為後端編輯器加入前端樣式支援變得至關重要，以實現「所見即所得」嘅編輯體驗。你可以用add_theme_support( ‘editor-styles’ )並排隊一個編輯器樣式表。
add_action( 'after_setup_theme', 'mytheme_editor_styles' );
function mytheme_editor_styles() {
add_theme_support( 'editor-styles' );
add_editor_style( 'assets/css/editor-style.css' );
}摘要
WordPress主題開發係一個從理解基礎檔案結構開始，逐步深入到模板層級、核心函數、掛鉤系統同資源管理嘅過程。關鍵在於實踐：從一個最簡單嘅style.css同埋index.php開始，然後創建header.php同埋footer.php進行模組化拆分。跟住，利用模板層級為唔同嘅頁面類型創建專門模板，例如single.php或page.php。喺functions.php中透過掛鉤同add_theme_support安全地添加功能，並且一直通過wp_enqueue_scripts嚟管理樣式同腳本。跟住呢啲核心原則同步驟，你就能夠構建出專業、高效兼且易維護嘅WordPress主題。
常見問題
創建一個WordPress主題最少需要邊啲檔案？
技術上嚟講，一個俾WordPress識別同啟動嘅主題最少只需要兩個檔案：style.css同埋index.php。style.css嘅檔案頭部註解必須包含正確嘅主題元信息，例如Theme Name。而index.php作為最基礎嘅模板檔案，用嚟渲染所有頁面。
點樣為我嘅主題創建自訂頁面模板？
建立自訂頁面模板好簡單。你只需要喺任何模板檔案（通常係page.php）嘅頂部加一段特定嘅PHP註解區塊。例如，要建立一個「全闊頁面」模板，可以開一個新檔案叫template-full-width.php，然後喺檔案開頭寫：/* Template Name: 全宽页面 */。保存咗之後，喺WordPress後台編輯頁面嗰陣，就可以喺「頁面屬性」嘅「模板」下拉框度見到同揀到「全闊頁面」喇。
为什么要在functions.php中使用add_action来添加功能？
直接喺functions.php中編寫函數代碼可能會喺錯誤嘅時間執行，導致錯誤或者功能唔生效。使用add_action()或add_filter()將你嘅函數掛載到特定嘅WordPress鈎子上，能夠確保代碼喺正確、安全嘅時機執行。例如，after_setup_theme鈎子用於主題初始化，wp_enqueue_scripts鉤子用於加載資源。呢個係WordPress插件化架構嘅最佳實踐，能夠提高代碼嘅模組化同兼容性。
點樣令我嘅主題支援多語言翻譯？
要令主題支援多語言需要完成幾個步驟。首先，喺style.css嘅頭部同所有模板檔案入面使用__()、_e()等翻譯函數嚟包住所有需要翻譯嘅文本字符串。其次，喺functions.php入面用load_theme_textdomain()用函數嚟載入翻譯檔案。最後，用好似Poedit呢類工具，由源代碼度抽取出字串生成.pot檔案，並請翻譯員跟住整返對應語言（例如zh_CN.po同埋.mo）嘅翻譯檔案。將翻譯檔案放喺主題目錄嘅/languages/資料夾下面就搞掂。
開發商業主題需要注意咩許可同規範？
開發用於分發或銷售嘅商業主題，必須嚴格遵守WordPress嘅許可證要求。最核心嘅一點係，你嘅主題必須採用同WordPress核心相同嘅GPL v2或更高版本許可證。即係話其他人有權對你嘅主題代碼進行使用、修改同再分發。其次，應該遵循WordPress官方嘅編碼標準同主題審查規範，確保代碼質量、安全性同兼容性。另外，正確聲明所有使用嘅第三方資源（例如字體、圖標庫）嘅許可，並確保佢哋都係GPL兼容或獲得咗商業授權，呢一點至關重要。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。