Filter, Actions, Hooks - Was zum Geier ist das? Frank Staude <[email protected]>
Hallo!Frank Staude
Email: [email protected]: @staudeWebseite: www.staude.netGitHub: staude
AdminPress - WordPress Administration
Moderator im deutschen WordPress.org Supportforum
Validator für die deutsche BuddyPress Übersetzung
de.wordpress.org
WPMeetups
WP Meetup Hannover
WP Meetup Franken (Nürnberg)
Plugins
Schon mal gehört?
• Dann Hook dich da rein!
• Das kannst du per Filter noch ändern.
• Da kann man „von außen“ noch was ändern / manipulieren
• Das kannst du per Plugin „steuern“
Hooks?
Ein Hook bezeichnet in der Informatik eine Schnittstelle, mit derbestehender Programmcode durch dritte erweitert werden kann.
Über einen Hook (deutsch Haken) kann man sich in Wordpress andefinierten Stellen “einhaken” und dort eigenen Programmcode ausführen.Es ist also möglich Wordpress zu manipulieren, ohne den eigentlichen Code zu verändern. Das bedeutet, das die Eingriffe die man vorgenommen hat, auch eine Aktualisierung des Wordpress Core überstehen.
Es gibt zwei Arten von Hooks in Wordpress• Actions• Filter
Actions?
• Ein Action Hook sagt: Ich habe etwas gemacht. Wenn du drauf reagieren musst, dann tu es.
• Hooks werden von den Funktionen aufgerufen
• do_action()
• do_actions_ref_array()
Actions?
• do_action() ruft Funktionen auf, die sich auf die jeweilige Aktion registriert haben.
• Von do_action() aufgerufene Funktionen beeinflussen sich nicht gegenseitig.
• Registrierung via add_action()
• Beispiel: header template, wp_head()
Actions!
Aktionen werden aufgerufen an der Stelle, wo sich im Code ein do_action() Aufruf befindet. Die aufgerufenen Aktionen können sich nicht gegenseitig beeinflussen und geben auch nichts an die aufrufende Stelle zurück.
Filter?
• Ein Filter Hook sagt: Hier ist Inhalt, mach damit etwas, bevor ich ihn weiter verwende.
• Filter werden von der Funktion aufgerufen• apply_filters()• apply_filters_ref_array()
• Filter bilden „Ketten“, die Rückgabe der ersten Funktion ist die Eingabe der zweiten Funktion usw.
Filter!
• apply_filters() ruft Funktionen auf, die sich auf den jeweiligen Hook registriert haben.
• Registrierung via add_filter()
• Beispiel: index template, the_title()
Filter!
Filter nehmen Inhalt entgegen, verändern ihn und geben ihn zurück. Alle auf einen Hook registrierten Filter werden nacheinander als Kette aufgerufen. Der Rückgabewert des ersten Filters ist der Input des zweiten Filters usw bis alle Filter für den Hook durchlaufen sind. Mit dem Rückgabewert des letzten Filters läuft dann der aufrufende Programmcode weiter.
Wie finde ich Hooks?
Code von Core/Plugins nach do_action(), do_actions_ref_array(), apply_filters() und
apply_filters_ref_array() durchsuchen.
Wie finde ich Hooks?
Codex Filter Referenz: codex.wordpress.org/Plugin_API/Filter_Reference
Wie finde ich Hooks?
Codex Action Referenz: codex.wordpress.org/Plugin_API/Action_Reference
Wie finde ich Hooks?
Adam Browns WP Hook Databaseadambrown.info/p/wp_hooks
Beispiele• wp_head (Action)
• the_title (Filter)
• restrict_manage_posts (Filter)
• manage_${post_type}_posts_columns (Filter)manage_$post_type_posts_custom_column (Action)
Links• de.forums.wordpress.org/ • wpmeetup-hannover.de • profiles.wordpress.org/fstaude • de.wikipedia.org/wiki/Hook_(Informatik) • codex.wordpress.org/Plugin_API#Actions • codex.wordpress.org/Plugin_API#Filters • codex.wordpress.org/Function_Reference/do_action • codex.wordpress.org/Function_Reference/do_action_ref_array • codex.wordpress.org/Function_Reference/add_action • codex.wordpress.org/Plugin_API/Action_Reference/wp_head • codex.wordpress.org/Function_Reference/apply_filters • codex.wordpress.org/Function_Reference/apply_filters_ref_array • codex.wordpress.org/Plugin_API/Filter_Reference/the_title • codex.wordpress.org/Plugin_API/Filter_Reference • codex.wordpress.org/Plugin_API/Action_Reference • adambrown.info/p/wp_hooks • codex.wordpress.org/Plugin_API/Filter_Reference/manage_$post_type_posts_columns • codex.wordpress.org/Plugin_API/Action_Reference/manage_$post_type_posts_custom_column
Credits
• Seite 1, Logo und Bild: WordCamp Hamburg
• Seite 3, Foto Paris Tuileries Garden Facepalm statue CC BY 2.0. Alex E. Proimos - http://www.flickr.com/photos/proimos/4199675334/