$out is needed here
[lhc/web/wiklou.git] / includes / SpecialPage.php
index b09658c..246f80a 100644 (file)
  * @addtogroup SpecialPage
  */
 
-/**
- * @access private
- */
-
 /**
  * Parent special page class, also static functions for handling the special
  * page list.
@@ -72,7 +68,15 @@ class SpecialPage
         * Query parameters that can be passed through redirects
         */
        var $mAllowedRedirectParams = array();
-
+       /**
+        * List of special pages, followed by parameters.
+        * If the only parameter is a string, that is the page name.
+        * Otherwise, it is an array. The format is one of:
+        ** array( 'SpecialPage', name, right )
+        ** array( 'IncludableSpecialPage', name, right, listed? )
+        ** array( 'UnlistedSpecialPage', name, right )
+        ** array( 'SpecialRedirectToSpecial', name, page to redirect to, special page param, ... )
+        */
        static public $mList = array(
                'DoubleRedirects'           => array( 'SpecialPage', 'DoubleRedirects' ),
                'BrokenRedirects'           => array( 'SpecialPage', 'BrokenRedirects' ),
@@ -80,6 +84,7 @@ class SpecialPage
 
                'Userlogin'                 => array( 'SpecialPage', 'Userlogin' ),
                'Userlogout'                => array( 'UnlistedSpecialPage', 'Userlogout' ),
+               'CreateAccount'             => array( 'SpecialRedirectToSpecial', 'CreateAccount', 'Userlogin', 'signup', array( 'uselang' ) ),
                'Preferences'               => array( 'SpecialPage', 'Preferences' ),
                'Watchlist'                 => array( 'SpecialPage', 'Watchlist' ),
 
@@ -88,8 +93,9 @@ class SpecialPage
                'Imagelist'                 => array( 'SpecialPage', 'Imagelist' ),
                'Newimages'                 => array( 'IncludableSpecialPage', 'Newimages' ),
                'Listusers'                 => array( 'SpecialPage', 'Listusers' ),
+               'Listgrouprights'           => 'SpecialListGroupRights',
                'Statistics'                => array( 'SpecialPage', 'Statistics' ),
-               'Randompage'                => array( 'SpecialPage', 'Randompage' ),
+               'Randompage'                => 'Randompage',
                'Lonelypages'               => array( 'SpecialPage', 'Lonelypages' ),
                'Uncategorizedpages'        => array( 'SpecialPage', 'Uncategorizedpages' ),
                'Uncategorizedcategories'   => array( 'SpecialPage', 'Uncategorizedcategories' ),
@@ -112,13 +118,14 @@ class SpecialPage
                'Ancientpages'              => array( 'SpecialPage', 'Ancientpages' ),
                'Deadendpages'              => array( 'SpecialPage', 'Deadendpages' ),
                'Protectedpages'            => array( 'SpecialPage', 'Protectedpages' ),
+               'Protectedtitles'           => array( 'SpecialPage', 'Protectedtitles' ),
                'Allpages'                  => array( 'IncludableSpecialPage', 'Allpages' ),
                'Prefixindex'               => array( 'IncludableSpecialPage', 'Prefixindex' ) ,
                'Ipblocklist'               => array( 'SpecialPage', 'Ipblocklist' ),
                'Specialpages'              => array( 'UnlistedSpecialPage', 'Specialpages' ),
                'Contributions'             => array( 'SpecialPage', 'Contributions' ),
                'Emailuser'                 => array( 'UnlistedSpecialPage', 'Emailuser' ),
-               'Whatlinkshere'             => array( 'SpecialPage', 'Whatlinkshere' ),
+               'Whatlinkshere'             => array( 'UnlistedSpecialPage', 'Whatlinkshere' ),
                'Recentchangeslinked'       => array( 'UnlistedSpecialPage', 'Recentchangeslinked' ),
                'Movepage'                  => array( 'UnlistedSpecialPage', 'Movepage' ),
                'Blockme'                   => array( 'UnlistedSpecialPage', 'Blockme' ),
@@ -131,27 +138,121 @@ class SpecialPage
                'Log'                       => array( 'SpecialPage', 'Log' ),
                'Blockip'                   => array( 'SpecialPage', 'Blockip', 'block' ),
                'Undelete'                  => array( 'SpecialPage', 'Undelete', 'deletedhistory' ),
-               'Import'                    => array( 'SpecialPage', "Import", 'import' ),
+               'Import'                    => array( 'SpecialPage', 'Import', 'import' ),
                'Lockdb'                    => array( 'SpecialPage', 'Lockdb', 'siteadmin' ),
                'Unlockdb'                  => array( 'SpecialPage', 'Unlockdb', 'siteadmin' ),
-               'Userrights'                => array( 'SpecialPage', 'Userrights', 'userrights' ),
+               'Userrights'                => 'UserrightsPage',
                'MIMEsearch'                => array( 'SpecialPage', 'MIMEsearch' ),
+               'FileDuplicateSearch'       => array( 'SpecialPage', 'FileDuplicateSearch' ),
                'Unwatchedpages'            => array( 'SpecialPage', 'Unwatchedpages', 'unwatchedpages' ),
                'Listredirects'             => array( 'SpecialPage', 'Listredirects' ),
-               'Revisiondelete'            => array( 'SpecialPage', 'Revisiondelete', 'deleterevision' ),
+               'Revisiondelete'            => array( 'UnlistedSpecialPage', 'Revisiondelete', 'deleterevision' ),
                'Unusedtemplates'           => array( 'SpecialPage', 'Unusedtemplates' ),
-               'Randomredirect'            => array( 'SpecialPage', 'Randomredirect' ),
+               'Randomredirect'            => 'SpecialRandomredirect',
                'Withoutinterwiki'          => array( 'SpecialPage', 'Withoutinterwiki' ),
+               'Filepath'                  => array( 'SpecialPage', 'Filepath' ),
 
                'Mypage'                    => array( 'SpecialMypage' ),
                'Mytalk'                    => array( 'SpecialMytalk' ),
                'Mycontributions'           => array( 'SpecialMycontributions' ),
                'Listadmins'                => array( 'SpecialRedirectToSpecial', 'Listadmins', 'Listusers', 'sysop' ),
+               'MergeHistory'              => array( 'SpecialPage', 'MergeHistory', 'mergehistory' ),
                'Listbots'                  => array( 'SpecialRedirectToSpecial', 'Listbots', 'Listusers', 'bot' ),
                );
 
        static public $mAliases;
        static public $mListInitialised = false;
+       /**
+        * List of special pages, followed by what subtitle they should go under
+        * at Special:SpecialPages
+        */
+       static public $mGroupsList = array(
+               'DoubleRedirects'           => 'maintenance',
+               'BrokenRedirects'           => 'maintenance',
+               'Lonelypages'               => 'maintenance',
+               'Uncategorizedpages'        => 'maintenance',
+               'Uncategorizedcategories'   => 'maintenance',
+               'Uncategorizedimages'       => 'maintenance',
+               'Uncategorizedtemplates'    => 'maintenance',
+               'Unusedcategories'          => 'maintenance',
+               'Unusedimages'              => 'maintenance',
+               'Protectedpages'            => 'maintenance',
+               'Protectedtitles'           => 'maintenance',
+               'Unusedtemplates'           => 'maintenance',
+               'Withoutinterwiki'          => 'maintenance',
+               'Longpages'                 => 'maintenance',
+
+               'Userlogin'                 => 'login',
+               'Userlogout'                => 'login',
+               'CreateAccount'             => 'login',
+
+               'Recentchanges'             => 'changes',
+               'Recentchangeslinked'       => 'changes',
+               'Watchlist'                 => 'changes',
+               'Newimages'                 => 'changes',
+               'Newpages'                  => 'changes',
+               'Log'                       => 'changes',
+               
+               'Upload'                    => 'media',
+               'Imagelist'                 => 'media',
+               'MIMEsearch'                => 'media',
+               'FileDuplicateSearch'       => 'media',
+               'Filepath'                  => 'media',
+               
+               'Listusers'                 => 'users',
+               'Listgrouprights'           => 'users',
+               'Ipblocklist'               => 'users',
+               'Contributions'             => 'users',
+               'Emailuser'                 => 'users',
+               'Listadmins'                => 'users',
+               'Listbots'                  => 'users',
+               
+               'Wantedpages'               => 'needy',
+               'Wantedcategories'          => 'needy',
+               'Shortpages'                => 'needy',
+               'Ancientpages'              => 'needy',
+               'Deadendpages'              => 'needy',
+               
+               'Mostlinked'                => 'highuse',
+               'Mostlinkedcategories'      => 'highuse',
+               'Mostlinkedtemplates'       => 'highuse',
+               'Mostcategories'            => 'highuse',
+               'Mostimages'                => 'highuse',
+               'Mostrevisions'             => 'highuse',
+               
+               'Userrights'                => 'permissions',
+               'Blockip'                   => 'permissions',
+               
+               'Statistics'                => 'other',
+               'Fewestrevisions'           => 'other',
+               'Randompage'                => 'other',
+               'Disambiguations'           => 'other',
+               'Specialpages'              => 'other',
+               'Blockme'                   => 'other',
+               'Movepage'                  => 'other',
+               'MergeHistory'              => 'other',
+               'Lockdb'                    => 'other',
+               'Unlockdb'                  => 'other',
+               'Version'                   => 'other',
+               'Whatlinkshere'             => 'other',
+               'Booksources'               => 'other',
+               'Revisiondelete'            => 'other',
+               'Export'                    => 'other',
+               'Categories'                => 'other',
+               'Undelete'                  => 'other',
+               'Import'                    => 'other',
+               'Unwatchedpages'            => 'other',
+               'Randomredirect'            => 'other',
+               'Allpages'                  => 'other',
+               'Allmessages'               => 'other',
+               'Prefixindex'               => 'other',
+               'Listredirects'             => 'other',
+               'Preferences'               => 'other',
+               'Resetpass'                 => 'other',
+               'Mypage'                    => 'other',
+               'Mytalk'                    => 'other',
+               'Mycontributions'           => 'other',
+               );
 
        /**#@-*/
 
@@ -181,6 +282,7 @@ class SpecialPage
 
                if( $wgEmailAuthentication ) {
                        self::$mList['Confirmemail'] = 'EmailConfirmation';
+                       self::$mList['Invalidateemail'] = 'EmailInvalidation';
                }
 
                # Add extension special pages
@@ -262,6 +364,37 @@ class SpecialPage
                }
                self::$mList[$page->mName] = $page;
        }
+       
+       /**
+        * Add a page to a certain display group for Special:SpecialPages
+        *
+        * @param mixed $page Must either be an array specifying a class name and 
+        *                    constructor parameters, or an object.
+        * @param string $group
+        * @static
+        */
+       static function setGroup( &$page, $group ) {
+               if ( !self::$mListInitialised ) {
+                       self::initList();
+               }
+               self::$mGroupsList[$page->mName] = $group;
+       }
+       
+       /**
+        * Add a page to a certain display group for Special:SpecialPages
+        *
+        * @param mixed $page Must either be an array specifying a class name and 
+        *                    constructor parameters, or an object.
+        * @static
+        */
+       static function getGroup( &$page ) {
+               if ( !self::$mListInitialised ) {
+                       self::initList();
+               }
+               $group = isset(self::$mGroupsList[$page->mName]) ? 
+                       self::$mGroupsList[$page->mName] : 'other';
+               return $group;
+       }
 
        /**
         * Remove a special page from the list
@@ -350,7 +483,7 @@ class SpecialPage
 
                foreach ( self::$mList as $name => $rec ) {
                        $page = self::getPage( $name );
-                       if ( $page->isListed() && $page->getRestriction() == '' ) {
+                       if ( $page->isListed() && !$page->isRestricted() ) {
                                $pages[$name] = $page;
                        }
                }
@@ -371,11 +504,12 @@ class SpecialPage
 
                foreach ( self::$mList as $name => $rec ) {
                        $page = self::getPage( $name );
-                       if ( $page->isListed() ) {
-                               $restriction = $page->getRestriction();
-                               if ( $restriction != '' && $wgUser->isAllowed( $restriction ) ) {
-                                       $pages[$name] = $page;
-                               }
+                       if (
+                               $page->isListed()
+                               and $page->isRestricted()
+                               and $page->userCanExecute( $wgUser )
+                       ) {
+                               $pages[$name] = $page;
                        }
                }
                return $pages;
@@ -405,7 +539,6 @@ class SpecialPage
                        $par = $bits[1];
                }
                $page = SpecialPage::getPageByAlias( $name );
-
                # Nonexistent?
                if ( !$page ) {
                        if ( !$including ) {
@@ -608,11 +741,26 @@ class SpecialPage
                return $this->mLocalName;
        }
 
+       /**
+        * Can be overridden by subclasses with more complicated permissions
+        * schemes.
+        *
+        * @return bool Should the page be displayed with the restricted-access
+        *   pages?
+        */
+       public function isRestricted() {
+               return $this->mRestriction != '';
+       }
+
        /**
         * Checks if the given user (identified by an object) can execute this
-        * special page (as defined by $mRestriction)
+        * special page (as defined by $mRestriction).  Can be overridden by sub-
+        * classes with more complicated permissions schemes.
+        *
+        * @param User $user The user to check
+        * @return bool Does the user have permission to view the page?
         */
-       function userCanExecute( &$user ) {
+       public function userCanExecute( $user ) {
                return $user->isAllowed( $this->mRestriction );
        }
 
@@ -668,9 +816,10 @@ class SpecialPage
                global $wgOut, $wgContLang;
 
                $msg = $wgContLang->lc( $this->name() ) . '-summary';
-               $out = wfMsg( $msg );
-               if ( ! wfEmptyMsg( $msg, $out ) and  $out !== '' and ! $this->including() )
+               $out = wfMsgNoTrans( $msg );
+               if ( ! wfEmptyMsg( $msg, $out ) and  $out !== '' and ! $this->including() ) {
                        $wgOut->addWikiText( $out );
+               }
 
        }
 
@@ -782,7 +931,7 @@ class SpecialRedirectToSpecial extends UnlistedSpecialPage {
 class SpecialMypage extends UnlistedSpecialPage {
        function __construct() {
                parent::__construct( 'Mypage' );
-               $this->mAllowedRedirectParams = array( 'action' , 'preload' , 'editintro' );
+               $this->mAllowedRedirectParams = array( 'action' , 'preload' , 'editintro', 'section' );
        }
 
        function getRedirect( $subpage ) {
@@ -802,7 +951,7 @@ class SpecialMypage extends UnlistedSpecialPage {
 class SpecialMytalk extends UnlistedSpecialPage {
        function __construct() {
                parent::__construct( 'Mytalk' );
-               $this->mAllowedRedirectParams = array( 'action' , 'preload' , 'editintro' );
+               $this->mAllowedRedirectParams = array( 'action' , 'preload' , 'editintro', 'section' );
        }
 
        function getRedirect( $subpage ) {