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

Mengapa memilih untuk mengembangkan plugin WordPress?

Sebagai sistem manajemen konten (Content Management System/CMS) yang paling populer di dunia, keunggulan WordPress dalam hal skalabilitas (kemampuan untuk diperluas) terutama berkat adanya plugin. Dengan mengembangkan plugin, Anda dapat menambahkan fitur khusus apa pun ke situs web Anda tanpa perlu mengubah file inti (core files) WordPress, sehingga kompatibilitas tetap terjaga saat versi WordPress diperbarui. Baik itu untuk memenuhi kebutuhan proyek tertentu, menyelesaikan masalah umum, atau ingin berbagi solusi Anda dengan komunitas dan menghasilkan pendapatan, pengembangan plugin merupakan keterampilan yang sangat berharga.

Mempelajari pengembangan plugin tidak hanya akan memungkinkan Anda memahami lebih dalam mekanisme kerja WordPress, seperti sistem Hook dan Shortcode, tetapi juga akan meningkatkan kemampuan pemrograman PHP Anda. Dari peningkatan fungsi yang sederhana hingga integrasi aplikasi yang kompleks, semuanya menjadi mungkin.

Membangun lingkungan pengembangan plugin Anda

Sebelum memulai menulis kode, memiliki lingkungan pengembangan lokal yang memadai sangat penting. Hal ini memungkinkan Anda melakukan pengujian dan debugging dengan aman, tanpa mempengaruhi situs web yang berjalan di internet.

推荐阅读 Panduan Ultimate untuk Pengembangan Plugin WordPress: Membangun Plugin Profesional dari Nol hingga Satu.。

Mengonfigurasi lingkungan server lokal

Disarankan untuk menggunakan alat pengembangan lokal yang terintegrasi, seperti Local by Flywheel, DevKinsta, atau XAMPP. Alat-alat ini dapat diinstal dengan satu klik saja dan sudah mencakup Apache/Nginx, PHP, serta MySQL. Pastikan versi PHP yang Anda gunakan kompatibel dengan server tujuan; umumnya disarankan untuk menggunakan PHP 7.4 atau versi yang lebih baru untuk mendapatkan kinerja dan keamanan yang lebih baik.

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

Menginstal dan mengatur WordPress

Instal sebuah instance WordPress yang baru di server lokal Anda. Disarankan untuk menggunakan tema default (seperti seri Twenty Twenty) selama proses pengembangan dan pengujian, agar dapat menghindari masalah kompatibilitas tema.wp-config.phpDi dalam file, aktifkan (enkripsi atau fitur lainnya yang diinginkan).WP_DEBUGKonstanta ini akan membantu Anda menemukan kesalahan dengan cepat selama proses pengembangan.

define( 'WP_DEBUG', true );

Siapkan editor kode.

Pilihlah editor kode yang kuat, seperti Visual Studio Code, PhpStorm, atau Sublime Text. Instal ekstensi yang relevan, seperti PHP IntelliSense atau WordPress Code Snippets, karena ekstensi tersebut dapat sangat meningkatkan efisiensi pengkodean Anda.

Buatlah file plugin pertamamu.

Sebuah plugin WordPress pada dasarnya merupakan satu atau lebih komponen yang terletak di dalam struktur kode aplikasi WordPress./wp-content/plugins/File-file PHP yang berada di dalam direktori tersebut. Sekarang, mari kita mulai dari struktur yang paling dasar.

Menulis komentar di bagian kepala plugin (plugin header comments)

Setiap plugin harus memuat sebuah komentar header dalam format standar, yang digunakan oleh WordPress untuk mengidentifikasi informasi plugin tersebut. Di dalam direktori plugin Anda (misalnya…/wp-content/plugins/my-first-plugin/Dalam dokumen tersebut, buatlah sebuah entitas bernama…my-first-plugin.phpFile utama dari…

推荐阅读 Dari Pemula hingga Ahli: Panduan Lengkap untuk Pengembangan Plugin WordPress.。

<?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 mendefinisikan nama, deskripsi, dan informasi lainnya dari plugin yang ditampilkan di antarmuka administrasi WordPress. Di dalamnya,Text DomainDigunakan untuk penerjemahan internasional.

Membangun kerangka kerja keamanan dasar untuk plugin

Untuk mencegah akses langsung ke file plugin Anda, Anda dapat menambahkan kode perlindungan ke bagian awal file tersebut. Ini merupakan praktik terbaik dalam pengembangan plugin WordPress.

// 防止直接访问
if ( ! defined( 'ABSPATH' ) ) {
	exit; // 如果未定义ABSPATH（WordPress根目录的绝对路径），则退出
}

ABSPATHIni adalah sebuah konstanta yang didefinisikan oleh WordPress, yang mewakili path absolut tempat plugin tersebut terinstal. Dengan memeriksa apakah konstanta ini ada, kita dapat mencegah pengguna eksternal untuk mengakses file plugin Anda langsung melalui URL.

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

Implement core features: add a management menu and settings.

Sebuah plugin yang lengkap umumnya memerlukan antarmuka konfigurasi yang tersedia di backend WordPress. Kita akan menambahkan halaman menu administrasi yang sederhana menggunakan API yang disediakan oleh WordPress.

Menggunakan fungsi untuk menambahkan menu manajemen tingkat atas

Kami akan menggunakanadd_action()Function mounted toadmin_menuPada bagian yang ditandai dengan tanda kutip (“…”), tambahkan kode berikut untuk menambahkan sebuah item menu di bagian belakang (backend). Lanjutkan menambahkan kode berikut ke dalam file plugin utama Anda.

// 添加管理菜单
function mfp_add_admin_menu() {
    add_menu_page(
        '我的第一个插件设置', // 页面标题
        '我的插件',           // 菜单标题
        'manage_options',    // 所需权限（管理员）
        'my-first-plugin',   // 菜单slug
        'mfp_settings_page', // 显示页面内容的回调函数
        'dashicons-admin-generic', // 图标（使用Dashicons）
        80                    // 菜单位置
    );
}
add_action( 'admin_menu', 'mfp_add_admin_menu' );

Di sini,add_menu_page()Fungsi ini digunakan untuk membuat sebuah menu utama. Parameter-parameternya mendefinisikan judul halaman, judul menu, aksesibilitas (hak akses pengguna), identifikasi unik (slug), fungsi callback yang digunakan untuk menampilkan isi halaman, ikon, serta posisi menu di sidebar.

推荐阅读 Panduan Lengkap Pengembangan Plugin WordPress: Dari Nol Sampai Penerapan Nyata。

Create a callback function for the settings page.

Sekarang, kita perlu mendefinisikan hal-hal yang telah disebutkan di atas.mfp_settings_page()Fungsi tersebut akan menghasilkan konten HTML untuk halaman manajemen.

// 设置页面回调函数
function mfp_settings_page() {
    // 检查用户权限
    if ( ! current_user_can( 'manage_options' ) ) {
        return;
    }
    ?>
    <div class="wrap">
        <h1>\n</h1>
        <p>Selamat datang di halaman pengaturan untuk plugin pertamaku! Di sini, Anda dapat menambahkan formulir dan opsi di masa depan.</p>
        <form action="/id/options.php/" method="post" data-trp-original-action="options.php">
            <?php
            // 输出设置字段、非ce等（后续扩展）
            settings_fields( 'mfp_options_group' );
            do_settings_sections( 'my-first-plugin' );
            submit_button( '保存设置' );
            ?>
        <input type="hidden" name="trp-form-language" value="id"/></form>
    </div>
    \n&lt;?php
}

Fungsi ini pertama-tama memeriksa apakah pengguna saat ini memiliki…manage_optionsIzin (biasanya untuk administrator), kemudian tampilkan kerangka halaman pengaturan yang sederhana. Di dalamnya…settings_fields()和do_settings_sections()Ini disediakan untuk mengatur opsi pendaftaran API bagi penggunaan WordPress di kemudian hari.

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

Menambahkan sebuah fitur front-end yang sederhana untuk plugin.

Selain antarmuka manajemen backend, plugin umumnya digunakan untuk menyediakan fitur tambahan pada bagian frontend (tampilan) situs web. Kita akan membuat sebuah kode singkat (shortcode) yang memungkinkan pengguna untuk memanggil fitur tersebut dalam artikel atau halaman web.

Menggunakan fungsi untuk mendaftarkan kode singkat

Kode singkat memungkinkan pengguna untuk…[shortcode]Tag-tag sederhana seperti ini digunakan untuk memasukkan fungsi dinamis ke dalam konten.add_shortcode()Fungsi tersebut telah didaftarkan.

// 注册一个短代码
function mfp_hello_world_shortcode( $atts ) {
    // 短码属性，设置默认值
    $atts = shortcode_atts(
        array(
            'name' => '访客',
        ),
        $atts,
        'mfp_hello'
    );

// 安全地输出内容
    return '<p>Halo, '. esc_html($atts['name'])'. ‘! Ini adalah sapaan yang dihasilkan oleh plugin saya.</p>'php
add_shortcode('mfp_hello', 'mfp_hello_world_shortcode');

add_shortcode()Fungsi tersebut menerima dua parameter: nama tag kode singkat (nama yang digunakan oleh pengguna) dan fungsi pemrosesan yang sesuai dengannya.shortcode_atts()Fungsi ini digunakan untuk menggabungkan atribut yang dimasukkan oleh pengguna dengan nilai default, sehingga kode menjadi lebih kokoh (robust).

Menguji kode singkat di front end

Setelah menyimpan file plugin, kunjungi halaman “Plugins” di panel administrasi WordPress, lalu aktifkan “My First Plugin”. Selanjutnya, buat atau edit sebuah artikel, dan masukkan kode plugin tersebut langsung ke dalam editor konten.[mfp_hello name="小明"]Setelah artikel diterbitkan, halaman frontend akan menampilkan pesan “Halo, Xiaoming! Ini adalah sapaan yang dihasilkan oleh plugin saya.” Jika atribut `name` tidak disediakan, maka pesan tersebut akan ditampilkan tanpa nama pengguna.[mfp_hello]Maka, pesan default “Halo, pengunjung!” akan ditampilkan.

Menyimpulkan.

Dengan panduan ini, Anda telah menyelesaikan seluruh proses pembuatan sebuah plugin WordPress dasar dari nol. Anda telah mempelajari struktur dasar sebuah plugin, pentingnya komentar di bagian header, cara menambahkan menu administrasi di backend, serta cara membuat kode singkat namun praktis untuk bagian frontend. Semua ini merupakan dasar-dasar dalam pengembangan plugin WordPress.

Perjalanan sejati dalam pengembangan plugin baru saja dimulai. Selanjutnya, Anda dapat mengeksplorasi API pengaturan (settings API) yang kuat dari WordPress untuk membuat opsi-opsi yang dapat disimpan, serta memanfaatkan fitur action hooks.add_action()And filter hooksadd_filter()Anda perlu memodifikasi perilaku inti dari plugin tersebut, belajar cara menambahkan dukungan internasionalisasi (multilingual support), serta cara memproses data pengguna dengan aman. Ingatlah bahwa mengikuti standar pengkodean WordPress dan memperhatikan aspek keamanan merupakan kunci dalam mengembangkan plugin berkualitas tinggi.

FAQ - Pertanyaan yang Sering Diajukan.

Apa saja pengetahuan dasar yang diperlukan untuk mengembangkan plugin WordPress?

Anda perlu memiliki pengetahuan dasar pemrograman PHP, pemahaman tentang HTML dan CSS, serta kemampuan dalam mengoperasikan WordPress (seperti menerbitkan artikel dan menginstal tema/plug-in). Kemahiran dalam pemrograman berorientasi objek (Object-Oriented Programming/OOP) tidak wajib, tetapi sangat membantu dalam pengembangan plugin yang lebih kompleks.

Apakah nama file utama plugin harus sama dengan nama foldernya?

Tidak wajib, tetapi ini merupakan praktik terbaik yang sangat direkomendasikan, karena dapat membuat struktur menjadi lebih jelas. File PHP dari plugin utama dapat memiliki nama apa saja, tetapi komentar di bagian awal file tersebut harus benar, dan file tersebut harus berada di dalam folder yang sama dengan plugin tersebut. Nama folder biasanya sama dengan “slug” (nama unik) dari plugin tersebut.

Bagaimana cara mendebug kode plugin saya?

Selain mengaktifkannya…WP_DEBUGAnda juga dapat menggunakan…error_log()Fungsi tersebut akan menulis informasi debug ke log kesalahan server, atau menggunakan…var_dump()和wp_die()Lakukan pemeriksaan keluaran (hanya untuk lingkungan pengembangan). Menggunakan alat bantu debugging seperti Query Monitor juga merupakan pilihan yang efisien.

Bagaimana cara mengunggah plugin yang saya kembangkan ke direktori plugin resmi WordPress?

Pertama-tama, Anda perlu memastikan bahwa kode plugin Anda memenuhi persyaratan pengelolaan konten WordPress, termasuk lisensi yang kompatibel dengan GPL, kualitas kode, keamanan, dan dukungan terhadap berbagai bahasa (internasionalisasi). Setelah itu, buatlah sebuah repositori SVN di WordPress.org, kirimkan kode Anda ke sana, dan lalui proses verifikasi. WordPress menyediakan panduan terperinci mengenai cara mengirimkan plugin.