Panduan Memulai Pengembangan Plugin WordPress: Membuat Plugin Pertama Anda dari Nol.

WordPress merupakan sistem manajemen konten (Content Management System/CMS) yang paling populer di dunia, dan keunggulannya dalam hal skalabilitas sebagian besar berasal dari arsitektur plugin-nya. Ketika Anda menemukan bahwa fitur yang tersedia tidak memenuhi kebutuhan Anda, mengembangkan plugin sendiri menjadi pilihan terbaik. Hal ini tidak hanya dapat menyelesaikan masalah tertentu, tetapi juga merupakan cara yang sangat baik untuk memahami lebih dalam mekanisme kerja inti WordPress. Panduan ini akan membimbing Anda melalui seluruh proses pengembangan plugin WordPress pertama Anda, mulai dari membangun lingkungan pengembangan, menulis kode, hingga akhirnya merilis plugin tersebut.

Pengaturan Lingkungan dan Alat Pengembangan

Sebelum memulai menulis kode, Anda memerlukan lingkungan pengembangan yang sesuai. Hal ini akan memastikan proses pengembangan Anda berjalan dengan efisien dan sesuai dengan praktik terbaik WordPress.

Pembangunan lingkungan pengembangan lokal

Pilihan terbaik adalah membangun lingkungan server lokal di komputer Anda sendiri. Anda dapat menggunakan XAMPP, MAMP (untuk Mac), WAMP (untuk Windows), atau Docker yang lebih fleksibel. Paket-paket alat ini mengintegrasikan server Apache, basis data MySQL, dan PHP, sehingga mampu meniru kondisi penggunaan WordPress secara online dengan sempurna. Setelah server lokal terinstal, unduh versi terbaru dari WordPress dari situs resminya (WordPress.org), lalu konfigurasikannya di lokal sesuai dengan prosedur instalasi standar yang membutuhkan waktu sekitar 5 menit.

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

Editor kode dan alat-alat penting

Sebuah editor kode yang kuat sangat penting. Visual Studio Code, PhpStorm, atau Sublime Text semuanya merupakan pilihan yang sangat baik, karena mereka menyediakan fitur penyorotan sintaks, saran kode yang cerdas, dan kemampuan untuk melakukan debugging. Selain itu, Anda juga memerlukan sistem pengelolaan versi (version control system) seperti Git untuk mengelola perubahan pada kode Anda. Meskipun plugin pertama mungkin terlihat sederhana, membiasakan diri menggunakan sistem pengelolaan versi sangat penting untuk pengembangan di masa depan.

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

Buatlah file plugin pertamamu.

Setiap plugin WordPress dimulai dengan sebuah file utama, yang berisi informasi berupa komentar (header comments) yang diperlukan agar WordPress dapat mengenali plugin tersebut.

Struktur file utama plugin

Di dalam direktori instalasi WordPress lokal Anda, masuk ke sana.wp-content/pluginsFolder: Buatlah folder baru di sini, dan beri nama folder tersebut…my-first-plugin(Nama harus singkat dan mampu menggambarkan fungsi plugin tersebut.) Dalam folder ini, buatlah sebuah file PHP yang biasanya bernama sama dengan folder tersebut:my-first-plugin.phpFile ini akan menjadi titik masuk (entry point) untuk plugin tersebut.

Menulis informasi kepala (header) untuk plugin

Di awal file utama ini, Anda harus menambahkan sebuah komentar kepala plugin yang sesuai dengan standar WordPress. Komentar tersebut menyediakan informasi dasar tentang plugin tersebut. Berikut adalah contoh paling dasarnya:

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

Kode ini merupakan “kartu identitas” (identifikasi) dari plugin tersebut.Plugin NameIni adalah kolom wajib; kolom ini menentukan nama plugin yang akan ditampilkan di antarmuka administrasi WordPress. Informasi lainnya, seperti deskripsi dan nomor versi, juga disarankan untuk diisi dengan lengkap. Setelah menyimpan file, masuk ke halaman “Plugins” di administrasi WordPress, Anda seharusnya dapat melihat “My First Plugin” muncul dalam daftar plugin, dan Anda dapat mengaktifkannya. Saat ini, plugin ini belum memiliki fitur apa pun.

推荐阅读 Panduan Lengkap untuk Mengembangkan Plugin WordPress: Membuat Plugin Fungsional Pertama Anda dari Nol.。

Menambahkan fitur dasar untuk plugin

Setelah plugin diaktifkan, kami akan menambahkan dua fitur dasar ke dalamnya: menambahkan teks kustom di akhir isi artikel, dan membuat halaman manajemen yang sederhana.

Menggunakan “hook” untuk memodifikasi isi artikel

Mekanisme inti WordPress adalah “Hook” (Pengait), yang memungkinkan Anda untuk menyisipkan kode Anda sendiri pada titik waktu tertentu. Hook Aksi (Action Hooks) digunakan untuk menjalankan suatu tindakan, sedangkan Hook Filtrasi (Filter Hooks) digunakan untuk memodifikasi data. Kita perlu menambahkan satu baris teks di akhir isi artikel, dan ini memerlukan penggunaan Hook.the_contentFilter hook ini…
Di bawah komentar di bagian awal file plugin utama Anda, tambahkan fungsi dan hook berikut:

// 在文章内容末尾添加自定义文本
function myfp_add_footer_text( $content ) {
    // 仅在主循环的单篇文章页面添加
    if ( is_single() && in_the_loop() && is_main_query() ) {
        $custom_text = '<p><em>Terima kasih telah membaca! Artikel ini dihasilkan oleh “My First Plugin”.</em></p>';
        $content .= $custom_text;
    }
    return $content;
}
// 将函数挂载到‘the_content’过滤器上
add_filter( 'the_content', 'myfp_add_footer_text' );

Setelah menyimpan file, lakukan pembaruan (refresh) pada halaman artikel di frontend situs web, dan Anda akan melihat teks yang telah ditambahkan di bagian bawah isi artikel tersebut. Dalam kode ini…myfp_add_footer_textFungsi tersebut menerima data mentah (raw data).$contentSetelah memeriksa kondisi halaman, teks paragraf HTML khusus ditambahkan di bagian akhir, dan kemudian konten yang telah dimodifikasi dikembalikan.add_filter()Fungsi tersebut menghubungkan fungsi kustom kita dengan filter inti (core filters) dari WordPress.

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

Membuat menu manajemen yang sederhana

Selanjutnya, kita akan membuat halaman pengaturan untuk plugin tersebut di panel administrasi WordPress. Proses ini melibatkan penggunaan action hook untuk menambahkan item baru ke menu administrasi. Tambahkan kode berikut:

// 在后台管理菜单中添加一个新页面
function myfp_add_admin_menu() {
    add_menu_page(
        '我的第一个插件设置', // 页面标题
        '我的插件',           // 菜单标题
        'manage_options',     // 所需权限
        'my-first-plugin',    // 菜单slug
        'myfp_admin_page_html', // 用于输出页面内容的回调函数
        'dashicons-admin-generic', // 图标（可选）
        100                   // 菜单位置
    );
}
add_action( 'admin_menu', 'myfp_add_admin_menu' );

// 定义管理页面的HTML内容
function myfp_admin_page_html() {
    // 检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1>\n</h1>
        <p>Selamat datang di halaman pengaturan untuk “Plugin Pertama Saya”. Ini adalah awal dari perjalanan Anda dalam mengembangkan dan menggunakan plugin tersebut.</p>
    </div>
    \n&lt;?php
}

Simpan dan perbarui halaman administrasi WordPress. Anda seharusnya melihat opsi menu baru bernama “My Plugins” di bagian bawah menu sebelah kiri. Klik opsi tersebut untuk masuk ke halaman pengaturan yang sederhana. Di sana…add_menu_page()Fungsi tersebut bertanggung jawab untuk mendaftarkan halaman menu utama (top-level menu page).myfp_admin_page_html()Fungsi tersebut bertanggung jawab untuk merender konten HTML dari halaman tersebut.

Keamanan plugin dan optimisasi kode

Saat mengembangkan plugin, keamanan dan kemudahan pemeliharaan (maintainability) merupakan aspek penting yang perlu dipertimbangkan sejak awal.

推荐阅读 Mulai dari nol: Mengapa memilih pengembangan plugin WordPress?。

Data Validation and Escaping

Jangan pernah mempercayai data yang dimasukkan oleh pengguna atau data dari sumber eksternal. Sebelum data dipaparkan ke browser atau disimpan ke dalam basis data, data tersebut harus diproses terlebih dahulu. WordPress menyediakan banyak fungsi bantu untuk hal ini. Misalnya, ketika Anda ingin menampilkan sebuah variabel sebagai atribut HTML, gunakan fungsi yang sesuai.esc_attr()Ketika menghasilkan teks ke dalam format HTML, gunakan tanda semicolon (;) untuk memisahkan setiap kalimat atau klausa.esc_html()Ketika mengirimkan konten ke URL, gunakan format yang sesuai dengan standar web.esc_url()Pada sebelumnya…myfp_admin_page_html()Dalam fungsi tersebut, kami menggunakan…esc_html()Keluarkan judul halaman dengan aman.

Menggunakan kelas untuk mengorganisir kode

Seiring dengan bertambahnya fitur pada plugin, menempatkan semua fungsi dalam ruang nama global (global namespace) dapat menyebabkan konflik dan kekacauan. Menggunakan kelas PHP untuk mengemas fungsi-fungsi plugin merupakan kebiasaan yang baik. Hal ini dapat meningkatkan organisasi kode, kebacaan, dan kemudahan penggunaan kembali (reusability) kode tersebut. Berikut adalah kerangka dasar untuk menulis ulang kode kami menggunakan kelas:

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

class My_First_Plugin {
    // 构造方法，用于初始化钩子
    public function __construct() {
        add_filter( 'the_content', array( $this, 'add_footer_text' ) );
        add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
    }

public function add_footer_text( $content ) {
        // ... 函数实现同上 ...
    }

public function add_admin_menu() {
        // ... 函数实现同上 ...
    }

public function admin_page_html() {
        // ... 函数实现同上 ...
    }
}
// 实例化插件类
new My_First_Plugin();

Metode ini menggabungkan semua metode dan atribut terkait dalam satu objek, sehingga strukturnya menjadi lebih jelas.

Menyimpulkan.

Dengan panduan ini, Anda telah menyelesaikan langkah-langkah dasar dalam membuat plugin WordPress dari nol: membangun lingkungan pengembangan, membuat file plugin dengan informasi header standar, menggunakan action hooks dan filter hooks untuk menambahkan fitur pada konten artikel, serta membuat antarmuka pengelolaan plugin. Anda juga telah memahami pentingnya aspek keamanan dan pengorganisasian kode. Ini hanyalah awal dari perjalanan Anda dalam pengembangan plugin WordPress. Dunia pengembangan plugin WordPress sangat luas; Anda dapat mengeksplorasi berbagai fitur lanjutan seperti Shortcode, Widget, Custom Post Type, dan endpoint REST API. Ingatlah bahwa membaca kode sumber, mengamati cara kerja plugin-plugin yang telah berhasil dikembangkan, serta mempelajari dokumentasi resmi pengembang adalah cara terbaik untuk terus meningkatkan keterampilan Anda.

FAQ - Pertanyaan yang Sering Diajukan.

Apa teknologi yang harus dikuasai untuk mengembangkan plugin?

Untuk mengembangkan plugin WordPress, Anda perlu menguasai pengetahuan dasar tentang PHP, HTML, CSS, dan JavaScript. PHP merupakan komponen inti, karena WordPress sendiri ditulis menggunakan PHP, sehingga Anda perlu menggunakannya untuk menulis logika plugin. HTML/CSS digunakan untuk membangun antarmuka pengguna (frontend), sedangkan JavaScript (terutama jQuery dan versi terbaru seperti ES6+) dapat digunakan untuk meningkatkan interaktivitas dan melakukan permintaan data melalui AJAX. Memiliki pemahaman dasar tentang MySQL juga akan membantu Anda dalam memproses data.

Mengapa plugin saya tidak muncul di bagian belakang (backend)?

Silakan periksa hal-hal berikut terlebih dahulu: 1. Apakah file utama plugin terletak diwp-content/pluginsDi dalam folder terpisah di bawah direktori. 2. Komentar header plugin pada file utama (khususnya <)Plugin Name:1. Apakah formatnya benar dan tidak ada kesalahan? 2. Apakah pengkodean file-nya UTF-8 tanpa BOM? 3. Apakah ada kesalahan sintaks yang menyebabkan PHP gagal mengurai kodenya? Anda dapat memeriksanya di log debug WordPress (yang perlu diaktifkan terlebih dahulu).wp-config.phpDiaktifkan di tengah…WP_DEBUG）。

Bagaimana cara menguji plugin tanpa mempengaruhi situs web yang berjalan secara online?

Disarankan dengan kuat untuk mengembangkan dan menguji plugin di lingkungan pengembangan lokal (seperti Local by Flywheel, XAMPP) atau server uji yang terpisah (Staging Site). Jangan pernah menguji plugin baru yang belum terverifikasi langsung di situs produksi yang sedang berjalan dan berisi data penting. Gunakan alat pengelolaan versi (seperti Git) untuk mengelola kode, sehingga Anda dapat dengan mudah kembali ke versi sebelumnya jika terjadi masalah.

Bagaimana seharusnya sebuah plugin diperbarui versinya?

Anda sebaiknya memperbarui informasi tersebut dalam komentar di bagian awal (header) dari file utama plugin.Version:Untuk pembaruan yang berskala besar, disarankan untuk mengikuti konsep kontrol versi yang bersifat semantik (semantic versioning/SemVer). Misalnya, untuk memperbaiki bug, tambahkan nomor revisi (seperti 1.0.1); untuk fitur baru yang kompatibel dengan versi sebelumnya, tambahkan nomor sub-versi (seperti 1.1.0); sedangkan untuk pembaruan yang tidak kompatibel dengan versi sebelumnya, tambahkan nomor versi utama (seperti 2.0.0). Anda juga dapat mengimplementasikan mekanisme pendeteksian pembaruan (misalnya, dengan menyimpan informasi plugin di server Anda sendiri atau di direktori plugin WordPress), sehingga pengguna dapat menerima pemberitahuan pembaruan di latar belakang.

Apa saja syarat yang diperlukan untuk mengunggah plugin ke direktori resmi?

Jika Anda ingin mengirimkan plugin ke direktori plugin resmi WordPress.org, Anda harus memenuhi persyaratan utama berikut: kode plugin harus kompatibel dengan lisensi GPLv2 atau yang lebih baru; kualitas kode harus memadai dan sesuai dengan Standar Pengkodean WordPress; fungsionalitasnya harus umum dan praktis, bukan hanya untuk situs web tertentu; tidak boleh mengandung kode berbahaya atau tautan spam. Sebelum mengirimkan, pastikan untuk membaca panduan dan persyaratan pengiriman secara detail di "Pusat Pengembang" di direktori resmi.