MediaWiki REL1_33
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 = new ListToggle( $this->getOutput() );
180 $selectLinks = $listToggle->getHTML();
181
182 $out->addHTML(
183 $selectLinks .
184 '<ul>'
185 );
186
187 $wordSeparator = $this->msg( 'word-separator' )->escaped();
188 $commaSeparator = $this->msg( 'comma-separator' )->escaped();
189
191 foreach ( $pages as $info ) {
195 list( $title, $userName ) = $info;
196
197 $image = $title->inNamespace( NS_FILE ) ? wfLocalFile( $title ) : false;
198 $thumb = $image && $image->exists() ?
199 $image->transform( [ 'width' => 120, 'height' => 120 ], 0 ) :
200 false;
201
202 $userNameText = $userName ?
203 $this->msg( 'nuke-editby', $userName )->parse() . $commaSeparator :
204 '';
205 $changesLink = $linkRenderer->makeKnownLink(
206 $title,
207 $this->msg( 'nuke-viewchanges' )->text(),
208 [],
209 [ 'action' => 'history' ]
210 );
211 $out->addHTML( '<li>' .
212 Xml::check(
213 'pages[]',
214 true,
215 [ 'value' => $title->getPrefixedDBkey() ]
216 ) . '&#160;' .
217 ( $thumb ? $thumb->toHtml( [ 'desc-link' => true ] ) : '' ) .
218 $linkRenderer->makeKnownLink( $title ) . $wordSeparator .
219 $this->msg( 'parentheses' )->rawParams( $userNameText . $changesLink )->escaped() .
220 "</li>\n" );
221 }
222
223 $out->addHTML(
224 "</ul>\n" .
225 Xml::submitButton( $this->msg( 'nuke-submit-delete' )->text() ) .
226 '</form>'
227 );
228 }
229
239 protected function getNewPages( $username, $limit, $namespace = null ) {
241
242 $what = [
243 'rc_namespace',
244 'rc_title',
245 'rc_timestamp',
246 ];
247
248 $where = [ "(rc_new = 1) OR (rc_log_type = 'upload' AND rc_log_action = 'upload')" ];
249
250 if ( class_exists( ActorMigration::class ) ) {
251 if ( $username === '' ) {
252 $actorQuery = ActorMigration::newMigration()->getJoin( 'rc_user' );
253 $what['rc_user_text'] = $actorQuery['fields']['rc_user_text'];
254 } else {
255 $actorQuery = ActorMigration::newMigration()
256 ->getWhere( $dbr, 'rc_user', User::newFromName( $username, false ) );
257 $where[] = $actorQuery['conds'];
258 }
259 } else {
260 $actorQuery = [ 'tables' => [], 'joins' => [] ];
261 if ( $username === '' ) {
262 $what[] = 'rc_user_text';
263 } else {
264 $where['rc_user_text'] = $username;
265 }
266 }
267
268 if ( $namespace !== null ) {
269 $where['rc_namespace'] = $namespace;
270 }
271
272 $pattern = $this->getRequest()->getText( 'pattern' );
273 if ( !is_null( $pattern ) && trim( $pattern ) !== '' ) {
274 // $pattern is a SQL pattern supporting wildcards, so buildLike
275 // will not work.
276 $where[] = 'rc_title LIKE ' . $dbr->addQuotes( $pattern );
277 }
278 $group = implode( ', ', $what );
279
280 $result = $dbr->select(
281 [ 'recentchanges' ] + $actorQuery['tables'],
282 $what,
283 $where,
284 __METHOD__,
285 [
286 'ORDER BY' => 'rc_timestamp DESC',
287 'GROUP BY' => $group,
288 'LIMIT' => $limit
289 ],
290 $actorQuery['joins']
291 );
292
293 $pages = [];
294
295 foreach ( $result as $row ) {
296 $pages[] = [
297 Title::makeTitle( $row->rc_namespace, $row->rc_title ),
298 $username === '' ? $row->rc_user_text : false
299 ];
300 }
301
302 // Allows other extensions to provide pages to be nuked that don't use
303 // the recentchanges table the way mediawiki-core does
304 Hooks::run( 'NukeGetNewPages', [ $username, $pattern, $namespace, $limit, &$pages ] );
305
306 // Re-enforcing the limit *after* the hook because other extensions
307 // may add and/or remove pages. We need to make sure we don't end up
308 // with more pages than $limit.
309 if ( count( $pages ) > $limit ) {
310 $pages = array_slice( $pages, 0, $limit );
311 }
312
313 return $pages;
314 }
315
323 protected function doDelete( array $pages, $reason ) {
324 $res = [];
325
326 foreach ( $pages as $page ) {
327 $title = Title::newFromText( $page );
328
329 $deletionResult = false;
330 if ( !Hooks::run( 'NukeDeletePage', [ $title, $reason, &$deletionResult ] ) ) {
331 if ( $deletionResult ) {
332 $res[] = $this->msg( 'nuke-deleted', $title->getPrefixedText() )->parse();
333 } else {
334 $res[] = $this->msg( 'nuke-not-deleted', $title->getPrefixedText() )->parse();
335 }
336 continue;
337 }
338
339 $file = $title->getNamespace() === NS_FILE ? wfLocalFile( $title ) : false;
340 $permission_errors = $title->getUserPermissionsErrors( 'delete', $this->getUser() );
341
342 if ( $permission_errors !== [] ) {
343 throw new PermissionsError( 'delete', $permission_errors );
344 }
345
346 if ( $file ) {
347 $oldimage = null; // Must be passed by reference
348 $ok = FileDeleteForm::doDelete( $title, $file, $oldimage, $reason, false )->isOK();
349 } else {
350 $article = new Article( $title, 0 );
351 $ok = $article->doDeleteArticle( $reason );
352 }
353
354 if ( $ok ) {
355 $res[] = $this->msg( 'nuke-deleted', $title->getPrefixedText() )->parse();
356 } else {
357 $res[] = $this->msg( 'nuke-not-deleted', $title->getPrefixedText() )->parse();
358 }
359 }
360
361 $this->getOutput()->addHTML( "<ul>\n<li>" . implode( "</li>\n<li>", $res ) . "</li>\n</ul>\n" );
362 $this->getOutput()->addWikiMsg( 'nuke-delete-more' );
363 }
364
373 public function prefixSearchSubpages( $search, $limit, $offset ) {
374 $user = User::newFromName( $search );
375 if ( !$user ) {
376 // No prefix suggestion for invalid user
377 return [];
378 }
379 // Autocomplete subpage as user list - public to allow caching
380 return UserNamePrefixSearch::search( 'public', $search, $limit, $offset );
381 }
382
383 protected function getGroupName() {
384 return 'pagetools';
385 }
386}
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
and that you know you can do these things To protect your we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights These restrictions translate to certain responsibilities for you if you distribute copies of the or if you modify it For if you distribute copies of such a whether gratis or for a you must give the recipients all the rights that you have You must make sure that receive or can get the source code And you must show them these terms so they know their rights We protect your rights with two and(2) offer you this license which gives you legal permission to copy
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:37
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.
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:585
$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 or null if authentication failed before getting that far or null if we can t even determine that When $user is not it can be in the form of< username >< more info > e g for bot passwords intended to be added to log contexts Fields it might only if the login was with a bot password 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:886
this hook is for auditing only $req
Definition hooks.txt:979
this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that When $user is not it can be in the form of< username >< more info > e g for bot passwords intended to be added to log contexts Fields it might only if the login was with a bot password 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:855
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:2157
namespace and then decline to actually register it file or subcat img or subcat $title
Definition hooks.txt:955
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:2004
this hook is for auditing only or null if authentication failed before getting that far $username
Definition hooks.txt:782
return true to allow those checks to and false if checking is done remove or add to the links of a group of changes in EnhancedChangesList Hook subscribers can return false to omit this line from recentchanges use this to change the tables headers change it to an object instance and return false override the list derivative used the name of the old file & $article
Definition hooks.txt:1580
processing should stop and the error should be shown to the user * false
Definition hooks.txt:187
const NS_FILE
Definition Defines.php:79
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