Mengembangkan Plugin WordPress, dari Pemula hingga Ahli: Panduan Langkah demi Langkah untuk Membuat Fitur Kustomisasi.

Pengaturan Lingkungan Pengembangan Plugin WordPress

Sebelum memulai menulis baris kode pertama, memiliki lingkungan pengembangan yang tepat merupakan fondasi penting untuk bekerja dengan efisien. Hal ini tidak hanya dapat memastikan bahwa plugin Anda dapat berjalan dengan stabil di berbagai lingkungan WordPress, tetapi juga dapat sangat meningkatkan efisiensi proses debugging dan pengujian.

Mengatur lingkungan pengembangan lokal.

Sangat disarankan untuk melakukan pengembangan di lingkungan lokal, bukan langsung di server online. Anda dapat menggunakan alat-alat seperti XAMPP, MAMP, Local by Flywheel, atau Docker untuk dengan cepat membangun lingkungan server lokal yang mencakup PHP, MySQL, dan Apache/Nginx. Pastikan versi PHP yang Anda gunakan kompatibel dengan versi WordPress yang ingin Anda gunakan; biasanya, pihak WordPress secara resmi akan merekomendasikan rentang versi PHP tertentu.

Pemilihan Editor dan Alat Pengedit Kode

Memilih editor kode yang kuat sangat penting, seperti VS Code, PhpStorm, atau Sublime Text. Editor-editor tersebut biasanya menyediakan fitur seperti penyorotan sintaks, saran kode (code hints), dan integrasi dengan sistem pengelolaan versi (version control). Selain itu, dengan menginstal beberapa potongan kode (snippets) atau plugin yang berkaitan dengan WordPress, proses pengembangan dapat dipercepat.add_action、add_filterPenulisan fungsi-fungsi umum lainnya.

推荐阅读 Menguasai Pengembangan Plugin WordPress Dari Nol: Membangun Fungsi Khusus dan Praktik Terbaik。

Membuat file utama untuk plugin

Setiap plugin WordPress harus memiliki sebuah file PHP utama, dan di bagian awal file tersebut harus terdapat komentar yang berisi informasi standar tentang plugin tersebut. File ini merupakan titik masuk (entry point) untuk plugin. Misalnya, jika kita berencana membuat sebuah plugin dengan nama “My Custom Greeting”, maka nama file PHP utamanya bisa diatur sebagai…my-custom-greeting.php。

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: My Custom Greeting
 * Plugin URI:  https://yourwebsite.com/my-custom-greeting
 * Description: 一个简单的插件，用于在网站前台显示自定义问候语。
 * Version:     1.0.0
 * Author:      Your Name
 * License:     GPL v2 or later
 * Text Domain: my-custom-greeting
 */

Komentar ini diperlukan; WordPress menggunakan komentar tersebut untuk mengenali plugin dan menampilkan informasi plugin tersebut di antarmuka manajemen backend.

Struktur Dasar Plugin dan Standar Keamanan

Sebuah plugin yang memiliki struktur yang jelas dan memenuhi standar keamanan merupakan dasar untuk pemeliharaan jangka panjang serta memperoleh kepercayaan dari pengguna. Mengikuti standar pemrograman dan praktik keamanan resmi WordPress dapat secara efektif mencegah kelemahan (vulnerability) yang umum terjadi.

Menggunakan kelas untuk mengorganisir kode

Meskipun Anda dapat menggunakan pemrograman fungsional murni, penggunaan kelas berorientasi objek (OOP) untuk mengenkapsulasi fungsi plugin merupakan pendekatan yang lebih modern dan direkomendasikan. Pendekatan ini membantu menghindari konflik nama fungsi serta membuat struktur kode lebih jelas. Mari kita buat sebuah kelas utama.My_Custom_Greeting。

if ( ! class_exists( 'My_Custom_Greeting' ) ) {
    class My_Custom_Greeting {
        public function __construct() {
            // 构造函数，在这里挂载钩子
        }
    }
    // 初始化插件
    new My_Custom_Greeting();
}

! class_exists()Pemeriksaan tersebut dilakukan untuk mencegah terjadinya definisi berulang dari sebuah kelas (class).

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

Mengimplementasikan mekanisme keamanan dan pemeriksaan hak akses

Semua fungsi yang mungkin memproses permintaan pengguna, baik di sisi frontend maupun backend, harus melakukan pemeriksaan hak akses (permission) dan pemeriksaan keamanan (security checks). WordPress menyediakan fitur untuk hal tersebut.wp_verify_nonce()和current_user_can()Gunakan fungsi-fungsi tertentu untuk membantu mewujudkannya. Hal ini merupakan persyaratan wajib dalam halaman pengaturan plugin atau logika pemrosesan formulir.

Direktori Plugin dan Organisasi File

Struktur direktori yang masuk akal membantu dalam proses pengelolaan. Sebuah direktori plugin yang tipikal dapat berisi:
File utama. my-custom-greeting.php (Terdapat di direktori akar plugin.)
- includes/ Daftar Isi: Berisi file-file yang berkaitan dengan kelas-kelas fungsional inti (core functions).
- admin/ Daftar Isi: Berisi kode terkait bagian belakang (backend).
- public/ Daftar Isi: Berisi kode terkait bagian frontend (tampilan pengguna).
- assets/ Daftar Isi: Berisi file CSS, JavaScript, dan gambar.
- languages/ Daftar Isi: Berisi berkas-berkas terjemahan internasional (.po/.mo)

Fitur Utama: Penerapan Praktis dari Hook dan Filter

Mekanisme plugin di WordPress berpusat pada “hook” (pautan/koneksi), yang terdiri dari Action (tindakan) dan Filter (filter). Memahami dan menguasai penggunaan hook dengan baik merupakan kunci dalam pengembangan plugin.

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

Menggunakan action hook untuk menambahkan fitur

Action hooks memungkinkan Anda untuk menjalankan kode kustom pada titik waktu tertentu, seperti saat proses inisialisasi, saat halaman diunduh, atau saat artikel diterbitkan. Kami menggunakan…add_action()Fungsi tersebut digunakan untuk melakukan proses “mounting”. Misalnya, dalam…wp_footerTambahkan ucapan selamat kami di bagian yang ditandai dengan tanda “kutip” (“hook”).

在My_Custom_GreetingMenghubungkan (meng-mount) komponen dalam konstruktor kelas:

public function __construct() {
    add_action( 'wp_footer', array( $this, 'display_greeting' ) );
}

Kemudian, definisikan metode panggilan balik (callback method) yang sesuai.display_greeting：

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

public function display_greeting() {
    $name = get_option( 'my_greeting_name', '访客' );
    echo '<p id="custom-greeting">Halo, '. esc_html($name)'. ‘! Selamat datang di situs kami.</p>';
}

Menggunakan filter hook untuk memodifikasi konten

Filter hooks memungkinkan Anda untuk memodifikasi data yang dihasilkan oleh WordPress atau plugin lainnya. Kami menggunakan…add_filter()Fungsi. Misalnya, untuk mengubah ekstensi default dari judul artikel.

add_filter( 'the_title', array( $this, 'modify_post_title' ), 10, 2 );

public function modify_post_title( $title, $id ) {
    if ( ! is_admin() && in_the_loop() ) {
        $title .= ' [推荐阅读]';
    }
    return $title;
}

Parameter di sini…10Itu adalah masalah prioritas.2Menunjukkan bahwa fungsi panggilan balik (callback function) menerima dua parameter.$title和$id）。

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

Membuat hook kustom

Sebuah plugin yang matang juga seharusnya menyediakan “hook”-nya sendiri, agar dapat diperluas oleh pengembang lain.do_action()Create an action hook and use it.apply_filters()Membuat filter hook.

// 在插件某处执行一个自定义动作
do_action( 'my_custom_greeting_before_display', $name );

// 提供一个可过滤的问候语文本
$greeting_text = apply_filters( 'my_custom_greeting_text', '你好，' . $name . '！', $name );

Membuat antarmuka pengelolaan untuk plugin

Sebagian besar plugin memerlukan halaman pengaturan di backend agar pengguna dapat mengonfigurasi perilaku plugin tersebut. WordPress menyediakan API yang lengkap untuk membuat halaman menu dan halaman opsi.

Tambahkan menu pengelolaan.

Gunakanadd_action( ‘admin_menu’, … )Kita menggunakan “hook” untuk menambahkan item menu. Kita juga menambahkan halaman menu anak yang berada di bawah menu “Settings” untuk plugin tersebut.

add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );

public function add_admin_menu() {
    add_options_page(
        '自定义问候语设置', // 页面标题
        '问候语设置',       // 菜单标题
        'manage_options',   // 所需权限
        'my-custom-greeting', // 菜单slug
        array( $this, 'render_settings_page' ) // 回调函数，用于输出页面内容
    );
}

Membangun halaman pengaturan dan formulir

Dalam fungsi panggilan balik (callback function)render_settings_pageDi sini, kita perlu membuat sebuah formulir dan menggunakan API Pengaturan WordPress untuk menyimpan data dengan aman. Pertama-tama, daftarkan sebuah pengaturan (setting).

add_action( 'admin_init', array( $this, 'register_settings' ) );

public function register_settings() {
    register_setting(
        'my_custom_greeting_options_group', // 选项组名
        'my_greeting_name',                 // 选项名
        array( 'sanitize_callback' => 'sanitize_text_field' ) // 清理回调
    );
}

Kemudian, outputkan formulir tersebut dalam fungsi rendering halaman:

public function render_settings_page() {
    ?>
    <div class="wrap">
        <h2>Pengaturan ucapan selamat tinggal yang disesuaikan</h2>
        <form method="post" action="/id/options.php/" data-trp-original-action="options.php">
            <?php settings_fields( 'my_custom_greeting_options_group' ); ?>
            <table class="form-table">
                <tr>
                    <th scope="row"><label for="greeting_name">Nama orang yang dituju dalam sapaan</label></th>
                    <td>
                        <input type="text" id="greeting_name" name="my_greeting_name" value="<?php echo esc_attr( get_option( 'my_greeting_name', '访客' ) ); ?>" class="regular-text" />
                        <p class="description">Nama yang dimasukkan di sini akan ditampilkan dalam pesan sapaan di halaman depan (frontend).</p>
                    </td>
                </tr>
            </table>
            <?php submit_button(); ?>
        <input type="hidden" name="trp-form-language" value="id"/></form>
    </div>
    \n&lt;?php
}

Menambahkan skrip dan tabel gaya (style sheet)

Untuk membuat antarmuka pengelolaan lebih menarik secara visual atau lebih interaktif, diperlukan penambahan kode CSS dan JavaScript ke halaman pengaturan.admin_enqueue_scriptsGunakan “hook” (mekanisme penghubung dalam kode program) untuk memeriksa nilai “slug” dari halaman tersebut, sehingga halaman tersebut hanya akan dimuat ketika plugin kita diaktifkan.

add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_admin_assets' ) );

public function enqueue_admin_assets( $hook ) {
    if ( 'settings_page_my-custom-greeting' !== $hook ) {
        return;
    }
    wp_enqueue_style( 'my-custom-greeting-admin', plugin_dir_url( __FILE__ ) . 'assets/css/admin-style.css' );
    wp_enqueue_script( 'my-custom-greeting-admin', plugin_dir_url( __FILE__ ) . 'assets/js/admin-script.js', array( 'jquery' ), '1.0.0', true );
}

Menyimpulkan.

Dengan mengikuti langkah-langkah yang dijelaskan dalam artikel ini, kita telah menyelesaikan proses pengembangan sebuah plugin WordPress yang lengkap: mulai dari membangun lingkungan pengembangan, membuat struktur keamanan dasar, hingga menerapkan mekanisme aksi (actions) dan filter hook untuk mengimplementasikan fungsi-fungsi inti plugin, serta membuat antarmuka pengelolaan yang user-friendly (ramah pengguna). Inti dari pengembangan plugin terletak pada pemahaman yang mendalam tentang sistem hook WordPress dan pematuhan terhadap standar keamanan serta penulisan kode yang ditetapkan oleh WordPress. Dari plugin sederhana ini, Anda dapat terus memperluas fungsinya dengan memasukkan lebih banyak kelas (classes), menggunakan operasi basis data yang lebih kompleks, mengintegrasikan REST API, atau membuat blok kustom (seperti Gutenberg Block), sehingga pada akhirnya Anda dapat membuat plugin yang memiliki fungsi yang kuat dan mudah dikelola.

FAQ - Pertanyaan yang Sering Diajukan.

Bagaimana cara mendebug (debug) plugin WordPress saya?
Mengaktifkan mode debug di WordPress merupakan cara yang paling efektif.wp-config.phpDalam dokumen tersebut, akan...WP_DEBUGKonstanta diatur ketrueIni akan langsung menampilkan kesalahan PHP, peringatan, dan pemberitahuan di halaman web. Untuk debugging yang lebih kompleks, Anda dapat menggunakan alat-alat khusus.error_log()Fungsi tersebut mencatat informasi ke dalam log kesalahan (error log) server, atau menggunakan alat debugging PHP yang profesional seperti Xdebug.

Bagaimana cara agar plugin saya kompatibel dengan berbagai versi PHP?

Selama proses pengembangan, sebaiknya dihindari penggunaan fungsi PHP yang terlalu baru atau yang sudah usang serta tidak lagi didukung (ditinggalkan). Periksa manual resmi PHP untuk mengetahui versi minimum yang didukung oleh suatu fungsi. Informasi ini dapat disertakan dalam berkas utama plugin atau dokumen yang menjelaskan penggunaan plugin tersebut.Requires PHP:Tag header digunakan untuk menyatakan versi PHP minimum yang diperlukan oleh plugin tersebut, sehingga WordPress akan memberikan peringatan jika kondisi tersebut tidak terpenuhi.

Bagaimana cara membuat plugin saya mendukung internasionalisasi dalam berbagai bahasa?

WordPress menggunakan kerangka kerja GNU gettext untuk mendukung fitur internasionalisasi (i18n). Langkah pertama yang perlu dilakukan adalah dengan menggunakan tag khusus di semua bagian teks yang perlu diterjemahkan.__()、_e()或_x()Fungsi-fungsi tersebut kemudian dibungkus (dipaketkan) menggunakan teknik tertentu. Setelah itu, alat seperti Poedit digunakan untuk memindai kode tersebut dan menghasilkan (menggenerasikan) berbagai file yang diperlukan..potFile template; kemudian buat file template yang sesuai untuk masing-masing bahasa..po和.moFile. Terakhir, gunakan file tersebut saat plugin diunduh (diload).load_plugin_textdomain()Memuat dan menerjemahkan fungsi.

Apa yang perlu diperhatikan saat mengirimkan plugin ke direktori resmi WordPress?

Sebelum mengirimkan, pastikan bahwa kode tersebut benar-benar mematuhi standar pengkodean dan pedoman dokumentasi WordPress. Plugin tersebut harus menggunakan lisensi yang kompatibel dengan GPLv2 atau versi yang lebih baru. Anda perlu menyediakan informasi yang lengkap mengenai lisensi tersebut.readme.txtFile tersebut berisi deskripsi, langkah-langkah instalasi, tangkapan layar, pertanyaan-pertanyaan umum, dan lainnya. Kode yang Anda kirimkan harus aman, tidak mengandung perilaku merugikan, dan tidak boleh bergantung pada Shortcode untuk fungsionalitas intinya; kode tersebut harus siap digunakan langsung setelah diinstal. Setelah dikirimkan, tim audit akan melakukan pemeriksaan yang ketat.