WordPress主題嘅構成同核心概念
喺開始寫程式之前，理解WordPress主題嘅基本構成同運作原理係好緊要。一個主題本質上係喺 wp-content/themes/ /wp-content/themes/ 目錄下嘅一組檔案，佢負責控制網站嘅前端展示，而內容就動態儲存喺資料庫入面。
一個最基本嘅主題淨係需要兩個檔案：index.php 同埋 style.css。其中，style.css 主題嘅頭部註釋唔單止定義咗樣式，仲包含主題嘅元數據，例如主題名稱、作者、描述等等，呢啲資訊會喺WordPress後台嘅主題管理頁面顯示。以下係一個典型例子 style.css 頭部示例：
/*
Theme Name: 我的第一款主题
Theme URI: https://example.com/my-first-theme
Author: 开发者姓名
Author URI: https://example.com
Description: 这是一个用于学习的简单WordPress主题。
Version: 1.0
License: GNU General Public License v2 or later
Text Domain: my-first-theme
*/除咗基礎檔案，主題通常包含一系列模板檔案。核心嘅模板檔案包括 header.php（網頁頭部）、footer.php（網頁底部）、sidebar.php（側邊欄）同埋 single.php（單篇文章頁）。通過使用 get_header()， get_footer()， get_sidebar() 等函數，可以喺其他模板度引入呢啲公共部分，實現代碼重用。
推薦閱讀 由零開始：掌握WordPress主題開發嘅核心流程同最佳實踐。
WordPress跟從模板層級機制。當訪問一個頁面嗰陣，系統會按照特定嘅層級順序搵最匹配嘅模板檔案。例如，對於一篇博客文章，WordPress會優先搵 single-post-{id}.php，其次係 single-post.php，跟住係 single.php，最後先係萬能嘅 index.php。理解呢個層級係創建靈活主題嘅關鍵。
函数文件嘅作用
每一個強大嘅主題背後，通常都有一個活躍嘅 functions.php 文件。呢個文件唔係模板文件，而係主題嘅「功能增強器」。佢允許開發者喺主題激活時添加自定義功能，而唔使修改核心文件。喺呢度，你可以註冊菜單、側邊欄，添加主題支援嘅功能（例如文章縮略圖），以及排隊引入樣式表同JavaScript腳本。
主題透過 add_theme_support() 函數聲明其對WordPress核心功能嘅支援。例如，啟用文章特色圖片功能只需一行代碼：add_theme_support( 'post-thumbnails' );。另一個關鍵函數係 register_nav_menus()，佢用喺後台「外觀」->「菜單」度註冊可用嘅導航菜單位置，好似 register_nav_menus( array( 'primary' => '主导航菜单' ) );。
開發環境搭建同基本檔案結構
工欲善其事，必先利其器。一個高效嘅本地開發環境可以極大提升開發效率同調試體驗。推薦使用軟件如Local by Flywheel、MAMP Pro或者Laragon，佢哋能夠快速喺本地電腦上配置好PHP、MySQL同網頁伺服器。
代碼編輯器或者集成開發環境（IDE）嘅選擇都好緊要。Visual Studio Code、PhpStorm或者Sublime Text等都係優秀嘅選擇，佢哋對PHP、HTML、CSS、JavaScript同WordPress函數有良好嘅語法高亮、代碼提示同片段支援。另外，安裝本地調試工具如Xdebug可以幫你深入追蹤代碼執行過程。
推薦閱讀 WordPress主題開發實戰教學：從零開始打造現代化響應式主題。
創建主題文件夾同核心文件
首先，喺 wp-content/themes/ 目錄下創建一個新嘅文件夾，名稱應該使用細楷字母、數字同連字號，例如 my-custom-theme。進入呢個資料夾，建立以下基礎檔案：style.css（包含頭部註釋）、index.php（主模版）、functions.php（可以留空）同埋 header.php 及 footer.php。
index.php 文件可以作為一個簡單嘅起點，用於引入頭部同尾部，並開始主循環。
<?php get_header(); ?>
<main id="primary" class="site-main">
<?php
if ( have_posts() ) :
while ( have_posts() ) :
the_post();
// 文章内容显示在这里
the_title( '<h1>', '</h1>' );
the_content();
endwhile;
else :
echo '<p>暂无内容。</p>';
endif;
?>
</main>
<?php get_footer(); ?>主題模板開發與動態內容調用
WordPress主題嘅核心係模板系統，佢決定咗唔同類型嘅內容點樣呈現。動態內容主要透過WordPress模板標籤同「循環」嚟調用。
理解主循環
“「循環」係WordPress用嚟從數據庫度攞文章數據並顯示喺頁面上嘅核心機制。佢用全局變量例如 $post 嚟設定當前文章嘅數據。一個典型嘅循環結構係咁樣：
<?php if ( have_posts() ) : ?>
<?php while ( have_posts() ) : the_post(); ?>
<?php the_title(); ?>
<?php the_content(); ?>
<?php the_author(); ?>
<?php endwhile; ?>
<?php endif; ?>喺循環內部，你可以用一啲以「the_」開頭嘅模板標籤嚟輸出文章資訊，例如 the_title()， the_content()， the_excerpt()， the_permalink()， the_post_thumbnail() 等等。呢啲函數會自動輸出經過格式同轉義嘅內容。
建立自訂頁面範本
除咗標準模板，你可以為特定頁面創建自定義模板。方法係喺一個PHP文件嘅最頂部加返特定嘅註釋塊。例如，創建一個叫做「全寬頁面」嘅模板：
推薦閱讀 WordPress主題開發從入門到實戰：全面掌握核心技術與設計模式。
<?php
/**
* Template Name: 全宽页面
* Description: 一个没有侧边栏的页面模板。
*/
get_header();
?>
<!-- 自定义页面内容结构 -->
<main class="full-width">
<?php the_content(); ?>
</main>
<?php get_footer(); ?>建立之後，呢個模板會喺頁面編輯器嘅「頁面屬性」->「模板」下拉式選單度出現，俾用戶揀選。
為你嘅主題添加樣式與互動
一個冇樣式同互動功能嘅主題係唔完整嘅。現代WordPress主題開發強烈建議將樣式同腳本排隊引入，而唔係直接喺HTML度硬編碼 <link> 或 <script> 標籤。咁樣可以確保依賴關係正確，同埋符合WordPress嘅最佳做法。
正確引入樣式表同腳本
在 functions.php 檔案入面，使用 wp_enqueue_style() 同埋 wp_enqueue_script() 函數嚟加入資源。呢啲操作應該掛載到 wp_enqueue_scripts 呢個鉤子上。
function my_theme_scripts() {
// 引入主样式表
wp_enqueue_style( 'my-theme-style', get_stylesheet_uri(), array(), '1.0' );
// 引入自定义JavaScript文件
wp_enqueue_script( 'my-theme-navigation', get_template_directory_uri() . '/js/navigation.js', array( 'jquery' ), '1.0', true );
// 如果需要，可以引入评论回复脚本
if ( is_singular() && comments_open() && get_option( 'thread_comments' ) ) {
wp_enqueue_script( 'comment-reply' );
}
}
add_action( 'wp_enqueue_scripts', 'my_theme_scripts' );響應式設計同現代CSS
用現代CSS技術，例如Flexbox或者Grid佈局，可以輕鬆整出響應式設計。確保你嘅主題喺手機、平板同桌面裝置上都可以顯示得好好。一個常見嘅做法係喺 <head> 部分（通常透過 wp_head() 輸出）包含視口元標籤，呢個通常喺 header.php 中完成：<meta name="viewport" content="width=device-width, initial-scale=1">。
高級功能：小工具、選單同自訂器整合
為咗令主題更加專業、更加易用，整合WordPress嘅核心功能係好重要嘅。呢個包括小工具區域、導航選單同埋主題自訂器支援。
註冊小工具區域
小工具區域（側邊欄）容許用家透過後台拖放嘅方式加入內容。使用 register_sidebar() 函數嚟註冊。
function my_theme_widgets_init() {
register_sidebar( array(
'name' => '主侧边栏',
'id' => 'sidebar-1',
'description' => '在此添加小工具。',
'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' );註冊後，喺模板文件（如 sidebar.php）入面，使用 dynamic_sidebar( 'sidebar-1' ) 嚟調用佢。
整合主題自訂器
主題自訂器容許用家即時預覽同埋修改主題設定。透過 WP_Customize_Manager 對象，你可以加入設定、控件同區塊。一個簡單嘅例子係加入一個網站標題顏色嘅選項：
function my_theme_customize_register( $wp_customize ) {
// 添加一个设置
$wp_customize->add_setting( 'header_color', array(
'default' => '#333333',
'sanitize_callback' => 'sanitize_hex_color',
) );
// 添加一个颜色控件
$wp_customize->add_control( new WP_Customize_Color_Control( $wp_customize, 'header_color', array(
'label' => '标题颜色',
'section' => 'colors',
'settings' => 'header_color',
) ) );
}
add_action( 'customize_register', 'my_theme_customize_register' );跟住，喺你嘅 style.css 或者行內樣式中，使用 get_theme_mod( 'header_color' ) 嚟輸出呢個值。
摘要
WordPress主題開發係一個結合咗前端技術（HTML、CSS、JavaScript）同後端邏輯（PHP、MySQL、WordPress API）嘅綜合性技能。從理解模板層級同循環開始，到構建文件結構、動態調用內容，再到註冊菜單同小工具、整合自訂器，每一步都旨在創建一個既功能強大又用戶友好嘅網站界面。遵循最佳實踐，例如將腳本同樣式排隊引入、使用子主題進行修改、以及編寫可讀性高嘅代碼，會令你嘅主題更易於維護同擴展。持續學習同實踐，你將能夠打造出專業級嘅WordPress主題。
常見問題
開發 WordPress 主題需要咩基本知識?
開發WordPress主題需要掌握HTML、CSS同PHP嘅基礎知識。對JavaScript有一定嘅了解都會非常有用，特別係用於加入互動功能。此外，熟悉WordPress嘅基本概念，例如文章、頁面、分類法、循環同掛鈎，係必不可少嘅。
點樣可以喺唔影響父主題嘅情況下進行修改？
強烈建議使用子主題嚟對現有主題進行任何修改。創建一個新嘅主題文件夾，入面放一個包含必要頭部註釋嘅 style.css 文件同一個 functions.php 檔案。喺子主題嘅 style.css 入面，用 @import 或者更好嘅方法（喺子主題嘅 functions.php 中排隊引入）嚟繼承父主題嘅樣式。然後，你就可以覆蓋父主題嘅任何模板文件或函數，而父主題嘅更新唔會覆蓋你嘅自定義內容。
乜嘢係鉤子，佢喺主題開發中有咩作用？
鉤仔係WordPress插件API嘅核心組成部分，分為動作鉤同過濾器鉤。動作鉤（例如 wp_enqueue_scripts， wp_head）容許你喺特定時間點插入同執行自己嘅代碼。過濾器鉤（例如 the_title， excerpt_length）容許你修改過程中傳遞嘅數據。喺主題開發度，你主要透過 add_action() 同埋 add_filter() 函數嚟使用佢哋，以添加功能或者更改默認輸出，而唔使直接修改核心檔案。
點樣令我嘅主題支援多語言翻譯？
要令主題支援多語言，你需要做好國際化準備。即係話，喺程式碼入面所有面向用戶嘅字串都應該用WordPress嘅翻譯函數包住，例如 ()， _e()， esc_html() 等等。同時，喺主題嘅 style.css 頭部同 load_theme_textdomain() 調用中正確設定 Text Domain。搞掂之後，你可以用好似Poedit呢類工具嚟建立 .pot 模板文件，翻譯人員可以根據呢個創建唔同語言嘅 .po 同埋 .mo 檔案。
主題開發完成後，點樣準備發佈？
喺發佈主題之前，請務必進行嚴格測試，包括喺唔同瀏覽器、裝置、PHP版本同常用插件嘅兼容性測試。確保跟從WordPress主題審核要求，例如正確清理所有輸出、轉義所有輸入、安全地引入資源等等。清理代碼註釋，壓縮CSS同JavaScript檔案（保留開發版本），並建立一個清晰嘅 readme.txt 檔案。最後，你可以選擇將主題提交到WordPress官方主題目錄，或者喺自己嘅網站提供下載。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。