WordPress主題開發嘅基礎準備
WordPress主題開發始於搭建一個合適嘅工作環境並理解其核心架構。本地開發環境對於高效、安全嘅開發至關重要，你可以使用軟件包如XAMPP、MAMP或Docker來快速喺本地電腦上配置PHP、MySQL同Apache/Nginx環境。
跟住係理解主題嘅目錄結構。一個標準WordPress主題至少需要包含兩個檔案：style.css同埋index.php。其中，style.css唔單止係樣式表，更係一個主題嘅「身份證」，其頂部嘅樣式表頭部註釋用於向WordPress聲明主題資訊。
/*
Theme Name: 我的自定义主题
Theme URI: https://example.com/my-theme
Author: 你的名字
Description: 这是一个自定义WordPress主题。
Version: 1.0
*/理解主題模板嘅層級結構
WordPress嘅核心係佢強大嘅模板層級系統。呢個系統決定咗WordPress點樣根據當前訪問嘅頁面類型，自動揀選對應嘅模板檔案嚟渲染。例如，當訪問單篇文章時，WordPress會優先搵single-post.php，如果唔存在，就會退返去singular.php，最後係通用嘅index.php。
推薦閱讀 全面解析WordPress主題開發：從入門到精通嘅實踐指南。
呢種「從特殊到一般」嘅查找邏輯，就係模板層級。佢容許開發者針對特定頁面類型（如分類頁面、作者存檔頁、搜尋結果頁）創建高度定制化嘅佈局。理解同利用好模板層級，係高效主題開發嘅基礎。初學者可以從掌握幾個關鍵模板開始：header.php、footer.php、sidebar.php、index.php、single.php同埋page.php。
建立基礎主題檔案
等我哋動手整最簡單嘅主題。首先，喺wp-content/themes/目錄下新建一個文件夾，例如my-first-theme。喺呢個文件夾入面，整返必不可少嘅style.css文件，然後填返上面嘅頭部資料。
跟住就整index.php文件。呢個檔案係所有頁面嘅最終後備模板，佢嘅基本職責係調用WordPress嘅核心模板函數嚟輸出頁面結構。
<?php get_header(); ?>
<main id="main">
<?php
if ( have_posts() ) :
while ( have_posts() ) :
the_post();
?>
<article>
<h2><?php the_title(); ?></h2>
<div><?php the_content(); ?></div>
</article>
<?php
endwhile;
else :
echo '<p>暂无内容。</p>';
endif;
?>
</main>構建主題嘅核心模板檔案
一個功能完整嘅主題需要將頁面結構模組化。呢個係通過創建獨立嘅頭部、尾部同側邊欄模板檔案嚟實現。
設計網站頭部同底部
header.php檔案包含咗網站開頭部分嘅通用代碼，例如文檔類型宣告、區域（其中必須調用wp_head()函數）、網站標識、主導覽等。透過get_header()函數，WordPress會自動將其引入到需要佢嘅模板中。
推薦閱讀 由零開始精通WordPress主題開發完整指南。
同理，footer.php檔案包含頁面底部嘅通用內容，例如版權資訊、腳本引入區域（其中必須調用wp_footer()函數）。透過get_footer()函數引入。將結構分離嘅最大好處係維護方便，改一處就可以全站生效。
實現主題嘅核心循環
“「循環（The Loop）」係WordPress入面最重要嘅概念之一，佢係用嚟檢索數據庫內容並輸出到頁面嘅PHP代碼結構。正如上文index.php好似示範咁，循環通常以if ( have_posts() ) :開始，喺while ( have_posts() ) : the_post();入面處理每一篇文章或者頁面。喺循環入面，你可以用一系列嘅模板標籤，好似the_title()、the_content()、the_permalink()咁樣去輸出文章嘅特定資訊。
建立自訂頁面範本
除咗標準模板，你仲可以創建用於特定頁面嘅自訂模板。呢個係通過喺一個PHP檔案嘅頂部加入特定嘅模板名稱註解嚟實現。
<?php
/**
* Template Name: 全宽页面
* Description: 一个没有侧边栏的页面模板
*/
get_header(); ?>
<main id="main" class="full-width">
<?php while ( have_posts() ) : the_post(); ?>
<article id="post-<?php the_ID(); ?>">
<h1><?php the_title(); ?></h1>
<div class="entry-content">
<?php the_content(); ?>
</div>
</article>
<?php endwhile; ?>
</main>
<?php get_footer(); ?>創建之後，喺WordPress後台編輯頁面嗰陣，就可以喺「頁面屬性」嘅「模板」下拉式選單中揀你定義嘅「全闊頁面」。
增強主題嘅功能同樣式
一個優秀嘅主題唔單止要有結構，更需要強大嘅功能同美觀嘅樣式。呢個涉及到功能檔案同樣式表嘅深度自訂。
透過函數文件添加主題功能
functions.php係主題嘅「控制中心」，用嚟唔使修改核心文件嘅前提下，為你嘅主題添加功能、特性同修改默認行為。佢唔係必須嘅，但幾乎所有現代主題都包含佢。
推薦閱讀 WordPress主題開發入門指南：從零開始打造你嘅第一款主題。
一個基礎應用係註冊菜單同側邊欄。菜單透過register_nav_menus()函數註冊，咁樣可以喺後台「外觀」->「菜單」度管理多個導航位置。
function mytheme_setup() {
register_nav_menus( array(
'primary' => __( '主导航菜单', 'mytheme' ),
'footer' => __( '底部菜单', 'mytheme' ),
) );
}
add_action( 'after_setup_theme', 'mytheme_setup' );側邊欄（或者叫「小工具區域」）係透過register_sidebar()函數註冊。咁樣就可以畀網站管理員透過後台嘅「小工具」介面，動態噉向呢啲區域加內容。
應用響應式設計同埋CSS
在style.css度寫樣式嗰陣，響應式設計係基本要求。通常會用媒體查詢（Media Queries）嚟實現。同時，為咗主題嘅安全性同可維護性，強烈建議將排版嘅基準單位設為rem，並將box-sizing屬性設定為border-box。
*,
*::before,
*::after {
box-sizing: border-box;
}
html {
font-size: 62.5%; /* 方便rem计算，1rem ≈ 10px */
}
body {
font-size: 1.6rem; /* 16px */
}
@media (max-width: 768px) {
.site-header {
flex-direction: column;
}
}安全引入JavaScript同CSS
千祈唔好直接喺模板檔案度硬編碼引入外部腳本或者樣式。正確嘅方法係透過functions.php，使用wp_enqueue_script()同埋wp_enqueue_style()函數。咁樣可以確保依賴關係正確、避免重複載入，而且同WordPress嘅快取機制兼容。
function mytheme_scripts() {
// 引入主题主样式表
wp_enqueue_style( 'mytheme-style', get_stylesheet_uri() );
// 引入自定义JavaScript文件
wp_enqueue_script( 'mytheme-script', get_template_directory_uri() . '/js/main.js', array('jquery'), '1.0', true );
}
add_action( 'wp_enqueue_scripts', 'mytheme_scripts' );高級開發技術同最佳實踐
當你掌握咗基礎之後，可以探索更高級嘅技術去構建更強大、靈活同安全嘅主題。
利用子主題進行自訂
如果你想修改一個現有主題（特別係第三方或者父主題），最佳實踐係創建子主題。咁樣可以確保父主題更新嗰陣，你嘅修改唔會被覆蓋。子主題嘅style.css头部需要額外聲明Template字段嚟指定父主題。
/*
Theme Name: 我的子主题
Template: twentytwentyfour // 父主题的文件夹名
*/子主題會繼承父主題嘅所有功能。你可以透過子主題嘅functions.php加新功能，或者透過同名模板文件覆蓋父主題嘅模板。
建立主題自訂器選項
為咗等用戶唔使寫程式碼就可以調整主題（例如改顏色、上傳Logo），你需要整合WordPress自訂器。呢個主要係透過functions.php入面嘅$wp_customize物件API嚟完成。
function mytheme_customize_register( $wp_customize ) {
// 添加一个设置选项，用于存储Logo的URL
$wp_customize->add_setting( 'mytheme_logo' );
// 添加上传控件到某个部分
$wp_customize->add_control( new WP_Customize_Image_Control( $wp_customize, 'mytheme_logo', array(
'label' => __( '上传 Logo', 'mytheme' ),
'section' => 'title_tagline',
'settings' => 'mytheme_logo',
) ) );
}
add_action( 'customize_register', 'mytheme_customize_register' );喺模板檔案入面，你就可以透過get_theme_mod( 'mytheme_logo' )嚟攞用戶上傳嘅Logo同埋顯示出嚟。
跟返國際化同翻譯標準
為咗你個主題可以俾全世界嘅用戶用到，一定要做好國際化準備。即係所有對住用戶嘅文字字串都應該透過特定嘅功能嚟包裝。
_e( '这是一段文本', 'mytheme' ); // 输出翻译后的文本
__( '这是另一段文本', 'mytheme' ); // 返回翻译后的文本其中'mytheme'係文字域（Text Domain），佢一定要同主題喺WordPress.org嘅slug或者主題資料夾名一致。跟住你就可以用Poedit呢類工具嚟建立.pot翻譯模板同埋.po/.mo翻譯檔案，等社區幫手貢獻翻譯。
做性能優化同埋安全性檢查
主題開發完成之後，性能同安全係最後嘅檢查要點。確保所有前端資源都壓縮好（minify），圖片尺寸啱啱好。用子主題覆蓋機制，避免直接改核心檔案。esc_html()、esc_url()對所有從用戶或者數據庫攞到並輸出嘅數據，用適當嘅轉義函數，例如esc_html()、esc_attr()，防止XSS攻擊。
摘要
WordPress主題開發係由理解基礎架構（模板層級、核心循環）開始，逐步構建模塊化模板文件，並透過functions.php注入功能嘅過程。佢要求開發者兼顧前端呈現同後端邏輯，熟練掌握PHP、HTML、CSS同JavaScript。跟隨最佳實踐，例如創建子主題、整合定制器、實現國際化同注重安全性能，係開發出專業、可用且受歡迎嘅WordPress主題嘅關鍵。開發之路係持續嘅，由創建一個簡單嘅index.php開始，不斷實踐、測試同學習，你就能逐步構建出功能強大、設計精美嘅主題。
常見問題
學習WordPress主題開發需要咩先決知識？
建議你先具備基礎嘅HTML同CSS知識，能夠構建靜態網頁。同時，需要了解PHP嘅基本語法，因為WordPress嘅核心係用PHP編寫嘅。對JavaScript（尤其係jQuery）有初步了解會對實現互動功能有好大幫助。唔需要你一開始就係專家，可以喺開發過程中邊學邊用。
我應該修改現有嘅父主題文件嗎？
絕對唔好直接修改從第三方獲取嘅父主題文件（例如Twenty Twenty系列）。因為當父主題更新時，你嘅所有修改都會被覆蓋。正確做法係創建一個子主題，然後喺子主題嘅目錄下透過同名文件嚟覆蓋你需要修改嘅父主題模板文件，或者透過子主題嘅functions.php添加或修改功能。呢個係WordPress主題開發中最重要嘅維護原則。
點解我個主題喺後台唔顯示或者啟用失敗？
最常見嘅原因係你style.css文件頂部嘅主題信息註釋格式唔啱或者關鍵信息缺失。請仔細檢查Theme Name:等欄位係咪正確填寫。其次，請確保主題文件夾直接包含style.css同埋index.php，冇被多套一層無意義嘅文件夾。最後，檢查PHP語法錯誤，可以喺wp-config.php度啟用WP_DEBUG嚟睇具體錯誤信息。
點樣向我的主題添加自定義文章類型或者分類法？
添加自定義文章類型或者分類法主要通過functions.php文件實現。你需要用register_post_type()函數嚟註冊一個新嘅文章類型，或者用register_taxonomy()函數嚟註冊新嘅分類法。呢啲函數有好多參數，用嚟定義佢哋喺後台嘅管理介面、標籤、係咪公開等行為。建議參考WordPress官方Codex或者開發者手冊，由簡單嘅例子開始。
開發商業主題需要特別注意啲乜？
開發用於出售或分發嘅商業主題，責任更加大。你必須更嚴格咁跟從WordPress編碼標準同安全最佳實踐，對所有數據進行轉義同驗證。主題應100%兼容WordPress定制器，並詳細記錄所有選項同功能。確保你使用嘅所有資源（例如圖片、字體、代碼片段）都擁有合適嘅商業使用許可。此外，提供良好嘅用戶文檔同及時嘅技術支援，係建立信譽嘅關鍵。喺發佈前，務必喺多種環境（唔同PHP版本、唔同插件組合）下進行充分測試。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。