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

2026-09-11T21:54:40Z

New page

<noinclude>{{#Widget:Rollback robot}}
== Description ==
This widget facilitates the automation of rollbacks. If you are doing lots of rollbacks, make sure to login to a bot account before using this page.

You will need the "rollback" permission on your account to use 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: 50%;
}
#fullwrapper input[type=text] {
width: 99%;
padding: 3px 2px;
}
#fullwrapper input[type=button] {
min-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>/* SCRIPT: ROLLBACK VANDALISM */
function mwRollbackScript (){
// Make the GUI.
function makeTaskGUI () {
// Initialise frame with required options.
var UIframe = $('<div id="fullwrapper">'
+'<div id="titlebar">AJAX contributions and rollback script</div>'
+'<div class="contentwrapper">'
+'<table><tbody>'
+'<tr>'
+'<td colspan="2"><textarea id="listuser" type="text" placeholder="Insert username to revert 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">'
+'<input name="contribs" type="button" value="Get contributions">'
+'<input name="rollback" type="button" value="Rollback contributions">'
+'<input name="reset" type="button" value="Reset">'
+'</td>'
+'</tr>'
+'</tbody></table>'
+'</div>'
+'</div>');
$('#widgettarget').html(UIframe);
}

// Fetch all the contributions
function apiQueryContributions (token) {
// Prepare URL: action = query, list = user contributions, limit = 500
var url = 'https://wiki.guildwars.com/api.php?action=query&format=json&list=usercontribs&uclimit=500&ucdir=newer&ucuser=' + user;
if (token) {
url += '&uccontinue=' + token
}

// Make the requests
$.getJSON(url).done(function(data){
datadrop.push(data['query']['usercontribs']);

// Check if more requests are necessary
if (data['continue']) {
apiQueryContributions(data['continue']['uccontinue']);
} else {
console.log('Contributions query complete.');
getTitles(datadrop);
}
});
}

// Collate all results
function getTitles (datadrop) {
// Nested array of request objects
var contribs = [];
$.each(datadrop, function(k,v){
$.each(v, function(kk,vv){
contribs.push(vv);
});
});

// Focus on titles
var titles = $.map(contribs, function(v){
return v.title;
});

// Helper function: Removes duplicates, blanks and undefined, then sorts. Usage: a.unique()
Array.prototype.unique = function() {
return this.filter(function (el, i, self) {
return self.indexOf(el) === i;
});
};

// Remove duplicates
titles = titles.unique();

// Return titles to UI
$('#listinput textarea').text( titles.join('\n') );
}

// Rollback an edit
function rollbackContributions () {

// 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'));

// Get single page from stack
var pagetitle = currentline;

// Do a rollback
api.rollback( pagetitle, user )
.done( function() {
$('#listsucceed div').html( $('#listprogress').text() + '<br>' + $('#listsucceed div').html());
$('#listprogress').text('');

// More on to next page
if (allpages.length > 0) {
rollbackContributions();
} else {
console.log('Finished rollbacks.')
}
})
.fail( function(code, response1, response2, jqXHR) {
// Actually it didn't "fail" per-se if it was rolledback by somebody else
if ( code == 'alreadyrolled') {
var pattern = new RegExp("The last edit to the page was by (.*) [\(]");
var hero = response1.error.info.match(pattern);
if (hero) {
$('#listsucceed div').html( $('#listprogress').text() + ' - <i>already reverted by and/or conflicting edits by ' + hero[1] + '</i>' + '<br>' + $('#listsucceed div').html());
console.log( pagetitle + ": API error: " + code + " by " + hero[1]);
} else {
$('#listsucceed div').html( $('#listprogress').text() + '<br>' + $('#listsucceed div').html());
console.log( pagetitle + ": API error: " + code);
}
$('#listprogress').text('');

// Continue
if (allpages.length > 0) {
rollbackContributions();
} else {
console.log('Finished rollbacks.');
}
} else {
// Other legitimate errors
$('#listfailed div').html( $('#listprogress').text() + '<br>' + $('#listfailed div').html());
$('#listprogress').text('');

// Full detail in console
if ( code == 'http' ) {
console.log( pagetitle + ": HTTP error: " + jqXHR.textStatus );
} else if ( code == 'ok-but-empty' ) {
console.log( pagetitle + ": Empty response from server." );
} else {
console.log( pagetitle + ": API error: " + code );
}
}
});
}

// Respond to button pushes
function mainTaskFunction () {
// When user clicks, get contributions
$('input[name="contribs"]').click(function() {
// Check user input box isn't blank
if ( $('#listuser').val() == '' ) {
console.log('You did not select a user to revert. Abort!');
return;
}

// Get username from the UI
user = $('#listuser').val().trim();

// Fetch contributions
console.log('User pressed button. Getting contributions for User:' + user + '...');
apiQueryContributions();
});

// When user clicks, rollback contributions
$('input[name="rollback"]').click(function() {
// Check user input box isn't blank
if ( $('#listuser').val() == '' ) {
console.log('You did not select a user to revert. Abort!');
return;
}

// Get username from the UI
user = $('#listuser').val().trim();

// Get contributions from the UI
var pages = $('#listinput textarea').val().split('\n');

// Fetch contributions
console.log('User pressed button. Rolling back contributions for User:' + user + '...');
rollbackContributions();
});

// When user clicks reset, blank all fields
$('input[name="reset"]').click(function() {
console.log('user clicked reset.');
$('#listuser').val('');
$('#listinput textarea').text('');
$('#listsucceed div').html('');
$('#listfailed div').html('');
$('#listprogress').text('');
$('#listsummary').val('');
});
}

// Initialise variables
var api = new mw.Api();
var user;
var datadrop = [];

// 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');
if (userrights.indexOf('sysop') > -1 || userrights.indexOf('bot') > -1 || userrights.indexOf('patrol') > -1 ) {
mwRollbackScript();
} else {
console.log('Insufficient user rights: '+JSON.stringify(userrights));
}
});
});
</script></includeonly>

Widget:Rollback robot - Revision history

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