RedirectSpecialPage.php

Go to the documentation of this file.

<?php
abstract class RedirectSpecialPage extends UnlistedSpecialPage {
    // Query parameters that can be passed through redirects
    protected $mAllowedRedirectParams = array();
 
    // Query parameters added by redirects
    protected $mAddedRedirectParams = array();
 
    public function execute( $par ) {
        $redirect = $this->getRedirect( $par );
        $query = $this->getRedirectQuery();
        // Redirect to a page title with possible query parameters
        if ( $redirect instanceof Title ) {
            $url = $redirect->getFullURL( $query );
            $this->getOutput()->redirect( $url );
 
            return $redirect;
        } elseif ( $redirect === true ) {
            // Redirect to index.php with query parameters
            $url = wfAppendQuery( wfScript( 'index' ), $query );
            $this->getOutput()->redirect( $url );
 
            return $redirect;
        } else {
            $class = get_class( $this );
            throw new MWException( "RedirectSpecialPage $class doesn't redirect!" );
        }
    }
 
    abstract public function getRedirect( $par );
 
    public function getRedirectQuery() {
        $params = array();
 
        foreach ( $this->mAllowedRedirectParams as $arg ) {
            if ( $this->getRequest()->getVal( $arg, null ) !== null ) {
                $params[$arg] = $this->getRequest()->getVal( $arg );
            }
        }
 
        foreach ( $this->mAddedRedirectParams as $arg => $val ) {
            $params[$arg] = $val;
        }
 
        return count( $params )
            ? $params
            : false;
    }
}
 
abstract class SpecialRedirectToSpecial extends RedirectSpecialPage {
    protected $redirName;
 
    protected $redirSubpage;
 
    function __construct(
        $name, $redirName, $redirSubpage = false,
        $allowedRedirectParams = array(), $addedRedirectParams = array()
    ) {
        parent::__construct( $name );
        $this->redirName = $redirName;
        $this->redirSubpage = $redirSubpage;
        $this->mAllowedRedirectParams = $allowedRedirectParams;
        $this->mAddedRedirectParams = $addedRedirectParams;
    }
 
    public function getRedirect( $subpage ) {
        if ( $this->redirSubpage === false ) {
            return SpecialPage::getTitleFor( $this->redirName, $subpage );
        } else {
            return SpecialPage::getTitleFor( $this->redirName, $this->redirSubpage );
        }
    }
}
 
abstract class RedirectSpecialArticle extends RedirectSpecialPage {
    function __construct( $name ) {
        parent::__construct( $name );
        $redirectParams = array(
            'action',
            'redirect', 'rdfrom',
            # Options for preloaded edits
            'preload', 'editintro', 'preloadtitle', 'summary', 'nosummary',
            # Options for overriding user settings
            'preview', 'internaledit', 'externaledit', 'mode', 'minor', 'watchthis',
            # Options for history/diffs
            'section', 'oldid', 'diff', 'dir',
            'limit', 'offset', 'feed',
            # Misc options
            'redlink', 'debug',
            # Options for action=raw; missing ctype can break JS or CSS in some browsers
            'ctype', 'maxage', 'smaxage',
        );
 
        wfRunHooks( "RedirectSpecialArticleRedirectParams", array( &$redirectParams ) );
        $this->mAllowedRedirectParams = $redirectParams;
    }
}