WordPress插件係擴展網站功能嘅核心，佢容許你以模組化嘅方式加入新功能，而唔使改動WordPress核心程式碼。透過開發自己嘅插件，你可以實現完全客製化嘅功能，更加貼合特定需求，同其他主題同插件保持兼容。呢個指南會帶你行完整個構建功能齊全、結構規範嘅WordPress插件嘅全過程。
WordPress插件嘅基本結構同規範
一個標準嘅WordPress插件需要跟返特定嘅檔案結構同規範，確保佢可以俾WordPress系統正確識別、安全運行，同埋容易維護。
建立插件主檔案
每個插件都必須有一個主PHP檔案，其檔案名通常同插件目錄名相同。呢個檔案嘅開頭必須包含一個特定嘅插件資訊頭部註釋，WordPress透過佢嚟識別插件。
推薦閱讀 深入解析 WordPress 插件開發：從零入門到高效自訂。
喺插件目錄下創建一個名為 my-first-plugin.php 嘅檔案，並加入以下頭部資訊：
<?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
*/跟從安全最佳實踐
所有插件代碼都應該包含喺安全檢查入面，以防被直接訪問。同時，應該用獨一無二嘅前綴嚟命名所有函數、類同常數，避免同主題或者其他插件撞名。
喺插件主檔案入面，應該喺標頭註解之後即刻加入安全防護代碼，同埋用一個獨特嘅前綴（例如 mfp_）嚟命名你嘅函數：
// 防止直接访问文件
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
// 使用唯一前缀定义一个函数
function mfp_display_greeting() {
echo '<p>你好，歡迎使用我第一個插件呀！</p>';
}實現核心功能：動作同過濾器
WordPress嘅核心擴展機制依賴於掛鉤（Hooks），分為動作（Actions）同過濾器（Filters）。理解同正確使用佢哋係插件開發嘅關鍵。
使用動作鈎子添加功能
動作鈎子容許你喺特定時間點或者事件發生嗰陣執行自己嘅代碼。例如，喺頁面底部加一段文字，可以用 wp_footer 動作。
推薦閱讀 WordPress插件開發：由零到一建立自訂功能插件。
將之前定義嘅函數掛載去 wp_footer 鈎子上面：
// 将函数挂载到 wp_footer 动作钩子
add_action( 'wp_footer', 'mfp_display_greeting' );咁樣，當WordPress執行到頁腳嗰陣，就會調用 mfp_display_greeting 函數，輸出問候語。
用過濾器鈎修改內容
過濾器鈎用嚟修改數據。佢哋接收一個值，處理完之後再傳返出去。例如，修改文章標題嘅默認後綴，可以用 the_title 過濾器。
創建一個函數嚟修改文章標題，然後將佢加到過濾器度：
// 定义一个函数来修改文章标题
function mfp_modify_title( $title, $id = null ) {
// 仅在前端修改非管理员页面的标题
if ( ! is_admin() && in_the_loop() ) {
$title .= ' - 来自我的插件';
}
return $title;
}
// 将函数挂载到 the_title 过滤器钩子，参数3是优先级，参数4是接受的参数个数
add_filter( 'the_title', 'mfp_modify_title', 10, 2 );構建插件管理界面
大多數插件都需要一個後台設定頁面，等網站管理員可以配置插件選項。WordPress提供咗豐富嘅API嚟創建標準嘅管理選單同表單。
創建插件設定頁面
使用 add_menu_page() 或 add_options_page() 函數可以為你嘅插件加一個管理頁面。通常，呢個頁面會喺「設定」選單下面。
推薦閱讀 從零開始掌握 WordPress 插件開發：原理、實踐與高級技巧。
創建一個函數嚟註冊管理選單，並將其掛載到 admin_menu 動作：
// 添加插件设置页面到后台菜单
function mfp_add_admin_menu() {
add_options_page(
'我的第一个插件设置', // 页面标题
'我的插件设置', // 菜单标题
'manage_options', // 权限要求
'my-first-plugin', // 菜单slug
'mfp_render_settings_page' // 用于渲染页面的回调函数
);
}
add_action( 'admin_menu', 'mfp_add_admin_menu' );
// 渲染设置页面的回调函数
function mfp_render_settings_page() {
?>
<div class="wrap">
<h1>我第一個插件設定</h1>
<form action="/yue/options.php/" method="post" data-trp-original-action="options.php">
<?php
settings_fields( 'mfp_settings_group' );
do_settings_sections( 'my-first-plugin' );
submit_button();
?>
<input type="hidden" name="trp-form-language" value="yue"/></form>
</div>
<?php
}註冊同處理設定選項
WordPress設定API可以安全噉處理選項嘅註冊、驗證同儲存。你需要定義設定欄位、章節，同埋用一個處理函數嚟儲存數據。
繼續喺插件主檔案入面加以下代碼嚟註冊設定：
// 初始化插件设置
function mfp_settings_init() {
// 注册一个新的设置组和选项
register_setting( 'mfp_settings_group', 'mfp_settings', 'mfp_sanitize_settings' );
// 在插件设置页面添加一个节
add_settings_section(
'mfp_section_basic',
'基本设置',
null,
'my-first-plugin'
);
// 向节中添加一个字段
add_settings_field(
'mfp_greeting_text',
'问候语文本',
'mfp_greeting_text_render',
'my-first-plugin',
'mfp_section_basic'
);
}
add_action( 'admin_init', 'mfp_settings_init' );
// 渲染问候语文本输入字段
function mfp_greeting_text_render() {
$options = get_option( 'mfp_settings' );
$value = isset( $options['greeting_text'] ) ? $options['greeting_text'] : '你好，世界！';
echo '<input type="text" name="mfp_settings[greeting_text]" value="' . esc_attr( $value ) . '" class="regular-text">';
}
// 清理和验证设置输入
function mfp_sanitize_settings( $input ) {
$sanitized = [];
if ( isset( $input['greeting_text'] ) ) {
$sanitized['greeting_text'] = sanitize_text_field( $input['greeting_text'] );
}
return $sanitized;
}插件嘅國際化同部署準備
為咗令插件可以俾全球用戶使用，同埋最終可以發佈，你需要做國際化同埋程式碼優化。
實現文本國際化
用WordPress嘅 __()、_e() 等函數嚟包裝所有需要翻譯嘅文本字串，同埋正確載入文本域。
修改你嘅輸出函數，等佢支援翻譯功能
function mfp_display_greeting() {
$options = get_option( ‘mfp_settings’ );
$greeting = isset( $options[‘greeting_text’] ) ? $options[‘greeting_text’] : __( ‘你好，世界！’, ‘my-first-plugin’ );
echo ‘<p>’ . esc_html( 1TP5問候語 ) . ‘</p>’;
}
// 在插件加载时加载翻译文件
function mfp_load_textdomain() {
load_plugin_textdomain( ‘my-first-plugin’, false, dirname( plugin_basename( __FILE__ ) ) . ‘/languages/’ );
}
add_action( ‘plugins_loaded’, ‘mfp_load_textdomain’ );優化代碼同建立發佈包
完成開發之後，你需要移除除錯代碼，確保所有函數都有唯一前綴。跟住，將成個插件目錄壓縮做ZIP檔案，呢個檔案就可以透過WordPress後台上傳安裝。
確保主檔案包含一個標準嘅卸載處理程序，用嚟喺用戶刪除插件時清理數據庫選項。呢個係透過註冊一個卸載掛鉤嚟實現：
// 插件卸载时的清理操作
register_uninstall_hook( __FILE__, ‘mfp_uninstall’ );
function mfp_uninstall() {
delete_option( ‘mfp_settings’ );
}摘要
本文詳細介紹咗從零開始創建WordPress自定義插件的完整流程。我哋從了解插件基礎結構同安全規範開始，逐步深入到WordPress核心嘅掛鈎系統（動作同過濾器），並學習咗點樣構建一個帶有設置頁面嘅後台管理界面。最後，我哋仲探討咗插件嘅國際化、代碼優化同最終部署嘅準備步驟。
記住，優秀嘅插件開發唔單止係功能實現，更關乎代碼嘅安全性、可維護性同對WordPress標準嘅遵循。建議你深入學習WordPress官方插件手冊，遵循代碼規範，並喺實際項目中不斷實踐。
常見問題
開發WordPress插件需要咩預備知識？
你需要具備PHP編程嘅基礎知識，包括對變量、函數、數組同條件判斷嘅理解。同時，對HTML、CSS有基本了解，同埋對WordPress嘅基本操作同後端結構有一定認識，將會非常有幫助。了解面向對象編程（OOP）係進階開發嘅加分項。
我必须使用类（Class）来编写插件吗？
唔一定。對於簡單嘅插件，用程序式編程（一組函數）係完全可行嘅，呢篇文嘅例子都係用呢種方式。不過，對於更複雜、功能更多嘅大型插件，用面向對象編程（OOP）同埋用類嘅形式組織代碼係更好嘅選擇。咁樣可以更有效咁組織代碼，避免命名衝突，同埋提高可維護性。
點樣調試我嘅WordPress插件代碼？
啟用WordPress嘅除錯模式係首要步驟。喺網站嘅 wp-config.php 檔案入面，將 WP_DEBUG 常數設定為 true。咁樣會喺頁面顯示PHP錯誤、通知同警告。另外，你可以用 error_log() 函數將除錯信息寫入伺服器嘅錯誤日誌，或者用專業嘅除錯插件（例如 Query Monitor）嚟檢查數據庫查詢、掛鈎執行同效能問題。
插件開發中點樣確保安全性？
確保安全性嘅關鍵措施包括：一定要對用戶輸入進行驗證同清理（用 sanitize_text_field(), esc_html(), wp_kses_post() 等函數）；對所有數據庫查詢用 $wpdb 類嘅方法，並利用佢嘅prepare語句來防止SQL注入；對輸出到瀏覽器嘅所有動態內容進行轉義；用WordPress內置嘅nonce同權限檢查（current_user_can()）嚟保護表單同AJAX請求。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。