setContext( $obj ); $this->skin = $obj->getSkin(); } else { $this->setContext( $obj->getContext() ); $this->skin = $obj; } $this->preCacheMessages(); } /** * Fetch an appropriate changes list class for the main context * This first argument used to be an User object. * * @deprecated in 1.18; use newFromContext() instead * @param string|User $unused Unused * @return ChangesList|EnhancedChangesList|OldChangesList derivative */ public static function newFromUser( $unused ) { wfDeprecated( __METHOD__, '1.18' ); return self::newFromContext( RequestContext::getMain() ); } /** * Fetch an appropriate changes list class for the specified context * Some users might want to use an enhanced list format, for instance * * @param $context IContextSource to use * @return ChangesList|EnhancedChangesList|OldChangesList derivative */ public static function newFromContext( IContextSource $context ) { $user = $context->getUser(); $sk = $context->getSkin(); $list = null; if ( wfRunHooks( 'FetchChangesList', array( $user, &$sk, &$list ) ) ) { $new = $context->getRequest()->getBool( 'enhanced', $user->getOption( 'usenewrc' ) ); return $new ? new EnhancedChangesList( $context ) : new OldChangesList( $context ); } else { return $list; } } /** * Sets the list to use a "

" tag * @param $value Boolean */ public function setWatchlistDivs( $value = true ) { $this->watchlist = $value; } /** * As we use the same small set of messages in various methods and that * they are called often, we call them once and save them in $this->message */ private function preCacheMessages() { if ( !isset( $this->message ) ) { foreach ( array( 'cur', 'diff', 'hist', 'enhancedrc-history', 'last', 'blocklink', 'history', 'semicolon-separator', 'pipe-separator' ) as $msg ) { $this->message[$msg] = $this->msg( $msg )->escaped(); } } } /** * Returns the appropriate flags for new page, minor change and patrolling * @param array $flags Associative array of 'flag' => Bool * @param string $nothing to use for empty space * @return String */ public function recentChangesFlags( $flags, $nothing = ' ' ) { global $wgRecentChangesFlags; $f = ''; foreach ( array_keys( $wgRecentChangesFlags ) as $flag ) { $f .= isset( $flags[$flag] ) && $flags[$flag] ? self::flag( $flag ) : $nothing; } return $f; } /** * Provide the "" element appropriate to a given abbreviated flag, * namely the flag indicating a new page, a minor edit, a bot edit, or an * unpatrolled edit. By default in English it will contain "N", "m", "b", * "!" respectively, plus it will have an appropriate title and class. * * @param string $flag One key of $wgRecentChangesFlags * @return String: Raw HTML */ public static function flag( $flag ) { static $flagInfos = null; if ( is_null( $flagInfos ) ) { global $wgRecentChangesFlags; $flagInfos = array(); foreach ( $wgRecentChangesFlags as $key => $value ) { $flagInfos[$key]['letter'] = wfMessage( $value['letter'] )->escaped(); $flagInfos[$key]['title'] = wfMessage( $value['title'] )->escaped(); // Allow customized class name, fall back to flag name $flagInfos[$key]['class'] = Sanitizer::escapeClass( isset( $value['class'] ) ? $value['class'] : $key ); } } // Inconsistent naming, bleh, kepted for b/c $map = array( 'minoredit' => 'minor', 'botedit' => 'bot', ); if ( isset( $map[$flag] ) ) { $flag = $map[$flag]; } return "" . $flagInfos[$flag]['letter'] . ''; } /** * Returns text for the start of the tabular part of RC * @return String */ public function beginRecentChangesList() { $this->rc_cache = array(); $this->rcMoveIndex = 0; $this->rcCacheIndex = 0; $this->lastdate = ''; $this->rclistOpen = false; $this->getOutput()->addModuleStyles( 'mediawiki.special.changeslist' ); return ''; } /** * Show formatted char difference * @param $old Integer: bytes * @param $new Integer: bytes * @param $context IContextSource context to use * @return String */ public static function showCharacterDifference( $old, $new, IContextSource $context = null ) { global $wgRCChangedSizeThreshold, $wgMiserMode; if ( !$context ) { $context = RequestContext::getMain(); } $new = (int)$new; $old = (int)$old; $szdiff = $new - $old; $lang = $context->getLanguage(); $code = $lang->getCode(); static $fastCharDiff = array(); if ( !isset( $fastCharDiff[$code] ) ) { $fastCharDiff[$code] = $wgMiserMode || $context->msg( 'rc-change-size' )->plain() === '$1'; } $formattedSize = $lang->formatNum( $szdiff ); if ( !$fastCharDiff[$code] ) { $formattedSize = $context->msg( 'rc-change-size', $formattedSize )->text(); } if ( abs( $szdiff ) > abs( $wgRCChangedSizeThreshold ) ) { $tag = 'strong'; } else { $tag = 'span'; } if ( $szdiff === 0 ) { $formattedSizeClass = 'mw-plusminus-null'; } if ( $szdiff > 0 ) { $formattedSize = '+' . $formattedSize; $formattedSizeClass = 'mw-plusminus-pos'; } if ( $szdiff < 0 ) { $formattedSizeClass = 'mw-plusminus-neg'; } $formattedTotalSize = $context->msg( 'rc-change-size-new' )->numParams( $new )->text(); return Html::element( $tag, array( 'dir' => 'ltr', 'class' => $formattedSizeClass, 'title' => $formattedTotalSize ), $context->msg( 'parentheses', $formattedSize )->plain() ) . $lang->getDirMark(); } /** * Format the character difference of one or several changes. * * @param $old RecentChange * @param $new RecentChange last change to use, if not provided, $old will be used * @return string HTML fragment */ public function formatCharacterDifference( RecentChange $old, RecentChange $new = null ) { $oldlen = $old->mAttribs['rc_old_len']; if ( $new ) { $newlen = $new->mAttribs['rc_new_len']; } else { $newlen = $old->mAttribs['rc_new_len']; } if ( $oldlen === null || $newlen === null ) { return ''; } return self::showCharacterDifference( $oldlen, $newlen, $this->getContext() ); } /** * Returns text for the end of RC * @return String */ public function endRecentChangesList() { if ( $this->rclistOpen ) { return "\n"; } else { return ''; } } /** * @param string $s HTML to update * @param $rc_timestamp mixed */ public function insertDateHeader( &$s, $rc_timestamp ) { # Make date header if necessary $date = $this->getLanguage()->userDate( $rc_timestamp, $this->getUser() ); if ( $date != $this->lastdate ) { if ( $this->lastdate != '' ) { $s .= "\n"; } $s .= Xml::element( 'h4', null, $date ) . "\n

"; $this->lastdate = $date; $this->rclistOpen = true; } } /** * @param string $s HTML to update * @param $title Title * @param $logtype string */ public function insertLog( &$s, $title, $logtype ) { $page = new LogPage( $logtype ); $logname = $page->getName()->escaped(); $s .= $this->msg( 'parentheses' )->rawParams( Linker::linkKnown( $title, $logname ) )->escaped(); } /** * @param string $s HTML to update * @param $rc RecentChange * @param $unpatrolled */ public function insertDiffHist( &$s, &$rc, $unpatrolled ) { # Diff link if ( $rc->mAttribs['rc_type'] == RC_NEW || $rc->mAttribs['rc_type'] == RC_LOG ) { $diffLink = $this->message['diff']; } elseif ( !self::userCan( $rc, Revision::DELETED_TEXT, $this->getUser() ) ) { $diffLink = $this->message['diff']; } else { $query = array( 'curid' => $rc->mAttribs['rc_cur_id'], 'diff' => $rc->mAttribs['rc_this_oldid'], 'oldid' => $rc->mAttribs['rc_last_oldid'] ); $diffLink = Linker::linkKnown( $rc->getTitle(), $this->message['diff'], array( 'tabindex' => $rc->counter ), $query ); } $diffhist = $diffLink . $this->message['pipe-separator']; # History link $diffhist .= Linker::linkKnown( $rc->getTitle(), $this->message['hist'], array(), array( 'curid' => $rc->mAttribs['rc_cur_id'], 'action' => 'history' ) ); $s .= $this->msg( 'parentheses' )->rawParams( $diffhist )->escaped() . ' . . '; } /** * @param string $s HTML to update * @param $rc RecentChange * @param $unpatrolled * @param $watched */ public function insertArticleLink( &$s, &$rc, $unpatrolled, $watched ) { $params = array(); $articlelink = Linker::linkKnown( $rc->getTitle(), null, array( 'class' => 'mw-changeslist-title' ), $params ); if ( $this->isDeleted( $rc, Revision::DELETED_TEXT ) ) { $articlelink = '' . $articlelink . ''; } # To allow for boldening pages watched by this user $articlelink = "{$articlelink}"; # RTL/LTR marker $articlelink .= $this->getLanguage()->getDirMark(); wfRunHooks( 'ChangesListInsertArticleLink', array( &$this, &$articlelink, &$s, &$rc, $unpatrolled, $watched ) ); $s .= " $articlelink"; } /** * Get the timestamp from $rc formatted with current user's settings * and a separator * * @param $rc RecentChange * @return string HTML fragment */ public function getTimestamp( $rc ) { return $this->message['semicolon-separator'] . '' . $this->getLanguage()->userTime( $rc->mAttribs['rc_timestamp'], $this->getUser() ) . ' . . '; } /** * Insert time timestamp string from $rc into $s * * @param string $s HTML to update * @param $rc RecentChange */ public function insertTimestamp( &$s, $rc ) { $s .= $this->getTimestamp( $rc ); } /** * Insert links to user page, user talk page and eventually a blocking link * * @param &$s String HTML to update * @param &$rc RecentChange */ public function insertUserRelatedLinks( &$s, &$rc ) { if ( $this->isDeleted( $rc, Revision::DELETED_USER ) ) { $s .= ' ' . $this->msg( 'rev-deleted-user' )->escaped() . ''; } else { $s .= $this->getLanguage()->getDirMark() . Linker::userLink( $rc->mAttribs['rc_user'], $rc->mAttribs['rc_user_text'] ); $s .= Linker::userToolLinks( $rc->mAttribs['rc_user'], $rc->mAttribs['rc_user_text'] ); } } /** * Insert a formatted action * * @param $rc RecentChange * @return string */ public function insertLogEntry( $rc ) { $formatter = LogFormatter::newFromRow( $rc->mAttribs ); $formatter->setContext( $this->getContext() ); $formatter->setShowUserToolLinks( true ); $mark = $this->getLanguage()->getDirMark(); return $formatter->getActionText() . " $mark" . $formatter->getComment(); } /** * Insert a formatted comment * @param $rc RecentChange * @return string */ public function insertComment( $rc ) { if ( $rc->mAttribs['rc_type'] != RC_MOVE && $rc->mAttribs['rc_type'] != RC_MOVE_OVER_REDIRECT ) { if ( $this->isDeleted( $rc, Revision::DELETED_COMMENT ) ) { return ' ' . $this->msg( 'rev-deleted-comment' )->escaped() . ''; } else { return Linker::commentBlock( $rc->mAttribs['rc_comment'], $rc->getTitle() ); } } return ''; } /** * Check whether to enable recent changes patrol features * * @deprecated since 1.22 * @return Boolean */ public static function usePatrol() { global $wgUser; wfDeprecated( __METHOD__, '1.22' ); return $wgUser->useRCPatrol(); } /** * Returns the string which indicates the number of watching users * @return string */ protected function numberofWatchingusers( $count ) { static $cache = array(); if ( $count > 0 ) { if ( !isset( $cache[$count] ) ) { $cache[$count] = $this->msg( 'number_of_watching_users_RCview' )->numParams( $count )->escaped(); } return $cache[$count]; } else { return ''; } } /** * Determine if said field of a revision is hidden * @param $rc RCCacheEntry * @param $field Integer: one of DELETED_* bitfield constants * @return Boolean */ public static function isDeleted( $rc, $field ) { return ( $rc->mAttribs['rc_deleted'] & $field ) == $field; } /** * Determine if the current user is allowed to view a particular * field of this revision, if it's marked as deleted. * @param $rc RCCacheEntry * @param $field Integer * @param $user User object to check, or null to use $wgUser * @return Boolean */ public static function userCan( $rc, $field, User $user = null ) { if ( $rc->mAttribs['rc_type'] == RC_LOG ) { return LogEventsList::userCanBitfield( $rc->mAttribs['rc_deleted'], $field, $user ); } else { return Revision::userCanBitfield( $rc->mAttribs['rc_deleted'], $field, $user ); } } /** * @param $link string * @param $watched bool * @return string */ protected function maybeWatchedLink( $link, $watched = false ) { if ( $watched ) { return '' . $link . ''; } else { return '' . $link . ''; } } /** Inserts a rollback link * * @param $s string * @param $rc RecentChange */ public function insertRollback( &$s, &$rc ) { if ( $rc->mAttribs['rc_type'] == RC_EDIT && $rc->mAttribs['rc_this_oldid'] && $rc->mAttribs['rc_cur_id'] ) { $page = $rc->getTitle(); /** Check for rollback and edit permissions, disallow special pages, and only * show a link on the top-most revision */ if ( $this->getUser()->isAllowed( 'rollback' ) && $rc->mAttribs['page_latest'] == $rc->mAttribs['rc_this_oldid'] ) { $rev = new Revision( array( 'title' => $page, 'id' => $rc->mAttribs['rc_this_oldid'], 'user' => $rc->mAttribs['rc_user'], 'user_text' => $rc->mAttribs['rc_user_text'], 'deleted' => $rc->mAttribs['rc_deleted'] ) ); $s .= ' ' . Linker::generateRollback( $rev, $this->getContext() ); } } } /** * @param $s string * @param $rc RecentChange * @param $classes */ public function insertTags( &$s, &$rc, &$classes ) { if ( empty( $rc->mAttribs['ts_tags'] ) ) { return; } list( $tagSummary, $newClasses ) = ChangeTags::formatSummaryRow( $rc->mAttribs['ts_tags'], 'changeslist' ); $classes = array_merge( $classes, $newClasses ); $s .= ' ' . $tagSummary; } public function insertExtra( &$s, &$rc, &$classes ) { // Empty, used for subclasses to add anything special. } protected function showAsUnpatrolled( RecentChange $rc ) { $unpatrolled = false; if ( !$rc->mAttribs['rc_patrolled'] ) { if ( $this->getUser()->useRCPatrol() ) { $unpatrolled = true; } elseif ( $this->getUser()->useNPPatrol() && $rc->mAttribs['rc_type'] == RC_NEW ) { $unpatrolled = true; } } return $unpatrolled; } }