Ticket #46303: 46303.3.diff

src/wp-admin/includes/file.php

@@ -2346 +2346 @@
  * @return true|WP_Error True on success or `WP_Error` on failure.
  */
 function wp_privacy_send_personal_data_export_email( $request_id ) {
-        // Get the request data.
         $request = wp_get_user_request_data( $request_id );
 
         if ( ! $request || 'export_personal_data' !== $request->action_name ) {
@@ -2356 +2355 @@
         /** This filter is documented in wp-includes/functions.php */
         $expiration      = apply_filters( 'wp_privacy_export_expiration', 3 * DAY_IN_SECONDS );
         $expiration_date = date_i18n( get_option( 'date_format' ), time() + $expiration );
+        $export_file_url = get_post_meta( $request_id, '_export_file_url', true );
+        $site_name       = wp_specialchars_decode( get_option( 'blogname' ), ENT_QUOTES );
+        $site_url        = home_url();
 
+        /**
+         * Filters the recipient of the personal data export email notification.
+         *
+         * @since 5.3.0
+         *
+         * @param string          $request_email The email address of the notification recipient.
+         * @param WP_User_Request $request       The request that is initiating the notification.
+         */
+        $request_email = apply_filters( 'wp_privacy_personal_data_email_to', $request->email, $request );
+
+        $email_data = array(
+                'request'            => $request,
+                'expiration'         => $expiration,
+                'expiration_date'    => $expiration_date,
+                'message_recipient'  => $request_email,
+                'export_file_url'    => $export_file_url,
+                'sitename'           => $site_name,
+                'siteurl'            => $site_url,
+        );
+
+        $subject = sprintf(
+                /* translators: %s: Site name. */
+                __( '[%s] Personal Data Export' ),
+                $site_name
+        );
+
+        /**
+         * Filters the subject of the email sent when an export request is completed.
+         *
+         * @since 4.9.8
+         *
+         * @param string $subject    The email subject.
+         * @param string $sitename   The name of the site.
+         * @param array  $email_data {
+         *     Data relating to the account action email.
+         *
+         *     @type WP_User_Request $request            User request object.
+         *     @type int             $expiration         The time in seconds until the export file expires.
+     *     @type string          $expiration_date    The localized date and time when the export file expires.
+         *     @type string          $message_recipient  The address that the email will be sent to. Defaults
+         *                                               to the value of `$request->email`, but can be changed
+         *                                               by the `wp_privacy_personal_data_email_to` filter.
+         *     @type string          $export_file_url    The export file URL.
+         *     @type string          $sitename           The site name sending the mail.
+         *     @type string          $siteurl            The site URL sending the mail.
+         * }
+         */
+        $subject = apply_filters( 'wp_privacy_personal_data_email_subject', $subject, $site_name, $email_data );
+
         /* translators: Do not translate EXPIRATION, LINK, SITENAME, SITEURL: those are placeholders. */
         $email_text = __(
                 'Howdy,
@@ -2383 +2434 @@
          * ###SITEURL###            The URL to the site.
          *
          * @since 4.9.6
+     * @since 5.3.0 Introduced the $email_data array.
          *
          * @param string $email_text     Text in the email.
          * @param int    $request_id     The request ID for this personal data export.
+     * @param array  $email_data {
+     *     Data relating to the account action email.
+     *
+     *     @type WP_User_Request $request            User request object.
+     *     @type int             $expiration         The time in seconds until the export file expires.
+     *     @type string          $expiration_date    The localized date and time when the export file expires.
+     *     @type string          $message_recipient  The address that the email will be sent to. Defaults
+     *                                               to the value of `$request->email`, but can be changed
+     *                                               by the `wp_privacy_personal_data_email_to` filter.
+     *     @type string          $export_file_url    The export file URL.
+     *     @type string          $sitename           The site name sending the mail.
+     *     @type string          $siteurl            The site URL sending the mail.
+     * }
          */
-        $content = apply_filters( 'wp_privacy_personal_data_email_content', $email_text, $request_id );
+        $content = apply_filters( 'wp_privacy_personal_data_email_content', $email_text, $request_id, $email_data );
 
-        $email_address   = $request->email;
-        $export_file_url = get_post_meta( $request_id, '_export_file_url', true );
-        $site_name       = wp_specialchars_decode( get_option( 'blogname' ), ENT_QUOTES );
-        $site_url        = home_url();
-
         $content = str_replace( '###EXPIRATION###', $expiration_date, $content );
         $content = str_replace( '###LINK###', esc_url_raw( $export_file_url ), $content );
-        $content = str_replace( '###EMAIL###', $email_address, $content );
+        $content = str_replace( '###EMAIL###', $request_email, $content );
         $content = str_replace( '###SITENAME###', $site_name, $content );
         $content = str_replace( '###SITEURL###', esc_url_raw( $site_url ), $content );
 
-        $mail_success = wp_mail(
-                $email_address,
-                sprintf(
-                        __( '[%s] Personal Data Export' ),
-                        $site_name
-                ),
-                $content
-        );
+        $mail_success = wp_mail( $request_email, $subject, $content );
 
         if ( ! $mail_success ) {
                 return new WP_Error( 'privacy_email_error', __( 'Unable to send personal data export email.' ) );