WordPress 主題係網站外觀同功能嘅基石。透過自己開發主題，開發者可以擺脫預設主題嘅限制，實現完全客製化嘅網站設計，並且喺呢個過程入面深入理解 WordPress 嘅核心架構。本文旨在為你構建一條清晰嘅學習路徑，由基本概念到實戰開發，系統噉掌握 WordPress 主題開發嘅精髓。
WordPress主題開發基礎
要成功開發一個 WordPress 主題，首先需要理解佢嘅基本結構同核心概念。一個主題本質上係一個位於 /wp-content/themes/ 目錄底下嘅資料夾，其中包含咗一系列特定檔案。
主題嘅核心檔案構成
每個 WordPress 主題都必須具備一啲基礎檔案。其中，最重要嘅兩個係 style.css 同埋 index.php。
推薦閱讀 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
*/index.php 係模板層級入面嘅預設後備檔案。如果其他更具體嘅模板檔案（例如 single.php）唔存在，WordPress就會退而求其次用返佢。佢係成個主題顯示邏輯嘅起點。
理解模板層級同模板檔案
WordPress 採用模板層級系統來決定針對唔同嘅頁面請求使用邊個模板檔案嚟呈現內容。例如，當用戶訪問一篇博客文章時，WordPress 會按順序搵：single-post-{id}.php -> single-post.php -> single.php -> singular.php -> index.php。掌握呢個層級關係，先至知道喺咩位置創建咩檔案嚟精確控制頁面顯示。
主題函數檔案嘅作用
functions.php 係主題嘅「大腦」。佢唔係一個直接顯示畀用戶嘅模板，而係一個喺主題初始化時自動載入嘅 PHP 檔案。你可以喺呢度加主題支援功能、註冊菜單同側邊欄、引入腳本同樣式檔案，以及定義各種自訂功能。
主題模板檔案嘅開發實戰
了解咗基本結構之後，我哋可以開始構建一個符合現代WordPress開發標準嘅基礎主題。我哋會由創建佈局同整合WordPress核心功能開始。
推薦閱讀 從零開始：打造一個搜尋引擎友好嘅專業WordPress主題。
構建基礎主題框架
首先，喺你嘅 /wp-content/themes/ 目錄下開一個新資料夾，例如 mytheme。然後創建上面提到嘅 style.css 同埋 index.php 文件。喺 index.php 喺度，我哋引入 WordPress 嘅核心函數嚟攞頭部、內容區同埋頁腳。
一個簡單嘅 index.php 開頭結構可以咁樣寫：
<?php get_header(); ?>
<main id="main-content">
<?php
if ( have_posts() ) :
while ( have_posts() ) : the_post();
// 文章内容输出将在这里
the_content();
endwhile;
else :
echo '<p>没有找到任何内容。</p>';
endif;
?>
</main>
<?php get_footer(); ?>呢段代碼調用咗 get_header() 同埋 get_footer() 函數，即係話我哋需要創建對應嘅 header.php 同埋 footer.php 文件，將網站嘅公共頭部同頁腳部分分離出嚟，實現代碼重用。
創建頭部同頁腳文件
在 header.php 入面，你需要包含HTML文檔嘅起始部分、必要嘅元標籤、引入樣式，同埋調用關鍵嘅WordPress函數例如 wp_head()。
<!DOCTYPE html>
<html no numeric noise key 1007>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<?php wp_head(); ?>
</head>
<body no numeric noise key 1004>
<?php wp_body_open(); ?>
<header id="site-header">
<h1><a href="/yue/</?php echo esc_url( home_url( '/' ) ); ?>"><?php bloginfo( 'name' ); ?></a></h1>
<p><?php bloginfo( 'description' ); ?></p>
</header>footer.php 通常就包含頁腳內容，同埋調用 wp_footer() 函數，呢個係好多外掛同 WordPress 核心腳本載入嘅必要掛鉤。
實現導航選單同側邊欄
一個完整嘅網站需要導航選單。首先，喺 functions.php 入面用 register_nav_menus() 函數註冊菜單位置。
推薦閱讀 點樣從零開始建立一個專業嘅WordPress主題：完整開發指南。
function mytheme_setup() {
register_nav_menus( array(
'primary' => __( '主导航菜单', 'mytheme' ),
) );
}
add_action( 'after_setup_theme', 'mytheme_setup' );跟住，喺 header.php 嘅合適位置，使用 wp_nav_menu() 用函數嚟顯示呢個菜單。
側邊欄（小工具區域）嘅註冊都差唔多，透過 register_sidebar() 函數實現，同埋喺模板檔案入面用 dynamic_sidebar() 嚟調用。
主題功能同樣式嘅增強
當基礎頁面能夠正確顯示之後，下一步係增強主題嘅功能同自訂能力，等佢更加專業、更加易用。
加入主題功能支援
現代 WordPress 主題需要聲明對某啲功能嘅支援。例如，為咗使用特色圖像（文章縮圖），你需要喺 functions.php 入面加返主題支援聲明。
add_theme_support( 'post-thumbnails' );
// 还可以添加其他支持，如自定义Logo、标题标签等
add_theme_support( 'title-tag' );
add_theme_support( 'custom-logo' );正確載入腳本同樣式
為咗效能最佳實踐同避免衝突，千祈唔好直接喺模板檔案入面用 <link> 或 <script> 標籤引入資源。應該用 wp_enqueue_style() 同埋 wp_enqueue_script() 函數，同埋透過 wp_enqueue_scripts 鉤仔嚟加載。
function mytheme_scripts() {
// 引入主题的主样式表
wp_enqueue_style( 'mytheme-style', get_stylesheet_uri() );
// 引入自定义的JavaScript文件
wp_enqueue_script( 'mytheme-navigation', get_template_directory_uri() . '/js/navigation.js', array(), null, true );
}
add_action( 'wp_enqueue_scripts', 'mytheme_scripts' );用循環顯示文章列表
“「循環」係WordPress入面用嚟從數據庫攞同顯示文章嘅核心理念。喺主頁或者歸檔頁，我哋通常需要顯示文章列表。呢個可以喺模板檔案（例如 home.php 或 archive.php）入面構建循環嚟實現，用啲函數好似 the_title()、the_excerpt()、the_permalink() 嚟輸出每篇文章嘅標題、摘要同連結。
進階主題開發技巧
掌握咗基礎之後，一啲進階技巧可以令你嘅主題更加有競爭力同易維護。
建立自訂頁面範本
頁面模板容許你為特定頁面賦予獨特嘅佈局。例如，整一個「全闊頁面」模板。只需要喺一個 PHP 檔案頂部加啲特定格式嘅註解，就可以將佢註冊做頁面模板。
<?php
/**
* Template Name: 全宽页面模板
* Description: 一个没有侧边栏的全宽页面模板
*/
get_header(); ?>
// ... 自定义的页面结构，不使用 get_sidebar() ...
<?php get_footer(); ?>跟住喺WordPress後台編輯頁面嘅時候，就可以喺「頁面屬性」度揀呢個模板。
實現子主題機制
如果你要修改一個現有主題（尤其係父主題），最好嘅做法係創建一個子主題。子主題只包含自定義嘅 style.css 同必要嘅模板文件，佢會繼承父主題嘅所有功能。喺你嘅子主題 style.css 入面，用 Template: 聲明嚟指定父主題嘅目錄名。咁樣確保咗父主題更新嗰陣，你嘅定制化修改唔會被覆蓋。
遵循 WordPress 編碼標準
為咗代碼嘅清晰同可維護性，建議跟從 WordPress 官方制定嘅 PHP、CSS、JavaScript 編碼標準。呢啲包括使用正確嘅縮進、括號位置、命名約定（函數同變數使用細楷字母加底線）等等。用類似 WordPress 官方主題（例如 Twenty Twenty-Four）嘅結構做參考係個好習慣。
摘要
WordPress 主題開發係由理解基礎檔案結構開始，逐步深入到模板層級、函數整合同自訂功能嘅過程。透過系統性咁建立 header.php、footer.php、functions.php 等核心檔案，並利用循環、掛鉤函數同主題支援功能，開發者可以構建出功能完整、代碼規範嘅專業主題。關鍵在於動手實踐，由一個最簡單嘅主題框架開始，逐步添加功能，最終你將能夠創建出完全符合項目需求嘅定制化 WordPress 主題。
常見問題
開發 WordPress 主題需要咩先決知識？
你需要有 HTML 同 CSS 嘅基礎知識，用嚟構建頁面結構同樣式。同時，PHP 基礎係必須嘅，因為 WordPress 核心同模板檔案都係用 PHP 編寫嘅。對 JavaScript 有基本了解有助增加前端互動功能。
咩係必需嘅 WordPress 主題檔案？
一個能被 WordPress 識別嘅最基礎主題，只需要兩個檔案：style.css（包含正確嘅主題資訊註釋標頭）同埋 index.php。不過，一個功能實用嘅主題通常仲會包括 functions.php、header.php、footer.php 同 page.php、single.php 等模板檔案。
點樣為我嘅主題加入選單功能？
首先，你需要喺主題嘅 functions.php 檔案入面用 register_nav_menus() 函數嚟註冊一個或多個菜單位置。然後，喺相應嘅模板檔案（如 header.php）入面，使用 wp_nav_menu() 函數並指定註冊嘅位置嚟輸出菜單。最後，用戶可以喺 WordPress 後台嘅「外觀 -> 菜單」介面中創建菜單並分配到該位置。
子主題同父主題有咩分別？
父主題係一個完整、獨立嘅功能主題。子主題就依賴於某個特定嘅父主題，佢只包含你想修改或添加嘅檔案（如 style.css、覆蓋嘅模板檔案）。當子主題啟動時，佢會優先載入自己嘅檔案，未提供嘅檔案就從父主題調用。使用子主題係安全噉樣定制同修改現有主題嘅推薦方式，可以確保父主題更新時自訂部分得以保留。
點樣為文章列表加「閱讀更多」連結？
喺文章循環入面，當你用 the_excerpt() 函數輸出摘要時，WordPress 會自動生成一個指向全文嘅「閱讀更多」連結。如果你想喺使用 the_content() 可以手動控制截斷位置，喺文章編輯器入面插入「更多」標籤，或者喺模板度用 the_content( ‘继续阅读’ ) 函數，參數就係自訂嘅連結文字。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。