Detaillierte Erkl?rung und Best Practices des WordPress-Plug-in-Update-Mechanismus

WordPress selbst liefert keinen nativen Plug-in-Update-Prozess, und Entwickler müssen ihn selbst implementieren. Dies beinhaltet die Aktualisierung der Versionsnummer in der Datenbank und das Erstellen neuer Optionen gegebenenfalls.

Die Versionsnummer des WordPress -Plugins sollte an zwei Stellen gespeichert werden: Konstanten in der Hauptdatei und Optionen in der Datenbank. Dies erm?glicht die Erkennung, ob die Datenbankoptionen seit dem letzten Plugin -Update aktualisiert wurden.

Bei der Aktualisierung der Optionen sollten Entwickler darauf achten, die Auswahl des Benutzers nicht zu überschreiben. Wenn in der Datenbank keine Option vorliegt, sollte sie erstellt werden.

array_merge() Für Optionen, die als Arrays gespeichert sind, k?nnen Entwickler die PHP-Funktion

verwenden, um sicherzustellen, dass alle Schlüssel definiert sind und keine nicht existierenden Optionen eingeführt werden. Dies stellt auch sicher, dass der Wert beibehalten wird, wenn der Benutzer die alte Option ?ndert.

Vor ein paar Wochen habe ich eine E -Mail über die WP -Fotokugel (ein WordPress -Plugin, das ich entwickelt hat) erhalten. Das Problem ist gro?: Das Aktualisieren des Plugins l?sst einige Installateure zum Absturz bringen. Nach einigen Untersuchungen stellte ich fest, dass das Problem aus den vom Plugin verwendeten Optionen zurückzuführen ist: Diese Installateure liefern keine Standardwerte für die neuen Optionen, die ich hinzugefügt habe.

Diese Werte sind sehr wichtig, daher brauche ich eine M?glichkeit, die Standardwerte zu erstellen. Im Gegensatz zu dem, was ich denke, bietet WordPress jedoch keine nativen Methoden zur Behandlung des Aktualisierungsprozesses.

Deshalb m?chte ich dieses Tutorial schreiben. Erstens werden wir genau verstehen, warum wir den Aktualisierungsprozess ben?tigen und warum WordPress keinen solchen Prozess liefert. Ich werde Ihnen dann zeigen, wie Sie Ihren eigenen Prozess ordnungsgem?? erstellen, um Ihre Optionen zu aktualisieren.

Die Bedeutung des Plug-in-Update-Prozesses

Normalerweise reicht das ?ndern der Datei nicht aus, um etwas korrekt zu aktualisieren. Wenn Sie beispielsweise Ihre WordPress -Datei manuell auf eine neue Version aktualisieren, werden Sie von der Plattform aufgefordert, auf eine Schaltfl?che zu klicken, um die Datenbank zu aktualisieren.

Angenommen, Sie verwenden Optionen im Plugin. Wenn sich das Plugin entwickelt, ben?tigen Sie in der neuen Version weitere Optionen. Es ist einfach, neue Optionen zu erstellen, wenn der Benutzer zum ersten Mal das Plugin aktiviert. Sie müssen nur den Aktivierungshaken verwenden.

Schauen wir uns zum Beispiel den folgenden Code an:

function my_awesome_plugin_activation() {
    update_option('my_awesome_plugin_option', 'default value');
}
register_activation_hook(__FILE__, 'my_awesome_plugin_activation');

update_option() Wenn Sie nicht mit add_option() statt

vertraut sind, machen wir uns bitte keine Sorgen, wir werden es sp?ter erkl?ren, wenn wir besprechen, wie man mit dem Update -Prozess umgeht.

Wenn Sie eine neue Option wünschen oder den Wert einer vorhandenen Option in einer neuen Version aktualisieren, müssen Sie die Benutzerdatenbank aktualisieren, die bereits Ihr Plugin verwendet. Daher ben?tigen wir eine Funktion, die sofort nach dem Update aufgerufen wird .

Die Aktivierung des Hakens kann etwas verwirrend sein. Wenn Sie das Plugin automatisch aktualisieren, wird es schlie?lich deaktiviert und reaktiviert, sodass wir erwarten k?nnen, dass dieser Haken aufgerufen wird. Aber das ist nicht der Fall.

genauer gesagt, es war früher, aber WordPress hat dieses Verhalten in Version 3.1 gestoppt. Das Entwicklungsteam hat diese Option erl?utert und Sie k?nnen die vollst?ndige Erkl?rung im Make WordPress Core -Blog lesen. Der Hauptgrund ist, dass es nicht jedes Mal aufgerufen wird, denn wenn der Benutzer das Plugin manuell aktualisiert, kann der Aktivierungshaken übersprungen werden.

WordPress bietet daher keine Standardmethode zur automatischen Aufruf von Funktionen nach Plug-in-Updates. Deshalb müssen Sie Ihren eigenen Prozess erstellen.

wie man mit dem Aktualisierungsprozess umgeht

In diesem Teil dieses Tutorials werde ich Ihnen zeigen, wie Sie eine bestimmte Funktion automatisch aufrufen, nachdem das Plugin aktualisiert wurde. Wir werden im n?chsten Abschnitt sehen, wie die Aktualisierung vorhandener Optionen und die Erstellung neuer Optionen (in derselben Funktion) ordnungsgem?? behandelt werden.

Prinzip dieser Methode

Das globale Prinzip unserer Methode ist, dass wir die Versionsnummer des Plugins an zwei Stellen speichern: Konstanten in der Plugin -Hauptdatei und Optionen in der Datenbank.

Die Zahlen in der Datenbank speichern die derzeit installierte Version des Benutzers, w?hrend die Zahlen in der Konstante die aktuelle Version sind. Wenn diese beiden Zahlen unterschiedlich sind, wurden die Datenbankoptionen seit dem letzten Plugin -Update nicht aktualisiert, sodass wir dies tun müssen.

In diesem Fall werden wir eine Funktion aufrufen, die alle erforderlichen Optionen aktualisiert. Diese Funktion aktualisiert auch die in der Datenbank gespeicherte Versionsnummer: damit wir diese Funktion nicht übertreffen.

konstant

Jetzt, wo wir das, was wir tun werden, abgedeckt haben, ist es Zeit, Code zu schreiben! Fügen Sie zun?chst eine konstante Definition in die Plugin -Hauptdatei hinzu und nehmen Sie Ihre aktuelle Versionsnummer als Wert. Um Probleme zu vermeiden, testen wir, ob es noch nicht existiert hat.

function my_awesome_plugin_activation() {
    update_option('my_awesome_plugin_option', 'default value');
}
register_activation_hook(__FILE__, 'my_awesome_plugin_activation');

Normalerweise verwendet die Plugin -Version eine digitale Identit?t. Sie k?nnen sie jedoch gerne verwenden, wenn Sie ein anderes System verwenden. Die einzige Einschr?nkung hier ist, eine eindeutige Kennung für jede Version oder zumindest für jede Version bereitzustellen, die die Datenbank ?ndern muss (neue Optionen, neue Standardeinstellungen usw.).

überprüfen Sie die Funktion

Wir müssen jetzt eine Funktion schreiben, um zu überprüfen, ob die Datenbank aktualisiert werden muss. Diese Funktion vergleicht die zuvor definierten Konstanten mit den derzeit in der Datenbank gespeicherten Werten. Dazu werden wir sicherstellen, dass unsere Funktion überall mit der plugins_loaded -Kaktion aufgerufen wird, die ausgel?st wird, sobald alle Plugins geladen sind.

if (!defined('MY_AWESOME_PLUGIN_VERSION'))
    define('MY_AWESOME_PLUGIN_VERSION', '3.4.1');

Diese Funktion ist einfach. Wir rufen die in der Datenbank gespeicherte Versionsnummer genau wie jede andere Option ab und vergleichen sie mit der Konstante. Wenn diese Werte unterschiedlich sind, werden wir die Funktion my_awesome_plugin_activation() aufrufen.

function my_awesome_plugin_check_version() {
}

add_action('plugins_loaded', 'my_awesome_plugin_check_version');

Jetzt müssen wir einige Probleme kl?ren. Was ist dann, wenn die Option in der Datenbank noch nicht vorhanden ist? Wenn die Option nicht vorhanden ist, gibt get_option() false zurück, was sich von Ihrer Versionsnummer unterscheidet, sodass die Funktion aufgerufen wird.

Warum nennen wir die Aktivierungsfunktion? Um klar zu sein, k?nnen wir eine neue Funktion erstellen, die speziell für den Aktualisierungsprozess verwendet wird. Wenn Sie dies tun, werden Sie jedoch feststellen, dass diese neue Funktion der Aktivierung sehr ?hnlich sein wird, da Aktualisierungsoptionen mit den Optionen übereinstimmen k?nnen.

Aktualisieren Sie die Versionsnummer in der Datenbank

Sie k?nnen in der oben genannten Aktivierungsfunktion alles tun, was Sie wollen. Eine Sache ist jedoch erforderlich, und das hei?t, die in der Datenbank gespeicherte Versionsnummer zu aktualisieren. Auf diese Weise nennen wir unsere Funktionen nicht jedes Mal, wenn die Seite geladen wird.

function my_awesome_plugin_activation() {
    update_option('my_awesome_plugin_option', 'default value');
}
register_activation_hook(__FILE__, 'my_awesome_plugin_activation');

Bitte beachten Sie den Trick: Wir verwenden nicht add_option(), verwenden Sie nur update_option(). Wenn die Option noch nicht vorhanden ist, erstellt dies update_option(). Wenn es existiert, aktualisiert es seinen Wert auf den angegebenen Wert. Aus diesem Grund k?nnen wir unsere Aktivierungsfunktion als Aktualisierungsfunktion ohne Probleme verwenden.

Aktualisieren Sie Optionen

überschreiben Sie die Auswahl des Benutzers nicht!

Die Aktualisierung einer Option ist genauso wie aktualisiert die Versionsnummer: Sie k?nnen update_option() aufrufen, und sie ist erledigt, auch wenn dies das erste Mal ist, dass WordPress die Option gesehen hat.

Wir m?chten jedoch nicht immer die Optionwerte aktualisieren. Wenn Sie Optionen verwenden, müssen Ihre Benutzer in der Regel die Einstellungen personalisieren. Durch die Verwendung von update_option() überschreiben Sie jedes Mal, wenn Sie das Plugin aktualisieren, die Auswahl des Benutzers, was wir nicht tun m?chten.

oben sehen wir, dass get_option(), wenn die Option nicht vorhanden ist, falsch zurückgibt. Wir werden dieses Verhalten testen, wenn die Option, die wir aktualisieren m?chten, in der Datenbank vorhanden sind. Wenn dies der Fall ist, tun wir nichts. Andernfalls erstellen wir diese Option.

if (!defined('MY_AWESOME_PLUGIN_VERSION'))
    define('MY_AWESOME_PLUGIN_VERSION', '3.4.1');

Bitte beachten Sie, dass dieser Test für Optionen erforderlich ist, die wir nicht au?er Kraft setzen m?chten. In einigen F?llen m?chten wir dies vielleicht tun, wenn man die Versionsnummer berücksichtigt, m?chten wir den alten Wert auf jeden Fall nicht behalten!

Spezialfall - Array

Sie sollten wissen, dass WordPress Arrays erm?glicht, die Werte unserer Optionen zu speichern, und das Erstellen ist nicht schwieriger als das Erstellen anderer Optionen. Zum Beispiel:

function my_awesome_plugin_check_version() {
}

add_action('plugins_loaded', 'my_awesome_plugin_check_version');

Wenn Sie mehrere Einstellungen ben?tigen, ist die Verwendung von Arrays eine gute Idee. Auf diese Weise verwenden Sie nicht viele Eintr?ge in der Datenbank und beschr?nken die Chancen eines anderen Plugins mithilfe von Optionen mit demselben Namen. Dies kann jedoch zu Problemen führen, wenn wir den Aktualisierungsprozess berücksichtigen.

Um die Gründe zu verstehen, nehmen wir an, Sie haben ein Array als Option mit einigen Schlüssel. Ihre Benutzer werden diese Werte sicherlich personalisieren. Mit den oben durchgeführten Tests k?nnen wir nur dann die Option erstellen, wenn sie nicht vorhanden ist und diese Entscheidungen nicht überschrieben werden. Das sieht einfach aus, aber was ist, wenn Sie in einem Array einen neuen Schlüssel erstellen m?chten?

Wenn die Option in der Datenbank vorhanden ist, wird der vorherige Code nicht erstellt, sodass Ihr neuer Schlüssel nicht vorhanden ist. Wenn wir die Bedingung jedoch l?schen, wird das Array bei jedem neuen Update seinen Standardwert abrufen. Nicht ideal. Glücklicherweise gibt es eine L?sung!

Erstens definieren wir ein Array, das die Standardwerte der Optionen enth?lt (falls ein neuer Schlüssel existiert).

if (MY_AWESOME_PLUGIN_VERSION !== get_option('my_awesome_plugin_version'))
    my_awesome_plugin_activation();

Dann holen wir das derzeit in der Datenbank gespeicherte Array ab.

function my_awesome_plugin_activation() {
    update_option('my_awesome_plugin_option', 'default value');
}
register_activation_hook(__FILE__, 'my_awesome_plugin_activation');

Jetzt k?nnen wir die PHP -Funktion array_merge() verwenden, um unser Standardarray als erster Parameter und das Array des Benutzers als zweiten Parameter zu nutzen. Auf diese Weise erhalten wir ein Array, das alle im $default -Array definierten Schlüssel enth?lt, und wir werden keine Optionen haben, die nicht existieren. Wenn der Benutzer eine der alten Optionen ?ndert, wird sein Wert beibehalten. Mit array_merge() führen wir immer die neuesten Definitionen.

if (!defined('MY_AWESOME_PLUGIN_VERSION'))
    define('MY_AWESOME_PLUGIN_VERSION', '3.4.1');

Schlie?lich verwenden wir update_option(), um die Ergebnisse in der Datenbank zu speichern.

function my_awesome_plugin_check_version() {
}

add_action('plugins_loaded', 'my_awesome_plugin_check_version');

Wir sind fast vorbei, aber wenn die Funktion zum ersten Mal ausgeführt wird, müssen wir jetzt einen Fehler beheben, auf den Sie m?glicherweise begegnen.

Diese Funktion wird aufgerufen, wenn das Plugin aktiviert ist, was wir wollen. In diesem Fall existiert jedoch noch nicht die Option, so dass get_option() false zurückgibt. Das Problem ist, dass die Verwendung von False als Parameter von array_merge() einen Fehler verursacht.

Was wir wollen, ist einfach, wenn die Option nicht vorhanden ist, m?chten wir, dass $option ein leeres Array sein. Dazu k?nnen wir den zweiten Parameter von get_option() verwenden, der den zu erhaltenen Standardwert anzeigt (um nicht false zurückzugeben).

if (MY_AWESOME_PLUGIN_VERSION !== get_option('my_awesome_plugin_version'))
    my_awesome_plugin_activation();

Schlussfolgerung

Sobald Sie es sorgf?ltig gelesen haben, ist der Prozess der Behandlung der Aktualisierung von WordPress -Plugins nicht kompliziert. Dies ist jedoch wichtig, wenn Sie Optionen verwenden, da es m?glicherweise einige Probleme ohne Initialisierungsoptionen gibt.

Derzeit bietet WordPress keine native M?glichkeit, Plug-in-Updates zu verarbeiten. In der Tat sollten wir angesichts der oben aufgeführten Probleme, die wir an einem Tag feststellen, dass diese Art von Funktionalit?t eingeführt wird, auf ?hnliche Weise wie dieses Tutorial implementieren.

Sie k?nnen den Code für mein Beispiel -Plugin hier erhalten. Stellen Sie sich diesen Code als Framework zur Implementierung Ihres eigenen WordPress -Plugin -Update -Prozesses vor. Wenn Sie Feedback haben, teilen Sie mir bitte in den Kommentaren unten mit.

WordPress Plugin Update FAQ (FAQ)

Welche Bedeutung hat die regelm??ige Aktualisierung von WordPress -Plugins?

regul?re Aktualisierungen von WordPress -Plugins sind aus folgenden Gründen von entscheidender Bedeutung: Erstens enthalten Updates h?ufig neue Funktionen und Funktionen, die die Leistung der Website verbessern k?nnen. Zweitens beheben Updates in der Regel Fehler und Schwachstellen, die die Sicherheit der Website gef?hrden k?nnen. Schlie?lich gew?hrleisten Updates die Kompatibilit?t mit der neuesten Version von WordPress, sodass Ihre Website reibungslos und effizient ausgeführt wird.

Wie k?nnen Sie sichere Aktualisierungen meines WordPress -Plugins sicherstellen?

Um Sicherheitsaktualisierungen sicherzustellen, stellen Sie Ihre Website sicher, bevor Sie den Aktualisierungsprozess starten. Auf diese Weise k?nnen Sie bei Problemen w?hrend des Update -Prozesses Ihre Website problemlos in ihren vorherigen Status wiederherstellen. Darüber hinaus wird empfohlen, Updates auf der Staging -Site zu testen, bevor sie auf Ihre Live -Website angewendet werden.

Was soll ich tun, wenn das Plugin -Update fehlschl?gt?

Wenn das Plugin -Update fehlschl?gt, besteht der erste Schritt darin, Ihre Website aus der Sicherung wiederherzustellen. Versuchen Sie dann, die Ursache des Versagens zu bestimmen. Dies kann auf einen Konflikt mit einem anderen Plugin oder Thema oder einem Kompatibilit?tsproblem mit Ihrer Version von WordPress zurückzuführen sein. Sobald Sie das Problem identifiziert haben, k?nnen Sie es selbst beheben oder den Plugin -Entwickler für Hilfe kontaktieren.

Wie kann ich automatisch den Prozess der Aktualisierung von WordPress -Plugins durchführen?

WordPress verfügt über integrierte Funktionen, mit denen Sie Plugins automatisch aktualisieren k?nnen. Sie k?nnen diese Funktion aktivieren, indem Sie den Abschnitt "Plug-in" im WordPress-Dashboard erhalten, das Plug-In ausw?hlen, das Sie automatisch aktualisieren m?chten, und auf automatische Aktualisierungen aktivieren.

Wenn das Plugin -Update Probleme mit meiner Website verursacht, kann ich das Plugin -Update zurückrollen?

Ja, wenn das Plugin -Update Probleme mit Ihrer Website verursacht, k?nnen Sie das Plugin -Update zurückrollen. Es gibt mehrere verfügbare Plugins, z. B. WP Rollback, mit denen Sie die vorherigen Versionen des Plugins problemlos wiederherstellen k?nnen.

Wie aktualisiere ich erweiterte WordPress-Plug-Ins?

Das erweiterte WordPress-Plug-In wird ?hnlich wie das kostenlose Plug-In aktualisiert. Sie ben?tigen jedoch einen gültigen Lizenzschlüssel, um auf das Update zuzugreifen. Nach der Eingabe der Lizenzschlüssel k?nnen Sie das Plug-In aus dem WordPress-Dashboard aktualisieren.

Was ist der beste Weg, um Updates auf mehreren WordPress -Websites zu verwalten?

Wenn Sie mehrere WordPress -Sites verwalten, müssen Sie m?glicherweise viel Zeit damit verbringen, Plugins für jede Website einzeln zu aktualisieren. Ein effizienterer Weg ist die Verwendung von WordPress -Management -Tools wie ManagingWP oder MainWP, mit der Sie Updates für alle Ihre Websites aus einem einzigen Dashboard verwalten k?nnen.

Wie deaktivieren Sie automatische Updates für bestimmte WordPress -Plugins?

Wenn Sie automatische Updates für bestimmte Plugins deaktivieren m?chten, k?nnen Sie Plugins wie Easy Updates Manager verwenden. Mit diesem Plugin k?nnen Sie die automatischen Updates jedes Plugins auf Ihrer Website steuern.

Wie überprüfen Sie die Kompatibilit?t von Plugin -Updates mit meiner Version von WordPress?

Bevor Sie das Plugin aktualisieren, k?nnen Sie die Kompatibilit?t mit Ihrer WordPress -Version überprüfen, indem Sie die Plugin -Seite im WordPress -Plugin -Verzeichnis besuchen. Hier finden Sie Informationen über die Kompatibilit?t des Plug-Ins mit verschiedenen Versionen von WordPress.

Was soll ich tun, wenn das Plugin -Update meine Website bricht?

Wenn das Plugin -Update Ihre Website durchbricht, besteht der erste Schritt darin, Ihre Website aus dem Sicherungsbackern wiederherzustellen. Deaktivieren Sie dann das Plugin, das das Problem verursacht hat. Wenn Sie nicht auf Ihr WordPress-Dashboard zugreifen k?nnen, k?nnen Sie das Plug-In über FTP deaktivieren, indem Sie den Plug-In-Ordner im Verzeichnis WP-Content/Plugins umbenennen. Nachdem Sie das Plugin deaktiviert haben, k?nnen Sie den Plugin -Entwickler beheben oder kontaktieren, um Hilfe zu erhalten.

Das obige ist der detaillierte Inhalt vonWordPress -Plugin aktualisiert den richtigen Weg. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!