WordPress自己寫插件，從入門到精通

來自：素雅營銷研究院

方知筆記

2025年06月22日 00:41

在當今的互聯(lián)網(wǎng)時代，WordPress作為最受歡迎的內容管理系統(tǒng)（CMS）之一，擁有龐大的用戶群體和豐富的插件生態(tài)系統(tǒng)。然而，有時候現(xiàn)有的插件并不能完全滿足我們的需求，這時候就需要我們自己動手編寫插件。本文將帶你從零開始，學習如何在WordPress中自己編寫插件。

1. 了解WordPress插件的基本結構

在開始編寫插件之前，首先需要了解WordPress插件的基本結構。一個典型的WordPress插件通常包含以下幾個部分：

插件頭信息：這是插件的元數(shù)據(jù)，包括插件名稱、描述、版本、作者等信息。這些信息通常放在插件文件的頂部，用PHP注釋的形式表示。

<?php
/*
Plugin Name: 我的第一個插件
Description: 這是一個簡單的WordPress插件示例。
Version: 1.0
Author: 你的名字
*/

主文件：這是插件的核心文件，通常以plugin-name.php命名。在這個文件中，你可以編寫插件的功能代碼。
其他文件：根據(jù)插件的復雜程度，你可能還需要創(chuàng)建其他文件，如CSS、JavaScript、圖片等。

2. 創(chuàng)建一個簡單的插件

讓我們從一個簡單的插件開始。這個插件的功能是在文章內容的前面添加一段自定義文本。

創(chuàng)建插件文件夾：在wp-content/plugins/目錄下創(chuàng)建一個新的文件夾，命名為my-first-plugin。
創(chuàng)建主文件：在my-first-plugin文件夾中創(chuàng)建一個名為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后臺，進入“插件”頁面，你應該會看到“我的第一個插件”出現(xiàn)在插件列表中。點擊“激活”按鈕，插件就會開始工作。
測試插件：打開任意一篇文章，你應該會看到文章內容前面多了一段自定義文本。

3. 擴展插件功能

現(xiàn)在你已經(jīng)創(chuàng)建了一個簡單的插件，接下來可以嘗試擴展它的功能。例如，你可以添加一個設置頁面，讓用戶自定義要添加的文本。

添加設置頁面：在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');