WordPress插件開發環境設定
喺開始編寫你第一個插件之前，一個穩定、隔離同埋功能齊全嘅開發環境係至關重要嘅。咁樣唔單止可以保護你嘅生產網站，仲可以提供調試同測試所需嘅所有工具。
本地開發環境嘅配置
最推薦嘅方式係使用本地伺服器環境，例如 Local by Flywheel、XAMPP 或者 MAMP。呢啲工具可以一鍵安裝 WordPress，並且集成了 PHP、MySQL 同埋網頁伺服器。請確保你嘅 PHP 版本同目前 WordPress 官方推薦版本保持一致，同埋開啟錯誤報告功能，咁樣有助於喺開發初期發現潛在問題。
喺你嘅 WordPress 安裝目錄下 wp-content/plugins 嘅資料夾入面，為你嘅新插件創建一個獨立嘅資料夾，例如 my-first-plugin。所有插件文件都会摆喺呢度。
推薦閱讀 全面解析SEO優化：從技術架構到內容策略嘅實戰指南。
代码编辑器嘅拣择同调试工具
拣一款强劲嘅代码编辑器可以大大提升开发效率，例如 Visual Studio Code、PHPStorm 或者 Sublime Text。记得为编辑器安装 WordPress 代码片段、PHP IntelliSense 同 PHP 调试等扩展。
至于调试，除咗开启 WordPress 嘅 WP_DEBUG 模式（喺 wp-config.php 檔案入面設定 define('WP_DEBUG', true);），仲建議安裝 Query Monitor 插件。佢係一個開發者面板，能夠實時顯示數據庫查詢、PHP 錯誤、掛鉤（Hooks）同腳本等關鍵信息，係插件開發嘅「瑞士軍刀」。
創建你嘅第一個WordPress插件
一個標準嘅 WordPress 插件至少需要一個主檔案。呢個主檔案需要包含特定嘅插件標頭信息，等 WordPress 能夠識別同載入佢。
編寫插件嘅主檔案
喺你嘅插件文件夾（例如 my-first-plugin）入面，建立一個 PHP 檔案，通常以插件名稱命名，例如 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
*/呢段註解係插件嘅「身份證」。當中，Plugin Name 係必填項，其他都係可選。WordPress 正係透過掃描呢啲資訊，喺後台插件列表度顯示你嘅插件。
推薦閱讀 WordPress插件開發完全指南：由零開始到高級進階。
實現一個基礎功能
等我哋為呢個插件加個簡單功能：喺文章內容嘅尾自動加一段自訂文字。我哋會用 the_content 過濾器。
喺插件頭信息下面，加以下嘅代碼：
// 在文章内容末尾添加自定义文本
function myfp_add_footer_text($content) {
// 仅对单篇文章生效
if (is_single()) {
$custom_text = '<p><em>多謝你睇完！呢篇文由「我嘅第一個插件」提供支援。</em></p>';
$content .= $custom_text;
}
return $content;
}
add_filter('the_content', 'myfp_add_footer_text');保存檔案之後，去 WordPress 後台嘅「插件」頁面，你應該會見到「我嘅第一個插件」。啟動佢，跟住瀏覽網站嘅一篇文章，你會見到預設嘅文字已經加咗喺文章末尾。呢個簡單例子示範咗點樣用「過濾器（Filter）」嚟修改 WordPress 嘅輸出。
深入插件核心：掛鈎同 API
WordPress 插件強大功能嘅基石係佢嘅「掛鈎（Hooks）」系統同豐富嘅 API。理解佢哋係進階開發嘅關鍵。
理解動作同過濾器鉤子
鉤仔分為兩種主要類型：動作（Action）同過濾器（Filter）。
動作鉤仔容許你喺特定嘅 WordPress 執行點（例如發佈文章、載入後台）插入自訂程式碼。用 add_action() 函數嚟掛載。佢只係執行操作，唔期望有返回值。
過濾器鉤仔就容許你修改 WordPress 喺處理過程中產生嘅數據。用 add_filter() 函數嚟掛載。你必須接收一個輸入值，修改之後將佢返回。
例如，喺用戶登入嗰陣發送電郵係一個動作：
推薦閱讀 從零開始打造一個獨立嘅 WooCommerce 電子商務網站:實用嘅逐步指南。
function myfp_on_user_login($user_login, $user) {
wp_mail($user->user_email, '欢迎回来！', '您刚刚成功登录了网站。');
}
add_action('wp_login', 'myfp_on_user_login', 10, 2);而修改文章標題就係一個過濾器：
function myfp_prepend_title($title) {
return '精选：' . $title;
}
add_filter('the_title', 'myfp_prepend_title');常用API接口詳解
WordPress 提供咗大量安全嘅 API 函數，避免你直接操作數據庫。
* 选项 API：使用 add_option(), get_option(), update_option() 嚟儲存同攞返插件嘅設定數據。呢啲數據會儲存喺 wp_options 表入面。
* 设置 API：用于在后台“设置”或独立页面中创建标准化、安全且可验证的表单字段。它简化了设置页面的创建过程，并自动处理安全校验（Nonce）和数据存储。核心函数包括 register_setting(), add_settings_section() 同埋 add_settings_field()。
* 数据库 API：通过 $wpdb 全域對象嚟自定義數據庫操作。佢提供咗好似 $wpdb->insert(), $wpdb->update(), $wpdb->get_results() 噉嘅方法，而且已經處理咗表前綴同 SQL 注入防護。
* HTTP API：使用 wp_remote_get() 或 wp_remote_post() 嚟發起遠程 HTTP 請求。佢比原生嘅 PHP 函數好似 file_get_contents() 更加安全、兼容性更加好，仲支援 SSL 同代理。
構建插件後臺同用戶介面
一個成熟嘅插件通常需要一個配置頁面，等用戶可以自訂佢嘅行為。WordPress 提供多種方式將頁面加到後臺選單入面。
建立管理選單同子選單
使用 add_menu_page() 函數可以喺後台左邊導航欄加一個頂級選單項目。用 add_submenu_page() 可以幫佢加子頁面。呢啲函數通常喺 admin_menu 喺動作掛鈎度調用。
下面係一個建立頂級選單同埋設定頁面嘅例子：
// 添加后台菜单
function myfp_add_admin_menu() {
// 添加顶级菜单
add_menu_page(
'我的插件设置', // 页面标题
'我的插件', // 菜单标题
'manage_options', // 权限要求
'myfp-settings', // 菜单slug
'myfp_settings_page_html', // 用于输出页面内容的回调函数
'dashicons-admin-generic', // 图标
80 // 位置
);
}
add_action('admin_menu', 'myfp_add_admin_menu');
// 设置页面HTML内容
function myfp_settings_page_html() {
// 权限检查
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
// 输出设置字段、节和安全字段
settings_fields('myfp_options'); // 与 register_setting() 的选项组名匹配
do_settings_sections('myfp-settings'); // 与页面slug匹配
submit_button('保存设置');
?>
<input type="hidden" name="trp-form-language" value="yue"/></form>
</div>
<?php
}使用設定API建立表格
為咗令上面個表單真係行得通，我哋需要用設定API嚟註冊欄位。呢樣嘢通常 admin_init 鉤子度完成。
// 初始化设置
function myfp_settings_init() {
// 注册一个设置选项
register_setting('myfp_options', 'myfp_settings');
// 添加一个设置节
add_settings_section(
'myfp_section_basic',
'基础设置',
null, // 节描述回调函数，可为空
'myfp-settings'
);
// 为节添加一个文本字段
add_settings_field(
'myfp_field_footer_text',
'页脚文本',
'myfp_field_footer_text_html', // 渲染字段HTML的回调函数
'myfp-settings',
'myfp_section_basic',
['label_for' => 'myfp_field_footer_text']
);
}
add_action('admin_init', 'myfp_settings_init');
// 字段HTML渲染函数
function myfp_field_footer_text_html() {
$options = get_option('myfp_settings');
$value = $options['footer_text'] ?? '默认文本';
?>
<input type="text"
id="myfp_field_footer_text"
name="myfp_settings[footer_text]"
value="<?php echo esc_attr($value); ?>"
class="regular-text">
<?php
}透過咁樣嘅組合，我哋就整咗個有驗證同儲存功能嘅標準化後台設定頁面。用戶保存之後，數值會透過 get_option('myfp_settings') 被攞到同用喺插件功能度。
摘要
WordPress插件開發係由理解基礎結構（插件頭、檔案組織）開始，逐步掌握核心機制（鈎子、API）嘅過程。透過搭建專業嘅本地環境，你可以安全咁做實驗同除錯。整第一個插件令你熟悉插件俾WordPress識別同載入嘅流程。深入理解動作同過濾器鈎子，以及選項、設定、數據庫等API，係你構建功能強大又安全插件嘅基礎。最後，利用WordPress提供嘅管理選單函數同設定API，你可以為用戶整出體驗一致、易於配置嘅後台介面。跟住呢啲步驟同最佳實踐，你就可以由零開始，構建出滿足各種需求嘅WordPress插件。
常見問題
開發WordPress插件需要啲咩基礎知識？
你需要具備PHP編程語言嘅基礎知識，因為插件主要用PHP編寫。同時，對HTML、CSS同JavaScript有基本了解，呢啲對於創建前端展示同互動界面非常重要。熟悉MySQL數據庫嘅基本概念（例如增刪改查）亦有助理解WordPress嘅數據操作。最後，了解WordPress本身嘅基本架構同常用模板標籤係必不可少嘅。
點樣確保我開發嘅插件係安全嘅？
確保插件安全需要遵循多項最佳實踐。首先，對所有用戶輸入嘅數據進行驗證、清理同轉義。使用WordPress提供嘅函數例如 esc_html(), esc_attr(), sanitize_text_field() 同埋 wp_kses()。其次，喺執行任何涉及數據修改嘅操作（如表單提交）時，必須使用Nonce（一次性令牌）來驗證請求嘅意圖同來源。最後，喺直接同數據庫互動時，務必使用 $wpdb 類提供嘅方法，或者使用更高級嘅API，避免手寫SQL語句以防止注入攻擊。
插件嘅主檔案可以任意命名嗎？
可以，但係必須遵循一定嘅規範。主PHP檔案可以任意命名，但通常建議使用同插件目錄名或插件名稱一致、全細楷並用連字號分隔嘅名稱，例如 my-awesome-plugin.php。關鍵係，呢個檔案必須包含正確嘅插件頭註釋（即 Plugin Name: 等），因為WordPress係透過掃描檔案內容中嘅呢啲特定註釋嚟識別插件，而唔係透過檔案名。
點樣為我嘅插件加入多語言支援？
為插件加入多語言支援（國際化同本地化）主要分為三個步驟。第一步，喺插件代碼入面，將所有需要翻譯嘅字串用 __() 或 _e() 等函數包住，並設定文字域（Text Domain）。第二步，喺插件頭註解入面正確聲明 Text Domain 同埋 Domain Path。第三步，用好似Poedit咁嘅工具，掃描插件代碼生成 .pot 模版檔案，然後為每種語言翻譯並生成對應嘅 .po 同埋 .mo 檔案，將其放喺指定嘅語言目錄下。WordPress會根據網站嘅語言設定自動加載對應嘅翻譯。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。