準備工作同環境搭建
喺開始寫程式碼之前，一個高效嘅本地開發環境係好緊要嘅。我哋推薦使用集成了Apache/Nginx、PHP同MySQL嘅軟件包，例如Local by Flywheel、MAMP或者XAMPP。請確保你嘅PHP版本係7.4或者更高，MySQL版本係5.6或者更高，並推薦使用最新版本嘅WordPress核心代碼。
WordPress主題本質上係一個位於/wp-content/themes/目錄下嘅文件夾，其核心骨架只需要兩個檔案。你需要喺本地環境度創建一個新嘅文件夾，例如my-professional-theme，並喺入面創建第一個關鍵檔案。
創建主題核心配置信息
每個主題都必須有一個style.css檔案，其頭部註釋部分用於向WordPress聲明主題嘅基本資料。呢個檔案名係固定嘅，WordPress會透過讀取其頭部信息嚟識別同列出你嘅主題。
推薦閱讀 掌握WordPress主題開發：由入門到精通嘅完整指南。
/*
Theme Name: My Professional Theme
Theme URI: https://yourwebsite.com/
Author: Your Name
Author URI: https://yourwebsite.com/
Description: 一个用于学习构建的专业级WordPress主题。
Version: 1.0
License: GNU General Public License v2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Text Domain: my-professional-theme
*/Text Domain用於國際化，佢會作為後續翻譯函數調用嘅標識。
創建主題核心啟動檔案
第二個必須嘅檔案係index.php，佢係所有頁面嘅預設後備模板。但更重要嘅啟動文件係functions.php。你需要喺主題目錄下建立呢個檔案，佢係成個主題嘅「大腦」，用嚟引入樣式表、JavaScript腳本、註冊菜單、側邊欄等。
<?php
// 安全措施：防止直接访问文件
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
// 1. 引入样式表和脚本
function my_theme_enqueue_scripts() {
// 引入主样式表
wp_enqueue_style( 'my-theme-style', get_stylesheet_uri() );
// 引入自定义样式
wp_enqueue_style( 'my-theme-custom-style', get_template_directory_uri() . '/assets/css/main.css' );
// 引入JavaScript
wp_enqueue_script( 'my-theme-main-js', get_template_directory_uri() . '/assets/js/main.js', array('jquery'), '1.0', true );
}
add_action( 'wp_enqueue_scripts', 'my_theme_enqueue_scripts' );
?>構建主題模板層次結構
WordPress嘅模板層次結構係其核心設計理念。當訪問一個頁面時，WordPress會按照特定嘅優先級尋找對應嘅模板檔案。理解並建立呢啲關鍵模板檔案係構建靈活主題嘅基礎。
建立網站通用版面佈局範本
header.php同埋footer.php構成咗網站所有頁面嘅頭部同底部。我哋可以透過 get_header() 同埋 get_footer() 函數喺任何範本入面引入佢哋。建立header.php，其中應該包含HTML文檔嘅<head>部分同網站頂部嘅可視區域（例如Logo、導航菜單）。
<!DOCTYPE html>
<html no numeric noise key 1006>
<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 1003>
<header id="masthead" class="site-header">
<div class="site-branding">
<h1 class="site-title"><a href="/yue/</?php echo esc_url( home_url( '/' ) ); ?>"><?php bloginfo( 'name' ); ?></a></h1>
</div>
<nav id="site-navigation" class="main-navigation">
'menu-primary',
'menu_id' => 'primary-menu',
) );
?>
</nav>
</header>footer.php就包含網站底部嘅資訊、腳本引入（透過 wp_footer()）同埋最終嘅閉合標籤。
推薦閱讀 打造專業網站：從零開始構建自訂 WordPress 主題嘅完整指南。
創建文章內容循環同首頁模板
index.php係所有頁面嘅最終後備模板，但係為咗更好控制，應該創建更具體嘅模板。例如，博客文章列表頁面通常由home.php或index.php控制。而單篇文章嘅詳情頁模板係single.php。呢啲模板嘅核心係「The Loop」（循環），佢係WordPress用嚟遍歷同輸出文章內容嘅機制。
創建home.php嚟展示博客文章列表：
<?php get_header(); ?>
<main id="primary" class="site-main">
<article id="post-<?php the_ID(); ?>" no numeric noise key 1010>
<header class="entry-header">
<h2 class="entry-title"><a href="/yue/</?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
</header>
<div class="entry-content">
<?php the_excerpt(); ?>
</div>
</article>
<p><?php esc_html_e( 'No posts found.', 'my-professional-theme' ); ?></p>
<?php endif; ?>
</main>實現頁面同側邊欄模板
靜態頁面使用page.php模板。呢個係展示「關於我哋」、「聯絡我哋」等頁面嘅理想選擇。佢嘅結構同single.php類似，但通常唔包含分類、標籤等元資訊。
側邊欄就由sidebar.php文件定義，佢通常包含小工具區域。喺functions.php入面，你需要用 register_sidebar() 函數嚟登記一個或者多個小工具區域，跟住喺sidebar.php入面用 dynamic_sidebar() 嚟調用佢。
// 在functions.php中注册侧边栏
function my_theme_widgets_init() {
register_sidebar( array(
'name' => esc_html__( 'Main Sidebar', 'my-professional-theme' ),
'id' => 'sidebar-1',
'description' => esc_html__( 'Add widgets here.', '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>',
) );
}
add_action( 'widgets_init', 'my_theme_widgets_init' );實現高級主題功能
一個專業主題唔單止要有結構，更加需要豐富嘅功能同埋優良嘅用家同開發者體驗。呢啲包括主題自訂器支援、選單系統、特色圖片、縮略圖支援等等。
集成WordPress菜單系統
在functions.php入面，用 register_nav_menus() 函數嚟註冊主題支援嘅菜單位置。上述header.php示例入面已經調用咗名為menu-primary嘅菜單位置。
推薦閱讀 WordPress主題開發完整教程：從零開始構建自訂主題。
function my_theme_register_menus() {
register_nav_menus(
array(
'menu-primary' => esc_html__( 'Primary Menu', 'my-professional-theme' ),
'menu-footer' => esc_html__( 'Footer Menu', 'my-professional-theme' ),
)
);
}
add_action( 'init', 'my_theme_register_menus' );添加文章特色圖片同縮略圖支援
特色圖片（Featured Image）係現代網站設計嘅標準配備。透過 add_theme_support() 函數，你可以為你嘅主題啟用呢個功能，同埋定義多種文章縮略圖尺寸。
function my_theme_setup() {
// 支持特色图片
add_theme_support( 'post-thumbnails' );
// 为特色图片添加自定义尺寸
add_image_size( 'my-theme-blog-thumbnail', 800, 400, true ); // 裁剪模式
}
add_action( 'after_setup_theme', 'my_theme_setup' );喺模板檔案入面，使用 the_post_thumbnail( 'my-theme-blog-thumbnail' ) 出呢張圖。
接入WordPress自訂器增強控制
WordPress自訂器（Customizer）容許用戶即時預覽同修改主題設定。你可以為佢加設定（settings）、控制（controls)同輸出邏輯。例如，加一個頁腳版權資訊選項：
function my_theme_customize_register( $wp_customize ) {
// 添加一个设置
$wp_customize->add_setting( 'footer_copyright_text', array(
'default' => '© 2026 Your Company Name. All rights reserved.',
'sanitize_callback' => 'sanitize_text_field',
) );
// 添加一个控件（输入框）到该设置
$wp_customize->add_control( 'footer_copyright_text', array(
'label' => __( 'Footer Copyright Text', 'my-professional-theme' ),
'section' => 'title_tagline', // 放在“站点身份”区域
'type' => 'text',
) );
}
add_action( 'customize_register', 'my_theme_customize_register' );在footer.php入面，用 get_theme_mod( 'footer_copyright_text' ) 嚟攞同顯示呢個數值。
主題優化同發佈準備
開發完成之後，確保你嘅主題流暢、安全同容易分發係最後嘅關鍵步驟。
確保主題嘅國際化支援
國際化（i18n）令你嘅主題可以翻譯成任何語言。喺functions.php度載入主題文本域係第一步。
function my_theme_load_theme_textdomain() {
load_theme_textdomain( 'my-professional-theme', get_template_directory() . '/languages' );
}
add_action( 'after_setup_theme', 'my_theme_load_theme_textdomain' );之後，喺主題入面所有需要翻譯嘅字串，都一定要用 ()、_e() 或 esc_html() 用函數包住佢。
跟返編碼標準做代碼審查
WordPress有官方嘅PHP、CSS同JavaScript編碼標準。跟返呢啲標準可以提高代碼嘅可讀性、易維護性，同埋令社區更容易接受。你可以用好似PHP_CodeSniffer配合WordPress編碼標準規則呢類工具來自動檢查你嘅代碼。
做安全加固同埋最後清理
安全係重中之重。除咗喺functions.php開頭檢查ABSPATH常量之外，所有用戶輸入同動態輸出都必須進行驗證、清理同轉義。常用嘅函數包括：
- 轉義： esc_html(), esc_attr(), esc_url()
清理： sanitize_text_field(), sanitize_email()
- 驗證： is_email(), absint()
發布前，移除所有用嚟調試嘅代碼（例如 var_dump()， print_r()），確保所有功能按預期運作，並喺唔同環境中進行充分測試。
摘要
由零開始構建一個專業嘅WordPress主題係一個系統性嘅工程，佢要求開發者唔單止要理解PHP/HTML/CSS/JavaScript，更要深入掌握WordPress嘅核心原理，例如模板層次結構、循環、掛鉤系統同主題支援功能。透過呢個指南，你系統性咁完成咗由環境搭建、模板創建、功能實現到優化發佈嘅完整流程。核心在於，一個優秀嘅主題應該喺提供強大功能同美觀設計嘅同時，保持代碼嘅清晰、高效同安全，並為用戶同後續開發者提供良好嘅可擴展性。不斷實踐、參考核心代碼同優秀主題，係提升開發水平嘅最佳途徑。
常見問題
### 開發WordPress主題必須掌握邊啲編程語言？
開發WordPress主題，PHP係必須掌握嘅核心語言，因為佢係WordPress本身同大部分模板標籤嘅編寫語言。同時，你需要精通HTML同CSS嚟控制頁面嘅結構同樣式。掌握基礎嘅JavaScript（特別係jQuery）對於實現前端交互效果至關重要。了解一啲SQL知識有助於你理解WordPress嘅數據查詢邏輯。
點解我個新主題冇喺WordPress後台「主題」列表度顯示出嚟？
呢個通常係因為style.css係因為檔案頭部註解資訊格式唔啱或者檔案缺失造成嘅。請確保：1）你個主題資料夾擺喺正確/wp-content/themes/路徑下；2）資料夾入面有style.css檔案；3）呢個檔案嘅頭部註解資訊（Theme Name、Author等）格式完全正確，冇語法錯誤。缺少任何一個必填資訊，WordPress都冇辦法識別呢個主題。
點樣為我嘅主題創建一個自訂頁面模板？
要創建自訂頁面模板，你需要喺主題根目錄下新開一個PHP文件，並喺該文件嘅最頂部加一個特定嘅模板名稱註釋塊。例如，創建一個「全寬頁面」模板，文件名為template-fullwidth.php，其開頭應為：<?php /* Template Name: 全宽页面 */ ?>。之後，用戶喺編輯頁面嗰陣，就可以喺「頁面屬性」嘅「模板」下拉框度揀「全寬頁面」。喺呢個文件入面，你可以編寫完全唔同於page.php嘅佈局同邏輯。
鉤子（Hooks）喺主題開發入面扮演乜嘢角色？
鉤子（分為動作鉤子 Action Hooks 同過濾器鉤子 Filter Hooks）係WordPress插件架構同主題可擴展性嘅基石。喺主題開發中，你主要用動作鉤子（透過 add_action()）喺特定嘅時間點（例如初始化、加載腳本、輸出頁腳嗰陣）插入你自己嘅功能代碼。同時，你亦會用過濾器鉤子（透過 add_filter()）用嚟修改WordPress或者其他插件輸出嘅內容（好似修改文章摘要長度、自訂文章類名咁）。合理運用鉤子可以令你嘅主題代碼模組化、更加易於維護同擴展。
主題開發完成之後，點樣將佢提交到WordPress官方主題目錄？
將主題提交到WordPress.org官方目錄係一個嚴格嘅過程。首先，你需要喺WordPress.org度申請一個SVN帳號。其次，你嘅主題必須100%跟從GPL v2或者更高版本嘅授權，同埋要經過官方主題審查團隊嘅審核。審核標準包括代碼質量、安全性、冇錯誤、跟從編碼標準、提供足夠嘅無障礙支援等等。喺提交之前，強烈建議你詳細閱讀官方主題開發手冊同提交指南，同埋用Theme Check插件進行自我審查，確保符合所有要求。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。