WordPress插件開發環境準備
喺開始寫代碼之前，你需要一個合適嘅開發環境。呢樣唔單止可以提高你嘅開發效率，仲可以幫你更好噉調試同測試插件。首先，你需要喺本地電腦度搭建一個WordPress運行環境。你可以揀用集成開發環境，好似XAMPP、MAMP或者Local by Flywheel，佢哋可以快速安裝PHP、MySQL同Apache/Nginx伺服器。至於WordPress核心文件，建議從官網下載同安裝最新嘅穩定版本。
確保你嘅PHP版本符合WordPress嘅最低要求，同埋啟用錯誤報告功能，呢樣對於調試好緊要。你可以喺wp-config.php檔案度加入以下代碼嚟開啟調試模式：
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true); // 将错误记录到 /wp-content/debug.log
define('WP_DEBUG_DISPLAY', false); // 不在页面上显示错误另外，一個強大嘅代碼編輯器係必不可少嘅，例如Visual Studio Code、PhpStorm或者Sublime Text。呢啲編輯器通常提供語法高亮、代碼提示同版本控制集成，可以顯著提升編碼體驗。最後，建議喺瀏覽器度安裝開發者工具，同埋考慮用專為WordPress開發設計嘅瀏覽器擴展，方便檢查掛鉤、查詢數據庫同監控性能。
推薦閱讀 WordPress插件開發入門指南：從零到一創建你嘅第一個功能模組。
創建你嘅第一個插件檔案
一個WordPress插件最基本嘅形式就係一個PHP檔案。所有插件都存放喺/wp-content/plugins/目錄入面。每個插件可以係一個獨立嘅PHP檔案，亦可以係一個包含多個檔案嘅資料夾。
首先，為你嘅插件創建一個具有獨特性嘅資料夾，例如my-first-plugin。喺呢個資料夾入面，創建主插件檔案，通常命名為同資料夾同名，即係my-first-plugin.php。呢個檔案嘅開頭必須包含一個符合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
*/呢段註釋入面嘅「Plugin Name」係必填項，佢決定咗插件喺後台管理界面嘅顯示名稱。其他資訊好似版本號、作者等有助於用戶了解插件。創建呢個檔案之後，將佢放入/wp-content/plugins/my-first-plugin/目錄。呢個時候，登入你嘅WordPress後台，進入「插件」頁面，你應該會睇到一個叫做「我嘅第一個定制化插件」嘅新插件，而且可以啟動佢。雖然佢而家仲乜都唔做，但係你已經成功創建咗一個插件嘅基本框架。
啟動同停用插件嘅處理
插件喺啟動同停用嗰陣通常需要執行一啲初始化同清理工作，例如建立數據庫表、設定默認選項或者移除臨時數據。WordPress 透過兩個特殊嘅掛鈎（Hook）嚟管理呢啲行為：register_activation_hook同埋register_deactivation_hook。
推薦閱讀 由零開始學到精通：WordPress插件開發完整指南同埋最佳實戰。
你可以喺主插件檔案度定義呢啲掛鈎。例如，當插件啟動嗰陣，我哋可能想向數據庫寫入一個默認配置選項；當插件停用嗰陣，可能需要清理呢個選項。實現代碼如下所示：
// 定义插件激活时执行的函数
function my_plugin_activate() {
// 添加一个默认选项到数据库
add_option('my_plugin_default_option', '这是默认值');
// 或者可以在这里初始化自定义数据库表（需要更复杂的SQL）
}
register_activation_hook(__FILE__, 'my_plugin_activate');
// 定义插件停用时执行的函数
function my_plugin_deactivate() {
// 删除之前创建的选项
delete_option('my_plugin_default_option');
// 注意：通常不在停用钩子中删除数据，以免用户重新激活时丢失设置
// 更常见的清理工作在卸载钩子中处理
}
register_deactivation_hook(__FILE__, 'my_plugin_deactivate');需要注意嘅係，register_deactivation_hook通常用於輕量級嘅清理，而永久性嘅數據刪除（例如刪除數據庫表）應該喺卸載掛鈎中處理，卸載功能需要通過register_uninstall_hook嚟註冊。合理噉使用呢啲掛鈎可以確保你嘅插件行為規範，唔會喺網站上留低冗餘數據。
理解同運用掛鈎同過濾器
WordPress插件開發嘅核心在於「掛鈎」（Hooks）機制，佢容許你喺特定嘅時間點或者位置插入自定義代碼，嚟修改或者擴展WordPress嘅核心功能。掛鈎主要分為兩種：動作（Actions）同過濾器（Filters）。
動作鈎容許你喺特定事件發生嗰陣執行自訂函數。例如，當文章發佈之後（publish_post）、喺網頁頭部加載嗰陣（wp_head）或者喺管理後台初始化嗰陣（admin_init）。你可以用add_action()函數嚟掛載你嘅代碼。下面係一個簡單嘅例子，佢喺每篇文章嘅結尾自動加一段自訂文本：
function add_custom_footer_to_content($content) {
if (is_single()) { // 仅在单篇文章页面添加
$custom_text = '<p><em>多謝你睇完呢篇文章！</em></p>';
$content .= $custom_text;
}
return $content;
}
// 使用‘the_content’过滤器，注意这是一个过滤器（Filter）的例子
add_filter('the_content', 'add_custom_footer_to_content');正如上面嘅代碼所示，我哋實際上用咗過濾器（Filter）。過濾器鈎用嚟修改傳畀佢嘅數據。佢同動作嘅關鍵區別在於，過濾器必須返返修改後嘅值。典型嘅過濾器包括the_content（修改文章內容）、the_title（修改標題）同excerpt_length（修改摘要長度）。對應嘅add_filter()函數用嚟掛載過濾器函數。
創建自訂掛鈎俾其他人擴展
一個設計得好嘅插件唔單止會用WordPress核心掛鈎，仲會提供自己嘅自訂掛鈎，等其他開發者可以擴展你個插件。用do_action()函數可以創建一個動作掛鈎，用apply_filters()可以創建一個過濾器掛鈎。
推薦閱讀 WordPress插件開發完整指南：從零到一開始打造你嘅專屬插件。
例如，喺你個插件處理某啲數據之前，提供一個過濾器畀其他人修改輸入參數：
// 定义插件的主要处理函数
function my_plugin_process_data($input_data) {
// 在核心处理前，允许其他开发者通过过滤器修改 $input_data
$filtered_data = apply_filters('my_plugin_filter_input', $input_data);
// ... 使用 $filtered_data 进行核心处理 ...
// 在处理完成后，触发一个动作钩子，通知其他开发者
do_action('my_plugin_after_processing', $filtered_data);
return $result;
}透過創建自定義鉤子，你個插件就會有良好嘅可擴展性，跟返WordPress本身嘅開發哲學。
為插件添加管理頁面同設定選項
大多數實用插件都需要一個後台管理介面，等網站管理員可以配置插件選項。WordPress提供咗豐富嘅API嚟創建管理菜單同設定頁面。
首先，你需要用add_action('admin_menu', 'your_function')用鉤子嚟註冊一個菜單項。喺對應嘅函數入面，用add_menu_page()或add_submenu_page()函數嚟添加頂級菜單或者子菜單。下面係一個添加頂級菜單同埋設定頁面嘅基礎示例：
// 钩入 admin_menu 来添加管理菜单
function my_plugin_add_admin_menu() {
add_menu_page(
'我的插件设置', // 页面标题
'我的插件', // 菜单标题
'manage_options', // 权限（管理员）
'my-plugin-settings', // 菜单slug
'my_plugin_settings_page', // 用于显示页面内容的回调函数
'dashicons-admin-generic', // 图标（Dashicon）
80 // 菜单位置
);
}
add_action('admin_menu', 'my_plugin_add_admin_menu');
// 定义设置页面的显示内容
function my_plugin_settings_page() {
// 检查用户权限
if (!current_user_can('manage_options')) {
return;
}
?>
<div class="wrap">
<h1><?php echo esc_html(get_admin_page_title()); ?></h1>
<form action="/yue/options.php/" method="post" data-trp-original-action="options.php">
<?php
// 输出设置字段和非ce字段
settings_fields('my_plugin_options_group');
do_settings_sections('my-plugin-settings');
submit_button('保存设置');
?>
<input type="hidden" name="trp-form-language" value="yue"/></form>
</div>
<?php
}註冊同驗證設定欄位
淨係得頁面唔夠㗎，你需要用WordPress Settings API嚟安全噉註冊、儲存同埋驗證設定選項。呢個過程包括用register_setting()、add_settings_section()同埋add_settings_field()等函數。
以下代碼展示咗點樣註冊一個設定選項組同埋一個文字欄位：
// 初始化插件设置
function my_plugin_settings_init() {
// 注册一个设置选项组及其数据
register_setting(
'my_plugin_options_group', // 选项组名，需与settings_fields()参数一致
'my_plugin_settings', // 存储在wp_options表中的选项名
'my_plugin_sanitize_input' // 可选的验证回调函数
);
// 添加一个设置区域
add_settings_section(
'my_plugin_section_main',
'主要设置',
null, // 区域描述的回调函数，可为空
'my-plugin-settings' // 所属页面的slug
);
// 向该区域添加一个具体的字段
add_settings_field(
'my_plugin_field_text',
'示例文本字段',
'my_plugin_field_text_render', // 渲染字段HTML的回调函数
'my-plugin-settings',
'my_plugin_section_main'
);
}
add_action('admin_init', 'my_plugin_settings_init');
// 渲染文本输入字段的函数
function my_plugin_field_text_render() {
$options = get_option('my_plugin_settings');
$value = $options['text_field'] ?? ''; // PHP 7.0+ 空合并运算符
?>
<input type='text' name='my_plugin_settings[text_field]' value='<?php echo esc_attr($value); ?>'>
<?php
}
// 清理和验证输入的函数
function my_plugin_sanitize_input($input) {
$sanitized_input = [];
if (isset($input['text_field'])) {
// 清理文本输入，移除非法标签
$sanitized_input['text_field'] = sanitize_text_field($input['text_field']);
}
return $sanitized_input;
}透過Settings API，WordPress會自動處理選項嘅儲存、安全驗證同權限檢查，大大簡化咗開發流程同提高咗安全性。
摘要
透過呢個指南，我哋系統性咁行過咗WordPress插件開發嘅主要步驟：由搭建環境、創建基礎插件文件，到理解同運用核心嘅掛鈎機制，最後為插件加入專業嘅管理介面同設定選項。每個環節都展示咗關鍵嘅代碼片段同標準實踐。插件開發嘅核心在於利用好WordPress龐大嘅掛鈎系統來擴展功能，同時跟返佢嘅API規範來保證安全性同兼容性。記住，由一個簡單嘅想法開始，逐步增加功能，同埋始終喺開發過程中進行充分測試，係構建優秀插件嘅有效路徑。跟住落嚟，你可以探索更多高級主題，例如創建自訂文章類型、加入短代碼（Shortcode）、處理AJAX請求同埋國際化你嘅插件。
常見問題
開發WordPress插件係咪一定要精通PHP？
係呀，具備紮實嘅PHP基礎係必須嘅。因為WordPress核心同佢嘅插件都係用PHP編寫嘅。你需要理解PHP嘅語法、函數、面向對象編程等概念。同時，對HTML、CSS同JavaScript有基本了解，對於創建用戶介面同互動都好有幫助。
一個插件必須包含幾多個檔案？
冇強制要求。一個插件可以只包含一個PHP主檔案。但隨住功能變得複雜，將代碼模組化到多個檔案中（例如admin.php處理後台，public.php處理前端，includes將公共函數放喺文件夾入面係更好嘅做法，有助於代碼嘅組織同維護。
點解我個插件啟動之後會令網站白屏？
呢個通常係由致命錯誤（Fatal Error）引起嘅，例如語法錯誤、調用唔存在嘅函數或者類。請確保你已經喺wp-config.php入面開啟咗WP_DEBUG模式，並檢查wp-content/debug.log檔案中嘅錯誤信息。透過FTP或檔案管理器停用你嘅插件（重新命名插件資料夾）可以快速恢復網站訪問。
點樣安全咁處理用戶喺前端提交嘅數據？
絕對唔可以信賴用戶輸入。喺處理任何嚟自表格、URL參數或Cookie嘅數據之前，必須進行驗證、清理同轉義。WordPress提供咗大量安全函數，例如sanitize_text_field()（清理文字）、esc_url()（轉義URL）、wp_kses_post()（按允許嘅HTML標籤過濾內容）同埋intval()（轉為整數）。喺將數據輸出到HTML頁面嗰陣，務必要用esc_html()、esc_attr()等函數進行轉義。
點樣可以令我個插件嘅文字支援多語言？
呢個需要透過國際化（i18n）嚟實現。喺你嘅代碼入面，將所有需要翻譯嘅字串用__()或_e()函數包住。然後喺插件頭部註解度正確設定Text Domain同埋Domain Path。用好似Poedit呢類工具嚟建立.pot模板檔案，並為其生成唔同語言嘅.po同埋.mo翻譯檔案。WordPress會根據網站嘅語言設定自動載入對應嘅翻譯。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。