Panduan Memulai Pengembangan Plugin WordPress: Membangun Ekstensi Pertama Anda dari Nol.

Pengaturan Lingkungan Pengembangan Plugin WordPress

Sebelum Anda mulai menulis kode, lingkungan pengembangan yang tepat sangat penting. Lingkungan ini tidak hanya akan memungkinkan Anda bekerja dengan efisien, tetapi juga dapat mensimulasikan kondisi lingkungan produksi yang sebenarnya, sehingga menghindari masalah ketidakkonsistenan antara lingkungan lokal dan lingkungan online. Lingkungan pengembangan yang tipikal harus mencakup lingkungan server lokal, editor kode, dan alat-alat debugging.

Pertama-tama, Anda memerlukan lingkungan server lokal yang mampu menjalankan WordPress. Kami merekomendasikan penggunaan paket lingkungan terintegrasi, seperti Laragon, XAMPP, atau Local by Flywheel. Alat-alat ini dapat menginstal Apache/Nginx, PHP, dan MySQL dengan satu klik, sehingga menghindari proses konfigurasi yang rumit. Pastikan versi PHP yang Anda gunakan kompatibel dengan versi WordPress terkini; umumnya disarankan untuk menggunakan PHP 7.4 atau versi yang lebih baru. Selain itu, periksa di bagian “Tools” -> “Site Health” di panel administrasi WordPress untuk memastikan tidak ada masalah penting yang dapat mengganggu pengembangan plugin.

Selanjutnya, pilihlah editor kode yang kuat. Visual Studio Code merupakan pilihan yang sangat populer saat ini; editor ini ringan, gratis, dan dilengkapi dengan berbagai ekstensi, seperti PHP Intelephense (untuk saran kode yang cerdas) dan WordPress Snippet (untuk potongan kode yang dapat digunakan kembali). Pilihan klasik lainnya adalah PhpStorm, yang menawarkan dukungan pengembangan WordPress yang lebih mendalam, namun merupakan perangkat lunak berbayar.

推荐阅读 Dari Nol ke Satu: Panduan Lengkap dan Praktik Terbaik dalam Pengembangan Plugin WordPress。

Terakhir, mengaktifkan mode debug merupakan langkah yang sangat penting dalam proses pengembangan. Hal ini dapat dilakukan dengan mengubah file-file yang terdapat di direktori akar (root directory) WordPress.wp-config.phpUntuk file tersebut, Anda dapat mengaktifkan laporan kesalahan yang lebih rinci, yang sangat penting untuk menemukan dan memperbaiki masalah dalam kode. Temukan bagian di file tersebut di mana definisi tersebut didefinisikan.WP_DEBUGDi tempat konstanta, tambahkan kode berikut:

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

// 启用 WordPress 调试模式
define( 'WP_DEBUG', true );
// 将错误记录到 /wp-content/debug.log 文件
define( 'WP_DEBUG_LOG', true );
// 在页面上显示错误（开发环境推荐，生产环境必须关闭）
define( 'WP_DEBUG_DISPLAY', true );

Buatlah file plugin pertamamu.

Sebuah plugin WordPress bisa sangat sederhana, hanya terdiri dari satu file saja. Semua plugin harus disimpan di tempat yang ditentukan oleh sistem WordPress./wp-content/plugins/Di dalam direktori tersebut, setiap plugin dapat memiliki direktori anaknya sendiri. Hal ini membantu dalam mengorganisir struktur kode yang lebih kompleks.

Comment on the plugin header

Setiap file utama plugin harus dimulai dengan komentar header PHP yang terstandarisasi; ini merupakan cara WordPress untuk mengenali informasi plugin. Buatlah sebuah file baru, beri nama…my-first-plugin.phpDan masukkan ke dalam…/wp-content/plugins/my-first-plugin/Di dalam folder tersebut, berikut adalah isi file-nya:

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

Komentar ini menyediakan semua metainformasi yang ditampilkan oleh plugin di halaman “Plugins” di panel administrasi WordPress (backend). Di dalamnya,Text Domain和Domain PathDigunakan untuk persiapan internasionalisasi (i18n) plugin.

Merealisasikan sebuah fungsi sederhana.

Sekarang, mari kita tambahkan sebuah fitur sederhana untuk plugin ini: menambahkan secara otomatis sebuah baris teks kustom di akhir isi artikel. Kita akan menggunakan fitur yang tersedia di WordPress.the_contentFilter hook. Yang baru saja Anda buat…my-first-plugin.phpDi bawah komentar di bagian awal file, tambahkan fungsi berikut:

推荐阅读 Menguasai Pengembangan Plugin WordPress: Membangun Fungsi Khusus dari Nol。

// 在文章内容末尾添加自定义文本
function my_first_plugin_add_footer_text( $content ) {
    // 确保只在主循环的单篇文章页面执行
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $footer_text = '<p><em>Terima kasih telah membaca! Artikel ini disajikan untuk Anda oleh “My First Plugin”.</em></p>';
        $content .= $footer_text;
    }
    return $content;
}
add_filter( 'the_content', 'my_first_plugin_add_footer_text' );

Setelah menyimpan file tersebut, masuklah ke panel administrasi WordPress Anda, lalu kunjungi halaman “Plugin”. Anda seharusnya dapat melihat plugin dengan nama “My First Plugin”. Aktifkan plugin tersebut, kemudian buka sebuah artikel blog. Anda akan melihat bahwa teks yang telah kita atur telah berhasil ditambahkan di bagian bawah isi artikel tersebut.

Menggunakan API inti WordPress

Selama proses pengembangan yang lebih mendalam, Anda akan sering berinteraksi dengan berbagai API yang disediakan oleh WordPress. Di antaranya, sistem “Hook” merupakan komponen yang paling penting, yang terdiri dari “Action” dan “Filter”.

Memahami hook aksi

Action hooks memungkinkan Anda untuk menjalankan kode kustom pada titik waktu tertentu. Misalnya, ketika sebuah artikel diterbitkan, Anda ingin mengirimkan email pemberitahuan. Dalam hal ini, action hooks dapat digunakan untuk melakukan hal tersebut.publish_postAksi (Actions). Contoh di bawah ini menunjukkan cara membuat fitur untuk mencatat informasi ke dalam log kesalahan saat sebuah artikel diterbitkan:

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_log_post_published( $post_id, $post ) {
    // 避免无限循环和非文章类型
    if ( wp_is_post_revision( $post_id ) || $post->post_type != ‘post’ ) {
        return;
    }
    // 记录日志
    error_log( “文章 ID {$post_id} 已发布，标题为：{$post->post_title}” );
}
// 将函数挂载到 publish_post 动作钩子上
add_action( ‘publish_post’， ‘my_first_plugin_log_post_published’， 10, 2 );

fungsiadd_actionParameter ketiga adalah prioritas (defaultnya 10); semakin kecil angkanya, semakin tinggi prioritasnya; parameter keempat adalah jumlah parameter yang diterima oleh fungsi tersebut.

Memahami Hook Filter (Filter Hook)

Filter hooks digunakan untuk memodifikasi data. Pada bagian “Membuat File Plugin Pertama Anda”, kita telah menggunakan filter hooks tersebut.the_contentHanya sebuah “filter hook” saja. Fungsi utamanya adalah menerima konten asli, memungkinkan Anda untuk memodifikasinya, lalu mengembalikannya lagi. Contoh lain yang sering digunakan adalah modifikasi panjang ringkasan artikel (abstract) dari sebuah artikel.

// 修改摘要的默认字数
function my_first_plugin_custom_excerpt_length( $length ) {
    return 30; // 将摘要字数改为30字
}
add_filter( ‘excerpt_length’， ‘my_first_plugin_custom_excerpt_length’ );

Tambahkan menu pintu masuk.

Untuk berinteraksi dengan pengguna, kita biasanya perlu menambahkan halaman menu ke sidebar pengelolaan di backend WordPress. Hal ini dapat dilakukan dengan…add_menu_pageImplementasi fungsi: Kode di bawah ini menambahkan halaman pengaturan utama untuk plugin.

推荐阅读 Panduan Lengkap untuk Mengembangkan Plugin WordPress: Membangun Fitur Ekstensi WordPress Berkualitas Tinggi dari Nol Hingga Satu.。

// 创建插件管理菜单
function my_first_plugin_add_admin_menu() {
    add_menu_page(
        ‘我的第一个插件设置’， // 页面标题
        ‘我的插件’，           // 菜单标题
        ‘manage_options’，     // 所需权限
        ‘my-first-plugin’，    // 菜单slug
        ‘my_first_plugin_settings_page’， // 回调函数，用于输出页面内容
        ‘dashicons-admin-plugins’， // 图标（可选）
        100                    // 菜单位置（可选）
    );
}
add_action( ‘admin_menu’， ‘my_first_plugin_add_admin_menu’ );

// 设置页面的回调函数
function my_first_plugin_settings_page() {
    ?>
    <div class="“wrap”">
        <h1>Pengaturan plugin pertama saya</h1>
        <p>Ini adalah halaman pengaturan plugin. Di masa depan, Anda dapat menambahkan formulir dan opsi di sini.</p>
    </div>
    \n&lt;?php
}

Keamanan Plugin dan Praktik Terbaik

Saat mengembangkan plugin untuk digunakan oleh orang lain, aspek keamanan dan kualitas kode tidak boleh diabaikan. Mengikuti praktik terbaik dapat melindungi situs web dari serangan, serta memastikan bahwa plugin tersebut kompatibel dan mudah diperawat.

Data Validation and Escaping

Jangan pernah mempercayai data yang dimasukkan oleh pengguna atau data yang berasal dari basis data. Data tersebut harus di-ekspos (diubah formatnya) sebelum ditampilkan di browser, dan harus diverifikasi serta dibersihkan sebelum disimpan ke dalam basis data. WordPress menyediakan banyak fungsi bantu untuk hal ini.

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

• Output: Use escape characters.esc_html()、esc_attr()、esc_url()和wp_kses_post()Fungsi-fungsi seperti ini melakukan proses ekspansi data (escaping) sesuai dengan konteksnya.
• Verifikasi masukan: Gunakansanitize_text_field()、sanitize_email()、intval()Fungsi-fungsi tersebut digunakan untuk membersihkan data formulir yang dikirim oleh pengguna.

Misalnya, saat mengatur halaman untuk memproses data formulir:

$user_input = $_POST[‘some_field’] ?? ‘’; // 使用空合并运算符提供默认值
$clean_input = sanitize_text_field( $user_input ); // 清理数据
update_option( ‘my_plugin_option’， $clean_input ); // 安全存储

Menggunakan metode selain CE (Common Encryption) dan pemeriksaan hak akses

Saat memproses permintaan formulir (terutama yang berasal dari admin-ajax.php atau admin-post.php), harus menggunakan…wp_verify_nonce()Digunakan untuk memverifikasi keabsahan permintaan, guna mencegah serangan penipuan permintaan antar-situs (Cross-Site Request Forgery/CSRF).current_user_can()Periksa apakah pengguna saat ini memiliki izin untuk melakukan operasi tersebut.

function my_first_plugin_handle_form_submit() {
    // 1. 检查nonce
    if ( ! isset( $_POST[‘my_nonce_field’] ) || ! wp_verify_nonce( $_POST[‘my_nonce_field’]， ‘my_action’ ) ) {
        wp_die( ‘安全校验失败！’ );
    }
    // 2. 检查权限
    if ( ! current_user_can( ‘manage_options’ ) ) {
        wp_die( ‘权限不足！’ );
    }
    // 3. 安全地处理数据…
}

Pengorganisasian Kode dan Internasionalisasi

Untuk plugin yang kompleks, disarankan untuk menggunakan Pemrograman Berorientasi Objek (Object-Oriented Programming/OOP) dalam mengorganisir kode, dengan memodulasi fungsi-fungsi menjadi kelas. Hal ini meningkatkan keterbacaan dan kemudahan penggunaan kembali kode (reusability) dari plugin tersebut.

Pada saat yang sama, siapkan fitur internasionalisasi (internationalization) untuk plugin sejak awal. Hal ini berarti bahwa semua teks yang ditampilkan kepada pengguna harus menggunakan fungsi penerjemahan (translation) yang disediakan oleh WordPress.__()、_e()Melakukan proses pengemasan. Dengan melihat kembali komentar di bagian atas plugin, kita telah mendefinisikan…Text DomainDalam kode, seharusnya digunakan seperti ini:

$message = __( ‘感谢阅读！本文由“我的第一个插件”为您呈现。’， ‘my-first-plugin’ );

Kemudian, Anda dapat menggunakan alat seperti Poedit untuk membuatnya..potFile template, digunakan oleh penerjemah untuk menghasilkan teks dalam berbagai bahasa..moDokumen.

Menyimpulkan.

Dengan panduan ini, Anda telah menyelesaikan proses pembuatan plugin WordPress dari awal hingga akhir. Anda telah mempelajari cara membangun lingkungan pengembangan, membuat file plugin yang berisi komentar header standar, serta menggunakan sistem hook aksi dan filter yang kuat di WordPress untuk menambahkan fitur baru. Kami juga membahas cara menambahkan menu administrasi dengan aman, memproses data, dan menekankan pentingnya aspek keamanan serta internasionalisasi (penggunaan bahasa yang beragam). Pengembangan plugin merupakan proses yang terus-menerus membutuhkan pembelajaran dan praktik; kuncinya adalah memahami sistem hook dan pedoman keamanan WordPress. Selanjutnya, Anda dapat mencoba mengembangkan fitur yang lebih kompleks, seperti membuat tabel basis data khusus, menambahkan kode singkat (Shortcode), widget, atau endpoint API REST, dan secara bertahap membangun plugin yang memiliki fitur lengkap serta kode yang kuat untuk digunakan dalam skala bisnis.

FAQ - Pertanyaan yang Sering Diajukan.

Haruskah sebuah plugin diletakkan dalam folder yang terpisah?

Tidak, sebuah plugin bisa saja hanya berupa file yang berdiri sendiri (tidak tergantung pada aplikasi lain)..phpFile tersebut, letakkan saja langsung di sana./wp-content/plugins/Berada di dalam direktori tersebut. Namun, untuk setiap plugin yang mengandung beberapa file atau sumber daya (seperti JS, CSS), atau file yang perlu diterjemahkan, sangat disarankan untuk menggunakan folder terpisah untuk menyimpan semua file terkait. Hal ini akan membuat struktur proyek menjadi lebih jelas dan memudahkan pengelolaannya.

Bagaimana cara menyimpan pengaturan plugin saya di dalam basis data?

WordPress menyediakan API opsi yang sangat mudah digunakan. Anda dapat memanfaatkannya untuk berbagai keperluan.add_option()、get_option()和update_option()Fungsi-fungsi ini digunakan untuk menambahkan, mengambil, dan memperbarui pengaturan plugin. Data tersebut akan disimpan dengan aman di dalam sistem WordPress.wp_optionsDi dalam tabel basis data, untuk data terstruktur dalam jumlah besar, Anda dapat mempertimbangkan untuk mengserialisasikannya menjadi array atau string JSON sebelum menyimpannya.

Akankah plugin yang saya kembangkan bertentangan (konflik) dengan plugin lainnya?

Memungkinkan, terutama ketika plugin menggunakan hook, nama fungsi, atau nama kelas yang umum digunakan. Untuk menghindari konflik, praktik terbaik adalah: menambahkan prefix unik untuk semua fungsi, kelas, dan variabel Anda (misalnya dengan menggunakan singkatan atau nama plugin), menggunakan “slug” dari plugin sebagai namespace (dapat digunakan di PHP 5.3+), dan memilih prioritas yang tepat saat menggunakan hook agar urutan eksekusinya sesuai dengan yang diinginkan.

Versi WordPress mana yang perlu didukung oleh plugin ini?

Ini tergantung pada pengguna target Anda. Umumnya, disarankan untuk kompatibel dengan versi terkini serta satu atau dua versi sebelumnya. Anda dapat melakukannya dalam pengaturan plugin…readme.txtFile tersebut telah berhasil diakses/diproses.Requires at least:Gunakan kolom untuk menyatakan versi WordPress minimum yang diperlukan. Selama proses pengembangan, sebaiknya dihindari penggunaan fungsi-fungsi yang hanya tersedia di versi WordPress yang lebih baru.function_exists()Melakukan penilaian kompatibilitas untuk memperluas cakupan penggunaan plugin tersebut.