Nicht „Was die Welt im Innersten zusammenhält“, sondern was uns WordPress möglichst weit öffnet, das sind die Hooks. Egal ob Theme oder Plugin, um etwas in WordPress zu ändern, zu erweitern, umzubauen und das ohne dass man direkt im WordPress Code ändert, dazu muss man verstehen was Hooks sind und wie diese Funktionieren. Egal ob man ein komplexes Plugin bauen möchte oder nur in seinem verwendeten Theme z.B. den Titel der Beiträge manipulieren möchte.

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

2. Hallo!
Frank Staude
Email: frank@staude.net
Twitter: @staude
Webseite: www.staude.net
GitHub: 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

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

5. 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()

6. 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()

7. 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.

8. 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.

9. Filter!
• apply_filters() ruft Funktionen auf, die sich auf den
jeweiligen Hook registriert haben.
• Registrierung via add_filter()
• Beispiel: index template, the_title()

10. 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.

11. Wie finde ich Hooks?
Code von Core/Plugins nach do_action(),
do_actions_ref_array(), apply_filters() und
apply_filters_ref_array() durchsuchen.

12. Wie finde ich Hooks?
Codex Filter Referenz:
codex.wordpress.org/Plugin_API/Filter_Reference

13. Wie finde ich Hooks?
Codex Action Referenz:
codex.wordpress.org/Plugin_API/Action_Reference

14. Wie finde ich Hooks?
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. Beispiel 1: wp_head()

17. Beispiel 1: wp_head()

18. Beispiel 1: wp_head()

19. Beispiel 1_ wp_head

20. Beispiel 1: wp_head

21. Beispiel 2: the_title

22. Beispiel 2: the_title

23. Beispiel 2: the_title

24. Beispiel 2: the_title

25. Beispiel 2: the_title

26. Beispiel 2: the_title

27. Beispiel 2: the_title

28. Beispiel 2: the_title

29. Beispiel 2: the_title

30. Beispiel 3: restrict_manage_posts

31. Beispiel 3: restrict_manage_posts

32. Beispiel 3: restrict_manage_posts

33. Beispiel 4: manage_post_posts_columns

34. Beispiel 4: manage_post_posts_columns

35. 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

36. 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/

37. Danke für eure Aufmerksamkeit
Jetzt kommen eure Fragen!