Changeset 43185 for trunk/src/wp-admin/includes/user.php

Timestamp:

05/09/2018 01:01:12 AM (7 years ago)

Author:

iandunn

Message:

Privacy: Mark erasure requests as completed after processing.

r42986 introduced the beginnings of an Ajax handler for processing requests to erase personal data. At the time, a method for marking requests as completed was planned, but had not yet been created. This commit introduces that mechanism, bringing the erasure process closer to completion.

Props coreymckrill, allendav.
Fixes #43922.

File:

• trunk/src/wp-admin/includes/user.php (modified) (1 diff)

trunk/src/wp-admin/includes/user.php

@@ -919 +919 @@
 
 /**
+ * Mark erasure requests as completed after processing is finished.
+ *
+ * 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.
+ *
+ * @since 4.9.6
+ *
+ * @see wp_privacy_personal_data_erasure_page
+ *
+ * @param array  $response      The response from the personal data eraser for
+ *                              the given page.
+ * @param int    $eraser_index  The index of the personal data eraser. Begins
+ *                              at 1.
+ * @param string $email_address The email address of the user whose personal
+ *                              data this is.
+ * @param int    $page          The page of personal data for this eraser.
+ *                              Begins at 1.
+ * @param int    $request_id    The request ID for this personal data erasure.
+ * @return array The filtered response.
+ */
+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;
+    }
+
+    $request = wp_get_user_request_data( $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 );
+
+    return $response;
+}
+
+/**
  * Add requests pages.
  *