20.01.2025

Aktionen in WordPress

In WordPress sind Aktionen Teil der Hooks-API, die es Entwicklern ermöglicht, benutzerdefinierten Code an bestimmten Punkten während der Ausführung von WordPress einzufügen. Mit Aktionen können Sie bei bestimmten Ereignissen oder Phasen Aufgaben oder Funktionen ausführen, z. B. wenn ein Beitrag veröffentlicht, eine Seite geladen oder ein Theme aktiviert wird.

Aktionen sind besonders nützlich, um die Funktionalität von WordPress zu erweitern, ohne die Kerndateien zu ändern, was Ihre Website wartungsfreundlicher und zukunftssicherer macht.

Wie WordPress-Aktionen funktionieren

Eine Aktion wird ausgelöst, wenn ein bestimmtes Ereignis in WordPress eintritt, z. B. das Laden eines Beitrags oder die Veröffentlichung eines Kommentars. Wenn eine Aktion ausgelöst wird, werden alle Funktionen, die mit dieser Aktion verknüpft sind, ausgeführt.

Zum Beispiel:

Wenn sich ein Benutzer anmeldet, löst WordPress die Aktion wp_login aus, mit der Sie benutzerdefinierten Code ausführen können, wenn sich ein Benutzer anmeldet.
Wenn ein Beitrag gespeichert wird, wird die save_post-Aktion ausgelöst, mit der Sie benutzerdefinierte Funktionen hinzufügen können, z. B. das Senden einer E-Mail, wenn ein Beitrag veröffentlicht wird.

Registrierung von Aktionen mit add_action()

Um eine Funktion an eine Aktion zu koppeln, verwenden Sie die Funktion add_action(). Mit dieser Funktion wird WordPress angewiesen, eine bestimmte Funktion auszuführen, wenn eine Aktion ausgelöst wird.

Syntax:

add_action( $hook, $function_to_add, $priority, $accepted_args );

$hook: Der Name des Aktions-Hooks (z.B. wp_login, save_post).
$function_to_add: Der Name der Funktion, die ausgeführt werden soll, wenn die Aktion ausgelöst wird.
$priorität (optional): Hier wird die Reihenfolge angegeben, in der die Funktionen ausgeführt werden sollen. Niedrigere Zahlen bedeuten höhere Priorität. Die Voreinstellung ist 10.
$accepted_args (optional): Die Anzahl der Argumente, die die Funktion akzeptiert. Voreinstellung ist 1.

Beispiel:

function my_custom_function() { // Benutzerdefinierter Code hier echo “User has logged in!”; } add_action( ‘wp_login’, ‘my_custom_function’ );

In diesem Beispiel wird die Funktion my_custom_function() ausgeführt, wenn sich ein Benutzer anmeldet, und es wird eine Meldung angezeigt.

Allgemeine WordPress-Aktionen

Hier sind einige häufig verwendete Aktionen in WordPress:

wp_enqueue_scripts: Wird verwendet, um Skripte und Stile auf dem Frontend einzureihen.
init: Wird ausgelöst, nachdem WordPress das Laden beendet hat, aber bevor irgendwelche Header gesendet werden. Wird oft verwendet, um benutzerdefinierte Beitragstypen oder Taxonomien zu registrieren.
wp_head: Wird im Head-Bereich des Themes ausgelöst, nützlich zum Hinzufügen von Meta-Tags, Styles oder Skripten.
save_post: Wird ausgelöst, wenn ein Beitrag gespeichert wird. Es kann verwendet werden, um zusätzliche Aktionen wie das Aktualisieren von Beitrags-Metadaten durchzuführen.
admin_init: Wird ausgelöst, wenn ein Benutzer auf das Admin-Dashboard zugreift. Dies ist nützlich, um benutzerdefinierte Einstellungen hinzuzufügen oder Funktionen für den Admin-Bereich zu initialisieren.

Benutzerdefinierte Aktionen erstellen

Sie können auch Ihre eigenen benutzerdefinierten Aktionen erstellen. Dadurch können andere Entwickler (oder Sie selbst) Funktionen an bestimmten Stellen in Ihrem benutzerdefinierten Theme oder Plugin einhängen.

Beispiel:

function my_custom_action() { // Etwas tun echo “Custom action triggered!”; } do_action( ‘my_custom_action’ );

In diesem Fall lösen Sie den my_custom_action-Haken an der Stelle aus, an der do_action( ‘my_custom_action’ ); platziert ist, und Sie können Funktionen wie folgt damit verbinden:

add_action( ‘my_custom_action’, ‘my_custom_function’ );

Verstehen von do_action() und do_action_ref_array()

do_action(): Diese Funktion stößt die Ausführung von Funktionen an, die mit einer bestimmten Aktion verbunden sind.

Beispiel:

do_action( ‘wp_footer’ );

do_action_ref_array(): Diese Funktion übergibt ein Array von Argumenten per Verweis an die angehängten Funktionen, was nützlich ist, wenn man mit Objekten oder Arrays arbeitet, die man direkt ändern möchte.

Beispiel:

$my_data = array( ‘Schlüssel’ => ‘Wert’ ); do_action_ref_array( ‘my_custom_action’, array( &$my_data ) );

Schlussfolgerung

WordPress-Aktionen bieten eine leistungsstarke Möglichkeit, die Funktionalität von WordPress zu erweitern, indem benutzerdefinierte Funktionen an bestimmte Ereignisse gekoppelt werden. Durch die Verwendung von Aktionen können Entwickler Themes, Plugins und Kernfunktionen anpassen, ohne den WordPress-Kern zu verändern, was einfache Updates und Wartungsfreundlichkeit gewährleistet. Das Verständnis für die Verwendung und Erstellung von Aktionen ist für jeden WordPress-Entwickler, der dynamischere und funktionsreichere Websites erstellen möchte, unerlässlich.