In einem früheren Tutorial haben wir es Ihnen gezeigt Wie erstelle ich ein WordPress-Plugin?. Ich denke, jetzt ist die Zeit gekommen, um voranzukommen und Ihnen zu ermöglichen, mehr mit WordPress zu tun.

Für dieses Tutorial ist es wichtig, um sicherzustellen, dass Sie alles an seinem Platz haben, so können Sie mit dem Quellcode arbeiten, die wir vorschlagen.

Für dieses Tutorial, ich denke:

  • Sie haben eine Konfiguration der lokalen Entwicklungsumgebung in Bezug auf Ihr Betriebssystem.
  • Sie haben eine Kopie von WordPress installiert und können diese für die Installation eines Plugins verwenden.
  • Sie kennen die Entwicklungspraktiken von Wordpress-Plugins.
  • Sie arbeiten bequem mit PHP und HTML.

Wenn Sie nicht mit dem Einrichten einer lokalen Entwicklungsumgebung vertraut sind, die WordPress versteht, lade ich Sie ein, dies zu lesen.

Und wenn Sie mit PHP relativ vertraut sind, auch wenn es nur die Sprache liest, werde ich mein Bestes tun, um klare Anweisungen und Kommentare für jeden Code zu geben, den wir teilen.

Wie Wordpress lokal auf einem PC / Windows mit XAMPP installieren

Sobald dies geschehen ist, können wir mit der Arbeit an unserem Plugin beginnen.

Benutzerdefinierte Einstellungen einer Admin-Seite in WordPress

Am Ende dieser Reihe werden wir ein Plugin haben, das die folgenden Anforderungen erfüllt:

  • Fügt ein neues Untermenü zu einem vorhandenen Menü.
  • Fügt eine neue Einstellungsseite hinzu, die dem neuen Element entspricht.
  • Desinfiziert und "serialisiert" die Optionen auf der Seite.
  • Überprüft die gespeicherten Werte und gibt sie zurück.

Darüber hinaus werden wir sicherstellen, dass wir dies mithilfe von WordPress-Codierungsstandards und analogen Methoden so modular wie möglich angehen, um das Lesen, Schreiben und Verwalten unseres Plugins so einfach wie möglich zu gestalten.

1 - Erstellen Sie den Bootstrap des Plugins

Mit Bootstrap meinen wir: " Vorbereitung von Plugin-Elementen ", Dies umfasst das Erstellen eines Verzeichnisses für die Plugin-Dateien, eine Basis-README-Datei, eine Kopie der Lizenz, eine Bootstrap-Datei, die schließlich zum Starten des Plugins verwendet wird, und ein Verzeichnis, das verwendet wird Klassen im Zusammenhang mit Verwaltungsfunktionen pflegen.

Die Dateigruppe sieht folgendermaßen aus:

Organisation-of-records-the-Plugin

En outre, le Inhalt des Plugins ist recht einfach. Überprüfen Sie den folgenden Code für die PHP-Datei „ Benutzerdefinierte-admin-settings.php Ich werde diese Datei später genauer erklären.

<?php
/**
 * Startdatei
 *
 * Dies ist die Hauptdatei, die von WordPress gelesen wird.
 *
 * @link https://blogpascher.com
 * @seit 1.0.0
 * @package Custom_Admin_Settings
 *
 * @wordpress-plugin
 * Plugin-Name: Administration Custom
 * Plugin-URI: https://blogpascher.com
 * Beschreibung: Erfahren Sie, wie Sie ein WordPress-Plugin erstellen.
 * Version: 1.0.0
 * Autor: Ihr Name
 * Autoren-URI: https://example.com
 * Lizenz: GPL-2.0+
 * Lizenz-URI: http://www.gnu.org/licenses/gpl-2.0.txt
 */
 
// Wenn diese Datei direkt aufgerufen wird, Abbruch.
if ( ! definiert( 'WPINC' ) ) {
 sterben;
}
 
add_action('plugins_loaded', 'custom_admin_settings');
/**
 * Starten Sie das Plugin.
 *
 * @seit 1.0.0
 */
Funktion custom_admin_settings() {
 
}

Beachten Sie, dass im obigen Code nur sehr wenig Code vorhanden ist. Stattdessen gibt es viele Kommentare. Der Hauptkommentarblock am Anfang der Datei definiert das Plugin.

Der Bereich unterhalb der " @ Wordpress-Plugin WordPress liest, um den Plugin-Titel, die Beschreibung und die zugehörigen Links im WordPress-Plugin-Dashboard abzurufen.

Als nächstes verhindern wir, dass jemand direkt auf die Datei zugreift. Und schließlich erstellen wir eine benutzerdefinierte Funktion, die mit dem Ereignis ausgelöst wird. " plugins_loaded “. Mit dieser Funktion wird das Plugin gestartet.

Zu diesem Zeitpunkt sollten Sie in der Lage sein, eine Verbindung zu WordPress herzustellen, auf das Dashboard zuzugreifen und dann das Plugin anzuzeigen, das zum Aktivieren verfügbar ist. Fahren Sie fort und klicken Sie auf Aktivieren.

Es wird nichts mehr passieren, aber wir werden Funktionen hinzufügen, die wir im gesamten Lernprogramm verwenden werden.

2 - So erstellen Sie ein Untermenü

Um mit der Arbeit am Plugin zu beginnen, werden wir zunächst einen Untermenüpunkt einführen. Dazu müssen wir die WordPress-Funktion nutzen " add_options_page “. Diese Funktion benötigt fünf Parameter:

  • Der Text, der als Titel der Optionsseite angezeigt werden soll
  • Der Text, der als Untermenütext für den Menüpunkt angezeigt werden soll
  • die für den Zugriff auf diese Seite erforderlichen Funktionen
  • der Slug, der zur Identifizierung der Seite verwendet wird
  • eine Rückruffunktion, die zum Laden der Seite verwendet wird.

Beachten Sie, dass wir Klassen verwenden, um unsere Funktionalität zu organisieren. Vieles, was wir tun werden, wird in " objektorientiert ".

Zuerst erstellen wir eine Klasse im Administratorverzeichnis mit dem Namen " Klasse-submenu.php ". Da diese Klasse für die Einführung eines neuen Untermenüs verantwortlich ist, das wir beschreibend benannt haben.

Le Inhalt der Klasse sollte so aussehen:

submenu_page = $ submenu_page; } / ** * Fügen Sie ein Untermenü in das Werkzeugmenü ein. * / public function init () {add_action ('admin_menu', Array ($ this, 'add_options_page')); } / ** * Erstellt das Untermenüelement und ruft das Untermenüseitenobjekt auf, um * den tatsächlichen Inhalt der Seite zu rendern. * / public function add_options_page () {add_options_page ('Administrationsseite', 'Benutzerdefinierte Administrationsseite', 'Verwaltungsoptionen', 'Benutzerdefinierte Administrationsseite', Array ($ this-> Untermenüseite, 'Rendern')); }}

Zu diesem Zeitpunkt wird das Plugin noch nicht viel bewirken. Wir müssen noch die Klasse erstellen " Submenu_Page Dann müssen wir die Klassen in die Startdatei des Plugins aufnehmen.

3 - Erstellung einer Unterseite

Fangen wir mit der ersten Klasse an " Submenu_Page “. Erstellen Sie eine andere Datei im Verzeichnis " Administrator Und benenne es um " Klasse-Untermenü-page.php “. Fügen Sie dann in der Datei den folgenden Code hinzu.

<?php
/**
 * Erstellt die Untermenüseite für das Plugin.
 *
 * @package Custom_Admin_Settings
 */
 
/**
 * Erstellen Sie ein Untermenü für die Plugin-Seite.
 *
 * Bietet die notwendige Funktionalität zum Rendern der Seite.
 *
 * @package Custom_Admin_Settings
 */
Klasse Submenu_Page {
 
 /**
 * Diese Funktion gibt den mit einem Menü verknüpften Inhalt zurück, der das Rendern gewährleistet.
 */
 öffentliche Funktion render() {
 echo 'Dies ist die grundlegende Untermenüseite.';
 }
}

Wenn diese Seite angezeigt wird, wird ein einfacher Text angezeigt: " Dies ist die Untermenü Grund Seite. Wir werden endlich neue Optionen hinzufügen. Aber zuerst werden wir das Plugin zum Leben erwecken, indem wir es in unserer Startdatei instanziieren.

4 - Rendern des Menüs und der Seite

Dann öffnen Sie die Datei Benutzerdefinierte-admin-settings.php Das haben wir früher in diesem Tutorial erstellt. Lassen Sie uns fortfahren und Code schreiben, der zum Einführen des neuen Untermenüelements und der zugehörigen Seite erforderlich ist.

Denken Sie daran, die Klasse " Untermenü "Erfordert, dass eine Instanz der Klasse" Submenu_Page "Wird in seinem Konstruktor übergeben, dann müssen wir die Methode aufrufen" init Aus der Untermenü-Klasse alles in Bewegung setzen.

Im Code sieht es so aus:

drin (); }}

Zu diesem Zeitpunkt sollten Sie in der Lage sein, Ihre WordPress-Installation zu aktualisieren, aktivieren Sie das Plugin (wenn es nicht schon so ist), und greifen Sie dann im Dashboard auf Ihre neue Seite zu.

creation-Düne-Seite dadministration-on-Wordpress

Im nächsten Artikel werden wir sehen, wie wir beginnen können, echte Parameter in den Bildschirm einzuführen. Darüber hinaus werden wir uns einige der Best Practices für die Arbeit mit unserem Modell ansehen und dann sehen, wie sie mit der API verbunden werden, die sie nicht nur registriert, sondern auch bereinigt und validiert.

Das war's für dieses Tutorial. Zögern Sie nicht, uns Fragen zu stellen, wenn Sie einen Punkt nicht verstehen.