Panduan lengkap untuk pembangunan plugin WordPress: daripada asas hingga tahap lanjutan.

Membangunkan sebuah plugin untuk WordPress bermakna anda sedang memperluas fungsi asas sistem pengurusan kandungan yang paling popular di dunia. Sama ada anda ingin mencipta alat kecil untuk keperluan khusus atau merancang untuk melancarkan produk komersial, memahami proses pembangunannya adalah sangat penting. Sebuah plugin yang direka dengan baik bukan sahaja akan mempunyai fungsi yang kuat, tetapi juga selamat, cekap, mudah diselenggara, dan mudah diedarkan.

Prinsip asas plugin WordPress

Sebelum meneroka kod dengan lebih mendalam, memahami prinsip asas plugin WordPress adalah langkah pertama.

Apa itu plugin?

Pada dasarnya, sebuah plugin merupakan koleksi satu atau lebih fail PHP yang “terhubung” dengan kod asas WordPress. Ia berfungsi untuk menambah, mengubah, atau menghapus ciri-ciri tertentu melalui “hook” yang telah ditetapkan sebelumnya. Setiap plugin mempunyai satu fail utama, yang biasanya mengandungi ulasan kepala khusus untuk mengenal pastikan identiti plugin tersebut kepada sistem WordPress.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan Terakhir Pembangunan Plugin WordPress: Membina Perluasan Profesional Dari Kosong Ke Sifar。

Struktur fail utama plugin

Fail utama ini merupakan pintu masuk untuk plugin. Komen-komen di bahagian atas fail tersebut sangat penting, kerana WordPress menggunakan maklumat dalam komen-komen ini untuk mengenal pasti butiran plugin dan memaparkannya dalam panel pentadbiran latar belakang.

UltaHost – Penyedia Hosting untuk WordPress

Jaminan pemulangan wang dalam tempoh 30 hari, lebar jalur dan pangkalan data yang tidak terhad, perlindungan DDoS percuma, diskaun 50% untuk pembelian selama 3 tahun.

Lawati halaman

<?php
/**
 * Plugin Name: 我的第一个插件
 * Plugin URI:  https://example.com/my-first-plugin
 * Description: 这是一个简短的插件描述，解释其功能。
 * Version:     1.0.0
 * Author:      你的名字
 * Author URI:  https://example.com
 * License:     GPL v2 or later
 * Text Domain: my-first-plugin
 */

Kod di atas mendefinisikan metadata asas untuk plugin tersebut. Di dalamnya,Text DomainIni adalah penunjuk yang digunakan untuk proses internasionalisasi (penterjemahan). Semasa menyimpan fail ini, anda perlu meletakkannya dalam folder yang dinamakan berdasarkan nama plugin tersebut, kemudian mengemukakan folder tersebut ke WordPress. /wp-content/plugins/ Ia berada dalam direktori tersebut. Dengan ini, anda boleh melihat dan mengaktifkannya pada halaman “Plugin” di bahagian belakang (backend).

Pembinaan persekitaran pembangunan dan alat-alat

Sebuah persekitaran pembangunan yang cekap dapat meningkatkan dengan ketara pengalaman dan produktiviti dalam pembangunan plugin.

Konfigurasi persekitaran pembangunan tempatan

Disyorkan untuk menggunakan persekitaran pelayan tempatan, seperti XAMPP, MAMP, Local by Flywheel, atau Docker. Ini membolehkan anda melakukan pembangunan dan penyelidikan tanpa mempengaruhi laman web yang bersedia untuk digunakan oleh pengguna. Pastikan bahawa versi PHP yang anda gunakan pada pelayan tempatan adalah serasi dengan persekitaran pelayan sasaran, dan aktifkan fungsi pelaporan ralat; ini sangat berguna pada peringkat pembangunan. Anda boleh…wp-config.phpTambahkan kod berikut ke dalam fail untuk mengaktifkan mod pembangunan (debug mode):

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true ); // 将错误记录到 /wp-content/debug.log
define( 'WP_DEBUG_DISPLAY', false ); // 不要在页面上显示错误

Alat pembangunan yang disyorkan untuk digunakan:

Selain editor kod (seperti VS Code, PhpStorm), alat-alat berikut juga sangat penting untuk pembangunan plugin:
1. Kawalan Versi (Git): Menggunakan Git serta platform seperti GitHub/GitLab/Bitbucket untuk mengurus versi kod dan bekerjasama secara berpasukan.
2. Alat Pemeriksaan Standard Kod: WordPress mempunyai set standard pengaturcaraan sendiri. Dengan menggunakan PHP_CodeSniffer dan set peraturan pengaturcaraan WordPress (WordPress Coding Standards), anda dapat memastikan gaya kod anda selaras dengan komuniti pengguna WordPress.
3. Alat Pemaju Browser: Digunakan untuk membaiki masalah (debug) kod JavaScript dan CSS pada bahagian hadapan (frontend) aplikasi web.
4. Alat Pengurusan Pangkalan Data (seperti phpMyAdmin): Digunakan untuk melihat dan mengurus data yang dihasilkan atau diubah oleh plugin secara langsung.
5. Alat CLI: Kemahiran dalam menggunakan WP-CLI membolehkan tugas pengurusan WordPress dilakukan dengan cepat, yang sangat membantu dalam proses ujian dan penempatan (deployment).

Diperoleh daripada WEB\nDisyorkan untuk membaca. Menguasai Pembangunan Plugin WordPress: Membina Modul Fungsi Khusus yang Cekap dari Kosong。

Penerangan Terperinci Mengenai Proses Pembangunan Utama

Setelah memahami prinsip asas dan menyediakan alat yang diperlukan, kita boleh mula menulis fungsi pertama.

Mencipta kelas asas untuk plugin

Walaupun plugin boleh ditulis terus menggunakan fungsi, penggunaan pengaturcaraan berorientasikan objek (Object-Oriented Programming/OOP) dan kelas untuk mengatur kod adalah pendekatan yang lebih profesional dan mudah diselenggara. Ini membantu mengasingkan fungsi-fungsi tertentu dan mengelakkan konflik nama.

class My_First_Plugin {
    public function __construct() {
        // 构造函数，在这里挂载钩子
        add_action( 'init', array( $this, 'register_shortcode' ) );
        add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_scripts' ) );
    }

public function register_shortcode() {
        add_shortcode( 'my_greeting', array( $this, 'render_shortcode' ) );
    }

public function render_shortcode( $atts ) {
        return '<p>Hai, ini daripada plugin saya!</p>';
    }

public function enqueue_scripts() {
        wp_enqueue_style( 'my-plugin-style', plugins_url( 'css/style.css', __FILE__ ) );
    }
}

// 实例化插件类
new My_First_Plugin();

Menggunakan pengait tindakan (action hooks) dan pengait penapis (filter hooks)

Hook (Gantung) merupakan mekanisme asas dalam pembangunan plugin untuk WordPress. Ia terbahagi kepada dua jenis: Action (Tindakan) dan Filter (Penapis).
* 动作钩子：允许你在特定的时间点（如“初始化后”、“保存文章前”）“注入”并执行你自己的代码。使用add_action()Fungsi untuk memuatkan (mounting).
* 过滤器钩子：允许你修改WordPress或其他插件即将要使用的数据。使用add_filter()Fungsi tersebut digunakan untuk memuatkan (mount) data, dan fungsi anda mesti mengembalikan nilai yang telah diubah suai.

hosting.com Hosting Bersama

Prestasi tinggi, menampilkan CPU AMD EPYC, storan SSD NVMe dan LiteSpeed, dengan sokongan pakar dalaman 24/7, langkah keselamatan canggih termasuk SSL, perlindungan serangan paksa kata laluan, perisian hasad dan DDoS, menjimatkan sehingga 73%.

Lawati halaman

// 动作钩子示例：在文章末尾添加内容
add_action( 'the_content', function( $content ) {
    if ( is_single() ) {
        $extra_text = '<div class="my-plugin-note">Terima kasih kerana membaca artikel ini!</div>';
        $content .= $extra_text;
    }
    return $content; // 注意：这里实际上用到了过滤器，但挂载在动作钩子‘the_content’上，它同时也是一个过滤器
} );

// 过滤器钩子示例：修改文章标题
add_filter( 'the_title', function( $title ) {
    return '【精选】' . $title;
} );

Create a management menu and a settings page.

Untuk membolehkan pengguna mengkonfigurasi plugin anda, anda perlu membuat menu pengurusan dan halaman tetapan di bahagian belakang (backend) WordPress. Ini dilakukan terutamanya melalui…add_menu_page()或add_options_page()Implementasi fungsi-fungsi seperti…

class Plugin_Admin {
    public function __construct() {
        add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
        add_action( 'admin_init', array( $this, 'register_settings' ) );
    }

public function add_admin_menu() {
        add_options_page(
            '我的插件设置',       // 页面标题
            '我的插件',          // 菜单标题
            'manage_options',    // 权限
            'my-plugin-settings', // 菜单slug
            array( $this, 'render_settings_page' ) // 显示页面的回调函数
        );
    }

public function register_settings() {
        register_setting( 'my_plugin_settings_group', 'my_plugin_option' );
        add_settings_section( 'section_id', '主要设置', null, 'my-plugin-settings' );
        add_settings_field( 'field_id', '选项名称', array( $this, 'render_field' ), 'my-plugin-settings', 'section_id' );
    }

public function render_field() {
        $value = get_option( 'my_plugin_option' );
        echo '<input type="text" name="my_plugin_option" value="' . esc_attr( $value ) . '" />';
    }

public function render_settings_page() {
        ?&gt;
        <div class="wrap">
            <h1>Tetapan-tetapan plugin saya</h1>
            <form action="/ms/options.php/" method="post" data-trp-original-action="options.php">
                <?php
                settings_fields( 'my_plugin_settings_group' );
                do_settings_sections( 'my-plugin-settings' );
                submit_button();
                ?>
            <input type="hidden" name="trp-form-language" value="ms"/></form>
        </div>
        &lt;?php
    }
}
new Plugin_Admin();

Topik Tinggi dan Amalan Terbaik

Apabila fungsi plugin menjadi semakin kompleks, mengikuti amalan terbaik adalah kunci untuk memastikan kualiti.

Mencipta jadual pangkalan data khusus

Walaupun WordPress…wp_optionsJadual sesuai untuk menyimpan konfigurasi yang ringkas, tetapi data yang kompleks (seperti pesanan, penghantaran borang) perlu disimpan dalam jadual pangkalan data yang dibina khas. Ini memerlukan penciptaan jadual tersebut ketika plugin diaktifkan.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan lengkap untuk pembangunan plugin WordPress: Membina ekstensi berkualiti tinggi dari awal hingga akhir.。

Anda perlu menggunakanregister_activation_hook()Penyambung (hook) digunakan untuk memastikan bahawa kod yang membuat jadual hanya dijalankan sekali sahaja apabila plugin diaktifkan.

register_activation_hook( __FILE__, 'my_plugin_create_table' );

function my_plugin_create_table() {
    global $wpdb;
    $table_name = $wpdb->prefix . 'my_plugin_data'; // 使用前缀避免冲突
    $charset_collate = $wpdb->get_charset_collate();

$sql = "CREATE TABLE $table_name (
        id mediumint(9) NOT NULL AUTO_INCREMENT,
        name tinytext NOT NULL,
        email varchar(100) NOT NULL,
        created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL,
        PRIMARY KEY (id)
    ) $charset_collate;";

require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );
    dbDelta( $sql );
}

Pastikan keselamatan dan prestasi plugin tersebut.

Keselamatan adalah sangat penting. Sentiasa sahkan, bersihkan, dan lakukan proses “escaping” pada input pengguna.
* 验证：检查数据是否符合预期格式（如是否为邮箱） - is_email()。
* 清理：移除数据中不允许的字符 - sanitize_text_field(), sanitize_email()。
* 转义：在将数据输出到HTML、JavaScript或URL之前，确保它们被安全编码 - esc_html(), esc_js(), esc_url()。

Hosting Bersama InterServer

Hosting kongsi: 1TB/bulan pada $2.50 USD, bulan pertama pada $0.10 USD dengan kod promo tryinterserver. 461 skrip aplikasi awan tersedia untuk pemasangan satu klik.

Lawati halaman

Untuk prestasi, gunakan hook dengan bijak untuk mengelakkan daripada menjalankan kueri yang tidak perlu setiap kali halaman dimuat. Gunakan caching objek (seperti…)wp_cache_set()和wp_cache_get()Untuk menyimpan hasil carian yang mahal, gunakan kaedah yang sesuai. Pada masa yang sama, pastikan bahawa sumber daya frontend (CSS/JS) diset dengan betul mengikut kebergantungan dan nombor versi yang berkaitan, dan pertimbangkan untuk menggunakan pengambilan berdasarkan syarat (conditional loading) pada masa yang sesuai.

Preparasi untuk pengantarabangsaan dan penglokalisasi.

Untuk memastikan plugin anda dapat digunakan oleh pengguna di seluruh dunia, anda perlu melakukan persiapan untuk penindasan budaya (internationalization atau i18n). Ini bermakna anda perlu mengemas semua teks yang akan dilihat oleh pengguna menggunakan fungsi khusus. Dalam kod, gunakan fungsi-fungsi yang menyokong pengurusan teks dalam pelbagai bahasa.__()Terjemahkan dan kembalikan rentetan teks menggunakan:_e()Terjemahkan dan outputkan rentetan karakter secara langsung.

\necho '<h2>' . __( '欢迎来到我的插件', 'my-first-plugin' ) . '</h2>';
_e( '这是一个段落。', 'my-first-plugin' );

Di antaranya'my-first-plugin'Ia adalah apa yang anda definisikan di bahagian atas plugin tersebut.Text DomainSelepas itu, anda boleh menggunakan alat seperti Poedit untuk membuatnya..potFail templat dan pelbagai bahasa.po和.moMenterjemahkan dokumen.

RINGKASAN

Pembangunan plugin WordPress adalah proses yang beransur-ansur, bermula dengan memahami infrastruktur asas (hook, fail utama), kemudian mahir menggunakan fungsi “action” dan “filter”, seterusnya membina antara muka pengurusan dan pangkalan data. Pembangun yang berjaya tidak hanya memberi perhatian kepada pelaksanaan fungsi, tetapi juga kepada keselamatan kod, prestasi, kebolehjagaan, dan sokongan untuk pelbagai bahasa (internationalization). Dengan membina persekitaran pembangunan yang profesional, mengikuti standard pengkodan WordPress, dan melaksanakan amalan pengeluaran dan penerimaan input yang selamat, anda akan dapat membuat plugin yang kuat, boleh dipercayai, dan disukai oleh pengguna. Ingatlah, cara terbaik untuk belajar pembangunan plugin adalah dengan bermula dengan fungsi yang kecil dan terperinci, kemudian mengembangkannya secara beransur-ansur melalui iterasi.

FAQ - Soalan Lazim

Apa pengetahuan asas yang diperlukan untuk membangunkan plugin WordPress?

Anda perlu memiliki asas pengaturcaraan PHP yang kukuh, kerana logik teras plugin tersebut ditulis dalam PHP. Pada masa yang sama, anda perlu mempunyai pengetahuan asas tentang HTML, CSS, dan JavaScript untuk membina antara muka pengguna (front-end) dan interaksi. Memahami konsep asas pangkalan data MySQL juga akan sangat membantu, kerana anda perlu berinteraksi dengan pangkalan data WordPress.

Bagaimana untuk mengelakkan konflik antara plugin saya dengan plugin lain?

Menggunakan pengaturcaraan berorientasikan objek (OOP) dan kelas untuk mengapsulkan kod anda adalah kaedah yang paling utama. Selain itu, tambahkan awalan yang unik pada semua nama fungsi, kelas, konstanta, nama pilihan, dan nama jadual pangkalan data (contohnya, menggunakan singkatan atau nama plugin anda). Ini dapat mengurangkan kemungkinan berlakunya konflik nama dengan ketara. Tambahan pula, pastikan bahawa fungsi panggilan balik (callback functions) yang anda gunakan semasa proses pemasangan (mounting hooks) adalah unik.

Bagaimanakah saya harus membaiki kod plugin saya?

Pertama, pastikan bahawa dalamwp-config.phpIa telah diaktifkan.WP_DEBUGMod. Mesej ralat akan direkodkan./wp-content/debug.logDalam fail tersebut. Selain itu, ia boleh digunakan.error_log()Fungsi tersebut akan menulis maklumat pembaikan (debugging information) yang disesuaikan ke dalam log. Untuk logik yang kompleks, gunakan alat pembaikan profesional seperti Xdebug bersama editor kod anda (seperti VS Code), dan anda boleh menetapkan titik henti (breakpoints) untuk melakukan pembaikan baris demi baris.

Setelah pembangunan selesai, bagaimanakah saya boleh menghantar plugin saya ke direktori plugin rasmi WordPress?

Anda perlu mengakses Pusat Pembangun Plugin rasmi WordPress dan mendaftar akaun. Sebelum menghantar plugin anda, pastikan ia memenuhi sepenuhnya garis panduan pembangunan plugin rasmi dan standard kod. Kod plugin anda harus mengandungi ulasan kepala yang standard, dan tidak boleh mengandungi sebarang kod yang dienkripsi atau dikacaukan. Proses penghantaran melibatkan pengunggahan paket plugin yang telah dikompresi, menunggu semakan oleh pihak berkuasa, dan setelah diluluskan, plugin tersebut boleh diterbitkan dalam direktori rasmi.