WordCamp Köln Filter, Actions, Hooks - was zum Geier ist das?

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)

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