Changeset 57283

Timestamp:

01/14/2024 10:59:48 AM (3 years 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 );
+        }
 }