wp admin notices

ประกาศผู้ดูแลระบบ WP

วิธีที่ง่ายและสะดวกในการสร้างประกาศผู้ดูแลระบบ WordPress ที่สามารถปิดได้อย่างต่อเนื่อง นอกจากนั้นมันยังมีคุณสมบัติเจ๋ง ๆ อีกด้วย:

• เก็บประกาศของคุณไว้เฉพาะสำหรับผู้ใช้ที่ปิดเท่านั้น
• แสดงการแจ้งเตือนของคุณในสถานการณ์เฉพาะ เช่น เมื่อปลั๊กอินบางตัวได้รับการอัปเดตหรือเปิดใช้งาน หรือบนรหัสหน้าจอผู้ดูแลระบบเฉพาะ หรือตามคำขอ $_GET / $_POST
• สร้างกรณีพิเศษของคุณเองซึ่ง/เมื่อใดที่ควรแสดงการแจ้งเตือนของคุณ

การใช้งานที่เรียบง่าย

 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> ' ,		
	) );
} );

หมายเหตุ: ตามค่าเริ่มต้น ไลบรารีนี้จะทำให้การแจ้งเตือนยังคงอยู่ ซึ่งหมายความว่าจะไม่แสดงอีกครั้งหลังจากที่ผู้ใช้ปิดการแจ้งเตือน เว้นแต่จะหมดอายุ

การเริ่มต้น

เพื่อให้ทำงานได้อย่างสมบูรณ์ คุณต้อง เริ่มต้นการ ทำงานดังนี้:

 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 );

และ สิ่งสำคัญ คือต้องโทรออกก่อนที่ จะเชื่อม ต่อปลั๊กอิน/ธีมของคุณ แต่ไม่ต้องกังวล ไลบรารีนี้จะถูกโหลดเมื่อจำเป็นเท่านั้น เนื่องจากไลบรารี่นี้ถูกเรียกใช้บน hooks ที่เหมาะสม

พารามิเตอร์ create_notice()

• id (String) - ระบุประกาศ
• type (String) - ประเภทของการแจ้งเตือนที่ใช้ในคลาสการแจ้งเตือนเพื่อตั้งค่าสี ค่าที่เป็นไปได้คือ 'notice-info' , 'notice-warning' , 'notice-success' , 'notice-error' , 'notice-info' ค่าเริ่มต้นคือ 'notice-info'
• เนื้อหา (สตริง) - แจ้งเนื้อหา
• ยกเลิกได้ (Boolean) - หากการแจ้งเตือนควรถูกไล่ออก กล่าวอีกนัยหนึ่งหากคุณสามารถปิดได้ ค่าเริ่มต้นเป็น true
• cancelal_expiration (int) - ระยะเวลาเป็นวินาทีที่การแจ้งเตือนจะถูกปิด ค่าที่มากกว่าศูนย์จะทำให้การแจ้งเตือนยังคงมีอยู่หลังจากปิดแล้ว หากคุณตั้งค่าเป็น 0 มันจะไม่คงอยู่อีกต่อไป ค่าเริ่มต้นคือ MONTH_IN_SECONDS
• display_on (array) - สถานการณ์ที่ควรแสดงการแจ้งเตือน/เมื่อใด ค่าที่เป็นไปได้ด้านล่าง:
  • screen_id (อาร์เรย์) แสดงการแจ้งเตือนบนรหัสหน้าจอผู้ดูแลระบบเฉพาะ ตัวอย่าง: 'screen_id' => array( 'plugins' )
  • Activated_plugin (อาร์เรย์) แสดงว่ามีการเปิดใช้งานปลั๊กอินบางตัวหรือไม่ ตัวอย่าง: 'activated_plugin' => array('akismet/akismet.php')
  • updated_plugin (อาร์เรย์) แสดงว่าปลั๊กอินบางตัวได้รับการอัพเดตหรือไม่ ตัวอย่าง: 'updated_plugin' => array('akismet/akismet.php')
  • คำขอ (อาร์เรย์) - แสดงในค่า $_GET หรือ $_POST หมายเหตุ: ใช้อาร์เรย์ของอาร์เรย์ที่มีพารามิเตอร์ 'key' และ 'value' ตัวอย่าง: 'request' => array( array( 'key' => 'show_notice', 'value' => '1' ), )
• Keep_active_on (อาร์เรย์) - เปิดการแจ้งเตือนเสมอเมื่อตรงตามข้อกำหนดของ display_on จนกว่าผู้ใช้จะปิดการแจ้งเตือน ค่าเริ่มต้นคือ array( 'activated_plugin', 'updated_plugin' ) ,

ตัวอย่าง

สร้างประกาศให้ปิดเป็นเวลา 1 สัปดาห์

 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 ,
	) );
} );

สร้างประกาศที่จะแสดงบนหน้าปลั๊กอินเท่านั้น

 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 ' ),			
		)
	) );
} );

สร้างประกาศที่จะแสดงหลังจากเปิดใช้งานปลั๊กอิน Akismet

 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 ' )
		)
	) );
} );

การติดตั้งแพ็คเกจ (ผ่านนักแต่งเพลง)

หากต้องการติดตั้งแพ็คเกจนี้ ให้แก้ไขไฟล์ composer.json ของคุณ:

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

ตอนนี้รัน:

$ composer install