Wir sind noch nicht ganz fertig! Wie wir sehen k?nnen, erfordert die add_options_page eine gültige Rückruffunktion, die wir in unserer Klasse veraltet_notice_admin noch nicht definiert haben. Fügen wir es hinzu. Dies sollte einfach genug sein, da wir den in unserem Admin/Partials-Ordner enthaltenen veralteten Veraltungsverz?gerungs-Admin-display.php verwenden. Wir müssen also nur für unsere Rückruffunktion diese Datei einfügen.

<span>/**
</span><span>	 * Add an options page under the Settings submenu
</span><span>	 *
</span><span>	 * <span>@since  1.0.0
</span></span><span>	 */
</span>	<span>public function add_options_page() {
</span>	
		<span>$this->plugin_screen_hook_suffix = add_options_page(
</span>			<span>__( 'Outdated Notice Settings', 'outdated-notice' ),
</span>			<span>__( 'Outdated Notice', 'outdated-notice' ),
</span>			<span>'manage_options',
</span>			<span>$this->plugin_name,
</span>			<span>array( $this, 'display_options_page' )
</span>		<span>);
</span>	
	<span>}</span>

das sollte es tun. Das Letzte, was wir jetzt tun müssen, ist, es korrekt mit der bereitgestellten Laderklasse in der Kesselplatte zu laden. ?ffnen Sie Ihre aus dem Klassenausgeschaltete, die NOTICE.PHP im inklusiven Ordner und den zus?tzlichen Haken hinzufügen, den wir zuvor in der Methode define_admin_hooks definiert haben. Der richtige Action -Haken, der auf unserer Optionsseite aufgenommen werden soll, ist admin_Menu. Fügen wir ihn hinzu.

<span>/**
</span><span>	 * Render the options page for plugin
</span><span>	 *
</span><span>	 * <span>@since  1.0.0
</span></span><span>	 */
</span>	<span>public function display_options_page() {
</span>		<span>include_once 'partials/outdated-notice-admin-display.php';
</span>	<span>}</span>

Sie sollten nun ein zus?tzliches Untermenü ?veralteter Mitteilung“ unter Einstellungen sehen. Sie k?nnen auf die Seite mit leeren Optionen zugreifen, indem Sie zur URL http: // /wp-admin/options-general.php?page=outdated-Notice gehen.

Es handelt sich vorerst um eine leere Seite. Beginnen wir also damit

Registrieren Sie den Haken mit dem Boilerplate -Loader
Registrieren Sie einen Einstellungsabschnitt
Registrieren Sie zwei Einstellungsfelder (Schwellentage und Textposition)
Registrieren Sie die beiden Einstellungen
Populate der Optionen Seite
Speichern und Wiederholung der Felder für die Anzeige.

<span>$this->loader->add_action( 'admin_menu', $plugin_admin, 'add_options_page' );</span>

<span>$this->loader->add_action( 'admin_init', $plugin_admin, 'register_setting' );</span>

<span>/**
</span><span>	 * Add an options page under the Settings submenu
</span><span>	 *
</span><span>	 * <span>@since  1.0.0
</span></span><span>	 */
</span>	<span>public function add_options_page() {
</span>	
		<span>$this->plugin_screen_hook_suffix = add_options_page(
</span>			<span>__( 'Outdated Notice Settings', 'outdated-notice' ),
</span>			<span>__( 'Outdated Notice', 'outdated-notice' ),
</span>			<span>'manage_options',
</span>			<span>$this->plugin_name,
</span>			<span>array( $this, 'display_options_page' )
</span>		<span>);
</span>	
	<span>}</span>

Beachten Sie, dass wir unseren Abschnittsnamen mit dem Variablen $ option_name vorwanden, um Konflikte mit anderen Plugins zu verhindern. Der Rückruf kann verwendet werden, um zus?tzliche Informationen zu unserem Abschnitt bereitzustellen, genau das, was wir wollen.

Wir werden eine weitere ?ffentliche Methode hinzufügen, veraltet_notice_general_cb, die grundlegende Informationen zu diesem Abschnitt wiederholt.

<span>/**
</span><span>	 * Render the options page for plugin
</span><span>	 *
</span><span>	 * <span>@since  1.0.0
</span></span><span>	 */
</span>	<span>public function display_options_page() {
</span>		<span>include_once 'partials/outdated-notice-admin-display.php';
</span>	<span>}</span>

Registrieren Sie zwei Einstellungsfelder (Schwellentage und Textposition)

Der n?chste Teil der Einstellungs -API, den wir verwenden müssen, besteht darin, das tats?chliche Feld auf der Seite der Optionen zu registrieren. Dies kann mit der Funktion add_Setings_field erreicht werden.

Wir werden Optionspunkte für die Textpositionskonfiguration verwenden. Dies erfolgt durch Hinzufügen dieses Codes zur Funktion Register_Setting, die wir haben.

<span>$this->loader->add_action( 'admin_menu', $plugin_admin, 'add_options_page' );</span>

Wir müssen sicherstellen, dass das fünfte Argument von add_Setings_field auf den zuvor registrierten Abschnitt der richtigen Einstellungen verweist, oder wir sehen das Feld m?glicherweise nicht auf unserer Optionsseite.

Dies wird noch nicht getan. Wir müssen die Rückruffunktion bereitstellen, die das tats?chliche Markup für unsere Optionsfelder rendert. In unserer Funktion veraltet_notice_position_cb müssen wir diesen Codeblock einschlie?en:

<span>$this->loader->add_action( 'admin_init', $plugin_admin, 'register_setting' );</span>

Die zweite Option für den Tagesschwellenwert kann mit einem normalen Texteingang konfiguriert werden. Wir werden also ein anderes Einstellungsfeld registrieren:

<span>/**
</span><span>	 * The options name to be used in this plugin
</span><span>	 *
</span><span>	 * <span>@since  	1.0.0
</span></span><span>	 * <span>@access 	private
</span></span><span>	 * <span>@var  	<span>string</span> 		$option_name 	Option name of this plugin
</span></span><span>	 */
</span>	<span>private $option_name = 'outdated_notice';</span>

Au?erdem müssen wir auch eine Rückruffunktion bereitstellen, die unser Textfeld rendert.

<span>// Add a General section
</span>	<span>add_settings_section(
</span>		<span>$this->option_name . '_general',
</span>		<span>__( 'General', 'outdated-notice' ),
</span>		<span>array( $this, $this->option_name . '_general_cb' ),
</span>		<span>$this->plugin_name
</span>	<span>);</span>

Registrieren Sie die Einstellungen

Schlie?lich müssen wir den Optionsnamen registrieren, den wir verwenden werden, damit er in WordPress erkannt werden kann. Da wir zwei verschiedene Optionsnamen verwenden, veraltet_notice_position und veraltet_notice_day, werden wir sie beide mit der Funktion "Register_Seting" registrieren.

<span>/**
</span><span>	 * Render the text for the general section
</span><span>	 *
</span><span>	 * <span>@since  1.0.0
</span></span><span>	 */
</span>	<span>public function outdated_notice_general_cb() {
</span>		<span>echo '<p>' . __( 'Please change the settings accordingly.', 'outdated-notice' ) . '</p>';
</span>	<span>}</span>

Beachten Sie, dass der dritte Parameter für die Funktion "Register_Setting" ein Sanitalisierungsrückruf ist. Obwohl es optional ist, ist es immer nützlich, sicherzustellen, dass die Eingabeteile saniert werden, bevor sie in der Datenbank gespeichert werden.

Für die t?gliche Desinfektion werden wir die integrierte PHP-Funktion intval verwenden, da sie in unserem Fall ausreicht. In Bezug auf die Position des Textnotizs werden wir unsere eigene Desinfektionsrückruffunktion definieren, mit der nur bestimmte Werte in der Datenbank gespeichert werden k?nnen. Dies ist besonders nützlich, wenn es um Optionen geht, die auf bestimmte Werte beschr?nkt sind, z. Diese, es wird nicht in der Datenbank gespeichert.

Hier ist eine einfache Desinfektionskallback -Funktion, um dies zu erreichen:

<span>/**
</span><span>	 * Add an options page under the Settings submenu
</span><span>	 *
</span><span>	 * <span>@since  1.0.0
</span></span><span>	 */
</span>	<span>public function add_options_page() {
</span>	
		<span>$this->plugin_screen_hook_suffix = add_options_page(
</span>			<span>__( 'Outdated Notice Settings', 'outdated-notice' ),
</span>			<span>__( 'Outdated Notice', 'outdated-notice' ),
</span>			<span>'manage_options',
</span>			<span>$this->plugin_name,
</span>			<span>array( $this, 'display_options_page' )
</span>		<span>);
</span>	
	<span>}</span>

Populate der Optionen Seite

Nachdem wir mit der Registrierung aller zugeh?rigen Einstellungen fertig sind, müssen wir jetzt sicherstellen, dass die Seite unserer Optionen korrekt ist. Da wir die WordPress -Art verwenden, um unsere Felder und Einstellungen zu registrieren, ist diese Aufgabe besonders einfach.

?ffnen Sie die veraltete Notice-Admin-display.php im Ordner admin/partials. So k?nnen wir die Optionsseite basierend auf den Einstellungen, die wir zuvor registriert haben, rendern.

<span>/**
</span><span>	 * Render the options page for plugin
</span><span>	 *
</span><span>	 * <span>@since  1.0.0
</span></span><span>	 */
</span>	<span>public function display_options_page() {
</span>		<span>include_once 'partials/outdated-notice-admin-display.php';
</span>	<span>}</span>

Mit einer einfachen Kombination von do_Setings_sektionen und Einstellungen_Fields -Funktionen erfolgt Ihre Optionsseite in kürzester Zeit.

Machen wir eine Pause und aktualisieren Sie die Seite der Optionen.

Speichern und neu bev?lkert die Felder

Versuchen Sie, einige Werte einzufüllen und das Formular zu speichern. Sie sollten die Bekanntmachung "Einstellungen speichern" erhalten. Aber es passierte nichts. Versuchen Sie, unsere Optionen zu belegen. Platzieren Sie dies irgendwo in der verwandten Funktion.

<span>$this->loader->add_action( 'admin_menu', $plugin_admin, 'add_options_page' );</span>

wir sollten einige Werte aus der Datenbank zurückholen, gem?? dem folgenden Beispiel:

<span>$this->loader->add_action( 'admin_init', $plugin_admin, 'register_setting' );</span>

Das bedeutet, dass unser Formular gut funktioniert. Das einzige, was noch übrig ist, ist, den aktuellen Wert im Textfeld anzuzeigen und sicherzustellen

<span>/**
</span><span>	 * The options name to be used in this plugin
</span><span>	 *
</span><span>	 * <span>@since  	1.0.0
</span></span><span>	 * <span>@access 	private
</span></span><span>	 * <span>@var  	<span>string</span> 		$option_name 	Option name of this plugin
</span></span><span>	 */
</span>	<span>private $option_name = 'outdated_notice';</span>

Code -Reinigung - WordPress -Plugin -Boilerplate verfügt über viele nützliche Funktionen, aber in unserem Fall ist die Administratorseite, die CSS und das JS -Laden v?llig unn?tig. Wir k?nnen das immer von unserer Codebasis entfernen, um es kleiner zu machen.
i18n (Internationalisierung) bereit - Obwohl wir das __ () und _e () in unserem Plugin ausgiebig verwenden, gehen wir nicht wirklich den tats?chlichen i18n -Prozess durch. Ich werde den Prozess hier nicht behandeln, da dieses Thema beispielsweise in diesem Artikel ziemlich ausführlich auf SitePoint er?rtert wurde.
feinere Auswahl - Wenn unsere Implementierung auf alle Beitr?ge angewendet wird, k?nnen wir sie weiter optimieren, um sie auf einen Beitrag in einer bestimmten Kategorie oder Beitr?ge mit bestimmten Tags enthalten.
• .

Der vollst?ndige Code kann aus diesem Github-Repository im Teil-2-Zweig angezeigt werden.

Schlussfolgerung

Wir haben ein Plugin mit grundlegenden Administratorfunktionen erstellt, indem wir verwandte Einstellungen registrieren und eine Optionsseite erstellt haben, mit der der Benutzer unser Plugin anpassen kann. In einer relativ kurzen Zeit mit dem WordPress -Plugin -Boilerplate haben wir dies erreicht, ohne die Codequalit?t zu beeintr?chtigen und dennoch die von WordPress empfohlenen Best Practices zu halten.

Seien Sie gespannt auf den n?chsten Teil der Serie, in dem wir die ?ffentliche Seite des Plugins durchführen, um die entsprechende Bekanntmachung innerhalb des Post -Inhalts anzuzeigen.

H?ufig gestellte Fragen zur Entwicklung eines WordPress -Plugins mit Boilerplate

Was ist der WordPress-Plugin-Kesselplatte und warum sollte ich sie verwenden? Es bietet eine klare und konsistente Struktur, die leicht zu verstehen und mit ihnen zu arbeiten ist. Mit dieser Kesselplatte sparen Sie viel Zeit und Mühe beim Einrichten der Grundstruktur eines Plugins. Es stellt au?erdem sicher, dass Ihr Plugin WordPress -Codierungsstandards und Best Practices folgt. Dies kann dazu beitragen, Fehler und Kompatibilit?tsprobleme zu verhindern. Mit dem WordPress -Plugin -Boilerplate müssen Sie sie zun?chst aus dem GitHub -Repository herunterladen. Nach dem Herunterladen k?nnen Sie das Verzeichnis und die Dateien des Boilerplate umbenennen, um den Namen Ihres Plugins zu entsprechen. Anschlie?end k?nnen Sie Ihr Plugin entwickeln, indem Sie der vorhandenen Struktur der Boilerplate Ihre eigene benutzerdefinierte Funktionalit?t hinzufügen. Hauptkomponenten. Dazu geh?ren die Plugin -Datei, die die Plugin -Header- und Loader -Klasse enth?lt. Das Include-Verzeichnis, das die Kern-Plugin-Klasse und andere funktionellbezogene Dateien enth?lt. das Administratorverzeichnis, das Dateien enth?lt, die sich auf die adminspezifische Funktionalit?t des Plugins beziehen; und das ?ffentliche Verzeichnis, das Dateien enth?lt, die sich auf die ?ffentlich ausgerichtete Funktionalit?t des Plugins beziehen. Mit dem WordPress -Plugin -Boilerplate k?nnen Sie neue Klassen im Incluen -Verzeichnis erstellen. Diese Klassen sollten die von der Kesselplatte bereitgestellte Basisklasse erweitern. Sie k?nnen diesen Klassen dann Ihre eigenen Methoden hinzufügen, um Ihre gewünschte Funktionalit?t zu implementieren. Sie k?nnen auch die vorhandenen Klassen und Methoden nach Bedarf ?ndern. Diese Klasse enth?lt Methoden zum Registrieren der Einstellungen, zum Anzeigen von Feldern der Einstellungen und zur Bereinigung von Einstellungswerten. Sie k?nnen diese Klasse als Ausgangspunkt für die Implementierung Ihrer eigenen Einstellungsfunktionen verwenden.

Wie füge ich meinem Plugin admin-spezifische Funktionen hinzu? Dieses Verzeichnis enth?lt Klassen zum Erstellen von Administratorseiten, Feldern für Einstellungen und Einreichungen von Formularformular. Mit Plugin k?nnen Sie die Klassen und Methoden im ?ffentlichen Verzeichnis des WordPress -Plugin -Boilerplate verwenden. Dieses Verzeichnis enth?lt Klassen für Enqueuching-Skripte und -stile sowie zum Anzeigen von Inhalten mit ?ffentlichen Auseinandersetzungen. Internationalisierung. Diese Klasse enth?lt Methoden zum Laden der Textdom?ne des Plugins, mit der Ihr Plugin in verschiedene Sprachen übersetzt werden kann. Für die Behandlung von Ajax -Anfragen. Diese Klassen enthalten Methoden zum Registrieren von AJAX -Aktionen, zur Bearbeitung von AJAX -Anforderungen und zum Senden von AJAX -Antworten. Die Plugin -Kesselplatte kann auf verschiedene Arten erfolgen. Eine gemeinsame Methode besteht darin, die WP_DEBUG-Konstante in Ihrer Datei wp-config.php zu verwenden. Dadurch werden PHP -Fehler, Hinweise und Warnungen angezeigt. Sie k?nnen auch verschiedene Debugging-Plugins verwenden, die für WordPress verfügbar sind, oder die integrierte Fehlerprotokollierungsfunktion von PHP verwenden.