點解插件係WordPress生態嘅核心
WordPress強大嘅可擴展性好大程度上依賴其插件系統。插件容許開發者唔使改WordPress核心代碼嘅前提下，為網站添加任何功能，由簡單嘅聯絡表格到複雜嘅電子商務系統都得。理解插件開發，即係話你掌握咗客製化WordPress以滿足任何需求嘅鎖匙。佢跟從「約定優於配置」嘅原則，透過一套清晰嘅生命週期掛鉤（Hooks）同核心進行互動。
一個標準嘅插件本質上係一個或多個位於/wp-content/plugins/目錄下嘅PHP檔案，其中必須包含特定嘅插件頭部註釋，用於向WordPress描述呢個插件。呢種模組化嘅設計確保咗功能嘅隔離同系統嘅穩定，令到插件嘅啟用、停用同卸載都變得安全可控。
建立你第一個插件：基礎結構
創建一個插件，首先需要建立佢嘅基礎檔案同結構。呢個唔單止係編寫代碼，更加係為插件未來嘅維護同擴展奠定基礎。
推薦閱讀 從零開始掌握WordPress插件開發：打造專屬功能同高效盈利。
首先，喺你本地WordPress開發環境嘅/wp-content/plugins/目錄下，創建一個新嘅資料夾。資料夾名稱應該係唯一且能夠描述插件功能嘅英文細楷字串，例如my-first-greeting-plugin。喺呢個文件夾入面，創建一個主PHP文件，文件名通常同文件夾名一樣，例如my-first-greeting-plugin.php。
插件信息頭部聲明
插件嘅主文件必須以特定嘅註解塊開頭，呢個係WordPress識別插件嘅關鍵。將以下代碼放入你嘅主PHP文件中：
<?php
/**
* Plugin Name: 我的第一个问候插件
* Plugin URI: https://example.com/my-greeting-plugin
* Description: 这是一个演示插件，用于在网站页脚添加一句自定义问候语。
* Version: 1.0.0
* Author: 你的名字
* Author URI: https://example.com
* License: GPL v2 or later
* Text Domain: my-first-greeting-plugin
* Domain Path: /languages
*/呢段註解定義咗插件喺WordPress後台「插件」頁面中顯示嘅所有信息。Plugin Name係必填項，其他都係可選。保存檔案之後，你就可以喺WordPress後台嘅插件列表度見到呢個新插件，同埋可以好似其他插件咁「啟用」佢。
使用動作鈎子添加功能
啟用插件之後，佢暫時仲未會做任何嘢。要令插件產生作用，我哋需要用WordPress嘅「掛鉤（Hooks）」。掛鉤分為「動作（Action）」同「過濾器（Filter）」。動作允許你喺特定嘅時間點（例如頁面加載、發佈文章嗰陣）執行自訂程式碼。
喺頁尾加句問候語
一個常見需求係喺網站嘅頁尾區域加啲內容。WordPress提供咗wp_footer呢個動作鉤子。我哋可以將自訂嘅函數「掛載」到呢個鉤子上面。
推薦閱讀 WordPress插件開發終極指南：從零開始創建第一個自訂插件。
喺主PHP檔案嘅頭部註釋下面，加入以下代碼：
// 声明一个自定义函数，用于输出问候语
function my_greeting_display() {
echo '<p style="text-align: center; color: #666; padding: 10px;">你好，世界！歡迎使用我嘅第一個WordPress插件。</p>';
}
// 使用 add_action 函数将我们的自定义函数挂载到 wp_footer 钩子上
add_action( 'wp_footer', 'my_greeting_display' );add_action函數係連接自訂代碼同WordPress核心嘅橋樑。第一個參數係鉤子名稱‘wp_footer’，第二個參數係我哋定義嘅函數名‘my_greeting_display’。保存檔案並重新整理網站前台，你就能喺頁腳見到呢段問候文字。
引入過濾器增強靈活性
動作鈎子等我哋「做嘢」，而過濾器鈎子就等我哋「修改數據」。佢哋容許我哋喺數據被使用或者輸出到瀏覽器之前修改佢。咁樣令插件功能更加靈活同可配置。
修改文章標題嘅例子
假設我哋想喺所有文章標題前面自動加上「【推薦】」字樣。我哋可以用the_title過濾器。
喺你個插件主檔案入面加入以下新函數同過濾器：
// 声明一个函数，用于修改文章标题
function my_prefix_post_title( $title, $post_id = null ) {
// 确保只在主循环且是文章页面添加前缀
if ( is_single() && in_the_loop() ) {
$title = '【推荐】' . $title;
}
// 必须返回修改后的值
return $title;
}
// 使用 add_filter 函数，挂载到 the_title 过滤器
add_filter( 'the_title', 'my_prefix_post_title', 10, 2 );add_filter嘅第三個參數10係優先級，數字越細越先執行；第四個參數2表示傳遞俾函數my_prefix_post_title嘅參數數量。過濾器函數必須返回修改後嘅值，唔單止係輸出佢。咁樣你嘅代碼就可以同其他插件或者佈景主題嘅過濾器鏈式協作。
推薦閱讀 全面掌握WordPress插件開發：從零到一構建自訂功能。
創建插件管理頁面
當插件需要一啲用戶可以設定嘅選項時，我哋需要為佢創建一個後台管理頁面。呢個係透過使用WordPress嘅管理選單API嚟實現嘅。
添加設定頁面到管理後台
我哋會喺WordPress後台左邊導航欄加一個簡單嘅頂級菜單。
喺你嘅插件主文件度繼續加以下代碼：
// 注册管理菜单
function my_greeting_add_admin_menu() {
add_menu_page(
'问候插件设置', // 页面标题
'问候插件', // 菜单标题
'manage_options', // 权限（管理员）
'my-greeting-plugin', // 菜单slug
'my_greeting_admin_page', // 回调函数，用于显示页面内容
'dashicons-admin-generic', // 菜单图标（WordPress Dashicons）
80 // 菜单位置
);
}
add_action( 'admin_menu', 'my_greeting_add_admin_menu' );
// 定义设置页面的HTML内容
function my_greeting_admin_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
// 输出设置字段（后续可扩展）
settings_fields( 'my_greeting_options' );
do_settings_sections( 'my-greeting-plugin' );
submit_button( '保存设置' );
?>
<input type="hidden" name="trp-form-language" value="yue"/></form>
<p>歡迎嚟到我第一個插件嘅設置頁面。之後可以喺度加多啲選項。</p>
</div>
<?php
}add_menu_page函數係創建頂級菜單嘅核心。保存之後，用管理員身份登入WordPress後台，你會喺左邊見到一個叫「問候插件」嘅新菜單項目。撳佢就會進入我哋定義嘅基礎設定頁面。呢個係構建更複雜插件配置功能嘅第一步，將來你可以喺呢個頁面整合設定欄位、表單保存等邏輯。
摘要
透過創建一個簡單嘅問候插件，我哋行過咗WordPress插件開發嘅核心路徑：由創建基礎檔案同頭部資訊開始，然後利用add_action掛鉤喺特定位置執行代碼，跟住使用add_filter修改輸出內容，最後透過管理選單API為插件添加後台配置界面。呢四大基石——檔案結構、動作鈎子、過濾器鈎子同管理界面——構成咗幾乎所有WordPress插件嘅基礎。理解同熟練運用呢啲概念，你就已經由入門邁向精通，能夠開始構建更複雜、功能更強大嘅自訂工具，真正釋放WordPress嘅全部潛力。
常見問題
### 一個插件嘅最小結構係咩？
一個插件可以只有一個獨立嘅PHP檔案。只要該檔案包含有效嘅WordPress插件頭部註釋（即Plugin Name），並將其放置喺/wp-content/plugins/目錄或者佢嘅子目錄下面，WordPress就會識別並列出佢。當然，複雜嘅插件通常會將代碼組織喺多個檔案同子目錄入面，以提升可維護性。
動作鉤子同過濾器鉤子嘅根本區別係咩？
動作鉤子用喺特定時刻「執行操作」，佢唔要求你嘅函數返回值，核心係執行一段代碼。過濾器鉤子用嚟「修改數據」，佢強制要求你嘅函數必須返回一個值（通常係修改後嘅傳入值），以便數據能夠喺過濾鏈入面傳遞。簡單嚟講，動作係做啲嘢，過濾器係改變啲嘢。
點樣確保我嘅插件代碼唔會同其他插件衝突？
為咗避免函數名、類名或者常量名撞名，最好嘅做法係用命名空間（推薦）或者幫所有標識符加個唯一嘅前綴。例如，呢篇文章嘅示例入面所有函數都用咗my_或my_greeting_做前綴。由PHP 5.3開始，用命名空間係更加現代同徹底嘅做法。
開發外掛時點樣進行調試？
首先，確保你喺你嘅wp-config.php檔案中開啟WP_DEBUG：define( ‘WP_DEBUG’, true );。使用error_log()函數會將調試信息寫入伺服器嘅錯誤日誌。對於變數檢查，可以用print_r()或var_dump()結合wp_die()喺頁面上安全輸出。另外，用Query Monitor等開發者插件可以大大提升調試效率。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。