WordPress主題開發基礎同埋環境搭建
想創建自己嘅WordPress主題，首先需要建立一個高效嘅本地開發環境。咁樣就可以喺唔上線伺服器嘅情況下，安全咁進行代碼測試同除錯。本地環境通常包括Apache或者Nginx伺服器、PHP解釋器同MySQL數據庫。集成工具好似XAMPP、MAMP或者Laravel Valet可以一鍵安裝呢啲組件，大大簡化咗搭建過程。
對於代碼編輯，一個功能強大嘅編輯器或者集成開發環境（IDE）好重要。Visual Studio Code、PhpStorm或者Sublime Text都係流行嘅選擇，佢哋提供語法高亮、代碼自動補全同版本控制集成等功能，可以顯著提升開發效率。
喺環境準備好之後，你需要了解一個WordPress主題最基本嘅文件組成。最核心嘅文件係style.css同埋index.php。其中，style.css唔單止係樣式表，佢更承擔住主題定義嘅職能。呢個文件嘅樣式表頭部必須包含特定嘅註釋信息，WordPress據此嚟識別你嘅主題。
推薦閱讀 由零開始：WordPress 主題開發嘅完整流程同實戰指南。
下面係一個最基本嘅style.css檔案標頭示例：
/*
Theme Name: 我的第一个主题
Theme URI: https://example.com/my-first-theme/
Author: 你的名字
Author URI: https://example.com/
Description: 这是一个为学习WordPress主题开发而创建的简洁主题。
Version: 1.0
License: GPL v2 or later
Text Domain: my-first-theme
*/另一個必需文件係index.php，佢係主題嘅預設模板檔案。就算佢最初只係包含一句簡單嘅「Hello World」，都一定要存在。將呢兩個檔案放入一個以你主題命名嘅資料夾（例如my-first-theme），然後將該資料夾上傳到WordPress安裝目錄下嘅/wp-content/themes/喺路徑度，你就可以喺WordPress後台嘅「外觀」->「主題」度見到同啟用佢啦。
核心模板檔案同主題結構
一個功能完整嘅WordPress主題係由一系列模板檔案構成，呢啲檔案跟住特定嘅層次結構。理解模板層級係進行進階定制嘅基礎。當WordPress處理一個頁面請求嗰陣，佢會根據請求嘅類型（例如首頁、文章頁、頁面、分類存檔等）跟住優先順序搵對應嘅模板檔案。
首頁通常由front-page.php或home.php處理，如果呢兩個檔案都唔存在，就會退返去index.php。單篇文章嘅渲染就跟住single-{post-type}-{slug}.php -> single-{post-type}.php -> single.php -> singular.php -> index.php嘅查找順序。例如，一篇博客文章會優先用到single-post.php，而一個自訂文章類型「產品」就會搵single-product.php。
除咗頁面模板，主題仲需要一啲關鍵檔案嚟組織結構同功能。其中，header.php同埋footer.php分別負責輸出頁面嘅頭部同底部。喺模板檔案度，你可以透過get_header()同埋get_footer()函數嚟引入佢哋，咁樣可以確保代碼嘅重用性。
推薦閱讀 WordPress主題開發入門指南：由零開始整自訂主題。
functions.php檔案係主題嘅「大腦」，用嚟添加主題功能、註冊選單、小工具區域、定義圖像尺寸等等，而唔使修改核心檔案。例如，你可以喺度用add_theme_support()函數嚟啟用文章縮圖功能。
// 在 functions.php 中启用文章特色图像
add_theme_support( 'post-thumbnails' );另一個重要檔案係sidebar.php，佢定義咗側邊欄嘅HTML結構。透過get_sidebar()函數調用，你可以喺模板嘅任何位置插入側邊欄。為咗動態管理側邊欄內容，你需要喺functions.php入面用register_sidebar()函數註冊一個或多個小工具區域。
主題功能增強同動態內容
当基础结构搭建完成后，下一步是融入WordPress的动态数据与功能。这涉及到使用WordPress的核心函数和“循环”（The Loop）来输出内容。
“循环”是WordPress中用于从数据库中获取文章并显示在网页上的基础PHP代码结构。它检查当前页面上是否有文章，并在有文章时，循环遍历每一篇来输出其内容。一个典型的循环代码如下所示：
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<article>
<h2><?php the_title(); ?></h2>
<div class="entry-content">
<?php the_content(); ?>
</div>
</article>
<?php endwhile; else : ?>
<p><?php esc_html_e( '抱歉，没有找到任何文章。' ); ?></p>
<?php endif; ?>在循环内部，你可以使用一系列模板标签来输出文章数据，例如the_title()、the_content()、the_permalink()、the_post_thumbnail()等。这些函数会自动回显（打印）内容。如果你需要获取值而不直接输出，可以使用对应的“get_”函数，如get_the_title()。
自定义菜单是现代主题的标配。通过register_nav_menus()函數喺functions.php中注册菜单位置后，用户就可以在后台“外观”->“菜单”中管理这些菜单。然后，在模板文件（通常是header.php）入面，使用wp_nav_menu()函数来渲染菜单。
推薦閱讀 WordPress主題開發終極指南：從入門到定制化實戰。
为了提升主题的国际化支持，你需要进行文本域加载。在functions.php入面，用load_theme_textdomain()函数来加载翻译文件。同时，在代码中所有需要翻译的字符串，都应使用翻译函数包裹，例如__()用嚟返回翻譯後嘅字符串，_e()用於直接回顯。
// 加载主题文本域
function my_theme_setup() {
load_theme_textdomain( 'my-first-theme', get_template_directory() . '/languages' );
}
add_action( 'after_setup_theme', 'my_theme_setup' );
// 在模板中使用翻译函数
echo '<p>' . esc_html__( '你好，世界！', 'my-first-theme' ) . '</p>';高级定制与子主题开发
当你需要对一个现有主题进行修改，但又希望在未来安全地更新父主题时，创建子主题是最佳实践。子主题继承父主题的所有功能，你只需在子主题中覆盖需要修改的文件或添加新功能即可。
創建一個子主題好簡單。首先，喺/wp-content/themes/目錄下新建一個文件夾，例如my-child-theme。然后，在其中创建style.css文件，其头部必须通过Template:字段声明父主题的目录名。
/*
Theme Name: 我的子主题
Template: twenty-twenty-six
Version: 1.0.0
*/接下来，在子主题的style.css中，你可以编写新的CSS规则来覆盖父主题的样式。如果需要修改PHP模板文件，只需将父主题中的对应文件（如header.php）复制到子主题目录并进行编辑，WordPress会自动优先加载子主题中的版本。
对于功能的增删改，子主题拥有自己的functions.php文件。重要的一点是，子主题的functions.php不会覆盖父主题的，而是会被提前加载。这意味着你可以在其中添加新功能，或使用remove_action()、add_filter()等钩子来修改父主题的行为。
高级定制还涉及使用WordPress的钩子（Hooks）系统，包括动作（Action）和过滤器（Filter）。例如，你可以使用wp_enqueue_scripts动作来正确地添加脚本和样式表，确保它们以正确的顺序加载且不产生冲突。
// 在子主题的 functions.php 中安全地加入自定义脚本
function my_child_theme_scripts() {
wp_enqueue_style( 'child-style',
get_stylesheet_directory_uri() . '/style.css',
array( 'parent-style' ) // 声明依赖父主题样式
);
wp_enqueue_script( 'custom-script',
get_stylesheet_directory_uri() . '/js/custom.js',
array( 'jquery' ),
'1.0',
true
);
}
add_action( 'wp_enqueue_scripts', 'my_child_theme_scripts' );摘要
WordPress主题开发是一个从掌握基础文件结构开始，逐步深入到模板层级、动态数据调用以及高级功能定制的过程。通过建立本地开发环境，理解style.css、index.php、header.php、footer.php同埋functions.php等核心文件的作用，开发者可以构建出功能完整的主题。熟练运用“循环”和模板标签是输出内容的关键。而采用子主题开发模式，并合理运用WordPress强大的钩子系统，则能让你在保持代码可维护性的同时，实现深度的、可升级的个性化定制。遵循这些最佳实践，你将能从一个初学者成长为能够创建专业级主题的WordPress开发者。
常見問題
### 開發WordPress主題必須掌握PHP嗎？
是的，PHP是开发WordPress主题的必备技能。虽然HTML、CSS和JavaScript负责前端展示和交互，但主题的核心逻辑、动态数据获取（如文章、页面、菜单内容）、模板文件的组织与调用都依赖于PHP。WordPress本身及其大量核心函数都是由PHP编写的。
點解我嘅自訂樣式冇生效？
这通常是由于CSS样式优先级或加载顺序问题导致的。首先，检查浏览器开发者工具，确认你的CSS规则是否被应用，或者是否被其他更高优先级的规则覆盖。其次，确保你的样式表是通过wp_enqueue_style()函数正确加入队列的，并检查其依赖关系和加载顺序。在子主题开发中，记得在style.css中正确声明对父主题样式的依赖。
如何创建一个自定义文章类型的存档页面？
要为自定义文章类型创建存档页面，你需要遵循WordPress的模板层级规则。例如，对于一个名为product的自定义文章类型，WordPress会依次查找archive-product.php、archive.php… 最後index.php。因此，你只需在主题根目录下创建一个名为archive-product.php的模板文件，并在这个文件中使用“循环”来输出所有“产品”文章即可。
子主题和父主题的functions.php文件是什么关系？
子主題嘅functions.php文件与父主题的functions.php不是覆盖关系，而是补充关系。当 WordPress 加载时，它会先加载子主题的functions.php，然后再加载父主题的functions.php。这意味着你可以在子主题的functions.php中添加新功能，或者使用WordPress的钩子（Hooks）来移除或修改父主题中通过钩子添加的功能，从而安全地定制主题行为。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。