HistoryAction.php

Go to the documentation of this file.

<?php
use MediaWiki\MediaWikiServices;
use Wikimedia\Rdbms\ResultWrapper;
use Wikimedia\Rdbms\FakeResultWrapper;
 
class HistoryAction extends FormlessAction {
    const DIR_PREV = 0;
    const DIR_NEXT = 1;
 
    public $message;
 
    public function getName() {
        return 'history';
    }
 
    public function requiresWrite() {
        return false;
    }
 
    public function requiresUnblock() {
        return false;
    }
 
    protected function getPageTitle() {
        return $this->msg( 'history-title', $this->getTitle()->getPrefixedText() )->text();
    }
 
    protected function getDescription() {
        // Creation of a subtitle link pointing to [[Special:Log]]
        $linkRenderer = MediaWikiServices::getInstance()->getLinkRenderer();
        $subtitle = $linkRenderer->makeKnownLink(
            SpecialPage::getTitleFor( 'Log' ),
            $this->msg( 'viewpagelogs' )->text(),
            [],
            [ 'page' => $this->getTitle()->getPrefixedText() ]
        );
 
        $links = [];
        // Allow extensions to add more links
        Hooks::run( 'HistoryPageToolLinks', [ $this->getContext(), $linkRenderer, &$links ] );
        if ( $links ) {
            $subtitle .= ''
                . $this->msg( 'word-separator' )->escaped()
                . $this->msg( 'parentheses' )
                    ->rawParams( $this->getLanguage()->pipeList( $links ) )
                    ->escaped();
        }
        return Html::rawElement( 'div', [ 'class' => 'mw-history-subtitle' ], $subtitle );
    }
 
    public function getArticle() {
        return $this->page;
    }
 
    private function preCacheMessages() {
        // Precache various messages
        if ( !isset( $this->message ) ) {
            $msgs = [ 'cur', 'last', 'pipe-separator' ];
            foreach ( $msgs as $msg ) {
                $this->message[$msg] = $this->msg( $msg )->escaped();
            }
        }
    }
 
    function onView() {
        $out = $this->getOutput();
        $request = $this->getRequest();
 
        if ( $out->checkLastModified( $this->page->getTouched() ) ) {
            return; // Client cache fresh and headers sent, nothing more to do.
        }
 
        $this->preCacheMessages();
        $config = $this->context->getConfig();
 
        # Fill in the file cache if not set already
        if ( HTMLFileCache::useFileCache( $this->getContext() ) ) {
            $cache = new HTMLFileCache( $this->getTitle(), 'history' );
            if ( !$cache->isCacheGood( /* Assume up to date */ ) ) {
                ob_start( [ &$cache, 'saveToFileCache' ] );
            }
        }
 
        // Setup page variables.
        $out->setFeedAppendQuery( 'action=history' );
        $out->addModules( 'mediawiki.action.history' );
        $out->addModuleStyles( [
            'mediawiki.interface.helpers.styles',
            'mediawiki.action.history.styles',
            'mediawiki.special.changeslist',
        ] );
        if ( $config->get( 'UseMediaWikiUIEverywhere' ) ) {
            $out = $this->getOutput();
            $out->addModuleStyles( [
                'mediawiki.ui.input',
                'mediawiki.ui.checkbox',
            ] );
        }
 
        // Handle atom/RSS feeds.
        $feedType = $request->getVal( 'feed' );
        if ( $feedType ) {
            $this->feed( $feedType );
 
            return;
        }
 
        $this->addHelpLink( '//meta.wikimedia.org/wiki/Special:MyLanguage/Help:Page_history', true );
 
        // Fail nicely if article doesn't exist.
        if ( !$this->page->exists() ) {
            global $wgSend404Code;
            if ( $wgSend404Code ) {
                $out->setStatusCode( 404 );
            }
            $out->addWikiMsg( 'nohistory' );
 
            $dbr = wfGetDB( DB_REPLICA );
 
            # show deletion/move log if there is an entry
            LogEventsList::showLogExtract(
                $out,
                [ 'delete', 'move', 'protect' ],
                $this->getTitle(),
                '',
                [ 'lim' => 10,
                    'conds' => [ 'log_action != ' . $dbr->addQuotes( 'revision' ) ],
                    'showIfEmpty' => false,
                    'msgKey' => [ 'moveddeleted-notice' ]
                ]
            );
 
            return;
        }
 
        $year = $request->getInt( 'year' );
        $month = $request->getInt( 'month' );
        $tagFilter = $request->getVal( 'tagfilter' );
        $tagSelector = ChangeTags::buildTagFilterSelector( $tagFilter, false, $this->getContext() );
 
        if ( $request->getBool( 'deleted' ) ) {
            $conds = [ 'rev_deleted != 0' ];
        } else {
            $conds = [];
        }
        if ( $this->getUser()->isAllowed( 'deletedhistory' ) ) {
            $checkDeleted = Xml::checkLabel( $this->msg( 'history-show-deleted' )->text(),
                'deleted', 'mw-show-deleted-only', $request->getBool( 'deleted' ) ) . "\n";
        } else {
            $checkDeleted = '';
        }
 
        // Add the general form
        $action = htmlspecialchars( wfScript() );
        $content = Html::hidden( 'title', $this->getTitle()->getPrefixedDBkey() ) . "\n";
        $content .= Html::hidden( 'action', 'history' ) . "\n";
        $content .= Xml::dateMenu(
            ( $year == null ? MWTimestamp::getLocalInstance()->format( 'Y' ) : $year ),
            $month
        ) . "\u{00A0}";
        $content .= $tagSelector ? ( implode( "\u{00A0}", $tagSelector ) . "\u{00A0}" ) : '';
        $content .= $checkDeleted . Html::submitButton(
            $this->msg( 'historyaction-submit' )->text(),
            [],
            [ 'mw-ui-progressive' ]
        );
        $out->addHTML(
            "<form action=\"$action\" method=\"get\" id=\"mw-history-searchform\">" .
            Xml::fieldset(
                $this->msg( 'history-fieldset-title' )->text(),
                $content,
                [ 'id' => 'mw-history-search' ]
            ) .
            '</form>'
        );
 
        Hooks::run( 'PageHistoryBeforeList', [ &$this->page, $this->getContext() ] );
 
        // Create and output the list.
        $pager = new HistoryPager( $this, $year, $month, $tagFilter, $conds );
        $out->addHTML(
            $pager->getNavigationBar() .
            $pager->getBody() .
            $pager->getNavigationBar()
        );
        $out->preventClickjacking( $pager->getPreventClickjacking() );
    }
 
    function fetchRevisions( $limit, $offset, $direction ) {
        // Fail if article doesn't exist.
        if ( !$this->getTitle()->exists() ) {
            return new FakeResultWrapper( [] );
        }
 
        $dbr = wfGetDB( DB_REPLICA );
 
        if ( $direction === self::DIR_PREV ) {
            list( $dirs, $oper ) = [ "ASC", ">=" ];
        } else { /* $direction === self::DIR_NEXT */
            list( $dirs, $oper ) = [ "DESC", "<=" ];
        }
 
        if ( $offset ) {
            $offsets = [ "rev_timestamp $oper " . $dbr->addQuotes( $dbr->timestamp( $offset ) ) ];
        } else {
            $offsets = [];
        }
 
        $page_id = $this->page->getId();
 
        $revQuery = Revision::getQueryInfo();
        return $dbr->select(
            $revQuery['tables'],
            $revQuery['fields'],
            array_merge( [ 'rev_page' => $page_id ], $offsets ),
            __METHOD__,
            [
                'ORDER BY' => "rev_timestamp $dirs",
                'USE INDEX' => [ 'revision' => 'page_timestamp' ],
                'LIMIT' => $limit
            ],
            $revQuery['joins']
        );
    }
 
    function feed( $type ) {
        if ( !FeedUtils::checkFeedOutput( $type ) ) {
            return;
        }
        $request = $this->getRequest();
 
        $feedClasses = $this->context->getConfig()->get( 'FeedClasses' );
        $feed = new $feedClasses[$type](
            $this->getTitle()->getPrefixedText() . ' - ' .
            $this->msg( 'history-feed-title' )->inContentLanguage()->text(),
            $this->msg( 'history-feed-description' )->inContentLanguage()->text(),
            $this->getTitle()->getFullURL( 'action=history' )
        );
 
        // Get a limit on number of feed entries. Provide a sane default
        // of 10 if none is defined (but limit to $wgFeedLimit max)
        $limit = $request->getInt( 'limit', 10 );
        $limit = min(
            max( $limit, 1 ),
            $this->context->getConfig()->get( 'FeedLimit' )
        );
 
        $items = $this->fetchRevisions( $limit, 0, self::DIR_NEXT );
 
        // Generate feed elements enclosed between header and footer.
        $feed->outHeader();
        if ( $items->numRows() ) {
            foreach ( $items as $row ) {
                $feed->outItem( $this->feedItem( $row ) );
            }
        } else {
            $feed->outItem( $this->feedEmpty() );
        }
        $feed->outFooter();
    }
 
    function feedEmpty() {
        return new FeedItem(
            $this->msg( 'nohistory' )->inContentLanguage()->text(),
            $this->msg( 'history-feed-empty' )->inContentLanguage()->parseAsBlock(),
            $this->getTitle()->getFullURL(),
            wfTimestamp( TS_MW ),
            '',
            $this->getTitle()->getTalkPage()->getFullURL()
        );
    }
 
    function feedItem( $row ) {
        $rev = new Revision( $row, 0, $this->getTitle() );
 
        $text = FeedUtils::formatDiffRow(
            $this->getTitle(),
            $this->getTitle()->getPreviousRevisionID( $rev->getId() ),
            $rev->getId(),
            $rev->getTimestamp(),
            $rev->getComment()
        );
        if ( $rev->getComment() == '' ) {
            $contLang = MediaWikiServices::getInstance()->getContentLanguage();
            $title = $this->msg( 'history-feed-item-nocomment',
                $rev->getUserText(),
                $contLang->timeanddate( $rev->getTimestamp() ),
                $contLang->date( $rev->getTimestamp() ),
                $contLang->time( $rev->getTimestamp() )
            )->inContentLanguage()->text();
        } else {
            $title = $rev->getUserText() .
                $this->msg( 'colon-separator' )->inContentLanguage()->text() .
                FeedItem::stripComment( $rev->getComment() );
        }
 
        return new FeedItem(
            $title,
            $text,
            $this->getTitle()->getFullURL( 'diff=' . $rev->getId() . '&oldid=prev' ),
            $rev->getTimestamp(),
            $rev->getUserText(),
            $this->getTitle()->getTalkPage()->getFullURL()
        );
    }
}