Fünfzig Aktionen von WordPress - Eine Einführung

Der Grund, warum WordPress das beliebteste Content-Management-System der Welt ist, ist natürlich seine Flexibilität. Die sehr einfache Struktur von "Hooks" verleiht WordPress diese Fähigkeit. Ohne Filter-Hooks und Action-Hooks wäre WordPress nicht so sehr erweiterbar und wir könnten kein so großes Spektrum an WordPress-Plugins oder -Themen haben.

In dieser Serie werden wir Aktionen durchlaufen, eine der zwei Arten von WordPress-Hooks. Im Laufe der Serie behandeln wir fast alles, was es über Aktionen zu wissen gibt:

Im ersten Teil,Wie es sich auch für diesen Artikel handelt, erfahren Sie, was WordPress-Aktionen sind und wie Aktionen mit sieben Kernfunktionen verwendet werden können.
In den nächsten fünf Teilen werden wir eine Reihe von Beispielen zu WordPress-Aktionen sehen. In jedem Teil werden wir 10 Aktionen durchgehen, indem wir lernen, wozu sie gut sind, und ein Beispiel für jede Aktion machen.
Im Finale der Serie werden wir zusammenfassen, was wir gelernt haben und die 50 Aktionsbeispiele, die wir gemacht haben.

Es wird eine lange, unglaubliche Fahrt sein. Anschnallen!

Was ist eine WordPress-Aktion??

Im Codex werden Aktionen wie folgt definiert:

Aktionen werden durch bestimmte Ereignisse ausgelöst, die in WordPress stattfinden, beispielsweise das Veröffentlichen eines Beitrags, das Ändern von Themen oder das Anzeigen eines Verwaltungsbildschirms. Action ist eine benutzerdefinierte PHP-Funktion, die in Ihrem Plugin (oder Theme) und definiert ist süchtig, auf einige dieser Ereignisse reagieren.

Aktionen sind also im Wesentlichen Funktionen, die durch ein WordPress-Ereignis ausgelöst werden und vor oder nach dem Ereignis ausgeführt werden. Aktionen sind eine der zwei Arten von "Haken" in WordPress - die andere wird "Filter" genannt, die wir vor einiger Zeit behandelt haben - Werfen Sie einen Blick auf die "Fünfzig Filter von WordPress", wenn Sie mehr über WordPress-Filter erfahren möchten.

Verwenden von Aktionen in WordPress

Das Definieren der Aktionen ist das Einfachste, was wir in dieser Serie tun werden. Glücklicherweise ist es fast genauso einfach zu lernen, wie man Aktionen erstellt und verwendet. Mal sehen, wie wir Funktionen mit Aktionen verknüpfen, neue Aktionen erstellen, vorhandene entfernen und andere aktionsbezogene Funktionen im WordPress-Kern.

Eine Funktion mit einer Aktion verknüpfen

Die wahrscheinlich einfachste Funktion unter diesen ist die folgende: Diese Funktion wird verwendet, um unsere Funktion mit dem Aktions-Hook zu verknüpfen, den wir verwenden werden:

Mal sehen, was diese Parameter bedeuten:

$ hook_name ist der Name des Action-Hooks, den wir verwenden werden
$ Funktionsname ist der Name unserer Funktion
$ Priorität ist eine Ganzzahl, die wir festlegen, um festzulegen, wie früh die Funktion im Action-Hook ausgeführt wird
$ Argumente ist die Anzahl der Argumente, die unsere Funktion verwendet, und der Action-Hook erlaubt

Sehen wir uns ein kurzes Beispiel an:

Fast zu einfach, richtig?

Funktionen von einem Aktionshaken entfernen

Wir haben zwei Funktionen, um Funktionen aus Aktionshaken zu entfernen: remove_action () und remove_all_actions (). Mal sehen, wie wir sie verwenden:

Das remove_action () function hat drei Parameter: den Namen des Hooks, den Namen der Funktion, die wir entfernen möchten von der Haken und die Priorität, die bei der Verwendung festgelegt wurde add_action (). Das remove_all_actions () Funktion hat nicht die $ Funktionsname Parameter, da alle mit der Aktion verbundenen Funktionen entfernt werden.

Aktions-Hook erstellen

Wenn Sie WordPress-Plugins oder -Themen entwickeln, empfiehlt es sich, einige Haken in Ihrem Code zu erstellen, damit andere Entwickler dies tun können erweitern Ihr Plugin oder Thema. Dafür haben wir wieder zwei Funktionen: do_action () und do_action_ref_array (). Mal sehen, wie das erste funktioniert:

Wie Sie sehen, hat die Funktion praktisch unendlich viele Parameter, da Sie beliebig viele Argumente definieren können. Wenn Sie Ihre Argumente jedoch in einem Array behalten müssen, müssen Sie die zweite Funktion verwenden:

Abrufen der Anzahl, wie oft eine Aktion ausgelöst wird

Wenn Sie wissen möchten, wie oft eine Aktion aufgerufen wird, können Sie mit dieser praktischen Funktion Aktionsaufrufe zählen:

Wie Sie sehen, ist der einzige Parameter der Funktion der Name des Action-Hooks.

Prüfen, ob etwas von einer Aktion abhängig ist

Stellen Sie sich vor, Sie entwickeln eine Erweiterung für ein beliebtes WordPress-Plugin und müssen prüfen, ob der Benutzer das Plugin installiert hat oder nicht. (Ihr Plugin funktioniert nicht, wenn das andere nicht installiert und aktiviert ist.)

Um dies zu überprüfen, können Sie die has_action () Funktion, um sicherzustellen, dass die beliebte Plugin-Aktion verfügbar ist:

Genau wie das did_action () Funktion, die has_action () Funktion hat nur einen Parameter: den Namen des Action-Hooks.

Fazit

Nun haben wir so ziemlich alles über das Erstellen und Verwenden von Aktionen beschrieben. Wir können nun eine fünf Artikel lange Reise von Aktionsbeispielen fortsetzen. Wir werden es überprüfen nur fünfzig davon, aber wenn Sie neugierig sind, finden Sie im Kern noch Hunderte.

Ich hoffe, Sie werden diese Serie genauso genießen wie ich, als ich das Ganze erstellt habe. Wenn Sie der Meinung sind, dass Sie mir bei den Tutorials helfen können, indem Sie weitere Aktionen vorschlagen und nach weiteren Beispielen fragen, zögern Sie nicht, mir zu sagen, und teilen Sie Ihre Gedanken mit den folgenden Kommentaren. Und wenn Ihnen das, was Sie in dieser Serie lesen, gefallen hat, vergessen Sie nicht, die Artikel zu teilen!

Wir sehen uns im nächsten Tutorial!

Code