WordPress插件開發基礎同環境準備
喺開始寫程式之前，理解WordPress插件嘅基本概念同埋搭好開發環境係好緊要嘅。一個WordPress插件本質上係一個或者多個PHP檔案嘅集合，佢透過WordPress提供嘅掛鈎（Hooks）系統嚟擴充或者修改核心功能。插件可以簡單到只係加一個短代碼，亦都可以複雜到起一個完整嘅電子商務系統。
開發環境嘅核心係建立一個本地嘅伺服器環境。你可以用XAMPP、MAMP、Local by Flywheel或者Docker等工具快速搭一個包含PHP、MySQL同Apache/Nginx嘅本地WordPress網站。確保你嘅PHP版本同而家WordPress官方推薦版本保持一致。喺程式編輯器方面，Visual Studio Code、PhpStorm或者Sublime Text都係唔錯嘅選擇，佢哋能夠提供語法高亮、程式提示同除錯支援，明顯提升開發效率。
一個標準嘅WordPress插件必須至少包含一個主PHP檔案，而且呢個檔案頭部需要包含特定嘅插件資訊註解。呢啲註解係WordPress識別插件嘅關鍵。另外，雖然唔係強制，但係為你個插件開一個獨立嘅目錄係好好嘅做法，咁樣有助於管理資源檔案、語言包同其他依賴。
推薦閱讀 由入門到精通WordPress插件開發：整份打造個人化網站嘅完整指南。
創建你嘅第一個插件檔案
而家，等我哋動手創建第一個插件嘅核心檔案。首先，你需要進入WordPress安裝目錄下嘅/wp-content/plugins/資料夾。喺呢度，為你嘅插件創建一個新嘅資料夾，例如命名為my-first-plugin。
喺該資料夾入面，創建一個主PHP檔案。通常呢個主檔案會同插件資料夾同名，例如my-first-plugin.php。呢個檔案嘅開頭必須包含標準嘅插件頭部資訊。
<?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插件後台所需嘅所有元資訊。保存檔案之後，你喺WordPress後台嘅「插件」頁面就會見到同可以啟動呢個插件喇。而家佢仲未有乜嘢功能，但結構已經建立好。
為插件加一個簡單功能
啟動插件之後，我哋為佢加第一個實際功能：喺網站頁腳顯示一行自訂文字。我哋會用WordPress嘅wp_footer鉤子。
喺插件主檔案my-first-plugin.php嘅頭部註釋下面，加返以下代碼：
推薦閱讀 由零開始掌握WordPress插件開發：構建自訂功能與擴展。
// 在网站页脚输出自定义文本
function mfp_add_footer_text() {
echo '<p style="text-align: center; color: #666;">多謝你使用呢個網站！由「我嘅第一個插件」提供支援。</p>';
}
add_action( 'wp_footer', 'mfp_add_footer_text' );呢度，mfp_add_footer_text係我哋自訂嘅函數，包含要輸出嘅HTML內容。add_action()係用於添加動作掛鈎嘅核心函數，將我哋嘅函數「掛上」WordPress核心嘅wp_footer呢個執行點。保存檔案並刷新網站前台，你就會喺頁面底部睇到呢行文字。
用短代碼擴展內容編輯
短碼（Shortcode）係WordPress提供嘅一個強大功能，容許用戶喺文章或者頁面度用簡單標籤插入動態內容。跟住，我哋整一個簡單嘅短碼嚟顯示當前日期。
喺同一個主文件度，繼續加以下代碼：
// 创建一个显示当前日期的短代码
function mfp_show_current_date( $atts ) {
// 定义短码的默认属性
$attributes = shortcode_atts(
array(
'format' => 'Y年m月d日',
),
$atts
);
// 根据属性中的格式返回日期
return date( $attributes['format'] );
}
add_shortcode( 'show_date', 'mfp_show_current_date' );函數mfp_show_current_date定義咗短碼嘅邏輯。shortcode_atts()個函數用嚟合併用戶自訂嘅屬性同預設屬性，確保代碼嘅穩健性。最後，add_shortcode()個函數會將[show_date]呢個標籤同我哋自訂嘅處理函數關聯埋一齊。
而家，你可以喺任何文章、頁面或者小工具嘅文字編輯器入面輸入[show_date]用嚟顯示默認格式嘅日期，或者用[show_date format="F j, Y"]嚟顯示英文格式嘅日期。
深入理解鉤子同過濾器
WordPress插件開發嘅核心哲學係「鉤子」（Hooks）。鉤子分為兩種：動作（Action）同過濾器（Filter）。我哋之前用過嘅add_action()就係加一個動作鈎。
推薦閱讀 從零開始：整你第一個WordPress插件。
動作鈎喺特定時間點執行你嘅代碼，佢唔預期有返回值，通常用嚟輸出內容或者執行某啲任務，例如喺頁腳加啲文字。過濾器鈎就用嚟修改數據。佢會收到一個值，經過你個函數處理之後，必須返返個修改過嘅值。
用過濾器修改文章標題
等我哋整一個過濾器，幫所有文章標題自動加個前綴。喺插件主文件度加：
// 使用过滤器为文章标题添加前缀
function mfp_add_title_prefix( $title, $id = null ) {
// 确保只在主循环且是文章页面的标题上生效
if ( in_the_loop() && is_single() && get_post_type( $id ) === 'post' ) {
$title = '【推荐阅读】' . $title;
}
return $title;
}
add_filter( 'the_title', 'mfp_add_title_prefix', 10, 2 );呢度，the_title係一個過濾器掛鉤。add_filter()嘅第三個參數「10」係優先級（數字越細越先執行），第四個參數「2」表示我哋嘅處理函數會接受兩個參數（原本嘅$title同文章ID）。呢個函數會檢查條件，只喺單篇文章頁面同埋喺主循環嗰陣，先至幫個標題加前綴。
插件安全與最佳實踐
開發插件嗰陣，安全性係首要考慮因素。千祈唔好相信用戶輸入嘅數據，一定要進行驗證、清理同轉義。
數據驗證與轉義
當插件需要處理嚟自表格或者URL嘅數據時，必須使用WordPress提供嘅安全函數。例如，使用sanitize_text_field()來清理文本輸入，使用esc_html()或esc_attr()來輸出HTML或屬性，以防止跨站腳本（XSS）攻擊。
實現一個簡單嘅設定頁面
一個完整嘅插件通常需要一個後台設定頁面。呢度示範點樣創建一個簡單嘅選項頁，並安全噉保存一個設定項。
// 在后台管理菜单中添加一个选项页面
function mfp_add_admin_menu() {
add_options_page(
'我的第一个插件设置', // 页面标题
'我的插件设置', // 菜单标题
'manage_options', // 权限要求
'my-first-plugin', // 菜单slug
'mfp_options_page_html' // 用于显示页面内容的回调函数
);
}
add_action( 'admin_menu', 'mfp_add_admin_menu' );
// 注册一个设置项
function mfp_settings_init() {
register_setting( 'mfpPlugin', 'mfp_settings' ); // 设置组，选项名
add_settings_section(
'mfp_plugin_section', // 区块ID
'基础设置', // 区块标题
null, // 区块介绍的回调函数（此处为null）
'my-first-plugin' // 所属页面slug
);
add_settings_field(
'custom_text', // 字段ID
'自定义显示文本', // 字段标签
'mfp_custom_text_field_html', // 用于输出字段HTML的回调函数
'my-first-plugin', // 页面slug
'mfp_plugin_section' // 所属区块ID
);
}
add_action( 'admin_init', 'mfp_settings_init' );
// 渲染设置字段的HTML
function mfp_custom_text_field_html() {
$options = get_option( 'mfp_settings' );
$value = isset( $options['custom_text'] ) ? esc_attr( $options['custom_text'] ) : '';
?>
<input type='text' name='mfp_settings[custom_text]' value='<?php echo $value; ?>'>
<p class="description">呢度輸入嘅文字會喺頁尾顯示出嚟。</p>
<?php
}
// 渲染整个选项页面的HTML
function mfp_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( 'mfpPlugin' ); // 输出安全字段
do_settings_sections( 'my-first-plugin' ); // 输出设置区块和字段
submit_button( '保存设置' );
?>
<input type="hidden" name="trp-form-language" value="yue"/></form>
</div>
<?php
}呢段代碼喺「設定」菜單下面開咗個子頁面，用嚟儲存一段自訂文字。留意返入面對用戶權限嘅檢查（current_user_can）同埋對輸出數據嘅轉義（esc_html, esc_attr），呢啲都係安全實踐嘅一部分。之後，你可以改返之前頁腳輸出嘅函數，從get_option( 'mfp_settings' )度讀取呢個值嚟動態顯示。
摘要
透過呢個教程，你完成咗由零開始構建一個功能完整嘅WordPress插件嘅全過程。你學識咗點樣創建插件嘅基本檔案結構，利用動作掛鈎add_action喺頁尾加內容，透過add_shortcode創建自訂短代碼，同埋用過濾器掛鈎add_filter修改文章數據。更重要嘅係，你接觸到插件安全嘅核心概念，同埋實踐咗點樣創建一個安全嘅後台設定頁面嚟管理插件選項。
插件開發係一個持續學習同實踐嘅過程。下一步，你可以試下為插件加入國際化支援（用__()同埋_e()函數），引入JavaScript同CSS資源，或者用面向對象編程（OOP）嚟重構代碼結構，等佢更加易於維護同擴展。記住，睇WordPress官方插件手冊同核心代碼係提升技能嘅最佳途徑。
常見問題
點樣調試我嘅WordPress插件？
開啟WordPress嘅除錯模式係第一步。喺網站wp-config.php檔案入面，將WP_DEBUG常數設定為true。咁樣會直接喺頁面上顯示PHP錯誤、警告同通知。對於更複雜嘅除錯，可以用error_log()個函數會將資訊寫入伺服器嘅錯誤日誌，或者用專業嘅除錯插件好似Query Monitor咁，嚟睇數據庫查詢、掛鈎執行同埋效能數據。
我個插件點樣兼容唔同嘅WordPress版本？
喺插件代碼入面，你應該用條件判斷嚟檢查WordPress核心函數、類或者常量嘅存在性，然後先用佢哋。可以用function_exists()、class_exists()或defined()嚟判斷。同時，喺插件嘅readme.txt文件入面要清楚講明你個插件支援嘅最低WordPress版本（透過「Requires at least」欄位），咁樣可以幫用戶了解兼容性。
開發插件係咪一定要用面向對象編程？
唔係必須嘅。你可以用純過程式編程（好似呢個教程嘅例子咁）嚟開發功能完整嘅插件。面向對象編程（OOP）嘅主要好處係有更好嘅代碼組織、封裝同可重用性，對於大型、複雜嘅插件項目更加有利。對於細型插件，過程式編程可能更加簡單直接。你可以根據項目嘅規模同複雜度嚟揀合適嘅方法。
點樣將我嘅插件發佈到WordPress官方插件目錄？
首先，你要喺WordPress.org度註冊一個帳戶同提交插件。你嘅插件代碼必須符合官方代碼標準同指引，包括安全性、冇惡意代碼、使用GPL兼容許可證等等。你需要創建一個詳細嘅readme.txt文件，同確保插件嘅主文件頭部註釋符合規範。提交之後，會有插件審查團隊嘅義工進行審核，通過咗就可以發佈。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。