理解WordPress插件嘅基本結構
深入睇代碼之前，理解一個WordPress插件嘅基本構成要素好重要。一個插件本質上係一個或一組放喺wp-content/plugins/目錄下面嘅PHP檔案。佢嘅核心係一個主檔案，包含咗插件嘅元信息，透過一個特殊格式嘅註解區塊嚟話俾WordPress知呢個插件嘅存在。
插件嘅核心入口檔案，例如我哋命名為my-first-plugin.php，必須包含一個特定嘅檔案頭註釋。呢個註釋區塊定義咗插件嘅名稱、描述、版本、作者等資訊，係WordPress識別同加載插件嘅唯一依據。一個最基本嘅插件可以只由呢一個檔案構成，佢通過利用WordPress提供嘅API，例如動作掛鉤（Action Hooks）同過濾器掛鉤（Filter Hooks），嚟修改或者擴展網站嘅功能。
插件嘅功能可以好簡單，例如喺頁面底部加一行字；亦都可以好複雜，好似創建一個完整嘅電子商務系統。無論複雜與否，其開發都遵循相同嘅基本模式：首先，喺正確嘅位置創建正確嘅檔案結構；然後，編寫代碼並掛載到WordPress嘅生命週期中；最後，透過WordPress嘅後台管理介面進行必要嘅配置同互動。
推薦閱讀 WordPress插件開發入門指南：從零開始打造你嘅第一個插件。
創建你嘅第一個插件
等我哋通過一個經典嘅「Hello World」示例嚟實踐創建一個最簡單嘅插件。呢個插件嘅功能係喺網站每個頁面嘅文章內容頂部輸出一句問候語。
首先，你需要喺本地或者伺服器嘅wp-content/plugins/目錄下開一個新嘅資料夾，命名為my-hello-plugin。然後，喺呢個資料夾入面開一個主PHP檔案，我哋會將佢命名為my-hello-plugin.php。
編寫插件嘅主檔案
打開my-hello-plugin.php檔案，並輸入以下代碼。呢段代碼跟咗WordPress插件標準格式，包含咗插件資訊頭同埋實現功能嘅代碼。
<?php
/**
* Plugin Name: 我的问候插件
* Plugin URI: https://yourwebsite.com/my-hello-plugin
* Description: 这是一个简单的插件，用于在文章内容前输出“您好，读者！”。
* Version: 1.0.0
* Author: 你的名字
* License: GPL v2 or later
* Text Domain: my-hello-plugin
*/
// 防止直接访问文件
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
/**
* 在主文章内容前添加问候语。
*
* @param string $content 原始的文章内容。
* @return string 添加了问候语后的新内容。
*/
function my_hello_add_greeting( $content ) {
$greeting = '<p style="background-color:#f0f8ff; padding:10px; border-left:4px solid #0073aa;"><strong>你好呀，讀者！歡迎你睇呢篇文章。</strong></p>';
// 只在主循环且是文章页面时添加
if ( is_single() && in_the_loop() && is_main_query() ) {
return $greeting . $content;
}
return $content;
}
// 将函数挂载到 ‘the_content’ 过滤器
add_filter( 'the_content', 'my_hello_add_greeting' );啟動並測試插件
將包含呢個檔案嘅資料夾上傳到伺服器嘅wp-content/plugins/目錄，或者如果你喺本地開發，直接放喺相應位置。然後，登入你嘅WordPress後台，導航到「插件」選單。你應該會喺插件列表度見到「我嘅問候插件」。撳「啟用」掣。
激活之後，去網站上任何一篇文章或者頁面，你就會睇到喺文章正文內容開始之前，出現咗一段有淺藍色背景同左邊框嘅問候語。呢個過程好清楚噉展示咗插件開發嘅核心流程：創建檔案、用鉤子加功能、喺後台激活。你已經成功行出咗WordPress插件開發嘅第一步。
推薦閱讀 WordPress插件開發：由零到一建立功能強大嘅網站擴展。
用鉤子同過濾器擴展功能
WordPress嘅靈活性同擴展性好大程度上係靠佢嘅「鉤子（Hooks）」系統。鉤子分兩類：動作鉤子（Actions）同過濾器鉤子（Filters）。理解同熟練運用佢哋係高級插件開發嘅關鍵。
動作鈎子允許你喺WordPress運行嘅特定時間點（例如發佈文章、加載頁面等）插入同執行自己嘅代碼。舉個例，save_post當文章或者頁面被保存到數據庫嗰陣，動作就會觸發。你可以透過add_action()函數將你嘅自定義函數「掛載」到呢個鈎子上面。
過濾器鈎子就容許你修改WordPress喺處理過程中產生嘅數據。你註冊一個函數到過濾器，當WordPress執行到呢個過濾器嗰陣，會將佢嘅數據傳遞俾所有已註冊嘅函數，然後接收處理後嘅返回值。上面例子用到嘅the_content就係一個典型嘅過濾器掛鈎，佢容許你修改即將輸出嘅文章內容。
創建一個簡單嘅管理選項
一個真正有用嘅插件通常需要一啲用戶可配置嘅選項。呢個涉及同WordPress後台嘅互動。我哋透過一個簡單嘅例子嚟演示點樣添加一個自訂設定頁面。
首先，我哋使用add_action(‘admin_menu’, …)嚟註冊一個函數，呢個函數會喺管理後台度開一個新嘅菜單項目。
/**
* 在WordPress后台添加一个自定义菜单页面。
*/
function my_hello_add_admin_menu() {
add_menu_page(
‘问候插件设置’， // 页面标题
‘问候插件’， // 菜单标题
‘manage_options’， // 所需权限
‘my-hello-plugin’， // 菜单slug
‘my_hello_admin_page_html’， // 用于显示页面内容的回调函数
‘dashicons-format-chat’， // 图标（可选）
80 // 菜单位置（可选）
);
}
add_action( ‘admin_menu‘, ’my_hello_add_admin_menu’ );
/**
* 自定义设置页面的HTML输出。
*/
function my_hello_admin_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( ‘my_hello_options’ );
do_settings_sections( ‘my-hello-plugin’ );
submit_button( ‘保存问候语设置’ );
?>
<input type="hidden" name="trp-form-language" value="yue"/></form>
</div>
<?php
}註冊同輸出設定欄位
淨係有頁面都唔夠，我哋需要開啲可以保存嘅選項。呢度要用到add_action(‘admin_init’, …)，同埋register_setting()、add_settings_section()同埋add_settings_field()等等一系列嘅函數。
推薦閱讀 由入門到精通：WordPress插件開發完整指南。
/**
* 初始化插件的设置。
*/
function my_hello_settings_init() {
// 注册一个设置项到数据库的‘my_hello_options’键下
register_setting( ‘my_hello_options‘, ’my_hello_greeting_text’ );
// 在页面中添加一个设置区域
add_settings_section(
‘my_hello_section’， // 区域ID
‘问候语设置’， // 区域标题
‘my_hello_section_html’， // 区域描述的回调函数
‘my-hello-plugin’ // 所属页面slug
);
// 在区域内添加一个具体的设置字段
add_settings_field(
‘my_hello_field’， // 字段ID
‘自定义问候语’， // 字段标签
‘my_hello_field_html’， // 用于渲染字段HTML的回调函数
‘my-hello-plugin’， // 所属页面slug
‘my_hello_section’ // 所属区域ID
);
}
add_action( ‘admin_init‘, ’my_hello_settings_init’ );
/**
* 设置区域的描述信息。
*/
function my_hello_section_html() {
echo ‘<p>喺呢度設定顯示喺文章開頭嘅問候語內容。</p>’;
}
/**
* 渲染设置字段的HTML。
*/
function my_hello_field_html() {
// 从数据库获取已保存的值，如果没有则使用默认值
$greeting = get_option( ‘my_hello_greeting_text‘, ’您好，读者！欢迎阅读本文。’ );
?>
<input type="‘text’"
id="‘my_hello_greeting_text’"
name="‘my_hello_greeting_text’"
value="“NO NUMERIC NOISE KEY" 1000”
class="“regular-text”" />
<p class="“description”">請輸入您希望喺文章內容前顯示嘅問候語。</p>
<?php
}而家，我哋已經有一個帶輸入框嘅後台設定頁面。跟住，需要修改最初嘅功能函數my_hello_add_greeting，等佢從數據庫嘅選項度讀取問候語。
function my_hello_add_greeting( $content ) {
// 获取保存的自定义问候语，如果不存在则使用默认值
$custom_greeting = get_option( ‘my_hello_greeting_text‘, ’您好，读者！欢迎阅读本文。’ );
$greeting = ‘<p style="“background-color:#f0f8ff;" padding:10px; border-left:4px solid #0073aa;”><strong>’ . esc_html( $自訂問候語 ) . ‘</strong></p>’;
if ( is_single() && in_the_loop() && is_main_query() ) {
return $greeting . $content;
}
return $content;
}到呢一步，一個具備基本後台配置功能嘅插件就搞掂喇。用戶可以喺後台「問候插件」菜單下自由修改問候語文本，而前台嘅文章會自動應用最新嘅設定。
插件開發嘅最佳實踐同安全
開發一個俾人用嘅WordPress插件，唔單止要求功能完善，仲必須跟從安全、性能同可維護性嘅最佳實踐。
安全考量
安全性係首要原則。千祈唔好信用戶輸入。所有從用戶嗰度攞到嘅數據（例如$_GET、$_POST、$_COOKIE）喺用嚟做數據庫查詢、輸出到頁面或者進行檔案操作之前，都必須要進行適當嘅清理、驗證同轉義。
對於輸出到HTML頁面嘅數據，要使用esc_html()、esc_attr()或wp_kses_post()等函數進行轉義。對於用嚟做數據庫查詢嘅變數，必須使用$wpdb->prepare()方法進行參數化查詢，千祈唔好直接將變數拼接落SQL語句度。喺插件入面，應該要一直使用defined(‘ABSPATH’) or die;為咗防止檔案被直接存取。
代碼組織同國際化
隨住插件功能增加，將所有代碼寫喺一個主檔案度會變得難以維護。合理嘅做法係按功能將代碼拆分到唔同檔案度。通常，主檔案負責定義鉤子同核心流程，而將設定頁面、功能函數、類定義等放喺includes/或admin/、public/呢啲子目錄入面，並透過require_once引入。
為咗令你嘅插件可以畀全球用戶使用，應該支持國際化（i18n）。即係話所有喺插件中輸出嘅文本字串都應該用WordPress嘅翻譯函數__()、_e()包住，同埋為Text Domain設定一個唯一識別符（例如插件目錄名）。喺檔案頭嘅註解塊入面，我哋已經定義咗Text Domain: my-hello-plugin。喺代碼中應該咁樣用：
$問候語 = ‘<p><strong>’ . esc_html__( ‘您好，读者！欢迎阅读本文。’ , ’my-hello-plugin’ ) . ‘</strong></p>’;咁樣，翻譯人員就可以用.po同埋.mo檔案為你個插件整唔同語言嘅翻譯。
效能優化
插件應該盡量減少對網站效能嘅影響。避免喺每次頁面載入時都做大量嘅數據庫查詢或者複雜嘅計算，特別係喺前端。合理使用WordPress嘅瞬態緩存API（Transients API）來儲存嗰啲唔經常變嘅昂貴查詢結果。例如，如果你想緩存一個API請求嘅結果，可以咁做：
$data = get_transient( ‘my_plugin_api_data’ );
if ( false === $data ) {
// 数据不存在或已过期，从API获取
$data = wp_remote_retrieve_body( wp_remote_get( ‘https://api.example.com/data’ ) );
// 将数据存储12小时
set_transient( ‘my_plugin_api_data’, $data, 12 * HOUR_IN_SECONDS );
}
// 使用 $data另外，確保只喺需要嘅頁面載入你嘅CSS同JavaScript檔案。使用wp_enqueue_script()同埋wp_enqueue_style()函數，並配合適當嘅鉤子（如wp_enqueue_scripts）嚟載入前端資源；對於後台資源，則使用admin_enqueue_scripts鉤子。
摘要
透過本文嘅逐步引導，我哋完成咗從一個簡單嘅「Hello World」外掛，到一個具備後台配置選項、遵循基本安全與代碼組織原則嘅實用外掛嘅完整開發旅程。關鍵在於理解並運用WordPress嘅核心機制：鉤子系統。佢容許我哋以模組化、非侵入式嘅方式擴展平台功能。無論係修改內容（過濾器）定係執行特定任務（動作），鉤子都係連接你嘅代碼同WordPress世界嘅橋樑。
記住，優秀嘅外掛開發唔單止係令功能行得通。佢涉及對用戶輸入嘅嚴格安全處理、代碼嘅清晰組織、對國際化嘅支援同對網站性能嘅細緻考量。從定義清晰嘅外掛檔案頭開始，到使用標準API創建菜單同設定，再到最後對輸出進行安全嘅轉義，每一步都影響著外掛嘅質量、安全性同用戶體驗。繼續深入探索WordPress嘅眾多API同函數，你將能夠構建出功能強大且健壯嘅外掛。
常見問題
插件開發需要咩基礎？
你需要具備PHP編程語言嘅基礎知識，包括變量、函數、陣列、條件判斷同循環等核心概念。同時，對HTML同CSS有基本了解都好有幫助，因為插件經常需要生成或修改前端界面。對WordPress嘅基本使用同後台結構有所了解，可以令開發過程更順暢。
點樣調試我嘅WordPress插件？
首先，確保你嘅wp-config.php文件中開咗WordPress嘅除錯模式。透過設定define('WP_DEBUG', true);同埋define('WP_DEBUG_LOG', true);，錯誤訊息會記錄喺wp-content/debug.log檔案入面，咁樣比直接顯示喺頁面上更安全。另外，可以結合使用error_log()函數嚟印出變數值，或者用瀏覽器開發者工具嘅「網絡」同「控制台」面板嚟檢查前端腳本同樣式嘅問題。
我開發嘅插件可以上傳到官方嘅插件目錄嗎？
可以，但要符合WordPress官方嘅插件提交要求。呢啲要求包括確保你嘅插件跟從GPL兼容許可證、遵守WordPress嘅編碼標準、確保代碼安全同唔包含惡意內容、提供清晰嘅文件說明等等。提交之前，建議仔細閱讀官方提供嘅插件開發者手冊同提交指南。提交過程需要通過WordPress.org嘅插件提交系統進行審核。
插件同主題嘅功能有咩分別？幾時應該開發插件？
主題（Theme）主要控制網站嘅外觀同佈局，通常負責模板檔案、樣式表同部分與展示相關嘅功能。而插件（Plugin）就用於添加或修改網站嘅功能，其影響同當前使用嘅主題（大部分情況下）無關。一個好嘅原則係：如果一項功能同網站嘅外觀直接相關（例如頁面佈局、顏色方案），可以考慮放喺主題度；如果係一項通用嘅、獨立嘅功能（例如聯絡表格、SEO優化、緩存），無論更換咩主題都應該存在，咁就應該開發成插件。呢個有助保持功能同設計嘅分離，提高靈活性。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。