MediaWiki REL1_32
SpecialNuke.php
Go to the documentation of this file.
1<?php
2
3class SpecialNuke extends SpecialPage {
4
5 public function __construct() {
6 parent::__construct( 'Nuke', 'nuke' );
7 }
8
9 public function doesWrites() {
10 return true;
11 }
12
16 public function execute( $par ) {
17 $this->setHeaders();
18 $this->checkPermissions();
19 $this->checkReadOnly();
20 $this->outputHeader();
21
22 $currentUser = $this->getUser();
23 if ( $currentUser->isBlocked() ) {
24 $block = $currentUser->getBlock();
25 throw new UserBlockedError( $block );
26 }
27
28 $req = $this->getRequest();
29 $target = trim( $req->getText( 'target', $par ) );
30
31 // Normalise name
32 if ( $target !== '' ) {
33 $user = User::newFromName( $target );
34 if ( $user ) {
35 $target = $user->getName();
36 }
37 }
38
39 $msg = $target === '' ?
40 $this->msg( 'nuke-multiplepeople' )->inContentLanguage()->text() :
41 $this->msg( 'nuke-defaultreason', $target )->
42 inContentLanguage()->text();
43 $reason = $req->getText( 'wpReason', $msg );
44
45 $limit = $req->getInt( 'limit', 500 );
46 $namespace = $req->getVal( 'namespace' );
47 $namespace = ctype_digit( $namespace ) ? (int)$namespace : null;
48
49 if ( $req->wasPosted()
50 && $currentUser->matchEditToken( $req->getVal( 'wpEditToken' ) )
51 ) {
52 if ( $req->getVal( 'action' ) === 'delete' ) {
53 $pages = $req->getArray( 'pages' );
54
55 if ( $pages ) {
56 $this->doDelete( $pages, $reason );
57
58 return;
59 }
60 } elseif ( $req->getVal( 'action' ) === 'submit' ) {
61 $this->listForm( $target, $reason, $limit, $namespace );
62 } else {
63 $this->promptForm();
64 }
65 } elseif ( $target === '' ) {
66 $this->promptForm();
67 } else {
68 $this->listForm( $target, $reason, $limit, $namespace );
69 }
70 }
71
77 protected function promptForm( $userName = '' ) {
78 $out = $this->getOutput();
79
80 $out->addWikiMsg( 'nuke-tools' );
81
83 'nuke-target' => [
84 'id' => 'nuke-target',
85 'default' => $userName,
86 'label' => $this->msg( 'nuke-userorip' )->text(),
87 'type' => 'user',
88 'name' => 'target',
89 'autofocus' => true
90 ],
91 'nuke-pattern' => [
92 'id' => 'nuke-pattern',
93 'label' => $this->msg( 'nuke-pattern' )->text(),
94 'maxLength' => 40,
95 'type' => 'text',
96 'name' => 'pattern'
97 ],
98 'namespace' => [
99 'id' => 'nuke-namespace',
100 'type' => 'namespaceselect',
101 'label' => $this->msg( 'nuke-namespace' )->text(),
102 'all' => 'all',
103 'name' => 'namespace'
104 ],
105 'limit' => [
106 'id' => 'nuke-limit',
107 'maxLength' => 7,
108 'default' => 500,
109 'label' => $this->msg( 'nuke-maxpages' )->text(),
110 'type' => 'int',
111 'name' => 'limit'
112 ]
113 ];
114
115 HTMLForm::factory( 'ooui', $formDescriptor, $this->getContext() )
116 ->setName( 'massdelete' )
117 ->setFormIdentifier( 'massdelete' )
118 ->setWrapperLegendMsg( 'nuke' )
119 ->setSubmitTextMsg( 'nuke-submit-user' )
120 ->setSubmitName( 'nuke-submit-user' )
121 ->setAction( $this->getPageTitle()->getLocalURL( 'action=submit' ) )
122 ->setMethod( 'post' )
123 ->addHiddenField( 'wpEditToken', $this->getUser()->getEditToken() )
124 ->prepareForm()
125 ->displayForm( false );
126 }
127
136 protected function listForm( $username, $reason, $limit, $namespace = null ) {
137 $out = $this->getOutput();
138
139 $pages = $this->getNewPages( $username, $limit, $namespace );
140
141 if ( count( $pages ) === 0 ) {
142 if ( $username === '' ) {
143 $out->addWikiMsg( 'nuke-nopages-global' );
144 } else {
145 $out->addWikiMsg( 'nuke-nopages', $username );
146 }
147
148 $this->promptForm( $username );
149
150 return;
151 }
152
153 $out->addModules( 'ext.nuke.confirm' );
154
155 if ( $username === '' ) {
156 $out->addWikiMsg( 'nuke-list-multiple' );
157 } else {
158 $out->addWikiMsg( 'nuke-list', $username );
159 }
160
161 $nuke = $this->getPageTitle();
162
163 $out->addHTML(
164 Xml::openElement( 'form', [
165 'action' => $nuke->getLocalURL( 'action=delete' ),
166 'method' => 'post',
167 'name' => 'nukelist' ]
168 ) .
169 Html::hidden( 'wpEditToken', $this->getUser()->getEditToken() ) .
170 Xml::tags( 'p',
171 null,
172 Xml::inputLabel(
173 $this->msg( 'deletecomment' )->text(), 'wpReason', 'wpReason', 70, $reason
174 )
175 )
176 );
177
178 // Select: All, None, Invert
179 // ListToggle was introduced in 1.27, old code kept for B/C
180 if ( class_exists( 'ListToggle' ) ) {
181 $listToggle = new ListToggle( $this->getOutput() );
182 $selectLinks = $listToggle->getHTML();
183 } else {
184 $out->addModules( 'ext.nuke' );
185
186 $links = [];
187 $links[] = '<a href="#" id="toggleall">' .
188 $this->msg( 'powersearch-toggleall' )->escaped() . '</a>';
189 $links[] = '<a href="#" id="togglenone">' .
190 $this->msg( 'powersearch-togglenone' )->escaped() . '</a>';
191 $links[] = '<a href="#" id="toggleinvert">' .
192 $this->msg( 'nuke-toggleinvert' )->escaped() . '</a>';
193
194 $selectLinks = Xml::tags( 'p',
195 null,
196 $this->msg( 'nuke-select' )
197 ->rawParams( $this->getLanguage()->commaList( $links ) )->escaped()
198 );
199 }
200
201 $out->addHTML(
202 $selectLinks .
203 '<ul>'
204 );
205
206 $wordSeparator = $this->msg( 'word-separator' )->escaped();
207 $commaSeparator = $this->msg( 'comma-separator' )->escaped();
208
210 foreach ( $pages as $info ) {
214 list( $title, $userName ) = $info;
215
216 $image = $title->inNamespace( NS_FILE ) ? wfLocalFile( $title ) : false;
217 $thumb = $image && $image->exists() ?
218 $image->transform( [ 'width' => 120, 'height' => 120 ], 0 ) :
219 false;
220
221 $userNameText = $userName ?
222 $this->msg( 'nuke-editby', $userName )->parse() . $commaSeparator :
223 '';
224 $changesLink = $linkRenderer->makeKnownLink(
225 $title,
226 $this->msg( 'nuke-viewchanges' )->text(),
227 [],
228 [ 'action' => 'history' ]
229 );
230 $out->addHTML( '<li>' .
231 Xml::check(
232 'pages[]',
233 true,
234 [ 'value' => $title->getPrefixedDBkey() ]
235 ) . '&#160;' .
236 ( $thumb ? $thumb->toHtml( [ 'desc-link' => true ] ) : '' ) .
237 $linkRenderer->makeKnownLink( $title ) . $wordSeparator .
238 $this->msg( 'parentheses' )->rawParams( $userNameText . $changesLink )->escaped() .
239 "</li>\n" );
240 }
241
242 $out->addHTML(
243 "</ul>\n" .
244 Xml::submitButton( $this->msg( 'nuke-submit-delete' )->text() ) .
245 '</form>'
246 );
247 }
248
258 protected function getNewPages( $username, $limit, $namespace = null ) {
260
261 $what = [
262 'rc_namespace',
263 'rc_title',
264 'rc_timestamp',
265 ];
266
267 $where = [ "(rc_new = 1) OR (rc_log_type = 'upload' AND rc_log_action = 'upload')" ];
268
269 if ( class_exists( 'ActorMigration' ) ) {
270 if ( $username === '' ) {
271 $actorQuery = ActorMigration::newMigration()->getJoin( 'rc_user' );
272 $what['rc_user_text'] = $actorQuery['fields']['rc_user_text'];
273 } else {
274 $actorQuery = ActorMigration::newMigration()
275 ->getWhere( $dbr, 'rc_user', User::newFromName( $username, false ) );
276 $where[] = $actorQuery['conds'];
277 }
278 } else {
279 $actorQuery = [ 'tables' => [], 'joins' => [] ];
280 if ( $username === '' ) {
281 $what[] = 'rc_user_text';
282 } else {
283 $where['rc_user_text'] = $username;
284 }
285 }
286
287 if ( $namespace !== null ) {
288 $where['rc_namespace'] = $namespace;
289 }
290
291 $pattern = $this->getRequest()->getText( 'pattern' );
292 if ( !is_null( $pattern ) && trim( $pattern ) !== '' ) {
293 // $pattern is a SQL pattern supporting wildcards, so buildLike
294 // will not work.
295 $where[] = 'rc_title LIKE ' . $dbr->addQuotes( $pattern );
296 }
297 $group = implode( ', ', $what );
298
299 $result = $dbr->select(
300 [ 'recentchanges' ] + $actorQuery['tables'],
301 $what,
302 $where,
303 __METHOD__,
304 [
305 'ORDER BY' => 'rc_timestamp DESC',
306 'GROUP BY' => $group,
307 'LIMIT' => $limit
308 ],
309 $actorQuery['joins']
310 );
311
312 $pages = [];
313
314 foreach ( $result as $row ) {
315 $pages[] = [
316 Title::makeTitle( $row->rc_namespace, $row->rc_title ),
317 $username === '' ? $row->rc_user_text : false
318 ];
319 }
320
321 // Allows other extensions to provide pages to be nuked that don't use
322 // the recentchanges table the way mediawiki-core does
323 Hooks::run( 'NukeGetNewPages', [ $username, $pattern, $namespace, $limit, &$pages ] );
324
325 // Re-enforcing the limit *after* the hook because other extensions
326 // may add and/or remove pages. We need to make sure we don't end up
327 // with more pages than $limit.
328 if ( count( $pages ) > $limit ) {
329 $pages = array_slice( $pages, 0, $limit );
330 }
331
332 return $pages;
333 }
334
342 protected function doDelete( array $pages, $reason ) {
343 $res = [];
344
345 foreach ( $pages as $page ) {
346 $title = Title::newFromText( $page );
347
348 $deletionResult = false;
349 if ( !Hooks::run( 'NukeDeletePage', [ $title, $reason, &$deletionResult ] ) ) {
350 if ( $deletionResult ) {
351 $res[] = $this->msg( 'nuke-deleted', $title->getPrefixedText() )->parse();
352 } else {
353 $res[] = $this->msg( 'nuke-not-deleted', $title->getPrefixedText() )->parse();
354 }
355 continue;
356 }
357
358 $file = $title->getNamespace() === NS_FILE ? wfLocalFile( $title ) : false;
359 $permission_errors = $title->getUserPermissionsErrors( 'delete', $this->getUser() );
360
361 if ( $permission_errors !== [] ) {
362 throw new PermissionsError( 'delete', $permission_errors );
363 }
364
365 if ( $file ) {
366 $oldimage = null; // Must be passed by reference
367 $ok = FileDeleteForm::doDelete( $title, $file, $oldimage, $reason, false )->isOK();
368 } else {
369 $article = new Article( $title, 0 );
370 $ok = $article->doDeleteArticle( $reason );
371 }
372
373 if ( $ok ) {
374 $res[] = $this->msg( 'nuke-deleted', $title->getPrefixedText() )->parse();
375 } else {
376 $res[] = $this->msg( 'nuke-not-deleted', $title->getPrefixedText() )->parse();
377 }
378 }
379
380 $this->getOutput()->addHTML( "<ul>\n<li>" . implode( "</li>\n<li>", $res ) . "</li>\n</ul>\n" );
381 $this->getOutput()->addWikiMsg( 'nuke-delete-more' );
382 }
383
392 public function prefixSearchSubpages( $search, $limit, $offset ) {
393 if ( !class_exists( 'UserNamePrefixSearch' ) ) { // check for version 1.27
394 return [];
395 }
396 $user = User::newFromName( $search );
397 if ( !$user ) {
398 // No prefix suggestion for invalid user
399 return [];
400 }
401 // Autocomplete subpage as user list - public to allow caching
402 return UserNamePrefixSearch::search( 'public', $search, $limit, $offset );
403 }
404
405 protected function getGroupName() {
406 return 'pagetools';
407 }
408}
This list may contain false positives That usually means there is additional text with links below the first Each row contains links to the first and second as well as the first line of the second redirect text
wfGetDB( $db, $groups=[], $wiki=false)
Get a Database object.
wfLocalFile( $title)
Get an object referring to a locally registered file.
Class for viewing MediaWiki article and history.
Definition Article.php:38
static doDelete(&$title, &$file, &$oldimage, $reason, $suppress, User $user=null, $tags=[])
Really delete the file.
Class for generating clickable toggle links for a list of checkboxes.
Show an error when a user tries to do something they do not have the necessary permissions for.
execute( $par)
doDelete(array $pages, $reason)
Does the actual deletion of the pages.
promptForm( $userName='')
Prompt for a username or IP address.
prefixSearchSubpages( $search, $limit, $offset)
Return an array of subpages beginning with $search that this special page will accept.
getNewPages( $username, $limit, $namespace=null)
Gets a list of new pages by the specified user or everyone when none is specified.
getGroupName()
Under which header this special page is listed in Special:SpecialPages See messages 'specialpages-gro...
listForm( $username, $reason, $limit, $namespace=null)
Display list of pages to delete.
doesWrites()
Indicates whether this special page may perform database writes.
Parent class for all special pages.
outputHeader( $summaryMessageKey='')
Outputs a summary message on top of special pages Per default the message key is the canonical name o...
setHeaders()
Sets headers - this should be called from the execute() method of all derived classes!
getOutput()
Get the OutputPage being used for this instance.
getUser()
Shortcut to get the User executing this instance.
checkPermissions()
Checks if userCanExecute, and if not throws a PermissionsError.
getContext()
Gets the context this SpecialPage is executed in.
msg( $key)
Wrapper around wfMessage that sets the current context.
getRequest()
Get the WebRequest being used for this instance.
checkReadOnly()
If the wiki is currently in readonly mode, throws a ReadOnlyError.
getPageTitle( $subpage=false)
Get a self-referential title object.
getLanguage()
Shortcut to get user's language.
MediaWiki Linker LinkRenderer null $linkRenderer
Show an error when the user tries to do something whilst blocked.
static search( $audience, $search, $limit, $offset=0)
Do a prefix search of user names and return a list of matching user names.
static newFromName( $name, $validate='valid')
Static factory method for creation from username.
Definition User.php:592
$res
Definition database.txt:21
deferred txt A few of the database updates required by various functions here can be deferred until after the result page is displayed to the user For updating the view updating the linked to tables after a etc PHP does not yet have any way to tell the server to actually return and disconnect while still running these but it might have such a feature in the future We handle these by creating a deferred update object and putting those objects on a global list
Definition deferred.txt:11
this hook is for auditing only $req
Definition hooks.txt:1018
either a unescaped string or a HtmlArmor object after in associative array form externallinks including delete and has completed for all link tables whether this was an auto creation use $formDescriptor instead & $formDescriptor
Definition hooks.txt:2208
this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable modifiable after all normalizations have been except for the $wgMaxImageArea check $image
Definition hooks.txt:925
namespace and then decline to actually register it file or subcat img or subcat $title
Definition hooks.txt:994
null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return true
Definition hooks.txt:2055
this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output $out
Definition hooks.txt:894
this hook is for auditing only or null if authentication failed before getting that far $username
Definition hooks.txt:815
processing should stop and the error should be shown to the user * false
Definition hooks.txt:187
const NS_FILE
Definition Defines.php:70
The wiki should then use memcached to cache various data To use multiple just add more items to the array To increase the weight of a make its entry a array("192.168.0.1:11211", 2))
const DB_REPLICA
Definition defines.php:25