準備工作同環境搭建
喺開始編寫代碼之前，一個穩定同高效嘅開發環境至關重要。咁樣唔單止可以確保你嘅插件喺未來開發中保持結構清晰，仲可以令你利用現代工具提升效率。
本地開發環境配置
我哋推薦使用本地伺服器環境，例如 Local by Flywheel、XAMPP 或者 MAMP。呢啲工具可以快速喺你部電腦度建立一個包含 Apache/Nginx、MySQL 同 PHP 嘅 WordPress 運行環境。請確保你嘅 PHP 版本同你目標伺服器嘅版本兼容，同埋開啟錯誤報告功能，咁樣有助於喺開發初期快速定位問題。
代碼編輯器同工具選擇
選擇一個功能強大嘅代碼編輯器係第一步，例如 Visual Studio Code、PhpStorm 或者 Sublime Text。佢哋通常提供語法高亮、代碼提示同版本控制集成。另外，安裝一個代碼美化工具（例如 PHP_CodeSniffer）同調試工具（例如 Xdebug）會極大提升你嘅開發體驗同代碼質量。
推薦閱讀 WordPress主題開發完整指南：從零開始打造專業網站。
創建你嘅第一個插件
而家，等我哋由創建一個最簡單嘅插件開始，了解 WordPress 插件嘅基本結構同激活機制。
插件主文件同基礎頭信息
每個 WordPress 插件都必須有一個主 PHP 文件，而且呢個文件必須包含標準嘅插件頭信息，咁樣 WordPress 先至可以識別到佢。我哋創建一個名為 my-first-plugin.php 嘅檔案。
將以下代碼放入呢個文件入面，然後上傳到 WordPress 安裝目錄下面 /wp-content/plugins/my-first-plugin/ 喺文件夾入面。
<?php
/**
* Plugin Name: 我的第一个插件
* Plugin URI: https://example.com/my-first-plugin
* Description: 这是一个用于学习的简单 WordPress 插件。
* Version: 1.0.0
* Author: 你的名字
* Author URI: https://example.com
* License: GPL v2 or later
* Text Domain: my-first-plugin
* Domain Path: /languages
*/保存之後，你可以喺 WordPress 後台嘅「插件」頁面見到呢個插件，仲可以撳「啟用」嚟啟動佢。而家佢仲未有任何功能，但係你已經成功建立咗一個受 WordPress 認可嘅插件。
為插件加一個設定頁面
一個常見嘅需求係為插件加一個後台管理頁面。我哋可以透過 WordPress 提供嘅 add_menu_page() 或 add_options_page() 函數嚟實現。
推薦閱讀 WordPress插件開發終極指南：由零到一構建專業擴展。
我哋喺主檔案入面繼續加代碼，整一個簡單嘅設定頁面。
// 钩子：在管理员菜单中添加一个新的页面
add_action('admin_menu', 'mfp_add_admin_menu');
function mfp_add_admin_menu() {
add_options_page(
'我的插件设置', // 页面标题
'我的插件', // 菜单标题
'manage_options', // 所需权限
'my-first-plugin', // 菜单slug
'mfp_settings_page_html' // 用于显示页面内容的回调函数
);
}
// 设置页面的HTML内容
function mfp_settings_page_html() {
// 检查用户权限
if (!current_user_can('manage_options')) {
return;
}
?>
<div class="wrap">
<h1><?php echo esc_html(get_admin_page_title()); ?></h1>
<p>歡迎嚟到我第一個插件嘅設定頁面！</p>
<form action="/yue/options.php/" method="post" data-trp-original-action="options.php">
<?php
// 输出设置字段（后续可在此添加）
settings_fields('mfp_options_group');
do_settings_sections('my-first-plugin');
submit_button('保存设置');
?>
<input type="hidden" name="trp-form-language" value="yue"/></form>
</div>
<?php
}呢段代碼使用 add_action() 個鈎會將個函數 mfp_add_admin_menu 掛上WordPress嘅 admin_menu 動作度。當管理員菜單建立嘅時候，我哋嘅函數就會被呼叫，咁就可以加一個新嘅子菜單項目落去「設定」主菜單下面。撳呢個菜單項目，就會執行 mfp_settings_page_html 函數嚟渲染頁面內容。
理解 WordPress 鉤子同過濾器
WordPress 嘅核心哲學係「鉤子」（Hooks），佢容許你喺特定時間點或者位置插入自訂代碼，從而修改或者擴展 WordPress 嘅核心功能，而唔使直接修改核心檔案。鉤子主要分為兩種：動作（Actions）同過濾器（Filters）。
動作鈎子嘅使用
動作鉤子喺特定事件發生嗰陣執行你嘅代碼，例如發佈文章、載入管理後台或者輸出頁尾。佢唔預期有返回值，主要用嚟執行某個任務。我哋用 add_action() 函數嚟掛載一個回調函數到指定嘅動作鉤子。
譬如，我哋想喺每篇文章嘅尾段自動加一段版權聲明。可以用 the_content 呢個過濾器（佢同時都係一個動作點）嚟實現。但為咗更純粹咁展示動作，我哋用 wp_footer 鉤子喺網站前台頁腳輸出資訊。
add_action('wp_footer', 'mfp_add_footer_note');
function mfp_add_footer_note() {
if (is_single()) { // 仅在文章页面显示
echo '<p style="text-align:center; color:#666;">本文由我嘅插件為您呈現。</p>';
}
}過濾器鈎子嘅用法
過濾器鉤子係用喺數據被使用或者存入資料庫之前修改佢。佢預期你接收一個數值，修改之後將佢傳返出去。我哋用 add_filter() 用函數嚟掛載回調函數。
推薦閱讀 WordPress插件開發入門指南：從零開始打造你嘅定制化功能模組。
一個經典例子係修改文章摘要嘅長度。WordPress 默認摘要長度係 55 個單詞，我哋可以透過 excerpt_length 過濾器嚟改變佢。
add_filter('excerpt_length', 'mfp_custom_excerpt_length');
function mfp_custom_excerpt_length($length) {
// 将摘要长度修改为 20 个单词
return 20;
}喺呢個例子入面，函數 mfp_custom_excerpt_length 接收咗默認嘅長度值 $length，然後返返我哋自訂嘅新長度值 20。WordPress 會用呢個返回值嚟生成摘要。
插件安全與最佳實踐
開發一個受歡迎嘅插件，安全性、可維護性同性能係必須考慮嘅要素。跟隨最佳實踐可以避免好多常見問題。
數據驗證、轉義同埋清理
千祈唔好信任用戶輸入或者嚟自數據庫嘅數據。喺處理任何數據之前，必須進行驗證、清理同轉義。
* 验证（Validation）：检查数据是否符合预期的格式或类型（如是否是邮箱、数字等）。可以使用 filter_var() 函數或者 WordPress 嘅 sanitize_*() 系列函數。
* 清理（Sanitization）：清除数据中的非法或危险字符，使其变得安全。对于表单输入，常用 sanitize_text_field()。
* 转义（Escaping）：在将数据输出到 HTML、JavaScript 或 URL 时，根据上下文进行转义，以防止跨站脚本（XSS）攻击。WordPress 提供了丰富的转义函数，如 esc_html()、esc_attr()、esc_url() 同埋 wp_kses_post()。
例如，安全噉輸出一個嚟自數據庫嘅變量：
// 假设 $user_input 是从数据库或表单获取的数据
echo '<div class="info">' . esc_html($user輸入) . '</div>';
// 或者，如果允许一些安全的HTML标签
echo '<div class="info">' . wp_kses_post($用戶輸入) . '</div>';插件國際化與本地化
為咗令你嘅插件可以俾全世界嘅用戶使用，你需要為佢添加翻譯支援，呢個過程叫做國際化（i18n）。WordPress 使用 GNU gettext 框架嚟實現。
首先，喺所有需要翻譯嘅字串處，使用特定嘅函數進行包裝。最常用嘅係 __()（用嚟返回值）同埋 _e()（用嚟直接回顯輸出）。
修改我哋之前創建嘅管理頁面標題：
function mfp_settings_page_html() {
if (!current_user_can('manage_options')) {
return;
}
?>
<div class="wrap">
<h1><?php echo esc_html(get_admin_page_title()); ?></h1>
<p><?php _e('欢迎来到我的第一个插件的设置页面！', 'my-first-plugin'); ?></p>
...
</div>
<?php
}注意，每個翻譯函數都包含一個文本域參數（‘my-first-plugin’），佢必須同插件頭信息中定義嘅 Text Domain 完全一致。然後，你可以用好似 Poedit 咁嘅工具，掃描插件代碼入面嘅可翻譯字串，生成 .pot 模板檔案，同埋建立唔同語言嘅 .po 同埋 .mo 翻譯檔案，擺喺插件目錄嘅 /languages/ 資料夾下面。
摘要
透過呢份指南，我哋系統性地行過咗 WordPress 插件開發嘅核心路徑。由搭建本地環境、創建包含標準頭資訊嘅主檔案，到利用動作同過濾器鈎子同 WordPress 核心深度互動，再到至關重要嘅安全性實踐同國際化準備，你已經掌握咗構建一個功能完整、安全可靠嘅插件所需嘅基礎知識。記住，優秀嘅插件源於清晰嘅代碼結構、嚴格嘅安全處理同細緻嘅用戶體驗。跟住落嚟，最好嘅學習方式就係動手實踐，由一個解決實際小問題嘅插件開始，逐步探索更複雜嘅 API 同功能。
常見問題
開發 WordPress 插件需要啲咩基礎知識？
你需要掌握 PHP 編程語言，呢個係 WordPress 嘅核心開發語言。同時，對 HTML、CSS 同 JavaScript 有基本了解，用嚟處理前端展示同互動。熟習 MySQL 數據庫嘅基本概念（例如 CRUD 操作）都好有幫助，因為 WordPress 用佢嚟儲存數據。最後，理解 WordPress 嘅基本架構同工作流程係關鍵。
點樣調試我嘅 WordPress 插件？
首先，喺 wp-config.php 檔案中開啟 WordPress 除錯模式，將 define('WP_DEBUG', true); 同埋 define('WP_DEBUG_LOG', true); 設定為 true。咁樣錯誤資訊會記錄到 /wp-content/debug.log 檔案中，避免直接顯示俾訪客睇。其次，使用 Xdebug 等專業除錯工具同你嘅代碼編輯器（例如 VS Code）集成，可以實現設定斷點、單步除錯等高級功能。此外，利用瀏覽器開發者工具嘅網絡同控制台面板，可以檢查 AJAX 請求同前端 JavaScript 錯誤。
我開發嘅插件點樣提交到 WordPress 官方插件目錄？
提交之前，請確保你嘅插件完全遵循 WordPress 官方嘅編碼標準同最佳實踐，並徹底進行代碼審查同安全檢查。你需要註冊一個 WordPress.org 帳號，然後喺插件提交頁面提交你嘅插件壓縮檔。審核團隊會檢查你嘅代碼，確保其安全性、合法性並符合相關指南。審核通過後，你嘅插件就會被列入官方目錄，俾全球用戶下載同安裝。
點樣為我嘅插件加一個設定選項到 WordPress 自訂器中？
WordPress 自訂器（Customizer）提供咗一種實時預覽嘅配置方式。你可以使用 add_action('customize_register', 'your_function'); 鉤。喺回調函數 your_function 入面，透過 $wp_customize 物件加一個章節（Section）、一個設定項（Setting）同一個控制器（Control）。咁樣容許用戶喺自訂器介面度調整選項，並即時睇到前端效果，好啱用嚟管理主題同外掛嘅外觀類設定。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。