MediaWiki  1.28.0
EmailNotification Class Reference

This module processes the email notifications when the current page is changed. More...

Collaboration diagram for EmailNotification:

Public Member Functions

 actuallyNotifyOnPageChange ($editor, $title, $timestamp, $summary, $minorEdit, $oldid, $watchers, $pageStatus= 'changed')
 Immediate version of notifyOnPageChange(). More...
 
 compose ($user, $source)
 Compose a mail to a given user and either queue it for sending, or send it now, depending on settings. More...
 
 notifyOnPageChange ($editor, $title, $timestamp, $summary, $minorEdit, $oldid=false, $pageStatus= 'changed')
 Send emails corresponding to the user $editor editing the page $title. More...
 
 sendImpersonal ($addresses)
 Same as sendPersonalised but does impersonal mail suitable for bulk mailing. More...
 
 sendMails ()
 Send any queued mails. More...
 

Static Public Member Functions

static updateWatchlistTimestamp (User $editor, LinkTarget $linkTarget, $timestamp)
 

Public Attributes

 $body
 
 $composed_common
 
 $from
 
 $minorEdit
 
 $oldid
 
 $pageStatus
 
 $replyto
 
 $summary
 
const ALL_CHANGES = 'all_changes'
 Notification because user is notified for all changes. More...
 
const USER_TALK = 'user_talk'
 Notification is due to user's user talk being edited. More...
 
const WATCHLIST = 'watchlist'
 Notification is due to a watchlisted page being edited. More...
 

Protected Attributes

User $editor
 
 $mailTargets = []
 
 $subject
 
 $timestamp
 
Title $title
 

Private Member Functions

 canSendUserTalkEmail ($editor, $title, $minorEdit)
 
 composeCommonMailtext ()
 Generate the generic "this page has been changed" e-mail text. More...
 
 sendPersonalised ($watchingUser, $source)
 Does the per-user customizations to a notification e-mail (name, timestamp in proper timezone, etc) and sends it out. More...
 

Detailed Description

This module processes the email notifications when the current page is changed.

It looks up the table watchlist to find out which users are watching that page.

The current implementation sends independent emails to each watching user for the following reason:

  • Each watching user will be notified about the page edit time expressed in his/her local time (UTC is shown additionally). To achieve this, we need to find the individual timeoffset of each watching user from the preferences..

Suggested improvement to slack down the number of sent emails: We could think of sending out bulk mails (bcc:user1,user2...) for all these users having the same timeoffset in their preferences.

Visit the documentation pages under http://meta.wikipedia.com/Enotif

Definition at line 48 of file EmailNotification.php.

Member Function Documentation

EmailNotification::actuallyNotifyOnPageChange (   $editor,
  $title,
  $timestamp,
  $summary,
  $minorEdit,
  $oldid,
  $watchers,
  $pageStatus = 'changed' 
)

Immediate version of notifyOnPageChange().

Send emails corresponding to the user $editor editing the page $title.

Note
Do not call directly. Use notifyOnPageChange so that wl_notificationtimestamp is updated.
Parameters
User$editor
Title$title
string$timestampEdit timestamp
string$summaryEdit summary
bool$minorEdit
int$oldidRevision ID
array$watchersArray of user IDs
string$pageStatus
Exceptions
MWException

Definition at line 189 of file EmailNotification.php.

References $editor, $minorEdit, $name, $oldid, $pageStatus, $summary, $timestamp, $title, $user, $wgEnotifMinorEdits, $wgEnotifUserTalk, $wgEnotifWatchlist, $wgUsersNotifiedOnAllChanges, as, canSendUserTalkEmail(), compose(), User\getName(), Title\getNamespace(), Title\getText(), global, User\isAllowed(), UserArray\newFromIDs(), User\newFromName(), NS_USER_TALK, Hooks\run(), sendMails(), and title.

EmailNotification::canSendUserTalkEmail (   $editor,
  $title,
  $minorEdit 
)
private
Parameters
User$editor
Title$title
bool$minorEdit
Returns
bool

Definition at line 268 of file EmailNotification.php.

References $wgEnotifUserTalk, User\getId(), Title\getNamespace(), Title\getText(), global, User\newFromName(), NS_USER_TALK, Hooks\run(), and wfDebug().

Referenced by actuallyNotifyOnPageChange(), and notifyOnPageChange().

EmailNotification::compose (   $user,
  $source 
)

Compose a mail to a given user and either queue it for sending, or send it now, depending on settings.

Call sendMails() to send any mails that were queued.

Parameters
User$user
string$source

Definition at line 419 of file EmailNotification.php.

References $source, $user, $wgEnotifImpersonal, composeCommonMailtext(), global, MailAddress\newFromUser(), and sendPersonalised().

Referenced by actuallyNotifyOnPageChange().

EmailNotification::notifyOnPageChange (   $editor,
  $title,
  $timestamp,
  $summary,
  $minorEdit,
  $oldid = false,
  $pageStatus = 'changed' 
)

Send emails corresponding to the user $editor editing the page $title.

May be deferred via the job queue.

Parameters
User$editor
Title$title
string$timestamp
string$summary
bool$minorEdit
bool$oldid(default: false)
string$pageStatus(default: 'changed')

Definition at line 117 of file EmailNotification.php.

References $minorEdit, $oldid, $pageStatus, $summary, $timestamp, $wgEnotifMinorEdits, $wgEnotifUserTalk, $wgUsersNotifiedOnAllChanges, canSendUserTalkEmail(), User\getId(), RequestContext\getMain(), User\getName(), Title\getNamespace(), global, User\isAllowed(), NS_USER_TALK, and JobQueueGroup\singleton().

EmailNotification::sendImpersonal (   $addresses)

Same as sendPersonalised but does impersonal mail suitable for bulk mailing.

Takes an array of MailAddress objects.

Parameters
MailAddress[]$addresses
Returns
Status|null

Definition at line 491 of file EmailNotification.php.

References $body, $wgContLang, from, global, UserMailer\send(), text, and wfMessage().

Referenced by sendMails().

EmailNotification::sendMails ( )

Send any queued mails.

Definition at line 436 of file EmailNotification.php.

References $wgEnotifImpersonal, global, and sendImpersonal().

Referenced by actuallyNotifyOnPageChange().

EmailNotification::sendPersonalised (   $watchingUser,
  $source 
)
private

Does the per-user customizations to a notification e-mail (name, timestamp in proper timezone, etc) and sends it out.

Returns true if the mail was sent successfully.

Parameters
User$watchingUser
string$source
Returns
bool

Definition at line 453 of file EmailNotification.php.

References $body, $source, $wgContLang, $wgEnotifUseRealName, from, global, MailAddress\newFromUser(), and UserMailer\send().

Referenced by compose().

static EmailNotification::updateWatchlistTimestamp ( User  $editor,
LinkTarget  $linkTarget,
  $timestamp 
)
static
Deprecated:
since 1.27 use WatchedItemStore::updateNotificationTimestamp directly
Parameters
User$editorThe editor that triggered the update. Their notification timestamp will not be updated(they have already seen it)
LinkTarget$linkTargetThe link target of the title to update timestamps for
string$timestampSet the update timestamp to this value
Returns
int[] Array of user IDs

Definition at line 87 of file EmailNotification.php.

References $timestamp, and RequestContext\getMain().

Referenced by WatchedItemIntegrationTest\testUpdateAndResetNotificationTimestamp().

Member Data Documentation

EmailNotification::$body

Definition at line 63 of file EmailNotification.php.

Referenced by sendImpersonal(), and sendPersonalised().

EmailNotification::$composed_common

Definition at line 64 of file EmailNotification.php.

User EmailNotification::$editor
protected

Definition at line 75 of file EmailNotification.php.

Referenced by actuallyNotifyOnPageChange().

EmailNotification::$from

Definition at line 63 of file EmailNotification.php.

EmailNotification::$mailTargets = []
protected

Definition at line 65 of file EmailNotification.php.

EmailNotification::$minorEdit

Definition at line 64 of file EmailNotification.php.

Referenced by actuallyNotifyOnPageChange(), and notifyOnPageChange().

EmailNotification::$oldid
EmailNotification::$pageStatus

Definition at line 64 of file EmailNotification.php.

Referenced by actuallyNotifyOnPageChange(), and notifyOnPageChange().

EmailNotification::$replyto

Definition at line 63 of file EmailNotification.php.

EmailNotification::$subject
protected

Definition at line 63 of file EmailNotification.php.

EmailNotification::$summary
EmailNotification::$timestamp
protected
Title EmailNotification::$title
protected

Definition at line 70 of file EmailNotification.php.

Referenced by actuallyNotifyOnPageChange().

const EmailNotification::ALL_CHANGES = 'all_changes'

Notification because user is notified for all changes.

Definition at line 61 of file EmailNotification.php.

const EmailNotification::USER_TALK = 'user_talk'

Notification is due to user's user talk being edited.

Definition at line 53 of file EmailNotification.php.

const EmailNotification::WATCHLIST = 'watchlist'

Notification is due to a watchlisted page being edited.

Definition at line 57 of file EmailNotification.php.


The documentation for this class was generated from the following file: