WordPress插件制作指南，從零開始開發(fā)你的第一個插件

來自：素雅營銷研究院

方知筆記

2025年06月27日 07:07

一、WordPress插件開發(fā)基礎(chǔ)

WordPress插件是擴展網(wǎng)站功能的強大工具，它允許你添加新特性而不需要修改核心代碼。制作一個插件需要基本的PHP知識，但入門門檻并不高。

開發(fā)環(huán)境準備

本地開發(fā)環(huán)境：推薦使用XAMPP、WAMP或Local by Flywheel
代碼編輯器：VS Code、PHPStorm或Sublime Text
WordPress安裝：確保使用最新版本

二、創(chuàng)建你的第一個插件

1. 插件文件結(jié)構(gòu)

在wp-content/plugins目錄下創(chuàng)建一個新文件夾，命名為”my-first-plugin”。在這個文件夾中創(chuàng)建主PHP文件，通常與文件夾同名：my-first-plugin.php。

2. 插件頭部信息

每個WordPress插件都需要標準的頭部注釋：

<?php
/*
Plugin Name: 我的第一個插件
Plugin URI: http://example.com/my-first-plugin
Description: 這是一個簡單的WordPress插件示例
Version: 1.0
Author: 你的名字
Author URI: http://example.com
License: GPL2
*/

三、插件核心功能開發(fā)

1. 添加簡單功能

讓我們創(chuàng)建一個在文章底部顯示自定義內(nèi)容的插件：

function my_plugin_content_filter($content) {
if (is_single()) {
$extra_content = '<div class="my-plugin-box"><p>感謝閱讀這篇文章！</p></div>';
$content .= $extra_content;
}
return $content;
}
add_filter('the_content', 'my_plugin_content_filter');

2. 添加短代碼功能

短代碼讓用戶可以在文章中方便地調(diào)用插件功能：

function my_plugin_shortcode($atts) {
$atts = shortcode_atts(array(
'name' => '訪客'
), $atts);

return '<div class="greeting">你好，' . esc_html($atts['name']) . '！這是我的插件短代碼示例。</div>';
}
add_shortcode('my_greeting', 'my_plugin_shortcode');

四、插件進階功能

1. 創(chuàng)建管理頁面

為你的插件添加設(shè)置頁面：

function my_plugin_admin_menu() {
add_menu_page(
'我的插件設(shè)置',
'我的插件',
'manage_options',
'my-plugin-settings',
'my_plugin_settings_page'
);
}
add_action('admin_menu', 'my_plugin_admin_menu');

function my_plugin_settings_page() {
?>
<div class="wrap">
<h1>我的插件設(shè)置</h1>
<form method="post" action="options.php">
<?php
settings_fields('my-plugin-settings-group');
do_settings_sections('my-plugin-settings-group');
?>
<table class="form-table">
<tr valign="top">
<th scope="row">自定義消息</th>
<td><input type="text" name="my_plugin_message" value="<?php echo esc_attr(get_option('my_plugin_message')); ?>" /></td>
</tr>
</table>
<?php submit_button(); ?>
</form>
</div>
<?php
}

2. 添加設(shè)置選項

注冊和保存插件設(shè)置：

function my_plugin_register_settings() {
register_setting('my-plugin-settings-group', 'my_plugin_message');
}
add_action('admin_init', 'my_plugin_register_settings');