mediawiki-extensions-Echo/includes/special/SpecialNotifications.php

<?php

class SpecialNotifications extends SpecialPage {

	/**
	 * Number of notification records to display per page/load
	 */
	const DISPLAY_NUM = 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() ) {
			// Redirect to login page and inform user of the need to login
			$this->requireLogin( 'echo-notification-loginrequired' );
			return;
		}

		$out->addSubtitle( $this->buildSubtitle() );

		$out->enableOOUI();

		// 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 = array();
		$notificationMapper = new EchoNotificationMapper();

		$attributeManager = EchoAttributeManager::newFromGlobalVars();
		$notifications = $notificationMapper->fetchByUser(
			$user,
			/* $limit = */self::DISPLAY_NUM + 1,
			$continue,
			$attributeManager->getUserEnabledEvents( $user, 'web' )
		);

		// If there are no notifications, display a message saying so
		if ( !$notifications ) {
			$out->addWikiMsg( 'echo-none' );

			return;
		}

		foreach ( $notifications as $notification ) {
			$output = EchoDataOutputFormatter::formatOutput( $notification, 'special', $user, $this->getLanguage() );
			if ( $output ) {
				$notif[] = $output;
			}
		}

		// Check if there is more data to load for next request
		if ( count( $notifications ) > self::DISPLAY_NUM ) {
			$lastItem = array_pop( $notif );
			$nextContinue = $lastItem['timestamp']['utcunix'] . '|' . $lastItem['id'];
		} else {
			$nextContinue = null;
		}

		// Add the notifications to the page (interspersed with date headers)
		$dateHeader = '';
		$unread = array();
		$echoSeenTime = EchoSeenTime::newFromUser( $user );
		$seenTime = $echoSeenTime->getTime();
		$notifArray = array();
		foreach ( $notif as $row ) {
			$class = 'mw-echo-notification';
			if ( !isset( $row['read'] ) ) {
				$class .= ' mw-echo-notification-unread';
				if ( !$row['targetpages'] ) {
					$unread[] = $row['id'];
				}
			}

			if ( $seenTime !== null && $row['timestamp']['mw'] > $seenTime ) {
				$class .= ' mw-echo-notification-unseen';
			}

			if ( !$row['*'] ) {
				continue;
			}

			// Output the date header if it has not been displayed
			if ( $dateHeader !== $row['timestamp']['date'] ) {
				$dateHeader = $row['timestamp']['date'];
				$notifArray[ $dateHeader ] = array(
					'unread' => array(),
					'notices' => array()
				);
			}

			// Collect unread IDs
			if ( !isset( $row['read'] ) ) {
				$notifArray[ $dateHeader ][ 'unread' ][] = $row['id'];
			}

			$notifArray[ $dateHeader ][ 'notices' ][] = Html::rawElement(
				'li',
				array(
					'class' => $class,
					'data-notification-category' => $row['category'],
					'data-notification-event' => $row['id'],
					'data-notification-type' => $row['type']
				),
				$row['*']
			);
		}

		// Build the HTML
		$notices = '';
		$markReadSpecialPage = SpecialPage::getTitleFor( 'NotificationsMarkRead' );
		foreach ( $notifArray as $section => $data ) {
			$sectionTitle = Html::element( 'span', array( 'class' => 'mw-echo-date-section-text' ), $section );
			if ( count( $data[ 'unread' ] ) > 0 ) {
				// There are unread notices. Add the 'mark section as read' button
				$markSectionAsReadButton = new OOUI\ButtonWidget( array(
					'label' => $this->msg( 'echo-specialpage-section-markread' )->text(),
					'href' => $markReadSpecialPage->getLocalURL() . '/' . join( ',', $data[ 'unread' ] ),
					'classes' => array( 'mw-echo-markAsReadSectionButton' ),
				) );
				$sectionTitle .= $markSectionAsReadButton;
			}

			// Heading
			$notices .= Html::rawElement( 'li', array( 'class' => 'mw-echo-date-section' ), $sectionTitle );

			// Notices
			$notices .= join( "\n", $data[ 'notices' ] );
		}

		$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 )
					),
					'class' => 'mw-ui-button mw-ui-primary',
					'id' => 'mw-echo-more'
				),
				$this->msg( 'moredotdotdot' )->text()
			);
		}

		$out->addHTML( $html );
		$out->addJsConfigVars(
			array(
				'wgEchoDisplayNum' => self::DISPLAY_NUM,
				'wgEchoNextContinue' => $nextContinue,
				'wgEchoDateHeader' => $dateHeader
			)
		);
		// For no-js support
		$out->addModuleStyles( array( 'ext.echo.styles.notifications', 'ext.echo.styles.special' ) );
	}

	/**
	 * 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::element(
			'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::element(
			'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 );
	}

	protected function getGroupName() {
		return 'users';
	}
}