Beharrte WordPress Admin-Hinweise Teil 1

WordPress-Administratorbenachrichtigungen bieten eine bequeme Möglichkeit, Benutzern im Admin-Bereich Nachrichten anzuzeigen, z. nachdem ein Beitrag aktualisiert wurde oder ein Plugin aktiviert wurde. Sie werden auch von vielen Themes und Plugins verwendet, um Benachrichtigungen über neue Funktionen oder Sicherheitswarnungen bis hin zu Details zu laufenden Werbeaktionen oder Upgrade-Aufforderungen anzuzeigen.

WordPress Core bietet vier verschiedene Administratorbenachrichtigungen, die im Kontext verwendet werden können, um einen Benutzer auf einen bestimmten Benachrichtigungstyp aufmerksam zu machen. Dies wird erreicht, indem für jede Art von Verwaltungsbenachrichtigung eine eigene Akzentfarbe angezeigt wird.

Administratorhinweise werden in der Regel oben auf jeder Verwaltungsseite angezeigt, um sich vom Inhalt der Hauptseite abzuheben und deutlich erkennbar zu sein. Sie sind elegant gestaltet, um nicht zu störend zu wirken.

In WordPress werden auch Administratorbenachrichtigungen an anderen Stellen der Administratoroberfläche verwendet, z. B. wenn ein Thema oder ein Plugin-Update verfügbar ist. Die grundlegende Verwendung von Administratorbenachrichtigungen beschränkt sich nicht nur darauf, oben im Administratorbildschirm angezeigt zu werden.

Die Anzeige eines Admin-Hinweises in einem benutzerdefinierten Plugin oder Thema ist relativ einfach und erfordert nur wenige Zeilen Code, wie wir in Kürze erfahren werden. WordPress bietet jedoch standardmäßig keine Möglichkeit, eine beharrliche Administratorbenachrichtigung abzulehnen.

Auch wenn Sie einer Administratorbenachrichtigung eine Abbruchschaltfläche hinzufügen können, verhindert dies nicht, dass sie erneut angezeigt wird, wenn die Seite neu geladen wird. Außerdem werden auf jeder Admin-Seite Administratorbenachrichtigungen angezeigt, was alles andere als ideal ist.

Wenn Sie genau steuern möchten, wann und wo Administratorbenachrichtigungen angezeigt werden, und um diese effektiv deaktivieren zu können, müssen Sie benutzerdefinierten Code hinzufügen, um das Standardverhalten zu ändern.

Was wir abdecken werden

Wir beginnen am Anfang und erkunden die Grundlagen der Implementierung von Administratorbenachrichtigungen über ein benutzerdefiniertes Plugin, einschließlich der Anzeige nur auf bestimmten Seiten des WordPress-Administrators.

Administratorhinweise werden standardmäßig auf jeder Seite angezeigt. Dies ist nicht immer das, was Sie möchten. Beispielsweise möchten Sie möglicherweise nur eine Benachrichtigung auf einer Plugin-Optionsseite anzeigen. Unser nächster Anlaufpunkt besteht also darin, abhängig von dem aktuellen Admin-Bildschirm die Administratorbenachrichtigungen bedingt anzuzeigen.

Darauf aufbauend werden Wege aufgezeigt, wie Administrationsbenachrichtigungen durch das Controlling weiter verwaltet werden können wann sie erscheinen auch Sie erscheinen nicht, sobald die Seite geladen wird. Sie werden nur angezeigt, wenn bestimmte Auslösebedingungen erfüllt sind. Dies kann beispielsweise nützlich sein, wenn Sie einen Administratorhinweis auf einer Plugin-Optionsseite anzeigen möchten nur nachdem die Einstellungen gespeichert wurden.

Wie oben erwähnt, gibt es keine einfache Möglichkeit, persistente Verwaltungsbenachrichtigungen zwischen dem Laden von Seiten zu verwerfen. Der Rest der Tutorialserie konzentriert sich daher hauptsächlich auf verschiedene Methoden, mit denen Sie Verwaltungsbenachrichtigungen abweisen können, damit sie nicht unerwartet wieder angezeigt werden.

Zu guter Letzt werden wir sehen, wie Sie Ihre eigenen benutzerdefinierten Administratorbenachrichtigungstypen erstellen und Ihren Administratorbenachrichtigungen zusätzliche Verzierungen wie Symbole hinzufügen können.

Am Ende dieser Tutorialserie können Sie jede Art von Administratorbenachrichtigung an beliebiger Stelle innerhalb des WordPress-Administrators anzeigen. Außerdem können Sie entscheiden, ob sie beim Laden der Seite oder über eine benutzerdefinierte Aktion angezeigt werden sollen. Außerdem können Sie sie je nach Ihren Anforderungen auf verschiedene Arten abweisen.

Folgen Sie mit?

Sie werden das Beste aus dieser Tutorial-Serie herausholen, wenn Sie die Anweisungen in der Verwaltungsbenachrichtigung weiterentwickeln. Der Code wird Schritt für Schritt vorgestellt, damit Sie im Verlauf des Tutorials selbst ein funktionsfähiges Plugin erstellen können. Wenn Sie jedoch nicht den gesamten Code selbst eingeben möchten, steht das fertige Plugin in Teil 4 zum Download zur Verfügung.

Es wird davon ausgegangen, dass Sie zumindest über grundlegende Kenntnisse der Entwicklung von WordPress-Plugins verfügen, einschließlich der Funktionsweise von Hooks. Wenn nicht, dann würde ich empfehlen, diese Themen in der offiziellen WordPress-Dokumentation nachzulesen, bevor Sie fortfahren:

  • Einführung in die Plugin-Entwicklung
  • Ein Plugin schreiben
  • WordPress-Hooks

Um den Plugin-Code für jedes Beispiel zu testen, benötigen Sie eine funktionierende WordPress-Site. Am einfachsten ist es, WordPress lokal zu installieren, damit Sie leicht auf Dateien zugreifen können. 

Es gibt viele Möglichkeiten für die lokale Entwicklung mit WordPress, einschließlich:

  • Lokal mit dem Schwungrad
  • DesktopServer
  • MAMP (und MAMP PRO)
  • Landstreicher

Wenn Sie noch nicht mit der WordPress-Entwicklung vertraut sind, ist es wahrscheinlich am einfachsten, Local oder DesktopServer einzurichten. Local ist kostenlos (es gibt eine Premium-Version), und DesktopServer hat eine eingeschränkte (kostenlose) Version sowie eine Premium-Version.

Außerdem werden einige Vorkenntnisse in PHP und JavaScript sowie einige Erfahrungen mit der Implementierung von Ajax-Anforderungen empfohlen. Es wird jedoch alles auf dem Weg erklärt, so dass kein fundiertes Wissen erforderlich ist.

Ein genauerer Blick auf Admin-Hinweise

Werfen wir einen Blick auf die grundlegendste Implementierung einer Administratorbenachrichtigung und den Code, der erforderlich ist, um eine Erfolgstypbenachrichtigung zu erstellen.

Funktion display_admin_notice () ?> 

Das Geheimnis des Erfolgs ist es, etwas zu wissen, das niemand anderes kennt ~ Aristoteles Onassis

Wir haben hier nur das registriert display_admin_notice () Funktion, die ausgeführt wird, wenn die Admin_Notizen Haken Feuer. Es spielt keine Rolle, wie die registrierte Funktion bezeichnet wird. Sie hat keinen Einfluss auf die Darstellung der Administratorbenachrichtigung.

Machen Sie sich jetzt keine Sorgen, den Code über sich selbst einzugeben. Konzentrieren Sie sich einfach darauf, wie der Admin-Hinweis generiert wird, da wir in späteren Tutorials darauf aufbauen werden.

Sie können ein beliebiges Markup verwenden, um einen Admin-Hinweis anzuzeigen. Das empfohlene Format lautet jedoch wie folgt:

Botschaft

Ersetzen Klasse mit einer Liste von CSS-Klassennamen. Sie sollten die Klasse einschließen beachten plus eine der folgenden Klassen, um die Art der Administratorbenachrichtigung zu bestimmen:

  • Hinweis-Fehler (rot)
  • Hinweis-Warnung (Gelb Orange)
  • Kündigungserfolg (Grün)
  • Hinweis-Info (Blau)

Das Botschaft Block kann ein beliebiger Text oder gültiger HTML-Code sein, der in der Administratorbenachrichtigung angezeigt wird.

Das obige Beispiel zeigt Admin-Hinweise auf allen Admin-Seiten, was nicht immer ideal ist. In Teil zwei werden wir uns ansehen, wie Sie genau steuern können, auf welchen Seiten sie erscheinen.

Es gibt eine weitere integrierte CSS-Klasse, die Sie hinzufügen können div.notice Dies fügt der Admin-Benachrichtigung eine Schaltfläche zum Entfernen hinzu. Mal sehen, was passiert, wenn der gleiche Admin-Hinweis den Erfolg hat ist abzulehnen Klasse hinzugefügt.

Funktion display_admin_notice () ?> 

Das Geheimnis des Erfolgs ist es, etwas zu wissen, das niemand anderes kennt ~ Aristoteles Onassis

Wir haben jetzt eine einfache Möglichkeit, eine Administratorbenachrichtigung abzulehnen. Bevor Sie jedoch zu aufgeregt werden, gibt es ein Problem bei der Verwendung dieser Methode. Wenn Sie die Seite aktualisieren, wird die Administratorbenachrichtigung erneut angezeigt. Auch wenn Sie festlegen können, dass eine Administratormitteilung nicht zulässig ist, ist sie dauerhaft und der Status "Abgewiesen" wird zwischen den Seitenladungen vergessen.

Wir werden später ausführlich auf hartnäckige Verwaltungsbenachrichtigungen eingehen und verschiedene Möglichkeiten erkunden, wie Sie sie verwerfen können, ohne dass sie erneut angezeigt werden.

Aber Admin-Hinweise sind schlecht! Sind sie nicht?

Wenn Sie mit den Administratorbenachrichtigungen in WordPress vertraut sind und / oder allgemein mit den WordPress-Nachrichten auf dem Laufenden sind, ist Ihnen möglicherweise ein gewisses Maß an Negativität in Bezug auf die Verwendung von Administratorbenachrichtigungen in benutzerdefinierten Plug-Ins und Designs bekannt.

Dies ist darauf zurückzuführen, dass einige Plugins zu viele Administrationsnotizen verwendet haben, um ihre 'wichtigen' Nachrichten zu vermitteln. Wenn Sie viele Plugins installiert haben und nur ein paar von ihnen das Administratorbenachrichtigungssystem missbrauchen, können Sie schnell mit der Administratorbenachrichtigung "soup" enden, bei der eine Reihe von Benachrichtigungen oben auf jeder Admin-Seite angezeigt wird.

Das Überladen von Admin-Bildschirmen mit unnötigen Benachrichtigungen kann zu Chaos (und Kopfschmerzen) führen und ist für Benutzer verständlicherweise ärgerlich, da dies die Verwaltung einer Site erschwert.

Im Idealfall sollten nur wichtige Administratorbenachrichtigungen, wie z. B. wichtige Sicherheitsupdates, bei jedem Laden der Seite angezeigt werden. Wenn Sie globale Administratorbenachrichtigungen anzeigen, um den Benutzern mitzuteilen, dass ein Plugin gerade aktualisiert wurde, und Sie aufgefordert werden, auf einen Link zu klicken, um weitere Informationen zu erhalten, sollten Sie sich wirklich fragen, ob dies auf jeder Administratorseite angezeigt werden muss.

Ein typischer Favorit ist auch die Anzeige einer nicht kritischen Verwaltungsbenachrichtigung, die nicht dauerhaft dauerhaft verworfen werden kann. Ich garantiere Ihnen, dass es keinen einfacheren Weg gibt, Ihre Plugin-Benutzer zu verfremden, als dies tun würde!

Es gibt jedoch Anwendungsfälle für permanente Benachrichtigungen, die nicht unzulässig sind, wie z. B. Datenbankaktualisierungen. Plugins, die benutzerdefinierte Tabellen verwenden, müssen möglicherweise gelegentlich Datenbankaktualisierungsroutinen ausführen, damit das Plugin ordnungsgemäß ausgeführt wird. In diesem Fall ist es daher sinnvoll, eine nicht abgelehnte Verwaltungsbenachrichtigung hinzuzufügen.

Eine gute Faustregel ist, nur den gesunden Menschenverstand einzusetzen. Würde der Admin-Hinweis, den Sie gerade hinzufügen, als Benutzer Sie stören? Wenn dies der Fall ist, möchten Sie möglicherweise das Hinzufügen des Hinweises überdenken oder überlegen, ob er an einem anderen Ort besser angezeigt wird.

Fazit

In diesem Tutorial haben wir uns mit den Administratorbenachrichtigungen und den verschiedenen integrierten Typen von WordPress befasst, einschließlich einer unzulässigen Administratorbenachrichtigung. Wie wir gesehen haben, gibt es einige Nachteile bei der Standardimplementierung von Administratorbenachrichtigungen, z. B. dass sie nicht abgelehnt werden können und dass sie auf jeder Admin-Seite angezeigt werden.

WordPress hat eine unglaublich aktive Wirtschaft. Es gibt Designs, Plugins, Bibliotheken und viele andere Produkte, mit deren Hilfe Sie Ihre Site und Ihr Projekt ausbauen können. Der Open-Source-Charakter der Plattform macht sie außerdem zu einer großartigen Option, mit der Sie Ihre Programmierkenntnisse verbessern können. In jedem Fall können Sie sehen, was wir auf dem Envato-Markt haben.

Der Rest der Tutorials in dieser Serie konzentriert sich darauf, wie wir Administrationsbenachrichtigungen erweitern können, um praktischer zu sein, wenn sie in Ihren eigenen Plugins und Themes verwendet werden.