Panduan Utama Pengembangan Plugin WordPress: Membangun Fitur Kustom dari Nol hingga Satu.

Lingkungan Pengembangan Plugin WordPress dan Persiapan Dasar

Sebelum memulai menulis kode, memiliki lingkungan pengembangan yang stabil dan terisolasi merupakan langkah pertama menuju keberhasilan. Hal ini tidak hanya dapat melindungi situs web produksi Anda dari pengaruh kode uji (test code), tetapi juga membuat proses debugging menjadi lebih lancar.

Membangun lingkungan pengembangan lokal

Disarankan untuk menggunakan paket perangkat lunak server lokal, seperti Local by Flywheel, XAMPP, atau MAMP. Alat-alat ini memungkinkan Anda menginstal lingkungan yang lengkap (termasuk PHP, MySQL, Apache, dan/atau Nginx) dengan satu klik saja. Pastikan versi PHP yang Anda gunakan sesuai dengan persyaratan versi WordPress yang ingin Anda gunakan; umumnya disarankan untuk menggunakan PHP 7.4 atau versi yang lebih baru untuk mendapatkan kinerja dan dukungan keamanan yang lebih baik.

Membuat file utama untuk plugin

Setiap plugin WordPress harus memiliki sebuah file utama, yang berfungsi sebagai titik masuk (entry point) untuk plugin tersebut. File ini perlu diletakkan di… wp-content/plugins File tersebut harus disimpan dalam folder terpisah di dalam direktori tersebut, dan diberi nama yang unik. Misalnya, jika Anda ingin membuat plugin bernama “Greeting”, Anda dapat membuat folder dengan nama “Greeting” dan menyimpan file plugin di dalamnya. my-first-plugin Buka folder tersebut, lalu buat file utama di dalamnya. my-first-plugin.php。

推荐阅读 Panduan Akhir Pengembangan Plugin WordPress: Membangun Plugin Berkelas Bisnis Dari Nol。

Pada awal file ini, harus terdapat sebuah komentar khusus untuk header plugin, yang berfungsi untuk memberikan informasi dasar tentang plugin tersebut kepada WordPress. Berikut adalah contoh yang paling sederhana:

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

<?php
/**
 * Plugin Name:       我的第一个插件
 * Plugin URI:        https://example.com/my-first-plugin
 * Description:       这是一个用于学习插件开发的简单插件。
 * Version:           1.0.0
 * Author:            你的名字
 * License:           GPL v2 or later
 * Text Domain:       my-first-plugin
 */

Struktur inti plugin dan mekanisme hook

Inti dari pengembangan plugin WordPress adalah memahami dan memanfaatkan sistem “Hook”-nya. Hook memungkinkan kode Anda untuk “terhubung” ke dalam proses inti WordPress pada titik waktu tertentu, sehingga Anda dapat mengubah atau menambahkan fitur tanpa perlu memodifikasi file inti WordPress itu sendiri.

Memahami Hook Aksi (Action Hook) dan Hook Filter (Filter Hook)

Hook terbagi menjadi dua kategori utama: Action (Aksi) dan Filter (Filter). Hook tipe Action akan menjalankan kode Anda ketika peristiwa tertentu terjadi, misalnya saat artikel diterbitkan atau saat halaman administrasi dibuka. Anda menggunakan… add_action() Fungsi digunakan untuk melakukan proses “mounting” (penyambungan data ke sistem). Hook filter (pemanggil fungsi khusus) digunakan untuk memodifikasi data; fungsi ini memungkinkan Anda mengubah nilai data sebelum data tersebut dikirim ke basis data atau browser. Anda menggunakan… add_filter() Fungsi tersebut digunakan untuk melakukan proses mounting (menghubungkan komponen tertentu ke sistem).

Misalnya, untuk menambahkan teks kustom di bagian kaki halaman situs web, Anda dapat menggunakan… wp_footer Action Hook ini:

function myplugin_add_footer_text() {
    echo '<p style="text-align:center;">Terima kasih telah menggunakan situs web ini!</p>';
}
add_action( 'wp_footer', 'myplugin_add_footer_text' );

Create a plugin management page.

Banyak plugin memerlukan halaman pengaturan yang tersedia di panel administrasi WordPress. Hal ini biasanya dilakukan dengan cara “menggantung” (mounting) plugin tersebut ke sistem administrasi WordPress. admin_menu Aksi tersebut diimplementasikan menggunakan “action hooks”. Anda perlu mendefinisikan sebuah fungsi, dan dalam fungsi tersebut, gunakan mekanisme yang tersedia untuk melakukan tindakan yang diinginkan. add_menu_page() 或 add_options_page() Gunakan fungsi-fungsi tertentu untuk mendaftarkan halaman, dan definisikan fungsi lainnya untuk menghasilkan konten HTML dari halaman tersebut.

推荐阅读 Mulai dari Nol: Panduan Lengkap dan Tutorial Praktis untuk Pengembangan Plugin WordPress。

function myplugin_add_admin_menu() {
    add_options_page(
        '我的插件设置', // 页面标题
        '我的插件',     // 菜单标题
        'manage_options', // 权限
        'myplugin-settings', // 菜单别名
        'myplugin_render_settings_page' // 用于显示页面内容的函数
    );
}
add_action( 'admin_menu', 'myplugin_add_admin_menu' );

function myplugin_render_settings_page() {
    ?>
    <div class="wrap">
        <h2>Pengaturan plugin saya</h2>
        <form method="post" action="/id/options.php/" data-trp-original-action="options.php">
            <?php
            settings_fields( 'myplugin_settings_group' );
            do_settings_sections( 'myplugin-settings' );
            submit_button();
            ?>
        <input type="hidden" name="trp-form-language" value="id"/></form>
    </div>
    \n&lt;?php
}

Mengimplementasikan fitur plugin dan pemrosesan data

Sebuah plugin yang lengkap umumnya perlu memproses input dari pengguna, menyimpan pengaturan, dan berinteraksi dengan basis data. WordPress menyediakan API yang kuat untuk mempermudah proses-proses tersebut.

Gunakan API pengaturan untuk menyimpan opsi.

Mengelola pengiriman formulir dan operasi basis data secara manual tidak hanya merepotkan, tetapi juga tidak aman. WordPress menyediakan API (Application Programming Interface) yang memungkinkan proses pendaftaran, verifikasi, dan penyimpanan pengaturan dengan cara yang terstandarisasi dan aman. API ini menggunakan tiga fungsi inti:register_setting()、add_settings_section() 和 add_settings_field()。

Berikut adalah contoh yang menunjukkan cara mengatur pengaturan untuk sebuah bidang teks:

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 myplugin_settings_init() {
    register_setting( 'myplugin_settings_group', 'myplugin_greeting_text' );

add_settings_section(
        'myplugin_section',
        '基础设置',
        null,
        'myplugin-settings'
    );

add_settings_field(
        'myplugin_field_greeting',
        '问候语',
        'myplugin_field_greeting_render',
        'myplugin-settings',
        'myplugin_section'
    );
}
add_action( ‘admin_init’， ‘myplugin_settings_init’ );

function myplugin_field_greeting_render() {
    $value = get_option( ‘myplugin_greeting_text’， ‘你好，世界！’ );
    echo ‘<input type=“text” name=“myplugin_greeting_text” value=“’ . esc_attr( $value ) . ‘” />’;
}

Membuat tabel basis data khusus

Untuk plugin yang memerlukan penyimpanan data relasional yang kompleks, Anda mungkin perlu membuat tabel basis data khusus. Proses ini biasanya dilakukan saat plugin diaktifkan. Anda perlu menulis sebuah fungsi dan mengaitkannya (meng-montekannya) dengan mekanisme pendaftaran dan pengaktifan (registration and activation hook) di WordPress. dbDelta() Fungsi ini digunakan untuk menjalankan perintah SQL yang bertujuan membuat atau memperbarui tabel, dan mampu menangani perubahan dalam struktur tabel secara cerdas.

Pertama-tama, daftarkan hook aktivasi dalam file plugin utama Anda:

register_activation_hook( __FILE__， ‘myplugin_create_database_table’ );

Kemudian, definisikan fungsi untuk membuat tabel:

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

function myplugin_create_database_table() {
    global $wpdb;
    $table_name = $wpdb->prefix . ‘myplugin_data’;
    $charset_collate = $wpdb->get_charset_collate();

$sql = “CREATE TABLE $table_name (
        id mediumint(9) NOT NULL AUTO_INCREMENT，
        name varchar(100) NOT NULL，
        email varchar(100) NOT NULL，
        created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL，
        PRIMARY KEY (id)
    ) $charset_collate;”;

require_once( ABSPATH . ‘wp-admin/includes/upgrade.php’ );
    dbDelta( $sql );
}

Keamanan plugin, internasionalisasi, dan persiapan untuk penerbitan

Plugin yang telah dikembangkan perlu melalui proses penguatan keamanan, penyesuaian bahasa (localisasi), dan pengemasan yang terstandarisasi, agar dapat diserahkan dengan aman kepada pengguna atau dikirimkan ke direktori resmi.

Menerapkan praktik terbaik keamanan

Keamanan merupakan hal yang paling penting dalam pengembangan plugin. Selalu verifikasi (periksa formatnya) dan bersihkan (hilangkan bagian-bagian yang berbahaya) dari input pengguna. Gunakan fungsi-fungsi yang disediakan oleh WordPress untuk melakukannya. esc_html()、esc_attr()、sanitize_text_field() Untuk menghasilkan atau memproses data, digunakan metode tertentu saat melakukan kueri pada basis data. $wpdb->prepare() Metode untuk mencegah serangan SQL injection. Pada saat yang sama, gunakan… current_user_can() Periksa hak akses pengguna untuk memastikan hanya pengguna yang berwenang yang dapat melakukan operasi sensitif.

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

Menginternasionalisasi plugin.

Agar plugin Anda dapat digunakan oleh pengguna di seluruh dunia, diperlukan persiapan untuk mendukung internasionalisasi (i18n). Artinya, semua teks yang ditujukan untuk pengguna tidak boleh ditulis langsung dalam kode, melainkan harus dibungkus menggunakan fungsi terjemahan yang disediakan oleh WordPress. Fungsi yang paling umum digunakan adalah… () Digunakan untuk menampilkan hasil terjemahan.() Digunakan untuk mendapatkan string yang telah diterjemahkan, serta… _e() Digunakan untuk menghasilkan terjemahan secara langsung.

Dalam kode Anda, seharusnya ditulis seperti ini:

$greeting = __( ‘你好，世界！’， ‘my-first-plugin’ );
echo esc_html( $greeting );

_e( ‘设置已保存。’， ‘my-first-plugin’ );

Perhatikan bahwa parameter kedua dalam fungsi penerjemahan, yaitu “Text Domain”, harus sesuai dengan definisi yang terdapat dalam komentar di bagian awal plugin. Text Domain Sama persis. Setelah itu, Anda dapat menggunakan alat seperti Poedit untuk menghasilkannya. .pot File template, digunakan oleh penerjemah untuk membuat terjemahan. .po 和 .mo File terjemahan.

Menyimpulkan.

Pengembangan plugin WordPress merupakan proses mengubah ide-ide kreatif menjadi fitur-fungsi yang nyata, yang didasarkan pada pemahaman yang mendalam tentang arsitektur inti WordPress, terutama sistem hook-nya. Mulai dari membangun lingkungan pengembangan, menulis file utama plugin, menggunakan hook-action dan filter, hingga memanipulasi data melalui API pengaturan (settings API) dan API basis data (database API), setiap langkahnya mengikuti pola yang terstruktur dengan jelas. Akhirnya, dengan menerapkan praktik keamanan yang ketat dan mendukung fitur internasionalisasi (internationalization) secara menyeluruh, plugin Anda dapat berkembang dari proyek pribadi menjadi produk yang siap untuk diterbitkan. Setelah memahami dasar-dasar ini, Anda dapat mengeksplorasi bidang yang lebih kompleks, seperti pengaturan tipe artikel (article types) secara khusus, integrasi dengan REST API, serta pengembangan blok (blocks) menggunakan Gutenberg, sehingga dapat membuat ekstensi (extensions) untuk WordPress yang lebih kuat dan modern.

FAQ - Pertanyaan yang Sering Diajukan.

Apakah untuk mengembangkan plugin WordPress, seseorang harus mahir dalam PHP?

Ya, PHP merupakan bahasa pemrograman utama untuk pengembangan WordPress dan plugin-nya. Anda perlu menguasai sintaks dasar PHP, fungsi, array, konsep pemrograman berorientasi objek, dan lainnya. Selain itu, pemahaman dasar tentang HTML, CSS, dan JavaScript juga sangat penting, karena Anda perlu menangani tampilan dan interaksi di sisi pengguna (front end).

Bagaimana cara mendebug plugin WordPress yang sedang dikembangkan?

Disarankan untuk mengaktifkan mode debug di WordPress. wp-config.php Dalam dokumen tersebut, akan... WP_DEBUG Konstanta diatur ke trueIni akan menampilkan semua kesalahan PHP, peringatan, dan notifikasi di layar. Selain itu, Anda juga dapat menggunakannya… error_log() Fungsi tersebut menulis informasi debug ke log kesalahan server, atau menggunakan alat pengembang browser untuk melakukan debug pada kode JavaScript di sisi front end.

Bagaimana cara menghindari konflik nama fungsi dalam sebuah plugin dengan plugin lain?

Untuk menghindari konflik nama fungsi, kelas, atau konstanta, selalu gunakan prefix yang unik. Praktik terbaik adalah menggunakan nama plugin atau singkatan sebagai prefix. Misalnya, jika plugin Anda bernama “Awesome Slider”, Anda dapat menggunakan prefix seperti “AS_” atau “AS_Slider”. as_ 或 awesome_slider_ Sebagai prefiks untuk semua fungsi kustom. Prinsip yang sama juga harus diterapkan untuk nama kelas.

Apakah plugin berbayar dapat dikirimkan ke direktori plugin resmi WordPress?

Tidak boleh. Direktori plugin resmi WordPress hanya menerima plugin yang mematuhi lisensi GPL dan benar-benar gratis. Jika Anda mengembangkan plugin berbayar (versi lanjutan), Anda perlu mendistribusikannya dan menjualnya di situs web Anda sendiri. Namun, banyak plugin berbayar yang menyediakan versi gratis yang mencakup fitur dasar untuk dikirimkan ke direktori resmi, sebagai sarana promosi dan uji coba bagi versi lanjutannya.