WordPress創(chuàng)建插件，從入門到精通的完整指南

來自：素雅營銷研究院

方知筆記

2025年06月30日 10:40

WordPress作為全球最流行的內(nèi)容管理系統(tǒng)(CMS)，其強大的插件架構(gòu)允許開發(fā)者擴展核心功能。本文將詳細介紹如何從零開始創(chuàng)建一個WordPress插件，涵蓋開發(fā)流程、最佳實踐和實用技巧。

一、準備工作

在開始創(chuàng)建WordPress插件前，您需要：

本地開發(fā)環(huán)境(XAMPP/MAMP/WAMP或Docker)
代碼編輯器(VS Code、PHPStorm等)
基礎(chǔ)的PHP和WordPress知識
測試用的WordPress安裝

二、創(chuàng)建基礎(chǔ)插件結(jié)構(gòu)

插件目錄：在wp-content/plugins/下創(chuàng)建新文件夾，如my-first-plugin
主文件：在文件夾中創(chuàng)建主PHP文件，通常與文件夾同名(my-first-plugin.php)
插件頭信息：在主文件頂部添加標(biāo)準注釋：

<?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-2.0+
* License URI: http://www.gnu.org/licenses/gpl-2.0.txt
*/

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

1. 添加簡單功能

function my_first_plugin_function() {
echo '<p>這是我的第一個插件輸出的內(nèi)容!</p>';
}
add_action('wp_footer', 'my_first_plugin_function');

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

add_action('admin_menu', 'my_first_plugin_menu');

function my_first_plugin_menu() {
add_menu_page(
'我的插件設(shè)置',       // 頁面標(biāo)題
'我的插件',          // 菜單標(biāo)題
'manage_options',   // 權(quán)限
'my-first-plugin',  // 菜單slug
'my_first_plugin_page', // 回調(diào)函數(shù)
'dashicons-admin-generic', // 圖標(biāo)
6                   // 位置
);
}

function my_first_plugin_page() {
echo '<div class="wrap"><h1>我的插件設(shè)置</h1>';
echo '<p>這里是插件的設(shè)置頁面內(nèi)容</p></div>';
}

四、進階開發(fā)技巧

1. 使用短代碼(Shortcode)

add_shortcode('greet', 'my_greeting_shortcode');

function my_greeting_shortcode($atts) {
$atts = shortcode_atts([
'name' => '訪客'
], $atts);

return '<div class="greeting">你好，' . esc_html($atts['name']) . '!</div>';
}

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

add_action('admin_init', 'my_first_plugin_settings');

function my_first_plugin_settings() {
register_setting('my_first_plugin_options', 'my_first_plugin_options');

add_settings_section(
'main_section',
'主要設(shè)置',
'my_section_text',
'my-first-plugin'
);

add_settings_field(
'greeting_text',
'問候語',
'greeting_text_input',
'my-first-plugin',
'main_section'
);
}

function my_section_text() {
echo '<p>這里是插件的主要設(shè)置部分</p>';
}

function greeting_text_input() {
$options = get_option('my_first_plugin_options');
echo "<input id='greeting_text' name='my_first_plugin_options[greeting_text]'
type='text' value='" . esc_attr($options['greeting_text'] ?? '') . "' />";
}