理解WordPress主題嘅基本結構同核心檔案
一個自訂WordPress主題本質上係一個包含特定檔案嘅資料夾，佢位於/wp-content/themes/目錄下。呢啲檔案跟從WordPress嘅模板層級系統，一齊決定咗網站點樣將資料庫入面嘅內容（例如文章、頁面）呈現畀訪客。理解呢啲檔案嘅角色同埋佢哋之間嘅協作方式係開發嘅第一步。
主題嘅必需檔案同目錄結構
每個WordPress主題都必須包含兩個核心檔案：style.css 同埋 index.php。其中，style.css 嘅作用尤其關鍵，佢唔單止係定義主題樣式嘅CSS檔案，佢檔案頭部嘅註解區塊更加係WordPress識別主題嘅「身份證」。呢個註解區塊必須嚴格跟從特定格式。
/*
Theme Name: 我的自定义主题
Author: 开发者名称
Description: 这是一个用于演示如何从零开发的自定义WordPress主题。
Version: 1.0.0
Text Domain: my-custom-theme
*/index.php 係主題嘅主模板檔案，亦都係模板層級中嘅最後一道防線。當WordPress無法為當前請求搵到更具體嘅模板檔案（例如single.php或page.php）嗰陣，就會返轉頭用index.php。所以，一個穩健嘅主題必須要有呢個檔案。
推薦閱讀 構建專業網站：從零開始創建自訂WordPress主題嘅完整指南。
模板層級同模板檔案嘅作用
WordPress 嘅模板層級係一套智能嘅模板選擇規則。佢根據用戶訪問嘅頁面類型（例如首頁、文章頁、分類頁）自動揀選最匹配嘅模板文件。例如，當訪問一篇單獨嘅文章時，WordPress 會跟以下順序搵：single-post-{slug}.php -> single-post-{id}.php -> single.php -> singular.php -> 最後先係 index.php。
除咗上述兩個必需文件，一個功能完整嘅主題通常仲包括：
* header.php：定義文檔頭部，包含<head>區、網站 Logo 同主導航。
* footer.php: 定義文檔頁腳，包含版權資訊、輔助連結等。
* functions.php: 呢個係主題嘅「大腦」，用嚟加載腳本樣式、註冊選單同小工具、定義主題支援功能等。
* single.php：用嚟顯示單篇文章。
* page.php：用嚟顯示單一頁面。
建構主題嘅核心功能同模板
建立咗基礎文件結構之後，下一步係填充呢啲模板文件嘅內容，同埋利用WordPress嘅核心函數同「主循環」嚟動態輸出數據。
喺functions.php度初始化主題功能
functions.php 文件係擴展主題功能嘅中心。你可以喺呢度加各種功能，而唔使改WordPress核心文件。一個標準嘅初始化過程包括設定主題支援、登記導航選單同小工具區域、同埋安全咁載入腳本同樣式表。
<?php
// 主题初始化设置
function mytheme_setup() {
// 让WordPress管理<title>标签
add_theme_support( 'title-tag' );
// 启用文章特色图像（缩略图）支持
add_theme_support( 'post-thumbnails' );
// 添加对HTML5标记的支持
add_theme_support( 'html5', array( 'search-form', 'comment-form', 'comment-list', 'gallery', 'caption' ) );
// 注册一个主菜单位置
register_nav_menus( array(
'menu-1' => esc_html__( '主菜单', 'my-custom-theme' ),
) );
}
add_action( 'after_setup_theme', 'mytheme_setup' );
// 注册小工具侧边栏
function mytheme_widgets_init() {
register_sidebar( array(
'name' => esc_html__( '侧边栏', 'my-custom-theme' ),
'id' => 'sidebar-1',
'description' => esc_html__( '在此添加小工具。', 'my-custom-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(), array(), '1.0.0' );
// 加载导航脚本（如果有的话）
wp_enqueue_script( 'mytheme-navigation', get_template_directory_uri() . '/js/navigation.js', array(), '1.0.0', true );
}
add_action( 'wp_enqueue_scripts', 'mytheme_scripts' );
?>用主循環（The Loop）輸出內容
“「主循環」係WordPress模板入面最核心嘅概念，佢係一段用嚟檢查同遍歷當前頁面需要顯示嘅文章（或頁面）嘅PHP代碼。幾乎所有內容展示模板都依賴佢。下面係一個喺index.php入面用主循環嘅簡單例子：
推薦閱讀 WordPress主題開發入門指南：從零到一構建自訂主題。
<?php if ( have_posts() ) : ?>
<div class="posts-container">
<?php while ( have_posts() ) : the_post(); ?>
<article no numeric noise key 1009>
<h2 class="entry-title">
<a href="/yue/</?php the_permalink(); ?>"><?php the_title(); ?></a>
</h2>
<div class="entry-meta">
发布于：
</div>
<div class="entry-summary">
<?php the_excerpt(); ?>
</div>
</article>
<?php endwhile; ?>
</div>
<p><?php esc_html_e( '很抱歉，没有找到符合条件的内容。', 'my-custom-theme' ); ?></p>
<?php endif; ?>呢段代碼入面，have_posts()同埋the_post()函數控制循環，而the_title()、the_permalink()、the_excerpt()等模板標籤就用於輸出具體內容。
實現響應式設計同高級主題功能
一個現代化主題唔單止要求功能齊全，仲必須提供優秀嘅用戶體驗，呢個包括喺唔同設備上都顯示得好，同可以透過靈活嘅方式滿足個人化需求。
集成響應式佈局同流動端優化
確保你嘅主題係響應式嘅，呢個需要從HTML同CSS兩方面著手。首先，喺header.php檔案嘅<head>區域內，確保包含視口元標籤：
<meta name="viewport" content="width=device-width, initial-scale=1">其次，喺你嘅style.css中，使用媒體查詢（Media Queries）嚟根據屏幕寬度調整佈局同樣式。例如，為移動裝置隱藏側邊欄：
@media screen and (max-width: 768px) {
#secondary-sidebar {
display: none;
}
.site-main {
width: 100%;
}
}創建自訂頁面模板同子主題
為咗滿足單一頁面嘅獨特佈局需求，WordPress 容許你創建自訂頁面模板。例如，你可以創建一個冇側邊欄嘅全寬頁面模板，命名為template-fullwidth.php，並喺檔案開頭加以下註釋：
<?php
/**
* Template Name: 全宽页面模板
* Description: 一个没有侧边栏的页面模板。
*/然後，喺 WordPress 後台編輯頁面時，就可以喺「頁面屬性」中選擇呢個「全寬頁面模板」。
推薦閱讀 WordPress主題開發完全指南：從零到一構建自訂網站。
為咗保護你嘅自訂修改喺父主題更新時唔會被覆蓋，強烈建議使用子主題進行開發。子主題只需包含一個style.css同一個可選嘅functions.php。子主題嘅style.css頭部必須聲明父主題：
/*
Theme Name: 我的子主题
Template: parent-theme-folder-name
*/主題嘅國際化、優化同發佈準備
開發接近尾聲時，你需要確保主題易於俾世界各地嘅用戶使用，並且具備良好嘅性能，最後做好發佈嘅準備。
實現主題嘅國際化（i18n）
國際化係令你嘅主題能夠翻譯成其他語言嘅過程。喺WordPress入面，主要係透過兩個函數實現：__()用嚟返回翻譯後嘅字符串，_e()用嚟直接輸出翻譯後嘅字串。你需要喺所有需要翻譯嘅文本處使用佢哋，並指定喺style.css頭部定義嘅文本域（Text Domain）。
<h2><?php esc_html_e( '最新文章', 'my-custom-theme' ); ?></h2>
<p><?php echo esc_html__( '这是一段示例文本。', 'my-custom-theme' ); ?></p>跟住，可以用好似Poedit呢類工具嚟整.pot翻譯模板檔案同埋具體嘅語言包（例如.zh_CN.po同埋.mo檔案）。
進行性能優化同代碼審查
喺發佈之前，應該對主題做性能優化。呢樣包括：壓縮CSS同JavaScript檔案、確保圖片尺寸啱數而且已經優化、減少數據庫查詢次數、同埋正確使用WordPress嘅腳本/樣式排隊系統，避免直接喺模板度引入資源。同時，做一次全面嘅代碼審查，確保跟咗WordPress嘅編碼標準，冇留低調試代碼，而且所有功能都係按預期咁運作。
摘要
由零開始開發一個自訂WordPress主題係一個系統性嘅學習過程，佢涵蓋咗由理解核心檔案結構、運用模板層級同主迴圈，到喺functions.php中集成功能、实现响应式设计，再到最终嘅国际同优化。跟住「从简单开始，逐步迭代」嘅原则，先构建一个最细可用嘅主题，然后不断加新嘅模板文件同功能。熟练掌握咗呢啲技能之后，你就能够创建出完全符合自己或者客户需求嘅独特网站，而唔再受限于现有主题嘅制约。记住，官方文档同开发者社区系你学习路上最好嘅伙伴。
常見問題
开发WordPress主题需要好深嘅PHP知识吗？
需要扎实嘅PHP基础，但唔使系专家级别。你需要明PHP语法、变量、数组、函数同循环结构，因为WordPress模板主要系由PHP代码构成嘅。最关键系学识用WordPress提供嘅大量内置函数（模板标签）同钩子（动作同过滤器），呢啲系连接你嘅主题同WordPress核心功能嘅桥梁。
點解我嘅自訂主題喺後台唔顯示？
最常見嘅原因係style.css文件头嘅注释格式唔啱或者信息缺失。请务必仔细检查Theme Name、Author等字段系咪有填，而且格式完全正确。另一个原因系主题文件夹摆咗喺错误嘅目录，佢必须摆喺wp-content/themes/之下。
點樣可以令我嘅主題支援古騰堡（Gutenberg）編輯器？
為咗令你嘅主題更加適合古騰堡編輯器，你需要喺functions.php入面加入對應嘅主題支援聲明。呢啲包括支援闊對齊、編輯器嘅樣式表等等。例如：
add_theme_support( 'align-wide' ); // 支持宽和全宽对齐
add_theme_support( 'editor-styles' );
add_editor_style( 'style-editor.css' ); // 加载一个用于编辑器的专属样式表另外，為一啲核心區塊（好似段落、標題、按鈕）編寫前端樣式，確保佢哋喺網站前台同編輯器入面睇落一致。
我應該點樣測試我嘅主題？
測試應該多角度進行。首先，喺唔同瀏覽器（例如Chrome、Firefox、Safari、Edge）同唔同尺寸嘅裝置（手機、平板、桌面電腦）上檢查外觀同功能。其次，測試同常用插件嘅兼容性。再次，使用WordPress內置嘅「主題單元測試」數據（XML檔案）匯入大量唔同類型嘅內容，以檢查主題喺各種極端情況下嘅表現。最後，開啟WP_DEBUG模式，檢查有冇任何PHP警告或錯誤。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。