mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/Echo
synced 2024-12-01 02:46:46 +00:00
c1c3c7b672
There are about 200 of such generic "array" type hints in this code base, the majority in @param tags. I started with what I found most relevant: @var and @return tags. I might continue working on this later, but wanted to stop for now to keep this patch moderately small. Change-Id: Iff0d9590a794ae0f885466ef6bb336b0b42a6cd3
227 lines
6.6 KiB
PHP
227 lines
6.6 KiB
PHP
<?php
|
|
|
|
class EchoHtmlDigestEmailFormatter extends EchoEventDigestFormatter {
|
|
|
|
/**
|
|
* @var string 'daily' or 'weekly'
|
|
*/
|
|
protected $digestMode;
|
|
|
|
public function __construct( User $user, Language $language, $digestMode ) {
|
|
parent::__construct( $user, $language );
|
|
$this->digestMode = $digestMode;
|
|
}
|
|
|
|
/**
|
|
* @param EchoEventPresentationModel[] $models
|
|
* @return string[] Array of the following format:
|
|
* [ 'body' => formatted email body,
|
|
* 'subject' => formatted email subject ]
|
|
*/
|
|
protected function formatModels( array $models ) {
|
|
// echo-email-batch-body-intro-daily
|
|
// echo-email-batch-body-intro-weekly
|
|
$intro = $this->msg( 'echo-email-batch-body-intro-' . $this->digestMode )
|
|
->params( $this->user->getName() )
|
|
->parse();
|
|
$intro = nl2br( $intro );
|
|
|
|
$eventsByCategory = $this->groupByCategory( $models );
|
|
ksort( $eventsByCategory );
|
|
$digestList = $this->renderDigestList( $eventsByCategory );
|
|
|
|
$htmlFormatter = new EchoHtmlEmailFormatter( $this->user, $this->language );
|
|
|
|
$body = $this->renderBody(
|
|
$this->language,
|
|
$intro,
|
|
$digestList,
|
|
$this->renderAction(),
|
|
$htmlFormatter->getFooter()
|
|
);
|
|
|
|
// echo-email-batch-subject-daily
|
|
// echo-email-batch-subject-weekly
|
|
$subject = $this->msg( 'echo-email-batch-subject-' . $this->digestMode )
|
|
->numParams( count( $models ), count( $models ) )
|
|
->text();
|
|
|
|
return [
|
|
'subject' => $subject,
|
|
'body' => $body,
|
|
];
|
|
}
|
|
|
|
private function renderBody( Language $language, $intro, $digestList, $action, $footer ) {
|
|
$alignStart = $language->alignStart();
|
|
$langCode = $language->getHtmlCode();
|
|
$langDir = $language->getDir();
|
|
|
|
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="$langCode" dir="$langDir">
|
|
<tr>
|
|
<td bgcolor="#EAECF0"><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:#72777D; 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: #54595D; 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> </td>
|
|
<td> </td>
|
|
<td align="$alignStart" style="font-family: Arial, Helvetica, sans-serif; font-size:10px; line-height:13px; color:#72777D; padding: 10px 20px;"><br />
|
|
$footer
|
|
<br /><br />
|
|
</td>
|
|
<td> </td>
|
|
</tr>
|
|
<tr>
|
|
<td colspan="4"> </td>
|
|
</tr>
|
|
</table>
|
|
<br><br></center>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</body></html>
|
|
EOF;
|
|
}
|
|
|
|
/**
|
|
* @param string $type Notification type
|
|
* @param int $count Number of notifications in this type's section
|
|
* @return string Formatted category section title
|
|
*/
|
|
private function getCategoryTitle( $type, $count ) {
|
|
return $this->msg( "echo-category-title-$type" )
|
|
->numParams( $count )
|
|
->parse();
|
|
}
|
|
|
|
/**
|
|
* @param EchoEventPresentationModel[] $models
|
|
* @return array [ 'category name' => EchoEventPresentationModel[] ]
|
|
*/
|
|
private function groupByCategory( $models ) {
|
|
$eventsByCategory = [];
|
|
foreach ( $models as $model ) {
|
|
$eventsByCategory[$model->getCategory()][] = $model;
|
|
}
|
|
return $eventsByCategory;
|
|
}
|
|
|
|
/**
|
|
* Apply style to notification category header
|
|
* @param string $category Can contain HTML. Is included as-is in HTML template, is not escaped.
|
|
* @return string
|
|
*/
|
|
protected function applyStyleToCategory( $category ) {
|
|
return <<< EOF
|
|
<tr>
|
|
<td colspan="2" style="color: #72777D; font-weight: normal; font-size: 13px; padding-top: 15px;">
|
|
$category <br />
|
|
<hr style="background-color:#FFFFFF; color:#FFFFFF; border: 1px solid #EAECF0;" />
|
|
</td>
|
|
</tr>
|
|
EOF;
|
|
}
|
|
|
|
/**
|
|
* Apply style to individual notification event
|
|
* @param EchoEventPresentationModel $model
|
|
* @return string
|
|
*/
|
|
protected function applyStyleToEvent( EchoEventPresentationModel $model ) {
|
|
$iconUrl = wfExpandUrl(
|
|
EchoIcon::getRasterizedUrl( $model->getIconType(), $this->language->getCode() ),
|
|
PROTO_CANONICAL
|
|
);
|
|
|
|
$imgSrc = Sanitizer::encodeAttribute( $iconUrl );
|
|
|
|
// notification text
|
|
$text = $model->getHeaderMessage()->parse();
|
|
|
|
return <<< EOF
|
|
<tr>
|
|
<td width="30">
|
|
<img src="$imgSrc" width="30" height="30" style="vertical-align:middle;">
|
|
</td>
|
|
<td style="font-family: Arial, Helvetica, sans-serif; font-size:13px; color: #54595D;">
|
|
$text
|
|
</td>
|
|
</tr>
|
|
EOF;
|
|
}
|
|
|
|
private function renderDigestList( $eventsByCategory ) {
|
|
$result = [];
|
|
// build the html section for each category
|
|
foreach ( $eventsByCategory as $category => $models ) {
|
|
$output = $this->applyStyleToCategory(
|
|
$this->getCategoryTitle( $category, count( $models ) )
|
|
);
|
|
foreach ( $models as $model ) {
|
|
$output .= "\n" . $this->applyStyleToEvent( $model );
|
|
}
|
|
$result[] = '<table border="0" width="100%">' . $output . '</table>';
|
|
}
|
|
|
|
return trim( implode( "\n", $result ) );
|
|
}
|
|
|
|
private function renderAction() {
|
|
return Html::element(
|
|
'a',
|
|
[
|
|
'href' => SpecialPage::getTitleFor( 'Notifications' )->getFullURL( '', false, PROTO_CANONICAL ),
|
|
'style' => EchoHtmlEmailFormatter::PRIMARY_LINK_STYLE,
|
|
],
|
|
$this->msg( 'echo-email-batch-link-text-view-all-notifications' )->text()
|
|
);
|
|
}
|
|
|
|
}
|