要開發一個 WordPress 外掛，首先需要在 WordPress 安裝目錄的 wp-content/plugins 在文件夹中创建一个专用的子文件夹。该子文件夹的名称应与你的插件核心功能或名称相关，最好使用小写字母和连字符，例如 my-first-plugin。
接下来，您需要在该文件夹中创建主插件文件。该文件通常以插件名称命名，例如 my-first-plugin.php该文件是插件的入口，其顶部必须包含一个符合 WordPress 标准的插件头部注释。该注释块用于向 WordPress 系统提供插件的基本信息，是插件被识别和启用的关键。
一個典型的外掛頭部註釋如下所示：
推荐阅读 零基础精通 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
* Domain Path: /languages
*/建立並填寫這個檔案後，你就可以在 WordPress 後臺的“外掛”頁面中看到你的外掛，並可以將其激活了。這標誌著你的外掛開發之旅正式啟動。
理解外掛的基礎結構
一個結構良好的 WordPress 外掛不僅便於自己維護，也方便其他開發者理解。遵循標準的組織方式能讓你的程式碼更清晰、更專業。
核心檔案與目錄的組織方式
除了主插件文件外，一个功能齐全的插件通常还包含多个目录和文件。例如，includes/ 目錄用於存放核心的 PHP 類或函式檔案；admin/ 目錄存放後臺管理介面相關的程式碼；public/ 或者 frontend/ 目錄存放面向網站訪客的程式碼；assets/ 目錄則用於存放 JavaScript、CSS 和圖片等靜態資源。
此外，還可能需要 languages/ 目錄存放國際化翻譯檔案（.po/.mo），以及一個 uninstall.php 檔案來處理外掛被刪除時的清理工作。合理的目錄結構是構建可維護、可擴充套件外掛的基礎。
外掛生命週期與標準鉤子
WordPress 外掛透過一系列“鉤子”（Hooks）與核心系統互動。理解外掛的生命週期，關鍵在於理解這些鉤子的執行順序。當 WordPress 處理一個請求時，它會依次載入核心檔案、主題和已啟用的外掛。
推荐阅读 《WordPress 插件开发完全指南：从入门到实战精讲》。
外掛開發者可以利用 register_activation_hook 外挂启用时，会执行一次性任务，例如创建数据库表。同样，register_deactivation_hook 用於處理外掛停用時的操作（注意，這不是刪除）。而 register_uninstall_hook 或一個獨立的 uninstall.php 檔案則用於在外掛被從 WordPress 中刪除時清理資料。
在日常執行中，最常用的兩個鉤子型別是動作（Action）和過濾器（Filter）。動作允許你在特定時刻（如 init）插入程式碼以執行功能；過濾器則允許你修改其他函式傳遞的資料（如 the_content）。
實現核心功能與安全互動
開發外掛的主要目的是為 WordPress 新增新功能。無論是新增一個簡碼、建立一個小工具，還是處理表單資料，都需要遵循 WordPress 的安全和互動規範。
建立短程式碼來輸出內容
短程式碼（Shortcode）是允許使用者在文章或頁面中透過一個簡單標籤來插入動態內容的強大工具。你可以使用 add_shortcode 函式來註冊你自己的短程式碼。
例如，以下代码注册了一个名为 For example, the following code registers a program named 例如，以下代码注册了一个名为 <的程序。 greet 的短程式碼，它接受一個 name 屬性並向用戶問好：
function myplugin_greet_shortcode( $atts ) {
// 使用 shortcode_atts 函数设置默认值并合并用户属性，确保安全性
$atts = shortcode_atts( array(
'name' => '访客',
), $atts, 'greet' );
// 在输出前对用户输入进行转义
$name = esc_html( $atts['name'] );
return '<p>你好，' . $name . '！欢迎来到本网站。</p>'将以下代码片段翻译成中文（简体），并详细解释其含义：
```php
function myplugin_greet_shortcode( $atts, $content ) {
$output = '你好！';
return $output;
}
add_shortcode( 'greet', 'myplugin_greet_shortcode' );
```;使用者可以在文章編輯器中輸入 [greet name=“小明”]然后，前端会显示“你好，小明！欢迎来到本网站。” 请记住，从用户处获取的所有数据在输出前都必须经过适当的转义或验证。例如，上面例子中使用了转义符号。 esc_html。
推荐阅读 WordPress 插件开发入门指南：从零开始创建你的第一个自定义插件。
為外掛新增設定頁面
對於需要使用者配置的外掛，建立一個後臺選項頁面是標準做法。你可以利用 WordPress 的“設定API”來安全、便捷地新增頁面和欄位，它自動處理了安全驗證（nonce）和資料儲存。
首先，使用 add_options_page 或者 add_menu_page 等函式在管理後臺新增一個選單項和頁面。然後，使用 register_setting、add_settings_section 以及 add_settings_field 等函式來定義你的設定選項。
以下是一個建立簡單設定頁面的框架程式碼：
function myplugin_add_admin_menu() {
add_options_page(
'我的插件设置', // 页面标题
'我的插件', // 菜单标题
'manage_options', // 所需权限
'myplugin-settings', // 菜单 Slug
'myplugin_settings_page' // 用于渲染页面的回调函数
);
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );
function myplugin_settings_init() {
register_setting( 'myplugin_settings_page', 'myplugin_settings' );
add_settings_section( 'myplugin_section', '基础设置', null, 'myplugin_settings_page' );
add_settings_field(
'api_key',
'API 密钥',
'myplugin_api_key_field_render', // 渲染输入字段的函数
'myplugin_settings_page',
'myplugin_section'
);
}
add_action( 'admin_init', 'myplugin_settings_init' );
function myplugin_api_key_field_render() {
$options = get_option( 'myplugin_settings' );
$value = isset( $options['api_key'] ) ? esc_attr( $options['api_key'] ) : '';
echo '<input type="text" name="myplugin_settings[api_key]" value="' . $value . '" />';
}
function myplugin_settings_page() {
?>
<form action='/zh-tw/options.php/' method='post' data-trp-original-action="options.php">
<h2>我的插件设置</h2>
<input type="hidden" name="trp-form-language" value="zh-tw"/></form>
<?php
}使用設定 API 可以確保你的外掛選項被安全地儲存到 wp_options 表中，並且管理介面符合 WordPress 風格。
遵循開發最佳實踐
編寫一個能長期穩定執行、易於維護且與其他外掛和諧共處的外掛，需要遵循一些關鍵的最佳實踐。
確保程式碼的安全性
安全性是外掛開發的重中之重。必須對所有使用者輸入（包括來自 URL、表單、Cookies 和資料庫的資料）進行驗證、清理和轉義。使用 WordPress 提供的系列函式，如 esc_html、esc_url、sanitize_text_field 來處理輸出；使用 wp_verify_nonce 以及 check_admin_referer 來驗證請求的合法性，防止跨站請求偽造（CSRF）攻擊。
在進行資料庫查詢時，務必使用 $wpdb 類提供的方法（如 prepare）來防止 SQL 注入攻擊。絕對不要直接拼接使用者輸入到 SQL 語句中。
實現國際化與本地化
為了讓你的外掛能被全世界的 WordPress 使用者使用，國際化（i18n）是必須的。這意味著你需要使用 WordPress 的翻譯函式來包裹所有面向用戶的字串。
在你的外掛頭部註釋中定義好 Text Domain（例如 my-first-plugin以及 Domain Path在程式碼中，對所有需要翻譯的字串使用 __() 進行翻譯，使用 _e() 進行翻譯並直接輸出，使用 _n() 處理單複數形式。
例如：$text = __(‘Hello World’， ‘my-first-plugin’);然后，你可以使用 Poedit 等工具来生成相关翻译内容。 .pot 模板檔案，供翻譯人員建立 .po 以及 .mo 檔案。將翻譯檔案放入外掛根目錄的 /languages 資料夾，WordPress 便會根據網站語言自動載入對應的翻譯。
進行程式碼最佳化與效能考量
效能不佳的外掛會拖慢整個網站。應避免在每次頁面載入時都執行大量不必要的程式碼。將只在後臺使用的指令碼和樣式透過條件判斷（如 is_admin()）僅載入在後臺；將前端資源透過 wp_enqueue_script() 以及 wp_enqueue_style() 在適當的鉤子（如 wp_enqueue_scripts）中排隊載入。
對於耗時的操作或外部 API 呼叫，考慮使用 WordPress 的 Transients API (set_transient， get_transient进行缓存操作。同时，要确保在禁用或删除插件时，能够正确处理其相关数据。 uninstall.php 清理自己建立的資料庫表和選項，但需謹慎操作，併為使用者提供是否刪除資料的選項。
除錯、測試與釋出
在將你的外掛交付給使用者之前，徹底的除錯、測試和準備工作是確保成功的關鍵步驟。
利用 WordPress 除錯工具
在開發階段，強烈建議開啟 WordPress 的除錯模式。在 wp-config.php 文件中的设置 define(‘WP_DEBUG’， true);这样一来，所有 PHP 错误、警告和通知都会被显示出来，帮助你快速定位问题。你还可以同时启用 WP_DEBUG_LOG 將錯誤記錄到日誌檔案，或啟用 SCRIPT_DEBUG 來載入未壓縮的 JavaScript 和 CSS 檔案以方便除錯。
準備外掛釋出資訊
如果你計劃將外掛提交到官方的 WordPress.org 外掛目錄，你需要準備一系列材料。這包括一個詳盡的 readme.txt 檔案，其格式必須符合 WordPress 的要求，包含描述、安裝步驟、常見問題、更新日誌等。你還需要提供高質量的橫幅和圖示圖片，以及填寫外掛的 SVN 倉庫描述。
在程式碼層面，確保你已經完成了國際化準備，並仔細檢查了所有程式碼是否符合 WordPress 編碼標準。你可以在本地使用 PHP_CodeSniffer 與 WordPress 編碼標準規則來進行檢查。
進行跨環境相容性測試
在釋出前，必須在多種環境下測試你的外掛。這包括不同版本的 WordPress（尤其是當前版本和上一個主要版本）、不同的 PHP 版本（如 PHP 7.4， 8.0， 8.1）、不同的資料庫版本（MySQL/MariaDB）以及與流行主題和其他外掛的相容性測試。確保你的外掛在啟用、停用、設定和使用的各個階段都沒有丟擲錯誤或警告。
总结
WordPress 外掛開發是一個將創意轉化為功能，並融入龐大生態系統的過程。從建立一個符合標準的主檔案開始，逐步構建清晰的檔案目錄結構，並深入理解動作與過濾器鉤子這一核心互動機制。在實現短程式碼、設定頁面等具體功能時，必須將安全性（驗證、轉義、防注入）和國際化作為編碼習慣。遵循最佳實踐，如最佳化效能、妥善管理資源，並利用除錯工具確保程式碼質量。最終，透過全面的跨環境測試和完善的釋出準備，你的外掛就能穩定、安全地為全球 WordPress 使用者服務。持續學習官方手冊和社群資源，是不斷提升外掛開發水平的關鍵。
常见问题解答（FAQ）
開發 WordPress 外掛需要哪些基礎知識？
你需要具備紮實的 PHP 程式設計基礎，因為外掛核心邏輯主要由 PHP 編寫。同時，需要對 HTML、CSS 和 JavaScript 有基本瞭解，用於構建使用者介面和互動。最重要的是，你必須熟悉 WordPress 的基本架構，包括其鉤子系統（動作和過濾器）、主題迴圈、資料庫結構以及各種核心函式和類的用法。
如何避免我的外掛與其他外掛發生衝突？
為你的所有函式、類、常量、動作/過濾器標籤以及選項名稱新增唯一字首是防止衝突最有效的方法。不要使用通用名稱，如 add_user() 或者 $count相反，应当使用与你的插件相关的标识符，例如 myplugin_add_user() 或者 $myplugin_count将你的代码封装在类或命名空间中也是一种良好的实践。此外，在排列代码和样式时，应使用唯一的控制代码，并考虑按需加载资源。
我應該將外掛資料儲存在哪裡？
對於簡單的配置選項，使用 WordPress 的 Options API (add_option, get_option, update_option将数据存储在 wp_options 表格是存储数据最简单、最标准的方式。如果你需要存储大量结构化的自定义数据（例如产品、订单等），就应该创建自定义数据库表。使用表格可以更高效地管理数据，避免数据混乱和重复输入。 $wpdb 物件並在外掛啟用時透過 dbDelta() 函式來建立和更新表結構，這能確保跨資料庫版本的相容性。
外掛被刪除後，如何清理其建立的資料？
WordPress 提供了兩種主要方式。第一種是使用 register_uninstall_hook() 函式註冊一個解除安裝鉤子。第二種，也是更推薦的方式，是在外掛根目錄建立一個獨立的 uninstall.php 檔案。在這個檔案中，你需要檢查是否從 WordPress 內部呼叫了 WP_UNINSTALL_PLUGIN 常量，然後執行刪除自定義選項（使用 delete_option）和自定義資料庫表等清理操作。請注意，務必在外掛描述中告知使用者刪除操作會清除哪些資料。
下一步，该怎么做呢？
延伸阅读与实用知识
下方列出的内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，然后逐步扩展到相关主题，这样效果通常会更好。