要開發一個 WordPress 插件，首先需要喺 WordPress 安裝目錄嘅 wp-content/plugins 文件夾內創建一個專屬嘅文件夾。呢個文件夾嘅名應該同你嘅插件核心功能或者名相關，而且最好用細楷字母同埋連字號，例如 my-first-plugin。
跟住，你需要喺呢個文件夾內創建主插件文件。呢個文件通常以插件名命名，例如 my-first-plugin.php。呢個文件係插件嘅入口，佢頂部必須包含一個符合 WordPress 標準嘅插件頭部註釋。呢個註釋塊用嚟向 WordPress 系統提供插件嘅基本信息，係插件被識別同啟用嘅關鍵。
一個典型嘅插件頭部註釋係咁樣嘅：
推薦閱讀 從零開始精通WordPress插件開發：完整指南同實戰演練。
<?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 插件唔單止方便自己維護，亦都方便其他開發者理解。跟返標準嘅組織方式可以令你嘅代碼更加清晰、更加專業。
核心檔案同目錄嘅組織方式
除咗主插件檔案，一個功能完整嘅插件通常會包含多個目錄同檔案。例如，includes/ 目錄用嚟擺核心嘅 PHP 類或者函數檔案；admin/ 目錄擺後台管理界面相關嘅程式碼；public/ 或 frontend/ 目錄擺面向網站訪客嘅程式碼；assets/ 目錄就用嚟擺 JavaScript、CSS 同圖片等靜態資源。
除此之外，仲有可能需要 languages/ 目錄用嚟存放國際化翻譯檔案（.po/.mo），同埋一個 uninstall.php 檔案去處理插件被刪除嗰陣嘅清理工作。合理嘅目錄結構係建立可維護、可擴展插件嘅基礎。
插件生命週期同標準掛鈎
WordPress 插件透過一系列「掛鈎」（Hooks）同核心系統互動。理解插件嘅生命週期，關鍵在於理解呢啲掛鈎嘅執行順序。當 WordPress 處理一個請求嗰陣，佢會依次加載核心檔案、主題同已啟動嘅插件。
推薦閱讀 WordPress 插件開發完全指南：從入門到實戰精講。
插件開發者可以利用 register_activation_hook 喺插件啟動嗰陣執行一次性任務，例如建立數據庫表。同樣，register_deactivation_hook 用嚟處理插件停用時嘅操作（注意，呢個唔係刪除）。而 register_uninstall_hook 或一個獨立嘅 uninstall.php 檔案就係用嚟喺插件俾人從 WordPress 度剷走嗰陣清理數據。
喺日常運作入面，最常用嘅兩種鈎類型係動作（Action）同過濾器（Filter）。動作容許你喺特定時刻（好似 init）插入代碼去執行功能；過濾器就容許你修改其他函數傳遞嘅數據（好似 the_content）。
實現核心功能同安全互動
開發插件嘅主要目的係為 WordPress 增加新功能。無論係加一個簡碼、整一個小工具，定係處理表單數據，都要跟返 WordPress 嘅安全同互動規範。
創建短代碼嚟輸出內容
短代碼（Shortcode）係容許用戶喺文章或者頁面度透過一個簡單標籤嚟插入動態內容嘅強勁工具。你可以用 add_shortcode 函數嚟註冊你自己嘅短代碼。
例如，以下代碼註冊咗一個叫做 greet 嘅短代碼，佢接受一個 name 屬性並向用戶問好：
function myplugin_greet_shortcode( $atts ) {
// 使用 shortcode_atts 函数设置默认值并合并用户属性，确保安全性
$atts = shortcode_atts( array(
'name' => '访客',
), $atts, 'greet' );
// 在输出前对用户输入进行转义
$name = esc_html( $atts['name'] );
return '<p>你好，' . $name . '！歡迎嚟到呢個網站。</p>';
}
add_shortcode( 'greet', 'myplugin_greet_shortcode' );```;用戶可以喺文章編輯器度輸入 [greet name=“小明”]，前端就會顯示「你好，小明！歡迎來到本網站。」。記住，所有從用戶度攞到嘅數據，喺輸出之前都必須經過適當嘅轉義或者驗證，好似上面個例子用 esc_html。
推薦閱讀 WordPress插件開發入門指南：由零開始創建你嘅第一個自訂插件。
為插件加設設定頁面
對於需要用戶配置嘅插件，整一個後台選項頁面係標準做法。你可以用 WordPress 嘅「設定API」來安全、方便咁加頁面同欄位，佢會自動處理安全驗證（nonce）同數據儲存。
首先，用 add_options_page 或 add_menu_page 等函數喺管理後台加一個菜單項同頁面。然後，用 register_setting、add_settings_section 同埋 add_settings_field 等函數嚟定義你嘅設定選項。
以下係一個創建簡單設定頁面嘅框架代碼：
function myplugin_add_admin_menu() {
add_options_page(
'我的插件设置', // 页面标题
'我的插件', // 菜单标题
'manage_options', // 所需权限
'myplugin-settings', // 菜单 Slug
'myplugin_settings_page' // 用于渲染页面的回调函数
);
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );
function myplugin_settings_init() {
register_setting( 'myplugin_settings_page', 'myplugin_settings' );
add_settings_section( 'myplugin_section', '基础设置', null, 'myplugin_settings_page' );
add_settings_field(
'api_key',
'API 密钥',
'myplugin_api_key_field_render', // 渲染输入字段的函数
'myplugin_settings_page',
'myplugin_section'
);
}
add_action( 'admin_init', 'myplugin_settings_init' );
function myplugin_api_key_field_render() {
$options = get_option( 'myplugin_settings' );
$value = isset( $options['api_key'] ) ? esc_attr( $options['api_key'] ) : '';
echo '<input type="text" name="myplugin_settings[api_key]" value="' . $value . '" />';
}
function myplugin_settings_page() {
?>
<form action='/yue/options.php/' method='post' data-trp-original-action="options.php">
<h2>我嘅插件設定</h2>
<?php
settings_fields( 'myplugin_settings_page' );
do_settings_sections( 'myplugin_settings_page' );
submit_button();
?>
<input type="hidden" name="trp-form-language" value="yue"/></form>
<?php
}使用設定 API 可以確保你嘅插件選項被安全噉保存到 wp_options 表中，而且管理介面符合 WordPress 風格。
遵循開發最佳實踐
編寫一個能夠長期穩定運行、易於維護，並且同其他插件和諧共存嘅插件，需要遵循一啲關鍵嘅最佳實踐。
確保代碼嘅安全性
安全性係插件開發嘅重中之重。必須對所有用戶輸入（包括來自 URL、表單、Cookies 同數據庫嘅數據）進行驗證、清理同轉義。使用 WordPress 提供嘅系列函數，例如 esc_html、esc_url、sanitize_text_field 用嚟處理輸出；使用 wp_verify_nonce 同埋 check_admin_referer 嚟驗證請求嘅合法性，防止跨站請求偽造（CSRF）攻擊。
進行數據庫查詢嗰陣，一定要用 $wpdb 類提供嘅方法（例如 prepare）嚟防止 SQL 注入攻擊。千祈唔好直接將用戶輸入拼接到 SQL 語句度。
實現國際化同本地化
為咗令你嘅插件可以俾全世界嘅 WordPress 用戶使用，國際化（i18n）係必須嘅。呢個意思係你需要用 WordPress 嘅翻譯函數去包裹所有面向用戶嘅字串。
喺你嘅插件頭部註釋度定義好 Text Domain（例如 my-first-plugin）同埋 Domain Path。喺程式碼入面，對所有需要翻譯嘅字串用 __() 嚟翻譯，用 _e() 進行翻譯並直接輸出，用 _n() 處理單複數形式。
例如：$text = __(‘Hello World’， ‘my-first-plugin’);。然後，你可以用 Poedit 等工具生成 .pot 範本檔案，俾翻譯人員創建 .po 同埋 .mo 檔案。將翻譯檔案放入插件根目錄嘅 /languages 資料夾，WordPress 就會根據網站語言自動載入相應嘅翻譯。
進行代碼優化同效能考量
效能唔好嘅插件會拖慢成個網站。應該避免每次頁面加載都執行大量唔必要嘅代碼。將只喺後台使用嘅腳本同樣式，透過條件判斷（例如 is_admin()）淨係加載喺後台；將前端資源透過 wp_enqueue_script() 同埋 wp_enqueue_style() 喺適當嘅掛鉤（例如 wp_enqueue_scripts）入面排隊加載。
對於耗時嘅操作或者外部 API 調用，可以考慮用 WordPress 嘅 Transients API（set_transient， get_transient）嚟做緩存。同時，要確保插件喺停用或者刪除嘅時候，能夠透過 uninstall.php 清理返自己建立嘅數據庫表同選項，但係要小心操作，同埋要俾用戶選擇係咪刪除數據嘅選項。
除錯、測試同發布
喺將你嘅插件交俾用戶之前，徹底嘅除錯、測試同準備工作係確保成功嘅關鍵步驟。
利用 WordPress 除錯工具
喺開發階段，強烈建議開啟 WordPress 嘅除錯模式。喺 wp-config.php 檔案入面設定 define(‘WP_DEBUG’， true);。咁樣會令所有 PHP 錯誤、警告同通知都顯示出嚟，幫你快速搵到問題所在。你仲可以同時啟用 WP_DEBUG_LOG 將錯誤記錄到日誌檔，或者啟用 SCRIPT_DEBUG 嚟載入未壓縮嘅 JavaScript 同 CSS 檔案，方便調試。
準備插件發佈資料
如果你打算將插件提交到官方嘅 WordPress.org 插件目錄，你需要準備一系列材料。呢啲包括一份詳細嘅 readme.txt 個檔案，格式一定要符合WordPress嘅要求，包含描述、安裝步驟、常見問題、更新日誌等等。你仲需要提供高質素嘅橫幅同圖示圖片，同埋填寫插件嘅SVN倉庫描述。
喺代碼層面，確保你已經完成咗國際化準備，同埋仔細檢查所有代碼係咪符合WordPress編碼標準。你可以喺本地用PHP_CodeSniffer同WordPress編碼標準規則嚟檢查。
進行跨環境兼容性測試
發佈之前，一定要喺多種環境下測試你嘅插件。呢個包括唔同版本嘅WordPress（特別係當前版本同埋上一個主要版本）、唔同嘅PHP版本（例如PHP 7.4、8.0、8.1）、唔同嘅數據庫版本（MySQL/MariaDB）同埋同流行主題同其他插件嘅兼容性測試。確保你嘅插件喺啟動、停用、設定同使用嘅各個階段都冇彈出錯誤或者警告。
摘要
WordPress插件開發係一個將創意轉化為功能，同埋融入龐大生態系統嘅過程。由創建一個符合標準嘅主檔案開始，逐步構建清晰嘅檔案目錄結構，同埋深入理解動作同過濾器掛鈎呢個核心互動機制。喺實現短代碼、設定頁面等具體功能嗰陣，一定要將安全性（驗證、轉義、防注入）同國際化當做編碼習慣。跟隨最佳實踐，例如優化性能、妥善管理資源，同埋利用除錯工具確保代碼質素。最終，通過全面嘅跨環境測試同完善嘅發佈準備，你嘅插件就能夠穩定、安全咁為全球WordPress用戶服務。持續學習官方手冊同社區資源，係不斷提升插件開發水準嘅關鍵。
常見問題
開發 WordPress 插件需要啲咩基礎知識？
你需要有紮實嘅 PHP 編程基礎，因為插件核心邏輯主要係用 PHP 寫嘅。同時，要對 HTML、CSS 同 JavaScript 有基本了解，用嚟構建用戶界面同互動。最重要嘅係，你一定要熟 WordPress 嘅基本架構，包括佢嘅掛鉤系統（動作同過濾器）、主題循環、數據庫結構，同埋各種核心函數同類嘅用法。
點樣避免我嘅插件同其他插件撞到？
為你所有嘅函數、類、常量、動作/過濾器標籤同埋選項名稱加返獨一無二嘅前綴，係防止衝突最有效嘅方法。唔好用啲通用名，例如 add_user() 或 $count。相反，應該用同你插件相關嘅前綴，例如 myplugin_add_user() 或 $myplugin_count。將你嘅代碼封裝喺類或者命名空間入面都係良好嘅實踐。另外，喺排隊腳本同樣式嗰陣，用唯一嘅句柄，同埋考慮按需要加載資源。
我應該將插件數據儲存喺邊度？
對於簡單嘅配置選項，用 WordPress 嘅 Options API (add_option, get_option, update_option) 將數據儲存喺 wp_options 表係最簡單、最標準嘅方式。如果你需要儲存大量結構化嘅自訂數據（例如產品、訂單等），就應該建立自訂數據庫表。使用 $wpdb 物件並喺插件啟動時透過 dbDelta() 函數嚟建立同更新表結構，咁樣可以確保跨數據庫版本嘅兼容性。
插件被刪除之後，點樣清理佢建立嘅數據？
WordPress提供咗兩種主要方式。第一種係用 register_uninstall_hook() 函數註冊一個卸載掛鈎。第二種，亦係更推薦嘅方式，係喺外掛程式根目錄度創建一個獨立嘅 uninstall.php 檔案。喺呢個檔案入面，你需要檢查係咪由WordPress內部調用咗 WP_UNINSTALL_PLUGIN 常數，然後執行刪除自訂選項（用 delete_option）同自訂數據庫表等清理操作。請注意，務必喺插件描述中告知用戶刪除操作會清除邊啲數據。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。