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

WordPress外掛開發入門指南：從零開始打造你的第一個外掛

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

為什麼選擇開發WordPress外掛

WordPress作為全球最流行的內容管理系統，其強大的可擴充套件性主要歸功於外掛。透過開發外掛，你可以為網站新增任何自定義功能，而無需修改核心檔案，這保證了WordPress升級時的相容性。無論是為了滿足特定專案需求、解決一個常見問題，還是希望將你的解決方案分享給社群並創造收入，外掛開發都是一項極具價值的技能。

學習外掛開發不僅能讓你深度理解WordPress的執行機制，如鉤子（Hooks）系統和短程式碼（Shortcode）等，還能提升你的PHP程式設計能力。從簡單的功能增強到複雜的應用整合，一切皆有可能。

搭建你的外掛開發環境

在開始編寫程式碼之前，一個合適的本地開發環境至關重要。這能讓你安全地進行測試和除錯，而不會影響線上網站。

推荐阅读 WordPress外掛開發終極指南：從零到一構建專業外掛。

配置本地伺服器環境

推薦使用整合的本地開發工具，如Local by Flywheel、DevKinsta或XAMPP。這些工具一鍵安裝，包含了Apache/Nginx、PHP和MySQL。請確保你的PHP版本與目標伺服器相容，通常建議使用PHP 7.4或更高版本以獲得更好的效能和安全性。

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

安裝並設定WordPress

在本地伺服器中安裝一個全新的WordPress例項。建議使用預設主題（如Twenty Twenty系列）進行開發測試，以排除主題相容性問題。在wp-config.php檔案中，開啟WP_DEBUG常量，這將幫助你在開發過程中快速發現錯誤。

define( 'WP_DEBUG', true );

準備程式碼編輯器

選擇一個強大的程式碼編輯器，如Visual Studio Code、PhpStorm或Sublime Text。安裝相關的擴充套件，例如PHP智慧感知、WordPress程式碼片段等，它們能極大提高你的編碼效率。

建立你的第一個外掛檔案

一個WordPress外掛本質上是一個或多個位於/wp-content/plugins/目錄下的PHP檔案。現在，讓我們從最基礎的結構開始。

編寫外掛頭部註釋

每個外掛都必須包含一個標準格式的頭部註釋，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:            你的名字
 * Author URI:        https://example.com
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

這段註釋定義了外掛在WordPress後臺管理介面中顯示的名稱、描述等資訊。其中，Text Domain用於國際化翻譯。

構建外掛的基本安全框架

為了防止直接訪問你的外掛檔案，可以在檔案頂部新增一個安全防護程式碼。這是WordPress外掛開發的最佳實踐。

// 防止直接访问
if ( ! defined( 'ABSPATH' ) ) {
	exit; // 如果未定义ABSPATH（WordPress根目录的绝对路径），则退出
}

ABSPATH是WordPress定義的一個常量，代表其安裝的絕對路徑。透過檢查此常量是否存在，可以有效阻止外部使用者直接透過URL訪問你的外掛檔案。

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

實現核心功能：新增管理選單和設定

一個完整的外掛通常需要在 WordPress 後臺提供配置介面。我們將透過 WordPress 提供的 API 來新增一個簡單的管理選單頁面。

使用函式新增頂級管理選單

我們將使用add_action()函式掛載到admin_menu鉤子上，從而在後臺新增一個選單項。在你的主外掛檔案中繼續新增以下程式碼。

// 添加管理菜单
function mfp_add_admin_menu() {
    add_menu_page(
        '我的第一个插件设置', // 页面标题
        '我的插件',           // 菜单标题
        'manage_options',    // 所需权限（管理员）
        'my-first-plugin',   // 菜单slug
        'mfp_settings_page', // 显示页面内容的回调函数
        'dashicons-admin-generic', // 图标（使用Dashicons）
        80                    // 菜单位置
    );
}
add_action( 'admin_menu', 'mfp_add_admin_menu' );

ここでは、add_menu_page()函式用於建立一個頂級選單。引數定義了頁面標題、選單標題、訪問許可權、唯一識別符號（slug）、用於輸出頁面內容的回撥函式、圖示以及選單在側邊欄的位置。

推荐阅读 WordPress外掛開發完整指南：從零基礎到實戰上架。

建立設定頁面的回撥函式

現在，我們需要定義上面提到的mfp_settings_page()函式，它將輸出管理頁面的HTML內容。

// 设置页面回调函数
function mfp_settings_page() {
    // 检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1></h1>
        <p>欢迎来到我的第一个插件的设置页面！这里是未来添加表单和选项的地方。</p>
        <form action="/zh-tw/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            // 输出设置字段、非ce等（后续扩展）
            settings_fields( 'mfp_options_group' );
            do_settings_sections( 'my-first-plugin' );
            submit_button( '保存设置' );
            ?>
        <input type="hidden" name="trp-form-language" value="zh-tw"/></form>
    </div>
    &lt;?php
}

這個函式首先檢查當前使用者是否有manage_options許可權（通常是管理員），然後輸出一個簡單的設定頁面框架。其中settings_fields()以及do_settings_sections()是為後續使用 WordPress 設定 API 註冊選項預留的。

InterServer 共享主机
虚拟主机的月费为1TB+5TB，价格为2.50美元。首月优惠价为1TB+5TB，价格为0.1美元。优惠码为"tryinterserver"。平台提供461个云应用脚本，一键安装便捷。
InterServer 标志 访问页面

為外掛新增一個簡單的前端功能

除了後臺管理介面，外掛更常見的是為網站前端提供功能。我們將建立一個簡單的短程式碼（Shortcode），讓使用者可以在文章或頁面中呼叫。

使用函式註冊短程式碼

短程式碼允許使用者透過[shortcode]這樣的簡單標籤在內容中插入動態功能。使用add_shortcode()进行函数注册。

// 注册一个短代码
function mfp_hello_world_shortcode( $atts ) {
    // 短码属性，设置默认值
    $atts = shortcode_atts(
        array(
            'name' => '访客',
        ),
        $atts,
        'mfp_hello'
    );

// 安全地输出内容
    return '<p>你好，' . esc_html( $atts['name'] ) . '！这是我的插件生成的问候。</p>';
}
add_shortcode( 'mfp_hello', 'mfp_hello_world_shortcode' );

add_shortcode()函式接受兩個引數：短程式碼標籤名（使用者使用時的名稱）和對應的處理函式。shortcode_atts()函式用於合併使用者輸入的屬性與預設值，確保程式碼健壯性。

在前端測試短程式碼

儲存外掛檔案後，前往 WordPress 後臺的“外掛”頁面，啟用“我的第一個外掛”。然後，建立或編輯一篇文章，在內容編輯器中直接輸入[mfp_hello name="小明"]。釋出文章後，前端頁面將顯示“你好，小明！這是我的外掛生成的問候。”。如果不提供name屬性，如[mfp_hello]，則會顯示預設的“你好，訪客！”。

总结

透過本指南，你完成了從零開始建立一個基礎 WordPress 外掛的完整流程。你學習了外掛的基本結構、頭部註釋的重要性、如何新增後臺管理選單以及如何建立一個簡單但實用的前端短程式碼。這些是 WordPress 外掛開發的基石。

真正的外掛開發之旅才剛剛開始。接下來，你可以探索 WordPress 強大的設定 API 來建立可儲存的選項，利用動作鉤子add_action()和過濾器鉤子add_filter()來修改核心行為，學習如何為外掛新增國際化支援，以及如何安全地處理使用者資料。記住，遵循 WordPress 編碼標準和注重安全性是開發高質量外掛的關鍵。

常见问题解答（FAQ）

開發WordPress外掛需要哪些先決知識？

你需要具備基礎的PHP程式設計知識，瞭解HTML和CSS，並且對WordPress的基本操作（如釋出文章、安裝主題外掛）有了解。熟悉面向物件程式設計（OOP）不是必須的，但對於開發複雜外掛非常有幫助。

外掛的主檔名必須和資料夾名一樣嗎？

不必須，但這是強烈推薦的最佳實踐，能使結構更清晰。主外掛的PHP檔案可以是任何名字，但它的頭部註釋必須正確，且該檔案必須位於外掛自身的資料夾內。資料夾名通常就是外掛的slug。

如何除錯我的外掛程式碼？

除了開啟WP_DEBUG，你還可以使用error_log()函式將除錯資訊寫入伺服器的錯誤日誌，或者使用var_dump()以及wp_die()進行輸出檢查（僅用於開發環境）。使用Query Monitor等除錯外掛也是高效的選擇。

我開發的外掛如何釋出到WordPress官方外掛目錄？

首先，你需要確保外掛程式碼符合WordPress的釋出要求，包括GPL相容許可、程式碼質量、安全性和國際化等。然後，在WordPress.org上申請一個SVN倉庫，將你的程式碼提交上去，並透過稽核流程。官方提供了詳細的外掛提交手冊。

下一步，该怎么做呢？

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

延伸阅读与实用知识

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

标签：