mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/Echo
synced 2024-09-24 18:59:40 +00:00
23f66ec6e8
Add a media query style for mobile device so the email doesn't generate a horizontal bar. Gmail strips out all style, that means we can't apply the mobile style to Gmail. Luckily, Gmail on mobile device browser automatically fit into the entire mobile screen bug: 53057 Change-Id: Ia4350669db2e81ee44d5b53d7cece6fcd8839e7a
856 lines
21 KiB
PHP
856 lines
21 KiB
PHP
<?php
|
|
|
|
/**
|
|
* Abstract class for formatting email notifications
|
|
*/
|
|
abstract class EchoEmailFormatter {
|
|
|
|
/**
|
|
* @var EchoEmailMode
|
|
*/
|
|
protected $emailMode;
|
|
|
|
/**
|
|
* @param $emailMode EchoEmailMode
|
|
*/
|
|
public function __construct( EchoEmailMode $emailMode ) {
|
|
$this->emailMode = $emailMode;
|
|
}
|
|
|
|
/**
|
|
* Abstract method for formatting email
|
|
* @return string
|
|
*/
|
|
abstract public function formatEmail();
|
|
}
|
|
|
|
/**
|
|
* Formatter class for formatting text email notification
|
|
*/
|
|
class EchoTextEmailFormatter extends EchoEmailFormatter {
|
|
|
|
/**
|
|
* @param $emailMode EchoEmailMode
|
|
*/
|
|
public function __construct( EchoEmailMode $emailMode ) {
|
|
parent::__construct( $emailMode );
|
|
$this->emailMode->attachDecorator( new EchoTextEmailDecorator() );
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function formatEmail() {
|
|
$template = $this->emailMode->getTextTemplate();
|
|
|
|
foreach ( $this->emailMode->getComponent() as $val ) {
|
|
$func = 'build' . ucfirst( $val );
|
|
$template = str_replace( "%%$val%%", $this->emailMode->$func(), $template );
|
|
}
|
|
|
|
// Remove redundant newline characters
|
|
return $this->removeExtraNewLine( $template );
|
|
}
|
|
|
|
/**
|
|
* Remove extra newline from a text content
|
|
* @param $text string
|
|
* @return string
|
|
*/
|
|
protected function removeExtraNewLine( $text ) {
|
|
return preg_replace( "/\n{3,}/", "\n\n", $text );
|
|
}
|
|
|
|
}
|
|
|
|
/**
|
|
* Formatter class for formatting HTML email notification
|
|
*/
|
|
class EchoHTMLEmailFormatter extends EchoEmailFormatter {
|
|
|
|
/**
|
|
* @param $emailMode EchoEmailMode
|
|
*/
|
|
public function __construct( EchoEmailMode $emailMode ) {
|
|
parent::__construct( $emailMode );
|
|
$this->emailMode->attachDecorator( new EchoHTMLEmailDecorator() );
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function formatEmail() {
|
|
$template = $this->emailMode->getHTMLTemplate();
|
|
|
|
foreach ( $this->emailMode->getComponent() as $val ) {
|
|
$func = 'build' . ucfirst( $val );
|
|
$template = str_replace( "%%$val%%", $this->emailMode->$func(), $template );
|
|
}
|
|
|
|
return $template;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Abstract entity that represents an email delivery mode
|
|
*/
|
|
abstract class EchoEmailMode {
|
|
|
|
/**
|
|
* @var array
|
|
* Email components
|
|
*/
|
|
protected $component;
|
|
|
|
/**
|
|
* @var User
|
|
* The user who receives email notifications
|
|
*/
|
|
protected $user;
|
|
|
|
/**
|
|
* @var EchoEmailDecorator
|
|
* Email decorator
|
|
*/
|
|
protected $decorator;
|
|
|
|
/**
|
|
* @var Language
|
|
* The language object for the user language
|
|
*/
|
|
protected $lang;
|
|
|
|
/**
|
|
* @param $user User
|
|
* @param $component array
|
|
*/
|
|
public function __construct( User $user, array $component ) {
|
|
$this->user = $user;
|
|
// All email delivery mode share the same footer
|
|
$this->component = array_merge( $component, array( 'footer' ) );
|
|
// Initialize with a text decorator, the decorator can be altered
|
|
// via attacheDecorator() based on text/html emails
|
|
$this->decorator = new EchoTextEmailDecorator();
|
|
$this->lang = Language::factory( $user->getOption( 'language' ) );
|
|
}
|
|
|
|
/**
|
|
* Get text email template
|
|
* @return string
|
|
*/
|
|
abstract public function getTextTemplate();
|
|
|
|
/**
|
|
* Get html email template
|
|
* @return string
|
|
*/
|
|
abstract public function getHTMLTemplate();
|
|
|
|
/**
|
|
* Get the footer component
|
|
* @return string
|
|
*/
|
|
public function buildFooter() {
|
|
global $wgEchoEmailFooterAddress;
|
|
return $this->decorator->decorateFooter( $wgEchoEmailFooterAddress, $this->user );
|
|
}
|
|
|
|
/**
|
|
* Getter method for email template component
|
|
* @return array
|
|
*/
|
|
public function getComponent() {
|
|
return $this->component;
|
|
}
|
|
|
|
/**
|
|
* Get the notification icon path
|
|
* @param $icon string
|
|
* @return string
|
|
*/
|
|
public static function getNotifIcon( $icon ) {
|
|
global $wgEchoNotificationIcons, $wgExtensionAssetsPath;
|
|
|
|
$iconInfo = $wgEchoNotificationIcons[$icon];
|
|
if ( isset( $iconInfo['url'] ) && $iconInfo['url'] ) {
|
|
$iconUrl = $iconInfo['url'];
|
|
} else {
|
|
if ( !isset( $iconInfo['path'] ) || !$iconInfo['path'] ) {
|
|
$iconInfo = $wgEchoNotificationIcons['placeholder'];
|
|
}
|
|
$iconUrl = "$wgExtensionAssetsPath/{$iconInfo['path']}";
|
|
}
|
|
|
|
// Use http for image path, there is no need for https
|
|
return wfExpandUrl( $iconUrl, PROTO_HTTP );
|
|
}
|
|
|
|
/**
|
|
* Attach an email decorator to the email mode object
|
|
* @param $decorator EchoEmailDecorator
|
|
*/
|
|
public function attachDecorator( EchoEmailDecorator $decorator ) {
|
|
$this->decorator = $decorator;
|
|
}
|
|
|
|
/**
|
|
* Format the message in the user's language
|
|
* @param $message string
|
|
* @param $user User
|
|
* @return Message
|
|
*/
|
|
public static function message( $message, $user ) {
|
|
return wfMessage( $message )->inLanguage( $user->getOption( 'language' ) );
|
|
}
|
|
|
|
}
|
|
|
|
/**
|
|
* Entity that represents a single email delivery mode
|
|
*/
|
|
class EchoEmailSingle extends EchoEmailMode {
|
|
|
|
/**
|
|
* @var EchoBasicFormatter
|
|
*/
|
|
protected $notifFormatter;
|
|
|
|
/**
|
|
* @var EchoEvent
|
|
*/
|
|
protected $event;
|
|
|
|
/**
|
|
* @param $notifFormatter EchoBasicFormatter
|
|
* @param $event EchoEvent
|
|
* @param $user User
|
|
*/
|
|
public function __construct( EchoBasicFormatter $notifFormatter, EchoEvent $event, User $user ) {
|
|
parent::__construct( $user, array ( 'emailIcon', 'intro', 'summary', 'action' ) );
|
|
$this->notifFormatter = $notifFormatter;
|
|
$this->event = $event;
|
|
}
|
|
|
|
/**
|
|
* Build the intro component
|
|
* @return string
|
|
*/
|
|
public function buildIntro() {
|
|
$bundle = $this->notifFormatter->getValue( 'bundleData' );
|
|
$email = $this->notifFormatter->getValue( 'email' );
|
|
|
|
if ( $bundle['use-bundle'] && $email['batch-bundle-body']['message'] ) {
|
|
$detail = $email['batch-bundle-body'];
|
|
} else {
|
|
$detail = $email['batch-body'];
|
|
}
|
|
|
|
$message = $this->notifFormatter->formatFragment(
|
|
$detail,
|
|
$this->event,
|
|
$this->user
|
|
);
|
|
|
|
return $this->decorator->decorateIntro( $message );
|
|
}
|
|
|
|
/**
|
|
* Build the summary component
|
|
* @return string
|
|
*/
|
|
public function buildSummary() {
|
|
return $this->decorator->decorateRevisionSnippet(
|
|
$this->notifFormatter->getRevisionSnippet(
|
|
$this->event,
|
|
$this->user
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Build the action component
|
|
* @return string
|
|
*/
|
|
public function buildAction() {
|
|
$link = array();
|
|
$ranks = array( 'primary', 'secondary' );
|
|
|
|
foreach ( $ranks as $rank ) {
|
|
$message = $this->event->getLinkMessage( $rank );
|
|
|
|
// Valid call to action should have link text
|
|
if ( !$message ) {
|
|
continue;
|
|
}
|
|
|
|
$link[] = $this->decorator->decorateSingleAction(
|
|
$this->notifFormatter,
|
|
$this->event,
|
|
$this->user,
|
|
$rank,
|
|
$message
|
|
);
|
|
}
|
|
|
|
// Add some spacing between the two action links
|
|
$spacing = $this->decorator->getActionLinkSeparator();
|
|
return implode( $spacing . $spacing, $link );
|
|
}
|
|
|
|
/**
|
|
* Build the email icon component
|
|
* @return string
|
|
*/
|
|
public function buildEmailIcon() {
|
|
return EchoEmailMode::getNotifIcon( $this->notifFormatter->getValue( 'icon' ) );
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function getTextTemplate() {
|
|
return <<< EOF
|
|
%%intro%%
|
|
|
|
%%summary%%
|
|
|
|
%%action%%
|
|
|
|
%%footer%%
|
|
EOF;
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function getHTMLTemplate() {
|
|
$alignStart = $this->lang->alignStart();
|
|
return <<< EOF
|
|
<html><head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
<style>
|
|
@media only screen and (max-width: 480px){
|
|
table[id="email-container"]{max-width:600px !important; width:100% !important;}
|
|
}
|
|
</style>
|
|
</head><body>
|
|
<table cellspacing="0" cellpadding="0" border="0" width="100%" align="center" lang="{$this->lang->getCode()}" dir="{$this->lang->getDir()}">
|
|
<tr>
|
|
<td bgcolor="#E6E7E8"><center>
|
|
<br /><br />
|
|
<table cellspacing="0" cellpadding="0" border="0" width="600" id="email-container">
|
|
<tr>
|
|
<td bgcolor="#FFFFFF" width="5%"> </td>
|
|
<td bgcolor="#FFFFFF" width="10%"> </td>
|
|
<td bgcolor="#FFFFFF" width="80%" style="line-height:40px;"> </td>
|
|
<td bgcolor="#FFFFFF" width="5%"> </td>
|
|
</tr><tr>
|
|
<td bgcolor="#FFFFFF" rowspan="2"> </td>
|
|
<td bgcolor="#FFFFFF" align="center" valign="top" rowspan="2"><img src="%%emailIcon%%" alt="" height="30" width="30"></td>
|
|
<td bgcolor="#FFFFFF" align="{$alignStart}" style="font-family: Arial, Helvetica, sans-serif; font-size:13px; line-height:20px; color:#6D6E70;">%%intro%%</td>
|
|
<td bgcolor="#FFFFFF" rowspan="2"> </td>
|
|
</tr><tr>
|
|
<td bgcolor="#FFFFFF" align="{$alignStart}" style="font-family: Arial, Helvetica, sans-serif; line-height: 20px; font-weight: 600;">
|
|
<table cellspacing="0" cellpadding="0" border="0">
|
|
<tr>
|
|
<td bgcolor="#FFFFFF" align="{$alignStart}" style="font-family: Arial, Helvetica, sans-serif; padding-top: 8px; font-size:13px; font-weight: bold; color: #58585B;">
|
|
%%summary%%
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<table cellspacing="0" cellpadding="0" border="0">
|
|
<tr>
|
|
<td bgcolor="#FFFFFF" align="{$alignStart}" style="font-family: Arial, Helvetica, sans-serif; font-size:14px; padding-top: 25px;">
|
|
%%action%%
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
</tr><tr>
|
|
<td bgcolor="#FFFFFF"> </td>
|
|
<td bgcolor="#FFFFFF"> </td>
|
|
<td bgcolor="#FFFFFF" style="line-height:40px;"> </td>
|
|
<td bgcolor="#FFFFFF"> </td>
|
|
</tr><tr>
|
|
<td bgcolor="#F8F8F8"> </td>
|
|
<td bgcolor="#F8F8F8"> </td>
|
|
<td bgcolor="#F8F8F8" align="{$alignStart}" style="font-family: Arial, Helvetica, sans-serif; font-size:10px; line-height:13px; color:#6D6E70; padding:10px 20px;"><br />
|
|
%%footer%%
|
|
<br /><br />
|
|
</td>
|
|
<td bgcolor="#F8F8F8"> </td>
|
|
</tr><tr>
|
|
<td colspan="4"> </td>
|
|
</tr>
|
|
</table>
|
|
<br><br></center>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</body></html>
|
|
EOF;
|
|
}
|
|
|
|
}
|
|
|
|
/**
|
|
* Class that represents email digest delivery mode
|
|
*/
|
|
class EchoEmailDigest extends EchoEmailMode {
|
|
|
|
/**
|
|
* @var string
|
|
* The mode of email digest, 'weekly' or 'daily'
|
|
*/
|
|
protected $digestMode;
|
|
|
|
/**
|
|
* @var array
|
|
* Raw email digest list
|
|
*/
|
|
protected $rawDigestList;
|
|
|
|
/**
|
|
* @param $user User
|
|
* @param $rawDigestList array the raw notification event list
|
|
* @param $digestMode string 'daily'/'weekly'
|
|
*/
|
|
public function __construct( User $user, array $rawDigestList, $digestMode = 'daily' ) {
|
|
parent::__construct( $user, array( 'intro', 'digestList', 'action' ) );
|
|
// Some data validation
|
|
if ( !in_array( $digestMode, array( 'daily', 'weekly' ) ) ) {
|
|
$digestMode = 'daily';
|
|
}
|
|
$this->digestMode = $digestMode;
|
|
$this->rawDigestList = $rawDigestList;
|
|
}
|
|
|
|
/**
|
|
* Build the intro component
|
|
* @return string
|
|
*/
|
|
public function buildIntro() {
|
|
// Give grep a chance to find the usages:
|
|
// echo-email-batch-body-intro-daily, echo-email-batch-body-intro-weekly
|
|
$message = EchoEmailMode::message(
|
|
'echo-email-batch-body-intro-' . $this->digestMode, $this->user
|
|
)->params( $this->user->getName() );
|
|
|
|
return $this->decorator->decorateIntro( $message );
|
|
}
|
|
|
|
/**
|
|
* Build the digestList component
|
|
* @return string
|
|
*/
|
|
public function buildDigestList() {
|
|
if ( !$this->rawDigestList ) {
|
|
return '';
|
|
}
|
|
|
|
return $this->decorator->decorateDigestList( $this->rawDigestList, $this->user );
|
|
}
|
|
|
|
/**
|
|
* Build the action component
|
|
* @return string
|
|
*/
|
|
public function buildAction() {
|
|
$title = SpecialPage::getTitleFor( 'Notifications' );
|
|
|
|
return $this->decorator->decorateDigestAction( $title, $this->user );
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function getTextTemplate() {
|
|
return <<< EOF
|
|
%%intro%%
|
|
|
|
%%digestList%%
|
|
|
|
%%action%%
|
|
|
|
%%footer%%
|
|
|
|
EOF;
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function getHTMLTemplate() {
|
|
$alignStart = $this->lang->alignStart();
|
|
return <<< EOF
|
|
<html><head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
<style>
|
|
@media only screen and (max-width: 480px){
|
|
table[id="email-container"]{max-width:600px !important; width:100% !important;}
|
|
}
|
|
</style>
|
|
</head><body>
|
|
<table cellspacing="0" cellpadding="0" border="0" width="100%" align="center" lang="{$this->lang->getCode()}" dir="{$this->lang->getDir()}">
|
|
<tr>
|
|
<td bgcolor="#E6E7E8"><center>
|
|
<br /><br />
|
|
<table cellspacing="0" cellpadding="0" border="0" width="600" id="email-container">
|
|
<tr>
|
|
<td bgcolor="#FFFFFF" width="5%"> </td>
|
|
<td bgcolor="#FFFFFF" width="6%"> </td>
|
|
<td bgcolor="#FFFFFF" width="79%" style="line-height:40px;"> </td>
|
|
<td bgcolor="#FFFFFF" width="10%"> </td>
|
|
</tr>
|
|
<tr>
|
|
<td bgcolor="#FFFFFF" rowspan="2"> </td>
|
|
<td bgcolor="#FFFFFF" rowspan="2"> </td>
|
|
<td bgcolor="#FFFFFF" align="center" style="font-family: Arial, Helvetica, sans-serif; font-size:13px; line-height:20px; color:#6D6E70; text-align: center;">%%intro%%</td>
|
|
<td bgcolor="#FFFFFF" rowspan="2"> </td>
|
|
</tr>
|
|
<tr>
|
|
<td bgcolor="#FFFFFF" align="{$alignStart}" style="font-family: Arial, Helvetica, sans-serif; line-height: 20px; font-weight: 600;">
|
|
<table cellspacing="0" cellpadding="0" border="0" width="100%">
|
|
<tr>
|
|
<td bgcolor="#FFFFFF" align="{$alignStart}" style="font-family: Arial, Helvetica, sans-serif; font-size:13px; color: #58585B; padding-top: 25px;">
|
|
%%digestList%%
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<br /><br />
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td bgcolor="#FFFFFF"> </td>
|
|
<td bgcolor="#FFFFFF"> </td>
|
|
<td bgcolor="#FFFFFF" style="line-height:60px;" align="center">%%action%%</td>
|
|
<td bgcolor="#FFFFFF"> </td>
|
|
</tr>
|
|
<tr>
|
|
<td bgcolor="#FFFFFF"> </td>
|
|
<td bgcolor="#FFFFFF"> </td>
|
|
<td bgcolor="#FFFFFF" style="line-height:40px;"> </td>
|
|
<td bgcolor="#FFFFFF"> </td>
|
|
</tr>
|
|
<tr>
|
|
<td bgcolor="#F8F8F8"> </td>
|
|
<td bgcolor="#F8F8F8"> </td>
|
|
<td bgcolor="#F8F8F8" align="{$alignStart}" style="font-family: Arial, Helvetica, sans-serif; font-size:10px; line-height:13px; color:#6D6E70; padding: 10px 20px;"><br />
|
|
%%footer%%
|
|
<br /><br />
|
|
</td>
|
|
<td bgcolor="#F8F8F8"> </td>
|
|
</tr>
|
|
<tr>
|
|
<td colspan="4"> </td>
|
|
</tr>
|
|
</table>
|
|
<br><br></center>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</body></html>
|
|
EOF;
|
|
}
|
|
|
|
}
|
|
|
|
/**
|
|
* Email decorator interface
|
|
*/
|
|
interface EchoEmailDecorator {
|
|
/**
|
|
* Decorate the intro for all modes
|
|
* @param $message Message the intro message object
|
|
* @return string
|
|
*/
|
|
public function decorateIntro( $message );
|
|
|
|
/**
|
|
* Decorate the digest list for digest mode
|
|
* @param $digestList array
|
|
* @param $user User
|
|
* @return string
|
|
*/
|
|
public function decorateDigestList( $digestList, $user );
|
|
|
|
/**
|
|
* Decorate the primary action for digest mode
|
|
* @param $title Title
|
|
* @param $user User
|
|
* @return string
|
|
*/
|
|
public function decorateDigestAction( $title, $user );
|
|
|
|
/**
|
|
* Decorate the footer for all mode
|
|
* @param $address string
|
|
* @param $user User
|
|
* @return string
|
|
*/
|
|
public function decorateFooter( $address, $user );
|
|
|
|
/**
|
|
* Decorate the actions for single mode
|
|
* @param $notifFormatter EchoBasicFormatter
|
|
* @param $event EchoEvent
|
|
* @param $user User
|
|
* @param $rank string
|
|
* @param $message string
|
|
* @return string
|
|
*/
|
|
public function decorateSingleAction( $notifFormatter, $event, $user, $rank, $message );
|
|
|
|
/**
|
|
* Decorate a revision snippet
|
|
* @param $snippet the raw revision snippet
|
|
* @return string
|
|
*/
|
|
public function decorateRevisionSnippet( $snippet );
|
|
|
|
/**
|
|
* Get the spacing for between action links
|
|
* @return string
|
|
*/
|
|
public function getActionLinkSeparator();
|
|
}
|
|
|
|
/**
|
|
* Text email decorator
|
|
*/
|
|
class EchoTextEmailDecorator implements EchoEmailDecorator {
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function decorateIntro( $message ) {
|
|
return $message->text();
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function decorateDigestList( $digestList, $user ) {
|
|
$result = array();
|
|
|
|
// build the text section for each category
|
|
foreach( $digestList as $category => $notifs ) {
|
|
$output = EchoEmailMode::message( 'echo-category-title-' . $category, $user )->numParams( count( $notifs ) )->text()
|
|
. EchoEmailMode::message( 'colon-separator', $user )->text() . "\n";
|
|
|
|
foreach( $notifs as $notif ) {
|
|
$output .= "\n " . EchoEmailMode::message( 'echo-email-batch-bullet', $user )->text() . ' ' . $notif['batch-body'];
|
|
}
|
|
$result[] = $output;
|
|
}
|
|
|
|
// for prepending and appending 'echo-email-batch-separator'
|
|
$result = array_merge( array( '' ), $result, array( '' ) );
|
|
|
|
return trim(
|
|
implode(
|
|
"\n\n" . EchoEmailMode::message( 'echo-email-batch-separator', $user )->text() . "\n\n",
|
|
$result
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function decorateDigestAction( $title, $user ) {
|
|
return EchoEmailMode::message( 'echo-email-batch-link-text-view-all-notifications', $user )->text()
|
|
. EchoEmailMode::message( 'colon-separator', $user )->text()
|
|
. '<'
|
|
. $title->getFullURL( '', false, PROTO_HTTPS )
|
|
. '>';
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function decorateFooter( $address, $user ) {
|
|
return EchoEmailMode::message( 'echo-email-footer-default', $user )
|
|
->params(
|
|
$address,
|
|
EchoEmailMode::message( 'echo-email-batch-separator', $user )->text()
|
|
)
|
|
->text();
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function decorateSingleAction( $notifFormatter, $event, $user, $rank, $message ) {
|
|
$url = $notifFormatter->getLink( $event, $user, $rank, false, true );
|
|
|
|
return EchoEmailMode::message( $message, $user )->text()
|
|
. EchoEmailMode::message( 'colon-separator', $user )->text()
|
|
. '<'
|
|
. $notifFormatter->sanitizeEmailLink( $url )
|
|
. '>';
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function decorateRevisionSnippet( $snippet ) {
|
|
// Doing nothing now, but there is a potential to wrap the text
|
|
// around snippet with quote in plain text email
|
|
return $snippet;
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function getActionLinkSeparator() {
|
|
return "\n";
|
|
}
|
|
}
|
|
|
|
/**
|
|
* HTML email decorator
|
|
*/
|
|
class EchoHTMLEmailDecorator implements EchoEmailDecorator {
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function decorateIntro( $message ) {
|
|
return nl2br( $message->parse() );
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function decorateDigestList( $digestList, $user ) {
|
|
$result = array();
|
|
// build the html section for each category
|
|
foreach( $digestList as $category => $notifs ) {
|
|
$output = $this->applyStyleToCategory(
|
|
EchoEmailMode::message( 'echo-category-title-' . $category, $user )
|
|
->numParams( count( $notifs ) )
|
|
->escaped()
|
|
);
|
|
foreach( $notifs as $notif ) {
|
|
$output .= "\n" . $this->applyStyleToEvent( $notif );
|
|
}
|
|
$result[] = '<table border="0" width="100%">' . $output . '</table>';
|
|
}
|
|
|
|
return trim( implode( "\n", $result ) );
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function decorateDigestAction( $title, $user ) {
|
|
return Linker::link(
|
|
$title,
|
|
EchoEmailMode::message( 'echo-email-batch-link-text-view-all-notifications', $user )->escaped(),
|
|
array( 'style' => $this->getPrimaryLinkCSS() ),
|
|
array(),
|
|
array( 'https' )
|
|
);
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function decorateFooter( $address, $user ) {
|
|
$title = SpecialPage::getTitleFor( 'Preferences' );
|
|
$title->setFragment( "#mw-prefsection-echo" );
|
|
return EchoEmailMode::message( 'echo-email-footer-default-html', $user )
|
|
->params( $address )
|
|
->rawParams( $title->getFullURL( '', false, PROTO_HTTPS ) )
|
|
->text();
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function decorateSingleAction( $notifFormatter, $event, $user, $rank, $message ) {
|
|
if ( $rank === 'primary' ) {
|
|
$style = $this->getPrimaryLinkCSS();
|
|
} else {
|
|
$style = $this->getSecondaryLinkCSS();
|
|
}
|
|
|
|
return $notifFormatter->getLink( $event, $user, $rank, false, false, $style );
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function decorateRevisionSnippet( $snippet ) {
|
|
return htmlspecialchars( $snippet );
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
public function getActionLinkSeparator() {
|
|
return " ";
|
|
}
|
|
|
|
/**
|
|
* The style for primary link
|
|
* @return string
|
|
*/
|
|
protected function getPrimaryLinkCSS() {
|
|
return 'cursor:pointer; text-align:center; text-decoration:none; padding:.45em 1.2em .45em;
|
|
color:#D9EEF7; background:#3366BB; font-family: Arial, Helvetica, sans-serif;font-size: 13px;';
|
|
}
|
|
|
|
/**
|
|
* The style for secondary link
|
|
* @return string
|
|
*/
|
|
protected function getSecondaryLinkCSS() {
|
|
return 'text-decoration: none;font-size: 10px;font-family: Arial, Helvetica, sans-serif; color: #808184';
|
|
}
|
|
|
|
/**
|
|
* Apply style to notification category header
|
|
* @param $category string
|
|
* @return string
|
|
*/
|
|
protected function applyStyleToCategory( $category ) {
|
|
return <<< EOF
|
|
<tr>
|
|
<td colspan="2" style="color: #A87B4F; font-weight: normal; font-size: 13px; padding-top: 15px;">
|
|
$category <br />
|
|
<hr style="background-color:#FFFFFF; color:#FFFFFF; border: 1px solid #F2F2F2;" />
|
|
</td>
|
|
</tr>
|
|
EOF;
|
|
}
|
|
|
|
/**
|
|
* Apply style to individual notification event
|
|
* @param $notif array an array containts keys: icon, batch-body, batch-body-html
|
|
* @return string
|
|
*/
|
|
protected function applyStyletoEvent( $notif ) {
|
|
// notification icon
|
|
$icon = EchoEmailMode::getNotifIcon( $notif['icon'] );
|
|
// notification text
|
|
$text = $notif['batch-body-html'];
|
|
|
|
return <<< EOF
|
|
<tr>
|
|
<td width="30">
|
|
<img src="$icon" width="30" height="30" style="vertical-align:middle;">
|
|
</td>
|
|
<td style="font-family: Arial, Helvetica, sans-serif; font-size:13px; color: #58585B;">
|
|
$text
|
|
</td>
|
|
</tr>
|
|
EOF;
|
|
}
|
|
|
|
}
|
|
|