喺互聯網嘅廣闊天地入面，WordPress 憑住佢強大嘅可擴展性，佔據咗內容管理系統嘅半壁江山。而賦予佢無盡擴展能力嘅核心，就係插件。透過 WordPress 插件開發，你可以為網站加入任何你諗到嘅功能。本文會手把手帶你由零開始，建立你嘅第一個 WordPress 插件，深入理解佢嘅核心結構同開發流程。
WordPress 插件基礎同開發環境搭建
開始寫程式之前，理解 WordPress 插件嘅本質同搭建一個合適嘅開發環境至關重要。一個插件本質上係一個或者多個 PHP 檔案，跟住 WordPress 嘅規範，透過特定嘅钩子（Hooks）同核心系統進行互動。
插件嘅基本定義
每個插件都必須有一個唯一嘅主檔案，並喺其頭部以特定格式嘅註解聲明插件資訊。呢段註解係 WordPress 喺插件管理頁面識別並顯示插件名稱、描述、版本等元數據嘅依據。
推薦閱讀 揭秘插件開發：從零開始構建你嘅第一個擴展。
本地開發環境配置
為咗高效且安全地進行開發，強烈建議使用本地伺服器環境。你可以選擇 XAMPP、MAMP、Local by Flywheel 或 Docker 等工具。核心要求係安裝好 PHP（版本需與你嘅目標伺服器兼容）、MySQL/MariaDB 同 Apache/Nginx。之後，下載最新嘅 WordPress 核心檔案並完成安裝。
創建你嘅第一個插件：問候語小工具
而家，等我哋一齊動手整一個簡單嘅插件。呢個插件嘅功能係：喺網站文章內容嘅最尾，自動加返一句自訂嘅問候語。
首先，喺 WordPress 嘅 wp-content/plugins 喺目錄入面，開一個新嘅文件夾，改名做 my-first-greeting-plugin。跟住，喺嗰個文件夾入面整返個主 PHP 文件，可以叫做 my-first-greeting-plugin.php。
插件頭部資訊聲明
打開主文件，輸入以下代碼嚟定義插件：
<?php
/**
* Plugin Name: 我的第一个问候语插件
* Plugin URI: https://yourwebsite.com/my-first-greeting-plugin
* Description: 这是一个练习用的插件，用于在文章末尾添加问候语。
* Version: 1.0.0
* Author: 你的名字
* Author URI: https://yourwebsite.com
* License: GPL v2 or later
* Text Domain: my-first-greeting-plugin
*/保存文件之後，進入 WordPress 後台嘅「插件」頁面，你應該會睇到呢個新插件出現喺插件列表度，而且可以啟動佢。當然，而家佢仲未有任何功能。
推薦閱讀 WooCommerce 电商网站性能优化嘅 10 个关键技巧同实战指南。
用掛鉤添加核心功能
WordPress 嘅運作好依賴「掛鉤」機制，分為动作钩子（Action Hooks）同过滤器钩子（Filter Hooks）。我哋要喺文章內容後加文字，需要用 the_content 呢個過濾器鈎。
喺主文件嘅頭部註解下面，加以下函數同鈎：
// 定义向文章内容添加问候语的函数
function mfgp_add_greeting_to_content( $content ) {
// 确保只在主循环的单篇文章页面显示
if ( is_single() && in_the_loop() && is_main_query() ) {
$greeting = '<p style="color:#666; font-style:italic;">多謝你睇完呢篇文章！祝你今日過得開心！</p>';
$content .= $greeting;
}
return $content;
}
// 将函数挂载到 ‘the_content’ 过滤器钩子上
add_filter( 'the_content', 'mfgp_add_greeting_to_content' );保存檔案並啟動插件之後，打開網站上任何一篇文章，捲到最尾，你應該會睇到新增嘅問候語。透過呢個簡單例子，你已經實踐咗插件開發最核心嘅概念：聲明插件、編寫功能函數、透過add_filter或add_action將函數掛上正確嘅掛鈎。
插件功能增強：加設管理設定頁面
一個成熟嘅插件通常容許用戶喺後台進行設定。跟住落嚟，我哋為問候語插件加設一個簡單嘅設定頁面，等管理員可以自訂顯示嘅文字。
建立管理選單項目
首先，我哋需要用add_action個鉤子會調用一個函數，呢個函數會用 add_options_page 個函數會喺WordPress後台嘅「設定」選單下面加一個子頁面。
喺主文件度繼續加以下嘅代碼：
推薦閱讀 從零到一：WordPress插件開發完整指南與實戰教程。
// 添加设置菜单
function mfgp_add_admin_menu() {
add_options_page(
'问候语插件设置', // 页面标题
'自定义问候语', // 菜单标题
'manage_options', // 权限要求（管理员）
'my-greeting-plugin', // 菜单 Slug
'mfgp_settings_page_html' // 用于输出页面内容的回调函数
);
}
add_action( 'admin_menu', 'mfgp_add_admin_menu' );建立設定頁面同埋保存邏輯
而家，我哋需要定義上面嘅回調函數 mfgp_settings_page_html 嚟渲染設定頁面嘅 HTML 表單，同埋處理表單數據嘅儲存。WordPress 提供咗設定 API 嚟簡化呢個過程，但為咗清楚理解流程，我哋先用基礎方法。
// 定义设置页面的 HTML 结构
function mfgp_settings_page_html() {
// 检查用户权限
if ( !current_user_can( 'manage_options' ) ) {
return;
}
// 处理表单提交（非设置API方式）
if ( isset( $_POST['mfgp_greeting_text'] ) ) {
// 验证 Nonce 确保请求来源安全
check_admin_referer( 'mfgp_save_settings' );
// 清理并保存输入的数据
$greeting_text = sanitize_textarea_field( $_POST['mfgp_greeting_text'] );
update_option( 'mfgp_custom_greeting', $greeting_text );
echo '<div class="notice notice-success is-dismissible"><p>設定已儲存！</p></div>';
}
// 获取已保存的问候语
$saved_greeting = get_option( 'mfgp_custom_greeting', '感谢您阅读本文！祝你拥有美好的一天！' );
?>
<div class="wrap">
<h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
<form method="post" action="">
<?php wp_nonce_field( 'mfgp_save_settings' ); ?>
<table class="form-table">
<tr>
<th scope="row"><label for="mfgp_greeting_text">自訂問候語</label></th>
<td>
<textarea name="mfgp_greeting_text" id="mfgp_greeting_text" rows="5" cols="50" class="large-text"><?php echo esc_textarea( $saved_greeting ); ?></textarea>
<p class="description">呢段文字會喺每篇文章嘅結尾顯示。</p>
</td>
</tr>
</table>
<?php submit_button( '保存更改' ); ?>
<input type="hidden" name="trp-form-language" value="yue"/></form>
</div>
<?php
}更新前端輸出函數
最後，我哋需要修改之前嘅前端輸出函數，令佢從數據庫嘅選項（get_option）中讀取問候語，而唔係用死板嘅文字。
function mfgp_add_greeting_to_content( $content ) {
if ( is_single() && in_the_loop() && is_main_query() ) {
// 从数据库选项中获取问候语，如果没有则使用默认值
$greeting_text = get_option( 'mfgp_custom_greeting', '感谢您阅读本文！祝你拥有美好的一天！' );
if ( ! empty( $greeting_text ) ) {
$greeting = '<p style="color:#666; font-style:italic;">' . esc_html( $問候文字 ) . '</p>';
$content .= $greeting;
}
}
return $content;
}而家，管理員可以喺「設定」 -> 「自訂問候語」頁面自由修改顯示嘅文字，前端展示會即時更新。
插件發佈準備：國際化同安全強化
喺將插件分享俾其他人或者提交到官方目錄之前，仲需要做一啲重要嘅收尾工作，主要係國際化同安全強化。
實現文本國際化
國際化（i18n）令你嘅插件可以翻譯成其他語言。你需要用特定嘅函數包住所有面向用戶嘅字串。修改我哋插件入面嘅字串：
1. 在插件头部注释中，我们已经定义了 Text Domain。
2. 在代码中，使用 () 或 esc_html() 函數包住字串。例如：
// 在设置页面函数中
$greeting_text = get_option( 'mfgp_custom_greeting', __( ‘感谢您阅读本文！祝你拥有美好的一天！’， ‘my-first-greeting-plugin’ ) );
echo ‘<h1>’ . esc_html__( ‘问候语插件设置’， ‘my-first-greeting-plugin’ ) . ‘</h1>’;
// 在前端输出函数中（注意：前端输出通常不需要翻译，除非是主题或用户决定）
// 但如果问候语本身需要多语言，可能需要更复杂的逻辑。3. 使用工具如 Poedit 创建 .pot 模板檔案，翻譯人員就可以跟住整 .po 同埋 .mo 檔案。
加強安全防護
安全係好緊要嘅。我哋已經用咗啲安全功能，好似sanitize_textarea_field、esc_html、esc_textarea同埋wp_nonce_field。另外，仲要留意：
* 权限检查：在管理页面函数开始处使用 current_user_can 進行檢查。
* 数据验证与清理：对所有用户输入（如 $_POST, $_GET）进行验证（是否符合预期格式）和清理（移除非法字符）。
* 非竞态条件更新：对于重要的选项，考虑使用 wp_options 表達時間，更安全嘅方式係使用 Settings API，佢內置咗非競態（nonce）同權限檢查。
摘要
透過呢個指南，我哋完成咗一個功能完整嘅 WordPress 插件從創建到發佈嘅完整旅程。我哋從理解插件基礎開始，創建咗帶有標準頭部信息嘅主文件；然後透過一個簡單嘅問候語功能，實踐咗 WordPress 最核心嘅掛鈎機制；跟住，我哋為插件加咗後台設置頁面，實現咗用戶可配置性；最後，我哋探討咗發佈前嘅關鍵步驟——國際化同安全強化。每個步驟都包含咗核心嘅 WordPress 函數同最佳實踐。掌握呢啲基礎知識之後，你就可以嘗試開發更複雜、更有創意嘅插件，為全球嘅 WordPress 生態系統貢獻力量。
常見問題
開發 WordPress 插件需要咩先決知識？
你需要具備基本嘅 PHP 編程知識，了解 HTML 同 CSS，並且對 WordPress 嘅基本操作（如文章、頁面、菜單）有一定了解。熟悉面向對象編程（OOP）唔係必須嘅，但會對開發大型插件有好大幫助。
點解我個插件啟動咗之後喺後台菜單度唔見咗？
最常見嘅原因係權限問題。請檢查你喺調用add_options_page或者類似函數嗰陣，第二個參數（ capability ）係咪設定得啱，例如 ‘manage_options’。另外，請確保你嘅函數已經正確噉透過add_action( ‘admin_menu’， ...)個鉤掛咗上去，而且冇語法錯誤搞到個函數冇執行到。你可以喺代碼開頭加error_log個函數嚟調試。
點樣調試我嘅 WordPress 插件？
首先，確保你喺你嘅 wp-config.php 個檔案開咗 WordPress 除錯模式：將 define( ‘WP_DEBUG’， true ); 同埋 define( ‘WP_DEBUG_LOG’， true );。咁樣錯誤訊息會記錄到 /wp-content/debug.log 喺文件入面。其次，可以用瀏覽器開發者工具嘅「控制台」同「網絡」選項卡進行前端調試。對於複雜嘅邏輯，用error_log( print_r( $variable， true ) );將變量值輸出到日誌係常用方法。
我嘅插件點樣同其他插件或者主題兼容？
為咗最大程度保證兼容性，你嘅插件應該：1）用獨特嘅前綴命名所有函數、類、變量同選項（好似我哋用咗mfgp_），避免命名衝突。2）喺添加修改前端或後端樣式時，盡量用獨特嘅選擇器類名。3）喺可能嘅情況下，提供過濾器鈎（apply_filters），容許其他開發者修改你插件嘅行為。4）避免直接修改 WordPress 核心數據庫表或者檔案。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。