WordPress插件開發入門指南：從零開始構建你嘅第一個自訂插件

WordPress插件開發環境準備

喺開始寫程式碼之前，你需要一個合適嘅本地開發環境。強烈建議唔好喺線上生產伺服器直接進行插件開發。一個典型嘅WordPress開發環境包括本地伺服器軟件（例如XAMPP、MAMP、Local by Flywheel或者Docker）、程式碼編輯器（例如VS Code、PHPStorm）同埋一個全新嘅WordPress安裝。

你需要確保你嘅PHP版本符合目標WordPress版本嘅要求，通常WordPress核心會同多個PHP版本保持兼容。對於插件開發，建議使用PHP 7.4或者更高版本，咁樣可以用到更新嘅語法同功能。同時，你需要喺WordPress後台開啟WP_DEBUG模式，咁可以幫你喺開發過程中快速搵到錯誤。喺你嘅wp-config.php檔案入面，搵到並設定以下常量：

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

咁樣設定會將錯誤訊息記錄到/wp-content/debug.log檔案入面，而唔會直接顯示喺頁面上影響前端用戶體驗，呢個係最佳實踐。

推薦閱讀 從零到一：WordPress插件開發權威指南與實踐教程。

創建你嘅第一個插件檔案

所有WordPress插件都存放喺/wp-content/plugins/目錄入面。每個插件通常都有一個獨立嘅資料夾，資料夾名稱應該簡潔而且能夠反映插件功能。而家，我哋嚟創建第一個插件。

UltaHost WordPress 主機

30日退款保證，無限頻寬同數據庫，免費DDoS防護，買3年優惠50%

瀏覽該頁面

編寫插件主檔案

喺你嘅插件資料夾入面，需要創建一個主PHP檔案。呢個檔案嘅命名通常同資料夾名稱一致，例如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同埋Domain Path用於國際化同本地化，為將來插件發佈做準備。

插件嘅基本安全同結構

安全係插件開發嘅第一要務。一個最基本嘅做法係防止直接存取你嘅插件檔案。我哋可以喺檔案頂部加一個直接存取檢查嚟實現。修改你嘅主檔案，喺插件頭註解之後加入以下代碼：

// 防止直接文件访问
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

呢段代碼檢查常數ABSPATH係咪有定義，如果冇（即係有人試圖直接透過URL訪問呢個PHP檔案），就終止腳本執行。呢個係所有優質WordPress插件都應該有嘅安全措施。

推薦閱讀 WordPress插件開發完整指南：從零基礎到發佈上線嘅實戰教程。

為插件添加核心功能

插件嘅作用在於擴展WordPress嘅功能。我哋透過兩個簡單例子嚟學點樣添加功能：創建一個管理頁面同喺前端添加內容。

添加一個簡單嘅管理菜單

首先，我哋學吓點樣喺後端管理員界面度添加一個屬於自己插件嘅菜單頁面。呢個需要用到WordPress嘅「掛鉤」（Hook）系統，特別係admin_menu動作鈎子。

我哋喺插件主檔案入面加一個函數，例如mfp_add_admin_menu，然後用add_action將個函數掛載到admin_menu掛咗鈎

hosting.com 共享主機

高效能,配備 AMD EPYC 處理器、NVMe SSD 儲存同 LiteSpeed,提供全天候專業內部支援,採用先進安全措施,包括 SSL、暴力破解、惡意軟件同 DDoS 防護,可節省高達 73%。

瀏覽該頁面

function mfp_add_admin_menu() {
    add_menu_page(
        '我的插件设置',          // 页面标题
        '我的插件',             // 菜单标题
        'manage_options',       // 权限要求
        'my-first-plugin',      // 菜单Slug
        'mfp_admin_page_html',  // 用于渲染页面内容的回调函数
        'dashicons-admin-generic', // 图标（使用Dashicons）
        30                      // 菜单位置
    );
}
add_action( 'admin_menu', 'mfp_add_admin_menu' );

跟住，我哋需要定義返上面用到嘅回呼函數mfp_admin_page_html嚟輸出頁面HTML內容。呢個係最簡單嘅示範：

function mfp_admin_page_html() {
    // 再次检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
        <p>你好，世界！呢個係我第一個插件管理頁面。</p>
    </div>
    &lt;?php
}

而家，重新整理你嘅WordPress後台，你應該會喺左邊導航欄見到一個新嘅「我嘅插件」選單項目。

喺前端頁面底部加返啲文字

除咗管理後端，我哋更常需要改前端。例如，我哋想喺所有文章同頁面嘅底部加返一段版權資訊。今次我哋用the_content過濾器掛鈎。

推薦閱讀 WordPress插件開發入門指南：從零開始構建你嘅第一個功能擴展。

過濾器掛鉤（Filter Hook）容許你修改傳畀函數嘅數據。我哋會創建一個函數mfp_add_footer_text，佢接收文章內容作為參數，並喺後面追加我哋自己嘅文字。

function mfp_add_footer_text( $content ) {
    // 仅对主循环中的单篇文章和页面生效
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $footer_text = '<p><em>本文由我第一個插件提供支援。</em></p>';
        $content .= $footer_text;
    }
    return $content;
}
add_filter( 'the_content', 'mfp_add_footer_text' );

呢段代碼首先檢查當前環境係咪單篇文章或頁面，並且處於主查詢循環中，以避免喺其他地方（例如小工具或摘要）重複添加文本。然後，佢會將包含版權信息嘅HTML段落附加到原文內容後面並返回。

InterServer 共享主機

共享主機:每月1TB,只需£2.50;首月只需£0.10,使用優惠碼 tryinterserver。461個雲端應用程式腳本,一鍵安裝。

瀏覽該頁面

插件開發嘅進階實踐

掌握基礎之後，了解一啲進階實踐可以令你嘅插件更加專業、更加穩健。

實現可配置嘅插件選項

一個成熟嘅插件通常需要允許用戶進行配置。WordPress提供咗設定API來簡化創建選項頁面嘅過程。呢個涉及註冊設定、添加設定欄位同設定分區。雖然比直接添加菜單頁面複雜，但佢能夠自動處理安全性（例如Nonce驗證）同表單數據保存。

通常，我哋會將插件選項以陣列嘅形式儲存到WordPress嘅wp_options表中。你可以用add_option()、get_option()同埋update_option()函數嚟操作你嘅插件數據。

用類嚟組織插件代碼

當插件功能增多嗰陣，將所有函數擺喺全局命名空間好容易造成函數名衝突。最佳實踐係用PHP類嚟封裝你嘅插件功能。咁樣唔單止可以更好噉組織代碼，仲可以利用面向對象嘅特性，例如自動加載、命名空間（如果你用PHP 5.3+）同埋更好嘅封裝性。

一個基於類別嘅插件主檔案可能係咁樣嘅樣：

if ( ! defined( 'ABSPATH' ) ) exit;

class My_First_Plugin {
    public function __construct() {
        // 在构造函数中挂载所有钩子
        add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
        add_filter( 'the_content', array( $this, 'add_footer_text' ) );
    }

public function add_admin_menu() { /* ... */ }
    public function add_footer_text( $content ) { /* ... */ }
}

// 初始化插件
new My_First_Plugin();

呢種方式將所有相關方法都聚集喺一個類別入面，大大提升咗程式碼嘅可維護性。

摘要

呢個指南帶你完成咗由零開始創建一個WordPress定制插件嘅完整流程。你學識咗點樣搭建環境、創建安全嘅插件檔案結構、使用動作掛鉤同過濾器掛鉤嚟分別擴展後端管理同前端顯示，並了解咗面向對象同設定API等進階開發實踐嘅思路。插件開發嘅核心在於理解WordPress嘅掛鉤系統，佢提供咗無數個切入點，令你可以喺唔修改核心程式碼嘅情況下改變平台嘅行為。持續實踐，由編寫細功能開始，逐步構建更複雜嘅插件，係掌握呢門技能嘅最佳路徑。

常見問題

### 開發插件需要咩樣嘅PHP基礎？
你需要掌握PHP嘅基礎語法，包括變量、數組、函數、條件判斷同循環。更重要嘅係理解點樣同WordPress嘅API互動，例如點樣用鈎子（add_action, add_filter）同常見嘅WordPress函數。面向對象編程（OOP）知識喺開發複雜插件嗰陣會好有幫助。

點樣調試自己開發嘅插件呢？

啟用WP_DEBUG模式係最關鍵嘅一步。睇吓wp-content/debug.log檔案入面嘅錯誤日誌。同時，你可以喺代碼入面用var_dump()或error_log()函數輸出調試信息。例如，error_log( print_r( $variable, true ) );可以將任何變數嘅內容記錄到debug.log入面。用好似Query Monitor呢啲專業調試插件都可以好大程度提升效率。

我喺插件度可以用第三方PHP庫嗎？

可以，但要小心處理。為咗避免同其他插件或者主題用嘅庫發生版本衝突，建議用PHP依賴管理工具Composer，同埋利用佢嘅自動加載功能。打包發佈插件嗰陣，你可以選擇將庫文件綁定喺你嘅插件入面（注意要跟返庫嘅許可證），或者要求用戶喺伺服器度自己安裝呢個依賴。

開發完成後點樣將插件發佈到WordPress官方目錄？

你需要去WordPress.org網站，提交你嘅插件進行審核。你嘅插件代碼必須符合官方嘅編碼標準同指引，例如確保安全性、進行國際化（用__()同埋_e()函數）、同埋包含一個詳細嘅readme.txt文件。審核通過之後，你嘅插件就可以俾全世界嘅用戶搜尋同安裝喇。