Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. Creative Coding

Mengkustomisasi Admin WordPress: Teks Bantuan

by
Read Time:6 minsLanguages:
This post is part of a series called Customizing the WordPress Admin.
Customizing the WordPress Admin: Custom Admin Menus
Customizing the WordPress Admin - Listings Screens

Indonesian (Bahasa Indonesia) translation by Ari Ana (you can also view the original English article)

Di Bagian 2 dari tutorial ini, saya menunjukkan kepada Anda cara menambahkan metabox kustom ke dashboard WordPress, yang dapat Anda gunakan untuk menyediakan teks bantuan untuk klien atau pengguna Anda.

Tetapi bagaimana jika Anda ingin memberikan teks bantuan pada layar pengeditan individual? Dalam tutorial ini, saya akan menunjukkan cara melakukannya.

Dalam tutorial ini Anda akan belajar cara:

  1. Menambahkan metabox ke layar pengeditan untuk teks bantuan
  2. Menambahkan metabox tambahan di posisi yang berbeda
  3. Membuat metabox dummy untuk menampilkan teks bantuan di bagian atas layar pengeditan

Saya akan membuat plugin untuk melakukan ini - jika Anda sudah membuat plugin setelah mengikuti Bagian 1 hingga 3 dari seri ini, Anda mungkin lebih suka menambahkan kode dari tutorial ini ke plugin tersebut, memberi Anda satu plugin dengan semua penyesuaian admin Anda.


Apa yang Anda Butuhkan untuk Menyelesaikan Tutorial Ini

Untuk menyelesaikan tutorial ini Anda akan membutuhkan:

  • Instalasi WordPress
  • Akses ke folder plugin situs Anda untuk menambahkan plugin Anda
  • Editor teks untuk membuat plugin Anda

Menyiapkan Plugin

Di awal plugin saya, saya menambahkan baris berikut:


1. Menambahkan Metabox Bantuan ke Layar Pengeditan Posting

Untuk menambahkan metabox yang berisi teks bantuan, Anda menggunakan fungsi add_meta_box(), yang juga akan Anda gunakan jika Anda membuat metabox untuk metadata posting atau di layar pengaturan. Fungsi ini membutuhkan beberapa parameter:

Parameternya adalah:

  • $id - ID unik untuk metabox.
  • $title - judul yang akan ditampilkan kepada pengguna.
  • $callback - fungsi callback yang mendefinisikan isi dari metabox.
  • $post_type - jenis posting yang layar pengeditannya akan muncul di metabox. Kosongkan ini untuk menambahkan metabox ke semua jenis layar pengeditan posting, atau tentukan jenis posting mana yang ingin Anda targetkan.
  • $context - di mana di layar pengeditan Anda ingin metabox muncul - 'normal', 'lanjutan' atau 'sisi'. Standarnya adalah 'lanjutan' yang menempatkan metabox di area utama layar.
  • $priority - dalam konteks yang telah Anda tetapkan, prioritas untuk metabox ini ('high''core''default' atau 'low'). Ini berguna jika Anda menambahkan banyak metabox.
  • $callback_args - argumen untuk dikirimkan ke fungsi callback Anda (opsional)

Jadi, untuk menambahkan metabox ke area utama dari layar pengeditan posting untuk posting saja, saya tambahkan yang berikut ini ke plugin saya:

Ini menambahkan metabox kosong, yang tidak akan berfungsi karena saya belum menambahkan fungsi callback. Ini adalah sebagai berikut:

Ini sekarang menambahkan metabox ke layar pengeditan posting saya, seperti yang ditunjukkan pada tangkapan layar:

customizing-the-wordpress-admin-part4-metabox-below-editorcustomizing-the-wordpress-admin-part4-metabox-below-editorcustomizing-the-wordpress-admin-part4-metabox-below-editor

Seperti yang Anda lihat, saya telah menghapus beberapa metabox lain yang biasanya terlihat di layar pengeditan posting (seperti kutipan dan diskusi), tetapi metabox baru saya berada di bawah panel pengeditan dan karenanya tidak terlalu terlihat. Tidak mungkin menggunakan fungsi add_meta_box() untuk menambahkan metabox di atas panel pengeditan utama tanpa menggunakan solusi jQuery yang menggerakkan panel pengeditan utama ke bawah, dan yang saya pikir berlebihan untuk masalah ini. Jadi, apa alternatif yang saya miliki?

  1. Pertama, saya dapat menambahkan metabox di atas metabox 'Publish', yang akan lebih jelas bagi pengguna.
  2. Atau, saya bisa menipu, dan menggunakan kaitan tindakan edit_form_after_title untuk menambahkan metabox palsu di atas panel pengeditan.

Saya akan mulai dengan opsi pertama: menambahkan metabox di sebelah kanan di atas metabox 'Publish'.


2. Menambahkan Metabox di Kanan Layar Pengeditan

Untuk menambahkan metabox di kanan atas layar, saya menggunakan fungsi add_meta_box() dengan cara yang sama seperti sebelumnya, dengan beberapa parameter berubah. Saya juga akan menggunakan fungsi callback yang berbeda untuk mengisi metabox dengan konten yang berbeda.

Di plugin Anda, tambahkan yang berikut:

Ini menambahkan metabox kecil dengan instruksi singkat - jika saya menambahkan lebih banyak teks, itu akan memindahkan metabox di bawahnya terlalu jauh di bawah layar. Anda dapat melihat hasilnya di tangkapan layar:

customizing-the-wordpress-admin-part4-help-text-on-rightcustomizing-the-wordpress-admin-part4-help-text-on-rightcustomizing-the-wordpress-admin-part4-help-text-on-right

Catatan: Saya mengomentari fungsi untuk metabox di area utama layar sebelum menambahkan metabox baru ini, itulah mengapa Anda tidak dapat melihatnya di tangkapan layar.


3. Menambahkan Metabox 'Palsu' Diatas Panel Pengeditan

Jadi menambahkan metabox kecil di kanan atas layar cukup sederhana - tetapi bagaimana jika saya ingin metabox di kiri atas, di atas panel pengeditan?

Untuk melakukan ini, Anda tidak menggunakan fungsi add_meta_box(), tetapi gunakan kaitan edit_form_after_title, yang menyisipkan konten setelah judul posting dan sebelum panel pengeditan. Saya akan melampirkan fungsi ke kaitan untuk menentukan markup yang akan ditambahkan ke layar, dan saya akan menggunakan kelas dalam markup saya untuk meniru tampilan metabox.

Di plugin Anda, tambahkan yang berikut:

Ini menambahkan beberapa markup ke layar pengeditan yang terlihat sangat mirip dengan metabox, karena saya menyertakan kelas .postbox dan .inside:

customizing-the-wordpress-admin-part4-metabox-above-editorcustomizing-the-wordpress-admin-part4-metabox-above-editorcustomizing-the-wordpress-admin-part4-metabox-above-editor

Namun, ada satu masalah dengan markup ini - itu akan muncul di layar pengeditan untuk setiap jenis posting. Karena saya tidak menggunakan fungsi add_meta_box(), saya tidak memiliki kemewahan dari parameter $post_type. Jadi alih-alih menggunakan ini, saya akan melakukan pemeriksaan untuk halaman pengeditan yang kita lakukan sebelum menghasilkan markup.

Saat saya di backend WordPress, saya tidak bisa menggunakan tag kondisional standar yang akan saya gunakan dalam file template untuk memeriksa lokasi saya, tetapi saya bisa menggunakan fungsi get_current_screen() untuk mengidentifikasi layar pengeditan yang saya gunakan.

Fungsi get_current_screen() mengembalikan array, yang akan menyertakan jenis posting dari layar saat ini, di antara hal-hal lainnya. Saya dapat menggunakan ini untuk memeriksa apakah jenis posting yang sedang diedit adalah 'post'.

Di dalam fungsi Anda, di atas konten lainnya, tambahkan yang berikut:

Seluruh fungsi sekarang akan terlihat seperti ini:

Ini akan memastikan bahwa metabox 'palsu' hanya akan dihasilkan di layar pengeditan Post, dan bukan layar pengeditan untuk jenis posting lainnya. Anda kemudian dapat mengulangi fungsi ini untuk jenis posting yang berbeda (seperti 'page' dan 'attachment', serta jenis posting kustom Anda sendiri), untuk menampilkan teks bantuan yang berbeda bagi mereka.


Ringkasan

Menambahkan teks bantuan ke layar pengeditan individu dapat sangat berguna bagi pengguna yang tidak ingin terus kembali ke dashboard untuk mendapatkan bantuan.

Dalam tutorial ini, Anda telah belajar cara menambahkan metabox untuk teks bantuan pada layar pengeditan, serta cara menggunakan kaitan edit_form_after_title untuk menambahkan teks bantuan tepat di atas panel pengeditan.

Advertisement
Did you find this post useful?
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.