4.2.2. add_filter()

Um nun einen Wert aktiv zu filtern, benötigen Sie noch die zugehörige Funktion. Sie nennt sich add_filter(). Aber sehen wir uns zuerst an, welche Parameter möglich sind22:>

<?php
function add_filter( $tag, $function_to_add, $priority = 10, $accepted_args = 1 ) {
	...
}
?>

Die Parameter:

  • $tag
    Der Name der Action.
  • $function_to_add
    Die Bezeichnung der Funktion, die WordPress aufrufen soll. Dies kann ein String, ein Array oder aber auch eine anonyme Funktion sein.
  • $priority
    Ein ganzzahliger (Integer) Wert, der die Reihenfolge beschreibt, in der der Filter angewendet werden soll. Der Standardwert ist 10.
  • $accepted_args
    Ein ganzzahliger (Integer) Wert, der die Anzahl an Argumenten beschreibt, die übergeben werden. Der Standardwert ist 1. Es wird also nur ein Parameter standardmäßig übergeben.

Es ist unschwer zu erkennen, dass die Parameterliste genau dieselbe ist wie auch bei der add_action() Funktion. Schauen wir uns nämlich die vollständige add_action() Funktion an, erkennen wir, was intern abläuft:

<?php
function add_action( $tag, $function_to_add, $priority = 10, $accepted_args = 1 ) {
	return add_filter( $tag, $function_to_add, $priority, $accepted_args );
}
?>

WordPress nutzt für alle Action-Hooks das Filter-System.

Beispiel mit einem Parameter

You’re not allowed to see this content. Please log in first.

❬ 4.2.1. apply_filters()4.2.3. apply_filters_ref_array() ❭