W3cubDocs

/WordPress

wp_privacy_process_personal_data_erasure_page( array $response, int $eraser_index, string $email_address, int $page, int $request_id )

Mark erasure requests as completed after processing is finished.

Description

This intercepts the Ajax responses to personal data eraser page requests, and monitors the status of a request. Once all of the processing has finished, the request is marked as completed.

Parameters

$response: (array) (Required) The response from the personal data eraser for the given page.
$eraser_index: (int) (Required) The index of the personal data eraser. Begins at 1.
$email_address: (string) (Required) The email address of the user whose personal data this is.
$page: (int) (Required) The page of personal data for this eraser. Begins at 1.
$request_id: (int) (Required) The request ID for this personal data erasure.

Return

(array) The filtered response.

Source

File: wp-admin/includes/privacy-tools.php

function wp_privacy_process_personal_data_erasure_page( $response, $eraser_index, $email_address, $page, $request_id ) {
	/*
	 * If the eraser response is malformed, don't attempt to consume it; let it
	 * pass through, so that the default Ajax processing will generate a warning
	 * to the user.
	 */
	if ( ! is_array( $response ) ) {
		return $response;
	}

	if ( ! array_key_exists( 'done', $response ) ) {
		return $response;
	}

	if ( ! array_key_exists( 'items_removed', $response ) ) {
		return $response;
	}

	if ( ! array_key_exists( 'items_retained', $response ) ) {
		return $response;
	}

	if ( ! array_key_exists( 'messages', $response ) ) {
		return $response;
	}

	// Get the request.
	$request = wp_get_user_request( $request_id );

	if ( ! $request || 'remove_personal_data' !== $request->action_name ) {
		wp_send_json_error( __( 'Invalid request ID when processing eraser data.' ) );
	}

	/** This filter is documented in wp-admin/includes/ajax-actions.php */
	$erasers        = apply_filters( 'wp_privacy_personal_data_erasers', array() );
	$is_last_eraser = count( $erasers ) === $eraser_index;
	$eraser_done    = $response['done'];

	if ( ! $is_last_eraser || ! $eraser_done ) {
		return $response;
	}

	_wp_privacy_completed_request( $request_id );

	/**
	 * Fires immediately after a personal data erasure request has been marked completed.
	 *
	 * @since 4.9.6
	 *
	 * @param int $request_id The privacy request post ID associated with this request.
	 */
	do_action( 'wp_privacy_personal_data_erased', $request_id );

	return $response;
}

Uses

Uses	Description
wp-includes/user.php: wp_get_user_request()	Return the user request object for the specified request ID.
wp-admin/includes/privacy-tools.php: wp_privacy_personal_data_erased	Fires immediately after a personal data erasure request has been marked completed.
wp-admin/includes/privacy-tools.php: _wp_privacy_completed_request()	Marks a request as completed by the admin and logs the current timestamp.
wp-admin/includes/ajax-actions.php: wp_privacy_personal_data_erasers	Filters the array of personal data eraser callbacks.
wp-includes/l10n.php: __()	Retrieve the translation of $text.
wp-includes/functions.php: wp_send_json_error()	Send a JSON response back to an Ajax request, indicating failure.
wp-includes/plugin.php: apply_filters()	Calls the callback functions that have been added to a filter hook.
wp-includes/plugin.php: do_action()	Execute functions hooked on a specific action hook.

Changelog

Version	Description
4.9.6	Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_privacy_process_personal_data_erasure_page