Hooks sind definierte Stellen, an denen Erweiterungen mit WordPress zusammenarbeiten können. Sie helfen, Änderungen wartbar in eigenen Dateien zu halten.
Eine Action hängt einen Ablauf an WordPress an, ein Filter verändert einen bestehenden Wert. An einem Stylesheet und einem Seitentitel erkennst du, warum es beide Varianten braucht.
Action oder Filter?
Eine Action löst einen Ablauf aus, etwa beim Einreihen eines Stylesheets. Ein Filter nimmt einen bestehenden Wert entgegen und gibt ihn verändert oder unverändert zurück.
Beim Entwickeln prüfen
Lies in der Dokumentation nach, wann ein Hook läuft und welche Argumente er übergibt. Beschränke die Funktion auf den gewünschten Kontext, damit beispielsweise eine individuelle Darstellung im Frontend keine Administrationsseite verändert.
Was eine Action auslöst
Ein Theme möchte im Frontend ein Stylesheet laden. Es kann seine Funktion an den vorgesehenen Zeitpunkt hängen. Andere Erweiterungen dürfen ebenfalls an diesem Punkt arbeiten. Die Funktion soll nur das Stylesheet registrieren oder laden und muss WordPress keinen geänderten Seitentitel zurückgeben.
Was ein Filter erwartet
Bei einem Filter kommt ein vorhandener Wert an. Wenn du beispielsweise für eine bestimmte Ansicht den Titel anpasst, gibst du den neuen Titel zurück. Für alle anderen Ansichten reichst du den Originalwert weiter. Fehlt die Rückgabe, können nachfolgende Funktionen einen unerwarteten Wert erhalten.
Mit Priorität und Argumenten arbeiten
Mehrere Funktionen können denselben Hook nutzen. Die Priorität bestimmt ihre Reihenfolge. Prüfe, welche Argumente der Hook tatsächlich bereitstellt und wie viele deine Funktion annimmt. Eine Änderung mit höherer Priorität ist keine Garantie, dass andere Erweiterungen später nichts mehr ändern.
Den Änderungsbereich klein halten
Begrenze eigene Logik auf die vorgesehenen Ansichten. Ein Filter für die Startseite soll nicht plötzlich Titel im Dashboard oder in Feeds verändern. Teste mindestens einen erwarteten Zweck und eine bewusst ausgenommene Ansicht, damit du unbeabsichtigte Nebenwirkungen erkennst.
Einen Titel-Filter auf seinen Bereich prüfen
Wenn ein Filter einen Seitentitel ändert, prüfe bewusst auch einen Beitrag, eine Liste und den Administrationsbereich. Die Funktion soll den ursprünglichen Wert in nicht betroffenen Fällen zurückgeben. Berücksichtige bei der Prüfung auch, ob ein SEO-Plugin den Titel nach einem eigenen Filter erneut anpasst.
Häufige Fragen
Wann verwende ich eine Action?
Eine Action eignet sich, wenn du zu einem passenden Zeitpunkt etwas ausführen möchtest, etwa eine Datei registrieren. Prüfe, ob der vorgesehene Zeitpunkt bereits alle benötigten Informationen bietet. Eine zu früh ausgeführte Abfrage kann falsche Ergebnisse liefern. Eine zu spät ausgeführte Funktion kann eine gewünschte Ausgabe nicht mehr verändern.
Wann brauche ich einen Filter?
Ein Filter passt, wenn du einen vorhandenen Wert anpassen willst. Du erhältst den Wert und gibst für den betreffenden Fall eine Fassung zurück. Prüfe ausdrücklich, was bei allen übrigen Fällen passiert. Ein Filter für einzelne Beiträge sollte beispielsweise Titel anderer Seitentypen unverändert durchlassen.
Was bedeuten Priorität und Zahl der Argumente?
Die Priorität legt die Reihenfolge gegenüber anderen registrierten Funktionen fest. Die Zahl der angenommenen Argumente muss zur Funktion und zum Hook passen. Prüfe die Dokumentation des konkreten Hooks. Wenn du Zusatzdaten erwartest, kann eine falsche Registrierung dazu führen, dass sie in deiner Funktion nicht ankommen.
Warum wirkt ein Filter scheinbar gar nicht?
Prüfe zuerst, ob die Datei geladen wird und ob der Hook im gewünschten Ablauf stattfindet. Ein Plugin oder Theme kann einen eigenen Ausgabepfad verwenden. Verifiziere außerdem, ob eine spätere Funktion den Wert weiter verändert. Reproduziere den Fall in einer Testkopie, bevor du die Priorität pauschal erhöhst.
Wie prüfe ich eine Änderung ohne unerwartete Nebenwirkungen?
Lege einen erwarteten Treffer und mehrere bewusst ausgeschlossene Ansichten fest. Bei einer neuen Überschrift testest du beispielsweise die Zielseite, einen normalen Beitrag und den Administrationsbereich. Prüfe auch, ob die Funktion mit fehlenden Daten umgehen kann. Dann fällt ein zu großer Geltungsbereich ebenso auf wie eine fehlende Prüfung.
Warum sollte ein Filter seinen Eingabewert für fremde Ansichten zurückgeben?
Andere Teile von WordPress können den Wert ebenfalls verwenden. Eine globale Änderung wirkt daher schnell weiter als beabsichtigt. Gib für Fälle außerhalb deiner Zielansicht den ursprünglichen Wert zurück. Prüfe mit einem Standardbeitrag und einer eigenen Ansicht, ob die Unterscheidung tatsächlich funktioniert. Wenn mehrere Erweiterungen denselben Filter verwenden, vergleiche die Ausgabe in der realen Kombination, nachdem der Code in einer Testkopie funktioniert. Notiere die beteiligten Hooks mit ihrer Priorität.