Panduan Permulaan untuk Pembangunan Plugin WordPress: Membina Plugin Kustom Pertama Anda dari Awal

Pengaturcaraan persekitaran pembangunan plugin WordPress

Sebelum anda mula menulis kod, anda memerlukan persekitaran pembangunan yang sesuai. Ini bukan sahaja dapat meningkatkan kecekapan pembangunan anda, tetapi juga membantu anda dalam membaiki ralat (debugging) dan menguji plugin dengan lebih baik. Pertama sekali, anda perlu membangunkan persekitaran operasi WordPress pada komputer anda sendiri. Anda boleh memilih untuk menggunakan persekitaran pembangunan terintegrasi seperti XAMPP, MAMP, atau Local by Flywheel, yang membenarkan pemasangan PHP, MySQL, dan pelayan Apache/Nginx dengan cepat. Untuk fail-fail asas WordPress, adalah disyorkan untuk memuat turun dan memasang versi stabil terkini dari laman web rasmi.

Pastikan bahawa versi PHP anda memenuhi keperluan minimum untuk WordPress, dan aktifkan fungsi laporan ralat (error reporting). Ini sangat penting untuk proses pembetulan masalah (debugging). Anda boleh melakukan ini dengan...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); // 不在页面上显示错误

Selain itu, sebuah editor kod yang berkuat adalah sangat penting, seperti Visual Studio Code,PhpStorm atau Sublime Text. Editor-editor ini biasanya menyediakan ciri seperti penyorotan sintaks, cadangan kod, dan integrasi dengan sistem kawalan versi, yang dapat meningkatkan pengalaman penulisan kod dengan ketara. Akhir sekali, disyorkan untuk memasang alat pembangun (developer tools) dalam pelayar anda, dan pertimbangkan untuk menggunakan tambahan (extensions) yang direka khusus untuk WordPress, bagi memudahkan pemeriksaan fungsi tertentu (hooks), pertanyaan ke pangkalan data (database queries), dan pemantauan prestasi (performance monitoring).

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan Permulaan untuk Membangunkan Plugin WordPress: Mencipta Modul Fungsi Pertama Anda Dari Awal Hingga Selesai.。

Cipta fail plugin pertama anda.

Bentuk asas sebuah plugin WordPress adalah sebuah fail PHP. Semua plugin disimpan di…/wp-content/plugins/Dalam direktori tersebut, setiap plugin boleh berupa sebuah fail PHP yang berdiri sendiri, atau sebuah folder yang mengandungi beberapa fail.

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

Pertama sekali, buatlah sebuah folder yang unik untuk plugin anda, contohnya:my-first-pluginDalam folder ini, buat fail plugin utama, yang biasanya dinamakan sama dengan nama folder tersebut.my-first-plugin.phpPada permulaan fail ini, mesti terdapat sebuah ulasan kepala plugin yang mematuhi standard WordPress. Ulasan ini memberikan maklumat asas tentang plugin kepada sistem WordPress.

Contoh ulasan kepala untuk fail plugin utama:

<?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
 */

Dalam ulasan ini, “Nama Plugin” adalah item wajib yang menentukan nama yang akan dipaparkan untuk plugin pada antaramuka pengurusan latar belakang. Maklumat lain seperti nombor versi, pengarang, dan sebagainya membantu pengguna memahami lebih lanjut tentang plugin tersebut. Setelah fail ini dibuat, letakkan ia di tempat yang sesuai./wp-content/plugins/my-first-plugin/Senarai. Pada masa ini, log masuk ke panel pentadbiran WordPress anda, kemudian ke halaman “Pembantu” (Plugins). Anda sepatutnya dapat melihat sebuah plugin baru yang bernama “My First Customized Plugin”, dan anda boleh mengaktifkannya. Walaupun pada masa ini ia tidak melakukan apa-apa, anda telah berjaya membuat kerangka asas untuk sebuah plugin.

Proses mengaktifkan dan menonaktifkan plugin

Apabila plugin diaktifkan atau dinonaktifkan, seringkali perlu dilakukan beberapa tindakan pengaturan awal (initialization) dan pembersihan (cleaning), seperti membuat jadual dalam pangkalan data, menetapkan pilihan lalai, atau menghapus data sementara. WordPress menguruskan tindakan-tindakan ini melalui dua jenis “hook” khas (special hooks):register_activation_hook和register_deactivation_hook。

Diperoleh daripada WEB\nDisyorkan untuk membaca. Dari pemula hingga mahir: Panduan lengkap untuk pembangunan plugin WordPress dan amalan terbaik.。

Anda boleh mendefinisikan “hook”-hook ini dalam fail plugin utama. Sebagai contoh, apabila plugin diaktifkan, kita mungkin ingin menulis pilihan konfigurasi lalai ke dalam pangkalan data; apabila plugin dinonaktifkan, kita mungkin perlu membersihkan pilihan tersebut. Kod pelaksanaannya adalah seperti berikut:

// 定义插件激活时执行的函数
function my_plugin_activate() {
    // 添加一个默认选项到数据库
    add_option('my_plugin_default_option', '这是默认值');
    // 或者可以在这里初始化自定义数据库表（需要更复杂的SQL）
}
register_activation_hook(__FILE__, 'my_plugin_activate');

// 定义插件停用时执行的函数
function my_plugin_deactivate() {
    // 删除之前创建的选项
    delete_option('my_plugin_default_option');
    // 注意：通常不在停用钩子中删除数据，以免用户重新激活时丢失设置
    // 更常见的清理工作在卸载钩子中处理
}
register_deactivation_hook(__FILE__, 'my_plugin_deactivate');

Perlu diperhatikan bahawa…register_deactivation_hookBiasanya digunakan untuk pembersihan yang ringan, manakala penghapusan data secara kekal (seperti menghapus jadual daripada pangkalan data) perlu dilakukan dalam fungsi “uninstall hook”. Fungsi uninstall perlu dilaksanakan melalui proses yang sesuai.register_uninstall_hookDaftarlah. Penggunaan hook ini dengan cara yang betul dapat memastikan bahawa tingkah laku plugin anda adalah selaras dengan garis panduan yang ditetapkan, dan tidak akan meninggalkan data yang berlebihan pada laman web.

Mengerti dan menggunakan hook serta filter

Inti pembangunan plugin WordPress terletak pada mekanisme “Hook”, yang membenarkan anda memasukkan kod khusus pada masa atau titik tertentu untuk mengubah suai atau memperluas fungsi asas WordPress. Hook terbahagi kepada dua jenis utama: Action dan Filter.

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

Action hooks membenarkan anda menjalankan fungsi khusus apabila acara tertentu berlaku. Sebagai contoh, apabila sebuah artikel diterbitkan…publish_post), semasa dimuat turun di bahagian atas halaman web (wp_head) atau semasa proses penginisian di bahagian pentadbiran (management backend).admin_initAnda boleh menggunakannya.add_action()Fungsi ini digunakan untuk memuatkan kod anda. Berikut adalah contoh yang mudah, di mana ia secara automatik menambahkan segmen teks khusus di akhir setiap artikel:

function add_custom_footer_to_content($content) {
    if (is_single()) { // 仅在单篇文章页面添加
        $custom_text = '<p><em>Terima kasih kerana membaca artikel ini!</em></p>';
        $content .= $custom_text;
    }
    return $content;
}
// 使用‘the_content’过滤器，注意这是一个过滤器（Filter）的例子
add_filter('the_content', 'add_custom_footer_to_content');

Seperti yang ditunjukkan dalam kod di atas, kita sebenarnya menggunakan penapis (filter). Hook penapis digunakan untuk mengubah data yang dihantar kepadanya. Perbezaan utama antara penapis dan tindakan (action) adalah penapis mesti mengembalikan nilai yang telah diubah. Contoh penapis yang biasa termasuk…the_content(Perubahan kandungan artikel)the_title(ubah tajuk) Danexcerpt_length(Pinda panjang ringkasan.) Yang setara dengannya...add_filter()Fungsi ini digunakan untuk memuatkan (mount) fungsi penapis (filter functions).

Mencipta hook tersuai untuk orang lain mengembangkannya

Sebuah plugin yang direka dengan baik bukan sahaja menggunakan hook teras WordPress, tetapi juga menyediakan hook khusus sendiri agar pembangun lain dapat mengembangkan plugin tersebut.do_action()Fungsi tersebut boleh mencipta sebuah “action hook” (pautan tindakan), yang boleh digunakan untuk…apply_filters()Boleh membuat satu penyesuaian (filter hook).

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

Sebagai contoh, sebelum plugin anda memproses data tertentu, sediakan sebuah penapis yang membenarkan orang lain untuk mengubah parameter input:

// 定义插件的主要处理函数
function my_plugin_process_data($input_data) {
    // 在核心处理前，允许其他开发者通过过滤器修改 $input_data
    $filtered_data = apply_filters('my_plugin_filter_input', $input_data);

// ... 使用 $filtered_data 进行核心处理 ...

// 在处理完成后，触发一个动作钩子，通知其他开发者
    do_action('my_plugin_after_processing', $filtered_data);

return $result;
}

Dengan mencipta pengaitan (hooks) yang disesuaikan, plugin anda menjadi lebih mudah untuk diperluas (scalable), dan ini selaras dengan falsafah pembangunan WordPress itu sendiri.

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

Tambahkan halaman pengurusan dan pilihan tetapan untuk plugin tersebut.

Kebanyakan plugin yang berguna memerlukan antara muka pengurusan pentas belakang (backend management interface) agar pentadbir laman web dapat mengkonfigurasi tetapan plugin tersebut. WordPress menyediakan API yang kaya untuk membuat menu pengurusan dan halaman tetapan.

Pertama sekali, anda perlu menggunakanadd_action('admin_menu', 'your_function')Gunakan fungsi yang sesuai untuk mendaftar item menu.add_menu_page()或add_submenu_page()Fungsi untuk menambah menu utama atau sub-menu. Berikut adalah contoh asas untuk menambah menu utama dan mengatur halaman:

// 钩入 admin_menu 来添加管理菜单
function my_plugin_add_admin_menu() {
    add_menu_page(
        '我的插件设置',           // 页面标题
        '我的插件',               // 菜单标题
        'manage_options',         // 权限（管理员）
        'my-plugin-settings',     // 菜单slug
        'my_plugin_settings_page', // 用于显示页面内容的回调函数
        'dashicons-admin-generic', // 图标（Dashicon）
        80                         // 菜单位置
    );
}
add_action('admin_menu', 'my_plugin_add_admin_menu');

// 定义设置页面的显示内容
function my_plugin_settings_page() {
    // 检查用户权限
    if (!current_user_can('manage_options')) {
        return;
    }
    ?>
    <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
            // 输出设置字段和非ce字段
            settings_fields('my_plugin_options_group');
            do_settings_sections('my-plugin-settings');
            submit_button('保存设置');
            ?>
        <input type="hidden" name="trp-form-language" value="ms"/></form>
    </div>
    &lt;?php
}

Medan tetapan pendaftaran dan pengesahan

Hanya mempunyai halaman web sahaja tidak mencukupi; anda perlu menggunakan WordPress Settings API untuk mendaftar, menyimpan, dan mengesahkan pilihan tetapan dengan selamat. Proses ini melibatkan penggunaan…register_setting()、add_settings_section()和add_settings_field()Fungsi-fungsi seperti itu.

Kod di bawah menunjukkan cara untuk mendaftar satu kumpulan pilihan tetapan (setting options) dan satu bidang teks (text field):

// 初始化插件设置
function my_plugin_settings_init() {
    // 注册一个设置选项组及其数据
    register_setting(
        'my_plugin_options_group', // 选项组名，需与settings_fields()参数一致
        'my_plugin_settings',      // 存储在wp_options表中的选项名
        'my_plugin_sanitize_input' // 可选的验证回调函数
    );

// 添加一个设置区域
    add_settings_section(
        'my_plugin_section_main',
        '主要设置',
        null, // 区域描述的回调函数，可为空
        'my-plugin-settings' // 所属页面的slug
    );

// 向该区域添加一个具体的字段
    add_settings_field(
        'my_plugin_field_text',
        '示例文本字段',
        'my_plugin_field_text_render', // 渲染字段HTML的回调函数
        'my-plugin-settings',
        'my_plugin_section_main'
    );
}
add_action('admin_init', 'my_plugin_settings_init');

// 渲染文本输入字段的函数
function my_plugin_field_text_render() {
    $options = get_option('my_plugin_settings');
    $value = $options['text_field'] ?? ''; // PHP 7.0+ 空合并运算符
    ?>
    <input type='text' name='my_plugin_settings[text_field]' value='<?php echo esc_attr($value); ?>'>
    <?php
}

// 清理和验证输入的函数
function my_plugin_sanitize_input($input) {
    $sanitized_input = [];
    if (isset($input['text_field'])) {
        // 清理文本输入，移除非法标签
        $sanitized_input['text_field'] = sanitize_text_field($input['text_field']);
    }
    return $sanitized_input;
}

Melalui API Settings, WordPress akan mengurus penyimpanan pilihan, pengesahan keselamatan, dan pemeriksaan hak akses secara automatik, yang sangat memudahkan proses pembangunan dan meningkatkan keselamatan sistem.

RINGKASAN

Melalui panduan ini, kita telah melalui langkah-langkah utama dalam pembangunan plugin WordPress secara sistematik: daripada membina persekitaran, membuat fail asas plugin, hingga memahami dan menggunakan mekanisme hook yang terdapat dalam WordPress, serta menambahkan antara muka pengurusan yang profesional dan pilihan tetapan untuk plugin tersebut. Setiap langkah telah menunjukkan segmen kod kritikal dan amalan standard. Inti pembangunan plugin adalah menggunakan sistem hook yang luas tersedia dalam WordPress untuk memperluas fungsi, sambil mematuhi spesifikasi API untuk memastikan keselamatan dan keserasian. Ingatlah, bermula dengan idea yang simple, menambahkan fungsi secara beransur-ansur, dan melakukan ujian yang menyeluruh sepanjang proses pembangunan adalah cara yang berkesan untuk mencipta plugin yang berkualiti tinggi. Selanjutnya, anda boleh meneroka topik-topik yang lebih lanjut, seperti membuat jenis artikel yang khusus, menambahkan kod pendek (Shortcode), mengendalikan permintaan AJAX, serta menginternasionalisasikan plugin anda.

FAQ - Soalan Lazim

Adakah anda perlu mahir dalam PHP untuk mengembangkan plugin WordPress?

Ya, memiliki asas PHP yang kukuh adalah penting. Ini kerana kod asas WordPress dan semua pluginnya ditulis dalam PHP. Anda perlu memahami sintaks PHP, fungsi, konsep pengaturcaraan berorientasikan objek, dan sebagainya. Pemahaman asas tentang HTML, CSS, dan JavaScript juga sangat membantu dalam mencipta antara muka pengguna (user interface) dan interaksi yang baik.

Berapa banyak fail yang harus dimasukkan ke dalam sebuah plugin?

Tidak ada keperluan yang wajib. Sebuah plugin boleh hanya mengandungi satu fail utama PHP. Namun, apabila fungsi-fungsi menjadi lebih kompleks, lebih baik untuk memodulkan kod ke dalam beberapa fail yang berbeza.admin.phpMenangani bahagian belakang (backend).public.phpMenangani bahagian hadapan (front end).includesMenyimpan fungsi-fungsi umum dalam folder adalah amalan yang lebih baik, kerana ia membantu mengatur dan menyelenggara kod dengan lebih mudah.

Mengapa plugin saya menyebabkan laman web menjadi kosong (white screen) setelah diaktifkan?

Ini biasanya disebabkan oleh ralat fatal (Fatal Error), seperti ralat tatabahasa, panggilan fungsi atau kelas yang tidak wujud. Pastikan anda telah…wp-config.phpIa telah diaktifkan.WP_DEBUGModel, dan periksa.wp-content/debug.logMaklumat ralat dalam fail tersebut. Anda boleh memulihkan akses ke laman web dengan cepat dengan mematikan plugin anda melalui FTP atau pengurus fail (dengan mengganti nama folder plugin tersebut).

Bagaimanakah untuk mengendalikan data yang dihantar oleh pengguna melalui bahagian frontend dengan selamat?

Anda tidak boleh mempercayai data yang dimasukkan oleh pengguna. Sebelum memproses sebarang data yang datang dari borang, parameter URL, atau Cookie, data tersebut mesti disahkan, dibersihkan, dan di-escape. WordPress menyediakan banyak fungsi keselamatan untuk membantu ini.sanitize_text_field()(Pembersihan teks)esc_url()(Escaped URL)wp_kses_post()(Filter the content using the allowed HTML tags) danintval()(Konversi ke nombor bulat). Semasa mengeluarkan data ke halaman HTML, pastikan untuk menggunakan...esc_html()、esc_attr()Fungsi seperti ini digunakan untuk melakukan proses “escape” (pengelakkan kesilapan atau penggunaan simbol yang tidak dijangka dalam kod).

Bagaimana untuk menjadikan teks dalam plugin saya menyokong berbilang bahasa?

Ini perlu dilakukan melalui proses internasionalisasi (i18n). Dalam kod anda, gantilah semua rentetan yang perlu diterjemahkan dengan…__()或_e()Pengemasan fungsi. Kemudian, tetapkan dengan betul dalam ulasan di bahagian atas plugin.Text Domain和Domain PathGunakan alat seperti Poedit untuk membuatnya..potFail templat, dan jana versi berbeza dalam bahasa yang diinginkan untuknya..po和.moFail terjemahan akan dimuat turun secara automatik oleh WordPress berdasarkan tetapan bahasa laman web tersebut.