准备工作与环境搭建
在開始編寫程式碼之前，你需要一個合適的開發環境。這包括一個本地的 WordPress 安裝和一個程式碼編輯器。推薦使用 XAMPP、Local by Flywheel 或 Docker 來搭建本地伺服器環境。確保你的 WordPress 是最新版本，以便使用最新的 API 和安全功能。
你需要了解 WordPress 外掛的基本結構。一個最小的外掛至少需要一個主檔案，該檔案是一個具有特定檔案頭註釋的 PHP 檔案。這個檔案的名字通常是 your-plugin-name.php，它告訴 WordPress 這是一個外掛，並提供了名稱、描述、版本和作者等資訊。
在程式碼編輯器中，為你的外掛專案建立一個新資料夾，例如 my-first-plugin。在這個資料夾內，建立主 PHP 檔案。
推荐阅读 零基础入门：WordPress插件开发终极指南与实践教程。
建立你的第一個外掛檔案
現在，讓我們動手建立外掛的主檔案。這個檔案是外掛的入口點，它透過頂部的註釋塊向 WordPress 宣告自己的存在。
編寫外掛頭部資訊
在剛剛建立的 PHP 檔案中，你需要新增標準的外掛檔案頭。例如，一個名為“站點問候語”的外掛可以這樣開始：
<?php
/**
* Plugin Name: 站点问候语
* Plugin URI: https://example.com/my-first-plugin
* Description: 一个简单的插件，用于在网站前台显示自定义问候语。
* Version: 1.0.0
* Author: 你的名字
* License: GPL v2 or later
* Text Domain: my-first-plugin
* Domain Path: /languages
*/WordPress 會掃描 wp-content/plugins 目錄下的所有 PHP 檔案，讀取這些特定的註釋資訊，並將其顯示在後臺的外掛管理頁面中。其中 Text Domain 用於國際化，Domain Path 指定了語言檔案的位置。
實現核心功能程式碼
在頭部資訊下方，你就可以開始編寫外掛的功能程式碼了。我們以一個簡單的功能為例：在網站頁尾的左上角輸出一句問候語。為了避免直接修改主題檔案，我們將使用 WordPress 的鉤子系統。
首先，我們需要建立一個函式來輸出問候語。然後，使用 add_action 函式將這個輸出鉤到 WordPress 的某個執行動作上，例如 wp_footer。
推荐阅读 WordPress外掛開發完整指南：從零基礎到實戰上架。
// 定义一个函数来输出问候语
function my_first_plugin_display_greeting() {
echo '<p style="position: fixed; bottom: 10px; left: 10px; background: #f1f1f1; padding: 10px; border-radius: 5px;">你好，欢迎来到我的网站！</p>';
}
// 使用 add_action 钩子将函数挂载到 wp_footer 动作
add_action( 'wp_footer', 'my_first_plugin_display_greeting' );完成以上程式碼後，將這個外掛資料夾（例如 my-first-plugin）整個複製到你的 WordPress 安裝目錄下的 wp-content/plugins/ 路徑中。然後，登入 WordPress 後臺，進入“外掛”選單，你應該能看到“站點問候語”這個外掛，點選“啟用”。現在，訪問你的網站前臺，就能在頁面底部看到自定義的問候語了。
為外掛新增管理選項
一個功能完善的外掛通常需要一個配置頁面，允許管理員在 WordPress 後臺進行設定。這涉及到建立管理選單和選項處理邏輯。
建立外掛設定頁面
WordPress 提供了函式來為外掛新增設定頁面。通常，我們會使用 add_options_page 或者 add_menu_page 等函式將這個頁面新增到後臺選單中。下面的示例演示如何新增一個簡單的設定子頁面到“設定”主選單下。
首先，建立一個函式來渲染設定頁面的 HTML 內容。
// 渲染插件设置页面的函数
function my_first_plugin_settings_page() {
?>
<div class="wrap">
<h1>站点问候语设置</h1>
<form method="post" action="/zh-tw/options.php/" data-trp-original-action="options.php">
<input type="hidden" name="trp-form-language" value="zh-tw"/></form>
</div>
<?php
}接下来，使用 add_action 鉤子在 admin_menu 階段註冊這個頁面。
// 将设置页面添加到后台菜单
function my_first_plugin_add_admin_menu() {
add_options_page(
'问候语设置', // 页面标题
'站点问候语', // 菜单标题
'manage_options', // 权限要求
'my-first-plugin', // 菜单别名
'my_first_plugin_settings_page' // 渲染函数
);
}
add_action( 'admin_menu', 'my_first_plugin_add_admin_menu' );註冊設定欄位與資料儲存
僅有頁面還不夠，我們需要定義具體的設定欄位（如輸入框、選擇框）並處理資料的儲存。這需要使用 WordPress 設定 API 中的 register_setting、add_settings_section 以及 add_settings_field 等函式。
推荐阅读 零到一：WordPress插件开发权威指南与实践教程。
以下程式碼註冊一個設定組和一個文字欄位，用於讓使用者自定義問候語內容。
// 初始化插件的设置
function my_first_plugin_settings_init() {
// 注册一个设置，将其保存到 `options` 表的 `my_first_plugin_greeting_text` 字段中
register_setting( 'my_first_plugin_settings_group', 'my_first_plugin_greeting_text' );
// 在页面中添加一个设置区域
add_settings_section(
'my_first_plugin_section',
'自定义问候语',
null,
'my-first-plugin'
);
// 在设置区域中添加一个文本字段
add_settings_field(
'my_first_plugin_field',
'问候语文本',
'my_first_plugin_field_render',
'my-first-plugin',
'my_first_plugin_section'
);
}
add_action( 'admin_init', 'my_first_plugin_settings_init' );
// 渲染文本输入框的函数
function my_first_plugin_field_render() {
$option = get_option( 'my_first_plugin_greeting_text', '你好，欢迎来到我的网站！' );
echo '<input type="text" name="my_first_plugin_greeting_text" value="' . esc_attr( $option ) . '" style="width: 300px;" />';
}最後，我們需要修改之前輸出問候語的函式，使其從資料庫中讀取使用者儲存的設定。
function my_first_plugin_display_greeting() {
$greeting_text = get_option( 'my_first_plugin_greeting_text', '你好，欢迎来到我的网站！' );
echo '<p style="position: fixed; bottom: 10px; left: 10px; background: #f1f1f1; padding: 10px; border-radius: 5px;">' . esc_html( $greeting_text ) . '</p>';
}外掛安全與最佳實務
在開發外掛時，安全性是首要考慮的因素。不安全的程式碼可能導致網站被攻擊。以下是一些核心的安全準則。
資料驗證與清理
任何時候，當你從使用者輸入（如 $_POST, $_GET）或資料庫獲取資料時，都必須假設它是不可信的。在輸出到瀏覽器或儲存到資料庫之前，必須進行驗證和清理。
對於輸出到 HTML 頁面的內容，使用 esc_html()、esc_attr() 或者 wp_kses_post() 等函式進行轉義，以防止跨站指令碼攻擊。
對於用於資料庫查詢的變數，應使用預編譯語句或像 $wpdb->prepare() 這樣的方法。
在我們的例子中，儲存設定時，WordPress 的 register_setting 函式會自動進行一些基礎的清理。在輸出時，我們使用了 esc_html() 來確保問候語文字中的 HTML 標籤被安全地轉義為普通文字。
使用非ce與許可權檢查
當處理來自管理頁面的表單提交時，必須驗證請求的合法性。這包括檢查使用者許可權和驗證隨機數。
在設定頁面的表單中，settings_fields() 函式已經自動包含了非ce驗證。但如果你建立了自定義的 AJAX 處理或非標準表單，必須手動驗證。通常使用 current_user_can() 檢查許可權，使用 check_admin_referer() 或者 wp_verify_nonce() 驗證隨機數。
例如，在自定義的提交處理函式中：
function my_plugin_handle_form_submit() {
// 检查权限
if ( ! current_user_can( 'manage_options' ) ) {
wp_die( '权限不足' );
}
// 验证随机数
if ( ! isset( $_POST['my_nonce_field'] ) || ! wp_verify_nonce( $_POST['my_nonce_field'], 'my_action' ) ) {
wp_die( '安全校验失败' );
}
// ... 处理安全的数据 ...
}总结
透過本指南，你完成了從一個簡單的 PHP 檔案到具有後臺管理功能的 WordPress 外掛的完整開發流程。你學會了外掛的基本結構、如何使用動作鉤子來注入功能、如何利用 WordPress 設定 API 建立可配置的選項頁面，以及至關重要的安全實踐。記住，優秀的外掛不僅功能強大，更需要程式碼清晰、安全可靠、遵循 WordPress 編碼標準。從這個小外掛出發，你可以繼續探索短程式碼、小工具、自定義文章型別等更高階的功能，逐步構建更復雜的擴充套件。
常见问题解答（FAQ）
如何為外掛新增多語言支援？
為外掛新增國際化（i18n）支援，主要涉及使用文字域和翻譯函式。首先，確保在外掛檔案頭中正確設定了 Text Domain 以及 Domain Path。在程式碼中，將所有需要翻譯的字串用 __() 或者 _e() 等函式包裹。然後，使用 Poedit 等工具建立 POT 模板檔案，並生成對應的 .mo 和 .po 翻譯檔案，將其放置在外掛指定的語言目錄下。
例如：echo esc_html( __( ‘Hello, World!’, ‘my-first-plugin’ ) );。當用戶切換到相應語言時，WordPress 會自動載入對應的翻譯檔案。
外掛中的函式名如何避免與其他外掛衝突？
避免函式名衝突的最佳實踐是使用名稱空間（PHP 5.3+）或為所有函式、類、常量新增唯一的字首。字首應足夠獨特，通常使用外掛名稱的縮寫或全稱。
例如，不要使用 display_greeting()，而應使用 my_first_plugin_display_greeting()。如果使用 PHP 名稱空間，你可以在檔案頂部宣告 namespace MyFirstPlugin;，然後在內部使用簡短的函式名，對外呼叫時則透過名稱空間解析。
開發完成後如何將外掛釋出到官方目錄？
要將外掛釋出到 WordPress.org 官方目錄，你需要先在 WordPress.org 上建立一個賬戶並提交外掛。過程包括：確保程式碼遵循 GPL 許可、透過 PHPCS 標準檢查、準備好 readme.txt 檔案（遵循特定格式）、提供清晰的截圖和文件。提交後，會有稽核員進行程式碼審查，通過後即可釋出。釋出後，使用者可以直接從 WordPress 後臺搜尋並安裝你的外掛。
外掛如何向後相容舊的 WordPress 版本？
為了保持向後相容性，在開發時應檢查當前 WordPress 版本，並使用條件語句來包裝依賴於新版本 API 的程式碼。同時，要避免使用已廢棄的函式，如果必須使用，應確保有備用的替代方案。在外掛的 readme.txt 檔案中，明確宣告外掛所需的最低 WordPress 版本，並對使用者給出清晰的提示。定期測試外掛在舊版本環境下的執行情況是維持相容性的關鍵。
下一步，该怎么做呢？
延伸阅读与实用知识
下方列出的内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，然后逐步扩展到相关主题，这样效果通常会更好。