WordPress插件開發環境準備
喺開始寫代碼之前，一個穩定、隔離嘅開發環境至關重要。呢樣嘢唔單止可以保護你嘅生產網站，仲可以俾你自由噉測試同除錯。最推薦嘅方法係用本地開發環境，例如 Local by Flywheel、XAMPP 或者 MAMP。呢啲工具可以一鍵喺本地電腦度安裝 WordPress 需要嘅 PHP、MySQL 同網頁伺服器。
跟住，你需要喺本地 WordPress 安裝度啟用除錯模式。咁樣有助於喺開發過程中快速發現錯誤。打開 WordPress 根目錄下嘅 wp-config.php 檔案，搵到或者加入以下常量定義：
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );咁樣設定之後，所有錯誤同警告訊息就會被記錄到 /wp-content/debug.log 喺文件入面，而唔會直接顯示喺頁面上影響前端用戶。
推薦閱讀 WordPress插件開發入門指南：由零開始創建你嘅第一個自訂插件。
最後，你需要一個代碼編輯器。Visual Studio Code、PhpStorm 同埋 Sublime Text 都係唔錯嘅選擇，佢哋對 PHP 同 WordPress 開發有好好嘅語法高亮同代碼提示支援。確保你嘅編輯器可以方便噉存取本地伺服器上嘅項目文件。
創建你嘅第一個插件
一個 WordPress 插件本質上係一個或者多個位於 wp-content/plugins 目錄下嘅 PHP 文件。每個插件都必須要有一個主文件，而且呢個文件頭部需要包含標準嘅插件資訊註釋，咁樣 WordPress 先至可以識別到佢。
編寫插件頭部信息
喺你嘅 wp-content/plugins 喺目錄下邊，開一個新嘅資料夾，例如 my-first-plugin。喺呢個文件夾入面，整一個主文件 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
*/呢段註解入面嘅「Plugin Name」係必須填寫嘅，其他都係可揀嘅。WordPress 會讀取呢啲資料，並且喺後台嘅「插件」管理頁面度顯示出嚟。
實現一個簡單嘅功能
而家，等我哋為呢個插件加第一個實際功能：喺文章內容嘅最尾自動加一段自訂文字。我哋會用 the_content 呢個過濾器掛鉤（Filter Hook）。
推薦閱讀 WordPress插件開發入門到精通：實戰經驗同核心技巧分享。
喺頭部註解下面，加以下呢段代碼：
function myfp_add_text_to_content( $content ) {
if ( is_single() && in_the_loop() && is_main_query() ) {
$custom_text = '<p><em>多謝你睇完呢篇文章，由「我嘅第一個插件」為你帶嚟。</em></p>';
$content .= $custom_text;
}
return $content;
}
add_filter( 'the_content', 'myfp_add_text_to_content' );保存檔案之後，入去 WordPress 後台嘅「插件」頁面，你應該會睇到「我嘅第一個插件」。啟動佢，然後去睇吓網站嘅一篇文章，你會發現文章末尾已經加咗我哋定義嘅文字。呢段代碼入面，myfp_add_text_to_content 係我哋定義嘅函數，add_filter() 將其掛載到 the_content 鈎子上。函數入面嘅條件判斷確保咗呢段文字只會喺前台單獨嘅文章頁面主循環中顯示。
理解WordPress插件核心機制
WordPress 插件強大而靈活嘅基石係佢嘅掛鈎（Hooks）機制。掛鈎容許你喺 WordPress 核心程式碼執行嘅特定位置插入自己嘅程式碼，從而改變或者增強佢嘅預設行為。掛鈎主要分為兩種：動作掛鈎（Action Hooks）同過濾器掛鈎（Filter Hooks）。
動作掛鈎同過濾器掛鈎
動作掛鈎（Action）容許你喺某個特定事件發生嗰陣執行自訂程式碼，例如發佈文章後、載入管理頁面嗰陣等等。佢唔需要回傳值。使用 add_action() 用函數嚟掛載。例如，喺插件啟動嗰陣執行一個操作：
function myfp_plugin_activation_task() {
// 创建数据库表、初始化选项等
update_option( 'myfp_plugin_installed', '2026-01-01' );
}
register_activation_hook( __FILE__, 'myfp_plugin_activation_task' );呢度用到咗 register_activation_hook，佢係一個特別嘅動作鈎，專係用嚟插件啟動。
過濾器鈎（Filter）就容許你修改傳畀佢嘅數據。佢要求函數接收一個值，而且必須要返一個修改過嘅值。我哋之前改文章內容嘅例子就係一個典型嘅過濾器。另一個例子係改文章嘅摘要長度：
推薦閱讀 掌握WordPress插件開發：從零到壹嘅完整實踐指南。
function myfp_custom_excerpt_length( $length ) {
return 20; // 将摘录长度改为20个单词
}
add_filter( 'excerpt_length', 'myfp_custom_excerpt_length' );用短代碼加動態內容
除咗掛鈎，短代碼（Shortcode）係插件同內容互動嘅另一個強大工具。佢容許用戶透過喺文章或者頁面度插入一個簡單標籤（例如 [my_shortcode]）嚟呼叫插件生成嘅複雜內容。
整一個短代碼好簡單，用 add_shortcode() 函數。例如，創建一個顯示當前時間嘅短代碼：
function myfp_current_time_shortcode( $atts ) {
$atts = shortcode_atts( array(
'format' => 'Y-m-d H:i:s',
), $atts, 'current_time' );
return date( $atts['format'] );
}
add_shortcode( 'current_time', 'myfp_current_time_shortcode' );用戶可以喺編輯器入面輸入 [current_time format="H:i"] 嚟只顯示小時同分鐘。
為插件添加管理頁面
好多插件都需要提供設定選項，通常會透過 WordPress 後台嘅管理選單頁面嚟實現。WordPress 提供咗一系列函數嚟新增頂級選單或者子選單項目。
創建插件設定頁面
我哋會為插件加一個簡單嘅設定頁面，用嚟管理之前加喺文章尾段嘅文字內容。首先，用 add_menu_page() 或 add_options_page() 函數嚟註冊頁面。通常，簡單嘅插件會將頁面加喺「設定」子選單下面。
喺插件主檔案入面加以下嘅程式碼：
function myfp_add_admin_menu() {
add_options_page(
'我的第一个插件设置', // 页面标题
'我的插件设置', // 菜单标题
'manage_options', // 所需权限
'myfp-settings', // 菜单slug
'myfp_settings_page_html' // 用于输出页面内容的回调函数
);
}
add_action( 'admin_menu', 'myfp_add_admin_menu' );呢段代碼話俾WordPress知，當構建後台管理選單嗰陣（admin_menu 動作），就執行 myfp_add_admin_menu 函數去加一個頁面。
構建設定頁面表單
跟住，我哋要定義 myfp_settings_page_html 函數嚟生成頁面嘅 HTML 內容，同埋處理表單嘅儲存。為咗安全噉儲存設定，我哋會用 WordPress 嘅 options API。
function myfp_settings_page_html() {
// 检查用户权限
if ( !current_user_can( 'manage_options' ) ) {
return;
}
// 处理表单提交
if ( isset( $_POST['myfp_footer_text'] ) ) {
update_option( 'myfp_footer_text', sanitize_textarea_field( $_POST['myfp_footer_text'] ) );
echo '<div class="notice notice-success"><p>設定已儲存！</p></div>';
}
// 获取现有值
$current_text = get_option( 'myfp_footer_text', '感谢阅读本文，由“我的第一个插件”为您呈现。' );
?>
<div class="wrap">
<h1>我第一個插件設定</h1>
<form method="post" action="">
<?php wp_nonce_field( 'myfp_settings_action', 'myfp_settings_nonce' ); ?>
<table class="form-table">
<tr>
<th scope="row"><label for="footer_text">文章頁尾文字</label></th>
<td>
<textarea name="myfp_footer_text" id="footer_text" rows="4" cols="50" class="large-text"><?php echo esc_textarea( $current_text ); ?></textarea>
<p class="description">呢段文字會喺每篇文章最尾顯示。</p>
</td>
</tr>
</table>
<?php submit_button(); ?>
<input type="hidden" name="trp-form-language" value="yue"/></form>
</div>
<?php
}最後，記得改返之前過濾文章內容嘅函數，等佢可以從選項 myfp_footer_text 喺度讀取文本，而唔係用硬編碼嘅字串。咁樣，一個具備基本管理功能嘅後台設定頁面就完成咗。
摘要
透過本文嘅步驟，你已經由零開始完成咗一個功能完整嘅 WordPress 插件。你學識咗點樣搭建開發環境、創建插件基礎結構、利用 WordPress 核心嘅鈎子機制（動作同過濾器）嚟擴展功能、實現短代碼同埋構建後台管理介面。插件開發嘅核心在於理解鈎子同事件驅動，呢樣嘢令你喺唔使修改核心代碼嘅前提下，深度定制 WordPress 嘅行為。記住，良好嘅代碼結構、安全嘅輸入輸出處理同埋對國際化嘅支持係開發高質量插件嘅基礎。跟住落嚟，你可以嘗試為插件添加更多功能，例如自定義文章類型、小工具或者 REST API 端點，不斷探索 WordPress 生態嘅無限可能。
常見問題
一個插件係咪一定要得一個PHP檔案？
唔一定。一個插件可以由單個 PHP 檔案構成，對於複雜插件，更推薦模組化嘅結構。你可以將唔同嘅功能拆分到唔同嘅類或者檔案度，主檔案只係負責引入呢啲檔案同埋初始化插件。咁樣有助於代碼嘅維護同組織。例如，可以創建 includes/ 目錄存放功能類，admin/ 目錄存放後台相關代碼，public/ 目錄存放前端邏輯。
點樣安全咁處理插件入面嘅用戶輸入？
處理用戶輸入（如表單數據、URL 參數）嗰陣，必須進行驗證（Validation）、清理（Sanitization）同轉義（Escaping）。對於儲存到數據庫嘅數據，使用 sanitize_text_field()、sanitize_textarea_field()、intval() 等函數進行清理。喺將數據輸出到 HTML 頁面嗰陣，使用 esc_html()、esc_attr()、esc_url() 或 wp_kses() 進行轉義，以防止跨站腳本（XSS）攻擊。
插件開發中點樣除錯代碼？
除咗啟用 WP_DEBUG 之外，你仲可以用 error_log() 函數將自訂訊息記錄到除錯日誌。對於檢查變數值，var_dump() 或 print_r() 結合 die() 係快速但粗糙嘅方法。更推薦使用 WordPress 內置嘅 wp_die() 同埋 wp_send_json()（用於 AJAX 除錯）。此外，使用 Query Monitor 等專業除錯插件可以更直觀咁睇到數據庫查詢、掛鈎、腳本等運行時資訊。
點樣可以令我個插件支援多語言？
要令插件支援國際化（i18n）就需要用到 WordPress 嘅翻譯函數。首先，喺插件頭部註釋度正確設定 Text Domain（例如 ‘my-first-plugin’）。喺代碼入面，對所有面向用戶嘅字串使用 () 或 _e() 用函數包住，例如 ( ‘Hello World’, ‘my-first-plugin’ )。跟住，用 Poedit 之類嘅工具生成 .pot 模板文件，翻譯人員可以根據呢個創建唔同語言嘅 .po 同埋 .mo 檔案，同擺喺插件嘅 languages/ 資料夾入面。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。