wp admin notices

Pemberitahuan Admin WP

Cara mudah dan nyaman untuk membuat pemberitahuan admin WordPress yang dapat ditutup terus-menerus. Selain itu ia memiliki beberapa fitur keren:

• Sembunyikan pemberitahuan Anda hanya untuk pengguna yang menutupnya.
• Tampilkan pemberitahuan Anda pada situasi tertentu, seperti ketika beberapa plugin diperbarui atau diaktifkan atau pada id layar admin tertentu atau pada permintaan $_GET / $_POST,
• Buat kasus khusus Anda sendiri di mana/kapan pemberitahuan Anda harus ditampilkan

Penggunaan Sederhana

 add_action ( ' admin_notices ' , function () {
	$ notices_manager =  ThanksToIT  WPAN get_notices_manager ();
	$ notices_manager -> create_notice ( array (
		' id '         => ' my-notice ' ,
		' content '    => ' <p>My Notice</p> ' ,		
	) );
} );

Catatan: Secara default, perpustakaan ini akan membuat pemberitahuan tetap ada, artinya pemberitahuan tersebut tidak akan ditampilkan lagi setelah pengguna menutupnya, kecuali pemberitahuan tersebut kedaluwarsa

Inisialisasi

Untuk membuatnya berfungsi dengan sempurna, Anda perlu menginisialisasinya seperti ini:

 add_action ( ' wp_ajax_ ' . ' tttwpan_dismiss_persist ' , array ( ' ThanksToITWPANNotices_Manager ' , ' ajax_dismiss ' ) );
add_action ( ' activated_plugin ' , array ( ' ThanksToITWPANNotices_Manager ' , ' set_activated_plugin ' ) );
add_action ( ' upgrader_process_complete ' , array ( ' ThanksToITWPANNotices_Manager ' , ' set_upgrader_process ' ), 10 , 2 );

Dan penting untuk melakukan panggilan ini sebelum kaitan lain pada plugin/tema Anda. Tapi jangan khawatir, perpustakaan ini akan dimuat hanya jika diperlukan, karena dipanggil pada hook yang tepat

parameter create_notice()

• id (String) - Mengidentifikasi pemberitahuan.
• type (String) - Jenis pemberitahuan, yang digunakan pada kelas pemberitahuan untuk mengatur warnanya. Nilai yang mungkin adalah 'notice-info' , 'notice-warning' , 'notice-success' , 'notice-error' , 'notice-info' . Nilai defaultnya adalah 'notice-info' .
• konten (String) - Perhatikan konten.
• dapat diberhentikan (Boolean) - Jika pemberitahuan harus diberhentikan. Dengan kata lain, jika Anda bisa menutupnya. Standarnya adalah true .
• pemberhentian_kedaluwarsa (int) - Berapa lama dalam hitungan detik pemberitahuan akan tetap ditutup. Nilai yang lebih besar dari nol akan membuat pemberitahuan tetap ada setelah ditutup. Jika Anda menyetel 0, itu tidak akan bertahan lagi. Standarnya adalah MONTH_IN_SECONDS .
• display_on (array) - Situasi di mana/kapan pemberitahuan harus ditampilkan. Nilai yang mungkin di bawah:
  • screen_id (array). Menampilkan pemberitahuan pada id layar admin tertentu. Contoh: 'screen_id' => array( 'plugins' ) .
  • diaktifkan_plugin (array). Ditampilkan jika beberapa plugin diaktifkan. Contoh: 'activated_plugin' => array('akismet/akismet.php') .
  • diperbarui_plugin (array). Ditampilkan jika beberapa plugin diperbarui. Contoh: 'updated_plugin' => array('akismet/akismet.php') .
  • request (array) - Ditampilkan pada nilai $_GET atau $_POST. Catatan: Dibutuhkan array array dengan parameter 'key' dan 'value' . Contoh: 'request' => array( array( 'key' => 'show_notice', 'value' => '1' ), ) .
• keep_active_on (array) - Menjaga agar pemberitahuan selalu terbuka setelah persyaratan display_on terpenuhi, hingga pengguna menutup pemberitahuan. Nilai defaultnya adalah array( 'activated_plugin', 'updated_plugin' ) ,

Contoh

Buat pemberitahuan yang akan ditutup selama 1 minggu

 add_action ( ' admin_notices ' , function () {
	$ notices_manager =  ThanksToIT  WPAN get_notices_manager ();
	$ notices_manager -> create_notice ( array (
		' id '         => ' 1-week-notice ' ,
		' content '    => ' <p>1 week notice</p> ' ,	
		' dismissal_expiration ' => WEEK_IN_SECONDS ,
	) );
} );

Buat pemberitahuan yang hanya akan ditampilkan di halaman plugin

 add_action ( ' admin_notices ' , function () {
	$ notices_manager =  ThanksToIT  WPAN get_notices_manager ();
	$ notices_manager -> create_notice ( array (
		' id '         => ' plugins-page-notice ' ,
		' content '    => ' <p>plugins page notice</p> ' ,	
		' display_on ' => array (
			' screen_id ' => array ( ' plugins ' ),			
		)
	) );
} );

Buat pemberitahuan yang akan ditampilkan setelah plugin Akismet diaktifkan

 add_action ( ' admin_notices ' , function () {
	$ notices_manager =  ThanksToIT  WPAN get_notices_manager ();
	$ notices_manager -> create_notice ( array (
		' id '         => ' akismet-notice ' ,
		' content '    => ' <p>Akismet notice</p> ' ,	
		' display_on ' => array (
			' activated_plugin ' => array ( ' akismet/akismet.php ' )
		)
	) );
} );

Instalasi Paket (melalui Komposer)

Untuk menginstal paket ini, edit file composer.json Anda:

 {
    "require" : {
        "thanks-to-it/wp-admin-notices" : "dev-master"
    }
}

Sekarang jalankan:

$ composer install