WordPress自己写插件，从入门到精通

Name: WordPress自己写插件，从入门到精通
Brand: suya
Availability: InStock

来自：素雅营销研究院

方知笔记

2025年04月23日 00:39

在当今的互联网时代，WordPress作为最受欢迎的内容管理系统（CMS）之一，拥有庞大的用户群体和丰富的插件生态系统。然而，有时候现有的插件并不能完全满足我们的需求，这时候就需要我们自己动手编写插件。本文将带你从零开始，学习如何在WordPress中自己编写插件。

1. 了解WordPress插件的基本结构

在开始编写插件之前，首先需要了解WordPress插件的基本结构。一个典型的WordPress插件通常包含以下几个部分：

插件头信息：这是插件的元数据，包括插件名称、描述、版本、作者等信息。这些信息通常放在插件文件的顶部，用PHP注释的形式表示。

<?php
/*
Plugin Name: 我的第一个插件
Description: 这是一个简单的WordPress插件示例。
Version: 1.0
Author: 你的名字
*/

主文件：这是插件的核心文件，通常以plugin-name.php命名。在这个文件中，你可以编写插件的功能代码。
其他文件：根据插件的复杂程度，你可能还需要创建其他文件，如CSS、JavaScript、图片等。

2. 创建一个简单的插件

让我们从一个简单的插件开始。这个插件的功能是在文章内容的前面添加一段自定义文本。

创建插件文件夹：在wp-content/plugins/目录下创建一个新的文件夹，命名为my-first-plugin。
创建主文件：在my-first-plugin文件夹中创建一个名为my-first-plugin.php的文件，并添加以下代码：

<?php
/*
Plugin Name: 我的第一个插件
Description: 这是一个简单的WordPress插件示例。
Version: 1.0
Author: 你的名字
*/

function my_first_plugin_add_text($content) {
$custom_text = "<p>这是通过我的第一个插件添加的文本。</p>";
return $custom_text . $content;
}

add_filter('the_content', 'my_first_plugin_add_text');

激活插件：登录到WordPress后台，进入“插件”页面，你应该会看到“我的第一个插件”出现在插件列表中。点击“激活”按钮，插件就会开始工作。
测试插件：打开任意一篇文章，你应该会看到文章内容前面多了一段自定义文本。

3. 扩展插件功能

现在你已经创建了一个简单的插件，接下来可以尝试扩展它的功能。例如，你可以添加一个设置页面，让用户自定义要添加的文本。

添加设置页面：在my-first-plugin.php文件中添加以下代码：

function my_first_plugin_settings_page() {
?>
<div class="wrap">
<h1>我的第一个插件设置</h1>
<form method="post" action="options.php">
<?php
settings_fields('my_first_plugin_options_group');
do_settings_sections('my-first-plugin');
submit_button();
?>
</form>
</div>
<?php
}

function my_first_plugin_add_settings_page() {
add_options_page('我的第一个插件设置', '我的第一个插件', 'manage_options', 'my-first-plugin', 'my_first_plugin_settings_page');
}

add_action('admin_menu', 'my_first_plugin_add_settings_page');

function my_first_plugin_register_settings() {
register_setting('my_first_plugin_options_group', 'my_first_plugin_custom_text', 'sanitize_text_field');
add_settings_section('my_first_plugin_main_section', '主要设置', null, 'my-first-plugin');
add_settings_field('my_first_plugin_custom_text', '自定义文本', 'my_first_plugin_custom_text_callback', 'my-first-plugin', 'my_first_plugin_main_section');
}

function my_first_plugin_custom_text_callback() {
$custom_text = get_option('my_first_plugin_custom_text', '这是通过我的第一个插件添加的文本。');
echo '<input type="text" name="my_first_plugin_custom_text" value="' . esc_attr($custom_text) . '" class="regular-text">';
}

add_action('admin_init', 'my_first_plugin_register_settings');

function my_first_plugin_add_text($content) {
$custom_text = get_option('my_first_plugin_custom_text', '这是通过我的第一个插件添加的文本。');
return "<p>" . esc_html($custom_text) . "</p>" . $content;
}

add_filter('the_content', 'my_first_plugin_add_text');