主页/知识/WordPress/内容详情

手把手教你从零开始掌握 WordPress 插件开发

3 分钟阅读时间
2026-03-16
2026-06-03
2,454
通过下方链接进行购物时，您无需支付额外费用，我就能获得佣金。.

WordPress外掛開發環境準備

在開始編寫程式碼之前，一個穩定、隔離的開發環境至關重要。這不僅能保護你的生產站點，還能讓你自由地測試和除錯。最推薦的方式是使用本地開發環境，例如 Local by Flywheel、XAMPP 或 MAMP。這些工具可以一鍵在本地計算機上安裝 WordPress 所需的 PHP、MySQL 和 Web 伺服器。

接下來，你需要在本地 WordPress 安裝中啟用除錯模式。這有助於在開發過程中快速發現錯誤。開啟 WordPress 根目錄下的 wp-config.php 檔案，找到或新增以下常量定義：

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

這樣設定後，所有錯誤和警告資訊將被記錄到 /wp-content/debug.log 檔案中，而不會直接顯示在頁面上影響前端使用者。

推荐阅读 WordPress 插件开发入门指南：从零开始创建你的第一个自定义插件。

最後，你需要一個程式碼編輯器。Visual Studio Code、PhpStorm 或 Sublime Text 都是優秀的選擇，它們對 PHP 和 WordPress 開發有良好的語法高亮和程式碼提示支援。確保你的編輯器能方便地訪問本地伺服器上的專案檔案。

UltaHost WordPress 主機
30天退款保證，無限頻寬與資料庫，免費的 DDoS 防護，購買3年優惠50%
UltaHost LOGO 访问页面

创建你的第一个外挂插件

一個 WordPress 外掛本質上是一個或多個位於 wp-content/plugins 目錄下的 PHP 檔案。每個外掛都必須有一個主檔案，並且該檔案頭部需要包含標準的外掛資訊註釋，以便 WordPress 能夠識別它。

編寫外掛頭部資訊

请将下文翻译成中文，并详细说明翻译思路：\n在你的 wp-content/plugins 目錄下，建立一個新的資料夾，例如 my-first-plugin。在該資料夾內，建立主檔案 my-first-plugin.php。檔案的開頭必須包含以下格式的註釋：

<?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
 */

這段註釋中的“Plugin Name”是必填項，其他均為可選。WordPress 會讀取這些資訊並在後臺的“外掛”管理頁面中顯示。

實現一個簡單的功能

現在，讓我們為這個外掛新增第一個實際功能：在文章內容的末尾自動新增一段自定義文字。我們將使用 the_content 這個過濾器鉤子（Filter Hook）。

推荐阅读 WordPress 插件开发入门到精通：实战经验与核心技巧分享。

在頭部註釋下方，新增以下程式碼：

function myfp_add_text_to_content( $content ) {
    if ( is_single() &amp;&amp; in_the_loop() &amp;&amp; is_main_query() ) {
        $custom_text = '<p><em>感谢阅读本文，由“我的第一个插件”为您呈现。</em></p>'以下是您提供的代码示例的翻译：

```php
function myfp_add_text_to_content($content) {  
    if (isset($content) &amp;&amp; !empty($content)) {  
        $custom_text = get_the_custom_text();  
        if (isset($custom_text) &amp;&amp; !empty($custom_text)) {  
            $content .= '\n';  
            $content .= $custom_text;  
        }  
    }  
    return $content;  
}
add_filter( 'the_content', 'myfp_add_text_to_content' );  
```;

儲存檔案後，進入 WordPress 後臺的“外掛”頁面，你應該能看到“我的第一個外掛”。啟用它，然後去檢視網站的一篇文章，你會發現文章末尾已經添加了我們定義的文字。這段程式碼中，myfp_add_text_to_content 是我們定義的函式，add_filter() 將其掛載到 the_content 鉤子上。函式內的條件判斷確保了這段文字只會在前臺單獨的文章頁面主迴圈中顯示。

理解WordPress外掛核心機制

WordPress 外掛強大而靈活的基石是其鉤子（Hooks）機制。鉤子允許你在 WordPress 核心程式碼執行的特定點插入自己的程式碼，從而改變或增強其預設行為。鉤子主要分為兩種：動作鉤子（Action Hooks）和過濾器鉤子（Filter Hooks）。

hostng.com 共享主机
高效能，配备 AMD EPYC CPU、NVMe SSD 存储和 LiteSpeed，全天候 24 小时专业内部支持，先进的安全措施包括 SSL、暴力破解、恶意软件和 DDoS 防护，节省高达 731 TB/月的带宽成本。
hosting.com标志 访问页面

动作钩子和过滤器钩子

動作鉤子（Action）允許你在某個特定事件發生時執行自定義程式碼，例如釋出文章後、載入管理頁面時等。它不要求返回值。使用 add_action() 函式來掛載。例如，在外掛啟用時執行一個操作：

function myfp_plugin_activation_task() {
    // 创建数据库表、初始化选项等
    update_option( 'myfp_plugin_installed', '2026-01-01' );
}
register_activation_hook( __FILE__, 'myfp_plugin_activation_task' );

這裡使用了 register_activation_hook，它是一個特殊的動作鉤子，專門用於外掛啟用。

過濾器鉤子（Filter）則允許你修改傳遞給它的資料。它要求函式接收一個值，並必須返回一個修改後的值。我們之前修改文章內容的例子就是一個典型的過濾器。另一個例子是修改文章的摘錄長度：

推荐阅读 掌握WordPress外掛開發：從零到一的完整實踐指南。

function myfp_custom_excerpt_length( $length ) {
    return 20; // 将摘录长度改为20个单词
}
add_filter( 'excerpt_length', 'myfp_custom_excerpt_length' );

使用短程式碼新增動態內容

除了鉤子，短程式碼（Shortcode）是外掛與內容互動的另一個強大工具。它允許使用者透過在文章或頁面中插入一個簡單的標籤（如 [my_shortcode]）來呼叫外掛生成的複雜內容。

建立一個短程式碼非常簡單，使用 add_shortcode() 函式。例如，建立一個顯示當前時間的短程式碼：

InterServer 共享主机
虚拟主机的月费为1TB+5TB，价格为2.50美元。首月优惠价为1TB+5TB，价格为0.1美元。优惠码为"tryinterserver"。平台提供461个云应用脚本，一键安装便捷。
InterServer 标志 访问页面 
function myfp_current_time_shortcode( $atts ) {
    $atts = shortcode_atts( array(
        'format' => 'Y-m-d H:i:s',
    ), $atts, 'current_time' );

return date( $atts['format'] );
}
add_shortcode( 'current_time', 'myfp_current_time_shortcode' );

用户可以在编辑器中进行输入操作。 [current_time format="H:i"] 來只顯示小時和分鐘。

為外掛新增管理頁面

許多外掛需要提供配置選項，這通常透過 WordPress 後臺的管理選單頁面來實現。WordPress 提供了一系列函式來新增頂級選單或子選單項。

建立外掛設定頁面

我們將為外掛新增一個簡單的設定頁面，用於管理之前新增到文章末尾的文字內容。首先，使用 add_menu_page() 或者 add_options_page() 函式來註冊頁面。通常，簡單的外掛會將頁面新增到“設定”子選單下。

在外掛主檔案中新增以下程式碼：

function myfp_add_admin_menu() {
    add_options_page(
        '我的第一个插件设置', // 页面标题
        '我的插件设置',       // 菜单标题
        'manage_options',     // 所需权限
        'myfp-settings',      // 菜单slug
        'myfp_settings_page_html' // 用于输出页面内容的回调函数
    );
}
add_action( 'admin_menu', 'myfp_add_admin_menu' );

這段程式碼告訴 WordPress，當構建後臺管理選單時（admin_menu 動作），執行 myfp_add_admin_menu 函式來新增一個頁面。

構建設定頁面表單

接下來，我們需要定義 myfp_settings_page_html 函式來生成頁面的 HTML 內容，並處理表單的儲存。為了安全地儲存設定，我們使用 WordPress 的 options API。

function myfp_settings_page_html() {
    // 检查用户权限
    if ( !current_user_can( 'manage_options' ) ) {
        return;
    }

// 处理表单提交
    if ( isset( $_POST['myfp_footer_text'] ) ) {
        update_option( 'myfp_footer_text', sanitize_textarea_field( $_POST['myfp_footer_text'] ) );
        echo '<div class="notice notice-success"><p>设置已保存！</p></div>';
    }

// 获取现有值
    $current_text = get_option( 'myfp_footer_text', '感谢阅读本文，由“我的第一个插件”为您呈现。' );
    ?>
    <div class="wrap">
        <h1>我的第一个插件设置</h1>
        <form method="post" action="">
            <?php wp_nonce_field( 'myfp_settings_action', 'myfp_settings_nonce' ); ?>
            <table class="form-table">
                <tr>
                    <th scope="row"><label for="footer_text">文章页脚文本</label></th>
                    <td>
                        <textarea name="myfp_footer_text" id="footer_text" rows="4" cols="50" class="large-text"><?php echo esc_textarea( $current_text ); ?></textarea>
                        <p class="description">这段文本将显示在每篇文章的末尾。</p>
                    </td>
                </tr>
            </table>
            
        <input type="hidden" name="trp-form-language" value="zh-tw"/></form>
    </div>
    &lt;?php
}

最後，記得修改之前過濾文章內容的函式，使其從選項 myfp_footer_text 中讀取文字，而不是使用硬編碼的字串。這樣，一個具備基本管理功能的後臺設定頁面就完成了。

总结

透過本文的步驟，你已經從零開始完成了一個功能完整的 WordPress 外掛。你學會了如何搭建開發環境、建立外掛基礎結構、利用 WordPress 核心的鉤子機制（動作與過濾器）來擴充套件功能、實現短程式碼以及構建後臺管理介面。外掛開發的核心在於理解鉤子與事件驅動，這讓你能夠在不修改核心程式碼的前提下，深度定製 WordPress 的行為。記住，良好的程式碼結構、安全的輸入輸出處理以及對國際化的支援是開發高質量外掛的基礎。接下來，你可以嘗試為外掛新增更多功能，例如自定義文章型別、小工具或 REST API 端點，不斷探索 WordPress 生態的無限可能。

常见问题解答（FAQ）

一個外掛必須只有一個PHP檔案嗎？

不一定。一個外掛可以由單個 PHP 檔案構成，對於複雜外掛，更推薦模組化的結構。你可以將不同的功能拆分到不同的類或檔案中，主檔案只負責引入這些檔案並初始化外掛。這有助於程式碼的維護和組織。例如，可以建立 includes/ 目錄存放功能類，admin/ 目錄存放後臺相關程式碼，public/ 目錄存放前端邏輯。

如何安全地處理外掛中的使用者輸入？

處理使用者輸入（如表單資料、URL 引數）時，必須進行驗證（Validation）、清理（Sanitization）和轉義（Escaping）。對於儲存到資料庫的資料，使用 sanitize_text_field()、sanitize_textarea_field()、intval() 等函式進行清理。在將資料輸出到 HTML 頁面時，使用 esc_html()、esc_attr()、esc_url() 或者 wp_kses() 進行轉義，以防止跨站指令碼（XSS）攻擊。

外掛開發中如何除錯程式碼？

除了啟用 WP_DEBUG 外，你還可以使用 error_log() 函式將自定義資訊記錄到除錯日誌。對於檢查變數值，var_dump() 或者 print_r() 結合 die() 是快速但粗糙的方法。更推薦使用 WordPress 自帶的 wp_die() 以及 wp_send_json()（用於 AJAX 除錯）。此外，使用 Query Monitor 等專業除錯外掛可以更直觀地檢視資料庫查詢、鉤子、指令碼等執行時資訊。

如何讓我的外掛支援多語言？

讓外掛支援國際化（i18n）需要使用 WordPress 的翻譯函式。首先，在外掛頭部註釋中正確設定 Text Domain（如 ‘my-first-plugin’）。在程式碼中，對所有面向用戶的字串使用 () 或者 _e() 函式進行包裹，例如 ( ‘Hello World’, ‘my-first-plugin’ )。然後，使用 Poedit 等工具生成 .pot 模板檔案，翻譯人員可以據此建立不同語言的 .po 以及 .mo 檔案，並存放在外掛的 languages/ 資料夾中。

下一步，该怎么做呢？

如果你正在搭建或优化WordPress网站，建议你继续阅读关于性能优化、插件配置和主题定制的相关内容。

延伸阅读与实用知识

下方列出的内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，然后逐步扩展到相关主题，这样效果通常会更好。

标签：