4.1.4. remove_action()

Die Funktion remove_action() erlaubt es – wie der Name schon sagt – eine zuvor hinzugefügte Action wieder zu entfernen. Viele Programmierer nutzen diese Funktion, um Actions zu entfernen, die standardmäßig von WordPress hinzugefügt werden.

Vorsicht ist geboten, wenn remove_action() vor add_action() aufgerufen wird. Dann ist sie nämlich wirkungslos, da eventuell keine Action entfernt werden kann.

Gut ist, dass die Funktion einen booleschen Wert zurückliefert, der uns mitteilt, ob eine Funktion erfolgreich entfernt wurde.

Sehen wir uns an, wie WordPress die Funktion aufgebaut hat12:

<?php
function remove_action( $tag, $function_to_remove, $priority = 10 ) {
	...
}
?>

Die Parameter:

  • $tag (string)
    Der Name der Action.
  • $function_to_remove (string|array)
    Die Bezeichnung der Funktion, die WordPress entfernen soll. Dies kann ein String oder ein Array sein.
  • $priority (int)
    Ein Ganzzahl (Integer) -Wert, der die Reihenfolge beschreibt, mit der die Action hinzugefügt wurde. Der Standardwert ist 10.

Dieser Inhalt ist nur eingeschränkt verfügbar. Melden Sie sich vorher an.