wp admin notices

WP 관리자 공지

지속적으로 닫힐 수 있는 WordPress 관리자 알림을 생성하는 쉽고 편리한 방법입니다. 그 외에도 몇 가지 멋진 기능이 있습니다:

• 알림을 닫은 사용자에게만 알림을 숨기세요.
• 일부 플러그인이 업데이트되거나 활성화되는 경우, 특정 관리자 화면 ID 또는 $_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() 매개변수

• id (문자열) - 알림을 식별합니다.
• type (String) - 색상을 설정하기 위해 공지 클래스에 사용되는 공지 유형입니다. 가능한 값은 'notice-info' , 'notice-warning' , 'notice-success' , 'notice-error' , 'notice-info' 입니다. 기본값은 'notice-info' 입니다.
• content (String) - 공지사항 내용입니다.
• 해제 가능 (부울) - 통지를 해제해야 하는지 여부입니다. 즉, 닫을 수 있는 경우입니다. 기본값은 true 입니다.
• 해제_만료 (int) - 알림이 닫힌 상태로 유지되는 시간(초)입니다. 0보다 큰 값을 사용하면 닫힌 후에도 알림이 유지됩니다. 0으로 설정하면 더 이상 지속되지 않습니다. 기본값은 MONTH_IN_SECONDS 입니다.
• display_on (array) - 알림이 표시되어야 하는 상황. 가능한 값은 다음과 같습니다.
  • screen_id (배열). 특정 관리자 화면 ID에 알림을 표시합니다. 예: 'screen_id' => array( 'plugins' ) .
  • activate_plugin (어레이). 일부 플러그인이 활성화되면 표시됩니다. 예: 'activated_plugin' => array('akismet/akismet.php') .
  • 업데이트_플러그인 (배열). 일부 플러그인이 업데이트되면 표시됩니다. 예: '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' ) 입니다.

예

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를 통해)

이 패키지를 설치하려면 composer.json 파일을 편집하세요.

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

이제 다음을 실행하세요.

$ composer install