Changeset 57283

Timestamp:

01/14/2024 10:59:48 AM (8 months ago)

Author:

audrasjb

Message:

Administration: Introduce new_admin_email_subject filter.

This changeset introduces the new_admin_email_subject hook which allow developers to filter the subject of the email sent when a change of site admin email address is attempted.

Props MadtownLems, johnbillion, alexanderkoledov, shooper, Marc_J, nikmeyer, xlthlx, devmuhib, nuhel, audrasjb.
Fixes #59250.

Location:

trunk

Files:

• src/wp-admin/includes/misc.php (modified) (1 diff)
• tests/phpunit/tests/admin/includesMisc.php (modified) (1 diff)

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

@@ -1532 +1532 @@
     }
 
-    wp_mail(
-        $value,
-        sprintf(
-            /* translators: New admin email address notification email subject. %s: Site title. */
-            __( '[%s] New Admin Email Address' ),
-            $site_title
-        ),
-        $content
+    $subject = sprintf(
+        /* translators: New admin email address notification email subject. %s: Site title. */
+        __( '[%s] New Admin Email Address' ),
+        $site_title
     );
+
+    /**
+     * Filters the subject of the email sent when a change of site admin email address is attempted.
+     *
+     * @since 6.5.0
+     *
+     * @param string $subject Subject of the email.
+     */
+    $subject = apply_filters( 'new_admin_email_subject', $subject );
+
+    wp_mail( $value, $subject, $content );
 
     if ( $switched_locale ) {

trunk/tests/phpunit/tests/admin/includesMisc.php

@@ -28 +28 @@
         }
     }
+
+    /**
+     * @ticket 59520
+     */
+    public function test_new_admin_email_subject_filter() {
+        // Default value
+        $mailer = tests_retrieve_phpmailer_instance();
+        update_option_new_admin_email( 'old@example.com', 'new@example.com' );
+        $this->assertEquals( '[Test Blog] New Admin Email Address', $mailer->get_sent()->subject );
+
+        // Filtered value
+        add_filter(
+            'new_admin_email_subject',
+            function () {
+                return 'Filtered Admin Email Address';
+            },
+            10,
+            1
+        );
+
+        $mailer->mock_sent = array();
+
+        $mailer = tests_retrieve_phpmailer_instance();
+        update_option_new_admin_email( 'old@example.com', 'new@example.com' );
+        $this->assertEquals( 'Filtered Admin Email Address', $mailer->get_sent()->subject );
+    }
 }