Hilfe-Tabs für das eigene Plugin erstellen

Create your own help tab

In diesem Beitrag möchte ich erläutern, wie man die Hilfe-Tabs des WordPress Admins für das eigene Plugin nutzen kann.

Hilfe-Tab erstellen
Hilfe-Tab erstellen

Beginnen wir also mit der Grundlage und erstellen eine neue Seite im Admin Menü:

Wie ihr wisst, erstellt man mit Hilfe von add_menu_page() einen neuen Menüpunkt. Diese Funktion gibt dabei die ID der neu registrierten Seite zurück. Mit Hilfe dieser können wir uns in die spezifische Load-Aktion der Seite einhaken:

add_action( 'load-' . $page_with_help, 'pwh_add_help_tab' );

In dieser Aktion werden wir nun unseren neuen Hilfe-Tab registrieren und ihm einige Inhalte geben.

Den Hilfe-Tab hinzufügen

Zunächst müssen wir den aktuellen Screen erhalten. Dazu können wir die Funktion get_current_screen() nutzen, welche uns das aktuellen WP_Screen Objekt zurückgibt. Dieses enthält unter anderem die Hilfe-Tabs.

Im zweiten Schritt werden wir nun mittels WP_Screen::add_help_tab() einen neuen Hilfe-Tab hinzufügen. Ein solcher enhält eine ID, einen Titel und den Inhalt:

Mit diesen zwei einfachen Schritten können wir unsere eigenen Hilfe-Tabs erzeugen, welche sich perfekt in das WordPress Design einfügen. Wir können auch eine Callback Funktion benennen, welche das Rendering des Inhalts übernimmt.

Mit einer solchen Callback Funktion erweitern wir unsere Möglichkeiten, den Output zu gestalten. Diese Funktion kann zwei Parameter aufnehmen: Zum einen das aktuelle Screen Objekt und zum anderen den aktuellen Hilfe-Tab.

Eine Sidebar erstellen

Auch die Hilfe Sektion kann über eine Sidebar verfügen. Sobald wir einen Tab registriert haben können wir dazu auf set_help_sidebar() zurückgreifen. Der Inhalt der Sidebar wird dann auf der rechten Seite der Sektion dargestellt.

Es ist also wirklich einfach, eine kleine Hilfe-Sektion für das eigene Plugin zu entwickeln. Für Eure Plugin-Nutzer kann eine gut gestaltete Hilfe dabei Gold wert sein.