開發一個自定義的WordPress主題，是將你的創意轉化為網路現實、並完全掌控網站外觀和功能的最佳方式。與使用現成主題不同，自定義主題允許你從一張白紙開始，構建一個完全符合你或你客戶需求的獨特網站。儘管這個過程聽起來可能令人生畏，但只要你遵循WordPress的官方規範，拆解步驟，就能清晰地完成。本文將引導你完成從建立基本檔案到實現核心功能的完整流程。
准备工作与环境搭建
在開始編寫第一行程式碼之前，你需要一個合適的開發環境和清晰的專案規劃。
本地開發環境的建立
首先，你需要在本地計算機上搭建一個PHP伺服器環境。推薦使用整合的軟體包，如XAMPP、MAMP或Local by Flywheel。這些工具可以一鍵安裝Apache、MySQL和PHP，省去繁瑣的配置。以XAMPP為例，安裝後，你的網站檔案通常位於其安裝目錄下的htdocs資料夾內。在這裡，你可以建立一個新的資料夾，例如my-custom-theme，這將成為你主題的根目錄。
推荐阅读 零基础学习WordPress主题开发：打造个性化网站的核心指南。
主題專案結構規劃
一個標準的WordPress主題至少包含兩個核心檔案：style.css以及index.php。但在專案開始前，建議規劃一個清晰且可擴充套件的目錄結構。一個典型的現代主題結構可能如下所示：
my-custom-theme/
├── style.css // 主样式表，包含主题信息头
├── index.php // 主模板文件
├── functions.php // 主题功能与函数文件
├── header.php // 头部模板
├── footer.php // 底部模板
├── sidebar.php // 侧边栏模板
├── page.php // 页面模板
├── single.php // 文章页模板
├── archive.php // 文章归档页模板
├── 404.php // 404错误页模板
├── search.php // 搜索结果页模板
├── assets/ // 静态资源目录
│ ├── css/ // 样式文件
│ ├── js/ // 脚本文件
│ └── images/ // 图片资源
└── templates/ // 可选的模板部件目录擁有一個良好的結構有助於程式碼的組織和維護。
建立核心主題檔案
這是構建主題的基石，檔案中的資訊頭將告訴WordPress這是一個有效的主題。
定義主題樣式表
style.css是主題的“身份證”，其頂部的註釋塊（主題資訊頭）是必需的。WordPress依賴這些資訊來在後臺識別和顯示你的主題。建立一個style.css檔案，並輸入以下內容：
/*
Theme Name: 我的自定义主题
Theme URI: https://example.com/my-custom-theme
Author: 你的名字
Author URI: https://yourwebsite.com
Description: 这是一个为了学习从零开始开发而创建的自定义WordPress主题。
Version: 1.0.0
License: GPL v2 or later
Text Domain: my-custom-theme
*/其中,Text Domain用於國際化（i18n），是你主題的唯一識別符號，通常與主題資料夾名稱一致。在此註釋塊之後，你可以開始編寫你的CSS樣式。
推荐阅读 WordPress主题开发指南：从新手到高手的完整实战教程。
构建基础模板文件
index.php是所有頁面的預設回退模板。它是最基礎的，但我們可以從簡單的HTML結構開始。首先，建立一個header.php檔案來存放文件頭部（從<!DOCTYPE html>到開啟<body>標籤的部分）和footer.php來存放閉合標籤和頁尾內容。
header.php示例：
<!DOCTYPE html>
<html no numeric noise key 1006>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<meta name="viewport" content="width=device-width, initial-scale=1">
</head>
<body no numeric noise key 1003>
<header>
<h1><a href="/zh-tw/</?php echo esc_url( home_url( '/' ) ); ?>"></a></h1>
<p></p>
</header>注意使用了wp_head()鉤子，這是WordPress核心、外掛和主題新增指令碼和樣式所必需的。
footer.php示例：
<footer>
<p>© . All rights reserved.</p>
</footer>
</body>
</html>這裡使用了wp_footer()鉤子。
現在，你的index.php可以變得非常簡潔：
推荐阅读 WordPress主題開發完整指南：從零到一構建專業級主題。
<main>
<article>
<h2></h2>
<div></div>
</article>
<p></p>
</main>這個模板使用了WordPress的核心迴圈（The Loop）來顯示文章列表。
引入功能與動態內容
一個真正的主題不僅僅是靜態頁面，它需要與WordPress核心互動，載入資源並實現動態功能。
編寫主題函式檔案
functions.php是你的主題“大腦”，用於新增功能、註冊選單、側邊欄、載入樣式和指令碼等。建立此檔案並開始新增基礎功能。
<?php
// 主题设置
function my_custom_theme_setup() {
// 让WordPress管理文档标题
add_theme_support( 'title-tag' );
// 启用文章和评论的RSS feed链接
add_theme_support( 'automatic-feed-links' );
// 启用文章缩略图（特色图像）
add_theme_support( 'post-thumbnails' );
// 注册一个导航菜单
register_nav_menus( array(
'primary' => __( '主导航菜单', 'my-custom-theme' ),
) );
}
add_action( 'after_setup_theme', 'my_custom_theme_setup' );
// 注册小工具区域（侧边栏）
function my_custom_theme_widgets_init() {
register_sidebar( array(
'name' => __( '主侧边栏', 'my-custom-theme' ),
'id' => 'sidebar-1',
'description' => __( '在此添加小工具。', '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', 'my_custom_theme_widgets_init' );add_theme_support()函式用於啟用主題功能，而register_nav_menus()以及register_sidebar()則分別註冊導航選單和小工具區域。
載入樣式與指令碼
正確的資源載入方式是將樣式表和JavaScript檔案透過wp_enqueue_scripts鉤子排隊。在你的functions.php新增内容：
function my_custom_theme_scripts() {
// 加载主样式表
wp_enqueue_style( 'my-custom-theme-style', get_stylesheet_uri() );
// 加载自定义JavaScript文件
wp_enqueue_script( 'my-custom-theme-navigation', get_template_directory_uri() . '/assets/js/navigation.js', array(), '1.0.0', true );
// 如果使用评论功能，加载评论回复脚本（仅当需要时）
if ( is_singular() && comments_open() && get_option( 'thread_comments' ) ) {
wp_enqueue_script( 'comment-reply' );
}
}
add_action( 'wp_enqueue_scripts', 'my_custom_theme_scripts' );get_stylesheet_uri()獲取style.css的URL，get_template_directory_uri()獲取主題目錄的URL。
建立模板層級結構
WordPress使用模板層級來決定為特定頁面使用哪個模板檔案。建立專門的模板檔案可以使你的內容展示更加精細和靈活。
為不同內容型別建立模板
你需要為不同型別的頁面建立專門的模板。例如：
* single.php：用於顯示單篇文章。
* page.php：用於顯示單個頁面。
* archive.php：用於顯示分類、標籤、作者、日期等歸檔頁面。
* search.php：用於顯示搜尋結果。
* 404.php：用於顯示“未找到”頁面。
一個基礎的single.php可能如下所示：
<main>
<article id="post-<?php the_ID(); ?>" no numeric noise key 1012>
<header>
<h1></h1>
<div>
|
</div>
</header>
<div>
</div>
<div>
</div>
<footer>
<?php the_tags( '标签: ', ', ', '<br />' ); ?>
<?php
// 如果允许评论，显示评论模板
if ( comments_open() || get_comments_number() ) :
comments_template();
endif;
?>
</footer>
</article>
</main>這個模板使用了the_post_thumbnail()來顯示特色影象，以及comments_template()來載入評論區域。
使用模板部件實現模組化
為了進一步提高程式碼複用性，可以將頁面中重複的部分，如文章元資訊、文章列表項等，提取為模板部件（Template Parts）。例如，建立一個template-parts/content.php檔案，然後在index.php或者archive.php的迴圈中使用get_template_part( 'template-parts/content' );來呼叫它。這使你的主模板檔案保持簡潔。
总结
透過以上步驟，你已經完成了一個基礎但功能完整的自定義WordPress主題的開發。這個過程涵蓋了從環境搭建、建立核心檔案、引入WordPress功能、到構建模板層級的關鍵環節。記住，開發主題是一個迭代的過程。你可以從最基礎的功能開始，然後逐步新增更復雜的特性，如自定義文章型別、主題定製器選項、響應式設計等。最重要的是遵循WordPress的編碼標準和最佳實踐，這能確保你的主題安全、高效且易於維護。現在，將你的主題資料夾複製到WordPress安裝目錄下的wp-content/themes/中，就可以在後臺“外觀”->“主題”中看到並激活它了。
常见问题解答（FAQ）
開發WordPress主題需要哪些程式語言基礎？
開發WordPress主題主要需要掌握HTML、CSS和PHP。HTML用於構建頁面結構，CSS用於樣式設計，而PHP是WordPress的伺服器端程式語言，用於處理邏輯、資料庫查詢和動態內容生成。此外，瞭解一些基礎的JavaScript知識對於新增互動功能也很有幫助。
為什麼必須使用 get_header() 和 get_footer() 函式？
get_header()以及get_footer()是WordPress的模板標籤，它們用於包含header.php以及footer.php檔案。使用這些函式而非直接使用include語句，是WordPress模板層級和子主題機制的核心。它允許子主題透過建立同名檔案來覆蓋父主題的頭部和底部，提供了極大的靈活性。
怎样让我的主题支持多语言（国际化）？
你需要使用WordPress的國際化（i18n）函式來包裹所有在主題中輸出的文字字串。主要使用__()、_e()等函式，並在style.css中設定正確的Text Domain。然後，使用如Poedit這樣的工具生成.pot翻譯模板檔案，譯者可以據此建立對應語言（如zh_CN.po以及.mo）的翻譯檔案。最後，在functions.php通过中介机构load_theme_textdomain()函数加载翻译。
主題開發完成後，如何測試其相容性？
在將主題釋出或部署到生產環境前，進行徹底的測試至關重要。首先，應在不同瀏覽器（Chrome, Firefox, Safari, Edge）和裝置（桌面、平板、手機）上進行響應式測試。其次，使用WordPress環境的不同配置進行測試，如啟用/禁用各種外掛、使用不同的文章型別和小工具。此外，還可以使用WordPress官方主題檢查外掛（Theme Check）來掃描你的主題，確保它遵循最新的WordPress編碼標準和最佳實踐。
下一步，该怎么做呢？
延伸阅读与实用知识
下方列出的内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，然后逐步扩展到相关主题，这样效果通常会更好。