WordPress插件係擴展WordPress核心功能嘅主要方法，佢容許開發者唔使改核心代碼就可以為網站加幾乎任何功能。無論係簡單嘅短代碼，定係複雜嘅電子商務系統，都可以透過插件實現。明白點樣開發插件，即係話你識得按特定需求去自訂功能，整啲可以重用嘅功能模組，甚至建立自己嘅產品。呢篇文章會帶你由基礎概念到實戰開發，一步步學識WordPress插件開發嘅核心技巧。
WordPress插件開發基礎同環境準備
喺寫第一行代碼之前，你需要明白插件嘅基本結構同埋準備好開發環境。
插件嘅基本結構同檔案組織
一個最簡單嘅 WordPress 插件可以只係由一個檔案構成。呢個主檔案必須包含特定嘅插件頭部註釋，WordPress 透過佢嚟識別插件資訊。呢個主檔案通常命名為 your-plugin-name.php。
推薦閱讀 深入淺出：從零開始掌握 WordPress 插件開發完整指南。
插件頭部註釋嘅格式如下：
<?php
/**
* Plugin Name: 我的第一个插件
* Plugin URI: https://example.com/my-first-plugin
* Description: 这是一个简单的插件描述。
* Version: 1.0.0
* Author: 你的名字
* Author URI: https://example.com
* License: GPL v2 or later
* Text Domain: my-first-plugin
*/呢段註釋定義咗插件嘅名稱、版本、作者等元資訊，係插件嘅「身份證」。插件檔案應該擺喺 /wp-content/plugins/ 目錄下面，可以係一個獨立嘅 PHP 檔案，亦可以係一個以插件名命名嘅資料夾，裏面包含主檔案同其他資源。
搭建本地開發環境
一個可靠嘅本地開發環境至關重要。推薦使用 Local by Flywheel、XAMPP 或者 MAMP 等工具快速搭建包含 PHP、MySQL 同 Apache/Nginx 嘅 WordPress 環境。另外，你需要一個代碼編輯器，例如 Visual Studio Code 或者 PHPStorm，並且安裝相關嘅 PHP 同 WordPress 代碼智能感知插件以提高開發效率。
確保你嘅環境使用同目標伺服器相近嘅 PHP 版本（推薦 PHP 7.4 或更高），並喺 wp-config.php 度開啟 WP_DEBUG 模式，以便喺開發過程中捕獲錯誤同警告。
define( 'WP_DEBUG', true );核心開發概念：掛鈎同過濾器
WordPress 插件開發嘅核心哲學係「鈎子（Hooks）」，佢容許你喺特定嘅時間點或者位置插入自定義代碼，而唔使修改核心文件。鈎子分為兩種：動作（Actions）同過濾器（Filters）。
推薦閱讀 從零開始掌握 WordPress 插件開發：原理、實踐與高級技巧。
理解動作鉤子
動作鈎允許你喺WordPress執行嘅特定時刻（例如發佈文章、加載頁面頭部）執行自訂函數。你可以用 add_action() 函數將你嘅函數「掛上」個鈎度。
例如，喺網站前台頁面嘅 部分加啲內容，可以用 wp_head 動作鉤子：
function myplugin_add_custom_head_content() {
echo '<meta name="my-custom-tag" content="Hello from my plugin">';
}
add_action( 'wp_head', 'myplugin_add_custom_head_content' );當 WordPress 執行到 wp_head 位置嗰陣，就會叫用我哋掛載嘅 myplugin_add_custom_head_content 函數。
明解過濾器掛鈎
過濾器鉤子用嚟修改數據。佢容許你喺數據被使用或者保存到資料庫之前對其進行修改。使用 add_filter() 函數嚟應用過濾器。
一個經典嘅例子係修改文章標題嘅顯示內容。下面嘅代碼會喺所有文章標題前面加上「重要：」字樣：
function myplugin_prepend_to_title( $title ) {
if ( is_single() ) {
$title = '重要：' . $title;
}
return $title;
}
add_filter( 'the_title', 'myplugin_prepend_to_title' );函數接收原始標題作為參數，修改後必須將其返回。WordPress 核心同好多插件提供咗數百個動作同過濾器鈎子，呢個係插件同系統互動嘅主要方式。
推薦閱讀 WordPress插件開發終極指南：從零開始打造你的第一個插件。
創建你嘅第一個功能插件
等我哋透過一個完整嘅實戰例子，創建一個「文章閱讀時間估算」插件，佢會綜合運用鈎子、短代碼同設定選項。
插件主檔案同功能實現
首先，喺 /wp-content/plugins/ 目錄下創建文件夾 post-reading-time並喺入面創建主檔案 post-reading-time.php，填寫好插件頭部資訊。
跟住，我哋實現核心功能函數。呢個函數會計算文章嘅閱讀時間（假設平均閱讀速度係每分鐘 200 字），然後返個格式化嘅字串。
function prt_calculate_reading_time( $post_id ) {
$post_content = get_post_field( 'post_content', $post_id );
// 清除短代码和HTML标签，只计算纯文字
$clean_content = strip_shortcodes( $post_content );
$clean_content = wp_strip_all_tags( $clean_content );
$word_count = str_word_count( $clean_content );
$reading_time = ceil( $word_count / 200 ); // 假设每分钟读200字
return sprintf(
_n( '约 %d 分钟读完', '约 %d 分钟读完', $reading_time, 'post-reading-time' ),
$reading_time
);
}透過短代碼同自動注入展示結果
為咗等用戶可以靈活使用，我哋提供兩種方式展示閱讀時間。第一種係創建一個短代碼 [reading_time]。
我哋用 add_shortcode() 用嚟註冊短代碼嘅函數：
function prt_reading_time_shortcode( $atts ) {
$atts = shortcode_atts( array(
'id' => get_the_ID(),
), $atts, 'reading_time' );
return '<span class="post-reading-time">' . prt_calculate_reading_time( $atts['id'] ) . '</span>';
}
add_shortcode( 'reading_time', 'prt_reading_time_shortcode' );用戶可以喺文章編輯器度插入 [reading_time] 嚟顯示當前文章嘅閱讀時間。
第二種方式係自動喺文章內容尾度追加閱讀時間。呢個需要用 the_content 過濾器掛鉤：
function prt_display_reading_time_after_content( $content ) {
if ( is_single() && in_the_loop() && is_main_query() ) {
$reading_time_html = '<div class="post-reading-time-container">';
$reading_time_html .= prt_calculate_reading_time( get_the_ID() );
$reading_time_html .= '</div>';
$content .= $reading_time_html;
}
return $content;
}
add_filter( 'the_content', 'prt_display_reading_time_after_content' );噉樣，每篇單獨嘅文章末尾都會自動顯示閱讀時間，唔使手動插入短代碼。
插件安全、優化同發佈準備
一個合格嘅插件唔單止要識行，仲必須安全、高效，同埋易畀人用。
數據驗證、轉義同權限檢查
安全係重中之重。所有嚟自用戶或外部輸入嘅數據都必須進行驗證同轉義。
- 驗證（Validation）：檢查數據係咪符合預期格式（例如係咪數字、電郵等），喺存入數據庫之前進行。可以用 sanitize_text_field()、intval() 等函數。
- 轉義（Escaping）：喺將數據輸出到瀏覽器嗰陣，確保佢唔會被解讀為惡意代碼。用 esc_html()、esc_attr()、esc_url() 等函數。
- 權限檢查（Capability Checks）：喺執行管理操作之前，用 current_user_can() 檢查當前用戶有冇相應權限，例如 current_user_can( 'edit_posts' )。
性能優化同代碼組織
隨住功能增加，應該將代碼模組化。將唔同嘅功能（例如後台設定、前端顯示、API處理）拆分到唔同嘅檔案，並透過主檔案引入。使用 require_once 或 include_once 來組織檔案。
對於可能會被頻繁調用嘅複雜查詢或操作，考慮使用 WordPress 嘅瞬時（Transients）API 進行緩存，例如 set_transient() 同埋 get_transient()，以減輕數據庫壓力。
國際化與發佈準備
為咗令插件可以畀全球用戶使用，必須進行國際化處理。即係話所有面向用戶嘅字串都應該用翻譯函數包住。
使用 __( '文本', 'text-domain' ) 嚟輸出可翻譯嘅字串。
2. 在插件头部注释中定义 Text Domain（例如 ‘post-reading-time’），同確保佢同之後生成嘅 .pot 檔案域名一致。
3. 使用工具如 Poedit 或 WP-CLI 的 wp i18n make-pot 用命令嚟生成語言模板檔案（.pot）。
發佈之前，請確保程式碼符合 WordPress 編碼標準，同埋寫清楚 readme.txt 檔案（用返 WordPress 官方要求嘅格式），詳細描述插件功能、安裝步驟、截圖同更新記錄。
摘要
WordPress 插件開發係一個由理解基礎結構、掌握鉤子機制，到安全高效實現功能，最後進行國際化封裝同發佈嘅系統過程。由創建一個簡單嘅功能插件開始，你可以逐步深入理解 WordPress 嘅運作機制同開發規範。關鍵在於跟住最佳實踐：善用鉤子進行非侵入式開發，嚴格進行安全防護，同埋時刻考慮程式碼嘅效能同可維護性。持續探索核心程式碼同優秀開源插件嘅實現，會係你提升技能嘅最佳途徑。
常見問題
開發 WordPress 插件需要咩先決知識？
你需要具備 PHP 編程語言嘅基礎知識，包括變數、函數、陣列、條件判斷同循環等。同時，對 HTML、CSS 同 JavaScript 有基本了解，以便處理前端展示同互動。熟悉 WordPress 嘅基本概念，例如文章、頁面、分類法，會令你喺開發時更加得心應手。
點樣調試我嘅 WordPress 插件？
最有效嘅方法係開啟 WordPress 除錯模式。喺 wp-config.php 檔案入面設定 define( 'WP_DEBUG', true ); 同埋 define( 'WP_DEBUG_LOG', true );。咁樣，所有錯誤同警告都會被記錄到 /wp-content/debug.log 檔案入面，避免直接顯示畀用戶睇。另外，使用瀏覽器開發者工具嚟查看網絡請求同 JavaScript 錯誤，以及使用 error_log() 喺代碼度用函數印出變數值去日誌，都係常用嘅除錯方法。
我嘅插件點樣同主題或者其他插件兼容？
保持兼容性嘅核心係跟返WordPress標準，同埋小心用鉤子。避免直接改核心數據庫表結構或者用未公開嘅函數（通常以 _ 下劃線開頭）。幫你啲函數、類、選項名加返獨特嘅前綴（例如 myplugin_），防止撞名。喺可能嘅情況下，提供過濾器鉤子，等其他開發者可以改你插件嘅行為，就好似你改WordPress核心咁。
點樣為我嘅插件加後台設定頁面？
你可以用 WordPress 提供嘅「設定 API」來加專業嘅後台設定頁面。呢個涉及幾個步驟：用 add_menu_page() 或 add_submenu_page() 函數註冊菜單頁面，然後用 register_setting()、add_settings_section() 同埋 add_settings_field() 等函數來定義設定欄位同區域。最後，建立一個回調函數來輸出設定頁面嘅 HTML 表單。呢種方法可以自動處理權限檢查、非安全驗證同選項儲存，係最推薦嘅方法。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。