Best Praktis Membuat Plugin Wordpress
Saat artikel ini dibuat, posisi CMS (Content Management System) Wordpress adalah yang paling banyak digunakan di dunia. Mudahnya menggunakan wordpress dan fiturnya yang berlimpah sangat memanjakan para pemilik website dalam mengelola situsnya. Setiap tahun versi wordpress selalu ada update terbaru, biasanya juga dibarengi dengan release theme baru sesuai tahun releasenya. Seperti pada tahun 2021 ini, wordpress sudah merelease theme resminya https://id.wordpress.org/themes/twentytwentyone/.
Dari semua kelebihan tersebut, kadang pengguna tetap saja memelukan fitur tambahan untuk memenuhi kebutuhannya yang beragam. Wordpress menyedikan berbagai macam plugin yang bisa diinstall sesuai keperluan. Developer dari seluruh penjuru dunia ikut meramaikan fitur wordpress dengan mengembangkan berbagai macam thema dan plugin. Teman-teman dapat mencari plugin wordpress di https://id.wordpress.org/plugins/.
Saat ini ada 59.205 plugin gratis yang bisa diinstall dari situs resmi wordpress tersebut. Sedangkan untuk theme resmi yang ada di wordpress ada 8.874 tema gratis. Data ini masih belum termasuk theme dan plugin berbayar yang sengaja dibuat oleh developer untuk fitur premium.
Sesuai judul artikel ini, kita langsung saja ke pembahasan inti. Bagaimana cara terbaik membuat plugin wordpress versi penulis. Secara umum teman-teman bisa mempelajari cara membuat plugin dari situs resmi wordpress di https://developer.wordpress.org/plugins/. Tapi untuk mempersingkat waktu, berikut ini adalah tahapan-tahapannya:
1. Membuat Basic Plugin Dengan Plugin Generator Online
- Plugin Name adalah nama plugin kita.
- Plugin Slug adalah nama folder sekaligus nama unik plugin yang akan dibuat. Bagian ini sangat penting dibandingkan dari inputan lainnya, karena semua fungsi dan file akan dibuat berdasarkan inputan di plugin slug ini.
- Plugin Uri adalah alamat website plugin kita. Biasanya saya isi dengan alamat repository plugin. Misalkan alamat repo githubnya
- Author Name adalah nama pembuat plugin. Bisa nama pribadi atau tim kerja.
- Author Email adalah alamat email
- Author Uri adalah alamat website developernya
- admin adalah folder yang berisi file untuk pengembangan fitur di dasboard wordpress. Seperti membuat menu baru, menambahkan metadata pada post page dll.
- includes adalah folder yang berisi configurasi untuk menjalankan fungsi yang sudah dibuat di folder admin dan public.
- languages adalah folder bahasa, misalkan kita mau membuat plugin dengan multi bahasa. Saya sendiri belum pernah menggunakan fitur ini.
- public adalah folder yang berisi file untuk pengembangan fitur halaman yang diakses oleh user umum diluar dari dasboard wordpress.
- wp-bl.php adalah file utama yang pertama kali akan di jalankan saat plugin sudah diaktifkan. Nama file ini sesuai dengan nama folder plugin hasil dari inputa Plugin Slug yang sudah diterangkan sebelumnya. Di dalam file ini terdapat configurasi nama plugin, nama developer dll.
2. Install Carbon Field Untuk Custom Fields Toolkit
- Copy folder core dan vendor pada existing plugin
- Tambahkan kode dibawah ini pada file utama plugin, dalam kasus ini di file wp-bl.php
- // ============== https://carbonfields.net/ ================
- if(!defined('Carbon_Fields_Plugin\PLUGIN_FILE')){
- define( 'Carbon_Fields_Plugin\PLUGIN_FILE', __FILE__ );
- define( 'Carbon_Fields_Plugin\RELATIVE_PLUGIN_FILE', basename( dirname( \Carbon_Fields_Plugin\PLUGIN_FILE ) ) . '/' . basename( \Carbon_Fields_Plugin\PLUGIN_FILE ) );
- }
- add_action( 'after_setup_theme', 'carbon_fields_boot_plugin' );
- if(!function_exists('carbon_fields_boot_plugin')){
- function carbon_fields_boot_plugin() {
- if ( file_exists( __DIR__ . '/vendor/autoload.php' ) ) {
- require( __DIR__ . '/vendor/autoload.php' );
- }
- \Carbon_Fields\Carbon_Fields::boot();
- if ( is_admin() ) {
- \Carbon_Fields_Plugin\Libraries\Plugin_Update_Warning\Plugin_Update_Warning::boot();
- }
- }
- }
- // ============== https://carbonfields.net/ ================
- Untuk menambahkan menu theme option pada dashboard wordpress maka perlu menambahkan kode di bawah ini pada file admin > class-wp-bl-admin.php
- use Carbon_Fields\Container;
- use Carbon_Fields\Field;
- Tambahkan kode di bawah ini untuk meregister action carbon_fields_register_fields
- $this->loader->add_action( 'carbon_fields_register_fields', $plugin_admin, 'crb_attach_wp_bl_options' );
- Buat function baru di file admin > class-wp-bl-admin.php
- public function crb_attach_wp_bl_options() {
- $basic_options_container = Container::make( 'theme_options', __( 'CRB Options' ) )
- ->set_page_menu_position( 4 )
- ->add_fields( array(
- Field::make( 'text', 'crb_wp_bl_text', 'Carbon field type text' )
- ->set_default_value('ini default value')
- ) );
- }
- Untuk detail lengkap terkait container type theme option bisa cek di https://docs.carbonfields.net/learn/containers/theme-options.html
3. Install HTML Aset Dari AdminLTE
- Buat file baru bisa di admin > partials atau public > partials sesuai kondisi. Sebagai contoh saya membuat file admin > partials > wp-bl-adminlte-chart-page.php. Di file ini saya mencopy kode content yang ada pada asset adminlte pages > charts > chartjs.html
- Buat variable global WP_BL_PLUGIN_URL di file wp-bl.php untuk menentukan plugin url. Ini akan digunakan untuk memanggil file aset adminlte.
- define( 'WP_BL_PLUGIN_URL', plugin_dir_url( __FILE__ ) );
- Kita akan menggunakan fitur shortcode dari wordpress untuk menampilkan halaman wp-bl-adminlte-chart-page.php di salah satu page wordpress.
- Jika kita menggunakan theme astra, kita perlu menambahkan beberapa style CSS pada file public > css > wp-bl-public.css untuk merewrite style dari astra theme.
4. Install Ultimate Member Plugin Untuk Manajemen User Role
Catatan:
Komentar
Posting Komentar