'; } /** * Format a line for enhanced recentchange (aka with javascript and block of lines). * * @param RecentChange $baseRC * @param bool $watched * * @return string */ public function recentChangesLine( &$baseRC, $watched = false ) { $date = $this->getLanguage()->userDate( $baseRC->mAttribs['rc_timestamp'], $this->getUser() ); $ret = ''; # If it's a new day, add the headline and flush the cache if ( $date != $this->lastdate ) { # Process current cache $ret = $this->recentChangesBlock(); $this->rc_cache = array(); $ret .= Xml::element( 'h4', null, $date ) . "\n"; $this->lastdate = $date; } $cacheEntry = $this->cacheEntryFactory->newFromRecentChange( $baseRC, $watched ); $this->addCacheEntry( $cacheEntry ); return $ret; } /** * Put accumulated information into the cache, for later display. * Page moves go on their own line. * * @param RCCacheEntry $cacheEntry */ protected function addCacheEntry( RCCacheEntry $cacheEntry ) { $cacheGroupingKey = $this->makeCacheGroupingKey( $cacheEntry ); if ( !isset( $this->rc_cache[$cacheGroupingKey] ) ) { $this->rc_cache[$cacheGroupingKey] = array(); } array_push( $this->rc_cache[$cacheGroupingKey], $cacheEntry ); } /** * @todo use rc_source to group, if set; fallback to rc_type * * @param RCCacheEntry $cacheEntry * * @return string */ protected function makeCacheGroupingKey( RCCacheEntry $cacheEntry ) { $title = $cacheEntry->getTitle(); $cacheGroupingKey = $title->getPrefixedDBkey(); $type = $cacheEntry->mAttribs['rc_type']; if ( $type == RC_LOG ) { // Group by log type $cacheGroupingKey = SpecialPage::getTitleFor( 'Log', $cacheEntry->mAttribs['rc_log_type'] )->getPrefixedDBkey(); } return $cacheGroupingKey; } /** * Enhanced RC group * @param RCCacheEntry[] $block * @return string */ protected function recentChangesBlockGroup( $block ) { # Add the namespace and title of the block as part of the class $classes = array( 'mw-collapsible', 'mw-collapsed', 'mw-enhanced-rc' ); if ( $block[0]->mAttribs['rc_log_type'] ) { # Log entry $classes[] = Sanitizer::escapeClass( 'mw-changeslist-log-' . $block[0]->mAttribs['rc_log_type'] ); } else { $classes[] = Sanitizer::escapeClass( 'mw-changeslist-ns' . $block[0]->mAttribs['rc_namespace'] . '-' . $block[0]->mAttribs['rc_title'] ); } $classes[] = $block[0]->watched && $block[0]->mAttribs['rc_timestamp'] >= $block[0]->watched ? 'mw-changeslist-line-watched' : 'mw-changeslist-line-not-watched'; $r = Html::openElement( 'table', array( 'class' => $classes ) ) . Html::openElement( 'tr' ); # Collate list of users $userlinks = array(); # Other properties $unpatrolled = false; $isnew = false; $allBots = true; $allMinors = true; $curId = 0; # Some catalyst variables... $namehidden = true; $allLogs = true; $RCShowChangedSize = $this->getConfig()->get( 'RCShowChangedSize' ); foreach ( $block as $rcObj ) { if ( $rcObj->mAttribs['rc_type'] == RC_NEW ) { $isnew = true; } // If all log actions to this page were hidden, then don't // give the name of the affected page for this block! if ( !$this->isDeleted( $rcObj, LogPage::DELETED_ACTION ) ) { $namehidden = false; } $u = $rcObj->userlink; if ( !isset( $userlinks[$u] ) ) { $userlinks[$u] = 0; } if ( $rcObj->unpatrolled ) { $unpatrolled = true; } if ( $rcObj->mAttribs['rc_type'] != RC_LOG ) { $allLogs = false; } # Get the latest entry with a page_id and oldid # since logs may not have these. if ( !$curId && $rcObj->mAttribs['rc_cur_id'] ) { $curId = $rcObj->mAttribs['rc_cur_id']; } if ( !$rcObj->mAttribs['rc_bot'] ) { $allBots = false; } if ( !$rcObj->mAttribs['rc_minor'] ) { $allMinors = false; } $userlinks[$u]++; } # Sort the list and convert to text krsort( $userlinks ); asort( $userlinks ); $users = array(); foreach ( $userlinks as $userlink => $count ) { $text = $userlink; $text .= $this->getLanguage()->getDirMark(); if ( $count > 1 ) { // @todo FIXME: Hardcoded '×'. Should be a message. $formattedCount = $this->getLanguage()->formatNum( $count ) . '×'; $text .= ' ' . $this->msg( 'parentheses' )->rawParams( $formattedCount )->escaped(); } array_push( $users, $text ); } $users = ' ' . $this->msg( 'brackets' )->rawParams( implode( $this->message['semicolon-separator'], $users ) )->escaped() . ''; $tl = ''; $r .= "$tl"; # Main line $r .= '' . $this->recentChangesFlags( array( 'newpage' => $isnew, # show, when one have this flag 'minor' => $allMinors, # show only, when all have this flag 'unpatrolled' => $unpatrolled, # show, when one have this flag 'bot' => $allBots, # show only, when all have this flag ) ); # Timestamp $r .= ' ' . $block[0]->timestamp . ' '; # Article link if ( $namehidden ) { $r .= ' ' . $this->msg( 'rev-deleted-event' )->escaped() . ''; } elseif ( $allLogs ) { $r .= $this->maybeWatchedLink( $block[0]->link, $block[0]->watched ); } else { $this->insertArticleLink( $r, $block[0], $block[0]->unpatrolled, $block[0]->watched ); } $r .= $this->getLanguage()->getDirMark(); $queryParams['curid'] = $curId; # Sub-entries $lines = ''; foreach ( $block as $i => $rcObj ) { $line = $this->getLineData( $block, $rcObj, $queryParams ); $lines .= $line; if ( !$line ) { // completely ignore this RC entry if we don't want to render it unset( $block[$i] ); } } // Further down are some assumptions that $block is a 0-indexed array // with (count-1) as last key. Let's make sure it is. $block = array_values( $block ); $r .= $this->getLogText( $block, $queryParams, $allLogs, $isnew, $namehidden ); $r .= ' . . '; # Character difference (does not apply if only log items) if ( $RCShowChangedSize && !$allLogs ) { $last = 0; $first = count( $block ) - 1; # Some events (like logs) have an "empty" size, so we need to skip those... while ( $last < $first && $block[$last]->mAttribs['rc_new_len'] === null ) { $last++; } while ( $first > $last && $block[$first]->mAttribs['rc_old_len'] === null ) { $first--; } # Get net change $chardiff = $this->formatCharacterDifference( $block[$first], $block[$last] ); if ( $chardiff == '' ) { $r .= ' '; } else { $r .= ' ' . $chardiff . ' . . '; } } $r .= $users; $r .= $this->numberofWatchingusers( $block[0]->numberofWatchingusers ); $r .= ''; if ( !$lines ) { // if there are no lines to be rendered (all aborted by hook), don't render the block return ''; } $r .= $lines; $r .= "\n"; $this->rcCacheIndex++; return $r; } /** * @param RCCacheEntry[] $block * @param RCCacheEntry $rcObj * @param array $queryParams * @return string * @throws Exception * @throws FatalError * @throws MWException */ protected function getLineData( array $block, RCCacheEntry $rcObj, array $queryParams = array() ) { $RCShowChangedSize = $this->getConfig()->get( 'RCShowChangedSize' ); # Classes to apply -- TODO implement $classes = array(); $type = $rcObj->mAttribs['rc_type']; $data = array(); $trClass = $rcObj->watched && $rcObj->mAttribs['rc_timestamp'] >= $rcObj->watched ? ' class="mw-enhanced-watched"' : ''; $separator = ' . . '; $data['recentChangesFlags'] = array( 'newpage' => $type == RC_NEW, 'minor' => $rcObj->mAttribs['rc_minor'], 'unpatrolled' => $rcObj->unpatrolled, 'bot' => $rcObj->mAttribs['rc_bot'], ); $params = $queryParams; if ( $rcObj->mAttribs['rc_this_oldid'] != 0 ) { $params['oldid'] = $rcObj->mAttribs['rc_this_oldid']; } # Log timestamp if ( $type == RC_LOG ) { $link = $rcObj->timestamp; # Revision link } elseif ( !ChangesList::userCan( $rcObj, Revision::DELETED_TEXT, $this->getUser() ) ) { $link = '' . $rcObj->timestamp . ' '; } else { $link = Linker::linkKnown( $rcObj->getTitle(), $rcObj->timestamp, array(), $params ); if ( $this->isDeleted( $rcObj, Revision::DELETED_TEXT ) ) { $link = '' . $link . ' '; } } $data['timestampLink'] = $link; $currentAndLastLinks = ''; if ( !$type == RC_LOG || $type == RC_NEW ) { $currentAndLastLinks .= ' ' . $this->msg( 'parentheses' )->rawParams( $rcObj->curlink . $this->message['pipe-separator'] . $rcObj->lastlink )->escaped(); } $data['currentAndLastLinks'] = $currentAndLastLinks; $data['separatorAfterCurrentAndLastLinks'] = $separator; # Character diff if ( $RCShowChangedSize ) { $cd = $this->formatCharacterDifference( $rcObj ); if ( $cd !== '' ) { $data['characterDiff'] = $cd; $data['separatorAfterCharacterDiff'] = $separator; } } if ( $rcObj->mAttribs['rc_type'] == RC_LOG ) { $data['logEntry'] = $this->insertLogEntry( $rcObj ); } else { # User links $data['userLink'] = $rcObj->userlink; $data['userTalkLink'] = $rcObj->usertalklink; $data['comment'] = $this->insertComment( $rcObj ); } # Rollback $data['rollback'] = $this->getRollback( $rcObj ); # Tags $data['tags'] = $this->getTags( $rcObj, $classes ); // give the hook a chance to modify the data $success = Hooks::run( 'EnhancedChangesListModifyLineData', array( $this, &$data, $block, $rcObj ) ); if ( !$success ) { // skip entry if hook aborted it return ''; } $line = ''; if ( isset( $data['recentChangesFlags'] ) ) { $line .= $this->recentChangesFlags( $data['recentChangesFlags'] ); unset( $data['recentChangesFlags'] ); } $line .= ' '; if ( isset( $data['timestampLink'] ) ) { $line .= '' . $data['timestampLink'] . ''; unset( $data['timestampLink'] ); } // everything else: makes it easier for extensions to add or remove data $line .= implode( '', $data ); $line .= "\n"; return $line; } /** * Generates amount of changes (linking to diff ) & link to history. * * @param array $block * @param array $queryParams * @param bool $allLogs * @param bool $isnew * @param bool $namehidden * @return string */ protected function getLogText( $block, $queryParams, $allLogs, $isnew, $namehidden ) { # Changes message static $nchanges = array(); static $sinceLastVisitMsg = array(); $n = count( $block ); if ( !isset( $nchanges[$n] ) ) { $nchanges[$n] = $this->msg( 'nchanges' )->numParams( $n )->escaped(); } $sinceLast = 0; $unvisitedOldid = null; /** @var $rcObj RCCacheEntry */ foreach ( $block as $rcObj ) { // Same logic as below inside main foreach if ( $rcObj->watched && $rcObj->mAttribs['rc_timestamp'] >= $rcObj->watched ) { $sinceLast++; $unvisitedOldid = $rcObj->mAttribs['rc_last_oldid']; } } if ( !isset( $sinceLastVisitMsg[$sinceLast] ) ) { $sinceLastVisitMsg[$sinceLast] = $this->msg( 'enhancedrc-since-last-visit' )->numParams( $sinceLast )->escaped(); } $currentRevision = 0; foreach ( $block as $rcObj ) { if ( !$currentRevision ) { $currentRevision = $rcObj->mAttribs['rc_this_oldid']; } } # Total change link $links = array(); /** @var $block0 RecentChange */ $block0 = $block[0]; $last = $block[count( $block ) - 1]; if ( !$allLogs ) { if ( !ChangesList::userCan( $rcObj, Revision::DELETED_TEXT, $this->getUser() ) ) { $links['total-changes'] = $nchanges[$n]; } elseif ( $isnew ) { $links['total-changes'] = $nchanges[$n]; } else { $links['total-changes'] = Linker::link( $block0->getTitle(), $nchanges[$n], array(), $queryParams + array( 'diff' => $currentRevision, 'oldid' => $last->mAttribs['rc_last_oldid'], ), array( 'known', 'noclasses' ) ); if ( $sinceLast > 0 && $sinceLast < $n ) { $links['total-changes-since-last'] = Linker::link( $block0->getTitle(), $sinceLastVisitMsg[$sinceLast], array(), $queryParams + array( 'diff' => $currentRevision, 'oldid' => $unvisitedOldid, ), array( 'known', 'noclasses' ) ); } } } # History if ( $allLogs ) { // don't show history link for logs } elseif ( $namehidden || !$block0->getTitle()->exists() ) { $links['history'] = $this->message['enhancedrc-history']; } else { $params = $queryParams; $params['action'] = 'history'; $links['history'] = Linker::linkKnown( $block0->getTitle(), $this->message['enhancedrc-history'], array(), $params ); } # Allow others to alter, remove or add to these links Hooks::run( 'EnhancedChangesList::getLogText', array( $this, &$links, $block ) ); if ( !$links ) { return ''; } $logtext = implode( $this->message['pipe-separator'], $links ); $logtext = $this->msg( 'parentheses' )->rawParams( $logtext )->escaped(); return ' ' . $logtext; } /** * Enhanced RC ungrouped line. * * @param RecentChange|RCCacheEntry $rcObj * @return string A HTML formatted line (generated using $r) */ protected function recentChangesBlockLine( $rcObj ) { $data = array(); $query['curid'] = $rcObj->mAttribs['rc_cur_id']; $type = $rcObj->mAttribs['rc_type']; $logType = $rcObj->mAttribs['rc_log_type']; $classes = array( 'mw-enhanced-rc' ); if ( $logType ) { # Log entry $classes[] = Sanitizer::escapeClass( 'mw-changeslist-log-' . $logType ); } else { $classes[] = Sanitizer::escapeClass( 'mw-changeslist-ns' . $rcObj->mAttribs['rc_namespace'] . '-' . $rcObj->mAttribs['rc_title'] ); } $classes[] = $rcObj->watched && $rcObj->mAttribs['rc_timestamp'] >= $rcObj->watched ? 'mw-changeslist-line-watched' : 'mw-changeslist-line-not-watched'; # Flag and Timestamp $data['recentChangesFlags'] = array( 'newpage' => $type == RC_NEW, 'minor' => $rcObj->mAttribs['rc_minor'], 'unpatrolled' => $rcObj->unpatrolled, 'bot' => $rcObj->mAttribs['rc_bot'], ); // timestamp is not really a link here, but is called timestampLink // for consistency with EnhancedChangesListModifyLineData $data['timestampLink'] = $rcObj->timestamp; # Article or log link if ( $logType ) { $logPage = new LogPage( $logType ); $logTitle = SpecialPage::getTitleFor( 'Log', $logType ); $logName = $logPage->getName()->escaped(); $data['logLink'] = $this->msg( 'parentheses' ) ->rawParams( Linker::linkKnown( $logTitle, $logName ) )->escaped(); } else { $data['articleLink'] = $this->getArticleLink( $rcObj, $rcObj->unpatrolled, $rcObj->watched ); } # Diff and hist links if ( $type != RC_LOG ) { $query['action'] = 'history'; $data['historyLink'] = ' ' . $this->msg( 'parentheses' ) ->rawParams( $rcObj->difflink . $this->message['pipe-separator'] . Linker::linkKnown( $rcObj->getTitle(), $this->message['hist'], array(), $query ) )->escaped(); } $data['separatorAfterLinks'] = ' . . '; # Character diff if ( $this->getConfig()->get( 'RCShowChangedSize' ) ) { $cd = $this->formatCharacterDifference( $rcObj ); if ( $cd !== '' ) { $data['characterDiff'] = $cd; $data['separatorAftercharacterDiff'] = ' . . '; } } if ( $type == RC_LOG ) { $data['logEntry'] = $this->insertLogEntry( $rcObj ); } else { $data['userLink'] = $rcObj->userlink; $data['userTalkLink'] = $rcObj->usertalklink; $data['comment'] = $this->insertComment( $rcObj ); $data['rollback'] = $this->getRollback( $rcObj ); } # Tags $data['tags'] = $this->getTags( $rcObj, $classes ); # Show how many people are watching this if enabled $data['watchingUsers'] = $this->numberofWatchingusers( $rcObj->numberofWatchingusers ); // give the hook a chance to modify the data $success = Hooks::run( 'EnhancedChangesListModifyBlockLineData', array( $this, &$data, $rcObj ) ); if ( !$success ) { // skip entry if hook aborted it return ''; } $line = Html::openElement( 'table', array( 'class' => $classes ) ) . Html::openElement( 'tr' ); $line .= ''; if ( isset( $data['recentChangesFlags'] ) ) { $line .= $this->recentChangesFlags( $data['recentChangesFlags'] ); unset( $data['recentChangesFlags'] ); } if ( isset( $data['timestampLink'] ) ) { $line .= ' ' . $data['timestampLink']; unset( $data['timestampLink'] ); } $line .= ' '; // everything else: makes it easier for extensions to add or remove data $line .= implode( '', $data ); $line .= "\n"; return $line; } /** * If enhanced RC is in use, this function takes the previously cached * RC lines, arranges them, and outputs the HTML * * @return string */ protected function recentChangesBlock() { if ( count( $this->rc_cache ) == 0 ) { return ''; } $blockOut = ''; foreach ( $this->rc_cache as $block ) { if ( count( $block ) < 2 ) { $blockOut .= $this->recentChangesBlockLine( array_shift( $block ) ); } else { $blockOut .= $this->recentChangesBlockGroup( $block ); } } return '

' . $blockOut . '

'; } /** * Returns text for the end of RC * If enhanced RC is in use, returns pretty much all the text * @return string */ public function endRecentChangesList() { return $this->recentChangesBlock() . '