{"id":35217,"date":"2020-06-10T23:28:33","date_gmt":"2020-06-11T06:28:33","guid":{"rendered":"https:\/\/kinsta.com\/?p=72202"},"modified":"2023-07-27T11:42:12","modified_gmt":"2023-07-27T10:42:12","slug":"wordpress-hooks","status":"publish","type":"post","link":"https:\/\/kinsta.com\/de\/blog\/wordpress-hooks\/","title":{"rendered":"Das WordPress Hooks Bootcamp: Wie man Aktionen, Filter und benutzerdefinierte Hooks verwendet"},"content":{"rendered":"

WordPress Hooks sind eines der wichtigsten Werkzeuge, die man im Arsenal eines WordPress Entwicklers<\/a> haben sollte. Sie sind die Grundlage f\u00fcr die Entwicklung von WordPress Plugins und Themes. Du kannst die vielen eingebauten Hooks von WordPress benutzen, um dich mit deinem eigenen Code in den WordPress Core ‚einzuklinken‘ und etwas zu tun<\/strong> oder zu ver\u00e4ndern<\/strong>.<\/p>\n

Es gibt zwei Arten von WordPress-Hooks: Aktionen<\/strong> und Filter<\/strong>. Hooks sind so weit verbreitet, dass sogar der WordPress Core selbst sie ausgiebig nutzt. WordPress beinhaltet auch eine M\u00f6glichkeit f\u00fcr dich, deine eigenen Hooks zu definieren<\/strong>, so dass sich andere Entwickler in deinen Code einklinken k\u00f6nnen.<\/p>\n

Zu lernen, wie Aktionen, Filter und benutzerdefinierte Hooks funktionieren, ist essentiell, um die Entwicklung von WordPress zu beherrschen.<\/p>\n

Die erste H\u00e4lfte dieses Artikels behandelt die Grundlagen der WordPress-Hooks und erkl\u00e4rt anhand mehrerer Beispiele, wie sie funktionieren. In der zweiten H\u00e4lfte lernst du, wie du Hooks benutzen kannst, um WordPress anzupassen, deine eigenen Hooks zu erstellen und sie zu benutzen, um deine eigenen erweiterbaren Plugins zu erstellen.<\/p>\n

Klingt aufregend? Lass uns loslegen!<\/p>\n

<\/div><\/kinsta-auto-toc>\n

Was sind WordPress Hooks?<\/h2>\n

Eine WordPress-Seite<\/a> wird durch Tonnen von Funktionen und Datenbankabfragen zusammengestellt. Der WordPress-Kern, Plugins und das Theme arbeiten zusammen, um die Seitenelemente wie Text, Bilder<\/a>, Skripte und Stile auszugeben. Sobald sie vollst\u00e4ndig zusammengesetzt sind, setzt der Browser sie alle zusammen und rendert die Seite.<\/p>\n

WordPress Hooks erlauben es dir, dich an bestimmten Punkten in diesen Erstellungsprozess ‚einzuklinken‘ und deinen eigenen Code auszuf\u00fchren. Die Hauptfunktion von Hooks ist es, dir zu erlauben, WordPress zu ver\u00e4ndern oder Funktionen hinzuzuf\u00fcgen, ohne die Kerndateien<\/a> zu ber\u00fchren.<\/p>\n

\"Hooks
Hooks werden dir helfen WordPress mit deinem eigenen Code zu erweitern<\/figcaption><\/figure>\n

Die WordPress Plugin API<\/a> steuert die Funktionalit\u00e4t von WordPress Hooks. Du verwendest Hooks, indem du bestimmte WordPress-Funktionen, Hook-Funktionen<\/strong> genannt, an bestimmten Stellen w\u00e4hrend der WordPress-Laufzeit aufrufst.<\/p>\n

Mit Hilfe von Hook-Funktionen kannst du deinen eigenen Code innerhalb einer Callback-Funktion<\/strong> b\u00fcndeln und ihn mit jedem beliebigen Hook registrieren lassen. Einmal registriert, l\u00e4uft dieser Callback \u00fcberall dort, wo sich der Hook befindet, und erlaubt es dir, die Standard WordPress Funktionen zu erweitern oder zu ersetzen.<\/p>\n

Die Position des Hook im Code-Ausf\u00fchrungsprozess ist ein wichtiger Faktor. Mehr \u00fcber seine Bedeutung erf\u00e4hrst du in den kommenden Abschnitten.<\/p>\n\n

Zwei Arten von WordPress Hooks: Aktionen und Filter<\/h3>\n

WordPress enth\u00e4lt zwei Arten von Hooks, die Aktionen<\/strong> und Filter<\/strong> genannt werden. Mit Aktionen kannst du an bestimmten vordefinierten Punkten in der WordPress Laufzeit etwas tun<\/strong>, w\u00e4hrend du mit Filtern alle von WordPress verarbeiteten Daten ver\u00e4ndern<\/strong> und zur\u00fcckgeben<\/code><\/strong> kannst.<\/p>\n

Aktionen werden im Code von WordPress definiert als:<\/p>\n

do_action( 'action_name', [optional_arguments] );<\/code><\/pre>\n
Der action_name<\/code><\/strong> string ist der Name der Aktion. Du kannst die [optional_arguments<\/code>]<\/strong> Variable angeben, um zus\u00e4tzliche Argumente an die Callback-Funktion zu \u00fcbergeben. Wenn dieses Feld nicht angegeben wird, dann ist sein Standardwert leer.<\/p>\n
Beispiel:<\/strong> Die Aktion do_action( 'wp_head' )<\/code><\/strong> kann eingeh\u00e4ngt werden, um jedes Mal, wenn WordPress den Header der Webseite<\/a> verarbeitet, eigenen Code auszuf\u00fchren. Diese Aktion hat keine weiteren Argumente.<\/p>\n
Filter werden im Code von WordPress definiert als:<\/p>\n
apply_filters( 'filter_name', 'value_to_be_filtered', [optional_arguments] );<\/code><\/pre>\n
Der filter_name<\/code><\/strong> string ist der Name des Filters, die Variable value_to_be_filtered<\/strong><\/code> ist der Wert, der gefiltert und zur\u00fcckgegeben werden muss, und die Variable [optional_arguments]<\/strong><\/code> kann zus\u00e4tzliche Argumente \u00fcbergeben, genau wie bei Aktionen.<\/p>\n
Beispiel:<\/strong> Der apply_filters( 'admin_footer_text' , string $text )<\/code><\/strong> Filter kann eingehakt werden, um den in der Fu\u00dfzeile des Administrators angezeigten Text zu ver\u00e4ndern. Ab WordPress 5.4 zeigt sein Standardwert in der Fu\u00dfzeile des Adminbereichs den Satz Danke, dass du mit WordPress<\/a> erstellt hast<\/code><\/em>.<\/p>\n
Wie du dich in Aktionen und Filter einklinken kannst, erf\u00e4hrst du sp\u00e4ter an vielen Beispielen aus dem WordPress Core.<\/p>\n
Sobald du dich eingeklinkt hast, kannst du deinen Code anweisen, etwas auf deiner Webseite zu tun<\/strong> oder anzupassen<\/strong>. Zum Beispiel kannst du Hooks verwenden, um nach dem Ver\u00f6ffentlichen eines Beitrags eine automatische E-Mail<\/a> zu versenden, oder du kannst benutzerdefinierte Stylesheets<\/a> laden, um das Aussehen deiner Webseite zu ver\u00e4ndern.<\/p>\n
\"WordPress
WordPress Hooks helfen dir, mit deiner Webseite zu interagieren oder sie zu ver\u00e4ndern<\/figcaption><\/figure>\n
Der einfachste Weg, Hooks zu verstehen, ist, sich vorzustellen, dass deine Webseite mit WordPress<\/a> ein Haus baut.<\/p>\n
Haken sind so \u00e4hnlich wie ein Kran, mit dem man Baugegenst\u00e4nde hin und her bewegt. Die Gegenst\u00e4nde, die \u00fcbertragen werden, sind die Callback-Funktionen<\/strong>, die deinen eigenen Code<\/a> enthalten. Diese Gegenst\u00e4nde (oder Funktionen) k\u00f6nnen dir helfen, das Haus zu bauen oder zu ver\u00e4ndern.<\/p>\n
\"Beispiel
Beispiel f\u00fcr das Einhaken in die ‚wp_head‘-Aktion in WordPress<\/figcaption><\/figure>\n
Callback-Funktionen k\u00f6nnen regul\u00e4re PHP-Funktionen, standardm\u00e4\u00dfige WordPress-Funktionen oder von dir definierte benutzerdefinierte Funktionen sein.<\/p>\n
Wir k\u00f6nnen bestimmte Gegenst\u00e4nde nur auf bestimmten Tr\u00e4gern transportieren, die an bestimmten Haken befestigt sind. So k\u00f6nnen Aktionen nur mit Aktionsfunktionen<\/strong> eingeh\u00e4ngt werden. Ebenso k\u00f6nnen Filter nur mit Filterfunktionen<\/strong> eingeh\u00e4ngt werden.<\/p>\n
Es ist zwar m\u00fchsam, die Haken und Tr\u00e4ger an einem Kran zu wechseln, aber WordPress macht es super einfach, indem es \u00fcber 2.200 Arten von Standard-Hooks<\/a> enth\u00e4lt.<\/p>\n
\"WordPress
WordPress 5.1 hat \u00fcber 2200 native Hooks (Quelle: Adam Brown)<\/figcaption><\/figure>\n
Du kannst Hooks finden, die \u00fcber den WordPress Core verteilt sind und es dir erm\u00f6glichen, genau die Stelle anzutippen, an der du dich einklinken m\u00f6chtest, um deinen eigenen Code auszuf\u00fchren.<\/p>\n\n
Hooks vs Actionen vs Filter<\/h2>\n
Wie im WordPress Plugin Handbuch<\/a> beschrieben:<\/p>\n
„Hooks sind eine M\u00f6glichkeit f\u00fcr ein St\u00fcck Code, mit einem anderen St\u00fcck Code zu interagieren\/modifizieren… Es gibt zwei Arten von Hooks: Aktionen und Filter“.<\/p><\/blockquote>\n
Es gibt eine weit verbreitete Inkonsistenz mit der Art und Weise, wie die Begriffe Hook<\/strong>, Aktion<\/strong> und Filter<\/strong> verwendet werden. Ein paar Tutorials und Anleitungen vermischen sie mit den damit verbundenen Funktionen. Ein Hauptgrund f\u00fcr diese Verwirrung liegt in der komplexen Natur der Funktionsweise von Hooks.<\/p>\n
Selbst wenn du genau in den WordPress Core schaust, wirst du feststellen, dass es keinen gro\u00dfen Unterschied zwischen dem Hinzuf\u00fcgen von Aktionen und Filtern gibt. Hier ist der Quellcode f\u00fcr die add_action()-Funktion<\/a> aus der wp-includes\/plugin.php<\/code><\/strong>-Datei:<\/p>\n
function add_action( $tag, $function_to_add, $priority = 10, $accepted_args = 1 ) {\u00a0 \u00a0 \u00a0 \n    return add_filter( $tag, $function_to_add, $priority, $accepted_args );\n}<\/code><\/pre>\n
Die add_action()-Funktion ruft einfach die add_filter()-Funktion auf und gibt ihren Wert zur\u00fcck. Warum? Weil beide im Grunde genommen auf die gleiche Weise funktionieren, bis auf einen Unterschied.<\/p>\n
Die apply_filters<\/code>()<\/strong>-Funktion gibt einen Wert zur\u00fcck, der bestehende Datentypen ver\u00e4ndern kann, w\u00e4hrend die do_action()<\/code><\/strong>-Funktion nichts zur\u00fcckgibt (NULL-Wert in PHP<\/a>).<\/p>\n
Wenn du immer noch verwirrt bist, mach dir keine Sorgen! Wenn du die erste H\u00e4lfte dieses Artikels durchgelesen hast, wird alles klar sein. Wir werden uns an die offizielle WordPress-Codex-Terminologie halten, da sie klar, pr\u00e4zise und universell ist.<\/p>\n
Macht euch vorerst mit der unten gezeigten Hook-Routine vertraut.<\/p>\n
\"Die
Die Hook-Routine: Hooks, Hook-Funktionen und Callback-Funktionen<\/figcaption><\/figure>\n
Lasst uns die Unterschiede zwischen Aktionen und Hooks aufl\u00f6sen.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n
WordPress Hooks<\/strong><\/td>\n<\/tr>\n
Actionen<\/strong><\/td>\nFilter<\/strong><\/td>\n<\/tr>\n
Aktionen werden verwendet, um benutzerdefinierte Funktionen an einem bestimmten Punkt w\u00e4hrend der Ausf\u00fchrung von WordPress Core auszuf\u00fchren.<\/td>\nFilter werden verwendet, um Daten zu modifizieren oder anzupassen, die von anderen Funktionen verwendet werden.<\/td>\n<\/tr>\n
Actions are defined\/created by the function do_action( 'action_name' )<\/strong><\/code> im Code von WordPress definiert\/erstellt.<\/td>\nFilter werden durch die Funktion apply_filters( 'filter_name', 'value_to_be_filtered' )<\/strong><\/code> im Code von WordPress definiert\/erstellt.<\/td>\n<\/tr>\n
Aktionen werden auch Action-Hooks<\/strong> genannt.<\/td>\nFilter werden auch Filter-Hooks<\/strong> genannt.<\/td>\n<\/tr>\n
Aktionen k\u00f6nnen nur mit Aktionsfunktionen eingeh\u00e4ngt werden. Z.B. add_action()<\/strong><\/code>, remove_action()<\/strong><\/code>.<\/td>\nFilter k\u00f6nnen nur mit Filterfunktionen eingeh\u00e4ngt werden. Z.B add_filter()<\/strong><\/code>, remove_filter()<\/strong><\/code>.<\/td>\n<\/tr>\n
Action-Funktionen brauchen keine Argumente an ihre Callback-Funktionen zu \u00fcbergeben.<\/td>\nFilterfunktionen ben\u00f6tigen mindestens ein Argument f\u00fcr ihre Callback-Funktionen.<\/td>\n<\/tr>\n
Action-Funktionen brauchen keine Argumente an ihre Callback-Funktionen zu \u00fcbergeben.<\/td>\nFilterfunktionen ben\u00f6tigen mindestens ein Argument f\u00fcr ihre Callback-Funktionen.<\/td>\n<\/tr>\n
Aktionsfunktionen sollten nichts zur\u00fcckgeben<\/code><\/strong>. Sie k\u00f6nnen jedoch die Ausgabe echoen<\/strong><\/code> oder mit der Datenbank interagieren.<\/td>\nFilterfunktionen m\u00fcssen ihre \u00c4nderungen als Ausgabe zur\u00fcckgeben<\/code><\/strong>. Selbst wenn eine Filterfunktion nichts \u00e4ndert, muss sie immer noch die unver\u00e4nderte Eingabe zur\u00fcckgeben<\/code><\/strong>.<\/td>\n<\/tr>\n
Aktionen k\u00f6nnen fast alles ausf\u00fchren, solange der Code g\u00fcltig ist.<\/td>\nDie Filter sollten isoliert arbeiten, damit sie keine unbeabsichtigten Nebenwirkungen haben.<\/td>\n<\/tr>\n
Zusammenfassung:<\/strong> Eine Aktion unterbricht den regul\u00e4ren Code-Ausf\u00fchrungsprozess, um etwas mit den erhaltenen Infos zu machen, gibt aber nichts zur\u00fcck und beendet sich dann.<\/td>\nZusammenfassung<\/strong>: Ein Filter modifiziert die Informationen, die er erh\u00e4lt, gibt sie an die Calling Hook-Funktion zur\u00fcck, und andere Funktionen k\u00f6nnen den Wert, den er zur\u00fcckgibt, verwenden.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Manchmal kannst du entweder eine Aktion oder einen Filter verwenden, um dasselbe Ziel zu erreichen. Wenn du zum Beispiel den Text in einem Beitrag \u00e4ndern m\u00f6chtest, kannst du eine Callback-Funktion mit der Aktion publish_post<\/a> registrieren und den Inhalt des Beitrags \u00e4ndern, wenn er in der Datenbank<\/a> gespeichert wird.<\/p>\n
\/\/ define the callback function to change the text\nfunction change_text_callback() { \n    \/\/ add the code to change text here\n}\n\n\/\/ hook in to the 'publish_post' action with the add_action() function\nadd_action( 'publish_post', 'change_text_callback' );<\/code><\/pre>\n
Oder du kannst eine weitere Callback-Funktion mit dem Inhaltsfilter the_content<\/a> registrieren, um den Inhalt des Beitrags zu \u00e4ndern, bevor er im Browser angezeigt wird.<\/p>\n
\/\/ define the callback function to modify the text\nfunction change_text_another_callback( $content ) { \n    \/\/ add the code to change text here and then return it \n    return $filtered_content;\n}\n\n\/\/ hook in to 'the_content' filter with the add_filter() function\nadd_filter( 'the_content', 'change_text_another_callback');<\/code><\/pre>\n
Zwei verschiedene Ans\u00e4tze mit dem gleichen Ergebnis. Zu wissen, wann man den einen \u00fcber den anderen stellt, ist der Schl\u00fcssel zu einem guten WordPress-Entwickler<\/a>.<\/p>\n
Wie funktionieren WordPress Hooks?<\/h2>\n
Das Hausbeispiel war einfach genug, um die grundlegende Funktionsweise von Hooks zu verstehen, aber es erfasst nicht die Komplexit\u00e4t, wie sie funktionieren. Am wichtigsten sind die Konzepte der Hookstellung und der Spezifit\u00e4t.<\/p>\n
Ein besseres Beispiel w\u00e4re es, sich vorzustellen, eine WordPress-Webseite so zu bearbeiten, wie ein Auto zusammenzubauen. Im Gegensatz zur Herstellung eines Autos, die viel Zeit in Anspruch nimmt, erfolgt der Zusammenbau einer Webseite fast augenblicklich.<\/p>\n
\"Das
Das Zusammensetzen einer Webseite ist wie das Zusammenbauen eines Autos<\/figcaption><\/figure>\n
\u00c4hnlich wie ein Auto in einem modernen Flie\u00dfband St\u00fcck f\u00fcr St\u00fcck zusammengesetzt wird, wird eine WordPress-Webseite Element f\u00fcr Element durch den Server und den Client zusammengesetzt.<\/p>\n
Der WordPress-Kern ist wie der Motor des Autos, das Fahrgestell und andere wesentliche Bestandteile, die den „Kern“ der Webseite ausmachen.<\/p>\n
Man kann eine funktionelle Webseite nur mit dem WordPress Core haben, aber wo ist der Spa\u00df dabei? Du brauchst aufregende Funktionen f\u00fcr die Webseite. Hier kommen die WordPress Plugins<\/a> und Themes<\/a> ins Spiel, die beide ausgiebig Hooks verwenden.<\/p>\n
Im obigen Beispiel ist jede nummerierte Station wie ein Hook im WordPress Core. Es gibt zwei Arten von Stationen, wie Aktionen und Filter. Jede Station enth\u00e4lt einen bestimmten Typ von Slot, der nur bestimmte Werkzeuge akzeptiert, \u00e4hnlich wie Aktionsfunktionen und Filterfunktionen.<\/p>\n
Alle Stationen sind aus Gr\u00fcnden der Modularit\u00e4t und Effizienz in regelm\u00e4\u00dfigen Abst\u00e4nden platziert.<\/p>\n
Je nach den Anforderungen an einer bestimmten Position k\u00f6nnen wir das f\u00fcr die Aufgabe am besten geeignete Werkzeug an dieser bestimmten Station anbringen (oder einhaken). Diese Tools sind wie die Callback-Funktionen, mit denen man mit WordPress interagieren oder WordPress modifizieren kann.<\/p>\n
Einige Tools k\u00f6nnen die Funktionsweise erheblich ver\u00e4ndern, \u00e4hnlich wie R\u00fcckrufe, die auf Aktionen registriert sind. Andere Werkzeuge werden nur dazu benutzt, das Aussehen des Autos zu ver\u00e4ndern, wie Callbacks, die f\u00fcr Filter registriert sind.<\/p>\n
Die Verwendung der richtigen Werkzeuge an den richtigen Stationen ist entscheidend, um ein erstklassiges Auto zu bauen. Auf die gleiche Weise helfen uns Hooks dabei, WordPress an unsere individuellen Bed\u00fcrfnisse anzupassen.<\/p>\n
Wenn man diese Analogie erweitert, sind Plugins wie das Hinzuf\u00fcgen hilfreicher Autofunktionen wie Airbags, Unterhaltungskonsole, ferngesteuertes schl\u00fcsselloses System usw. (wie diese, um die Funktionalit\u00e4t von WooCommerce zu verbessern<\/a>). Themes sind analog zur Anpassung des visuellen Teils des Autos, wie das Gesamtdesign, Lackierung, Felgen, etc. (hier ist, wie ihr euer WordPress Theme anpasst<\/a>).<\/p>\n
Wo registriert man Hooks und ihre Funktionen?<\/h2>\n
Es gibt zwei empfohlene Wege, um Hooks in WordPress hinzuzuf\u00fcgen:<\/p>\n