Panduan Pengembangan Plugin WordPress: Membuat Plugin Kustom Pertama Anda Dari Nol

Lingkungan pengembangan dan persiapan dasar.

Sebelum mulai menulis kode, memiliki lingkungan pengembangan lokal yang stabil dan efisien sangat penting. Untuk pengembangan plugin WordPress, kami merekomendasikan penggunaan lingkungan terintegrasi seperti XAMPP, MAMP, atau Local by Flywheel, yang dapat menginstal Apache, MySQL, dan PHP dengan satu klik, sehingga menghindari proses konfigurasi yang rumit. Pastikan bahwa versi PHP Anda tidak lebih rendah dari 7.4 dan versi MySQL tidak lebih rendah dari 5.6, untuk memenuhi persyaratan lingkungan terbaru yang direkomendasikan oleh WordPress.

Selanjutnya, Anda memerlukan sebuah editor kode. Visual Studio Code, PhpStorm, atau Sublime Text merupakan pilihan yang sangat baik, karena ketiganya menyediakan fitur penyorotan sintaks, saran kode (code hints), dan alat debugging yang dapat sangat meningkatkan efisiensi pengembangan. Selain itu, instal juga alat pengelolaan versi (version control tool) seperti Git untuk mengelola sejarah perubahan kode Anda; ini merupakan praktik standar dalam pengembangan modern.

Memahami struktur dasar plugin WordPress adalah langkah pertama. Plugin yang paling sederhana pun setidaknya memuat satu file PHP utama, di mana komentar di bagian awal file tersebut berfungsi sebagai “kartu identitas” plugin, yang digunakan untuk memberitahu sistem WordPress tentang informasi plugin tersebut. File ini dapat berdiri sendiri, atau dapat juga berfungsi sebagai titik masuk ke dalam direktori plugin yang lebih kompleks.

推荐阅读 Pengembangan Plugin WordPress: Dari Pemula Hingga Ahli: Membangun Plugin Kustom Pertamamu。

Buatlah file plugin pertamamu.

Mari kita mulai dengan membuat plugin yang paling sederhana. Pertama-tama, masuk ke direktori instalasi WordPress lokal Anda.wp-content/pluginsFolder. Di sini, buatlah sebuah folder baru dengan nama…my-first-pluginSemua file yang terkait dengan plugin akan diletakkan di dalam direktori ini.

UltaHost – Hosting untuk WordPress

Jaminan pengembalian uang dalam 30 hari, bandwidth dan basis data yang tidak terbatas, perlindungan DDoS gratis, diskon 50% untuk pembelian selama 3 tahun (dari harga normal: 50%).

halaman akses

Dalam folder tersebut, buatlah sebuah file PHP utama, misalnya dengan nama “main.php”.my-first-plugin.phpBagian awal (header) dari file ini harus memuat blok komentar yang berisi informasi tentang plugin tertentu. Berikut adalah contoh standarnya:

<?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 komentar ini, “Nama Plugin” merupakan kolom wajib yang harus diisi. WordPress membutuhkannya untuk mengenali dan menampilkan plugin Anda di daftar plugin di backend. Informasi lain seperti versi, penulis, dan sebagainya membantu pengguna memahami detail plugin tersebut. Setelah menyimpan file, masuklah ke backend WordPress Anda, lalu kunjungi halaman “Plugins”. Anda seharusnya dapat melihat “My First Plugin” muncul di daftar plugin, dan Anda dapat mengaktifkan atau menonaktifkannya. Saat ini plugin tersebut belum memiliki fungsi apa pun, tetapi Anda telah berhasil membuat kerangka plugin yang sah.

Menambahkan fitur inti ke plugin

Sebuah plugin yang telah diaktifkan perlu menggunakan mekanisme hook dari WordPress untuk menjalankan kode. Ada dua jenis hook: Action Hooks dan Filter Hooks. Action Hooks memungkinkan Anda untuk menyisipkan kode pada titik waktu tertentu untuk menjalankan fungsi tertentu, sedangkan Filter Hooks memungkinkan Anda untuk memodifikasi data yang dilewatkan selama proses tersebut.

Gunakan action hook untuk menambahkan menu administrasi.

Agar pengguna dapat berinteraksi dengan plugin, kita biasanya perlu menambahkan halaman pengaturan di backend WordPress. Hal ini dapat dilakukan dengan…add_action()Function mounted toadmin_menuAksi ini diimplementasikan menggunakan hook (pengait fungsi).

推荐阅读 Panduan Akhir Pengembangan Plugin WordPress: Membuat Plugin Kustom Pertama Dari Nol。

Pertama-tama, kita mendefinisikan sebuah fungsi dalam berkas plugin utama, yang berfungsi untuk menghasilkan konten HTML halaman pengaturan. Fungsi ini dapat diberi nama…mfp_settings_page_htmlKemudian, kita membuat fungsi lainnya, misalnya…mfp_add_admin_menuDi dalamnya, WordPress digunakan.add_menu_page()Fungsi ini digunakan untuk mendaftarkan sebuah item menu tingkat atas yang baru. Akhirnya, gunakan…add_action('admin_menu', 'mfp_add_admin_menu')Menggantungkan fungsi pendaftaran ke sistem.

Menggunakan filter hook untuk mengubah isi artikel

Selain fungsi di latar belakang, plugin lebih sering digunakan untuk mengubah konten tampilan (frontend) sebuah situs web. Misalnya, kita dapat menambahkan pernyataan hak cipta secara otomatis di akhir setiap artikel. Hal ini memerlukan penggunaan plugin tertentu.the_contentFilter hook ini…

Kita mendefinisikan sebuah fungsi, misalnya dengan nama…mfp_add_copyright_to_contentFungsi tersebut menerima sebuah parameter, yaitu isi artikel asli, dan menambahkan teks HTML khusus di akhirnya. Setelah itu, proses selanjutnya dilakukan melalui…add_filter('the_content', 'mfp_add_copyright_to_content')Daftarkan fungsi ini sebagai filter. Dengan demikian, setiap kali WordPress memanggil konten artikel, konten tersebut akan terlebih dahulu diproses oleh fungsi kita, lalu informasi hak cipta akan ditambahkan sebelum akhirnya ditampilkan.

hosting.com hosting bersama

Kinerja tinggi, dilengkapi dengan CPU AMD EPYC, penyimpanan SSD NVMe, dan LiteSpeed, dukungan internal ahli 24 jam sehari, langkah-langkah keamanan canggih termasuk SSL, brute force, malware, dan perlindungan DDoS, menghemat hingga 731 TB/bulan.

halaman akses

Keamanan, optimisasi, dan pengelolaan plugin

Mengembangkan fitur hanyalah langkah pertama; memastikan keamanan dan kinerja plugin juga sama pentingnya. Semua data yang dimasukkan oleh pengguna harus melalui proses verifikasi yang ketat, pengolahan (escaping), dan pembersihan sebelum dimasukkan ke dalam basis data atau ditampilkan di halaman web. WordPress menyediakan berbagai fungsi keamanan yang berguna untuk hal ini.sanitize_text_field()(Cleaning the text)esc_html()(Escaped HTML) danwp_kses()(Izin untuk menggunakan tag HTML tertentu; pastikan untuk menggunakannya di tempat yang tepat.)

Untuk meningkatkan kemudahan pemeliharaan dan kinerja plugin, disarankan untuk mengikuti prinsip-prinsip pemrograman berorientasi objek (Object-Oriented Programming/OOP) dalam mengorganisir kode, dengan mengemas fungsi-fungsi dalam kelas-kelas yang terstruktur. Selain itu, gunakan API cache sementara (Transients API) dari WordPress dengan bijak untuk menyimpan hasil pencarian yang membutuhkan waktu lama atau data yang diperoleh dari permintaan jarak jauh, sehingga tidak perlu dihitung ulang setiap kali halaman dibuka.

Setelah fitur plugin Anda telah diperbaiki dan lulus pengujian, Anda dapat mempertimbangkan untuk merilisnya. Anda perlu menyiapkan dokumen atau materi promosi yang jelas dan ringkas untuk menjelaskan keunggulan plugin tersebut kepada pengguna.readme.txtFile tersebut harus disusun dalam format yang sesuai dengan persyaratan WordPress.org, dan berisi deskripsi fungsi plugin, cara instalasi, catatan pembaruan (update logs), serta jawaban untuk pertanyaan-pertanyaan umum. Jika Anda ingin mengirimkan plugin tersebut ke direktori plugin resmi WordPress, Anda perlu membuat repositori SVN dan mengikuti standar kode serta panduan pengiriman yang ditetapkan oleh WordPress. Untuk plugin komersial, Anda juga perlu membangun server khusus untuk penjualan dan pembaruan plugin tersebut.

推荐阅读 Menguasai sepenuhnya pengembangan plugin WordPress: Membangun fitur khusus dari nol。

Menyimpulkan.

Dengan panduan ini, kita telah menempuh jalur utama dalam pengembangan plugin WordPress: mulai dari membangun lingkungan pengembangan, membuat struktur file dasar, hingga memberikan “kehidupan” pada plugin dengan menggunakan mekanisme aksi (actions) dan filter hooks, serta akhirnya memperhatikan aspek keamanan, optimisasi, dan persiapan untuk pengunggahan plugin ke situs web. Esensi dari pengembangan plugin adalah memperluas fungsi-fungsi inti WordPress, dan mekanisme hooks merupakan jembatan yang menghubungkan kode yang Anda tulis dengan sistem WordPress itu sendiri. Setelah memahami dasar-dasar ini, Anda dapat mengeksplorasi API yang lebih kompleks dan berbagai kemungkinan lainnya dengan membaca dokumentasi resmi plugin serta kode inti WordPress, sehingga Anda dapat membuat plugin yang kuat, aman, dan populer di kalangan pengguna.

FAQ - Pertanyaan yang Sering Diajukan.

Apa saja file yang harus dimiliki oleh sebuah plugin?

Plugin yang paling sederhana hanya perlu berisi satu file PHP yang memiliki komentar header yang benar. Namun, seiring dengan meningkatnya kompleksitas fungsionalitas, plugin tersebut biasanya akan mencakup beberapa file PHP, JavaScript, CSS, sumber daya gambar, serta berbagai komponen lainnya.readme.txtFile penjelasan. File PHP utama yang menjadi inti dari aplikasi sangat diperlukan.

Hosting bersama InterServer.

Hosting bersama seharga $2,50 USD per bulan, diskon $0,1 USD untuk bulan pertama dengan kode promo tryinterserver, serta 461 skrip aplikasi cloud yang dapat diinstal dengan sekali klik.

halaman akses

Bagaimana cara menghindari konflik antara plugin saya dengan plugin lainnya?

Menambahkan prefiks unik untuk semua nama fungsi, kelas, konstanta, dan variabel global merupakan praktik terbaik untuk menghindari konflik penamaan. Umumnya, singkatan dari plugin atau nama tertentu digunakan sebagai prefiks tersebut.mfp_或my_plugin_Pada saat yang sama, mengenkapsulasi kode dalam kelas juga dapat secara efektif memisahkan ruang lingkup (scope) dari berbagai komponen program.

Bagaimana cara menambahkan opsi pengaturan yang dapat dikonfigurasi untuk sebuah plugin?

Disarankan untuk menggunakan WordPress Settings API untuk membuat halaman pengaturan yang aman dan terstandarisasi. API ini menyediakan fungsi-fungsi untuk mendaftarkan pengaturan, menambahkan bidang pengaturan, serta bab-bab tertentu dalam halaman pengaturan. Selain itu, API ini dapat secara otomatis menangani proses penyimpanan, validasi data pengguna, dan validasi menggunakan mekanisme NonCE (Non-Cross-Site Request Forgery). Penggunaan API ini jauh lebih efisien dibandingkan jika semua proses dilakukan secara manual.$_POSTData menjadi jauh lebih aman dan lebih mudah diakses.

Bagaimana cara mendeteksi dan memperbaiki kesalahan (error) dalam plugin saat proses pengembangan?

Pertama-tama, pastikan bahwa…wp-config.phpMode debug WordPress telah diaktifkan dalam file tersebut.WP_DEBUGKonstanta diatur ketrueSelain itu, Anda juga dapat menginstal dan mengaktifkan plugin debugging profesional seperti Query Monitor. Plugin ini dapat membantu Anda melihat hasil kueri database, eksekusi kode (hook), kesalahan PHP, serta titik-titik kendala (performance bottlenecks), sehingga menjadi alat yang sangat penting dalam proses pengembangan.