Cara Membuat Widget WordPress Untuk Pemula

Selamat datang. Pastinya anda berada di halaman ini karena ingin membuat sebuah widget ataupun karena tersasar. Secara umum widget di WordPress menggunakah kelas PHP. WordPress sendiri sudah menyiapkan fitur-fitur dasar untuk pembuatan sebuah widget. Sehingga kita cukup mengembangnkan kelas WordPress Widget tersebut.

Struktur Kelas Widget dan Penjelasan Fungsi

WordPress widget secara sederhana memiliki struktur sebagai berikut yang bisa ditemukan pada berkas "\wp-includes\widgets.php"

class Widget_Contoh extends WP_Widget {
    function __construct() {}
    function widget( $args, $instance ) {}
    function update( $new_instance, $old_instance ) {}
    function form( $instance ) {}
}

__construct() digunakan untuk inisialisai kelas PHP, disini kita bisa mendeklarasikan semua variable untuk kelas, mengantikan berkas-berkas .css ataupun .js.
Fungsi ini terdiri dari parameter:
- $id_base, penanda dasar menggunakan huruf kecil.
- $name, nama yang akan ditampilkan pada widget.
- $widget_options, array() 'description' dan 'classname'
- $control_options, array() 'width' dan 'height' untuk tinggi dan lebar widget.

widget() fungsi ini digunakan untuk menampilkan widget di halaman depan pengguna (front-end). Disinilah tempat kita untuk mengolah data untuk ditampilkan di halaman web.

update() digunakan untuk menyimpan konfigurasi widget yang kita buat dari halaman admin. Untuk contoh, kita belum membutuhkan fungsi ini.

form() digunakan untuk menampilkan form field seperti text, textarea, input, radio, select dll untuk diubah dari konfigurasi awal ataupun hasil konfigurasi yang telah kita simpan.

Pembuatan Widget

Pertama-tama buatlah sebuah berkas baru di direktori thema yang sedang digunakan dengan nama "widget-contoh.php". Kita akan menggunakan fungsi __construct untuk menambahkan parameter dari widget yang akan dibuat seperti contoh berikut.

function __construct() {
    // Kelas CSS dan penjelasan widget
    $widget_attr = array(
        'classname' => 'widget_contoh',
        'description' => 'Ini adalah deskripsi singkat widget.'
    );

    // Lihat penjelasan __construct diatas
    parent::__construct( 'widget_contoh', 'Widget Contoh', $widget_attr );
}

Langkah berikutnya adalah membuat tampilan widget untuk halaman depan dan admin.

function widget( $args, $instance ) {
    echo 'Halo semuanya, apa kabar?';
}

function form( $instance ) {
    echo '<p>Halo admin, apa kabar?</p>';
}

Penambahan Widget ke Thema

Kita bisa membuat widget ini sebagai plugin. Tapi disini kita menggunakan "functions.php" dari thema yang sedang dipakai. Tambahkan kode berikut pada baris paling akhir.

require( get_template_directory() . '/widget.php' );

function widget_contoh_init() {
    register_widget( 'Widget_Contoh' );
}

add_action( 'widgets_init', 'widget_contoh_init' );

Begitulah cara paling sederhana untuk membuat widget yang akan menampilkan teks di halaman depan. Anda bisa mengunduh file contoh berikut. Silahkan beri komentar atau pertanyaan pada kotak di bawah ini. Terima kasih sudah membaca. Selamat mencoba.

Unduh 'widget-contoh.php'