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

ومن المهم إجراء هذه الاستدعاءات قبل أي ربط آخر بالمكون الإضافي/الموضوع الخاص بك. لكن لا تقلق، لن يتم تحميل هذه المكتبة إلا عند الضرورة، حيث يتم استدعاؤها على الخطافات المناسبة

معلمات create_notice()

• معرف (سلسلة) - يحدد الإشعار.
• النوع (سلسلة) - نوع الإشعار المستخدم في فئة الإشعارات من أجل ضبط لونه. القيم المحتملة هي 'notice-info' و 'notice-warning' و 'notice-success' و 'notice-error' و 'notice-info' . القيمة الافتراضية هي 'notice-info' .
• المحتوى (سلسلة) - محتوى الإشعار.
• قابل للرفض (منطقي) - إذا كان يجب أن يكون الإشعار قابلاً للرفض. وبعبارة أخرى، إذا كنت تستطيع إغلاقه. الافتراضي true .
• Disal_expiration (int) - المدة بالثواني التي سيظل فيها الإشعار مغلقًا. القيم الأكبر من الصفر ستجعل الإشعار يستمر بعد إغلاقه. إذا قمت بتعيين 0، فلن يستمر. الافتراضي هو MONTH_IN_SECONDS .
• Display_on (array) - الحالات التي/متى يجب أن يتم عرض الإشعار فيها. القيم المحتملة أدناه:
  • معرف الشاشة (صفيف). يعرض الإشعار على معرفات شاشة المشرف المحددة. مثال: 'screen_id' => array( 'plugins' ) .
  • activated_plugin (صفيف). يتم عرضه في حالة تنشيط بعض المكونات الإضافية. مثال: 'activated_plugin' => array('akismet/akismet.php') .
  • update_plugin (مصفوفة). يتم عرضه في حالة تحديث بعض المكونات الإضافية. مثال: 'updated_plugin' => array('akismet/akismet.php') .
  • طلب (مصفوفة) - يتم عرضه على قيم $_GET أو $_POST. ملاحظة: يتطلب الأمر مصفوفة من المصفوفات ذات معلمات 'key' و 'value' . مثال: 'request' => array( array( 'key' => 'show_notice', 'value' => '1' ), ) .
• keep_active_on (array) - يبقي الإشعار مفتوحًا دائمًا بمجرد استيفاء متطلبات Display_on، حتى يقوم المستخدم بإغلاق الإشعار. القيمة الافتراضية هي array( 'activated_plugin', 'updated_plugin' ) ,

أمثلة

قم بإنشاء إشعار سيتم إغلاقه لمدة أسبوع واحد

 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