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

Pemberitahuan Admin WordPress Persisten: Bagian 1

by
Read Time:7 minsLanguages:
This post is part of a series called Persisted WordPress Admin Notices.
Persisted WordPress Admin Notices: Part 2

Indonesian (Bahasa Indonesia) translation by Frida Wahyu (you can also view the original English article)

Pemberitahuan admin WordPress menyediakan cara mudah untuk menampilkan pesan kepada pengguna di area admin, mis. setelah posting diperbarui atau plugin telah diaktifkan. Mereka juga digunakan oleh banyak tema dan plugin untuk menampilkan pemberitahuan tentang apa pun dari fitur baru atau peringatan keamanan hingga detail tentang promosi yang sedang berlangsung atau permintaan peningkatan.

Inti WordPress menyediakan empat pemberitahuan admin berbeda yang dapat digunakan secara kontekstual untuk mengingatkan pengguna untuk jenis pemberitahuan tertentu. Ini dicapai dengan menampilkan warna aksen unik untuk setiap jenis pemberitahuan admin.

Pemberitahuan admin biasanya ditampilkan di bagian atas setiap halaman admin untuk berdiri keluar dari konten halaman utama dan terlihat jelas. Mereka dirancang secara elegan agar tidak terlalu mengganggu secara visual.

WordPress core admin noticeWordPress core admin noticeWordPress core admin notice

WordPress juga menggunakan kembali pemberitahuan admin di lokasi lain di seluruh antarmuka admin, seperti ketika pembaruan tema atau plugin tersedia. Penggunaan inti pemberitahuan admin tidak terbatas hanya ditampilkan di bagian atas layar admin.

WordPress admin notices in alternative locationWordPress admin notices in alternative locationWordPress admin notices in alternative location

Menampilkan pemberitahuan admin dalam plugin atau tema khusus relatif mudah, hanya membutuhkan beberapa baris kode, karena kami akan segera menemukan. Namun, WordPress tidak menyediakan cara secara default untuk menutup pemberitahuan admin yang berlangsung lama.

Meskipun Anda dapat menambahkan tombol tutup ke pemberitahuan admin apa pun, ini tidak mencegahnya muncul kembali ketika halaman dimuat ulang. Juga, pemberitahuan admin muncul di setiap halaman admin, yang jauh dari ideal.

Jika Anda ingin memiliki kontrol terperinci atas kapan dan di mana pemberitahuan admin ditampilkan dan agar dapat menutupnya secara efektif, Anda harus menambahkan kode kustom untuk mengubah perilaku default.

Apa yang akan kita bahas

Kami akan mulai dari awal dan menjelajahi dasar-dasar penerapan pemberitahuan admin melalui plugin khusus, termasuk menampilkannya hanya pada halaman tertentu di admin WordPress.

Pemberitahuan admin muncul di setiap halaman secara default, yang tidak selalu seperti yang Anda inginkan. Misalnya, Anda mungkin hanya ingin menampilkan pemberitahuan pada halaman opsi plugin. Jadi port panggilan selanjutnya kami akan menampilkan pemberitahuan admin tergantung pada layar admin saat ini.

Membangun ini, kami akan memperkenalkan cara-cara untuk mengelola pemberitahuan admin lebih lanjut dengan mengontrol ketika mereka muncul juga. Daripada muncul segera setelah halaman dimuat, mereka hanya akan muncul jika kondisi pemicuan tertentu terpenuhi. Ini bisa berguna, misalnya, jika Anda ingin menampilkan pemberitahuan admin pada halaman opsi plugin, tetapi hanya setelah pengaturan telah disimpan.

Seperti yang disebutkan di atas, tidak ada cara mudah untuk menutup pemberitahuan admin yang berlangsung antara pemuatan halaman. Jadi sisa seri tutorial akan fokus terutama pada berbagai metode yang dapat Anda terapkan untuk menutup pemberitahuan admin sehingga mereka tidak akan muncul kembali secara tak terduga.

Akhirnya, untuk sedikit bersenang-senang, kita akan melihat bagaimana Anda dapat membuat jenis pemberitahuan admin khusus Anda sendiri dan menambahkan hiasan tambahan seperti ikon ke pemberitahuan admin Anda.

Pada akhir seri tutorial ini, Anda akan dapat menampilkan semua jenis pemberitahuan admin di mana saja di dalam admin WordPress. Selain itu, Anda akan dapat memutuskan apakah akan menampilkannya pada pemuatan halaman atau melalui tindakan khusus, dan Anda juga akan dapat menutupnya dengan berbagai cara, tergantung pada kebutuhan Anda.

Ingin mengikutinya?

Anda akan mendapatkan sebagian besar dari seri tutorial ini jika Anda ikut serta saat kami membuat setiap contoh pemberitahuan admin. Kode ini disajikan dalam pendekatan langkah demi langkah untuk memungkinkan Anda membangun plugin yang berfungsi sendiri saat kami melanjutkan melalui tutorial. Namun, jika Anda tidak ingin mengetikkan semua kode sendiri, plugin yang sudah selesai akan tersedia untuk diunduh di bagian empat.

Diasumsikan bahwa Anda memiliki setidaknya pengetahuan dasar tentang pengembangan plugin WordPress, termasuk cara kerja kait. Jika tidak, saya akan merekomendasikan membaca tentang topik ini melalui dokumentasi WordPress resmi sebelum melanjutkan:

Untuk menguji kode plugin untuk setiap contoh, Anda memerlukan situs WordPress yang berfungsi. Cara termudah untuk melakukannya adalah menginstal WordPress secara lokal sehingga Anda memiliki akses mudah untuk mengedit file.

Ada banyak pilihan untuk berkembang secara lokal dengan WordPress, termasuk:

Jika Anda baru dalam pengembangan WordPress, maka Local atau DesktopServer mungkin paling mudah untuk disiapkan. Lokal gratis untuk digunakan (mereka memiliki versi premium dalam karya), dan DesktopServer memiliki versi terbatas (gratis) plus versi premium yang tersedia.

Juga, beberapa pengalaman PHP dan JavaScript sebelumnya direkomendasikan, seperti beberapa pengalaman mengimplementasikan permintaan Ajax. Namun, semuanya akan dijelaskan di sepanjang jalan, jadi pengetahuan yang mendalam tidak diperlukan.

Pandangan Lebih Dekat pada Pemberitahuan Admin

Mari kita lihat penerapan paling dasar dari pemberitahuan admin dan kode yang diperlukan untuk membuat pemberitahuan jenis sukses.

A Successful admin noticeA Successful admin noticeA Successful admin notice

Semua yang kami lakukan di sini adalah untuk mendaftarkan fungsi display_admin_notice() yang akan dijalankan saat hook hook admin_notices. Tidak masalah apa fungsi yang terdaftar disebut-itu tidak akan mempengaruhi bagaimana pemberitahuan admin diberikan.

Jangan khawatir tentang memasukkan kode di atas Anda sendiri sekarang; cukup fokus pada bagaimana pemberitahuan admin dibuat karena kami akan membangun ini dalam tutorial nanti.

Anda dapat menggunakan markup apa pun yang Anda suka untuk menampilkan pemberitahuan admin; namun, format yang disarankan adalah sebagai berikut:

Ganti {class} dengan daftar nama kelas CSS. Anda harus menyertakan notice kelas ditambah salah satu dari kelas berikut untuk menentukan jenis pemberitahuan admin:

  • notice-error (merah)
  • notice-warning (kuning/orange)
  • notice-success (hijau)
  • notice-info (biru)
The various admin noticesThe various admin noticesThe various admin notices

Blok {message} dapat berupa teks apa pun atau HTML yang valid yang akan ditampilkan di dalam pemberitahuan admin.

Contoh di atas menunjukkan pemberitahuan admin pada semua halaman admin, yang tidak selalu ideal, jadi di bagian dua kita akan melihat bagaimana Anda dapat mengontrol persis halaman apa yang ditampilkan.

Ada lagi kelas CSS built-in yang dapat Anda tambahkan ke div.notice yang menambahkan tombol tutup ke pemberitahuan admin. Mari kita lihat apa yang terjadi ketika pemberitahuan admin sukses yang sama memiliki kelas yang is-dismissible yang ditambahkan ke dalamnya.

Our first admin noticeOur first admin noticeOur first admin notice

Kami sekarang memiliki cara mudah untuk menutup pemberitahuan admin. Namun, sebelum Anda terlalu bersemangat, ada masalah dengan menggunakan metode ini. Jika Anda me-refresh halaman, pemberitahuan admin akan muncul kembali! Jadi, meskipun Anda dapat menyetel pemberitahuan admin untuk dihapus, itu persisten, dan status yang ditutup terlupakan di antara pemuatan laman.

Kami akan membahas pemberitahuan admin yang gigih secara terperinci nanti dan menjelajahi berbagai cara Anda dapat menutupnya tanpa mereka muncul kembali.

Tapi Pemberitahuan Admin Buruk! Kan ?

Jika Anda sudah terbiasa dengan pemberitahuan admin di WordPress dan / atau mengikuti berita WordPress secara umum, maka Anda mungkin menyadari sejumlah negatif mengenai penggunaan pemberitahuan admin di plugin dan tema khusus.

Ini berasal dari beberapa plugin yang terlalu sering menggunakan pemberitahuan admin sebagai upaya untuk mendapatkan pesan 'penting' mereka. Jika Anda sudah menginstal banyak plugin dan hanya beberapa dari mereka yang menyalahgunakan sistem pemberitahuan admin maka Anda dapat dengan cepat mengakhiri dengan pemberitahuan admin 'sup', di mana seluruh jalinan pemberitahuan ditampilkan di bagian atas setiap halaman admin.

Overloading layar admin dengan pemberitahuan yang tidak perlu dapat menyebabkan kekacauan (dan sakit kepala) dan sangat menjengkelkan bagi pengguna karena membuat mengelola situs lebih sulit.

Idealnya, hanya pemberitahuan admin penting, seperti pembaruan keamanan penting, yang harus ditampilkan pada setiap pemuatan halaman. Jika Anda menampilkan pemberitahuan admin global untuk memberi tahu pengguna bahwa sebuah plugin baru saja diperbarui, dan meminta untuk mengklik tautan untuk informasi lebih lanjut, maka Anda harus benar-benar bertanya pada diri sendiri apakah ini perlu ada di setiap halaman admin.

Selain itu, favorit yang umum adalah untuk menampilkan pemberitahuan admin yang tidak penting yang tidak dapat dibatalkan dengan mudah secara permanen. Saya jamin Anda tidak ada cara yang lebih mudah untuk mengasingkan pengguna plugin Anda daripada dengan melakukan ini!

Namun, ada kasus penggunaan untuk pemberitahuan persisten yang tidak dapat ditutup, seperti pembaruan basis data. Plugin yang menggunakan tabel khusus mungkin perlu menjalankan rutin pembaruan basis data sesekali agar plugin tetap berjalan dengan benar. Jadi, dalam hal ini, masuk akal untuk menambahkan pemberitahuan admin yang tidak dapat ditutup.

Aturan praktis yang baik adalah hanya menggunakan akal sehat. Apakah pemberitahuan admin yang akan Anda tambahkan ke plugin mengganggu Anda sebagai pengguna? Jika demikian, Anda mungkin ingin memikirkan kembali menambahkan pemberitahuan, atau mempertimbangkan apakah akan lebih baik ditampilkan di lokasi alternatif.

Kesimpulan

Dalam tutorial ini, kami telah membahas apa saja pemberitahuan admin dan berbagai jenis bawaan yang disediakan oleh WordPress, termasuk pemberitahuan admin yang ditolak. Seperti yang telah kita lihat, ada beberapa kelemahan pada implementasi default dari pemberitahuan admin, seperti tidak dapat ditutup dan fakta yang diberikan pada setiap halaman admin.

WordPress memiliki ekonomi yang sangat aktif. Ada tema, plugin, pustaka, dan banyak produk lain yang membantu Anda membangun situs dan proyek Anda. Sifat open-source dari platform juga menjadikannya pilihan yang bagus dari mana Anda dapat lebih baik keterampilan pemrograman Anda. Apapun masalahnya, Anda dapat melihat apa yang tersedia di Pasar Envato.

Bagian lain dari tutorial dalam seri ini akan berfokus pada bagaimana kami dapat memperpanjang pemberitahuan admin agar lebih praktis ketika digunakan dalam plugin dan tema Anda sendiri.

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.