Panduan Permulaan Pembangunan Plugin WordPress: Buat Plugin Pertama Anda Dari Kosong

WordPress merupakan sistem pengurusan kandungan (Content Management System/CMS) yang paling popular di dunia, dan keupayaannya untuk diperluas (scalability) yang tinggi sebahagian besarnya disebabkan oleh arkitektur plugin-nya. Apabila anda mendapati bahawa fungsi-fungsi sedia ada tidak memenuhi keperluan anda, mengembangkan plugin sendiri menjadi pilihan terbaik. Ini bukan sahaja dapat menyelesaikan masalah tertentu, tetapi juga merupakan cara yang sangat baik untuk memahami dengan lebih mendalam mekanisme kerja asas WordPress. Panduan ini akan membimbing anda melalui proses penuh dalam mengembangkan plugin WordPress yang pertama, daripada persiapan persekitaran, penulisan kod, hingga ke pelancaran akhir.

Pengaturcaraan persekitaran dan persiapan alat

Sebelum anda mula menulis kod, anda memerlukan persekitaran pembangunan yang sesuai. Ini akan memastikan proses pembangunan anda berjalan dengan cekap dan selaras dengan amalan terbaik WordPress.

Pembinaan persekitaran pembangunan tempatan

Pilihan terbaik adalah untuk membina persekitaran pelayan setempat pada komputer anda sendiri. Anda boleh menggunakan alat seperti XAMPP, MAMP (untuk Mac), WAMP (untuk Windows), atau Docker yang lebih fleksibel. Paket-paket ini mengintegrasikan pelayan Apache, pangkalan data MySQL, dan PHP, sehingga dapat meniru keadaan operasi WordPress secara dalam talian dengan sempurna. Setelah pelayan setempat dipasang, muat turun versi terkini WordPress dari laman web rasmi WordPress.org, dan lengkapi konfigurasinya mengikut prosedur standard “Pemasangan dalam 5 Minit”.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan Permulaan Pembangunan Plugin WordPress: Bina Plugin Fungsi Pertama Anda Dari Kosong。

Pengedit kod dan alat-alat yang diperlukan

Sebuah editor kod yang berkuasa adalah sangat penting. Visual Studio Code,PhpStorm, atau Sublime Text semuanya merupakan pilihan yang cemerlang, kerana ia menyediakan ciri-ciri seperti penyorotan sintaks, cadangan kod yang pintar, dan fungsi untuk membetulkan ralat (debugging). Selain itu, anda juga memerlukan sistem kawalan versi, seperti Git, untuk mengurus perubahan pada kod anda. Walaupun plugin pertama mungkin kelihatan mudah, tetapi membiasakan diri menggunakan sistem kawalan versi adalah sangat penting untuk pembangunan masa depan.

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

Cipta fail plugin pertama anda.

Setiap plugin WordPress bermula dengan sebuah fail utama, yang mengandungi maklumat penunjuk (header comments) yang diperlukan agar WordPress dapat mengenali plugin tersebut.

Struktur fail utama plugin

Dalam direktori pemasangan WordPress tempatan anda, masuk ke dalamnya.wp-content/pluginsFolder. Buat folder baru di sini dan berikan nama ia sebagai…my-first-plugin(Nama harus ringkas dan mampu menggambarkan fungsi plugin tersebut.) Dalam folder ini, buat sebuah fail PHP yang biasanya mempunyai nama yang sama dengan folder tersebut:my-first-plugin.phpFail ini akan menjadi titik masuk untuk plugin tersebut.

Menulis maklumat kepala untuk plugin

Di awal fail utama ini, anda mesti menambahkan sebuah ulasan kepala plugin yang mematuhi standard WordPress. Ulasan ini memberikan maklumat asas tentang plugin tersebut. Berikut adalah contoh yang paling 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
 */

Kod ini merupakan “kad pengenalan” bagi plugin tersebut.Plugin NameIni adalah item wajib, kerana ia menentukan nama plugin yang akan dipaparkan di antara muka pengurusan WordPress. Maklumat lain seperti deskripsi dan nombor versi juga disyorkan diisi dengan lengkap. Selepas menyimpan fail tersebut, masuk ke halaman “Plugins” di panel pentadbiran WordPress, anda sepatutnya dapat melihat “My First Plugin” dalam senarai plugin dan boleh mengaktifkannya. Buat masa ini, plugin ini tidak mempunyai sebarang fungsi.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan Lengkap Pembangunan Plugin WordPress: Bangun Plugin Fungsi Pertama Anda Dari Kosong。

Menambahkan fungsi asas untuk plugin

Setelah plugin diaktifkan, kami akan menambahkan dua fungsi asas kepadanya: menambahkan teks khusus di akhir kandungan artikel, dan membuat halaman pengurusan yang mudah.

Menggunakan “hook” untuk mengubah kandungan artikel

Mekanisme teras WordPress adalah “Hook” (Pengait), yang membenarkan anda memasukkan kod anda pada titik masa yang tertentu. Hook Aksi (Action Hooks) digunakan untuk melaksanakan sesuatu tindakan, manakala Hook Penapisan (Filter Hooks) digunakan untuk mengubah data. Kita ingin menambahkan satu baris teks di akhir kandungan artikel, dan ini memerlukan penggunaan Hook.the_contentFilter hook ini.
Di bawah ulasan pada bahagian atas fail plugin utama anda, tambahkan fungsi dan hook berikut:

// 在文章内容末尾添加自定义文本
function myfp_add_footer_text( $content ) {
    // 仅在主循环的单篇文章页面添加
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $custom_text = '<p><em>Terima kasih kerana membaca! Artikel ini dihasilkan oleh “My First Plugin”.</em></p>';
        $content .= $custom_text;
    }
    return $content;
}
// 将函数挂载到‘the_content’过滤器上
add_filter( 'the_content', 'myfp_add_footer_text' );

Setelah menyimpan fail tersebut, muat semula halaman artikel pada bahagian hadapan laman web, dan anda akan melihat teks yang telah ditambahkan di bahagian bawah kandungan artikel tersebut. Dalam kod ini…myfp_add_footer_textFungsi tersebut menerima data yang asal (original data).$contentSetelah memeriksa syarat-syarat halaman, teks paragraf HTML yang disesuaikan telah ditambahkan di akhir, dan kemudian kandungan yang telah diubah suai telah dikembalikan.add_filter()Fungsi tersebut menghubungkan fungsi kustom kita dengan penapis asas (core filters) WordPress.

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

Membuat menu pengurusan yang ringkas

Seterusnya, kita akan membuat halaman tetapan untuk plugin tersebut di bahagian belakang WordPress (backend). Ini melibatkan penggunaan “action hooks” untuk menambahkan item baru ke menu pentadbiran. Masukkan kod berikut:

// 在后台管理菜单中添加一个新页面
function myfp_add_admin_menu() {
    add_menu_page(
        '我的第一个插件设置', // 页面标题
        '我的插件',           // 菜单标题
        'manage_options',     // 所需权限
        'my-first-plugin',    // 菜单slug
        'myfp_admin_page_html', // 用于输出页面内容的回调函数
        'dashicons-admin-generic', // 图标（可选）
        100                   // 菜单位置
    );
}
add_action( 'admin_menu', 'myfp_add_admin_menu' );

// 定义管理页面的HTML内容
function myfp_admin_page_html() {
    // 检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1><?php echo esc_html( get_admin_page_title() ); ?></h1>
        <p>Selamat datang ke halaman tetapan untuk “Plugin Pertama Saya”. Ini adalah permulaan yang baik!</p>
    </div>
    &lt;?php
}

Simpan dan segar semula laman belakang WordPress. Anda sepatutnya melihat pilihan menu baru “My Plugins” berhampiran bahagian bawah bar menu sebelah kiri. Klik pada pilihan tersebut untuk masuk ke halaman tetapan yang mudah. Di sini,add_menu_page()Fungsi tersebut bertanggungjawab untuk mendaftarkan halaman menu utama.myfp_admin_page_html()Fungsi tersebut bertanggungjawab untuk merender kandungan HTML halaman tersebut.

Keselamatan plugin dan pengoptimuman kod

Ketika mengembangkan plugin, keselamatan dan kebolehpenyelenggaraan merupakan aspek yang perlu diambil kira sejak awal.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Bermula dari kosong: Mengapa memilih pembangunan plugin WordPress?。

Pemverian Data dan Penyisihan (Data Validation and Escaping)

Jangan pernah mempercayai data yang dimasukkan oleh pengguna atau data dari luaran. Sebelum mana-mana data dihantar ke browser atau disimpan ke dalam pangkalan data, ia mesti diproses terlebih dahulu. WordPress menyediakan banyak fungsi bantuan untuk tujuan ini. Sebagai contoh, apabila anda ingin menghantar data ke dalam atribut HTML, gunakan fungsi yang sesuai.esc_attr(); Apabila mengeksport ke teks HTML, gunakan <esc_html()Ketika menghantar kandungan ke URL, gunakan format yang sesuai.esc_url()Dalam yang sebelumnya…myfp_admin_page_html()Dalam fungsi tersebut, kami telah menggunakan…esc_html()Keluarkan tajuk halaman dengan selamat.

Gunakan kelas untuk mengatur kod.

Seiring dengan peningkatan jumlah fungsi dalam plugin, meletakkan semua fungsi dalam ruang nama global (global namespace) boleh menyebabkan konflik dan kekacauan. Menggunakan kelas PHP untuk mengemas fungsi-fungsi plugin merupakan amalan yang baik. Ini dapat meningkatkan organisasi kod, kebolehbacaan, dan kebolehgunaan semula kod tersebut. Berikut adalah rangka asas untuk menulis semula fungsi-fungsi kita yang sebelumnya menggunakan kelas:

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

class My_First_Plugin {
    // 构造方法，用于初始化钩子
    public function __construct() {
        add_filter( 'the_content', array( $this, 'add_footer_text' ) );
        add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
    }

public function add_footer_text( $content ) {
        // ... 函数实现同上 ...
    }

public function add_admin_menu() {
        // ... 函数实现同上 ...
    }

public function admin_page_html() {
        // ... 函数实现同上 ...
    }
}
// 实例化插件类
new My_First_Plugin();

Dengan cara ini, semua kaedah dan atribut yang berkaitan dibungkuskan dalam satu objek, menjadikan strukturnya lebih jelas.

RINGKASAN

Dengan panduan ini, anda telah melaksanakan langkah-langkah asas dalam membuat plugin WordPress dari awal: membina persekitaran, mencipta fail plugin dengan maklumat header standard, menggunakan hook tindakan (action hooks) dan hook penapisan (filter hooks) untuk menambahkan fungsi pada kandungan artikel, serta membuat antara muka pengurusan. Anda juga telah memahami kepentingan keselamatan dan pengaturan kod yang baik. Ini hanyalah titik permulaan; dunia pembangunan plugin WordPress sangat luas, dan anda boleh meneroka lebih banyak ciri lanjutan seperti kod pendek (Shortcode), widget, jenis artikel khusus (Custom Post Type), dan titik akhir API REST. Ingatlah bahawa membaca kod sumber, mempelajari cara plugin yang baik dilaksanakan, serta merujuk kepada dokumentasi pembangun rasmi adalah cara terbaik untuk terus meningkatkan kemahiran anda.

FAQ - Soalan Lazim

Apakah teknik yang perlu dikuasai untuk mengembangkan plugin?

Untuk mengembangkan plugin WordPress, anda perlu menguasai asas-asas PHP, HTML, CSS, dan JavaScript. PHP merupakan komponen utama kerana WordPress sendiri ditulis dalam bahasa PHP, dan anda perlu menggunakannya untuk menulis logik plugin tersebut. HTML/CSS digunakan untuk membina antara muka pengguna (front-end), manakala JavaScript (terutamanya jQuery dan versi terkini seperti ES6+) boleh digunakan untuk meningkatkan interaktiviti dan membuat permintaan AJAX. Pengetahuan asas tentang MySQL juga berguna untuk mengurus data.

Mengapa plugin saya tidak dipaparkan di latar belakang (background)?

Sila periksa perkara berikut terlebih dahulu: 1. Adakah fail utama plugin telah diletakkan di tempat yang sepatutnya?wp-content/pluginsDalam folder berasingan di dalam direktori tersebut. 2. Notasi pada bahagian kepala plugin untuk fail utama (terutamanya)...Plugin Name:Formatnya adalah betul dan tidak mengandungi kesilapan. 2. Pengekodan fail adalah UTF-8 tanpa BOM. 3. Terdapat kesilapan sintaks yang menyebabkan PHP tidak dapat menganalisisnya. Anda boleh menyemak log debug WordPress untuk mengesahkannya.wp-config.phpAktifkan di sini.WP_DEBUG）。

Bagaimana untuk menguji plugin tanpa mempengaruhi laman web dalam talian?

Saya sangat mengesyorkan agar pembangunan dan ujian plugin dilakukan dalam persekitaran pembangunan tempatan (seperti Local by Flywheel, XAMPP) atau pelayan ujian yang berasingan (Staging Site). Jangan sekali-kali menguji plugin baru yang belum disahkan terus pada laman web produksi yang sedang beroperasi dan mengandungi data penting. Gunakan alat kawalan versi (seperti Git) untuk mengurus kod, supaya anda dapat dengan mudah kembali ke versi sebelumnya sekiranya berlaku masalah.

Bagaimanakah plugin harus diperbaharui kepada versi yang lebih baru?

Anda sepatutnya mengemaskini dalam ulasan di bahagian atas fail utama plugin tersebut.Version:Untuk kemaskini besar, adalah dinasihatkan untuk mengikuti kawalan versi semantik (SemVer). Sebagai contoh, untuk membaiki pepijat, tambahkan nombor pindaan (1.0.1); untuk fungsi baharu yang kompatibel dengan versi sebelumnya, tambahkan nombor subversi (1.1.0); dan untuk kemaskini yang tidak kompatibel, tambahkan nombor versi utama (2.0.0). Anda juga boleh melaksanakan mekanisme pengesanan kemaskini (seperti menjadi hos maklumat plugin pada pelayan sendiri atau dalam direktori plugin WordPress) supaya pengguna boleh menerima pemberitahuan kemaskini secara latar belakang.

Apa syarat-syarat yang diperlukan untuk menerbitkan plugin ke dalam direktori rasmi?

Jika anda ingin menyerahkan plugin ke direktori plugin rasmi WordPress.org, anda perlu memenuhi syarat-syarat utama berikut: kod plugin mesti serasi dengan lesen GPLv2 atau lebih tinggi; kualiti kod mesti memenuhi standard; fungsi mesti bersifat universal dan praktikal, dan bukan disesuaikan untuk laman web tertentu; tidak boleh mengandungi kod berniat jahat atau pautan spam. Sebelum menyerahkan, pastikan anda telah membaca panduan dan syarat-syarat pengemukan secara terperinci di “Pusat Pembangun” direktori rasmi.