AJAX-Anfragen in WordPress sicher prüfen und verarbeiten

Wenn ein Klick auf einer WordPress-Website sofort etwas speichern soll, etwa einen Beitrag als Favorit, sendet die Seite eine Anfrage im Hintergrund an den Server. Dieser Beitrag zeigt am Beispiel einer Favoritenliste, wie WordPress solche AJAX-Anfragen mit Nonce, Berechtigung und geprüften Eingaben verarbeitet.

3 Min. von Erhard Sigrist
Eine Favoritenanfrage wird mit Nonce, Anmeldung und geprüfter Beitrags-ID an WordPress übermittelt und bestätigt.

Eine eingeloggte Kundin kann auf einer Website einen Beitrag zu ihren Favoriten hinzufügen, ohne die Seite neu zu laden. WordPress verarbeitet diese Aktion auf dem Server und verbindet dabei mehrere Prüfungen miteinander.

Nonce, Berechtigung und Eingabewerte erfüllen unterschiedliche Aufgaben. Zusammen stellen sie sicher, dass eine Anfrage aus der erwarteten Sitzung stammt, die angemeldete Person ihre eigene Favoritenliste bearbeitet und die übermittelte Beitrags-ID verwendet werden kann.

Endpunkt, Beitrags-ID und Nonce bereitstellen

Dieses Beispiel speichert den aktuellen Beitrag in der Favoritenliste der angemeldeten Person. Das Skript erhält die URL des WordPress-Endpunkts, die ID des aktuellen Beitrags und einen für diese Aktion erzeugten Nonce.

add_action( 'wp_enqueue_scripts', function() {
	if ( ! is_singular() ) {
		return;
	}

	$post_id = get_queried_object_id();

	wp_enqueue_script(
		'ud-favorites',
		get_theme_file_uri( 'assets/js/favorites.js' ),
		[],
		'1.0.0',
		true
	);

	wp_add_inline_script(
		'ud-favorites',
		'window.udFavorites = ' . wp_json_encode( [
			'url'    => admin_url( 'admin-ajax.php' ),
			'postId' => $post_id,
			'nonce'  => wp_create_nonce( 'ud_add_favorite_' . $post_id ),
		] ) . ';',
		'before'
	);
} );

Favorit per Anfrage speichern

Ein Button mit dem Attribut data-ud-add-favorite löst die Anfrage aus. fetch() übermittelt Aktion, Beitrags-ID und Nonce an WordPress.

document
	.querySelector( '[data-ud-add-favorite]' )
	?.addEventListener( 'click', async () => {
		const response = await fetch( window.udFavorites.url, {
			method: 'POST',
			headers: {
				'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8',
			},
			body: new URLSearchParams( {
				action: 'ud_add_favorite',
				post_id: window.udFavorites.postId,
				nonce: window.udFavorites.nonce,
			} ),
		} );

		const result = await response.json();
		if ( result.success ) {
			document.body.classList.add( 'has-favorite' );
		}
	} );

Die Oberfläche kann nach einer erfolgreichen Antwort unmittelbar reagieren und den gespeicherten Favoriten sichtbar machen.

Der Klick übermittelt die Anfragebestandteile an WordPress, wo Nonce, Anmeldung und Beitrags-ID geprüft werden.

Sitzung und Berechtigung getrennt prüfen

Der Nonce bindet die Anfrage an die erwartete WordPress-Sitzung. Die Berechtigung wird zusätzlich geprüft, bevor eine Person ihre persönliche Favoritenliste verändert.

add_action( 'wp_ajax_ud_add_favorite', function() {
	$post_id = isset( $_POST['post_id'] )
		? absint( wp_unslash( $_POST['post_id'] ) )
		: 0;

	check_ajax_referer( 'ud_add_favorite_' . $post_id, 'nonce' );

	if ( ! get_post( $post_id ) || ! is_user_logged_in() ) {
		wp_send_json_error( [ 'message' => 'Keine Berechtigung.' ], 403 );
	}

	$user_id   = get_current_user_id();
	$favorites = (array) get_user_meta( $user_id, '_ud_favorites', true );
	$favorites = array_unique( array_merge( $favorites, [ $post_id ] ) );

	update_user_meta( $user_id, '_ud_favorites', $favorites );
	wp_send_json_success();
} );

Eingaben und Antworten verarbeiten

Die Beitrags-ID wird vor der Verwendung in eine positive Ganzzahl überführt und anschliessend auf einen vorhandenen Beitrag geprüft. Weitere Werte werden je nach erwartetem Datentyp validiert und bereinigt.

wp_send_json_success() und wp_send_json_error() liefern dem Skript eine einheitliche Antwort. Das Frontend kann den weiteren Ablauf dadurch anhand eines klaren Ergebnisses steuern.

Ergebnis

Webseiten
mit Substanz.

Interaktive Aktionen sicher mit WordPress verbinden
Die Favoritenliste wird im Frontend unmittelbar aktualisiert, während WordPress die Anfrage auf dem Server verarbeitet. Nonce, Anmeldung und validierte Daten greifen dabei zusammen.

Favoriten direkt aktualisieren

Die Oberfläche reagiert nach der erfolgreichen Anfrage und macht den gespeicherten Beitrag sichtbar.

Anfragen serverseitig prüfen

Nonce, Anmeldung und Beitrags-ID bilden die Grundlage für die Verarbeitung der Aktion.

Antworten einheitlich verarbeiten

WordPress liefert dem Skript ein klares Ergebnis für die weitere Steuerung im Frontend.