mediawiki-extensions-Echo/special/SpecialNotifications.php
Erik Bernhardson 425a4a09fa Catch exceptions formatting notifications
Provide users a better user experience by catching and logging
errors with Echo notifications.

Bug: 60906
Change-Id: Iee93a05c6eed468af8bbfa60249df0819c49c45b
2014-02-05 13:55:27 -08:00

155 lines
4.4 KiB
PHP

<?php
class SpecialNotifications extends SpecialPage {
/**
* Number of notification records to display per page/load
*/
private static $displayNum = 20;
public function __construct() {
parent::__construct( 'Notifications' );
}
public function execute( $par ) {
$this->setHeaders();
$out = $this->getOutput();
$out->setPageTitle( $this->msg( 'echo-specialpage' )->text() );
$user = $this->getUser();
if ( $user->isAnon() ) {
$notificationsPageName = $this->getPageTitle()->getPrefixedDBkey();
$returnTo = array( 'returnto' => $notificationsPageName );
$signupTitle = SpecialPage::getTitleFor( 'UserLogin', 'signup' );
$signupURL = $signupTitle->getFullURL( $returnTo );
$loginTitle = SpecialPage::getTitleFor( 'UserLogin' );
$loginURL = $loginTitle->getFullURL( $returnTo );
$anonMsgHtml = $this->msg( 'echo-anon', $signupURL, $loginURL )->parse();
$out->addHTML( Html::rawElement( 'span', array( 'class' => 'plainlinks' ), $anonMsgHtml ) );
return;
}
$out->addSubtitle( $this->buildSubtitle() );
// The continue parameter to pull current set of data from, this
// would be used for browsers with javascript disabled
$continue = $this->getRequest()->getVal( 'continue', null );
// Pull the notifications
$notif = ApiEchoNotifications::getNotifications( $user, 'html', self::$displayNum + 1, $continue );
// If there are no notifications, display a message saying so
if ( !$notif ) {
$out->addWikiMsg( 'echo-none' );
return;
}
// Check if there is more data to load for next request
if ( count( $notif ) > self::$displayNum ) {
$lastItem = array_pop( $notif );
$nextContinue = $lastItem['timestamp']['utcunix'] . '|' . $lastItem['id'];
} else {
$nextContinue = null;
}
// Add the notifications to the page (interspersed with date headers)
$dateHeader = '';
$notices = '';
$unread = array();
foreach ( $notif as $row ) {
if ( !$row['*'] ) {
continue;
}
// Output the date header if it has not been displayed
if ( $dateHeader !== $row['timestamp']['date'] ) {
$dateHeader = $row['timestamp']['date'];
$notices .= Html::rawElement( 'li', array( 'class' => 'mw-echo-date-section' ), $dateHeader );
}
$class = 'mw-echo-notification';
if ( !isset( $row['read'] ) ) {
$class .= ' mw-echo-unread';
$unread[] = $row['id'];
}
$notices .= Html::rawElement(
'li',
array(
'class' => $class,
'data-notification-category' => $row['category'],
'data-notification-event' => $row['id'],
'data-notification-type' => $row['type']
),
$row['*']
);
}
$html = Html::rawElement( 'ul', array( 'id' => 'mw-echo-special-container' ), $notices );
// Build the more link
if ( $nextContinue ) {
$html .= Html::element(
'a',
array(
'href' => SpecialPage::getTitleFor( 'Notifications' )->getLinkURL(
array( 'continue' => $nextContinue )
),
'id' => 'mw-echo-more'
),
$this->msg( 'moredotdotdot' )->text()
);
}
$out->addHTML( $html );
$out->addModules( 'ext.echo.special' );
$out->addJsConfigVars(
array(
'wgEchoDisplayNum' => self::$displayNum,
'wgEchoNextContinue' => $nextContinue,
'wgEchoDateHeader' => $dateHeader
)
);
// For no-js support
global $wgExtensionAssetsPath;
$out->addExtensionStyle( "$wgExtensionAssetsPath/Echo/modules/base/ext.echo.base.css" );
// Mark items as read
if ( $unread ) {
MWEchoNotifUser::newFromUser( $user )->markRead( $unread );
}
}
/**
* Build the subtitle (more info and preference links)
* @return string HTML for the subtitle
*/
public function buildSubtitle() {
global $wgEchoHelpPage;
$lang = $this->getLanguage();
$subtitleLinks = array();
// More info link
$subtitleLinks[] = Html::rawElement(
'a',
array(
'href' => $wgEchoHelpPage,
'id' => 'mw-echo-moreinfo-link',
'class' => 'mw-echo-special-header-link',
'title' => $this->msg( 'echo-more-info' )->text(),
'target' => '_blank'
),
$this->msg( 'echo-more-info' )->text()
);
// Preferences link
$subtitleLinks[] = Html::rawElement(
'a',
array(
'href' => SpecialPage::getTitleFor( 'Preferences' )->getLinkURL() . '#mw-prefsection-echo',
'id' => 'mw-echo-pref-link',
'class' => 'mw-echo-special-header-link',
'title' => $this->msg( 'preferences' )->text()
),
$this->msg( 'preferences' )->text()
);
return $lang->pipeList( $subtitleLinks );
}
}