gww>Chieftain Alex at 21:53, 11 September 2026

2026-09-11T21:53:00Z

New page

<noinclude>{{#Widget:Block robot}}
== Description ==
This widget facilitates the automation of repetitive block/unblock tasks for spambots. If you are making a lot of changes, make sure to login to a bot account before using this page.

== Usage ==
=== Parameters ===
This widget has no parameters.

[[Category:Widgets]]
</noinclude><includeonly><div id="widgettarget"></div>
<style>
/* CSS for bulk edit tool */
#listwrapper {
width: 100%;
clear: both;
}
#listwrapper > table {
width: 100%;
}
#titlebar {
border: 1px solid #555;
background-color: #777;
padding: 3px 0px;
width: 100%;
color: #EEE;
text-align: center;
font-size: 12pt;
}
.contentwrapper {
border: 1px solid #555;
margin-top: 2px;
background-color: #DDD;
width: 100%;
}
.contentwrapper > table {
width: 100%;
border-spacing: 5px;
}
.contentwrapper td {
border: 1px solid #555;
background-color: #EEE;
padding: 5px;
font-family: consolas;
vertical-align: top;
}
#listoperators {
min-width: 222px;
width: 30%;
}
#fullwrapper input[type=text] {
width: 99%;
padding: 3px 2px;
}
#fullwrapper input[type=button] {
width: 70px;
margin: 0px 2px;
}
#fullwrapper select {
display: inline-block;
height: 27px;
}
#listinput textarea {
overflow-y: scroll;
height: 515px;
}
#listsucceed {
background-color: #9F9;
white-space: nowrap;
}
#listsucceed div {
height: 500px;
overflow-y: scroll;
}
#listfailed {
background-color: #F99;
white-space: nowrap;
}
#listfailed div {
max-height: 100px;
overflow-y: scroll;
}
</style>
<script>
/* WIDGET: BLOCK ROBOT */
function mwBlockScript () {

// Make the GUI.
function makeTaskGUI () {
// Initialise frame with required options.
var UIframe = $('<div id="fullwrapper">'
+'<div id="titlebar">AJAX spambot blocking script</div>'
+'<div class="contentwrapper">'
+'<table><tbody>'
+'<tr>'
+'<td colspan="2"><textarea id="listsummary" type="text" placeholder="Insert edit summary here." rows="1"></textarea></td>'
+'</tr>'
+'<tr>'
+'<td id="listinput" rowspan="2"><textarea></textarea></td>'
+'<td id="listsucceed"><div></div></td>'
+'</tr>'
+'<tr>'
+'<td id="listfailed"><div></div></td>'
+'</tr>'
+'<tr>'
+'<td id="listprogress"></td>'
+'<td id="listoperators">'
+'<select id="listmode" name="mode">'
+'<option value="blank" selected>(blank)</option>'
+'<option value="block">Block</option>'
+'<option value="unblock">Unblock</option>'
+'</select>'
+'<input name="run" type="button" value="Run">'
+'<input name="reset" type="button" value="Reset">'
+'</td>'
+'</tr>'
+'</tbody></table>'
+'</div>'
+'</div>');
$('#widgettarget').html(UIframe);
}

// Helper function
function isAnonymousUser(username) {
// Pattern of the form 111.111.1.1
const pattern = /(\d+)\.(\d+)\.(\d+)\.(\d+)/i;
var res = username.match(pattern);
if (res) {
return true;
} else {
return false;
}
}

// Extract information from the GUI.
function getCurrentTaskFromGUI() {

// Define variables
var mode = $('#listmode').val();
var summary = '';
var username = '';

// Obtain the list of potential pages
var allpages = [];
allpages = $('#listinput textarea').val().split('\n');

// Take the first line away from the potential pages and add to the processing box.
var currentline = allpages.shift();
$('#listprogress').text(currentline);

// Return allpages back to the form without the top line
$('#listinput textarea').val(allpages.join('\n'));

// Check list entry isn't blank
var currentpages = currentline.split('>');
if (currentpages.length > 0) {
username = currentpages[0].trim();
}

// Get summary
summary = $('#listsummary').val();

// Verify inprogress isn't blank
if ( $('#listprogress').text() == '' ) {
return;
}

// Need to pass a different set of options for each operation
var options = {};
switch (mode) {
case "block":
// Block target user
options = {
action: 'block',
expiry: ( isAnonymousUser(username) ? '1 year' : 'infinite' ),
reason: summary,
user: username,
reblock: true, // Without this, if they have an existing block (even a short 3 day one), the API would otherwise throw an alreadyblocked message.
bot: true
};
tokenOperation(options);
break;
case "unblock":
// Unblock target user
options = {
action: 'unblock',
reason: summary,
user: username,
bot: true
};
tokenOperation(options);
break;
default:
// Do nothing and abort.
return;
break;
}
}

// Perform an operation using the currently active account with a token.
function tokenOperation (options) {
// console.log(options);
var pagetitle = options.user;
api.postWithToken( "csrf", options )
.done( function( result, jqXHR ) {
$('#listsucceed div').html( $('#listprogress').text() + '<br>' + $('#listsucceed div').html());
$('#listprogress').text('');
if ( $('#listinput textarea').val() !== '' ) {
getCurrentTaskFromGUI();
}
})
.fail( function(code, result) {
// Actually it didn't "fail" per-se if they were already blocked indefinitely
if ( code == 'alreadyblocked') {
$('#listsucceed div').html( $('#listprogress').text() + ' --> already blocked' + '<br>' + $('#listsucceed div').html());
$('#listprogress').text('');

// Continue
getCurrentTaskFromGUI();
} else {
$('#listfailed div').html( $('#listprogress').text() + '<br>' + $('#listfailed div').html());
$('#listprogress').text('');
if ( code === "http" ) {
console.log( pagetitle + ": HTTP error: " + result.textStatus );
} else if ( code === "ok-but-empty" ) {
console.log( pagetitle + ": Got an empty response from the server" );
} else {
console.log( pagetitle + ": API error: " + code );
}
}
});
}

// Make the API connection, set up the GUI, respond to button pushes, loop through elements
function mainTaskFunction () {
// When user clicks run, pick up the current function and cycle through the list
$('input[name="run"]').click(function() {
console.log('user clicked run.');
if ( $('#listmode').val() == 'blank' ) {
console.log('User did not select a mode. Abort!');
return;
}
getCurrentTaskFromGUI();
});
// When user clicks reset, blank all fields
$('input[name="reset"]').click(function() {
console.log('user clicked reset.');
$('#listmode').val('blank');
$('#listsucceed div').html('');
$('#listfailed').html('');
$('#listinput textarea').text('');
$('#listprogress').text('');
$('#listprogress').text('');
$('#listsummary').val('');
});
}

// Prepare MediaWiki API functions
var api = new mw.Api();

// Create the user interface
makeTaskGUI();

// Add functions to the interface
mainTaskFunction();
}

// DEFER LOADING SCRIPT UNTIL JQUERY IS READY. WAIT 40MS BETWEEN ATTEMPTS.
function defer(method) {
if (window.jQuery) {
method();
} else {
setTimeout(function() { defer(method) }, 240);
}
}

// INITIALISATION
defer(function () {
mw.loader.using('mediawiki.api', function () {
var userrights = mw.config.get('wgUserGroups');
var pageurl = window.location.href;
if (userrights.indexOf('sysop') > -1) {
mwBlockScript();
} else {
console.log('Insufficient user rights: '+JSON.stringify(userrights));
}
});
});
</script></includeonly>

Widget:Block robot - Revision history

gww>Chieftain Alex at 21:53, 11 September 2026