Dari Nol hingga Satu: Panduan Memulai dan Praktik Terbaik untuk Mengembangkan Plugin WordPress.

Mengapa memilih untuk mengembangkan plugin WordPress sendiri?

WordPress mampu menjadi sistem manajemen konten (Content Management System/CMS) paling populer di dunia, dan hal ini tidak lepas dari keunggulan arsitektur plugin-nya yang sangat kuat. Plugin memungkinkan pengembang untuk menambahkan hampir semua fitur ke situs web tanpa perlu mengubah kode inti (core code) WordPress. Dengan mengembangkan plugin sendiri, Anda dapat memenuhi kebutuhan yang sangat khusus, menyelesaikan masalah bisnis tertentu, meningkatkan kinerja situs web, bahkan mengkomersialisasikan solusi tersebut untuk dibagikan dan dijual di komunitas atau pasar. Menguasai keterampilan pengembangan plugin berarti Anda dapat mengendalikan perilaku WordPress secara mendalam, berubah dari pengguna tema yang pasif menjadi pencipta fitur yang aktif.

Memahami arsitektur plugin WordPress adalah langkah pertama. Semua plugin berada di…/wp-content/plugins/Di dalam direktori tersebut, setiap plugin memiliki foldernya sendiri. WordPress mengenali dan memuat plugin dengan memindai file PHP utama yang ada di dalam direktori tersebut. Desain modular ini memastikan isolasi fungsional, keamanan, serta kemudahan dalam pemeliharaan (maintenance).

Membangun plugin WordPress pertama Anda

Struktur dasar file untuk membuat plugin

Sebuah plugin WordPress yang paling sederhana pun memerlukan setidaknya satu file PHP utama. Mari kita mulai dengan membuat file yang bernama…my-first-pluginBuka folder tersebut, lalu buat file utama di dalamnya.my-first-plugin.phpKomentar di bagian awal file ini sangat penting, karena berfungsi untuk memberikan informasi meta tentang plugin kepada WordPress.

推荐阅读 Panduan Lengkap untuk Pengembangan Plugin WordPress: Membangun Fitur Kustom dari Nol Hingga Satu.。

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

Masukkan folder yang berisi kode di atas ke dalam…/wp-content/plugins/Kemudian, masuk ke halaman “Plugin” di panel administrasi WordPress, dan Anda akan dapat melihat serta mengaktifkan plugin tersebut. Meskipun plugin ini belum memiliki fungsi apa pun saat ini, Anda telah berhasil membuat kerangka plugin yang memenuhi persyaratan yang dibutuhkan.

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

Menambahkan sebuah fitur sederhana ke plugin

Mari kita tambahkan sebuah fitur dasar untuk plugin ini: menambahkan teks kustom secara otomatis di akhir isi artikel. Untuk ini, kita perlu menggunakan hook filter dari WordPress.the_content。

在my-first-plugin.phpDi bawah komentar header, tambahkan kode berikut:

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

Kode ini mendefinisikan sebuah fungsi.myfp_add_footer_textHal tersebut menerima isi artikel.$contentSebagai parameter, di dalam fungsi tersebut penggunaan tag kondisional dilakukan untuk menentukan proses yang akan dijalankan berdasarkan nilai parameter tersebut.is_single()Melakukan penilaian terlebih dahulu untuk memastikan bahwa teks hanya ditambahkan pada halaman artikel tunggal. Setelah itu, gunakan…add_filter()Fungsi tersebut akan menggantung (menghubungkan) fungsi yang kita buat sendiri ke sistem yang digunakan.the_contentPada filter ini, setelah Anda menyimpan file dan membaca artikel apa pun, Anda akan melihat bahwa teks yang kami tambahkan sudah muncul di bagian bawahnya.

Mengikuti praktik terbaik dalam pengembangan plugin WordPress

Pastikan keamanan kode dan validasi data.

Saat memproses data masukan atau keluaran dari pengguna dalam sebuah plugin, keamanan merupakan hal yang paling penting untuk diperhatikan. WordPress menyediakan banyak fungsi untuk membantu pengembang melakukan validasi data, pengelolaan karakter (escaping), dan pembersihan data. Jangan pernah menggunakan data tersebut secara langsung.$_GET、$_POST或$_REQUESTVariabel yang terdapat di dalam teks tersebut.

推荐阅读 Menganalisis secara mendalam pengembangan plugin WordPress: Membangun ekstensi fungsionalitas kustom dari nol.。

Misalnya, ketika Anda mendapatkan sebuah ID dari parameter URL dan menggunakannya untuk melakukan kueri ke basis data, Anda harus melakukannya dengan cara berikut:

// 安全地获取并验证一个URL整数参数
$item_id = isset( $_GET['id'] ) ? absint( $_GET['id'] ) : 0;
if ( $item_id > 0 ) {
    // 使用 $item_id 进行安全查询
    global $wpdb;
    $query = $wpdb->prepare( "SELECT * FROM {$wpdb->prefix}my_table WHERE id = %d", $item_id );
    $result = $wpdb->get_row( $query );
}

Di sini,absint()Fungsi tersebut memaksa input untuk diubah menjadi bilangan bulat non-negatif.$wpdb->prepare()Metode ini digunakan untuk menyiapkan pernyataan SQL dengan aman, guna mencegah serangan SQL injection. Untuk setiap data dinamis yang akan ditampilkan di halaman HTML, metode tersebut harus digunakan.esc_html()、esc_attr()或wp_kses_post()Fungsi-fungsi seperti ini digunakan untuk melakukan proses “escaping” (penggantian karakter khusus dengan karakter biasa).

Mengimplementasikan fitur terjemahan dan dukungan internasionalisasi

Agar plugin Anda dapat digunakan oleh pengguna di seluruh dunia, internasionalisasi (i18n) sangat penting. Hal ini mengharuskan semua teks yang ditujukan untuk pengguna untuk dibungkus menggunakan fungsi penerjemahan 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

Ubah kode yang sebelumnya digunakan untuk menambahkan teks, sehingga kode tersebut dapat mendukung proses penerjemahan.

function myfp_add_footer_text( $content ) {
    if ( is_single() && in_the_loop() && is_main_query() ) {
        // 使用 __() 函数使字符串可翻译
        $footer_text = sprintf(
            '<p><em>%s</em></p>',
            esc_html__( '感谢阅读本文，由“我的第一个插件”为您呈现。', 'my-first-plugin' )
        );
        $content .= $footer_text;
    }
    return $content;
}

Kami menggunakan…esc_html__( ‘字符串’, ‘text-domain’ )Untuk mengemas teks. Di antaranya,my-first-pluginIni adalah bidang teks (Text Domain) yang didefinisikan di bagian atas plugin, yang memastikan independensi proses penerjemahan. Setelah itu, penerjemah dapat menggunakannya..potFile tersebut digunakan untuk membuat versi plugin dalam berbagai bahasa..moFile terjemahan.

Menulis kode yang dapat dipelihara dan menggunakan pemrograman berorientasi objek.

Untuk plugin yang sederhana, penggunaan pemrograman prosedural mungkin sudah cukup. Namun, untuk plugin dengan fungsi yang kompleks, penggunaan pemrograman berorientasi objek (Object-Oriented Programming/OOP) dapat membantu mengorganisir kode dengan lebih baik, sehingga meningkatkan keterbacaan dan kemudahan pemeliharaannya.

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

Berikut adalah contoh penggunaan kelas untuk merekonstruksi plugin kita:

class My_First_Plugin {
    /**
     * 构造函数，用于初始化动作和过滤器
     */
    public function __construct() {
        add_action( 'init', array( $this, 'load_textdomain' ) );
        add_filter( 'the_content', array( $this, 'add_footer_to_content' ) );
    }

/**
     * 加载插件文本域用于国际化
     */
    public function load_textdomain() {
        load_plugin_textdomain( 'my-first-plugin', false, dirname( plugin_basename( __FILE__ ) ) . '/languages' );
    }

/**
     * 在文章内容后添加文本
     */
    public function add_footer_to_content( $content ) {
        if ( is_single() && in_the_loop() && is_main_query() ) {
            $footer_text = sprintf(
                '<p><em>%s</em></p>',
                esc_html__( '感谢阅读本文，由“我的第一个插件”为您呈现。', 'my-first-plugin' )
            );
            $content .= $footer_text;
        }
        return $content;
    }
}

// 初始化插件类
new My_First_Plugin();

Dengan mengemas fungsi-fungsi tersebut dalam sebuah kapsul (encapsulation).My_First_PluginDalam kelas tersebut, struktur kode menjadi lebih jelas, sehingga terhindar dari kontaminasi fungsi yang berasal dari ruang nama global (global namespace), dan juga lebih mudah untuk melakukan ekspansi fungsional.

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 antarmuka pengelolaan dan opsi pengaturan untuk plugin

Create a management menu and options page.

Banyak plugin memerlukan opsi konfigurasi untuk pengguna. WordPress menyediakan API untuk menambahkan halaman menu dan sub-menu di bagian belakang (backend). Penggunaan API ini sangat disarankan.add_options_page()Fungsi tersebut menambahkan halaman pengaturan plugin ke menu utama “Settings”, yang sesuai dengan standar pengalaman pengguna WordPress.

class My_First_Plugin_Admin {
    public function __construct() {
        add_action( 'admin_menu', array( $this, 'add_admin_menu' ) );
        add_action( 'admin_init', array( $this, 'register_settings' ) );
    }

public function add_admin_menu() {
        add_options_page(
            '我的插件设置',          // 页面标题
            '我的第一个插件',        // 菜单标题
            'manage_options',       // 所需权限
            'myfp-settings',        // 菜单slug
            array( $this, 'render_settings_page' ) // 回调函数
        );
    }

public function register_settings() {
        register_setting( 'myfp_settings_group', 'myfp_footer_text' );
        add_settings_section( 'myfp_main_section', '主要设置', null, 'myfp-settings' );
        add_settings_field( 'myfp_text_field', '页脚文本', array( $this, 'render_text_field' ), 'myfp-settings', 'myfp_main_section' );
    }

public function render_text_field() {
        $value = get_option( 'myfp_footer_text', '默认的感谢文本。' );
        echo '<input type="text" name="myfp_footer_text" value="' . esc_attr( $value ) . '" class="regular-text" />';
    }

public function render_settings_page() {
        ?&gt;
        <div class="wrap">
            <h1>\n</h1>
            <form action="/id/options.php/" method="post" data-trp-original-action="options.php">
                <?php
                settings_fields( 'myfp_settings_group' );
                do_settings_sections( 'myfp-settings' );
                submit_button();
                ?>
            <input type="hidden" name="trp-form-language" value="id"/></form>
        </div>
        &lt;?php
    }
}

// 仅在管理后台加载管理类
if ( is_admin() ) {
    new My_First_Plugin_Admin();
}

Menghubungkan fungsi plugin dengan opsi pengaturan

Setelah halaman pengaturan dibuat, kita perlu memodifikasi fungsi frontend agar menggunakan nilai opsi yang disimpan oleh pengguna, bukan teks yang dikodekan secara tetap (hard-coded).

Sebelum diperbaruiMy_First_Pluginwithin the classadd_footer_to_contentMetode:

public function add_footer_to_content( $content ) {
    if ( is_single() && in_the_loop() && is_main_query() ) {
        // 从数据库选项获取用户自定义的文本，如果不存在则使用默认翻译
        $saved_text = get_option( 'myfp_footer_text' );
        $footer_text = ! empty( $saved_text ) ? esc_html( $saved_text ) : esc_html__( '感谢阅读本文，由“我的第一个插件”为您呈现。', 'my-first-plugin' );

$content .= sprintf( '<p><em>%s</em></p>', $footer_text );
    }
    return $content;
}

Sekarang, teks di bagian kaki halaman plugin dapat disesuaikan melalui halaman pengaturan di backend, sehingga terjadi pemisahan antara fungsi dan konfigurasi. Hal ini sangat meningkatkan fleksibilitas plugin.

Menyimpulkan.

Pengembangan plugin WordPress merupakan proses yang dimulai dengan memahami arsitektur dasarnya, kemudian secara bertahap mempelajari aspek-aspek terkait keamanan, internasionalisasi (penggunaan berbagai bahasa), organisasi kode, dan interaksi dengan pengguna. Inti dari pengembangan plugin ini adalah mengikuti standar pemrograman WordPress serta praktik terbaik yang ditetapkan oleh komunitas pengguna WordPress, termasuk penggunaan sistem hook (Actions dan Filters) yang disediakan oleh platform tersebut, memastikan keamanan data, mendukung berbagai bahasa, serta membuat antarmuka pengelolaan yang mudah dipahami. Anda dapat mempelajari seluruh proses pengembangan plugin secara sistematis dengan memulai dari membuat plugin sederhana, kemudian secara bertahap menambahkan opsi pengaturan dan merekonstruksi kode tersebut menjadi struktur yang berorientasi objek. Ingatlah bahwa sebuah plugin yang berkualitas tidak hanya perlu dapat berjalan dengan baik, tetapi juga harus aman, efisien, mudah diperawat, dan ramah terhadap pengguna dari berbagai latar belakang bahasa.

FAQ - Pertanyaan yang Sering Diajukan.

Apa saja pengetahuan dasar yang diperlukan untuk mengembangkan plugin WordPress?

Anda perlu memiliki dasar pemrograman PHP yang kuat, karena plugin tersebut sebagian besar ditulis menggunakan PHP. Selain itu, Anda perlu memahami dasar-dasar HTML, CSS, dan JavaScript untuk membuat antarmuka dan interaksi pengguna di sisi front end. Memahami konsep-konsep dasar WordPress, seperti tema, jenis artikel, sistem klasifikasi, metadata, serta mekanisme hook (action dan filter), sangat penting untuk mengembangkan plugin dengan sukses. Kebiasaan dengan operasi dasar basis data MySQL juga akan sangat membantu dalam menangani data yang kompleks.

Bagaimana cara mendebug plugin WordPress yang sedang dikembangkan?

Pertama-tama, pastikan bahwa…wp-config.phpBuka file tersebut.WP_DEBUG和WP_DEBUG_LOGIni akan mencatat kesalahan dan peringatan PHP ke dalam…/wp-content/debug.logDalam file tersebut, hindari menampilkan pesan kesalahan langsung kepada pengguna. Selanjutnya, hal tersebut dapat dimanfaatkan untuk…error_log()Fungsi tersebut menghasilkan informasi debug khusus ke dalam berkas log yang sama. Untuk memeriksa nilai variabel, gunakan…print_r()或var_dump()Fungsi tersebut, digunakan bersama dengan…echo ‘’;Gunakan fitur pemformatan hanya dalam lingkungan pengembangan. Selain itu, gunakan panel Console dan Network pada alat pengembang browser (F12) untuk mendeteksi dan memperbaiki masalah terkait kode JavaScript dan permintaan AJAX.

Bagaimana cara plugin saya berinteraksi dengan layanan pihak ketiga atau API?

Berinteraksi dengan API pihak ketiga merupakan cara umum untuk memperluas fungsi sebuah plugin. Di WordPress, penggunaan API HTTP bawaan (seperti…) disarankan.wp_remote_get()， wp_remote_post()Gunakan protokol HTTPS untuk mengirimkan permintaan, karena protokol ini menangani masalah terkait kompatibilitas, waktu tunggu (timeout), dan keamanan. Pastikan untuk menggunakan HTTPS saat mengirimkan data sensitif. Untuk respons API yang diterima, biasanya diperlukan pemecahan kode (decoding) data dalam format JSON.json_decode()Anda perlu memproses data dalam format JSON atau XML, serta melakukan penanganan kesalahan dengan baik, seperti memeriksa kode status HTTP dan kode kesalahan yang dikembalikan oleh API. Disarankan untuk menyimpan informasi sensitif seperti kunci API di dalam pengaturan plugin, bukan di kode sumber (file) secara langsung (hard-coded).

Bagaimana cara mengirimkan plugin gratis saya ke direktori plugin resmi WordPress?

Pertama-tama, Anda perlu memastikan bahwa plugin Anda sepenuhnya mematuhi lisensi GPL, memiliki kualitas kode yang tinggi, dan tidak mengandung tautan jahat atau iklan. Buat akun di WordPress.org, lalu kunjungi bagian “Pengembang” untuk mengajukan plugin Anda. Anda perlu menyediakan paket kompresi plugin yang stabil (dalam format ZIP), yang berisi informasi header plugin yang sesuai dengan standar, serta…readme.txtFile (yang menggunakan format tertentu untuk mendeskripsikan plugin), beserta screenshot dan ikon (yang bersifat opsional). Setelah dikirim, tim pemeriksaan plugin akan melakukan peninjauan, dan proses ini mungkin memakan waktu beberapa minggu. Setelah lulus pemeriksaan, Anda akan mendapatkan repositori SVN resmi untuk mengelola kode Anda, sehingga pengguna dapat langsung mencari dan menginstal plugin Anda dari panel administrasi WordPress.