WordPress 插件开发入门：从零开始创建你的第一个插件

6 月 2, 2026

—

由

ccaion

于开发

前言

WordPress 插件是扩展其功能的最佳方式。本文将手把手带你创建一个最基本的插件，涵盖目录结构、主文件注册和常用钩子（Hooks）的使用。

1. 创建插件目录和主文件

在 wp-content/plugins/ 下新建目录：

wp-content/plugins/my-first-plugin/my-first-plugin.php

2. 插件头部注释

每个插件主文件开头都需要标准头部：

<?php
/**
 * Plugin Name: My First Plugin
 * Plugin URI:  https://example.com/my-first-plugin
 * Description: 这是我的第一个 WordPress 插件
 * Version:     1.0.0
 * Author:      WP Dev
 * License:     GPLv2
 */

3. 添加动作钩子（Action Hook）

WordPress 的核心机制就是钩子（Hooks），分为动作钩子（Action）和过滤钩子（Filter）：

// 动作钩子：在页面底部输出内容
function mfp_hello_world() {
    echo '<h2>Hello from My First Plugin!</h2>';
}
add_action('wp_footer', 'mfp_hello_world');

// 过滤钩子：修改文章内容
function mfp_modify_content($content) {
    return $content . '<p>👋 文章已被 My First Plugin 修改</p>';
}
add_filter('the_content', 'mfp_modify_content');

4. 注册自定义设置

插件通常需要管理后台界面，使用 Settings API：

// 添加设置页面
function mfp_add_admin_menu() {
    add_options_page(
        'My First Plugin 设置',
        'My First Plugin',
        'manage_options',
        'mfp-settings',
        'mfp_settings_page'
    );
}
add_action('admin_menu', 'mfp_add_admin_menu');

5. 启用插件

登录 WordPress 后台 → 插件 → 已安装的插件
找到「My First Plugin」点击启用
访问任意文章页面，底部应显示 “Hello from My First Plugin!”

总结

插件开发的核心是理解 WordPress 的钩子机制。掌握 add_action 和 add_filter，你就能与 WordPress 核心交互，构建任意复杂度的功能扩展。

提示：开发插件时请开启 WP_DEBUG 模式（wp-config.php 中设为 true），方便发现 PHP 错误和警告。