點解要從插件開始學WordPress開發
WordPress嘅核心設計哲學之一係佢極高嘅可擴展性，而插件就係實現呢個特性嘅主要手段。同直接修改主題嘅functions.php檔案相比，創建一個獨立嘅插件有明顯優勢。插件將功能邏輯同主題外觀分開，令到你更換網站主題嗰陣，核心功能可以保留。佢更加有組織同易維護，方便代碼重用、版本控制，同其他開發者分享。
從技術角度睇，一個插件本質上係一個或者多個PHP檔案，跟住特定WordPress標準，擺喺/wp-content/plugins/目錄下。當WordPress初始化時，佢會掃描呢個目錄並加載所有活躍插件嘅代碼。即係話，透過插件，你可以幾乎冇限制噉修改或者增強WordPress嘅任何方面，由加個簡單嘅短代碼到整複雜嘅管理面板都得。
搭建你第一個插件嘅基礎結構
創建一個WordPress插件嘅第一步係建立佢嘅基礎文件結構。雖然一個插件可以得一個檔案，但良好嘅結構有助於長期維護。
推薦閱讀 WordPress 插件開發入門指南：從零構建你嘅第一個自訂功能擴展。
創建主插件檔案
每個插件都必須有一個主檔案，佢包含插件嘅元信息。我哋首先喺本地開發環境嘅/wp-content/plugins/目錄下開一個新資料夾，例如my-first-plugin。然之後，喺嗰個資料夾入面創建主PHP檔案，通常同資料夾同名：my-first-plugin.php。
喺呢個主檔案嘅頭部，我哋需要加返標準嘅插件信息註釋塊。呢個註釋塊係WordPress識別插件同埋顯示喺後台管理介面嘅關鍵。
<?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
*/定義插件核心類
為咗保持代碼嘅封裝性同避免命名衝突，最佳實踐係使用面向對象編程，將插件嘅所有功能封裝喺一個類入面。我哋喺主檔案度定義呢個類。
if ( ! class_exists( 'My_First_Plugin' ) ) {
class My_First_Plugin {
/**
* 构造方法，用于初始化插件
*/
public function __construct() {
// 初始化钩子
$this->init_hooks();
}
/**
* 初始化WordPress动作和过滤器钩子
*/
private function init_hooks() {
// 钩子将在这里添加
}
}
// 实例化插件类
new My_First_Plugin();
}if ( ! class_exists( 'My_First_Plugin' ) )係一個安全檢查，防止類重複定義。__construct()係類嘅構造函數，當類被實例化嗰陣會自動調用。我哋喺入面調用咗一個私有方法init_hooks()嚟集中管理所有掛鈎嘅註冊。
利用掛鉤系統添加功能
WordPress嘅掛鉤（Hooks）系統係佢事件驅動架構嘅核心，分為動作（Actions）同過濾器（Filters）。動作容許你喺特定時刻執行代碼，而過濾器就容許你修改數據。
推薦閱讀 WordPress插件開發從入門到精通：手把手教你創建自訂功能。
為文章內容添加自訂版權
一個常見嘅需求係喺每篇文章嘅末尾自動加上版權資訊。呢個可以透過the_content過濾器嚟實現。我哋喺init_hooks()方法度加入呢個過濾器。
首先，更新吓init_hooks()方法：
private function init_hooks() {
// 使用过滤器在文章内容后追加版权信息
add_filter( 'the_content', array( $this, 'append_copyright_notice' ) );
}呢度，add_filter()函數將我哋類入面嘅append_copyright_notice方法掛載到the_content過濾器上。而家，我哋需要定義呢個回調方法。
/**
* 在文章内容后追加版权信息的回调函数
*
* @param string $content 原始文章内容。
* @return string 追加了版权信息后的内容。
*/
public function append_copyright_notice( $content ) {
// 仅在主查询的单篇文章页面显示
if ( is_single() && in_the_loop() && is_main_query() ) {
$copyright_text = sprintf(
'<p><small>© 版權聲明：本文首發於%s，轉載請註明出處。</small></p>',
get_bloginfo( 'name' )
);
$content .= $copyright_text;
}
return $content;
}呢個方法接收原始嘅$content。透過條件判斷is_single()、in_the_loop()同埋is_main_query()，我哋確保版權資訊只會喺前端單篇文章頁面嘅主體內容度出現，唔會影響到頁面、摘要或者管理後臺。跟住，我哋整一個版權文本，用字串連接操作符.=將佢加喺原本嘅內容後面，最後返返修改咗嘅內容。
建立管理選單頁面
為插件加個簡單嘅設定頁面係另一個常見功能。呢個需要用動作鈎子。我哋會創建一個頂級管理菜單頁面。
在init_hooks()繼續加個動作：
推薦閱讀 WordPress插件開發入門指南：從零到一創建你嘅第一個功能模組。
private function init_hooks() {
add_filter( 'the_content', array( $this, 'append_copyright_notice' ) );
// 添加管理菜单
add_action( 'admin_menu', array( $this, 'add_admin_menu_page' ) );
}當WordPress構建管理菜單嗰陣，會觸發admin_menu動作。我哋跟住落嚟定義add_admin_menu_page()方法。
/**
* 向WordPress管理后台添加一个自定义菜单页面
*/
public function add_admin_menu_page() {
add_menu_page(
'我的第一个插件', // 页面标题
'我的插件', // 菜单标题
'manage_options', // 权限要求
'my-first-plugin-page', // 菜单别名
array( $this, 'render_admin_page' ), // 回调函数，用于输出页面内容
'dashicons-admin-plugins', // 图标
80 // 菜单位置
);
}add_menu_page()函數係WordPress核心API，用嚟註冊一個頂級選單。manage_options係權限標識，代表只有管理員先睇到呢個選單。我哋指定咗render_admin_page方法嚟渲染頁面內容。
/**
* 渲染管理页面内容的回调函数
*/
public function render_admin_page() {
?>
<div class="wrap">
<h1>我嘅第一個插件管理頁面</h1>
<p>恭喜！你已經成功創建咗一個帶有管理頁面嘅WordPress插件。</p>
<p>呢個係一個簡單嘅示例頁面，你可以喺度加表格、設定選項等等。</p>
<p>目前網站名稱係：<strong><?php echo esc_html( get_bloginfo( 'name' ) ); ?></strong></p>
</div>
<?php
}實現國際化同安全最佳實踐
一個規範嘅插件應該考慮到國際化同安全性，以確保佢可以俾全球用戶安全咁使用。
使插件支援多語言
國際化（i18n）令插件文本可以俾翻譯。我哋已經喺插件頭註解中聲明咗Text Domain: my-first-plugin。而家需要用__()或_e()函數嚟包住所有輸出嘅字串。
首先，喺__construct()或init_hooks()入面加個動作去載入翻譯檔案：
add_action( 'plugins_loaded', array( $this, 'load_textdomain' ) );定義載入翻譯嘅方法：
public function load_textdomain() {
load_plugin_textdomain(
'my-first-plugin',
false,
dirname( plugin_basename( __FILE__ ) ) . '/languages/'
);
}跟住，修改之前輸出文本嘅地方。例如，更新append_copyright_notice方法入面嘅文本：
$copyright_text = sprintf(
'<p><small>© %s：%s，%s。</small></p>',
__( '版权声明', 'my-first-plugin' ),
sprintf( __( '本文首发于%s', 'my-first-plugin' ), get_bloginfo( 'name' ) ),
__( '转载请注明出处', 'my-first-plugin' )
);同樣，更新管理頁面入面嘅字串：
<h1><?php esc_html_e( '我的第一个插件管理页面', 'my-first-plugin' ); ?></h1>
<p><?php esc_html_e( '恭喜！你已经成功创建了一个带有管理页面的WordPress插件。', 'my-first-plugin' ); ?></p>esc_html_e()函數喺輸出翻譯文本嘅同時，亦都進行咗HTML轉義，提升咗安全性。
轉義輸出同驗證輸入
喺插件開發入面，所有輸出到前端或者瀏覽器嘅數據都必須進行轉義，所有嚟自用戶或者外部源嘅輸入都必須進行驗證同清理。
喺輸出網站名稱嘅時候，我哋已經用咗esc_html()。这是防止跨站脚本（XSS）攻击的关键步骤。如果一个函数名称以“_e”结尾（意为“echo”），它通常会直接输出转义后的内容。而“__”开头的函数则返回翻译后的字符串，需要你手动进行转义输出。
如果我哋嘅管理頁面將來要處理表單提交，我哋就必須要用wp_verify_nonce()嚟驗證請求，同埋用sanitize_text_field()、intval()等函數嚟清理用戶輸入嘅數據，然後先存入數據庫或者做其他操作。呢個係保護網站安全必不可少嘅步驟。
摘要
透過呢份指南，我哋由建立一個基本嘅插件檔案結構開始，逐步實現插件嘅核心功能。我哋學識咗點樣用面向對象嘅方式組織代碼，點樣利用WordPress強大嘅動作同過濾器鈎子介入佢嘅運行流程，為文章內容加入自訂功能，同埋建立一個管理後台頁面。同時，我哋亦探討咗國際化（i18n）同安全輸出/輸入呢兩個專業插件開發中好重要嘅環節。
呢個只係一個起點。基於呢個框架，你可以繼續探索更多可能性：加入設定選項、建立自訂文章類型同分類法、編寫小工具（Widget）、引入AJAX互動、處理短代碼（Shortcode）等等。記住，睇WordPress官方插件手冊同核心代碼係深入學習嘅最佳途徑。而家，你已經掌握咗由零開始建立WordPress插件嘅基本技能，可以開始將你嘅諗法變成現實喇。
常見問題
插件係咪一定要用類嚟開發？
唔一定。WordPress插件可以用純過程化函數嚟寫。不過，用類（面向對象編程）係更加推薦嘅做法，因為咁樣可以更好地組織代碼，將變量同方法封裝喺獨立嘅命名空間入面，有效避免同其他插件或者主題嘅函數名撞咗，同埋提高代碼嘅可維護性同重用性。
點樣調試我嘅插件？
WordPress開發入面常用嘅調試方法係開啟WP_DEBUG。喺你網站根目錄嘅wp-config.php喺文件入面，搵到同修改以下呢行：define( 'WP_DEBUG', true );。你仲可以同時設定define( 'WP_DEBUG_LOG', true );，咁樣錯誤訊息就會記錄喺/wp-content/debug.log文件度，而唔會顯示喺頁面上。另外，用瀏覽器開發者工具嘅控制台（Console）同網絡（Network）標籤頁，同埋PHP錯誤日誌，都係有效嘅搵問題方法。
我可唔可以直接喺插件度用jQuery呀？
係呀，可以。WordPress核心已經內置咗jQuery庫。為咗正確、安全咁引入你嘅自定義JavaScript檔案或者依賴，你應該用wp_enqueue_script()函數，並且喺依賴數組度聲明array( 'jquery' )。咁樣WordPress就會確保jQuery喺你嘅腳本之前加載。千祈唔好喺插件度硬編碼遠程嘅jQuery CDN連結，咁樣可能會導致衝突或者安全問題。
插件發佈之前需要做啲咩檢查？
喺發佈插件之前，建議做以下檢查：確保程式碼符合WordPress編碼標準；完成國際化準備，所有用戶可見嘅字串都用咗翻譯函數包住；喺多個WordPress版本同PHP版本底下進行兼容性測試；檢查所有輸出係咪已經正確轉義，所有輸入係咪已經妥善驗證同清理；提供一個清晰嘅卸載方法，可以刪除插件創建嘅所有數據庫選項同表（如果需要）；編寫詳細嘅readme.txt文件。呢啲步驟可以提升插件嘅專業度同可靠性。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。