MediaWiki  master
SpecialShortPages.php
Go to the documentation of this file.
1 <?php
27 
35 
36  function __construct( $name = 'Shortpages' ) {
37  parent::__construct( $name );
38  }
39 
40  function isSyndicated() {
41  return false;
42  }
43 
44  public function getQueryInfo() {
45  $config = $this->getConfig();
46  $blacklist = $config->get( 'ShortPagesNamespaceBlacklist' );
47  $tables = [ 'page' ];
48  $conds = [
49  'page_namespace' => array_diff(
50  MediaWikiServices::getInstance()->getNamespaceInfo()->getContentNamespaces(),
51  $blacklist
52  ),
53  'page_is_redirect' => 0
54  ];
55  $joinConds = [];
56  $options = [ 'USE INDEX' => [ 'page' => 'page_redirect_namespace_len' ] ];
57 
58  // Allow extensions to modify the query
59  Hooks::run( 'ShortPagesQuery', [ &$tables, &$conds, &$joinConds, &$options ] );
60 
61  return [
62  'tables' => $tables,
63  'fields' => [
64  'namespace' => 'page_namespace',
65  'title' => 'page_title',
66  'value' => 'page_len'
67  ],
68  'conds' => $conds,
69  'join_conds' => $joinConds,
70  'options' => $options
71  ];
72  }
73 
74  public function reallyDoQuery( $limit, $offset = false ) {
75  $fname = static::class . '::reallyDoQuery';
76  $dbr = $this->getRecacheDB();
77  $query = $this->getQueryInfo();
78  $order = $this->getOrderFields();
79 
80  if ( $this->sortDescending() ) {
81  foreach ( $order as &$field ) {
82  $field .= ' DESC';
83  }
84  }
85 
86  $tables = isset( $query['tables'] ) ? (array)$query['tables'] : [];
87  $fields = isset( $query['fields'] ) ? (array)$query['fields'] : [];
88  $conds = isset( $query['conds'] ) ? (array)$query['conds'] : [];
89  $options = isset( $query['options'] ) ? (array)$query['options'] : [];
90  $join_conds = isset( $query['join_conds'] ) ? (array)$query['join_conds'] : [];
91 
92  if ( $limit !== false ) {
93  $options['LIMIT'] = intval( $limit );
94  }
95 
96  if ( $offset !== false ) {
97  $options['OFFSET'] = intval( $offset );
98  }
99 
100  $namespaces = $conds['page_namespace'];
101  if ( count( $namespaces ) === 1 ) {
102  $options['ORDER BY'] = $order;
103  $res = $dbr->select( $tables, $fields, $conds, $fname,
104  $options, $join_conds
105  );
106  } else {
107  unset( $conds['page_namespace'] );
108  $options['INNER ORDER BY'] = $order;
109  $options['ORDER BY'] = [ 'value' . ( $this->sortDescending() ? ' DESC' : '' ) ];
110  $sql = $dbr->unionConditionPermutations(
111  $tables,
112  $fields,
113  [ 'page_namespace' => $namespaces ],
114  $conds,
115  $fname,
116  $options,
117  $join_conds
118  );
119  $res = $dbr->query( $sql, $fname );
120  }
121 
122  return $res;
123  }
124 
125  function getOrderFields() {
126  return [ 'page_len' ];
127  }
128 
133  function preprocessResults( $db, $res ) {
135  }
136 
137  function sortDescending() {
138  return false;
139  }
140 
146  function formatResult( $skin, $result ) {
147  $dm = $this->getLanguage()->getDirMark();
148 
149  $title = Title::makeTitleSafe( $result->namespace, $result->title );
150  if ( !$title ) {
151  return Html::element( 'span', [ 'class' => 'mw-invalidtitle' ],
152  Linker::getInvalidTitleDescription( $this->getContext(), $result->namespace, $result->title ) );
153  }
154 
155  $linkRenderer = $this->getLinkRenderer();
156  $hlink = $linkRenderer->makeKnownLink(
157  $title,
158  $this->msg( 'hist' )->text(),
159  [],
160  [ 'action' => 'history' ]
161  );
162  $hlinkInParentheses = $this->msg( 'parentheses' )->rawParams( $hlink )->escaped();
163 
164  if ( $this->isCached() ) {
165  $plink = $linkRenderer->makeLink( $title );
166  $exists = $title->exists();
167  } else {
168  $plink = $linkRenderer->makeKnownLink( $title );
169  $exists = true;
170  }
171 
172  $size = $this->msg( 'nbytes' )->numParams( $result->value )->escaped();
173 
174  return $exists
175  ? "${hlinkInParentheses} {$dm}{$plink} {$dm}[{$size}]"
176  : "<del>${hlinkInParentheses} {$dm}{$plink} {$dm}[{$size}]</del>";
177  }
178 
179  protected function getGroupName() {
180  return 'maintenance';
181  }
182 }
__construct( $name='Shortpages')
static element( $element, $attribs=[], $contents='')
Identical to rawElement(), but HTML-escapes $contents (like Xml::element()).
Definition: Html.php:231
getContext()
Gets the context this SpecialPage is executed in.
reallyDoQuery( $limit, $offset=false)
isCached()
Whether or not the output of the page in question is retrieved from the database cache.
Definition: QueryPage.php:258
formatResult( $skin, $result)
This is a class for doing query pages; since they&#39;re almost all the same, we factor out some of the f...
Definition: QueryPage.php:36
getRecacheDB()
Get a DB connection to be used for slow recache queries.
Definition: QueryPage.php:399
msg( $key,... $params)
Wrapper around wfMessage that sets the current context.
preprocessResults( $db, $res)
int $offset
The offset and limit in use, as passed to the query() function.
Definition: QueryPage.php:41
static makeTitleSafe( $ns, $title, $fragment='', $interwiki='')
Create a new Title from a namespace index and a DB key.
Definition: Title.php:612
SpecialShortpages extends QueryPage.
getConfig()
Shortcut to get main config object.
int $limit
Definition: QueryPage.php:44
getLanguage()
Shortcut to get user&#39;s language.
static getInvalidTitleDescription(IContextSource $context, $namespace, $title)
Get a message saying that an invalid title was encountered.
Definition: Linker.php:187
executeLBFromResultWrapper(IResultWrapper $res, $ns=null)
Creates a new LinkBatch object, adds all pages from the passed result wrapper (MUST include title and...
Definition: QueryPage.php:800
static run( $event, array $args=[], $deprecatedVersion=null)
Call hook functions defined in Hooks::register and $wgHooks.
Definition: Hooks.php:200
MediaWiki Linker LinkRenderer null $linkRenderer
Definition: SpecialPage.php:67