includes/specials/SpecialUncategorizedpages.php

   1 <?php
   2 /**
   3  * Implements Special:Uncategorizedpages
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; either version 2 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License along
  16  * with this program; if not, write to the Free Software Foundation, Inc.,
  17  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  18  * http://www.gnu.org/copyleft/gpl.html
  19  *
  20  * @file
  21  * @ingroup SpecialPage
  22  */
  23
  24 use MediaWiki\MediaWikiServices;
  25
  26 /**
  27  * A special page looking for page without any category.
  28  *
  29  * @ingroup SpecialPage
  30  * @todo FIXME: Make $requestedNamespace selectable, unify all subclasses into one
  31  */
  32 class UncategorizedPagesPage extends PageQueryPage {
  33         protected $requestedNamespace = false;
  34
  35         function __construct( $name = 'Uncategorizedpages' ) {
  36                 parent::__construct( $name );
  37         }
  38
  39         function sortDescending() {
  40                 return false;
  41         }
  42
  43         function isExpensive() {
  44                 return true;
  45         }
  46
  47         function isSyndicated() {
  48                 return false;
  49         }
  50
  51         function getQueryInfo() {
  52                 return [
  53                         'tables' => [ 'page', 'categorylinks' ],
  54                         'fields' => [
  55                                 'namespace' => 'page_namespace',
  56                                 'title' => 'page_title',
  57                                 'value' => 'page_title'
  58                         ],
  59                         // default for page_namespace is all content namespaces (if requestedNamespace is false)
  60                         // otherwise, page_namespace is requestedNamespace
  61                         'conds' => [
  62                                 'cl_from IS NULL',
  63                                 'page_namespace' => $this->requestedNamespace !== false
  64                                                 ? $this->requestedNamespace
  65                                                 : MediaWikiServices::getInstance()->getNamespaceInfo()->
  66                                                         getContentNamespaces(),
  67                                 'page_is_redirect' => 0
  68                         ],
  69                         'join_conds' => [
  70                                 'categorylinks' => [ 'LEFT JOIN', 'cl_from = page_id' ]
  71                         ]
  72                 ];
  73         }
  74
  75         function getOrderFields() {
  76                 // For some crazy reason ordering by a constant
  77                 // causes a filesort
  78                 if ( $this->requestedNamespace === false &&
  79                         count( MediaWikiServices::getInstance()->getNamespaceInfo()->
  80                                 getContentNamespaces() ) > 1
  81                 ) {
  82                         return [ 'page_namespace', 'page_title' ];
  83                 }
  84
  85                 return [ 'page_title' ];
  86         }
  87
  88         protected function getGroupName() {
  89                 return 'maintenance';
  90         }
  91 }