MediaWiki REL1_35
SpecialShortPages.php
Go to the documentation of this file.
1<?php
27
35
36 public function __construct( $name = 'Shortpages' ) {
37 parent::__construct( $name );
38 }
39
40 public 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 $this->getHookRunner()->onShortPagesQuery( $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 protected function getOrderFields() {
126 return [ 'page_len' ];
127 }
128
133 public function preprocessResults( $db, $res ) {
135 }
136
137 protected function sortDescending() {
138 return false;
139 }
140
146 public 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
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}
static getInvalidTitleDescription(IContextSource $context, $namespace, $title)
Get a message saying that an invalid title was encountered.
Definition Linker.php:188
MediaWikiServices is the service locator for the application scope of MediaWiki.
This is a class for doing query pages; since they're almost all the same, we factor out some of the f...
Definition QueryPage.php:39
executeLBFromResultWrapper(IResultWrapper $res, $ns=null)
Creates a new LinkBatch object, adds all pages from the passed result wrapper (MUST include title and...
int $offset
The offset and limit in use, as passed to the query() function.
Definition QueryPage.php:44
isCached()
Whether or not the output of the page in question is retrieved from the database cache.
getRecacheDB()
Get a DB connection to be used for slow recache queries Stable to override.
getContext()
Gets the context this SpecialPage is executed in.
msg( $key,... $params)
Wrapper around wfMessage that sets the current context.
getConfig()
Shortcut to get main config object.
getLanguage()
Shortcut to get user's language.
MediaWiki Linker LinkRenderer null $linkRenderer
SpecialShortpages extends QueryPage.
getGroupName()
Under which header this special page is listed in Special:SpecialPages See messages 'specialpages-gro...
reallyDoQuery( $limit, $offset=false)
Run the query and return the result Stable to override.
getQueryInfo()
Subclasses return an SQL query here, formatted as an array with the following keys: tables => Table(s...
preprocessResults( $db, $res)
sortDescending()
Override to sort by increasing values.
getOrderFields()
Subclasses return an array of fields to order by here.
isSyndicated()
Sometime we don't want to build rss / atom feeds.
formatResult( $skin, $result)
__construct( $name='Shortpages')
Basic database interface for live and lazy-loaded relation database handles.
Definition IDatabase.php:38
Result wrapper for grabbing data queried from an IDatabase object.