Pembangunan Plugin WordPress: Dari Permulaan Hingga Kemahiran Lanjutan: Membina Plugin Fungsi Pertama Anda

Mengapa perlu belajar pengembangan plugin WordPress?

WordPress, sebagai sistem pengurusan kandungan yang paling popular di dunia, memiliki keupayaan pengembangan yang kuat berkat ketersediaan sejumlah besar plugin. Belajar mengembangkan plugin bukan sahaja membolehkan anda menyesuaikan fungsi mengikut keperluan sendiri, tetapi juga memahami dengan lebih mendalam struktur asas WordPress, meningkatkan kemahiran teknikal, dan bahkan mengubah idea anda menjadi produk yang boleh diterbitkan. Dengan mengembangkan plugin sendiri, anda dapat mengawal kualiti kod dengan tepat, memastikan keselamatan laman web, dan mengelakkan masalah keserasian yang mungkin timbul akibat penggunaan plugin pihak ketiga.

Sebuah plugin asas untuk WordPress pada dasarnya terdiri daripada satu atau lebih fail PHP yang terletak dalam direktori yang ditentukan. Plugin tersebut berinteraksi dengan sistem WordPress yang asas melalui API yang disediakan oleh WordPress, seperti hook tindakan (action hooks), hook penapisan (filter hooks), kod pendek (shortcodes), dan alat tambahan (widgets). Memahami mekanisme ini adalah prasyarat untuk mengembangkan plugin dengan jayanya.

Mengatur persekitaran pembangunan dan infrastruktur asas

Sebelum menulis baris kod pertama, adalah sangat penting untuk mewujudkan persekitaran pembangunan yang baik. Anda memerlukan sebuah persekitaran pelayan tempatan (seperti XAMPP, Local by Flywheel atau DevKinsta), sebuah editor kod (seperti VS Code atau PhpStorm), serta sebuah instalasi WordPress untuk tujuan ujian.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan Terakhir Pembangunan Plugin WordPress: Menguasai Prinsip Asas dan Projek Praktikal。

Pintu masuk untuk plugin adalah sebuah fail PHP utama. Komen di bahagian atas fail tersebut merupakan kunci untuk WordPress mengenali plugin tersebut. Mari kita mulakan dengan membuat struktur asas untuk plugin tersebut.

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

Mencipta fail utama untuk plugin

Fail utama sebuah plugin biasanya dinamakan berdasarkan nama plugin tersebut. Sebagai contoh, jika kita membuat sebuah plugin yang dinamakan “My First Plugin”, fail utamanya boleh dinamakan “my_first_plugin.js”.my-first-plugin.phpFail tersebut mesti diletakkan di/wp-content/plugins/my-first-plugin/Dalam direktori tersebut.

Bahagian kepala fail mesti mengandungi ulasan maklumat tambahan (plugin information comments) yang standard. Berikut adalah contoh asas:

<?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 v2 or later
 * Text Domain:       my-first-plugin
 * Domain Path:       /languages
 */

Setelah menyimpan fail tersebut, masuk ke halaman “Pemalam” (Plugins) di panel pentadbiran WordPress. Anda sepatutnya dapat melihat pemalam baru ini dalam senarai pemalam dan boleh mengaktifkannya. Pada masa ini, pemalam ini tidak mempunyai sebarang fungsi, tetapi kerangka asasnya sudah siap dibina.

Membina struktur direktori asas untuk plugin

Sebuah plugin yang mempunyai struktur yang jelas akan memudahkan penyelenggaraan jangka panjang. Disarankan untuk membuat direktori berikut:
* /assets/Digunakan untuk menyimpan sumber statik seperti CSS, JavaScript, dan gambar.
* /includes/Digunakan untuk menyimpan fail kelas PHP dan fail fungsi yang merupakan inti program.
* /languages/Digunakan untuk menyimpan fail terjemahan antarabangsa (.po/.mo).

Diperoleh daripada WEB\nDisyorkan untuk membaca. Prinsip dan intipati Tailwind CSS: Mendedahkan mekanisme kerja rangka kerja CSS atomik yang memberi keutamaan kepada kemudahan penggunaan.。

Main Filemy-first-plugin.phpIa sepatutnya hanya bertanggungjawab untuk proses penginisian plugin, seperti mendefinisikan pemalar (constants), memuatkan fail lain, mendaftar fungsi tertentu (hooks), dan sebagainya.

Melaksanakan fungsi utama: Membina menu pengurusan dan halaman-halaman yang berkaitan.

Salah satu fungsi tambahan yang sering digunakan ialah menambahkan halaman menu pengurusan di bahagian belakang (backend) WordPress. Kita akan melakukannya menggunakan “Menu Page API” yang disediakan oleh WordPress.

Tambahkan menu utama di bahagian belakang (backend).

Kita perlu menggunakanadd_menu_page()Fungsi. Fungsi ini biasanya digunakan dalam...admin_menuKekunci tindakan ini dipanggil apabila ia diaktifkan. Kita menambahkan kod berikut ke dalam fail utama:

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

// 定义在管理员菜单初始化时执行的功能
function mfp_add_admin_menu() {
    add_menu_page(
        '我的插件设置',         // 页面标题
        '我的插件',            // 菜单标题
        'manage_options',      // 所需权限
        'my-first-plugin',     // 菜单slug
        'mfp_display_settings_page', // 用于显示页面内容的回调函数
        'dashicons-admin-generic', // 菜单图标（Dashicon）
        6                      // 菜单位置
    );
}
// 将函数挂载到 `admin_menu` 钩子上
add_action('admin_menu', 'mfp_add_admin_menu');

Mencipta kandungan yang akan dipaparkan pada halaman tetapan

Dalam kod di atas,mfp_display_settings_pageIni adalah sebuah fungsi panggilan balik (callback function) yang bertanggungjawab untuk menghasilkan kandungan HTML halaman tetapan (setting page). Kita perlu mendefinisikan fungsi ini:

// 设置页面的显示内容
function mfp_display_settings_page() {
    // 检查用户权限
    if (!current_user_can('manage_options')) {
        wp_die(__('你没有权限访问此页面。'));
    }
    ?>
    <div class="wrap">
        <h1><?php echo esc_html(get_admin_page_title()); ?></h1>
        <form action="/ms/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            // 输出设置字段和安全nonce字段
            settings_fields('mfp_options_group'); // 设置组的名称
            do_settings_sections('my-first-plugin'); // 页面slug
            submit_button('保存设置');
            ?>
        <input type="hidden" name="trp-form-language" value="ms"/></form>
    </div>
    &lt;?php
}

Kod ini membuat sebuah rangka untuk halaman tetapan standard WordPress, di mana komponen-komponen tertentu digunakan di dalamnya.settings_fields()和do_settings_sections()Fungsi ini bermakna kita akan menggunakan WordPress Settings API untuk menguruskan tetapan (options) kita, yang merupakan cara yang paling selamat dan terstandard.

Gunakan API Settings untuk mengurus pilihan tambahan (plugins).

Berurusan secara langsung$_POSTTerdapat risiko keselamatan pada data tersebut. API WordPress Settings telah menguruskan pengesahan data, keselamatan, dan penyimpanan data untuk kita, menjadikannya kaedah pilihan utama untuk mengurus tetapan plugin.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan Lengkap Plugin WooCommerce: Membina Laman Web E-dagang Antarabangsa Profesional Dari Kosong。

Pengaturan pendaftaran, bidang (fields), dan bab (chapters)

Kita perlu…admin_initMenginisialisasikan tetapan kita dalam “hook”. Pertama sekali, gunakan…register_setting()Daftar satu pilihan tetapan.

function mfp_register_settings() {
    // 注册一个设置：`mfp_options` 是存储在`wp_options`表中的键名
    register_setting(
        'mfp_options_group', // 设置组名，需与`settings_fields()`参数一致
        'mfp_options',       // 选项名
        'mfp_sanitize_options' // 可选：数据清洗回调函数
    );

// 添加一个设置章节
    add_settings_section(
        'mfp_main_section',                // 章节ID
        '主要设置',                         // 章节标题
        'mfp_main_section_callback',       // 章节介绍的回调函数
        'my-first-plugin'                  // 所属页面slug
    );

// 在章节中添加一个文本字段
    add_settings_field(
        'mfp_text_field',                  // 字段ID
        '示例文本',                         // 字段标签
        'mfp_text_field_callback',         // 用于渲染字段HTML的回调函数
        'my-first-plugin',                 // 所属页面slug
        'mfp_main_section'                 // 所属章节ID
    );
}
add_action('admin_init', 'mfp_register_settings');

Mendefinisikan fungsi rendering dan pembersihan untuk medan (fields)

Sekarang, kita perlu mendefinisikan setiap fungsi panggilan balik (callback function) yang telah digunakan di atas, untuk menghasilkan kod HTML untuk bidang-bidang yang perlu ditampilkan dan membersihkan data.

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

// 主章节的描述文本
function mfp_main_section_callback() {
    echo '<p>Ini adalah kawasan tetapan utama untuk plugin tersebut.</p>';
}

// 文本字段的HTML输出
function mfp_text_field_callback() {
    // 从数据库获取现有值
    $options = get_option('mfp_options');
    $value = $options['mfp_text_field'] ?? ''; // PHP 7.0+ 空合并运算符
    echo '<input type="text" name="mfp_options[mfp_text_field]" value="' . esc_attr($value) . '" class="regular-text">';
}

// 数据清洗函数（可选但推荐）
function mfp_sanitize_options($input) {
    $sanitized_input = [];
    if (isset($input['mfp_text_field'])) {
        // 对文本字段进行基本的清洗，如去除标签
        $sanitized_input['mfp_text_field'] = sanitize_text_field($input['mfp_text_field']);
    }
    return $sanitized_input;
}

Setakat ini, sebuah plugin yang lengkap dengan halaman tetapan keselamatan telah siap dibina. Setelah plugin diaktifkan, anda boleh melihat menu “My Plugins” di bahagian belakang WordPress, klik untuk masuk dan mengatur serta menyimpan sebuah pilihan teks. Semua data disimpan dengan selamat melalui API WordPress.wp_optionsDalam jadual.

Menambahkan fungsi frontend untuk plugin: Mencipta kod pendek

Fungsi latar belakang (backend) adalah asas, tetapi plugin biasanya juga perlu mempengaruhi bahagian depan (frontend) laman web. Mencipta kod pendek (shortcode) merupakan cara yang sangat baik untuk memaparkan fungsi plugin dalam artikel, halaman, atau alat tambahan (widgets).

Daftar kod pendek yang mudah.

Kita mendaftar satu yang bernama[my_greeting]Kod pendek ini digunakan untuk menampilkan ucapan selamat di bahagian hadapan (frontend).add_shortcode()Fungsi.

Tambahkan dalam fail utama atau fail fungsi khusus:

// 注册短代码
function mfp_greeting_shortcode($atts, $content = null) {
    // 使用shortcode_atts设置默认属性并合并用户输入
    $atts = shortcode_atts(
        array(
            'name' => '访客', // 默认值
        ),
        $atts,
        'my_greeting' // 短代码名称
    );

// 获取插件选项中存储的文本
    $options = get_option('mfp_options');
    $custom_text = $options['mfp_text_field'] ?? '';

// 构造输出
    $output = '<div class="mfp-greeting">'$output = '<p>Hello, '. esc_html($atts['name'])'. ‘! Selamat datang ke laman web kami.</p>';
    if (!empty($custom_text)) {
        $output .= '<p><strong>Mesej Khusus:</strong>'`. esc_html($custom_text)`.'</p>'$output = '</div>';

// 返回输出内容，而不是直接echo
    return $output;
}
add_shortcode('my_greeting', 'mfp_greeting_shortcode');

Sekarang, pengguna boleh memasukkan kandungan dalam editor artikel.[my_greeting name="张三"]Pada bahagian hadapan (frontend), maklumat salam yang diperibadikan akan dipaparkan, dan jika “teks contoh” telah disetkan di bahagian belakang (backend), ia juga akan ditunjukkan bersama-sama. Kaedah ini berkesan dalam menghubungkan tetapan yang dibuat di bahagian belakang dengan output yang dipaparkan di bahagian hadapan.

RINGKASAN

Melalui langkah-langkah di atas, kami telah menyelesaikan pembinaan sebuah plugin WordPress yang mempunyai fungsi yang lengkap. Kami bermula dari awal, mencipta fail asas dan struktur plugin tersebut, dan menggunakan…add_menu_page()Dengan menggunakan API Settings, halaman tetapan latar belakang yang selamat telah dibina, dan ia disediakan melalui…add_shortcode()Fungsi output untuk bahagian hadapan (frontend) telah dilaksanakan. Proses ini meliputi aliran utama pembangunan plugin: perancangan, pengaturan awal (initialization), integrasi dengan API belakang (backend API), pemprosesan data, dan penyediaan antara muka untuk bahagian hadapan (frontend interface).

Setelah anda memahami dengan baik asas-asas ini, anda boleh meneruskan untuk meneroka topik-topik yang lebih lanjut, seperti mencipta jenis artikel yang diperibadikan, metadata (Meta Box), jadual pangkalan data yang diperibadikan, titik akhir API REST, pemprosesan AJAX, dan pengantarabangsaan plugin. Ingatlah bahawa mengikuti standard pengaturcaraan WordPress dan amalan terbaik adalah kunci untuk membangunkan plugin yang berkualiti tinggi dan mudah diselenggara.

FAQ - Soalan Lazim

Apakah pengetahuan PHP yang perlu dikuasai untuk pembangunan plugin?

Paling minimum, anda perlu menguasai sintaks asas PHP, termasuk pemboleh ubah (variables), array, fungsi (functions), pengurusan keadaan (conditional statements), dan pengulangan (loops). Pengetahuan tentang pengaturcaraan berorientasikan objek (Object-Oriented Programming/OOP) sangat berguna untuk membina plugin yang lebih kompleks. Selain itu, anda perlu memahami bagaimana WordPress memuatkan plugin, serta cara menggunakan pemboleh ubah dan fungsi global dengan selamat.

Bagaimana untuk membaiki (debug) plugin WordPress yang anda buat sendiri?

Pertama, pastikan bahawa dalamwp-config.phpBuka fail tersebut.WP_DEBUG和WP_DEBUG_LOGDengan cara ini, mesej ralat akan direkodkan ke dalam fail log. Selain itu, ia boleh digunakan…error_log()Fungsi tersebut mengeluarkan maklumat pembetulan ralat (debugging information). Untuk logik yang kompleks, alat pembetulan ralat yang profesional seperti Xdebug boleh digunakan untuk melaksanakan kod secara berperingkat.

Bagaimana untuk memastikan keselamatan sebuah plugin semasa pembangunannya?

Sentiasa verifikasi dan bersihkan input pengguna. Gunakan fungsi yang terbina dalam WordPress, seperti…esc_html(), esc_attr(), sanitize_text_field()和wp_kses()Untuk menguruskan output tersebut, gunakan kaedah yang bukan berdasarkan teknologi CE (Common Edge).wp_nonce_field()Ini digunakan untuk mencegah penipuan permintaan merentas tapak (Cross-Site Request Forgery, CSRF). Untuk operasi pangkalan data, gunakan…$wpdbMetode yang disediakan oleh kelas, atau penggunaannyaprepare()Ayat-ayat untuk mencegah serangan SQL injection.

Adakah plugin sepatutnya disimpan di lokasi setempat (local) atau dikembangkan pada pelayan dalam talian (online server)?

Saya sangat mengesyorkan untuk melakukan kerja pembangunan utama dalam persekitaran pembangunan tempatan (seperti Local, XAMPP). Persekitaran tempatan mempunyai respons yang cepat, tidak terjejas oleh rangkaian, dan membenarkan anda untuk melakukan ujian dan perubahan sesuka hati tanpa mempengaruhi laman web yang berada dalam talian. Setelah fungsi-fungsi utama selesai dibangunkan, barulah laman web tersebut boleh dideploy ke persekitaran ujian dalam talian untuk ujian keserasian yang terakhir.

Bagaimana untuk menerbitkan plugin anda ke dalam direktori rasmi WordPress?

Anda perlu mengakses WordPress.org, mendaftar akaun pembangun, dan menghantar kod plugin anda melalui Subversion (SVN). Plugin tersebut harus mematuhi piawaian kod dan struktur direktori rasmi, serta mengandungi semua komponen yang diperlukan.readme.txtSetelah diluluskan, pengguna di seluruh dunia boleh mencari dan memasang plugin anda terus melalui sistem dalaman (backend).