Panduan Pembangunan Plugin WordPress: Dari Kosong Ke Sifar, Cipta Plugin Custom Pertama Anda

Persekitaran pembangunan dan persediaan asas.

Sebelum mula menulis kod, sebuah persekitaran pembangunan tempatan yang stabil dan cekap adalah sangat penting. Untuk pembangunan plugin WordPress, kami mengesyorkan penggunaan persekitaran terintegrasi seperti XAMPP, MAMP, atau Local by Flywheel, yang membenarkan pemasangan Apache, MySQL, dan PHP dengan satu klik, mengelakkan proses konfigurasi yang rumit. Pastikan bahawa versi PHP anda tidak kurang dari 7.4 dan versi MySQL tidak kurang dari 5.6, untuk memenuhi keperluan persekitaran terkini yang disyorkan oleh WordPress.

Seterusnya, anda memerlukan sebuah editor kod. Visual Studio Code,PhpStorm, atau Sublime Text semuanya merupakan pilihan yang sangat baik, kerana ia menyediakan ciri-ciri seperti penyorotan sintaks, cadangan kod, dan fungsi debugging yang dapat meningkatkan kecekapan pembangunan dengan ketara. Selain itu, anda juga perlu memasang alat kawalan versi (version control tool) seperti Git untuk mengurus sejarah perubahan kod anda, yang merupakan amalan standard dalam pembangunan moden.

Memahami struktur asas plugin WordPress adalah langkah pertama. Sebuah plugin asas sekurang-kurangnya mengandungi satu fail PHP utama, di mana komen pada bahagian atas fail tersebut berfungsi sebagai “kad pengenalan” plugin tersebut, digunakan untuk memberitahu sistem WordPress tentang maklumat plugin tersebut. Fail ini boleh wujud secara berasingan, atau ia boleh menjadi titik masuk kepada direktori plugin yang lebih kompleks.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Pembangunan Plugin WordPress: Dari Permulaan Hingga Kemahiran Lanjutan: Membina Plugin Custom Pertama Anda。

Cipta fail plugin pertama anda.

Mari kita mulakan dengan mencipta plugin yang paling asas. Pertama sekali, masuk ke dalam direktori pemasangan WordPress anda yang berada di lokasi setempat.wp-content/pluginsFolder. Di sini, buatlah sebuah folder baru dan berikan nama ia…my-first-pluginSemua fail yang berkaitan dengan plugin akan diletakkan dalam direktori ini.

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

Dalam folder tersebut, buat sebuah fail PHP utama, contohnya dengan nama “main.php”.my-first-plugin.phpBahagian kepala fail ini mesti mengandungi blok komen maklumat tambahan (plugin information comments) yang khusus. Berikut adalah contoh standard:

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

Dalam ulasan ini, “Nama Plugin” adalah item wajib yang perlu diisi. WordPress bergantung pada maklumat ini untuk mengenal pasti dan menunjukkan plugin anda dalam senarai plugin di latar belakang. Maklumat lain seperti nombor versi dan pengarang membantu pengguna memahami butiran plugin tersebut. Setelah menyimpan fail, log masuk ke panel pentadbiran WordPress anda dan ke halaman “Plugins”. Anda sepatutnya dapat melihat “My First Plugin” dalam senarai plugin, dan boleh mengaktifkan atau menonaktifkannya. Buat masa ini, plugin tersebut tidak mempunyai sebarang fungsi, tetapi anda telah berjaya membuat kerangka plugin yang sah.

Menambahkan fungsi asas kepada plugin

Sebuah plugin yang telah diaktifkan perlu menggunakan mekanisme “hook” dalam WordPress untuk menjalankan kod. Terdapat dua jenis hook: Action Hooks dan Filter Hooks. Action Hooks membenarkan anda memasukkan kod pada titik masa tertentu untuk melaksanakan fungsi tertentu, manakala Filter Hooks membenarkan anda mengubah data yang dihantar semasa proses berjalan.

Gunakan “action hook” untuk menambah menu pengurusan.

Untuk membolehkan pengguna berinteraksi dengan plugin, kita biasanya perlu menambahkan halaman tetapan di bahagian belakang (backend) WordPress. Ini boleh dilakukan dengan…add_action()Function mountedadmin_menuAksion hook ini digunakan untuk melaksanakannya.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Panduan Terakhir Pembangunan Plugin WordPress: Membina Plugin Custom Pertama Dari Kosong。

Pertama sekali, kita mendefinisikan sebuah fungsi dalam fail plugin utama yang digunakan untuk mengeluarkan kandungan HTML halaman tetapan. Fungsi ini boleh diberi nama…mfp_settings_page_htmlKemudian, kita mencipta fungsi lain, sebagai contoh…mfp_add_admin_menuDi dalamnya, WordPress digunakan.add_menu_page()Fungsi ini digunakan untuk mendaftar item menu utama yang baru. Akhirnya, gunakan…add_action('admin_menu', 'mfp_add_admin_menu')Mount the registration function to the system.

Menggunakan pengait penapis (filter hook) untuk mengubah kandungan artikel

Selain daripada fungsi latar belakang, plugin sering digunakan untuk mengubah kandungan yang ditampilkan di bahagian depan laman web (front-end). Sebagai contoh, kita boleh menambahkan kenyataan hak cipta secara automatik di akhir setiap artikel. Ini memerlukan penggunaan plugin yang sesuai.the_contentFilter hook ini.

Kita mendefinisikan sebuah fungsi, contohnya dengan nama…mfp_add_copyright_to_contentIa menerima satu parameter (iaitu kandungan artikel asal), dan menambahkan teks HTML yang disesuaikan di hujungnya. Kemudian, melalui…add_filter('the_content', 'mfp_add_copyright_to_content')Daftarkan fungsi ini sebagai penapis (filter). Dengan ini, setiap kali WordPress memanggil kandungan artikel, kandungan tersebut akan diproses oleh fungsi kita terlebih dahulu, di mana maklumat hak cipta akan ditambahkan sebelum ia dipaparkan.

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

Keamanan, pengoptimuman, dan pengeluaran plugin

Membangunkan fungsi-fungsi tertentu hanyalah langkah pertama; memastikan keselamatan dan prestasi plugin juga sangat penting. Semua data yang dimasukkan oleh pengguna mesti melalui proses pengesahan yang ketat, pembebasan risiko (escaping), dan pembersihan sebelum dimasukkan ke dalam pangkalan data atau dipaparkan di halaman web. WordPress menyediakan pelbagai fungsi keselamatan yang berguna untuk tujuan ini.sanitize_text_field()(Pembersihan teks)esc_html()(Escaped HTML) danwp_kses()(Izin untuk menggunakan tag HTML yang ditentukan; pastikan ia digunakan di tempat yang sesuai.)

Untuk meningkatkan kemudahan penyelenggaraan dan prestasi plugin, disyorkan untuk mengikuti prinsip pengaturcaraan berorientasikan objek (Object-Oriented Programming/OOP) dalam mengatur kod, dengan mengemas fungsi-fungsi dalam kelas yang berkaitan. Selain itu, gunakan API caching sementara (Transients API) WordPress dengan bijak untuk menyimpan hasil carian yang memakan masa atau data yang diperoleh dari sumber jauh, bagi mengelakkan pengiraan yang berulang setiap kali halaman dimuat.

Apabila fungsi plugin anda telah diperbaiki dan lulus ujian, anda boleh mempertimbangkan untuk mengeluarkannya. Anda perlu menyediakan dokumentasi yang jelas…readme.txtFail tersebut perlu memenuhi format yang ditetapkan oleh WordPress.org, dan digunakan untuk menerangkan fungsi plugin, kaedah pemasangan, log kemas kini, serta soalan-soalan yang sering diajukan. Jika anda ingin menghantar plugin ke direktori plugin rasmi WordPress, anda perlu membuat sebuah repositori SVN dan mengikuti garis panduan pengkodan serta prosedur penghantaran yang ditetapkan. Bagi plugin komersial, anda perlu menyediakan sendiri pelayan untuk penjualan dan kemas kini plugin tersebut.

Diperoleh daripada WEB\nDisyorkan untuk membaca. Menguasai sepenuhnya pembangunan plugin WordPress: Membina ciri-ciri khusus sendiri dari awal hingga akhir。

RINGKASAN

Melalui panduan ini, kita telah melalui proses pembangunan plugin WordPress secara menyeluruh: daripada menyediakan persekitaran, mencipta struktur fail asas, hingga menggunakan mekanisme “actions” dan “filters” untuk memberikan fungsi tambahan kepada plugin, dan akhirnya memberi perhatian kepada aspek keselamatan, pengoptimuman, dan persiapan untuk penerbitan. Inti pembangunan plugin adalah untuk memperluas fungsi asas WordPress, dan mekanisme “hooks” berfungsi sebagai jambatan yang menghubungkan kod anda dengan sistem WordPress. Setelah menguasai asas-asas ini, anda boleh meneroka API yang lebih kompleks dan pelbagai kemungkinan dengan merujuk kepada manual plugin rasmi dan kod sumber WordPress, seterusnya membina plugin yang kuat, selamat, dan popular.

FAQ - Soalan Lazim

Apakah fail-fail yang mesti dimasukkan dalam sebuah plugin?

Satu plugin yang paling mudah boleh terdiri daripada hanya satu fail PHP yang mengandungi ulasan header fail yang betul. Namun, seiring dengan peningkatan kerumitan fungsinya, plugin tersebut biasanya akan merangkumi beberapa fail PHP, JavaScript, CSS, sumber gambar, dan lain-lain komponen.readme.txtFail penjelasan. Fail PHP utama yang merupakan inti program adalah penting.

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

Bagaimana untuk mengelakkan konflik antara plugin saya dengan plugin lain?

Menambahkan prefiks unik kepada semua nama fungsi, kelas, konstanta, dan variabel global adalah amalan terbaik untuk mengelakkan konflik penamaan. Biasanya, singkatan atau nama plugin digunakan sebagai prefiks.mfp_或my_plugin_Pada masa yang sama, mengapsulkan kod dalam kelas juga dapat membantu mengasingkan skop penggunaan variabel dan fungsi dengan berkesan.

Bagaimana untuk menambahkan pilihan tetapan yang boleh disesuaikan untuk sebuah plugin?

Disyorkan untuk menggunakan WordPress Settings API untuk membuat halaman tetapan yang selamat dan standard. API ini menyediakan fungsi untuk mendaftar tetapan, menambahkan bidang dan bahagian tetapan, serta mengurus proses penyimpanan, pengesahan, dan pengesahan nonce secara automatik. Ia lebih mudah dan efisien berbanding mengurusnya secara manual.$_POSTData menjadi jauh lebih selamat dan mudah diakses.

Bagaimana untuk membaiki ralat dalam plugin semasa proses pembangunan?

Pertama sekali, pastikan anda…wp-config.phpMod pembangunan (debugging mode) untuk WordPress telah diaktifkan dalam fail tersebut.WP_DEBUGKonstanta ditetapkan kepadatruePada masa yang sama, anda boleh memasang dan mengaktifkan plugin pembangunan profesional seperti Query Monitor, yang dapat membantu anda memeriksa pertanyaan pangkalan data, pelaksanaan fungsi tertentu (hook), ralat PHP, dan kekangan prestasi. Ia merupakan alat yang sangat penting dalam proses pembangunan.