WordPress插件開發環境準備
喺開始寫第一行code之前，一個合適嘅開發環境係高效工作嘅基石。咁樣唔單止可以確保你個插件喺唔同嘅WordPress環境都行得穩陣，仲可以大大提升debug同測試嘅效率。
本地開發環境搭建
強烈建議喺本地開發，唔好直接喺線上server搞。你可以用XAMPP、MAMP、Local by Flywheel或者Docker呢啲工具，好快咁起返個包含PHP、MySQL同Apache/Nginx嘅本地server環境。要確保你嘅PHP版本同目標WordPress版本兼容，通常WordPress官方會推薦一個PHP版本範圍。
代碼編輯器同工具選擇
揀個功能強大嘅code編輯器好緊要，例如VS Code、PhpStorm或者Sublime Text。佢哋通常會提供語法高亮、code提示、版本控制集成呢啲功能。另外，裝返啲WordPress相關嘅code snippets或者插件，可以加快add_action、add_filter等常用函數嘅編寫。
推薦閱讀 從零開始掌握WordPress插件開發：打造自訂功能與最佳實踐指南。
建立插件嘅主檔案
每個WordPress插件都一定要有個主PHP文件，同埋喺檔案開頭包含標準嘅插件資訊註解。呢個檔案係插件嘅入口點。例如，我哋打算創建一個叫「My Custom Greeting」嘅插件，咁主檔案就可以命名為my-custom-greeting.php。
<?php
/**
* Plugin Name: My Custom Greeting
* Plugin URI: https://yourwebsite.com/my-custom-greeting
* Description: 一个简单的插件，用于在网站前台显示自定义问候语。
* Version: 1.0.0
* Author: Your Name
* License: GPL v2 or later
* Text Domain: my-custom-greeting
*/呢段註解係必需嘅，WordPress靠佢嚟識別插件同喺後台管理介面度顯示。
插件基礎結構同安全規範
一個結構清晰、符合安全規範嘅插件係長期維護同攞到用戶信任嘅基礎。跟從WordPress官方嘅編碼標準同安全實踐可以有效避免常見漏洞。
使用類來組織程式碼
雖然你可以用純函數式編程，但用面向對象（OOP）嘅類來封裝插件功能係更現代同推薦嘅做法。咁樣可以避免函數名撞名，令程式碼結構更清晰。我哋創建一個主類My_Custom_Greeting。
if ( ! class_exists( 'My_Custom_Greeting' ) ) {
class My_Custom_Greeting {
public function __construct() {
// 构造函数，在这里挂载钩子
}
}
// 初始化插件
new My_Custom_Greeting();
}! class_exists()嘅檢查係為咗防止類被重複定義。
推薦閱讀 WordPress插件開發入門指南：從零到一構建你嘅第一個功能擴展。
實現安全性同權限檢查
所有可能喺前端或者後端處理用戶請求嘅函數，都必須進行權限同埋安全檢查。WordPress提供咗wp_verify_nonce()同埋current_user_can()等函數嚟幫手實現。喺任何插件設定頁面或者表單處理邏輯入面，呢個係強制要求。
外掛目錄同檔案組織
合理嘅目錄結構有助於管理。一個典型嘅插件目錄可能包含：
- 主檔案 my-custom-greeting.php (位於插件根目錄)
- includes/ 目錄：存放核心功能類檔案
- admin/ 目錄：存放後台相關代碼
- public/ 目錄：存放前台相關代碼
- assets/ 目錄：存放CSS、JavaScript同圖片
- languages/ 目錄：存放國際化翻譯檔案（.po/.mo）
核心功能：掛鈎與過濾器實戰
WordPress嘅外掛機制核心係「掛鈎」（Hooks），包括動作（Action）同過濾器（Filter）。理解同熟練運用掛鈎係外掛開發嘅關鍵。
使用動作鈎子添加功能
動作掛鈎容許你喺特定時間點（例如初始化、載入頁面、發佈文章嗰陣）執行自訂程式碼。我哋用add_action()函數嚟掛載。例如，喺wp_footer掛鈎處加我哋嘅問候語。
在My_Custom_Greeting類嘅構造函數中掛載：
public function __construct() {
add_action( 'wp_footer', array( $this, 'display_greeting' ) );
}然後定義對應嘅回調方法display_greeting：
推薦閱讀 WordPress插件開發完全指南：從零開始構建專業擴展。
public function display_greeting() {
$name = get_option( 'my_greeting_name', '访客' );
echo '<p id="custom-greeting">你好，' . esc_html( $name ) . '！歡迎嚟到本站。</p>';
}用過濾器鈎修改內容
過濾器掛鉤容你修改WordPress或者其他插件產生嘅數據。我哋用add_filter()函數。例如，修改文章標題嘅預設後綴。
add_filter( 'the_title', array( $this, 'modify_post_title' ), 10, 2 );
public function modify_post_title( $title, $id ) {
if ( ! is_admin() && in_the_loop() ) {
$title .= ' [推荐阅读]';
}
return $title;
}呢度嘅參數10係優先級，2表示回調函數接受兩個參數（$title同埋$id）。
建立自訂鉤子
一個成熟嘅插件仲應該提供自己嘅鉤子，俾其他開發者擴展。用do_action()創建動作鉤子，用apply_filters()創建過濾器鉤子。
// 在插件某处执行一个自定义动作
do_action( 'my_custom_greeting_before_display', $name );
// 提供一个可过滤的问候语文本
$greeting_text = apply_filters( 'my_custom_greeting_text', '你好，' . $name . '！', $name );為插件創建管理介面
大多數插件都需要一個後台設定頁面，等用戶可以配置插件行為。WordPress提供咗豐富嘅API嚟創建菜單頁同選項頁。
添加管理菜單
使用add_action( ‘admin_menu’, … )掛鈎嚟添加菜單項目。我哋為插件添加一個喺「設定」下面嘅子菜單頁。
add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
public function add_admin_menu() {
add_options_page(
'自定义问候语设置', // 页面标题
'问候语设置', // 菜单标题
'manage_options', // 所需权限
'my-custom-greeting', // 菜单slug
array( $this, 'render_settings_page' ) // 回调函数，用于输出页面内容
);
}構建設置頁面同表單
喺回調函數render_settings_page喺度，我哋需要輸出一個表單，並且用 WordPress 設定 API 嚟安全噉保存數據。首先，註冊一個設定。
add_action( 'admin_init', array( $this, 'register_settings' ) );
public function register_settings() {
register_setting(
'my_custom_greeting_options_group', // 选项组名
'my_greeting_name', // 选项名
array( 'sanitize_callback' => 'sanitize_text_field' ) // 清理回调
);
}跟住喺頁面渲染函數度輸出表單：
public function render_settings_page() {
?>
<div class="wrap">
<h2>自訂問候語設定</h2>
<form method="post" action="/yue/options.php/" data-trp-original-action="options.php">
<?php settings_fields( 'my_custom_greeting_options_group' ); ?>
<table class="form-table">
<tr>
<th scope="row"><label for="greeting_name">問候對象名稱</label></th>
<td>
<input type="text" id="greeting_name" name="my_greeting_name" value="<?php echo esc_attr( get_option( 'my_greeting_name', '访客' ) ); ?>" class="regular-text" />
<p class="description">呢度輸入嘅名會顯示喺前台嘅問候語入面。</p>
</td>
</tr>
</table>
<?php submit_button(); ?>
<input type="hidden" name="trp-form-language" value="yue"/></form>
</div>
<?php
}加入腳本同埋樣式表
為咗令管理介面更加靚或者有互動性，需要為設定頁面加入 CSS 同埋 JavaScript。使用admin_enqueue_scripts鉤子，並檢查頁面slug以確保只喺我哋插件嘅頁面加載。
add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_admin_assets' ) );
public function enqueue_admin_assets( $hook ) {
if ( 'settings_page_my-custom-greeting' !== $hook ) {
return;
}
wp_enqueue_style( 'my-custom-greeting-admin', plugin_dir_url( __FILE__ ) . 'assets/css/admin-style.css' );
wp_enqueue_script( 'my-custom-greeting-admin', plugin_dir_url( __FILE__ ) . 'assets/js/admin-script.js', array( 'jquery' ), '1.0.0', true );
}摘要
透過本文嘅步驟，我哋完成咗一個完整WordPress插件嘅開發流程：從環境搭建、創建基礎安全結構，到利用動作與過濾器鉤子實現核心功能，最後創建用戶友好嘅管理界面。插件開發嘅核心在於深入理解WordPress嘅鉤子系統，並遵循其安全與編碼標準。從呢個小插件出發，你可以透過引入更多嘅類、使用更複雜嘅數據庫操作、集成REST API或者創建自定義區塊（Gutenberg Block）來不斷擴展其功能，最終構建出功能強大、易於維護嘅專業級插件。
常見問題
### 點樣調試我嘅WordPress插件？
啟用WordPress嘅調試模式係最有效嘅方法。喺wp-config.php檔案入面，將WP_DEBUG常數設定為true。咁樣會直接喺頁面上顯示PHP錯誤、警告同通知。對於更複雜嘅除錯，可以用error_log()個函數會將資料記錄喺伺服器嘅錯誤日誌度，或者用專業嘅PHP除錯工具例如Xdebug。
我個插件點樣可以兼容唔同嘅PHP版本？
開發嘅時候，應該避免用啲太新或者太舊、已經唔再支援嘅PHP函數。查下PHP官方手冊，了解函數最低支援嘅版本。喺插件嘅主檔案或者說明文件度，可以透過Requires PHP:頭部標籤嚟聲明插件需要嘅最低PHP版本，咁樣WordPress就會喺唔符合條件嘅時候彈警告。
點樣可以令我嘅插件支援多語言國際化？
WordPress用GNU gettext框架實現國際化（i18n）。首先，喺所有需要翻譯嘅字串處用__()、_e()或_x()等函數包裝。然後，用好似Poedit咁嘅工具掃描代碼生成.pot模板檔案，再為每種語言創建相應嘅.po同埋.mo檔案。最後，喺插件載入嗰陣用load_plugin_textdomain()函數加載翻譯。
插件提交到WordPress官方目錄需要注意咩？
提交前，請確保代碼嚴格遵循WordPress編碼標準同文檔規範。插件必須使用GPLv2或更高兼容許可證。需要提供詳盡readme.txt文件，包含描述、安裝步驟、截圖、常見問題等。你嘅代碼必須安全、冇惡意行為，而且唔可以將核心功能依賴於短代碼（Shortcode）——佢應該開箱即用。提交後，審核團隊會進行嚴格檢查。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。