Eine Einführung in die WordPress -Dashboard -Widgets -API

Die WordPress-Dashboard-Widgets-API lässt Themen und Plugins WordPress-Dashboard-Widgets hinzufügen, entfernen oder neu positionieren. Das WordPress -Dashboard ist das erste, was wir sehen, wenn wir uns beim WordPress -Administrationsbildschirm anmelden. Die WordPress Dashboard -Widget -API ist ab WordPress 2.7 erhältlich. In diesem Tutorial werden wir uns die verschiedenen Aktionen und Funktionen ansehen, die von der API bereitgestellt werden. Und wie Sie das Dashboard -Widget mit dieser API hinzufügen, entfernen und positionieren.

Key Takeaways

• Die WordPress-Dashboard-Widgets-API ermöglicht die Hinzufügung, Entfernen oder Wiedereinstellung von Widgets auf dem WordPress-Dashboard. Diese API ist seit WordPress 2.7 verfügbar und ist ein Schlüsselwerkzeug für WordPress -Entwickler.
• Hinzufügen eines Widgets beinhaltet die Verwendung der Funktion WP_ADD_Dashboard_Widget, für die drei Argumente erforderlich sind: eine eindeutige ID für das Widget, den Titel des Widgets und einen Rückruf, der den Inhalt des Widgets anzeigt. Das Entfernen eines Widgets erfolgt über die Funktion REMED_META_BOX.
• Während die API keine Möglichkeit bietet, die Position der Widgets zu ändern, kann eine Problemumgehung erreicht werden, indem die Variable WordPress Core $ wp_meta_box manipuliert wird. Widgets können benutzerdefinierte Daten hinzugefügt werden, und ihr Erscheinungsbild kann mit CSS angepasst werden.

hinter der Szene von WordPress Dashboard -Widgets

Intern sind WordPress Dashboard -Widgets WordPress -Metaboxen. Die Dashboard -Widget -API verwendet die WordPress -Meta -Box -API, um Dashboard -Widgets hinzuzufügen, zu entfernen und zu positionieren.

Hinzufügen eines Dashboard -Widgets

Mit der Funktion WP_ADD_Dashboard_Widget können wir dem WordPress -Dashboard ein Widget hinzufügen. Wir müssen diese Funktion in den Hook wp_dashboard_setup einwickeln. Hier finden Sie einen Beispielcode zur Verwendung von wp_add_dashboard_widget:

<span>function add_dashboard_widget()
</span><span>{
</span><span>wp_add_dashboard_widget("sitepoint", "SitePoint Videos", "display_sitepoint_dashboard_widget");
</span><span>}
</span>
<span>function display_sitepoint_dashboard_widget()
</span><span>{
</span><span>echo "Watch Video Courses at <a href='http://learnable.com'>Learnable</a>";
</span><span>}
</span>
<span>add_action("wp_dashboard_setup", "add_dashboard_widget");</span>

Hier rufen wir wp_add_dashboard_widget in add_dashboard_widget auf, das vom WP_Dashboard_Setup -Hook ausgelöst wird. wp_add_dashboard_widget nimmt drei Argumente. Hier sind die Argumente:

1. $ id: Jedes Dashboard -Widget muss eine eindeutige ID haben. Stellen Sie sicher, dass Sie es mit Ihrem Plugin- oder Themennamen vorfixieren, um Überschreibungen zu vermeiden.
2. $ title: Titel des zu angezeigten Widgets.
3. $ CALLBACK: Ein Rückruf, der den Inhalt des Widgets anzeigt.

So sieht das Widget aus:

Entfernen eines Dashboard -Widgets

Wir können ein Standard- oder benutzerdefiniertes Dashboard -Widget mit der Funktion REMED_META_BOX entfernen. Wir müssen diese Funktion in der Funktion WP_DASHBOARD_SETUP einwickeln. Hier erfahren Sie, wie wir REMED_META_BOX verwenden:

<span>function add_dashboard_widget()
</span><span>{
</span><span>wp_add_dashboard_widget("sitepoint", "SitePoint Videos", "display_sitepoint_dashboard_widget");
</span><span>}
</span>
<span>function display_sitepoint_dashboard_widget()
</span><span>{
</span><span>echo "Watch Video Courses at <a href='http://learnable.com'>Learnable</a>";
</span><span>}
</span>
<span>add_action("wp_dashboard_setup", "add_dashboard_widget");</span>

Hier rufen wir die Funktion REMED_META_BOX in der Funktion REME_DASHBOARD_WIDGE auf, die tatsächlich von der Aktion wp_dashboard_setup ausgelöst wird. REMED_META_BOX nimmt drei Argumente ein, sie sind:

1. $ id: Die eindeutige ID des Widgets. Hier ist die Liste der IDs der Standard -Widgets: Dashboard_ACTIVITY , Dashboard_Right_Now , Dashboard_Recent_Coments , Dashboard_Recent_Drafts , Dashboard , Dashboard_quick_press , Dashboard_secondary , Dashboard_Primary und Dashboard_Coming_Links
.
$ Ort: Dies hat immer den Wert "Dashboard" beim Entfernen eines Dashboards.
$ Position: Wenn Sie ein Widget entfernen, das standardmäßig von WordPress Core erstellt oder mit wp_add_dashboard_widget erstellt wurde, ist sein Wert „normal“.

Positionierungswidgets im Dashboard

positionieren Standardmäßig werden die neuen Widgets links auf der Dashboard -Seite nach unten hinzugefügt. Die WordPress -Dashboard -Widgets -API bietet keine Möglichkeit, die Position der Widgets zu ändern. Wir können jedoch die WordPress Core $ wp_meta_box -Variable als Problemumgehung hacken. Hier ist ein Beispiel, wie wir unser Widget nach oben bringen können:

<span>function add_dashboard_widget()
</span><span>{
</span><span>wp_add_dashboard_widget("sitepoint", "SitePoint Videos", "display_sitepoint_dashboard_widget");
</span><span>}
</span>
<span>function display_sitepoint_dashboard_widget()
</span><span>{
</span><span>echo "Watch Video Courses at <a href='http://learnable.com'>Learnable</a>";
</span><span>}
</span>
<span>add_action("wp_dashboard_setup", "add_dashboard_widget");</span>

Sie können dieses Array ändern und die Position der Widgets nach Bedarf ändern.

Anzeigen eines RSS -Feeds in einem Dashboard -Widget

<span>function remove_dashboard_widget()
</span><span>{
</span><span>remove_meta_box("sitepoint", "dashboard", "normal");
</span><span>}
</span>
<span>add_action("wp_dashboard_setup", "remove_dashboard_widget");</span>

Lassen Sie uns ein Dashboard -Widget erstellen, das den RSS -Feed von SitePoint abholt und es dann anzeigt. Wir werden die WordPress -API verwenden, um den RSS -Feed zu holen und zu analysieren. Hier ist der Code für unser Widget: Hier schließen wir die Datei „feat.php“ ein, die alle APIs enthüllt, die für die Arbeit mit RSS in WordPress erforderlich sind. Dann verwenden wir Fetch_Feed, um den RSS -Feed herunterzuladen und zu analysieren. Schließlich zeigen wir 10 RSS -Elemente an. So sollte unser RSS -Dashboard -Widget aussehen:

Schlussfolgerung

Viele WordPress -Plugins wie Analytics, WooCommerce -Addons und verschiedene Überwachungsverlängerungen verwenden die Dashboard -Widgets -API. Die WordPress -Dashboard -Widgets -API ist eine der wichtigsten APIs für WordPress -Entwickler. In diesem Beispiel haben wir Sie durch einige grundlegende Beispiele geführt. Bitte kommentieren Sie Ihre Erfahrungen mit der API unten.

häufig gestellte Fragen zu WordPress Dashboard -Widgets api

Wie kann ich meinem WordPress -Dashboard ein neues Widget hinzufügen? Zunächst müssen Sie eine Funktion erstellen, die den Inhalt Ihres Widgets ausgibt. Anschließend müssen Sie diese Funktion mit WordPress mit der Funktion WP_ADD_Dashboard_Widget registrieren. Diese Funktion nimmt drei Parameter an: die ID des Widgets, ihren Namen und die Funktion, die seinen Inhalt ausgibt. Sobald Sie dies getan haben, wird Ihr Widget auf Ihrem Dashboard angezeigt.

Kann ich vorhandene Widgets aus meinem WordPress -Dashboard entfernen? Dies kann mit der Funktion REMED_META_BOX erfolgen. Diese Funktion dauert drei Parameter: die ID des Widgets, das Sie entfernen möchten, auf dem Bildschirm, auf dem das Widget angezeigt wird, und den Kontext, in dem das Widget angezeigt wird. Widgets?

Das Erscheinungsbild Ihres Dashboard -Widgets kann mit CSS angepasst werden. Sie können die CSS -Datei Ihres Themas in der Style.css -Datei Ihres Themas hinzufügen oder ein benutzerdefiniertes CSS -Plugin verwenden. Sie können bestimmte Widgets ansprechen, indem Sie ihre ID als CSS -Selektor verwenden.

Kann ich die Position meiner Dashboard -Widgets steuern? Dies kann mit dem Action -Hook wp_dashboard_setup erfolgen. Mit diesem Haken können Sie die Position Ihrer Widgets im Dashboard angeben.

Wie kann ich meinem Dashboard -Widget benutzerdefinierte Daten hinzufügen? Die Daten können alles sein, was Sie wollen, wie Statistiken, Diagramme oder sogar benutzerdefinierte Formulare.

Kann ich AJAX in meinen Dashboard -Widgets verwenden? . Dies kann durchgeführt werden, indem Sie die erforderlichen JavaScript -Dateien und die Verwendung des Action -Hooks wp_ajax_ zur Verarbeitung der AJAX -Anforderung auf der Serverseite verwenden. Ihr Dashboard -Widget wird mit JavaScript interaktiv. Sie können Ihre JavaScript -Dateien mit der Funktion wp_enqueue_script unterhalten und dann JavaScript verwenden, um Ihren Widgets Interaktivität hinzuzufügen. Fügen Sie Ihrem Dashboard mehrere Instanzen desselben Widgets hinzu. Jedes Widget muss über eine eindeutige ID verfügen. Wenn Sie also mehrere Instanzen desselben Widgets hinzufügen möchten, müssen Sie jede Instanz als separates Widget mit einer eindeutigen ID registrieren. Bildschirme in WordPress? Dies kann mit der Funktion add_meta_box erfolgen. Mit dieser Funktion können Sie jedem Bildschirm in WordPress Widgets hinzufügen, nicht nur zum Dashboard. Abfragen. Sie können diese Medienabfragen in die Style.css -Datei Ihres Themas hinzufügen oder ein benutzerdefiniertes CSS -Plugin verwenden. Sie können bestimmte Widgets ansprechen, indem Sie ihre ID als CSS -Selektor verwenden.

Das obige ist der detaillierte Inhalt vonEine Einführung in die WordPress -Dashboard -Widgets -API. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!