想開發WordPress插件，首先需要理解佢嘅基本構成。一個插件本質上係一個或多個PHP檔案，佢哋跟從WordPress嘅特定規範，透過掛鈎系統同核心進行互動，從而擴展或修改網站嘅功能。開發一個插件，你至少需要一個主檔案，當中包含標準嘅插件頭部註釋，呢個係WordPress識別插件嘅關鍵。
搭建你嘅第一個插件
我哋由創建一個最簡單嘅「Hello World」插件開始，呢個過程會幫你熟悉插件嘅結構、啟動同停用流程。
建立插件主檔案
首先，喺你嘅WordPress安裝目錄下嘅wp-content/plugins喺資料夾入面，新建立一個資料夾，例如my-first-plugin。喺呢個資料夾入面，創建一個名為my-first-plugin.php嘅主PHP檔案。呢個檔案名通常同資料夾名一致。
推薦閱讀 WordPress插件開發終極指南：從零到一構建你嘅首個插件。
打開my-first-plugin.php檔案，輸入以下標準插件頭部資訊：
<?php
/**
* Plugin Name: 我的第一个插件
* Plugin URI: https://example.com/my-first-plugin
* Description: 这是一个用于学习的简单Hello World插件。
* Version: 1.0.0
* Author: 你的名字
* Author URI: https://example.com
* License: GPL v2 or later
* Text Domain: my-first-plugin
*/呢段注释好紧要。WordPress会扫描wp-content/plugins同埋佢嘅子目录入面所有PHP文件嘅Plugin Name:行嚟识别插件，同埋喺后台嘅插件管理页面显示出嚟。
實現基礎功能與激活掛鉤
跟住，我哋為插件加個簡單功能：喺網站頁腳顯示一行自訂文字。同時，我哋利用WordPress嘅生命週期掛鉤，嚟示範插件激活同停用時可以執行嘅操作。
喺頭部註解下面，繼續加以下代碼：
// 定义一个函数，在页脚输出信息
function my_first_plugin_display_footer_text() {
echo '<p style="text-align: center;">歡迎使用我嘅第一個WordPress插件！</p>';
}
// 使用 ‘wp_footer’ 动作钩子挂载我们的函数
add_action( 'wp_footer', 'my_first_plugin_display_footer_text' );
// 插件激活时执行的操作
function my_first_plugin_activate() {
// 可能在这里创建数据库表、设置默认选项等
update_option( 'my_first_plugin_installed', current_time( 'mysql' ) );
}
register_activation_hook( __FILE__, 'my_first_plugin_activate' );
// 插件停用时执行的操作
function my_first_plugin_deactivate() {
// 清理临时数据，但保留可能由用户创建的数据
delete_option( 'my_first_plugin_installed' );
}
register_deactivation_hook( __FILE__, 'my_first_plugin_deactivate' );而家，登入你嘅WordPress後台，進入「外掛」頁面，你應該會見到一個叫做「我嘅第一個外掛」嘅外掛。撳「啟用」，然後去網站嘅前台頁面，碌到最底，你應該會見到加咗嘅自訂文字。呢個簡單例子展示咗外掛由創建到運行嘅基本流程。
推薦閱讀 WordPress插件開發完整指南：從零開始打造你的第一個插件。
深入理解WordPress掛鈎系統
掛鈎係WordPress外掛開發嘅基石。佢容許你喺核心程式碼執行嘅特定位置插入自己嘅程式碼，而唔使修改核心檔案。掛鈎主要分為兩種：動作（Action）同過濾器（Filter）。
動作鈎子嘅使用
動作掛鈎喺特定事件發生嗰陣執行，例如發佈文章、載入頁面頭部或者頁尾。佢唔預期會返任何值，只係「執行一段程式碼」。我哋已經喺第一個外掛度用咗wp_footer呢個動作鈎子。
另一個常見嘅例子係init鈎會喺WordPress初始化時觸發，通常用嚟註冊自訂文章類型或者分類法。
function my_plugin_custom_init() {
// 在这里注册自定义文章类型
}
add_action( 'init', 'my_plugin_custom_init' );動作鈎子透過add_action( $hook_name, $function_to_add, $priority, $accepted_args )函數掛載。
過濾器鈎子嘅用法
過濾器鈎用嚟修改數據。佢喺數據被使用（例如存入資料庫或者輸出到瀏覽器）之前傳俾你，你處理完之後再返返修改過嘅值。例如，the_content過濾器容許你修改文章內容。
function my_plugin_add_disclaimer_to_content( $content ) {
if ( is_single() ) {
$disclaimer = '<p><em>本文由我嘅插件處理。</em></p>';
$content .= $disclaimer;
}
return $content; // 必须返回修改后的内容
}
add_filter( 'the_content', 'my_plugin_add_disclaimer_to_content' );過濾器鈎係透過add_filter( $hook_name, $function_to_add, $priority, $accepted_args )函數掛載。優先級$priority決定咗多個函數掛載到同一個鈎嗰陣嘅執行順序，數字越細，優先級越高。
推薦閱讀 WordPress插件開發新手入門指南：從零開始構建你嘅第一個功能插件。
插件架構同安全性最佳實踐
隨住插件功能愈嚟愈複雜，良好嘅架構同嚴格嘅安全措施係保證插件穩定、可維護同安全嘅關鍵。
採用面向對象編程
对于功能丰富的插件，建议使用类（Class）来组织代码。这有助于封装功能，避免函数名冲突，并使代码结构更清晰。
<?php
/**
* Plugin Name: 高级示例插件
*/
if ( ! class_exists( 'Advanced_Sample_Plugin' ) ) {
class Advanced_Sample_Plugin {
public function __construct() {
// 在构造函数中挂载钩子
add_action( 'wp_footer', array( $this, 'display_message' ) );
add_filter( 'the_title', array( $this, 'modify_title' ) );
}
public function display_message() {
echo '<p>嚟自高級插件類嘅訊息。</p>';
}
public function modify_title( $title ) {
return '前缀 - ' . $title;
}
}
// 初始化插件类
new Advanced_Sample_Plugin();
}實施安全防護
WordPress插件安全至關重要。首要原則係：千祈唔好信任用戶輸入。所有從$_GET，$_POST，$_COOKIE等超全局變量攞到啲數據都一定要驗證、清理同轉義。
1. 验证：检查数据是否符合预期格式（如是否为邮箱、数字）。使用sanitize_email()，is_email()等函數。
2. 清理：移除数据中非法或不安全的字符。对于文本输入，使用sanitize_text_field()。對於容許HTML嘅內容，用wp_kses_post()或wp_kses()。
3. 转义：在将数据输出到HTML、JavaScript或URL时，确保其被安全编码。使用esc_html()，esc_js()，esc_url()等函數。
例如，處理一個短碼屬性：
function my_shortcode_handler( $atts ) {
// 使用 shortcode_atts 设置默认值并提取属性
$atts = shortcode_atts( array(
'url' => '#',
), $atts, 'my_shortcode' );
// 清理并转义 URL 属性
$clean_url = esc_url( $atts['url'] );
return "<a href='/yue/{$clean_url}/'>安全連結</a>";
}
add_shortcode( 'my_shortcode', 'my_shortcode_handler' );為插件加返個管理介面同埋國際化
一個成熟嘅插件通常需要配置選項，而且應該考慮支援多語言。
創建管理設定頁面
使用WordPress嘅Settings API嚟建立安全、標準化嘅管理頁面。呢個係推薦嘅方法，佢幫你處理咗安全性（nonce驗證）同埋表單UI一致性。
以下係一個添加頂級選單同埋設定頁面嘅簡化例子：
class My_Plugin_Admin {
public function __construct() {
add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
add_action( 'admin_init', array( $this, 'settings_init' ) );
}
public function add_admin_menu() {
add_menu_page(
'我的插件设置', // 页面标题
'我的插件', // 菜单标题
'manage_options', // 权限
'my-plugin', // 菜单slug
array( $this, 'options_page_html' ) // 回调函数，输出页面内容
);
}
public function settings_init() {
register_setting( 'my_plugin_settings', 'my_plugin_options' ); // 注册设置
// 添加设置区域和字段
add_settings_section( 'my_plugin_section', '主要设置', null, 'my-plugin' );
add_settings_field( 'api_key', 'API密钥', array( $this, 'api_key_field_html' ), 'my-plugin', 'my_plugin_section' );
}
public function api_key_field_html() {
$options = get_option( 'my_plugin_options' );
?>
<input type='text' name='my_plugin_options[api_key]' value='<?php echo esc_attr( $options['api_key'] ?? '' ); ?>'>
<?php
}
public function options_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_plugin_settings' );
do_settings_sections( 'my-plugin' );
submit_button();
?>
<input type="hidden" name="trp-form-language" value="yue"/></form>
</div>
<?php
}
}
new My_Plugin_Admin();實現插件國際化
為咗令插件能夠俾全球用戶使用，需要支援多語言。呢個係透過使用__( ‘Text’， ’text-domain’ )同埋_e( ‘Text’， ’text-domain’ )等翻譯函數包住所有用戶可見嘅文本來實現。你之前喺插件頭部註釋中定義嘅Text Domain: my-first-plugin就係為咗呢個準備嘅。
1. 在代码中，对所有需要翻译的字符串使用翻译函数：
echo __( ‘欢迎使用我的插件！’， ‘my-first-plugin’ );
$title = esc_html__( ‘设置页面’， ‘my-first-plugin’ );2. 使用如Poedit这样的工具，扫描插件代码中的翻译字符串，生成.pot模板檔案。翻譯人員跟住呢個整每種語言對應嘅.po同埋編譯好嘅.mo檔案（例如zh_CN.po/mo）。
3. 将这些语言文件放置在插件的languages文件夾入面。WordPress會根據網站語言設定自動載入相應嘅翻譯。
摘要
WordPress插件開發係一個由簡單腳本到複雜應用嘅過程。核心在於理解同熟練運用鈎子系統，透過動作同過濾器將你嘅功能無縫整合到WordPress嘅生命週期中。遵循面向對象嘅架構思想可以提升代碼嘅組織性同可維護性。安全性係開發嘅基石，必須對任何用戶輸入進行驗證、清理同輸出轉義。最後，透過Settings API創建專業嘅後台界面，並利用國際化函數令你嘅插件走向世界。由創建一個簡單嘅my-first-plugin.php開始，逐步實踐呢啲概念，你便能開發出強大、安全且受歡迎嘅WordPress插件。
常見問題
開發WordPress插件需要啲咩基礎知識？
你需要掌握PHP編程語言，因為插件主要由PHP編寫。同時，需要對HTML、CSS同JavaScript有基本了解，用於構建前端界面同互動。最重要嘅係，理解WordPress嘅基本運作機制，例如主題、鈎子、循環同數據儲存方式。
我可唔可以喺本地測試插件而唔影響線上網站呀？
絕對可以，而且呢個做法係強烈推薦嘅。你應該喺本地開發環境（例如用XAMPP、MAMP、Local by Flywheel等工具搭建）或者一個獨立嘅測試伺服器上面進行插件開發。咁樣可以避免因為程式碼錯誤而搞到線上網站冧咗或者數據唔見咗。
點樣調試我嘅插件代碼？
WordPress提供咗多種除錯工具。首先，喺wp-config.php檔案裡面開啟除錯模式：定義WP_DEBUG常數做true。咁樣會直接喺頁面上顯示PHP錯誤、警告同通知。對於更複雜嘅除錯，可以用error_log()函數會將資訊寫入伺服器錯誤日誌，或者使用專門嘅除錯插件例如Query Monitor，佢可以提供關於數據庫查詢、掛鉤、PHP錯誤等等詳細資訊。
開發完成之後，點樣將插件提交到WordPress官方目錄？
你需要去WordPress.org開一個帳號。然後，透過Subversion（SVN）工具將你嘅插件代碼提交到WordPress提供嘅SVN倉庫度。提交之前，請確保插件代碼符合官方嘅插件開發標準同指引，包括安全性、代碼質素、文檔同國際化等等要求。審核通過之後，你嘅插件就會出現喺官方目錄度俾用戶下載安裝。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。