準備工作：理解WordPress插件基礎
在開始編寫代碼之前，建立一個堅實的理論基礎至關重要。一個WordPress插件本質上是一個或多個PHP文件的集合，它通過WordPress提供的Hook（钩子）系統來擴展或修改WordPress核心功能。插件可以小到只添加一個短代碼，大到創建一個完整的管理後台應用。所有插件都存放在/wp-content/plugins/目錄下，每個插件擁有自己獨立的文件夾。
開發環境是您的工作台。您需要一個本地服務器環境，例如XAMPP、MAMP或Local by Flywheel，並安裝好WordPress。強烈建議在wp-config.php文件已打开WP_DEBUG模式，這將幫助您在開發過程中快速定位錯誤。此外，一個得心應手的代碼編輯器（如VS Code、PhpStorm）和一個現代瀏覽器（附帶開發者工具）也是必不可少的。
創建第一個插件：基礎結構與激活
讓我們從創建一個最簡單的插件開始，它的功能是在網站所有頁面的底部添加一行版權信息。這個過程將引導您瞭解插件的基本構成要素。
推荐阅读 入门级WordPress插件开发指南：从零开始构建你的第一个功能扩展。
首先，在……方面，我们应该采取以下措施：首先，……；其次，……；最后，……。/wp-content/plugins/目錄下創建一個新的文件夾，命名為my-first-plugin。在該文件夾內，創建主插件文件，通常與文件夾同名：my-first-plugin.php。每個插件都必須有一個標準的插件頭部註釋，這是WordPress識別插件信息的唯一方式。
<?php
/**
* Plugin Name: 我的第一个插件
* Plugin URI: https://example.com/my-first-plugin
* Description: 这是一个用于学习WordPress插件开发的入门插件，将在页面底部添加版权信息。
* Version: 1.0.0
* Author: 你的名字
* License: GPL v2 or later
* Text Domain: my-first-plugin
*/保存文件後，登錄您的WordPress管理後台，進入“插件”頁面，您將看到名為“我的第一個插件”的插件出現在列表中。點擊“啓用”，您的插件就正式激活了，雖然它目前還不會做任何事情。
實現核心功能：使用鈎子添加內容
WordPress的強大之處在於其Hook（钩子）系統，分為Action（动作）以及Filter（过滤器）兩種。動作鈎子允許您在特定的時間點（如頁面加載完畢、文章發佈時）插入您自己的代碼來執行功能。過濾器鈎子則允許您修改在流程中傳遞的數據（如文章內容、標題）。
為了在頁腳添加文本，我們需要使用wp_footer這個動作鈎子。我們在主插件文件中添加以下代碼：
// 这是一个安全措施，防止直接访问PHP文件
if ( ! defined( 'ABSPATH' ) ) {
exit; // 如果ABSPATH未定义，则退出
}
/**
* 在网站页脚输出自定义HTML内容
*/
function myfp_add_footer_text() {
echo '<div style="text-align: center; padding: 20px; border-top: 1px solid #eee; margin-top: 40px;">';
echo '<p>© ' . date('Y') . ' 我的网站。保留所有权利。本内容由<strong>我的第一个插件</strong>生成。</p>';
echo '</div>';
}
// 将我们的函数挂载到 `wp_footer` 动作钩子上
add_action( 'wp_footer', 'myfp_add_footer_text' );在這段代碼中，我們首先定義了函數myfp_add_footer_text()，其功能是輸出一段HTML代碼。然後，我們使用add_action()函數將這個自定義函數“掛載”到wp_footer這個鈎子上。這意味着每當WordPress執行到wp_footer位置時（通常位於主題的footer.php文件中），就會自動調用我們的函數，從而在頁面底部顯示我們定義的版權信息。
推荐阅读 從零開始：WordPress 插件開發完整指南與最佳實踐分享。
進階功能：創建管理頁面與短代碼
一個功能完善的插件通常需要與管理員交互。接下來，我們為插件添加一個簡單的配置頁面，並創建一個短代碼。
在管理菜單中添加設置頁面
我們將使用add_menu_page()函數在WordPress後台左側菜單中添加一個新項目。修改主插件文件，添加以下代碼：
/**
* 注册插件管理菜单
*/
function myfp_add_admin_menu() {
add_menu_page(
'我的第一个插件设置', // 页面标题
'我的插件', // 菜单标题
'manage_options', // 所需权限
'myfp-settings', // 菜单slug
'myfp_settings_page', // 显示页面内容的回调函数
'dashicons-admin-plugins', // 图标（使用Dashicon）
30 // 菜单位置
);
}
add_action( 'admin_menu', 'myfp_add_admin_menu' );
/**
* 设置页面的HTML内容
*/
function myfp_settings_page() {
// 检查用户权限
if ( !current_user_can( 'manage_options' ) ) {
return;
}
?>
<div class="wrap">
<h1></h1>
<p>欢迎来到“我的第一个插件”的设置页面。这是一个简单的管理界面示例。</p>
<form action="/zh-hk/options.php/" method="post" data-trp-original-action="options.php">
<?php
// 未来可以在这里添加设置字段
?>
<p>更多高级功能（如保存设置）将在后续教程中介绍。</p>
<input type="hidden" name="trp-form-language" value="zh-hk"/></form>
</div>
<?php
}保存後刷新後台，您將在左側看到一個新的“我的插件”菜單項，點擊即可進入我們剛剛創建的空設置頁面。
創建並註冊一個短代碼
短代碼允許用户通過簡單的[shortcode]標籤在文章或頁面中插入動態內容。我們來創建一個顯示當前服務器時間的短代碼。
/**
* 短代码处理函数
* @param array $atts 短代码属性
* @param string $content 短代码包裹的内容
* @return string 返回要替换的HTML
*/
function myfp_current_time_shortcode( $atts = [], $content = null ) {
// 设置默认属性并合并用户传入的属性
$atts = shortcode_atts(
array(
'format' => 'Y-m-d H:i:s',
),
$atts,
'current_time'
);
// 根据format属性格式化当前时间
$current_time = date( $atts['format'] );
// 返回输出内容
return '<div class="myfp-time"><strong>当前时间：</strong> ' . esc_html( $current_time ) . '</div>';
}
// 注册短代码 [current_time]
add_shortcode( 'current_time', 'myfp_current_time_shortcode' );現在，您可以在任何文章、頁面或小工具文本框中輸入[current_time]來顯示默認格式的時間，或者使用[current_time format="F j, Y"]來顯示自定義格式的時間。WordPress會自動調用我們的myfp_current_time_shortcode()函數來處理並替換這個短代碼。
总结
通過本指南，您已經完成了從零開始構建一個功能完整的WordPress插件的關鍵步驟。您瞭解了插件的基本結構、頭部註釋的重要性，並實踐了WordPress開發的核心——鈎子系統。您成功地使用add_action()向網站前台添加了內容，使用add_menu_page()創建了管理後台界面，並使用add_shortcode()註冊了可供內容編輯器使用的短代碼。
推荐阅读 WordPress插件开发入门指南。
這僅僅是插件開發世界的起點。從這裏出發，您可以探索更復雜的領域，例如：創建數據庫表來存儲數據、使用add_settings_section()以及add_settings_field()構建真正的選項頁面、處理表單提交、添加AJAX交互、構建自定義文章類型和分類法，以及遵循WordPress編碼標準和安全最佳實踐來發布您的插件。繼續實踐和探索，您將能夠開發出強大而專業的WordPress插件。
常见问题解答（FAQ）
一個插件必須包含多少個文件？
一個插件可以只包含一個主PHP文件。對於簡單插件，這完全足夠。當插件功能變得複雜時，為了代碼清晰和可維護性，建議將不同的功能模塊拆分到不同的文件中（如CSS、JavaScript、類定義文件等），並通過主文件進行組織加載。
為什麼我的插件在後台列表中沒有出現？
這通常是由於插件頭部註釋格式不正確或文件路徑錯誤導致的。請確保您的插件主PHP文件直接位於/wp-content/plugins/your-plugin-folder/目錄下，並且文件頂部的註釋塊格式完全正確，特別是Plugin Name:這一行必不可少。檢查無誤後，刷新插件頁面即可。
動作鈎子和過濾器鈎子有什麼區別？
動作鈎子用於在特定時刻“執行某段代碼”，它不要求返回值，主要用於觸發附加功能，如添加HTML、發送郵件。過濾器鈎子用於“修改某個數據”，它必須返回一個值（通常是修改後的輸入值），主要用於在內容輸出前進行干預，如修改文章標題、為內容添加鏈接。
如何安全地移除已添加的鈎子？
您可以使用remove_action()或者remove_filter()函數來移除之前添加的鈎子。但必須確保移除操作發生在原添加操作之後，並且優先級參數需與原add_action()或者add_filter()中的優先級一致。通常建議在插件停用鈎子或特定條件下執行移除操作。
接下来，我该怎么做呢？
延伸阅读与实用知识
下方这些内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始看起，然后再逐步扩展到相关主题，这样通常效果会更好。