wp admin notices

Hinweise für WP-Administratoren

Eine einfache und bequeme Möglichkeit, WordPress-Administratorbenachrichtigungen zu erstellen, die dauerhaft geschlossen werden können. Darüber hinaus hat es einige coole Funktionen:

• Halten Sie Ihre Benachrichtigungen nur für den Benutzer verborgen, der sie geschlossen hat.
• Zeigen Sie Ihren Hinweis in bestimmten Situationen an, z. B. wenn ein Plugin aktualisiert oder aktiviert wird, oder auf bestimmten Admin-Bildschirm-IDs oder bei $_GET / $_POST-Anfragen.
• Erstellen Sie Ihre eigenen Sonderfälle, wo/wann Ihr Hinweis angezeigt werden soll

Einfache Nutzung

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

Hinweis: Standardmäßig sorgt diese Bibliothek dafür, dass Benachrichtigungen bestehen bleiben, d. h. sie werden nicht mehr angezeigt, nachdem der Benutzer sie geschlossen hat, es sei denn, sie laufen ab

Initialisierung

Damit es perfekt funktioniert, müssen Sie es wie folgt initialisieren :

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

Und es ist wichtig , diese Aufrufe vor jedem anderen Hook in Ihrem Plugin/Theme zu tätigen. Aber keine Sorge, diese Bibliothek wird nur geladen, wenn es nötig ist, da sie über die richtigen Hooks aufgerufen wird

create_notice()-Parameter

• id (String) – Identifiziert den Hinweis.
• type (String) – Der Typ des Hinweises, der in der Hinweisklasse verwendet wird, um seine Farbe festzulegen. Mögliche Werte sind 'notice-info' , 'notice-warning' , 'notice-success' , 'notice-error' , 'notice-info' . Der Standardwert ist 'notice-info' .
• content (String) – Hinweisinhalt.
• dismissible (Boolean) – Wenn die Kündigung abzuweisen sein soll. Mit anderen Worten, wenn Sie es schließen können. Der Standardwert ist true .
• dismissal_expiration (int) – Wie lange in Sekunden die Benachrichtigung geschlossen bleibt. Bei Werten größer als Null bleibt der Hinweis nach dem Schließen bestehen. Wenn Sie 0 festlegen, bleibt es nicht länger bestehen. Der Standardwert ist MONTH_IN_SECONDS .
• display_on (Array) – Situationen, in denen/wann der Hinweis angezeigt werden soll. Mögliche Werte unten:
  • screen_id (Array). Zeigt den Hinweis auf bestimmten Admin-Bildschirm-IDs an. Beispiel: 'screen_id' => array( 'plugins' ) .
  • aktiviertes_plugin (Array). Wird angezeigt, wenn ein Plugin aktiviert wird. Beispiel: 'activated_plugin' => array('akismet/akismet.php') .
  • aktualisiertes_plugin (Array). Wird angezeigt, wenn ein Plugin aktualisiert wird. Beispiel: 'updated_plugin' => array('akismet/akismet.php') .
  • Anfrage (Array) – Wird bei $_GET- oder $_POST-Werten angezeigt. Hinweis: Es wird ein Array von Arrays mit den Parametern 'key' und 'value' benötigt. Beispiel: 'request' => array( array( 'key' => 'show_notice', 'value' => '1' ), ) .
• keep_active_on (Array) – Hält die Benachrichtigung immer geöffnet, sobald die display_on-Anforderungen erfüllt sind, bis der Benutzer die Benachrichtigung schließt. Der Standardwert ist array( 'activated_plugin', 'updated_plugin' ) ,

Beispiele

Erstellen Sie eine Mitteilung, die eine Woche lang geschlossen bleibt

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

Erstellen Sie einen Hinweis, der nur auf der Plugins-Seite angezeigt wird

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

Erstellen Sie einen Hinweis, der angezeigt wird, nachdem das Akismet-Plugin aktiviert wurde

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

Paketinstallation (über Composer)

Um dieses Paket zu installieren, bearbeiten Sie Ihre composer.json -Datei:

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

Führen Sie nun Folgendes aus:

$ composer install