WordPress 作為全球最流行嘅內容管理系統，佢強大嘅可擴展性主要歸功於插件。透過開發插件，你可以為網站添加任何自訂功能，而唔使修改核心代碼。呢個指南會帶你完成構建第一個功能插件嘅全過程，涵蓋由環境準備、代碼編寫到發佈測試嘅每一個關鍵步驟。
準備工作同環境搭建
喺編寫第一行代碼之前，你需要一個合適嘅開發環境。呢樣嘢唔單止可以提升效率，仲可以避免喺真實網站上調試可能帶來嘅風險。
建立本地開發環境
推薦使用本地伺服器軟件包，例如 XAMPP、MAMP 或者 Laragon。佢哋可以一鍵安裝 Apache、MySQL 同 PHP，完美模擬線上環境。確保你嘅 PHP 版本同目標 WordPress 版本兼容，通常 WordPress 官網會提供最新嘅版本要求。
推薦閱讀 WordPress插件開發完全指南：從零開始打造你嘅第一個功能插件。
安裝 WordPress 同代碼編輯器
喺本地伺服器安裝一個全新嘅 WordPress 網站，用嚟做插件開發同測試。同時，揀一個功能強大嘅代碼編輯器，好似 Visual Studio Code 或者 PhpStorm。呢啲編輯器對 PHP 語法高亮、代碼提示同除錯支援都好好，可以明顯提升寫代碼嘅體驗。
創建你嘅第一個插件檔案
一個最基本嘅 WordPress 插件可以只係由一個檔案構成。我哋會由一個簡單嘅「Hello World」插件開始，了解插件嘅結構。
插件主檔案嘅結構
首先，喺 WordPress 嘅 wp-content/plugins 喺目錄下邊，開一個新嘅資料夾，例如 my-first-plugin喺嗰個資料夾入面，建立主插件檔案，通常用插件名嚟命名，例如 my-first-plugin.php。
每個插件必須喺檔案開頭包含特定嘅插件資訊註釋，呢個係 WordPress 識別插件嘅關鍵。以下係一個最基礎嘅示例：
<?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
*/保存文件后，进入 WordPress 后台的“插件”页面，你就能看到这个插件并可以激活它。虽然它现在没有任何功能，但你已经成功创建了一个合规的插件框架。
推薦閱讀 一步步教你由零開始掌握 WordPress 插件開發。
为插件添加基本功能
激活插件后，让我们为其添加一个简单功能：在网站页脚添加一行自定义文本。我们将使用 WordPress 的 wp_footer 鉤子。
在插件信息注释下方，添加以下代码：
// 在网站页脚输出自定义文本
function myfp_add_footer_text() {
echo '<p style="text-align: center;">多謝你使用我嘅第一個插件！</p>';
}
add_action( 'wp_footer', 'myfp_add_footer_text' );保存文件并刷新网站前端，你会在页面底部看到这行居中的文本。这个例子演示了如何使用 add_action() 函数将你的自定义函数“挂载”到 WordPress 的核心执行点上。
实现一个实用的管理功能
一个完整的插件通常需要在 WordPress 管理后台提供配置界面。接下来，我们将为插件添加一个简单的设置页面，允许管理员自定义在页脚显示的文字。
建立管理選單頁面
我们需要在后台“设置”菜单下添加一个子菜单页。这需要用到 add_options_page() 函數。
首先，创建一个函数来渲染设置页面的 HTML 内容，并将其挂载到 admin_menu 掛咗鈎
推薦閱讀 從零開始：點解要揀WordPress插件開發。
// 添加插件设置页面到后台菜单
function myfp_add_admin_menu() {
add_options_page(
'我的插件设置', // 页面标题
'我的插件', // 菜单标题
'manage_options', // 权限（管理员）
'my-first-plugin', // 菜单slug
'myfp_settings_page' // 用于输出页面内容的回调函数
);
}
add_action( 'admin_menu', 'myfp_add_admin_menu' );
// 设置页面的HTML内容
function myfp_settings_page() {
?>
<div class="wrap">
<h1>我第一個插件設定</h1>
<form method="post" action="/yue/options.php/" data-trp-original-action="options.php">
<?php
settings_fields( 'myfp_settings_group' ); // 设置字段组
do_settings_sections( 'my-first-plugin' ); // 设置区域
submit_button(); // 提交按钮
?>
<input type="hidden" name="trp-form-language" value="yue"/></form>
</div>
<?php
}註冊設定、欄位同數據儲存
仅有页面还不够，我们需要使用 WordPress 设置 API 来安全地注册、验证和保存选项。这涉及三个核心函数：register_setting(), add_settings_section() 同埋 add_settings_field()。
// 初始化插件设置
function myfp_settings_init() {
// 注册一个新的设置项到数据库的 `wp_options` 表
register_setting( 'myfp_settings_group', 'myfp_footer_text' );
// 在设置页面添加一个区域
add_settings_section(
'myfp_section',
'页脚文字设置',
null, // 区域描述回调函数，这里不需要
'my-first-plugin'
);
// 在刚添加的区域里创建一个字段
add_settings_field(
'myfp_field_footer',
'显示的文本',
'myfp_field_footer_cb', // 用于输出字段HTML的回调函数
'my-first-plugin',
'myfp_section'
);
}
add_action( 'admin_init', 'myfp_settings_init' );
// 渲染文本输入字段的回调函数
function myfp_field_footer_cb() {
$text = get_option( 'myfp_footer_text', '感谢使用我的第一个插件！' ); // 获取已保存的值
echo '<input type="text" name="myfp_footer_text" value="' . esc_attr( $text ) . '" class="regular-text">';
echo '<p class="description">呢度輸入嘅文字會喺網站頁腳顯示。</p>';
}更新功能以使用保存的设置
最后，修改我们之前写的 myfp_add_footer_text 函数，使其从数据库读取管理员设置的值。
function myfp_add_footer_text() {
$footer_text = get_option( 'myfp_footer_text', '感谢使用我的第一个插件！' );
if ( ! empty( $footer_text ) ) {
echo '<p style="text-align: center;">' . esc_html( $footer_text ) . '</p>';
}
}
add_action( 'wp_footer', 'myfp_add_footer_text' );现在，进入 WordPress 后台的“设置”->“我的插件”，你可以修改页脚文本并保存。刷新网站前端，即可看到自定义内容生效。
插件安全、優化同發佈準備
一个合格的插件必须考虑安全性、性能和国际化的最佳实践。
實現數據驗證同轉義
永远不要信任用户输入或直接从数据库输出的数据。在上面的例子中，我们使用了 esc_attr() 在输入字段中转义属性，使用 esc_html() 在前端转义输出。对于更复杂的场景，应使用 sanitize_text_field() 嚟清理輸入，用 wp_kses_post() 来允许安全的 HTML 输出。
添加国际化支持
为了让插件能被全球用户使用，需要为所有面向用户的字符串做好翻译准备。这需要使用 __() 同埋 _e() 等函数，并声明文本域。
更新插件头部的注释，确保 Text Domain 与后续调用一致。然后修改代码中的字符串，例如：
// 在设置字段描述中使用国际化函数
echo '<p class="description">' . esc_html__( '这里输入的文字将显示在网站页脚。', 'my-first-plugin' ) . '</p>';
// 在输出函数中使用
$default_text = __( '感谢使用我的第一个插件！', 'my-first-plugin' );
$footer_text = get_option( 'myfp_footer_text', $default_text );之后，你可以使用 Poedit 等工具创建 .pot 模板檔案，供翻譯者創建 .po 同埋 .mo 翻譯檔案。
進行最終測試同打包
在发布前，需要在不同环境（如不同 PHP 版本、不同 WordPress 版本）下测试插件的功能。确保激活、停用、设置保存、数据删除等操作不会引发错误或留下冗余数据。你可以编写一个卸载清理函数，通过 register_uninstall_hook() 在用户删除插件时清理数据库选项。
最后，将你的插件文件夹压缩为 .zip 文件。这个压缩包可以直接通过 WordPress 后台的“上传插件”功能安装，也符合提交到 WordPress 官方插件目录的格式要求。
摘要
通过本指南，你完成了从零开始构建一个功能完整的 WordPress 插件的全过程。你学会了如何创建插件基础文件、使用动作钩子添加功能、利用 WordPress 设置 API 构建后台管理界面，并了解了安全、国际化和打包等关键知识。这个简单的页脚文本插件虽然基础，但它所蕴含的插件结构、钩子机制和设置 API 是开发任何复杂插件的基石。接下来，你可以尝试探索短代码（Shortcode）、自定义文章类型、REST API 端点等更高级的功能，逐步提升你的插件开发技能。
常見問題
开发 WordPress 插件必须掌握 PHP 吗？
是的，PHP 是 WordPress 及其插件开发的核心编程语言。你需要掌握 PHP 的基础语法、函数、数组和面向对象编程概念。同时，对 HTML、CSS 和基础的 JavaScript 也有助于开发包含用户界面的插件。
插件的主文件名可以任意取吗？
可以，但必须与插件文件夹内的主 PHP 文件名保持一致。通常，为了清晰起见，主文件会与插件文件夹同名或命名为 index.php。最重要的是，文件头部必须包含正确的插件信息注释块，WordPress 正是通过解析这个注释块来识别插件的。
为什么我的插件设置保存后不生效？
请按以下步骤排查：首先，确保你的设置字段已通过 register_setting() 正确注册，且 settings_fields() 函数调用中的设置组名称与之匹配。其次，检查表单的 action 属性是否指向 options.php。最后，在前端输出时，确认你使用的是 get_option() 函数，并且传入的选项名称与注册时完全一致。
如何让我的插件在停用时清理数据？
你可以用 register_uninstall_hook() 函数来注册一个卸载钩子。在这个钩子的回调函数中，你可以使用 delete_option() 函数来删除插件创建的所有数据库选项。请注意，此操作不可逆，仅应在用户明确选择“删除”插件时执行，而不是“停用”时。
可以将免费插件提交到 WordPress 官方目录吗？
是的，WordPress 官方鼓励开发者将符合标准的免费插件提交到其插件目录。这需要你拥有一个 WordPress.org 账号，并仔细阅读其插件提交指南。你的代码需要遵循一定的编码标准，并且不能包含恶意代码或违反许可证要求。成功提交后，用户将可以直接从 WordPress 后台搜索并安装你的插件。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。