Panduan Utama Pengembangan Plugin WordPress: Membangun Plugin Pertama Anda dari Nol hingga Satu.

Lingkungan pengembangan dan persiapan awal.

Sebelum memulai menulis kode apa pun, memiliki lingkungan pengembangan yang stabil dan profesional merupakan kunci keberhasilan. Pertama-tama, Anda perlu membuat lingkungan pengembangan WordPress di komputer lokal yang semirip mungkin dengan lingkungan produksi. Hal ini biasanya dapat dicapai dengan menggunakan perangkat lunak lingkungan terintegrasi seperti XAMPP atau MAMP, atau kontainer Docker yang lebih modern. Lingkungan lokal memungkinkan Anda untuk melakukan pengujian dan debugging dengan bebas, tanpa mempengaruhi situs web yang berjalan di internet.

Selanjutnya, Anda memerlukan sebuah editor kode atau lingkungan pengembangan terintegrasi (Integrated Development Environment/IDE). 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. Pastikan juga bahwa versi PHP yang Anda gunakan kompatibel dengan versi WordPress yang ingin Anda gunakan. WordPress secara resmi merekomendasikan penggunaan PHP 7.4 atau versi yang lebih baru untuk mendapatkan kinerja dan keamanan yang lebih baik.

Terakhir, dan yang sangat penting, adalah dengan memahami buku panduan resmi WordPress untuk pengembang plugin. Dokumen ini dianggap sebagai “kitab suci” dalam pengembangan plugin, karena menjelaskan secara rinci semua API inti, pedoman keamanan, dan praktik terbaik. Sebelum mulai mengkode, luangkan waktu untuk membaca bagian “Membuat Plugin” dan “Dasar-Dasar Plugin” di dalamnya; hal ini akan membantu Anda membangun fondasi yang kuat untuk proses pengembangan Anda.

推荐阅读 Panduan Lengkap Pengembangan Plugin WordPress: Dari Dasar hingga Tingkat Lanjut。

Buatlah file plugin pertamamu.

Sebuah plugin WordPress pada dasarnya merupakan satu atau lebih komponen yang terletak di dalam struktur kode aplikasi WordPress.wp-content/pluginsFile-file PHP yang terdapat dalam direktori tersebut. Setiap plugin harus memiliki sebuah file utama, yang berisi informasi header khusus untuk plugin tersebut, guna menyatakan keberadaan plugin kepada sistem WordPress.

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

Struktur file utama plugin

File utama sebuah plugin merupakan titik masuk (entry point) untuk menggunakan plugin tersebut, dan nama file tersebut biasanya sama dengan nama direktori tempat plugin berada. Contohnya:my-first-plugin.phpDi awal file ini, Anda harus menambahkan sebuah komentar header plugin yang sesuai dengan standar WordPress. Inilah satu-satunya cara bagi WordPress untuk mengenali informasi tentang plugin tersebut.

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

Setiap informasi dalam komentar ini sangat penting.Plugin NameIni merupakan kolom wajib, dan isi dari kolom tersebut akan ditampilkan dalam daftar plugin di panel administrasi WordPress.Text DomainDigunakan untuk penerjemahan internasional.Domain PathMaka, lokasi file terjemahan telah ditentukan.

Implementasi Fungsi Dasar Plugin

Setelah menyatakan header plugin, Anda dapat mulai menambahkan kode fungsional. Pendekatan yang aman dan standar adalah dengan mengenkapsulasi seluruh logika fungsional dalam fungsi atau kelas, dan memicukannya melalui sistem Hook dari WordPress. Sebagai contoh, kita dapat membuat fungsi sederhana untuk menambahkan teks di bagian bawah halaman.

// 定义一个函数，用于在页面底部输出内容
function my_first_plugin_display_footer_text() {
    echo '<p style="text-align: center; color: #666;">Terima kasih telah menggunakan plugin pertama saya!</p>';
}
// 使用 add_action 钩子将函数挂载到 ‘wp_footer’ 动作上
add_action( 'wp_footer', 'my_first_plugin_display_footer_text' );

add_action()Ini adalah sebuah fungsi inti yang digunakan untuk mengonversi fungsi kustom Anda menjadi format yang dapat digunakan oleh sistem lain atau alat tertentu.my_first_plugin_display_footer_textTerkait dengan (Bound to)wp_footerPada titik aksi yang spesifik ini, ketika WordPress menjalankan bagian kaki halaman (footer), fungsi Anda akan dipanggil secara otomatis.

推荐阅读 Panduan Lengkap Pengembangan Plugin WordPress: Membangun Plugin Profesional Dari Nol。

Mengenal Mekanisme Inti WordPress dengan Mendalam

Untuk mengembangkan plugin yang kuat dan fleksibel, Anda perlu memahami dengan mendalam dua mekanisme inti WordPress, yaitu Hook dan Filter. Kedua mekanisme ini berfungsi sebagai jembatan bagi interaksi antara plugin dengan inti WordPress serta plugin lainnya.

Penggunaan Action Hook

Action Hooks memungkinkan Anda untuk menyisipkan kode Anda sendiri pada momen-momen tertentu saat WordPress dijalankan. Misalnya, saat sebuah artikel diterbitkan, saat pengguna masuk ke akunnya, atau saat sebuah skrip diunduh. Dalam contoh di atas…wp_footerHanya sebuah “action hook” saja. Anda bisa menggunakannya.add_action()Fungsi ini digunakan untuk berlangganan (subscribe) ke berbagai “hook” (mekanisme pemanggilan fungsi secara otomatis). Fungsi tersebut menerima setidaknya dua parameter: nama hook dan fungsi penanggapan (callback function).

// 在管理后台的文章编辑页面添加一个自定义元框
function my_first_plugin_add_custom_meta_box() {
    add_meta_box(
        'myplugin_sectionid',           // 元框的唯一ID
        '我的插件自定义选项',            // 元框标题
        'my_first_plugin_meta_box_callback', // 输出内容的回调函数
        'post'                          // 在‘文章’编辑页面显示
    );
}
add_action( 'add_meta_boxes', 'my_first_plugin_add_custom_meta_box' );

Penggunaan Filter Hooks

Filter Hooks berbeda dengan Action Hooks; Filter Hooks memungkinkan Anda untuk memodifikasi data sebelum data tersebut disimpan ke dalam basis data atau ditampilkan di browser. Misalnya, Anda dapat memodifikasi isi artikel, judul artikel, bahkan komentar-komentarnya.add_filter()Fungsi ini digunakan untuk menerapkan filter. Fungsi panggilan balik (callback function) yang Anda daftarkan menerima data asli sebagai parameter, dan harus mengembalikan data yang telah dimodifikasi.

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

// 在所有文章标题前添加一个前缀
function my_first_plugin_add_title_prefix( $title ) {
    // 仅当在主查询中且在单个文章页面时生效
    if ( is_single() && in_the_loop() && is_main_query() ) {
        return '【推荐】' . $title;
    }
    return $title;
}
add_filter( 'the_title', 'my_first_plugin_add_title_prefix' );

Memahami dan menguasai penggunaan “hook”-hook ini merupakan kunci untuk membedakan antara pengembang plugin tingkat pemula dan tingkat lanjut.

Keamanan, optimisasi, dan pengelolaan plugin

Sebuah plugin yang lengkap bukan hanya sekumpulan fitur saja; penting juga untuk mempertimbangkan aspek keamanan, kinerja, kemudahan pemeliharaan, serta cara pengiriman plugin tersebut kepada pengguna.

Mengimplementasikan validasi data dan keamanan

Jangan pernah mempercayai data yang dimasukkan oleh pengguna. Semua data yang berasal dari pengguna harus diperiksa dan diverifikasi dengan seksama sebelum digunakan.$_POST、$_GET或$_COOKIESemua data yang diperoleh harus melalui proses verifikasi dan pembersihan (sanitizing). WordPress menyediakan berbagai fungsi bantu yang berguna untuk hal ini.sanitize_text_field()、intval()、wp_kses()“Dll,” digunakan untuk membersihkan data. Saat mengeluarkan data ke front end, proses penghindaran karakter khusus (escaping) juga diperlukan.esc_html()、esc_attr()或wp_kses_post()Fungsi-fungsi seperti ini digunakan untuk mencegah serangan jenis Cross-Site Scripting (XSS).

推荐阅读 Panduan Dasar Pengembangan Plugin WordPress: Membangun Plugin Kustom Pertama Anda Dari Nol。

Lokalisasi dan Penerjemahan Plugin

Agar plugin Anda dapat digunakan oleh pengguna di seluruh dunia, internasionalisasi (i18n) sangat penting. Anda perlu menggunakan fungsi penerjemahan WordPress untuk mengatur semua teks yang ditampilkan kepada pengguna. Hal yang paling mendasar yang perlu Anda lakukan adalah…__()Digunakan untuk menampilkan hasil terjemahan._e()Digunakan untuk menghasilkan terjemahan.

// 在插件代码中包装可翻译字符串
$greeting_message = __( ‘感谢使用我的插件！‘， ‘my-first-plugin’ );

// 在特定的钩子上加载翻译文件
function my_first_plugin_load_textdomain() {
    load_plugin_textdomain( ‘my-first-plugin’， false， dirname( plugin_basename( __FILE__ ) ) . ‘/languages/’ );
}
add_action( ‘plugins_loaded’， ‘my_first_plugin_load_textdomain’ );

Kemudian, Anda dapat menggunakan alat seperti Poedit untuk membuat….potFile template, digunakan oleh penerjemah untuk membuat terjemahan..po和.moFile terjemahan.

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

Sedang mempersiapkan untuk dipublikasikan ke dalam direktori resmi.

Ketika Anda bersiap untuk merilis plugin secara publik, Anda perlu mengikuti persyaratan penerbitan resmi dari WordPress. Ini termasuk menulis dokumentasi yang rinci…readme.txtAnda perlu membuat sebuah file berisi deskripsi plugin, instruksi instalasi, jawaban untuk pertanyaan umum, tangkapan layar, dan informasi lainnya (format file mirip dengan header plugin). Pastikan kode yang Anda tulis memenuhi standar penulisan kode WordPress. Lakukan pengujian yang menyeluruh terhadap plugin tersebut, dan pertimbangkan untuk mengirimkannya ke platform kontrol versi seperti GitHub. Setelah itu, Anda dapat mengajukan permohonan untuk mendapatkan repositori SVN di WordPress.org, sehingga kode plugin Anda dapat disimpan di direktori resmi plugin WordPress dan dapat diunduh serta diinstal oleh pengguna di seluruh dunia.

Menyimpulkan.

Pengembangan plugin WordPress merupakan proses mengubah ide-ide kreatif menjadi fitur-fungsi yang berguna, yang kemudian diintegrasikan ke dalam ekosistem sistem manajemen konten terbesar di dunia. Mulai dari membangun lingkungan pengembangan, membuat file-file dasar, hingga memahami dengan mendalam mekanisme interaksi inti seperti sistem hook (hook system), lalu memperhatikan aspek keamanan, internasionalisasi (internationalization), dan mempersiapkan plugin untuk dipublikasikan, setiap langkahnya sangat penting. Dengan mengikuti praktik terbaik, terutama pedoman pemrograman yang aman dan standar WordPress, Anda tidak hanya akan membuat plugin yang stabil dan dapat diandalkan, tetapi juga memastikan bahwa plugin tersebut memiliki umur yang panjang serta kompatibilitas yang baik dengan versi WordPress yang berbeda. Ingatlah bahwa plugin yang berkualitas berasal dari pemahaman yang mendalam tentang kebutuhan pengguna dan rasa hormat terhadap mekanisme platform tersebut. Sekarang, setelah Anda memahami langkah-langkah dasar dalam membangun plugin dari nol, saatnya Anda memulai perjalanan pengembangan Anda dan menambahkan nilai bagi komunitas WordPress dengan kode yang Anda tulis.

FAQ - Pertanyaan yang Sering Diajukan.

Apakah untuk mengembangkan plugin, seseorang harus mahir dalam PHP?

Ya, menguasai PHP dengan baik merupakan dasar untuk pengembangan plugin WordPress. Hal ini karena sebagian besar komponen WordPress, termasuk plugin dan tema-temanya, ditulis menggunakan PHP. Anda perlu memahami sintaks, fungsi, kelas, dan objek dalam PHP, serta cara berinteraksi dengan basis data (umumnya MySQL/MariaDB).

Bagaimana cara men-debug plugin WordPress saya?

Berikut adalah beberapa metode yang dapat direkomendasikan: Pertama-tama,wp-config.phpAktifkan di dalam file.WP_DEBUGBiarkan kesalahan dan peringatan PHP ditampilkan. Selanjutnya, gunakan…error_log()Fungsi tersebut menulis informasi debug ke log kesalahan (error log) pada server. Untuk debugging yang lebih kompleks, Anda dapat menggunakan Xdebug bersama dengan IDE untuk melakukan pemotongan proses (breakpoint debugging). Selain itu, banyak pengembang juga menggunakan plugin debugging seperti Query Monitor untuk melihat hasil kueri database, proses eksekusi fungsi tertentu (hook execution), dan sebagainya.

Bagaimana cara agar plugin saya kompatibel dengan tema atau plugin lainnya?

Untuk memaksimalkan kompatibilitas, plugin Anda sebaiknya menggunakan API dan hook standar yang disediakan oleh WordPress, serta menghindari modifikasi langsung pada file inti atau penggunaan fungsi-fungsi yang tidak terbuka (biasanya fungsi yang diawali dengan tanda bawah garis “_”). Saat memodifikasi data global atau hasil pengolahan, pastikan untuk memeriksa kondisi terlebih dahulu (misalnya, dengan menggunakan kondisi tertentu).is_admin()、is_single()Untuk fitur-fitur yang berpotensi bertentangan dengan plugin lain, pertimbangkan untuk menyediakan opsi agar pengguna dapat memilih apakah ingin mengaktifkannya atau tidak.

Setelah plugin diterbitkan, bagaimana cara memberikan pembaruan kepada pengguna?

Jika Anda mengunggah plugin ke direktori resmi WordPress.org, layanan pembaruan akan berjalan secara otomatis. Yang perlu Anda lakukan hanyalah memperbarui nomor versi di file utama plugin (misalnya, dari versi sebelumnya ke versi terbaru).1.0.0Ubah menjadi1.0.1Setelah melakukan perubahan pada kode sumber, Anda perlu mengganti file tersebut dengan versi yang telah diperbarui, lalu mengirimkannya ke repositori SVN resmi. Setelah itu, WordPress akan secara otomatis mengirimkan notifikasi pembaruan kepada semua pengguna. Jika Anda mendistribusikan plugin tersebut sendiri, Anda perlu membuat mekanisme pemeriksaan pembaruan yang khusus. Hal ini biasanya melibatkan penyimpanan file JSON yang berisi informasi versi di server jauh, dan melakukan pemeriksaan secara berkala melalui permintaan HTTP di dalam plugin tersebut.