WordPress主題係網站外觀同功能嘅核心。同用現成主題唔同，自己開發主題可以帶嚟完全嘅控制權、更高嘅性能同埋更貼合項目需求嘅定制化體驗。呢個指南會帶你系統性咁理解同實踐點樣由零開始建立一個專業、標準、可擴展嘅WordPress主題。
開發環境同工具準備
喺開始寫第一行程式碼之前，一個高效嘅開發環境係好重要嘅。
本地伺服器環境搭建
推薦用集成嘅本地伺服器軟件，例如 Local by Flywheel、XAMPP 或者 MAMP。呢類工具一鍵安裝 Apache/Nginx、PHP 同 MySQL，並且模擬線上伺服器環境。核心要求係 PHP 版本唔低過 7.4，MySQL 版本唔低過 5.6。
推薦閱讀 由入門到精通：打造專業級WordPress主題嘅完整開發指南。
代碼編輯器同開發工具
揀一個功能強大嘅代碼編輯器，好似 Visual Studio Code、PhpStorm 或者 Sublime Text。VS Code 憑住佢豐富嘅插件生態（例如 PHP Intelephense、WordPress Snippet、Live Server）成為咗好多開發者嘅首選。
確保安裝同啟動瀏覽器嘅開發者工具，用嚟實時除錯 HTML、CSS 同 JavaScript。
版本控制系統
由項目一開始就用 Git 做版本控制。喺代碼根目錄初始化一個 Git 倉庫，並且連接到 GitHub、GitLab 或者 Bitbucket 呢啲遠程倉庫。咁樣唔單止方便管理代碼，亦都為團隊協作同將來嘅部署打好基礎。
主題檔案結構同核心檔案
一個標準嘅 WordPress 主題會跟返特定嘅目錄同檔案結構。主題資料夾通常喺 /wp-content/themes/your-theme-name/。
主題必需檔案
每個主題必須包含兩個最基礎嘅檔案：style.css 同埋 index.php。其中，style.css 唔單止係樣式表，佢頂部嘅註解區塊更加係主題嘅「身份證」，用嚟向WordPress系統聲明主題資訊。
推薦閱讀 從零到一：WordPress主題開發終極指南與實踐教程。
/*
Theme Name: 我的专业主题
Theme URI: https://example.com/my-theme
Author: 你的名字
Author URI: https://example.com
Description: 一个由零开始构建的专业WordPress主题。
Version: 1.0.0
License: GPL v2 or later
Text Domain: my-professional-theme
*/index.php 係主題嘅預設模板檔案，亦都係所有頁面嘅最後備選。一個最簡單嘅 index.php 可以只包含調用博客文章嘅循環。
模板層級與常用模板文件
WordPress 使用模板層級嚟決定特定頁面用邊個模板文件。理解呢個機制係主題開發嘅關鍵。你需要逐步建立以下核心模板文件：
* header.php：網站頭部，包含 <!DOCTYPE html>、<head> 區域同頁面頂部公共部分。
* footer.php: 網站底部，包含版權資訊、腳本引入等。
* functions.php: 主題嘅「大腦」，用嚟添加功能、註冊菜單、側邊欄，引入腳本同樣式。
* page.php: 用嚟顯示單個頁面。
* single.php: 用嚟顯示單篇博客文章。
* archive.php: 用嚟顯示分類、標籤、作者等歸檔頁面。
* front-page.php: 當設定為靜態首頁時，呢個檔案會做網站嘅首頁。
* style.css: 主樣式表。
喺主模板檔案入面，用 get_header()、get_footer()、get_sidebar() 等函數嚟模組化噉引入呢啲部分。
核心功能同主題選項
透過 functions.php 文件，你可以為你嘅主題注入強大嘅功能。
添加主題支援功能
使用 add_theme_support() 函數嚟聲明主題支援嘅核心功能。例如，啟用文章縮圖、自訂標誌、HTML5 標記支援等。
function my_theme_setup() {
// 启用文章和页面特色图像
add_theme_support( 'post-thumbnails' );
// 启用自定义徽标
add_theme_support( 'custom-logo', array(
'height' => 100,
'width' => 400,
'flex-height' => true,
'flex-width' => true,
) );
// 启用 HTML5 对表单、搜索表单、评论列表等的支持
add_theme_support( 'html5', array( 'search-form', 'comment-form', 'comment-list', 'gallery', 'caption' ) );
// 添加标题标签支持
add_theme_support( 'title-tag' );
}
add_action( 'after_setup_theme', 'my_theme_setup' );註冊選單同側邊欄
WordPress 容許用戶透過後台管理菜單同小工具。你需要首先喺 functions.php 入面註冊佢哋。
推薦閱讀 WordPress主題開發完全指南：由入門到精通嘅實戰教學。
註冊導航選單使用 register_nav_menus() 函數：
register_nav_menus( array(
'primary' => __( '主导航菜单', 'my-professional-theme' ),
'footer' => __( '页脚菜单', 'my-professional-theme' ),
) );然後喺 header.php 或 footer.php 入面用 wp_nav_menu() 函數調用
註冊小工具區域（側邊欄）使用 register_sidebar() 函數：
register_sidebar( array(
'name' => __( '主侧边栏', 'my-professional-theme' ),
'id' => 'sidebar-1',
'description' => __( '在此添加小工具。', 'my-professional-theme' ),
'before_widget' => '<section id="%1$s" class="widget %2$s">',
'after_widget' => '</section>',
'before_title' => '<h2 class="widget-title">',
'after_title' => '</h2>',
) );喺模板中使用 dynamic_sidebar( 'sidebar-1' ) 嚟顯示。
安全引入腳本同樣式
千祈唔好直接喺模板檔案入面硬編碼引入 CSS 同 JS 檔案。應該使用 wp_enqueue_scripts 用鈎子安全噉排隊加載。
function my_theme_scripts() {
// 引入主题主样式表
wp_enqueue_style( 'my-theme-style', get_stylesheet_uri(), array(), '1.0.0' );
// 引入自定义 JavaScript 文件
wp_enqueue_script( 'my-theme-script', get_template_directory_uri() . '/js/main.js', array( 'jquery' ), '1.0.0', true );
}
add_action( 'wp_enqueue_scripts', 'my_theme_scripts' );模板標籤同循環
WordPress 嘅核心功能係動態顯示內容，而呢個主要靠模板標籤同「循環」實現。
理解主循環
“「循環」係 WordPress 用嚟喺數據庫度攞內容同埋喺頁面顯示嘅 PHP 代碼。佢嘅基本結構如下：
<!-- 在这里显示每篇文章的内容 -->
<h2><?php the_title(); ?></h2>
<div><?php the_content(); ?></div>
<p><?php _e( '抱歉，没有找到任何内容。', 'my-professional-theme' ); ?></p>
<?php endif; ?>呢個循環會出現喺 index.php、archive.php、single.php 等幾乎所有顯示內容嘅模板度。
常用模板標籤
模板標籤係用嚟輸出特定內容嘅 PHP 函數。例如：
* the_title()： 輸出文章/頁面標題。
* the_content()： 輸出文章/頁面主要內容。
* the_excerpt()： 輸出文章摘要。
* the_permalink()：攞文章或者頁面嘅永久連結。
* the_post_thumbnail()：輸出文章特色圖片。
* the_category()：輸出文章所屬分類。
* comments_template()：引入評論模板。
自訂查詢同循環
有時你需要顯示主循環之外嘅內容，例如喺首頁顯示一個特定分類嘅文章列表。呢個時候你需要創建自定義嘅 WP_Query 循環。
<?php
$custom_query = new WP_Query( array(
'category_name' => 'featured',
'posts_per_page' => 3,
) );
if ( $custom_query->have_posts() ) :
while ( $custom_query->have_posts() ) : $custom_query->the_post();
// 显示每篇精选文章
endwhile;
wp_reset_postdata(); // 重置全局 $post 数据
endif;
?>摘要
從零開始開發一個WordPress主題係一個系統性嘅工程，佢要求開發者唔單止要掌握PHP、HTML、CSS同JavaScript等前端技術，更要深入理解WordPress嘅核心架構，例如模板層級、鈎子機制同數據庫查詢。通過搭建專業開發環境、構建標準嘅文件結構、喺 functions.php 中穩健地添加功能、並熟練運用模板標籤同循環，你將能夠創造出完全符合設計需求、性能優異且易於維護嘅專業級主題。呢個過程雖然有一定學習曲線，但帶來嘅靈活性、控制力同技能提升係使用現成主題無法比擬嘅。記住，遵循WordPress編碼標準同最佳實踐，係確保你嘅主題安全、兼容且面向未來嘅關鍵。
常見問題
開發WordPress主題需要邊啲編程語言基礎？
開發WordPress主題主要需要PHP、HTML、CSS同JavaScript嘅基礎知識。PHP用於處理邏輯同動態內容；HTML負責頁面結構；CSS控制樣式同佈局；JavaScript就用於實現交互效果。對MySQL有基本了解都有助於理解數據查詢。
主題嘅 functions.php 檔案有咩作用？
functions.php 呢個檔案係主題功能嘅核心。佢用嚟增加或者修改主題嘅功能，例如註冊選單同埋側邊欄、增加主題功能支援（好似特色圖片）、安全噉引入CSS同埋JavaScript腳本、定義自訂函數，同埋透過WordPress鉤子（Hooks）嚟擴展或者修改核心行為。
點樣令我嘅主題支援多語言？
令主題支援多語言（國際化i18n）主要涉及兩個步驟。首先，喺 functions.php 度載入主題文字域，用 load_theme_textdomain( 'my-theme', get_template_directory() . '/languages' )。其次，喺主題嘅所有PHP檔案入面，將所有需要翻譯嘅字串用 __( '文本', 'my-theme' ) 或 _e( '文本', 'my-theme' ) 函數包住。之後，可以用Poedit呢類工具產生 .po 同埋 .mo 翻譯檔案。
開發完成之後，點樣測試我嘅主題？
主題開發完成之後，需要進行全面測試。包括：喺唔同瀏覽器（Chrome、Firefox、Safari、Edge）同唔同設備尺寸（響應式設計）上面進行外觀測試；使用WordPress除錯模式（喺 wp-config.php 度設定 define( 'WP_DEBUG', true );）用嚟搵PHP錯誤、警告同通知；用插件好似WP Theme Check咁檢查主題係咪符合WordPress官方標準；同測試晒所有功能，例如表單提交、菜單、小工具、分頁、留言等等。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。