Add new Hook 'SendWatchlistEmailNotification'

Bug: 53569
Change-Id: I73d5eef9a18d59b022c353c4b7d2aee18bfa6591

diff --git a/RELEASE-NOTES-1.23 b/RELEASE-NOTES-1.23
index be53faf..9b8050c 100644 (file)
--- a/RELEASE-NOTES-1.23
+++ b/RELEASE-NOTES-1.23
@@ -107,6 +107,8 @@ production.
   parameter, which overrides the 'options' parameter.
 * Admins can expire users users passwords manually, or on a schedule using the
   $wgPasswordExpirationDays configuration setting.
+* Add new hook SendWatchlistEmailNotification, this will be used to determine
+  whether to send a watchlist email notification.
 
 === Bug fixes in 1.23 ===
 * (bug 41759) The "updated since last visit" markers (on history pages, recent

diff --git a/docs/hooks.txt b/docs/hooks.txt
index b9423a8..e7fa89b 100644 (file)
--- a/docs/hooks.txt
+++ b/docs/hooks.txt
@@ -277,6 +277,11 @@ $user: the User object about to be created (read-only, incomplete)
 $targetUser: the user whom to send talk page email notification
 $title: the page title
 
+'SendWatchlistEmailNotification': Return true to send watchlist email notification
+$targetUser: the user whom to send watchlist email notification
+$title: the page title
+$this: EmailNotification object
+
 'AbortChangePassword': Return false to cancel password change.
 $user: the User object to which the password change is occuring
 $mOldpass: the old password provided by the user

diff --git a/includes/UserMailer.php b/includes/UserMailer.php
index e1d00d3..fe80929 100644 (file)
--- a/includes/UserMailer.php
+++ b/includes/UserMailer.php
@@ -649,7 +649,9 @@ class EmailNotification {
                                                && $watchingUser->isEmailConfirmed()
                                                && $watchingUser->getID() != $userTalkId
                                        ) {
-                                               $this->compose( $watchingUser );
+                                               if ( wfRunHooks( 'SendWatchlistEmailNotification', array( $watchingUser, $title, $this ) ) ) {
+                                                       $this->compose( $watchingUser );
+                                               }
                                        }
                                }
                        }