WordPress插件開發環境準備
喺你開始寫程式碼之前，一個合適嘅開發環境至關重要。呢樣唔單止可以令你高效工作，仲可以模擬真實嘅生產環境，避免本地同線上出現唔一致嘅問題。一個典型嘅開發環境需要包含本地伺服器環境、程式碼編輯器同埋除錯工具。
首先，你需要一個能夠運行WordPress嘅本地伺服器環境。推薦使用整合環境包，例如 Laragon、XAMPP 或者 Local by Flywheel。呢啲工具可以一鍵安裝Apache/Nginx、PHP同埋MySQL，慳返繁瑣嘅配置過程。請確保你嘅PHP版本同目前主流WordPress版本兼容，通常建議使用PHP 7.4或者更高版本。同時，喺WordPress後台嘅「工具」 -> 「網站健康」入面，確保冇影響插件開發嘅關鍵問題。
其次，揀一個強大嘅程式碼編輯器。Visual Studio Code 係目前非常流行嘅選擇，佢輕量、免費，而且有豐富嘅擴展，例如PHP Intelephense（用於程式碼智能提示）、WordPress Snippet（程式碼片段）等等。另一個經典選擇係PhpStorm，佢提供咗更深度整合嘅WordPress開發支援，但係屬於付費軟件。
推薦閱讀 從零到一：WordPress 插件開發完整指南同最佳實踐。
最後，開啟除錯模式係開發過程中必不可少嘅步驟。透過修改WordPress根目錄下嘅wp-config.php文件，你可以啟用詳細嘅錯誤報告，呢個對於發現同修復代碼中嘅問題至關重要。揾到文件中定義WP_DEBUG常量嘅地方，或者添加以下代碼：
// 启用 WordPress 调试模式
define( 'WP_DEBUG', true );
// 将错误记录到 /wp-content/debug.log 文件
define( 'WP_DEBUG_LOG', true );
// 在页面上显示错误（开发环境推荐，生产环境必须关闭）
define( 'WP_DEBUG_DISPLAY', true );創建你嘅第一個插件檔案
一個WordPress插件可以簡單到只有一個文件。所有插件都必須存放喺/wp-content/plugins/目錄下。每個插件可以擁有自己嘅子目錄，呢個有助於組織更複雜嘅代碼結構。
插件頭部註解
每個插件主文件都必須以標準化嘅PHP頭部註解開始，呢個係WordPress識別插件資訊嘅方式。開一個新檔案，命名為my-first-plugin.php，擺入/wp-content/plugins/my-first-plugin/資料夾入面。檔案內容如下：
<?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
* Domain Path: /languages
*/呢段註解提供咗插件喺WordPress後台「插件」頁面顯示嘅所有元資訊。當中，Text Domain同埋Domain Path用於插件嘅國際化（i18n）準備。
實現一個簡單嘅功能
而家，等我哋為呢個插件加個簡單功能：喺文章內容嘅末尾自動加一行自訂文字。我哋會用WordPress嘅the_content過濾器鈎子。喺你啱啱建立嘅my-first-plugin.php檔案嘅頭部註解下面，加以下函數：
推薦閱讀 掌握WordPress插件開發：從零到一構建自訂功能。
// 在文章内容末尾添加自定义文本
function my_first_plugin_add_footer_text( $content ) {
// 确保只在主循环的单篇文章页面执行
if ( is_single() && in_the_loop() && is_main_query() ) {
$footer_text = '<p><em>多謝你睇完！呢篇文係由「我嘅第一個插件」為你呈現㗎。</em></p>';
$content .= $footer_text;
}
return $content;
}
add_filter( 'the_content', 'my_first_plugin_add_footer_text' );保存檔案之後，登入你嘅WordPress後台，進入「外掛」頁面，你應該會見到一個叫做「我嘅第一個外掛」嘅外掛。啟動佢，然後去睇一篇網誌文章，你會發現文章內容嘅底部已經成功加咗我哋設定嘅文字。
使用 WordPress 核心 API
深入開發嘅時候，你會頻密同WordPress提供嘅各種API互動，其中最核心嘅係「掛鈎」（Hooks）系統，包括「動作」（Actions）同「過濾器」（Filters）。
理解動作鉤子
動作掛鈎容許你喺特定時間點執行自訂程式碼。例如，當一篇文章發表嘅時候，你想寄一封電郵通知。呢個時候可以用publish_post動作。下面嘅示例展示咗點樣創建一個喺文章發佈嗰陣，喺錯誤日誌度記錄信息嘅功能：
// 定义文章发布时执行的动作函数
function my_first_plugin_log_post_published( $post_id, $post ) {
// 避免无限循环和非文章类型
if ( wp_is_post_revision( $post_id ) || $post->post_type != ‘post’ ) {
return;
}
// 记录日志
error_log( “文章 ID {$post_id} 已发布，标题为：{$post->post_title}” );
}
// 将函数挂载到 publish_post 动作钩子上
add_action( ‘publish_post’， ‘my_first_plugin_log_post_published’， 10, 2 );函數add_action嘅第三個參數係優先級（默認10），數字越細優先級越高；第四個參數係函數接受嘅參數個數。
明解過濾器掛鈎
過濾器鈎用嚟修改數據。喺「創建你嘅第一個插件文件」章節度，我哋用嘅the_content就係一個過濾器鈎。佢接收原始內容，容許你修改之後再返出去。另一個常用例子係修改文章摘要嘅長度：
// 修改摘要的默认字数
function my_first_plugin_custom_excerpt_length( $length ) {
return 30; // 将摘要字数改为30字
}
add_filter( ‘excerpt_length’， ‘my_first_plugin_custom_excerpt_length’ );加入入口選單
為咗同用家互動，我哋通常需要喺WordPress後台嘅管理側邊欄加一個選單頁面。呢個可以透過add_menu_page函數實現。以下嘅程式碼為外掛加咗一個頂級設定頁面：
推薦閱讀 WordPress插件開發全攻略：從零到一構建高質量嘅WordPress擴展功能。
// 创建插件管理菜单
function my_first_plugin_add_admin_menu() {
add_menu_page(
‘我的第一个插件设置’， // 页面标题
‘我的插件’， // 菜单标题
‘manage_options’， // 所需权限
‘my-first-plugin’， // 菜单slug
‘my_first_plugin_settings_page’， // 回调函数，用于输出页面内容
‘dashicons-admin-plugins’， // 图标（可选）
100 // 菜单位置（可选）
);
}
add_action( ‘admin_menu’， ‘my_first_plugin_add_admin_menu’ );
// 设置页面的回调函数
function my_first_plugin_settings_page() {
?>
<div class="“wrap”">
<h1>我第一個插件設定</h1>
<p>呢度係插件嘅設定頁面。將來你可以喺呢度加表格同選項。</p>
</div>
<?php
}插件安全同最佳實踐
開發俾其他人用嘅外掛嗰陣，安全性同程式碼質素唔可以忽視。跟從最佳實踐可以保護網站免受攻擊，同埋確保外掛嘅兼容性同可維護性。
數據驗證與轉義
永遠唔好相信用戶輸入或者嚟自數據庫嘅數據。輸出到瀏覽器之前，一定要做轉義；保存到數據庫之前，一定要做驗證同清理。WordPress提供咗好多輔助函數。
- 轉義輸出：使用
esc_html()、esc_attr()、esc_url()同埋wp_kses_post()等函數，根據上下文對數據進行轉義。 - 驗證輸入：使用
sanitize_text_field()、sanitize_email()、intval()等函數清理用戶提交嘅表單數據。
例如，喺設定頁面處理表單數據嗰陣：
$user_input = $_POST[‘some_field’] ?? ‘’; // 使用空合并运算符提供默认值
$clean_input = sanitize_text_field( $user_input ); // 清理数据
update_option( ‘my_plugin_option’， $clean_input ); // 安全存储使用非ce同權限檢查
處理表單請求（尤其係嚟自 admin-ajax.php 或者 admin-post.php 嘅請求）嗰陣，一定要用wp_verify_nonce()嚟驗證請求嘅合法性，防止跨站請求偽造（CSRF）攻擊。同時，要用current_user_can()檢查當前用戶係咪有執行操作嘅權限。
function my_first_plugin_handle_form_submit() {
// 1. 检查nonce
if ( ! isset( $_POST[‘my_nonce_field’] ) || ! wp_verify_nonce( $_POST[‘my_nonce_field’]， ‘my_action’ ) ) {
wp_die( ‘安全校验失败！’ );
}
// 2. 检查权限
if ( ! current_user_can( ‘manage_options’ ) ) {
wp_die( ‘权限不足！’ );
}
// 3. 安全地处理数据…
}代碼組織同國際化
對於複雜嘅插件，建議使用面向對象編程（OOP）來組織代碼，將功能模組化為類。咁樣可以提高代碼嘅可讀性同可重用性。
同時，要從一開始就為插件做好國際化準備。即係話，所有面向用戶嘅字串都應該用WordPress嘅翻譯函數__()、_e()包裝好。回顧插件頭部註釋，我哋已經定義咗Text Domain。喺代碼中應該咁樣用：
$message = __( ‘感谢阅读！本文由“我的第一个插件”为您呈现。’， ‘my-first-plugin’ );然後，你可以用好似Poedit呢類工具來創建.pot模板檔案，俾翻譯人員生成唔同語言嘅.mo檔案。
摘要
透過本指南，你已經完成咗由零開始創建WordPress插件嘅核心旅程。你學識咗點樣搭建開發環境，創建包含標準頭部註釋嘅插件檔案，並利用WordPress強大嘅動作同過濾器鈎子系統來添加功能。我哋仲探討咗點樣安全地添加管理選單、處理數據，並強調咗安全性同國際化嘅重要性。插件開發係一個不斷學習同實踐嘅過程，核心在於理解WordPress嘅鈎子系統同安全準則。跟住落嚟，你可以嘗試開發更複雜嘅功能，例如創建自訂數據庫表、添加短代碼（Shortcode）、小工具（Widget）或者REST API端點，逐步構建功能完善、代碼穩健嘅商業級插件。
常見問題
一個插件係咪一定要放喺一個獨立嘅資料夾入面？
唔係，一個插件可以只係一個單獨嘅.php檔案，直接放喺/wp-content/plugins/目錄下。但係，對於任何包含多個檔案、資源（例如JS、CSS）或者需要翻譯檔案嘅插件，強烈建議使用一個獨立嘅資料夾來存放所有相關檔案，咁樣可以令項目結構更清晰，方便管理。
點樣可以將我嘅插件設定儲存喺數據庫？
WordPress提供咗好方便嘅選項API。你可以用add_option()、get_option()同埋update_option()函數嚟新增、攞取同更新插件設定。呢啲數據會安全咁儲存到WordPress嘅wp_options數據庫表度。對於大量結構化數據，可以考慮將佢序列化成陣列或者JSON字串之後再儲存。
我開發嘅插件會唔會同其他插件撞？
有可能，尤其係當插件用咗通用嘅掛鉤、函數名或者類名嗰陣。為咗避免撞，最好嘅做法係：幫你所有函數、類、變數加返個獨特嘅前綴（例如用插件縮寫或者名），用插件 slug 做命名空間（喺 PHP 5.3+ 可以用真正嘅命名空間），同埋用掛鉤嗰陣揀啱優先級，確保執行順序符合預期。
插件要兼容邊啲 WordPress 版本？
呢個要睇你目標用戶係邊啲。通常建議兼容而家主要版本同之前一兩個版本。你可以喺插件嘅readme.txt文件入面通過Requires at least:用字段嚟聲明最低要求嘅WordPress版本。開發過程中，應該避免使用啱啱先有嘅新版本功能，或者用function_exists()進行兼容性判斷，咁樣可以擴大插件嘅適用範圍。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。