Filter, Actions, Hooks -
Was zum Geier ist das?
Frank Staude <frank@staude.net>
Hallo!
Frank Staude

!
Email: frank@staude.net

Twitter: @staude

!
WordPress / BuddyPress Entwickler
bei der Rheinschmiede

!
Moderator im deutschen
WordPress.org Supportforum

!
WP Meetup Hannover

!
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 der

bestehender Programmcode durch dritte erweitert werden kann.

!
Über einen Hook (deutsch Haken) kann man sich in Wordpress an

definierten 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 Database

adambrown.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)
Beispiel 1: wp_head()
Beispiel 1: wp_head()
Beispiel 1: wp_head()
Beispiel 1_ wp_head
Beispiel 1: wp_head
Beispiel 2: the_title
Beispiel 2: the_title
Beispiel 2: the_title
Beispiel 2: the_title
Beispiel 2: the_title
Beispiel 2: the_title
Beispiel 2: the_title
Beispiel 2: the_title
Beispiel 2: the_title
Beispiel 2: the_title
Beispiel 3: restrict_manage_posts
Beispiel 3: restrict_manage_posts
Beispiel 3: restrict_manage_posts
Beispiel 4: manage_post_posts_columns
Beispiel 4: manage_post_posts_columns
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/
Danke für eure Aufmerksamkeit
Jetzt kommen eure Fragen!

Filter, Actions, Hooks - Was zum Geier ist das?

  • 1.
    Filter, Actions, Hooks- Was zum Geier ist das? Frank Staude <frank@staude.net>
  • 2.
    Hallo! Frank Staude ! Email: frank@staude.net Twitter:@staude ! WordPress / BuddyPress Entwickler bei der Rheinschmiede ! Moderator im deutschen WordPress.org Supportforum ! WP Meetup Hannover ! Plugins
  • 3.
    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“
  • 4.
    Hooks? Ein Hook bezeichnetin der Informatik eine Schnittstelle, mit der bestehender Programmcode durch dritte erweitert werden kann. ! Über einen Hook (deutsch Haken) kann man sich in Wordpress an definierten 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
  • 5.
    Actions? • Ein ActionHook 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()
  • 6.
    Actions? • do_action() ruftFunktionen 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()
  • 7.
    Actions! Aktionen werden aufgerufenan 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.
  • 8.
    Filter? • Ein FilterHook 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.
  • 9.
    Filter! • apply_filters() ruftFunktionen auf, die sich auf den jeweiligen Hook registriert haben. ! • Registrierung via add_filter() ! • Beispiel: index template, the_title()
  • 10.
    Filter! Filter nehmen Inhaltentgegen, 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.
  • 11.
    Wie finde ichHooks? Code von Core/Plugins nach do_action(), do_actions_ref_array(), apply_filters() und apply_filters_ref_array() durchsuchen.
  • 12.
    Wie finde ichHooks? Codex Filter Referenz: codex.wordpress.org/Plugin_API/Filter_Reference
  • 13.
    Wie finde ichHooks? Codex Action Referenz: codex.wordpress.org/Plugin_API/Action_Reference
  • 14.
    Wie finde ichHooks? Adam Browns WP Hook Database adambrown.info/p/wp_hooks
  • 15.
    Beispiele • wp_head (Action) ! •the_title (Filter) ! • restrict_manage_posts (Filter) ! • manage_${post_type}_posts_columns (Filter)
 manage_$post_type_posts_custom_column (Action)
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
    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
  • 37.
    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/
  • 38.
    Danke für eureAufmerksamkeit Jetzt kommen eure Fragen!