WordPress插件開發基礎同環境搭建
WordPress插件係擴展WordPress核心功能嘅獨立代碼包。要開始開發，首先需要建立一個專業嘅本地開發環境。呢個通常包括安裝本地伺服器軟件（例如XAMPP、MAMP或者Local by Flywheel）、一個代碼編輯器（例如VS Code或者PhpStorm），同埋一個用嚟測試嘅WordPress安裝。用本地環境可以避免喺線上網站做實驗性開發可能帶嚟嘅風險。
準備好之後，創建第一個插件好簡單。只需要喺WordPress嘅wp-content/plugins目錄下新建一個文件夾，例如my-first-plugin，然後喺嗰個文件夾入面創建一個主PHP文件，文件名通常同文件夾名一樣。呢個主文件嘅開頭必須包含標準嘅插件頭註釋，呢個係WordPress識別插件嘅關鍵。
插件主檔案嘅必備結構
插件嘅主檔案係插件嘅入口點，佢頂部嘅註釋區塊包含咗一系列元數據。其中，Plugin Name係唯一必需嘅欄位，佢會喺WordPress後台嘅插件列表中顯示。一個最基本嘅插件可以只包含呢個標頭資訊，而唔包含任何實際運行嘅代碼。
推薦閱讀 WordPress 插件開發完全指南：從入門到精通實戰教程。
以下係一個最簡插件檔案嘅示例代碼：
<?php
/**
* Plugin Name: 我的第一个插件
* Description: 这是一个用于学习的简单WordPress插件。
* Version: 1.0.0
* Author: 你的名字
* License: GPL v2 or later
* Text Domain: my-first-plugin
*/將上面啲代碼保存之後，登入WordPress後台嘅「插件」頁面，你就會睇到呢個新插件同可以啟動佢。雖然佢暫時仲未有任何功能，但呢個標誌住開發流程正式開始。
核心機制：動作鈎子同過濾器
WordPress插件開發嘅核心哲學係「鈎子（Hooks）」，佢容許你嘅代碼喺特定時刻或者對特定數據「掛鈎」到WordPress嘅核心流程入面。鈎子主要分為兩類：動作（Actions）同過濾器（Filters）。
動作鈎子喺特定事件發生嗰陣執行你嘅自訂函數，例如喺文章發佈之後、喺頁面頭部載入腳本嗰陣等等。佢哋用嚟「做啲嘢」。使用add_action()函數可以將你嘅函數掛載到指定嘅動作鉤上。
使用動作鈎子添加功能
例如，如果你想喺網站嘅頁腳加一段自訂文本，可以利用wp_footer呢個動作鉤。首先，你需要喺主插件檔案度寫一個自訂函數，然後用add_action()將佢綁定到個鉤度。
推薦閱讀 掌握WordPress插件開發：由零到一建立你嘅第一個自訂插件。
以下係一個實現示例：
function myplugin_add_footer_text() {
echo '<p style="text-align:center;">多謝使用呢個網站！</p>';
}
add_action( 'wp_footer', 'myplugin_add_footer_text' );當WordPress執行到wp_footer掛鉤嗰陣，就會自動調用myplugin_add_footer_text()函數，輸出你定義嘅文本。
使用過濾器鈎修改數據
過濾器掛鉤就用嚟修改數據。佢哋喺數據被使用（例如存入數據庫或者輸出到瀏覽器）之前對其進行處理。佢哋用嚟「修改某啲嘢」。使用add_filter()用函數嚟應用過濾器。例如，想改所有文章標題嘅話，可以喺顯示之前加個前綴。
下面段code示範咗點樣幫所有文章標題加個「[推薦]」前綴：
function myplugin_modify_title( $title ) {
if ( is_single() ) {
$title = '[推荐] ' . $title;
}
return $title;
}
add_filter( 'the_title', 'myplugin_modify_title' );建立插件後台管理頁面
好多插件需要俾用戶設定選項，呢樣嘢就要喺WordPress後台整管理選單同設定頁面。WordPress提供咗一系列函數嚟加頂級選單或者子選單項目。
添加頂級管理選單
你可以用add_menu_page()函數為你嘅插件創建一個獨立嘅後台菜單。呢個函數需要多個參數，包括頁面標題、菜單標題、用戶權限、菜單別名、生成頁面內容嘅回調函數等。
推薦閱讀 一步步教你由零開始掌握 WordPress 插件開發。
喺度，回調函數myplugin_settings_page_html負責輸出設定頁面嘅HTML內容。
添加菜單嘅代碼通常需要掛喺admin_menu呢個動作掛喺鉤子上，確保喺管理介面初始化嗰陣執行。
構建設置頁面同安全表單
喺設置頁面嘅回調函數入面，你需要輸出一個表單，同埋處理表單嘅提交。WordPress 提供咗設置 API 嚟簡化呢個過程，佢可以安全噉處理選項嘅註冊、保存同埋渲染。但為咗理解基本原理，我哋可以先睇一個手動處理表單提交嘅簡單例子。
下面嘅代碼示範咗點樣創建一個包含輸入框嘅簡單設置頁面，同埋安全噉保存數據：
function myplugin_settings_page_html() {
// 检查用户权限
if ( ! current_user_can( 'manage_options' ) ) {
return;
}
// 处理表单提交
if ( isset( $_POST['myplugin_option'] ) ) {
// 安全检查：验证随机数
check_admin_referer( 'myplugin_save_settings' );
// 清理并保存数据
$option_value = sanitize_text_field( $_POST['myplugin_option'] );
update_option( 'myplugin_custom_option', $option_value );
echo '<div class="notice notice-success"><p>設定已儲存！</p></div>';
}
// 获取已保存的值
$saved_value = get_option( 'myplugin_custom_option', '默认值' );
?>
<div class="wrap">
<h1>我嘅插件設定</h1>
<form method="post" action="">
<?php wp_nonce_field( 'myplugin_save_settings' ); ?>
<label for="myplugin_option">選項：</label>
<input type="text" id="myplugin_option" name="myplugin_option" value="<?php echo esc_attr( $saved_value ); ?>" />
<?php submit_button( '保存更改' ); ?>
<input type="hidden" name="trp-form-language" value="yue"/></form>
</div>
<?php
}進階開發與插件發佈
當插件功能趨向複雜時，良好嘅代碼組織至關重要。建議採用物件導向編程（OOP）嘅方式，將插件功能封裝喺類入面。咁樣有助於避免函數名衝突，令代碼結構更清晰、更易維護。
插件國際化係走向世界嘅關鍵。使用__()同埋_e()等函數將所有面向用戶嘅文字包住，並透過load_plugin_textdomain()函數加載翻譯檔案。喺插件頭註釋中正確設定Text Domain亦都係必須嘅。
插件發佈前嘅準備工作
喺將插件提交到官方目錄或者進行分發之前，必須進行徹底測試。呢個包括喺唔同PHP版本、WordPress版本以及各種主題同插件組合下嘅兼容性測試。代碼應該跟從WordPress編碼標準，同埋做好安全防護，對所有用戶輸入進行驗證、清理同轉義。
為插件編寫清晰嘅README.txt文件，說明佢嘅功能、安裝方法、常見問題等。最後，將代碼打包成ZIP檔案，就可以提交到WordPress.org插件目錄或者喺你自己嘅網站上分發。
摘要
WordPress插件開發係一個從理解基礎掛鉤機制開始，逐步深入創建管理介面、組織代碼結構，最終實現安全發佈嘅過程。掌握動作同過濾器掛鉤嘅使用係核心，佢哋係同WordPress互動嘅橋樑。無論係添加一個簡單功能定係構建複雜嘅商業插件，遵循安全編碼規範、進行充分測試同考慮國際化都係成功嘅關鍵。通過持續實踐，你將能夠創建出強大、穩定且受歡迎嘅WordPress插件。
常見問題
開發插件前必須學PHP嗎？
係嘅，具備紮實嘅PHP基礎知識係開發WordPress插件嘅必要條件。因為WordPress本身同埋佢嘅插件絕大部分都係用PHP編寫嘅。你需要了解PHP嘅語法、函數、變數、陣列、面向對象編程等等概念，先至能夠有效咁編寫同埋調試插件代碼。
點樣避免我嘅插件函數名同其他插件撞名？
避免函數名衝突嘅最佳做法係使用面向對象編程，將你所有嘅函數封裝喺一個類嘅方法入面。如果使用過程式編程，就應該為所有函數名加上一個獨特嘅前綴，通常同你嘅插件名稱或者縮寫有關，例如myplugin_或mp_。咁樣可以大大降低命名衝突嘅可能性。
點解我嘅插件設定保存之後，一刷新頁面就消失咗？
呢個通常係因為冇正確處理表單提交嘅隨機數驗證。喺保存表單數據之前，必須使用check_admin_referer()或wp_verify_nonce()函數嚟驗證隨機數，以確保請求嚟自正確嘅來源並防止跨站請求偽造攻擊。如果驗證失敗，WordPress會阻止數據保存。
點樣可以令我插件嘅文字可以翻譯成其他語言？
你需要對插件中所有面向用戶嘅字串進行國際化處理。使用__()函數攞到字串嘅翻譯，或者用_e()函數直接輸出翻譯。你仲需要喺插件初始化嗰陣（例如掛載到plugins_loaded鈎度）callload_plugin_textdomain()函數嚟載入對應嘅語言檔案。工具好似Poedit可以幫你創建.pot模板檔案同.po/.mo翻譯檔案。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。