Panduan Lengkap untuk Pengembangan Plugin WordPress: Membangun Fitur Kustom dari Nol Hingga Satu.

Preparasi dan pengaturan lingkungan.

Sebelum memulai menulis kode, memiliki lingkungan pengembangan yang stabil dan profesional merupakan dasar penting untuk keberhasilan. Hal ini tidak hanya dapat meningkatkan efisiensi pengkodean Anda, tetapi juga memastikan kompatibilitas plugin di berbagai lingkungan.

Konfigurasi lingkungan pengembangan lokal.

Disarankan untuk menggunakan paket lingkungan server lokal, seperti Local by Flywheel, XAMPP, atau MAMP. Alat-alat ini memungkinkan Anda menginstal Apache, MySQL, dan PHP dengan satu klik, sehingga dapat mereplikasi lingkungan server secara sempurna. Pastikan bahwa versi PHP yang Anda gunakan sesuai dengan persyaratan versi WordPress yang ingin Anda gunakan; umumnya disarankan untuk menggunakan PHP 7.4 atau versi yang lebih baru untuk mendapatkan kinerja dan keamanan yang lebih baik.

Pemilihan Editor dan Alat Pengedit Kode

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 (code hints), dan alat debugging. Selain itu, menginstal alat kontrol versi (version control) seperti Git merupakan standar industri untuk mengelola perubahan kode, bekerja sama dalam tim, dan membuat cadangan kode.

推荐阅读 Panduan Utama untuk Mengembangkan Plugin WordPress: Jalan Menuju Keahlian, dari Pemula hingga Praktisi.。

Buatlah file plugin pertamamu.

Bagian paling inti dari sebuah plugin WordPress adalah file utamanya. File ini tidak hanya berisi kode eksekusi plugin, tetapi juga menyatakan metainformasi plugin kepada sistem WordPress melalui komentar header file yang khusus.

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

Struktur file utama plugin

Setiap plugin harus memiliki satu file PHP utama. Kita biasanya menamai file tersebut berdasarkan fungsi dari plugin tersebut, misalnya… my-first-plugin.phpPada awal file, harus terdapat komentar header plugin yang standar; ini merupakan kunci bagi WordPress untuk mengenali plugin tersebut.

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

Komentar ini memberitahu WordPress untuk menampilkan informasi seperti nama dan deskripsi plugin di halaman “Plugin” di bagian belakang (backend). Text Domain Digunakan untuk internasionalisasi, sebagai persiapan untuk pekerjaan penerjemahan selanjutnya.

Mengaktifkan dan menonaktifkan plugin

Setelah membuat file utama, Anda perlu meletakkannya di dalam direktori instalasi WordPress. /wp-content/plugins/ Berada di dalam folder tersebut. Bisa diletakkan secara terpisah, atau bisa dibuatkan direktori khusus untuknya (misalnya…). /wp-content/plugins/my-first-plugin/Setelah itu, letakkan file utama (main file) ke dalam folder tersebut. Setelah selesai, masuk ke panel administrasi WordPress, lalu kunjungi halaman “Plugins”. Di sana, Anda akan melihat plugin baru tersebut dan dapat mengklik “Aktifkan” (Enable) untuk mengaktifkannya.

Memahami Mekanisme Inti WordPress: Hook dan Filter

Kekuatan dan fleksibilitas WordPress sebagian besar berasal dari sistem “Hook-nya”. Plugin dapat mengubah atau menambahkan fungsi pada WordPress tanpa perlu memodifikasi kode inti (core code) dengan cara “menggantungkan” (mounting) diri pada hook-hook tersebut.

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

Penggunaan Action Hook

Action Hooks memungkinkan Anda untuk menjalankan kode kustom pada titik waktu tertentu, seperti saat artikel diterbitkan, saat pengguna masuk, atau saat halaman administrasi diunduh. add_action() Fungsi tersebut dapat digunakan untuk “menggantungkan” (menghubungkan) fungsi Anda ke hook (titik koneksi) yang telah ditentukan.

Contoh di bawah ini menunjukkan cara menambahkan teks kustom di bagian bawah halaman depan sebuah situs web. Kita menggunakan… wp_footer Action hook ini…

function myplugin_add_footer_text() {
    echo '<p style="text-align:center;">Terima kasih telah menggunakan situs web ini!</p>';
}
add_action( 'wp_footer', 'myplugin_add_footer_text' );

Penggunaan Filter

Filter digunakan untuk memodifikasi data yang dihasilkan selama proses. Berbeda dengan aksi (actions), filter memerlukan sebuah nilai masukan dan harus mengembalikan nilai yang telah dimodifikasi. add_filter() Fungsi tersebut digunakan untuk menerapkan filter.

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

Sebagai contoh, kode di bawah ini mengubah tampilan konten di akhir judul artikel, dengan menambahkan sebuah ekstensi (suffix) ke semua judul. Kita menggunakan… the_title Filter ini.

function myplugin_modify_title( $title ) {
    // 确保只在主循环中修改
    if ( is_single() ) {
        return $title . ' [推荐阅读]';
    }
    return $title;
}
add_filter( 'the_title', 'myplugin_modify_title' );

Menambahkan halaman pengaturan untuk plugin

Sebuah plugin yang matang biasanya perlu menyediakan opsi konfigurasi bagi pengguna. Di WordPress, ada metode standar untuk membuat halaman pengaturan (setting page) untuk sebuah plugin, yang dapat ditambahkan ke berbagai posisi dalam menu administrasi (backend menu).

Membuat item menu administrasi

Pertama-tama, Anda perlu menggunakan… add_action( ‘admin_menu’, … ) Gunakan fungsi-fungsi yang tersedia di WordPress untuk mendaftarkan halaman menu baru. WordPress menyediakan berbagai fungsi untuk menambahkan menu pada berbagai tingkatan (level). add_menu_page()(Top Menu) atau add_options_page()(Tambahkan ke sub-menu “Pengaturan”).

推荐阅读 Panduan Lengkap untuk Mengembangkan Plugin WordPress: Dari Pemula hingga Ahli dalam Membuat Plugin Fungsional.。

Kode di bawah ini mendemonstrasikan cara membuat halaman menu utama yang sederhana. myplugin_settings_page_html Tanggung jawab untuk merender konten HTML dari halaman tersebut.

function myplugin_add_menu() {
    add_menu_page(
        ‘我的插件设置’,          // 页面标题
        ‘我的插件’,             // 菜单标题
        ‘manage_options’,      // 所需权限
        ‘myplugin’,            // 菜单 Slug
        ‘myplugin_settings_page_html’, // 回调函数
        ‘dashicons-admin-generic’, // 图标（可选）
        20                     // 位置（可选）
    );
}
add_action( ‘admin_menu’, ‘myplugin_add_menu’ );

function myplugin_settings_page_html() {
    // 检查用户权限
    if ( ! current_user_can( ‘manage_options’ ) ) {
        return;
    }
    ?>
    <div class="“wrap”">
        <h1>\n</h1>
        <form action="/id/“options.php”/" method="“post”" data-trp-original-action="“options.php”">
            <?php
            // 输出设置字段
            settings_fields( ‘myplugin_options’ );
            do_settings_sections( ‘myplugin’ );
            submit_button( ‘保存设置’ );
            ?>
        <input type="hidden" name="trp-form-language" value="id"/></form>
    </div>
    \n&lt;?php
}

Pengaturan Pendaftaran, Bidang, dan Bagian (Registration Settings, Fields, and Sections)

Untuk memungkinkan formulir di atas menyimpan data, Anda perlu menggunakan API pengaturan WordPress. Ini melibatkan penggunaan… register_setting() Daftarkan sebuah grup pengaturan (setting group), lalu gunakannya. add_settings_section() Tambahkan sebuah segmen, dan gunakan… add_settings_field() Tambahkan bidang-bidang yang spesifik.

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

Proses ini biasanya dilakukan pada… admin_init Prosesnya selesai di dalam “hook” tersebut. Dengan mengatur API, verifikasi data dan penyimpanan data akan dilakukan secara otomatis. wp_options Hal ini sangat memudahkan proses pengembangan, terutama dalam hal keamanan (pemeriksaan nilai Nonce).

Menyimpulkan.

Pengembangan plugin WordPress merupakan sebuah proses yang sistematis, yang mencakup berbagai tahap mulai dari membangun lingkungan pengembangan, membuat file-file dasar, memahami dan menggunakan sistem hook dengan mendalam, hingga membuat antarmuka pengguna untuk plugin tersebut. Dengan mengikuti standar pemrograman dan praktik terbaik WordPress (seperti penggunaan komentar di awal file plugin, penamaan fungsi yang aman, dukungan terhadap berbagai bahasa, serta pengaturan API), kita tidak hanya dapat memastikan bahwa plugin berjalan dengan stabil, tetapi juga memudahkan proses pemeliharaan dan pengembangan selanjutnya. Inti dari pengembangan plugin adalah memanfaatkan ekosistem hook yang luas yang disediakan oleh WordPress untuk memperluas fungsi situs web secara termodulasi dan tanpa mengganggu struktur asli situs tersebut. Melalui praktik-praktik yang dijelaskan dalam panduan ini, Anda telah memahami langkah-langkah dasar untuk membuat sebuah plugin kustom yang lengkap fungsinya dan memiliki struktur yang jelas, dari nol.

FAQ - Pertanyaan yang Sering Diajukan.

Apa saja dasar pemrograman yang diperlukan untuk mengembangkan plugin?

Anda perlu memiliki pengetahuan dasar yang kuat tentang PHP, karena inti WordPress dan pluginnya sebagian besar ditulis menggunakan PHP. Selain itu, pemahaman dasar tentang HTML, CSS, dan JavaScript (terutama jQuery, mengingat banyak kode lama di WordPress yang masih menggunakan jQuery) sangat diperlukan untuk membantu Anda mengelola tampilan dan interaksi di bagian frontend. Pengetahuan tentang konsep dasar operasi basis data MySQL juga akan sangat membantu.

Bagaimana cara menghindari konflik nama fungsi plugin dengan plugin lain?

Praktik terbaik untuk menghindari konflik adalah dengan menggunakan prefiks yang unik untuk menamai semua fungsi, kelas, konstanta, dan variabel Anda. Prefiks tersebut harus cukup unik dan umumnya terkait dengan nama atau singkatan dari plugin Anda. Misalnya, jika plugin Anda bernama “Awesome Widget”, Anda dapat menggunakan prefiks seperti “awesowe…” aw_、awesome_widget_ 或 AW_ 作为前缀。将代码封装在类（Class）中也是现代 WordPress 插件开发中广泛采用的、更优雅的避免冲突和组织代码的方式。

Di mana seharusnya plugin disimpan?

File plugin harus disimpan di dalam direktori instalasi WordPress. /wp-content/plugins/ Di dalam folder tersebut. Untuk plugin yang sederhana dan hanya terdiri dari satu file, Anda dapat langsung meletakkan file PHP utamanya di direktori ini. Namun, untuk plugin yang lebih kompleks, sangat disarankan untuk membuat subdirektori yang bernama sesuai dengan nama plugin tersebut. /wp-content/plugins/my-awesome-plugin/Setelah itu, susun semua file plugin (PHP, CSS, JS, gambar, dll.) ke dalam direktori anak ini. Hal ini membuat pengelolaan file menjadi lebih jelas dan teratur.

Bagaimana cara menambahkan dukungan terjemahan untuk plugin?

Menambahkan dukungan internasionalisasi (i18n) ke sebuah plugin umumnya melibatkan langkah-langkah berikut: Pertama, atur dengan benar pengaturan terkait internasionalisasi dalam komentar di bagian awal kode plugin (header). Text DomainDan gunakan fungsi penerjemahan WordPress dalam kode, seperti… ()、_e()、esc_html() Gunakan tanda “<” untuk mengelilingi semua string yang perlu diterjemahkan. Setelah itu, gunakan alat seperti Poedit untuk mengekstrak string-string tersebut dan menghasilkan file terjemahan yang diinginkan. .pot File template, dan berdasarkan file tersebut, buatlah versi berbahasa yang sesuai. .po 和 .mo Terakhir, gunakan kode tersebut saat plugin diinisialisasi. load_plugin_textdomain() Fungsi ini digunakan untuk memuat data terjemahan.