MediaWiki:Gadget-morebits.js: Perbedaan antara revisi

Dari Wikipedia bahasa Indonesia, ensiklopedia bebas
Konten dihapus Konten ditambahkan
Krinkle (bicara | kontrib)
Maintenance: mw:RL/MGU - Updated deprecated module name
Repo at 5c1e7e3: Update from Github
Baris 1: Baris 1:
//<nowiki>
// <nowiki>
/**
/**
* morebits.js
* morebits.js
Baris 16: Baris 16:
* - The whole thing relies on jQuery. But most wikis should provide this by default.
* - The whole thing relies on jQuery. But most wikis should provide this by default.
* - Morebits.quickForm, Morebits.simpleWindow, and Morebits.status rely on the "morebits.css" file for their styling.
* - Morebits.quickForm, Morebits.simpleWindow, and Morebits.status rely on the "morebits.css" file for their styling.
* - Morebits.simpleWindow relies on jquery UI Dialog (ResourceLoader module name 'jquery.ui').
* - Morebits.simpleWindow relies on jquery UI Dialog (from ResourceLoader module name 'jquery.ui').
* - Morebits.quickForm tooltips rely on Tipsy (ResourceLoader module name 'jquery.tipsy').
* - Morebits.quickForm tooltips rely on Tipsy (ResourceLoader module name 'jquery.tipsy').
* For external installations, Tipsy is available at [http://onehackoranother.com/projects/jquery/tipsy].
* For external installations, Tipsy is available at [http://onehackoranother.com/projects/jquery/tipsy].
* - To create a gadget based on morebits.js, use this syntax in MediaWiki:Gadgets-definition:
* - To create a gadget based on morebits.js, use this syntax in MediaWiki:Gadgets-definition:
* * GadgetName[ResourceLoader|dependencies=mediawiki.user,mediawiki.util,jquery.ui,jquery.tipsy]|morebits.js|morebits.css|GadgetName.js
* * GadgetName[ResourceLoader|dependencies=mediawiki.user,mediawiki.util,jquery.ui,jquery.tipsy]|morebits.js|morebits.css|GadgetName.js
* - Alternatively, you can configure morebits.js as a hidden gadget in MediaWiki:Gadgets-definition:
* * morebits[ResourceLoader|dependencies=mediawiki.user,mediawiki.util,jquery.ui,jquery.tipsy|hidden]|morebits.js|morebits.css
* and then load ext.gadget.morebits as one of the dependencies for the new gadget
*
*
* Most of the stuff here doesn't work on IE < 9. It is your script's responsibility to enforce this.
* All the stuff here works on all browsers for which MediaWiki provides JavaScript support.
*
*
* This library is maintained by the maintainers of Twinkle.
* This library is maintained by the maintainers of Twinkle.
Baris 30: Baris 33:




( function ( window, document, $, undefined ) { // Wrap entire file with anonymous function
(function (window, document, $) { // Wrap entire file with anonymous function


var Morebits = {};
var Morebits = {};
Baris 43: Baris 46:
* @returns {boolean}
* @returns {boolean}
*/
*/
Morebits.userIsInGroup = function ( group ) {
Morebits.userIsInGroup = function (group) {
return mw.config.get( 'wgUserGroups' ).indexOf( group ) !== -1;
return mw.config.get('wgUserGroups').indexOf(group) !== -1;
};
};
// Used a lot
Morebits.userIsSysop = Morebits.userIsInGroup('sysop');




Baris 54: Baris 59:
* includes/utils/IP.php.
* includes/utils/IP.php.
* Converts an IPv6 address to the canonical form stored and used by MediaWiki.
* Converts an IPv6 address to the canonical form stored and used by MediaWiki.
* @param {string} address - The IPv6 address
* @returns {string}
*/
*/
Morebits.sanitizeIPv6 = function ( address ) {
Morebits.sanitizeIPv6 = function (address) {
address = address.trim();
address = address.trim();
if ( address === '' ) {
if (address === '') {
return null;
return null;
}
}
if ( !mw.util.isIPv6Address( address ) ) {
if (!mw.util.isIPv6Address(address)) {
return address; // nothing else to do for IPv4 addresses or invalid ones
return address; // nothing else to do for IPv4 addresses or invalid ones
}
}
Baris 66: Baris 73:
address = address.toUpperCase();
address = address.toUpperCase();
// Expand zero abbreviations
// Expand zero abbreviations
var abbrevPos = address.indexOf( '::' );
var abbrevPos = address.indexOf('::');
if ( abbrevPos > -1 ) {
if (abbrevPos > -1) {
// We know this is valid IPv6. Find the last index of the
// We know this is valid IPv6. Find the last index of the
// address before any CIDR number (e.g. "a:b:c::/24").
// address before any CIDR number (e.g. "a:b:c::/24").
var CIDRStart = address.indexOf( '/' );
var CIDRStart = address.indexOf('/');
var addressEnd = ( CIDRStart > -1 ) ? CIDRStart - 1 : address.length - 1;
var addressEnd = CIDRStart > -1 ? CIDRStart - 1 : address.length - 1;
// If the '::' is at the beginning...
// If the '::' is at the beginning...
var repeat, extra, pad;
var repeat, extra, pad;
if ( abbrevPos === 0 ) {
if (abbrevPos === 0) {
repeat = '0:';
repeat = '0:';
extra = ( address == '::' ) ? '0' : ''; // for the address '::'
extra = address === '::' ? '0' : ''; // for the address '::'
pad = 9; // 7+2 (due to '::')
pad = 9; // 7+2 (due to '::')
// If the '::' is at the end...
// If the '::' is at the end...
} else if ( abbrevPos === ( addressEnd - 1 ) ) {
} else if (abbrevPos === (addressEnd - 1)) {
repeat = ':0';
repeat = ':0';
extra = '';
extra = '';
Baris 90: Baris 97:
}
}
var replacement = repeat;
var replacement = repeat;
pad -= address.split( ':' ).length - 1;
pad -= address.split(':').length - 1;
for ( var i = 1; i < pad; i++ ) {
for (var i = 1; i < pad; i++) {
replacement += repeat;
replacement += repeat;
}
}
replacement += extra;
replacement += extra;
address = address.replace( '::', replacement );
address = address.replace('::', replacement);
}
}
// Remove leading zeros from each bloc as needed
// Remove leading zeros from each bloc as needed
address = address.replace( /(^|:)0+([0-9A-Fa-f]{1,4})/g, '$1$2' );
address = address.replace(/(^|:)0+([0-9A-Fa-f]{1,4})/g, '$1$2');


return address;
return address;
Baris 113: Baris 120:
*
*
* select A combo box (aka drop-down).
* select A combo box (aka drop-down).
* - Attributes: name, label, multiple, size, list, event
* - Attributes: name, label, multiple, size, list, event, disabled
* option An element for a combo box.
* option An element for a combo box.
* - Attributes: value, label, selected, disabled
* - Attributes: value, label, selected, disabled
Baris 127: Baris 134:
* - Attributes (within list): name, label, value, checked, disabled, event, subgroup
* - Attributes (within list): name, label, value, checked, disabled, event, subgroup
* input A text box.
* input A text box.
* - Attributes: name, label, value, size, disabled, readonly, maxlength, event
* - Attributes: name, label, value, size, disabled, required, readonly, maxlength, event
* dyninput A set of text boxes with "Remove" buttons and an "Add" button.
* dyninput A set of text boxes with "Remove" buttons and an "Add" button.
* - Attributes: name, label, min, max, sublabel, value, size, maxlength, event
* - Attributes: name, label, min, max, sublabel, value, size, maxlength, event
Baris 141: Baris 148:
* - Attributes: name, label, disabled, event
* - Attributes: name, label, disabled, event
* textarea A big, multi-line text box.
* textarea A big, multi-line text box.
* - Attributes: name, label, value, cols, rows, disabled, readonly
* - Attributes: name, label, value, cols, rows, disabled, required, readonly
* fragment A DocumentFragment object.
* fragment A DocumentFragment object.
* - No attributes, and no global attributes except adminonly
* - No attributes, and no global attributes except adminonly
Baris 150: Baris 157:
/**
/**
* @constructor
* @constructor
* @param {event} event Function to execute when form is submitted
* @param {event} event - Function to execute when form is submitted
* @param {*} eventType
* @param {string} [eventType=submit] - Type of the event (default: submit)
*/
*/
Morebits.quickForm = function QuickForm( event, eventType ) {
Morebits.quickForm = function QuickForm(event, eventType) {
this.root = new Morebits.quickForm.element( { type: 'form', event: event, eventType:eventType } );
this.root = new Morebits.quickForm.element({ type: 'form', event: event, eventType: eventType });
};
};


Baris 169: Baris 176:
/**
/**
* Append element to the form
* Append element to the form
* @param {Morebits.quickForm.element} data
* @param {(Object|Morebits.quickForm.element)} data - a quickform element, or the object with which
* a quickform element is constructed.
* @returns {Morebits.quickForm.element} - same as what is passed to the function
*/
*/
Morebits.quickForm.prototype.append = function QuickFormAppend( data ) {
Morebits.quickForm.prototype.append = function QuickFormAppend(data) {
return this.root.append( data );
return this.root.append(data);
};
};


/**
/**
* @constructor
* @constructor
* @param {Object} data - Object representing the quickform element. See class documentation
* @param {Object}
* comment for available types and attributes for each.
*/
*/
Morebits.quickForm.element = function QuickFormElement( data ) {
Morebits.quickForm.element = function QuickFormElement(data) {
this.data = data;
this.data = data;
this.childs = [];
this.childs = [];
Baris 193: Baris 203:
* @returns {Morebits.quickForm.element} The same element passed in
* @returns {Morebits.quickForm.element} The same element passed in
*/
*/
Morebits.quickForm.element.prototype.append = function QuickFormElementAppend( data ) {
Morebits.quickForm.element.prototype.append = function QuickFormElementAppend(data) {
var child;
var child;
if( data instanceof Morebits.quickForm.element ) {
if (data instanceof Morebits.quickForm.element) {
child = data;
child = data;
} else {
} else {
child = new Morebits.quickForm.element( data );
child = new Morebits.quickForm.element(data);
}
}
this.childs.push( child );
this.childs.push(child);
return child;
return child;
};
};
Baris 209: Baris 219:
* @returns {HTMLElement}
* @returns {HTMLElement}
*/
*/
Morebits.quickForm.element.prototype.render = function QuickFormElementRender( internal_subgroup_id ) {
Morebits.quickForm.element.prototype.render = function QuickFormElementRender(internal_subgroup_id) {
var currentNode = this.compute( this.data, internal_subgroup_id );
var currentNode = this.compute(this.data, internal_subgroup_id);


for( var i = 0; i < this.childs.length; ++i ) {
for (var i = 0; i < this.childs.length; ++i) {
// do not pass internal_subgroup_id to recursive calls
// do not pass internal_subgroup_id to recursive calls
currentNode[1].appendChild( this.childs[i].render() );
currentNode[1].appendChild(this.childs[i].render());
}
}
return currentNode[0];
return currentNode[0];
};
};


Morebits.quickForm.element.prototype.compute = function QuickFormElementCompute( data, in_id ) {
Morebits.quickForm.element.prototype.compute = function QuickFormElementCompute(data, in_id) {
var node;
var node;
var childContainder = null;
var childContainder = null;
var label;
var label;
var id = ( in_id ? in_id + '_' : '' ) + 'node_' + this.id;
var id = (in_id ? in_id + '_' : '') + 'node_' + this.id;
if( data.adminonly && !Morebits.userIsInGroup( 'sysop' ) ) {
if (data.adminonly && !Morebits.userIsSysop) {
// hell hack alpha
// hell hack alpha
data.type = 'hidden';
data.type = 'hidden';
Baris 230: Baris 240:


var i, current, subnode;
var i, current, subnode;
switch( data.type ) {
switch (data.type) {
case 'form':
case 'form':
node = document.createElement( 'form' );
node = document.createElement('form');
node.className = "quickform";
node.className = 'quickform';
node.setAttribute( 'action', 'javascript:void(0);');
node.setAttribute('action', 'javascript:void(0);');
if( data.event ) {
if (data.event) {
node.addEventListener( data.eventType || 'submit', data.event , false );
node.addEventListener(data.eventType || 'submit', data.event, false);
}
}
break;
break;
case 'fragment':
case 'fragment':
node = document.createDocumentFragment();
node = document.createDocumentFragment();
// fragments can't have any attributes, so just return it straight away
// fragments can't have any attributes, so just return it straight away
return [ node, node ];
return [ node, node ];
case 'select':
case 'select':
node = document.createElement( 'div' );
node = document.createElement('div');


node.setAttribute( 'id', 'div_' + id );
node.setAttribute('id', 'div_' + id);
if( data.label ) {
if (data.label) {
label = node.appendChild( document.createElement( 'label' ) );
label = node.appendChild(document.createElement('label'));
label.setAttribute( 'for', id );
label.setAttribute('for', id);
label.appendChild( document.createTextNode( data.label ) );
label.appendChild(document.createTextNode(data.label));
}
}
var select = node.appendChild( document.createElement( 'select' ) );
var select = node.appendChild(document.createElement('select'));
if( data.event ) {
if (data.event) {
select.addEventListener( 'change', data.event, false );
select.addEventListener('change', data.event, false);
}
}
if( data.multiple ) {
if (data.multiple) {
select.setAttribute( 'multiple', 'multiple' );
select.setAttribute('multiple', 'multiple');
}
}
if( data.size ) {
if (data.size) {
select.setAttribute( 'size', data.size );
select.setAttribute('size', data.size);
}
}
if (data.disabled) {
select.setAttribute( 'name', data.name );
select.setAttribute('disabled', 'disabled');
}
select.setAttribute('name', data.name);


if( data.list ) {
if (data.list) {
for( i = 0; i < data.list.length; ++i ) {
for (i = 0; i < data.list.length; ++i) {


current = data.list[i];
current = data.list[i];


if( current.list ) {
if (current.list) {
current.type = 'optgroup';
current.type = 'optgroup';
} else {
} else {
current.type = 'option';
current.type = 'option';
}
}


subnode = this.compute( current );
subnode = this.compute(current);
select.appendChild( subnode[0] );
select.appendChild(subnode[0]);
}
}
}
childContainder = select;
}
break;
childContainder = select;
case 'option':
break;
case 'option':
node = document.createElement('option');
node = document.createElement( 'option' );
node.values = data.value;
node.values = data.value;
node.setAttribute('value', data.value);
if (data.selected) {
node.setAttribute( 'value', data.value );
if( data.selected ) {
node.setAttribute('selected', 'selected');
}
node.setAttribute( 'selected', 'selected' );
if (data.disabled) {
}
if( data.disabled ) {
node.setAttribute('disabled', 'disabled');
}
node.setAttribute( 'disabled', 'disabled' );
node.setAttribute('label', data.label);
}
node.setAttribute( 'label', data.label );
node.appendChild(document.createTextNode(data.label));
break;
node.appendChild( document.createTextNode( data.label ) );
case 'optgroup':
break;
case 'optgroup':
node = document.createElement('optgroup');
node = document.createElement( 'optgroup' );
node.setAttribute('label', data.label);
node.setAttribute( 'label', data.label );


if( data.list ) {
if (data.list) {
for( i = 0; i < data.list.length; ++i ) {
for (i = 0; i < data.list.length; ++i) {


current = data.list[i];
current = data.list[i];
current.type = 'option'; //must be options here
current.type = 'option'; // must be options here


subnode = this.compute( current );
subnode = this.compute(current);
node.appendChild( subnode[0] );
node.appendChild(subnode[0]);
}
}
}
}
break;
case 'field':
break;
node = document.createElement('fieldset');
case 'field':
node = document.createElement( 'fieldset' );
label = node.appendChild(document.createElement('legend'));
label = node.appendChild( document.createElement( 'legend' ) );
label.appendChild(document.createTextNode(data.label));
if (data.name) {
label.appendChild( document.createTextNode( data.label ) );
if( data.name ) {
node.setAttribute('name', data.name);
}
node.setAttribute( 'name', data.name );
if (data.disabled) {
}
if( data.disabled ) {
node.setAttribute('disabled', 'disabled');
}
node.setAttribute( 'disabled', 'disabled' );
}
break;
case 'checkbox':
break;
case 'checkbox':
case 'radio':
node = document.createElement('div');
case 'radio':
if (data.list) {
node = document.createElement( 'div' );
if( data.list ) {
for (i = 0; i < data.list.length; ++i) {
for( i = 0; i < data.list.length; ++i ) {
var cur_id = id + '_' + i;
var cur_id = id + '_' + i;
current = data.list[i];
current = data.list[i];
var cur_div;
if (current.type === 'header') {
var cur_div;
if( current.type === 'header' ) {
// inline hack
// inline hack
cur_div = node.appendChild( document.createElement( 'h6' ) );
cur_div = node.appendChild(document.createElement('h6'));
cur_div.appendChild( document.createTextNode( current.label ) );
cur_div.appendChild(document.createTextNode(current.label));
if( current.tooltip ) {
if (current.tooltip) {
Morebits.quickForm.element.generateTooltip( cur_div , current );
Morebits.quickForm.element.generateTooltip(cur_div, current);
}
continue;
}
}
cur_div = node.appendChild(document.createElement('div'));
continue;
subnode = cur_div.appendChild(document.createElement('input'));
}
subnode.values = current.value;
cur_div = node.appendChild( document.createElement( 'div' ) );
subnode = cur_div.appendChild( document.createElement( 'input' ) );
subnode.setAttribute('value', current.value);
subnode.values = current.value;
subnode.setAttribute('name', current.name || data.name);
subnode.setAttribute( 'value', current.value );
subnode.setAttribute('type', data.type);
subnode.setAttribute( 'name', current.name || data.name );
subnode.setAttribute('id', cur_id);
subnode.setAttribute( 'type', data.type );
subnode.setAttribute( 'id', cur_id );

if( current.checked ) {
subnode.setAttribute( 'checked', 'checked' );
}
if( current.disabled ) {
subnode.setAttribute( 'disabled', 'disabled' );
}
label = cur_div.appendChild( document.createElement( 'label' ) );
label.appendChild( document.createTextNode( current.label ) );
label.setAttribute( 'for', cur_id );
if( current.tooltip ) {
Morebits.quickForm.element.generateTooltip( label, current );
}
// styles go on the label, doesn't make sense to style a checkbox/radio
if( current.style ) {
label.setAttribute( 'style', current.style );
}

var event;
if( current.subgroup ) {
var tmpgroup = current.subgroup;


if( ! Array.isArray( tmpgroup ) ) {
if (current.checked) {
subnode.setAttribute('checked', 'checked');
tmpgroup = [ tmpgroup ];
}
if (current.disabled) {
subnode.setAttribute('disabled', 'disabled');
}
label = cur_div.appendChild(document.createElement('label'));
label.appendChild(document.createTextNode(current.label));
label.setAttribute('for', cur_id);
if (current.tooltip) {
Morebits.quickForm.element.generateTooltip(label, current);
}
// styles go on the label, doesn't make sense to style a checkbox/radio
if (current.style) {
label.setAttribute('style', current.style);
}
}


var event;
var subgroupRaw = new Morebits.quickForm.element({
if (current.subgroup) {
type: 'div',
id: id + '_' + i + '_subgroup'
var tmpgroup = current.subgroup;

});
$.each( tmpgroup, function( idx, el ) {
if (!Array.isArray(tmpgroup)) {
var newEl = $.extend( {}, el );
tmpgroup = [ tmpgroup ];
if( ! newEl.type ) {
newEl.type = data.type;
}
}
newEl.name = (current.name || data.name) + '.' + newEl.name;
subgroupRaw.append( newEl );
} );


var subgroup = subgroupRaw.render( cur_id );
var subgroupRaw = new Morebits.quickForm.element({
type: 'div',
subgroup.className = "quickformSubgroup";
id: id + '_' + i + '_subgroup'
subnode.subgroup = subgroup;
subnode.shown = false;
});
$.each(tmpgroup, function(idx, el) {
var newEl = $.extend({}, el);
if (!newEl.type) {
newEl.type = data.type;
}
newEl.name = (current.name || data.name) + '.' + newEl.name;
subgroupRaw.append(newEl);
});


event = function(e) {
var subgroup = subgroupRaw.render(cur_id);
subgroup.className = 'quickformSubgroup';
if( e.target.checked ) {
e.target.parentNode.appendChild( e.target.subgroup );
subnode.subgroup = subgroup;
if( e.target.type === 'radio' ) {
subnode.shown = false;

var name = e.target.name;
if( e.target.form.names[name] !== undefined ) {
event = function(e) {
if (e.target.checked) {
e.target.form.names[name].parentNode.removeChild( e.target.form.names[name].subgroup );
e.target.parentNode.appendChild(e.target.subgroup);
if (e.target.type === 'radio') {
var name = e.target.name;
if (e.target.form.names[name] !== undefined) {
e.target.form.names[name].parentNode.removeChild(e.target.form.names[name].subgroup);
}
e.target.form.names[name] = e.target;
}
}
} else {
e.target.form.names[name] = e.target;
e.target.parentNode.removeChild(e.target.subgroup);
}
}
} else {
};
subnode.addEventListener('change', event, true);
e.target.parentNode.removeChild( e.target.subgroup );
if (current.checked) {
subnode.parentNode.appendChild(subgroup);
}
}
} else if (data.type === 'radio') {
};
event = function(e) {
subnode.addEventListener( 'change', event, true );
if( current.checked ) {
if (e.target.checked) {
var name = e.target.name;
subnode.parentNode.appendChild( subgroup );
if (e.target.form.names[name] !== undefined) {
}
e.target.form.names[name].parentNode.removeChild(e.target.form.names[name].subgroup);
} else if( data.type === 'radio' ) {
}
event = function(e) {
if( e.target.checked ) {
delete e.target.form.names[name];
var name = e.target.name;
if( e.target.form.names[name] !== undefined ) {
e.target.form.names[name].parentNode.removeChild( e.target.form.names[name].subgroup );
}
}
};
delete e.target.form.names[name];
subnode.addEventListener('change', event, true);
}
};
}
// add users' event last, so it can interact with the subgroup
subnode.addEventListener( 'change', event, true );
if (data.event) {
}
subnode.addEventListener('change', data.event, false);
// add users' event last, so it can interact with the subgroup
if( data.event ) {
} else if (current.event) {
subnode.addEventListener( 'change', data.event, false );
subnode.addEventListener('change', current.event, true);
}
} else if ( current.event ) {
subnode.addEventListener( 'change', current.event, true );
}
}
}
}
}
break;
case 'input':
break;
node = document.createElement('div');
case 'input':
node = document.createElement( 'div' );
node.setAttribute('id', 'div_' + id);
node.setAttribute( 'id', 'div_' + id );


if( data.label ) {
if (data.label) {
label = node.appendChild( document.createElement( 'label' ) );
label = node.appendChild(document.createElement('label'));
label.appendChild( document.createTextNode( data.label ) );
label.appendChild(document.createTextNode(data.label));
label.setAttribute( 'for', id );
label.setAttribute('for', data.id || id);
}
}


subnode = node.appendChild( document.createElement( 'input' ) );
subnode = node.appendChild(document.createElement('input'));
if( data.value ) {
if (data.value) {
subnode.setAttribute( 'value', data.value );
subnode.setAttribute('value', data.value);
}
}
subnode.setAttribute( 'name', data.name );
subnode.setAttribute('name', data.name);
subnode.setAttribute( 'id', id );
subnode.setAttribute('type', 'text');
if (data.size) {
subnode.setAttribute( 'type', 'text' );
if( data.size ) {
subnode.setAttribute('size', data.size);
}
subnode.setAttribute( 'size', data.size );
if (data.disabled) {
}
if( data.disabled ) {
subnode.setAttribute('disabled', 'disabled');
}
subnode.setAttribute( 'disabled', 'disabled' );
if (data.required) {
}
subnode.setAttribute('required', 'required');
if( data.readonly ) {
}
subnode.setAttribute( 'readonly', 'readonly' );
if (data.readonly) {
}
subnode.setAttribute('readonly', 'readonly');
if( data.maxlength ) {
}
subnode.setAttribute( 'maxlength', data.maxlength );
if (data.maxlength) {
}
subnode.setAttribute('maxlength', data.maxlength);
if( data.event ) {
}
subnode.addEventListener( 'keyup', data.event, false );
if (data.event) {
}
subnode.addEventListener('keyup', data.event, false);
break;
}
case 'dyninput':
childContainder = subnode;
var min = data.min || 1;
break;
var max = data.max || Infinity;
case 'dyninput':
var min = data.min || 1;
var max = data.max || Infinity;


node = document.createElement( 'div' );
node = document.createElement('div');


label = node.appendChild( document.createElement( 'h5' ) );
label = node.appendChild(document.createElement('h5'));
label.appendChild( document.createTextNode( data.label ) );
label.appendChild(document.createTextNode(data.label));


var listNode = node.appendChild( document.createElement( 'div' ) );
var listNode = node.appendChild(document.createElement('div'));


var more = this.compute( {
var more = this.compute({
type: 'button',
type: 'button',
label: 'more',
label: 'more',
disabled: min >= max,
disabled: min >= max,
event: function(e) {
event: function(e) {
var new_node = new Morebits.quickForm.element( e.target.sublist );
var new_node = new Morebits.quickForm.element(e.target.sublist);
e.target.area.appendChild( new_node.render() );
e.target.area.appendChild(new_node.render());


if( ++e.target.counter >= e.target.max ) {
if (++e.target.counter >= e.target.max) {
e.target.setAttribute( 'disabled', 'disabled' );
e.target.setAttribute('disabled', 'disabled');
}
}
e.stopPropagation();
e.stopPropagation();
}
}
} );
});


node.appendChild( more[0] );
node.appendChild(more[0]);
var moreButton = more[1];
var moreButton = more[1];


var sublist = {
var sublist = {
type: '_dyninput_element',
type: '_dyninput_element',
label: data.sublabel || data.label,
label: data.sublabel || data.label,
name: data.name,
name: data.name,
value: data.value,
value: data.value,
size: data.size,
size: data.size,
remove: false,
remove: false,
maxlength: data.maxlength,
maxlength: data.maxlength,
event: data.event
event: data.event
};
};


for( i = 0; i < min; ++i ) {
for (i = 0; i < min; ++i) {
var elem = new Morebits.quickForm.element( sublist );
var elem = new Morebits.quickForm.element(sublist);
listNode.appendChild( elem.render() );
listNode.appendChild(elem.render());
}
}
sublist.remove = true;
sublist.remove = true;
sublist.morebutton = moreButton;
sublist.morebutton = moreButton;
sublist.listnode = listNode;
sublist.listnode = listNode;


moreButton.sublist = sublist;
moreButton.sublist = sublist;
moreButton.area = listNode;
moreButton.area = listNode;
moreButton.max = max - min;
moreButton.max = max - min;
moreButton.counter = 0;
moreButton.counter = 0;
break;
break;
case '_dyninput_element': // Private, similar to normal input
case '_dyninput_element': // Private, similar to normal input
node = document.createElement( 'div' );
node = document.createElement('div');


if( data.label ) {
if (data.label) {
label = node.appendChild( document.createElement( 'label' ) );
label = node.appendChild(document.createElement('label'));
label.appendChild( document.createTextNode( data.label ) );
label.appendChild(document.createTextNode(data.label));
label.setAttribute( 'for', id );
label.setAttribute('for', id);
}
}


subnode = node.appendChild( document.createElement( 'input' ) );
subnode = node.appendChild(document.createElement('input'));
if( data.value ) {
if (data.value) {
subnode.setAttribute( 'value', data.value );
subnode.setAttribute('value', data.value);
}
}
subnode.setAttribute( 'name', data.name );
subnode.setAttribute('name', data.name);
subnode.setAttribute( 'type', 'text' );
subnode.setAttribute('type', 'text');
if( data.size ) {
if (data.size) {
subnode.setAttribute( 'size', data.size );
subnode.setAttribute('size', data.size);
}
}
if( data.maxlength ) {
if (data.maxlength) {
subnode.setAttribute( 'maxlength', data.maxlength );
subnode.setAttribute('maxlength', data.maxlength);
}
}
if( data.event ) {
if (data.event) {
subnode.addEventListener( 'keyup', data.event, false );
subnode.addEventListener('keyup', data.event, false);
}
}
if( data.remove ) {
if (data.remove) {
var remove = this.compute( {
var remove = this.compute({
type: 'button',
type: 'button',
label: 'remove',
label: 'remove',
Baris 546: Baris 562:
var more = e.target.morebutton;
var more = e.target.morebutton;


list.removeChild( node );
list.removeChild(node);
--more.counter;
--more.counter;
more.removeAttribute( 'disabled' );
more.removeAttribute('disabled');
e.stopPropagation();
e.stopPropagation();
}
}
} );
});
node.appendChild( remove[0] );
node.appendChild(remove[0]);
var removeButton = remove[1];
var removeButton = remove[1];
removeButton.inputnode = node;
removeButton.inputnode = node;
removeButton.listnode = data.listnode;
removeButton.listnode = data.listnode;
removeButton.morebutton = data.morebutton;
removeButton.morebutton = data.morebutton;
}
break;
case 'hidden':
node = document.createElement( 'input' );
node.setAttribute( 'type', 'hidden' );
node.values = data.value;
node.setAttribute( 'value', data.value );
node.setAttribute( 'name', data.name );
break;
case 'header':
node = document.createElement( 'h5' );
node.appendChild( document.createTextNode( data.label ) );
break;
case 'div':
node = document.createElement( 'div' );
if (data.name) {
node.setAttribute( 'name', data.name );
}
if (data.label) {
if ( ! Array.isArray( data.label ) ) {
data.label = [ data.label ];
}
}
break;
var result = document.createElement( 'span' );
case 'hidden':
result.className = 'quickformDescription';
node = document.createElement('input');
for( i = 0; i < data.label.length; ++i ) {
node.setAttribute('type', 'hidden');
if( typeof data.label[i] === 'string' ) {
node.values = data.value;
result.appendChild( document.createTextNode( data.label[i] ) );
node.setAttribute('value', data.value);
} else if( data.label[i] instanceof Element ) {
result.appendChild( data.label[i] );
node.setAttribute('name', data.name);
break;
case 'header':
node = document.createElement('h5');
node.appendChild(document.createTextNode(data.label));
break;
case 'div':
node = document.createElement('div');
if (data.name) {
node.setAttribute('name', data.name);
}
if (data.label) {
if (!Array.isArray(data.label)) {
data.label = [ data.label ];
}
var result = document.createElement('span');
result.className = 'quickformDescription';
for (i = 0; i < data.label.length; ++i) {
if (typeof data.label[i] === 'string') {
result.appendChild(document.createTextNode(data.label[i]));
} else if (data.label[i] instanceof Element) {
result.appendChild(data.label[i]);
}
}
}
node.appendChild(result);
}
}
break;
node.appendChild( result );
case 'submit':
}
node = document.createElement('span');
break;
childContainder = node.appendChild(document.createElement('input'));
case 'submit':
childContainder.setAttribute('type', 'submit');
node = document.createElement( 'span' );
if (data.label) {
childContainder = node.appendChild(document.createElement( 'input' ));
childContainder.setAttribute( 'type', 'submit' );
childContainder.setAttribute('value', data.label);
}
if( data.label ) {
childContainder.setAttribute( 'value', data.label );
childContainder.setAttribute('name', data.name || 'submit');
if (data.disabled) {
}
childContainder.setAttribute( 'name', data.name || 'submit' );
childContainder.setAttribute('disabled', 'disabled');
}
if( data.disabled ) {
break;
childContainder.setAttribute( 'disabled', 'disabled' );
case 'button':
}
node = document.createElement('span');
break;
childContainder = node.appendChild(document.createElement('input'));
case 'button':
childContainder.setAttribute('type', 'button');
node = document.createElement( 'span' );
if (data.label) {
childContainder = node.appendChild(document.createElement( 'input' ));
childContainder.setAttribute( 'type', 'button' );
childContainder.setAttribute('value', data.label);
}
if( data.label ) {
childContainder.setAttribute( 'value', data.label );
childContainder.setAttribute('name', data.name);
if (data.disabled) {
}
childContainder.setAttribute( 'name', data.name );
childContainder.setAttribute('disabled', 'disabled');
}
if( data.disabled ) {
if (data.event) {
childContainder.setAttribute( 'disabled', 'disabled' );
childContainder.addEventListener('click', data.event, false);
}
}
if( data.event ) {
break;
childContainder.addEventListener( 'click', data.event, false );
case 'textarea':
}
node = document.createElement('div');
break;
node.setAttribute('id', 'div_' + id);
case 'textarea':
if (data.label) {
node = document.createElement( 'div' );
label = node.appendChild(document.createElement('h5'));
node.setAttribute( 'id', 'div_' + id );
var labelElement = document.createElement('label');
if( data.label ) {
labelElement.textContent = data.label;
label = node.appendChild( document.createElement( 'h5' ) );
labelElement.setAttribute('for', data.id || id);
label.appendChild( document.createTextNode( data.label ) );
label.appendChild(labelElement);
// TODO need to nest a <label> tag in here without creating extra vertical space
}
//label.setAttribute( 'for', id );
subnode = node.appendChild(document.createElement('textarea'));
}
subnode = node.appendChild( document.createElement( 'textarea' ) );
subnode.setAttribute('name', data.name);
if (data.cols) {
subnode.setAttribute( 'name', data.name );
if( data.cols ) {
subnode.setAttribute('cols', data.cols);
}
subnode.setAttribute( 'cols', data.cols );
if (data.rows) {
}
if( data.rows ) {
subnode.setAttribute('rows', data.rows);
}
subnode.setAttribute( 'rows', data.rows );
if (data.disabled) {
}
if( data.disabled ) {
subnode.setAttribute('disabled', 'disabled');
}
subnode.setAttribute( 'disabled', 'disabled' );
if (data.required) {
}
subnode.setAttribute('required', 'required');
if( data.readonly ) {
}
subnode.setAttribute( 'readonly', 'readonly' );
if (data.readonly) {
}
subnode.setAttribute('readonly', 'readonly');
if( data.value ) {
}
subnode.value = data.value;
if (data.value) {
}
subnode.value = data.value;
break;
}
default:
childContainder = subnode;
throw new Error("Morebits.quickForm: unknown element type " + data.type.toString());
break;
default:
throw new Error('Morebits.quickForm: unknown element type ' + data.type.toString());
}
}


if( !childContainder ) {
if (!childContainder) {
childContainder = node;
childContainder = node;
}
}
if( data.tooltip ) {
if (data.tooltip) {
Morebits.quickForm.element.generateTooltip( label || node , data );
Morebits.quickForm.element.generateTooltip(label || node, data);
}
}


if( data.extra ) {
if (data.extra) {
childContainder.extra = data.extra;
childContainder.extra = data.extra;
}
}
if( data.style ) {
if (data.style) {
childContainder.setAttribute( 'style', data.style );
childContainder.setAttribute('style', data.style);
}
}
if( data.className ) {
if (data.className) {
childContainder.className = ( childContainder.className ?
childContainder.className = childContainder.className ?
childContainder.className + " " + data.className :
childContainder.className + ' ' + data.className :
data.className );
data.className;
}
}
childContainder.setAttribute( 'id', data.id || id );
childContainder.setAttribute('id', data.id || id);


return [ node, childContainder ];
return [ node, childContainder ];
Baris 673: Baris 694:


Morebits.quickForm.element.autoNWSW = function() {
Morebits.quickForm.element.autoNWSW = function() {
return $(this).offset().top > ($(document).scrollTop() + $(window).height() / 2) ? 'sw' : 'nw';
return $(this).offset().top > ($(document).scrollTop() + ($(window).height() / 2)) ? 'sw' : 'nw';
};
};


/**
/**
* Create a jquery.tipsy-based tooltip.
* @param {HTMLElement} node
* @requires jquery.tipsy
* @param {Object} data
* @param {HTMLElement} node - the HTML element beside which a tooltip is to be generated
* @param {Object} data - tooltip-related configuration data
*/
*/
Morebits.quickForm.element.generateTooltip = function QuickFormElementGenerateTooltip( node, data ) {
Morebits.quickForm.element.generateTooltip = function QuickFormElementGenerateTooltip(node, data) {
$('<span/>', {
$('<span/>', {
'class': 'ui-icon ui-icon-help ui-icon-inline morebits-tooltip'
'class': 'ui-icon ui-icon-help ui-icon-inline morebits-tooltip'
}).appendTo(node).tipsy({
}).appendTo(node).tipsy({
'fallback': data.tooltip,
'fallback': data.tooltip,
'fade': true,
'fade': true,
'gravity': (data.type === "input" || data.type === "select") ?
'gravity': data.type === 'input' || data.type === 'select' ?
Morebits.quickForm.element.autoNWSW : $.fn.tipsy.autoWE,
Morebits.quickForm.element.autoNWSW : $.fn.tipsy.autoWE,
'html': true,
'html': true,
'delayOut': 250
'delayOut': 250
});
});
};
};


Baris 700: Baris 723:
/**
/**
* Returns all form elements with a given field name or ID
* Returns all form elements with a given field name or ID
* @returns {HTMLElement[]}
* @param {HTMLFormElement} form
* @param {string} fieldName - the name or id of the fields
* @returns {HTMLElement[]} - array of matching form elements
*/
*/
Morebits.quickForm.getElements = function QuickFormGetElements(form, fieldName) {
Morebits.quickForm.getElements = function QuickFormGetElements(form, fieldName) {
Baris 718: Baris 743:
* Searches the array of elements for a checkbox or radio button with a certain
* Searches the array of elements for a checkbox or radio button with a certain
* `value` attribute, and returns the first such element. Returns null if not found.
* `value` attribute, and returns the first such element. Returns null if not found.
* @param {HTMLInputElement[]} elementArray
* @param {HTMLInputElement[]} elementArray - array of checkbox or radio elements
* @param {string} value
* @param {string} value - value to search for
* @returns {HTMLInputElement}
* @returns {HTMLInputElement}
*/
*/
Baris 757: Baris 782:
Morebits.quickForm.getElementLabelObject = function QuickFormGetElementLabelObject(element) {
Morebits.quickForm.getElementLabelObject = function QuickFormGetElementLabelObject(element) {
// for buttons, divs and headers, the label is on the element itself
// for buttons, divs and headers, the label is on the element itself
if (element.type === "button" || element.type === "submit" ||
if (element.type === 'button' || element.type === 'submit' ||
element instanceof HTMLDivElement || element instanceof HTMLHeadingElement) {
element instanceof HTMLDivElement || element instanceof HTMLHeadingElement) {
return element;
return element;

// for fieldsets, the label is the child <legend> element
// for fieldsets, the label is the child <legend> element
} else if (element instanceof HTMLFieldSetElement) {
} else if (element instanceof HTMLFieldSetElement) {
return element.getElementsByTagName("legend")[0];
return element.getElementsByTagName('legend')[0];

// for textareas, the label is the sibling <h5> element
// for textareas, the label is the sibling <h5> element
} else if (element instanceof HTMLTextAreaElement) {
} else if (element instanceof HTMLTextAreaElement) {
return element.parentNode.getElementsByTagName("h5")[0];
return element.parentNode.getElementsByTagName('h5')[0];
}

// for others, the label is the sibling <label> element
// for others, the label is the sibling <label> element
return element.parentNode.getElementsByTagName('label')[0];
} else {
return element.parentNode.getElementsByTagName("label")[0];
}
};
};


Baris 812: Baris 833:
*/
*/
Morebits.quickForm.overrideElementLabel = function QuickFormOverrideElementLabel(element, temporaryLabelText) {
Morebits.quickForm.overrideElementLabel = function QuickFormOverrideElementLabel(element, temporaryLabelText) {
if (!element.hasAttribute("data-oldlabel")) {
if (!element.hasAttribute('data-oldlabel')) {
element.setAttribute("data-oldlabel", Morebits.quickForm.getElementLabel(element));
element.setAttribute('data-oldlabel', Morebits.quickForm.getElementLabel(element));
}
}
return Morebits.quickForm.setElementLabel(element, temporaryLabelText);
return Morebits.quickForm.setElementLabel(element, temporaryLabelText);
Baris 824: Baris 845:
*/
*/
Morebits.quickForm.resetElementLabel = function QuickFormResetElementLabel(element) {
Morebits.quickForm.resetElementLabel = function QuickFormResetElementLabel(element) {
if (element.hasAttribute("data-oldlabel")) {
if (element.hasAttribute('data-oldlabel')) {
return Morebits.quickForm.setElementLabel(element, element.getAttribute("data-oldlabel"));
return Morebits.quickForm.setElementLabel(element, element.getAttribute('data-oldlabel'));
}
}
return null;
return null;
Baris 845: Baris 866:
*/
*/
Morebits.quickForm.setElementTooltipVisibility = function QuickFormSetElementTooltipVisibility(element, visibility) {
Morebits.quickForm.setElementTooltipVisibility = function QuickFormSetElementTooltipVisibility(element, visibility) {
$(Morebits.quickForm.getElementContainer(element)).find(".morebits-tooltip").toggle(visibility);
$(Morebits.quickForm.getElementContainer(element)).find('.morebits-tooltip').toggle(visibility);
};
};


Baris 865: Baris 886:
* in twinkleunlink.js, which is better
* in twinkleunlink.js, which is better
*/
*/
HTMLFormElement.prototype.getChecked = function( name, type ) {
HTMLFormElement.prototype.getChecked = function(name, type) {
var elements = this.elements[name];
var elements = this.elements[name];
if( !elements ) {
if (!elements) {
// if the element doesn't exists, return null.
// if the element doesn't exists, return null.
return null;
return null;
Baris 873: Baris 894:
var return_array = [];
var return_array = [];
var i;
var i;
if( elements instanceof HTMLSelectElement ) {
if (elements instanceof HTMLSelectElement) {
var options = elements.options;
var options = elements.options;
for( i = 0; i < options.length; ++i ) {
for (i = 0; i < options.length; ++i) {
if( options[i].selected ) {
if (options[i].selected) {
if( options[i].values ) {
if (options[i].values) {
return_array.push( options[i].values );
return_array.push(options[i].values);
} else {
} else {
return_array.push( options[i].value );
return_array.push(options[i].value);
}
}


}
}
}
}
} else if( elements instanceof HTMLInputElement ) {
} else if (elements instanceof HTMLInputElement) {
if( type && elements.type !== type ) {
if (type && elements.type !== type) {
return [];
return [];
} else if( elements.checked ) {
} else if (elements.checked) {
return [ elements.value ];
return [ elements.value ];
}
}
} else {
} else {
for( i = 0; i < elements.length; ++i ) {
for (i = 0; i < elements.length; ++i) {
if( elements[i].checked ) {
if (elements[i].checked) {
if( type && elements[i].type !== type ) {
if (type && elements[i].type !== type) {
continue;
continue;
}
}
if( elements[i].values ) {
if (elements[i].values) {
return_array.push( elements[i].values );
return_array.push(elements[i].values);
} else {
} else {
return_array.push( elements[i].value );
return_array.push(elements[i].value);
}
}
}
}
Baris 913: Baris 934:
*/
*/


HTMLFormElement.prototype.getUnchecked = function( name, type ) {
HTMLFormElement.prototype.getUnchecked = function(name, type) {
var elements = this.elements[name];
var elements = this.elements[name];
if( !elements ) {
if (!elements) {
// if the element doesn't exists, return null.
// if the element doesn't exists, return null.
return null;
return null;
Baris 921: Baris 942:
var return_array = [];
var return_array = [];
var i;
var i;
if( elements instanceof HTMLSelectElement ) {
if (elements instanceof HTMLSelectElement) {
var options = elements.options;
var options = elements.options;
for( i = 0; i < options.length; ++i ) {
for (i = 0; i < options.length; ++i) {
if( !options[i].selected ) {
if (!options[i].selected) {
if( options[i].values ) {
if (options[i].values) {
return_array.push( options[i].values );
return_array.push(options[i].values);
} else {
} else {
return_array.push( options[i].value );
return_array.push(options[i].value);
}
}


}
}
}
}
} else if( elements instanceof HTMLInputElement ) {
} else if (elements instanceof HTMLInputElement) {
if( type && elements.type !== type ) {
if (type && elements.type !== type) {
return [];
return [];
} else if( !elements.checked ) {
} else if (!elements.checked) {
return [ elements.value ];
return [ elements.value ];
}
}
} else {
} else {
for( i = 0; i < elements.length; ++i ) {
for (i = 0; i < elements.length; ++i) {
if( !elements[i].checked ) {
if (!elements[i].checked) {
if( type && elements[i].type !== type ) {
if (type && elements[i].type !== type) {
continue;
continue;
}
}
if( elements[i].values ) {
if (elements[i].values) {
return_array.push( elements[i].values );
return_array.push(elements[i].values);
} else {
} else {
return_array.push( elements[i].value );
return_array.push(elements[i].value);
}
}
}
}
Baris 962: Baris 983:
* Escapes a string to be used in a RegExp
* Escapes a string to be used in a RegExp
* @param {string} text - string to be escaped
* @param {string} text - string to be escaped
* @param {boolean} [space_fix] - Set this true to replace spaces and underscore with `[ _]` as they are often equivalent
* @param {boolean} [space_fix=false] - Set true to replace spaces and underscores with `[ _]` as they are
* often equivalent
* @returns {string} - the escaped text
*/
*/
RegExp.escape = function(text, space_fix) {

text = mw.util.escapeRegExp(text);
RegExp.escape = function( text, space_fix ) {
text = mw.RegExp.escape(text);


// Special MediaWiki escape - underscore/space are often equivalent
// Special MediaWiki escape - underscore/space are often equivalent
if( space_fix ) {
if (space_fix) {
text = text.replace( / |_/g, '[_ ]' );
text = text.replace(/ |_/g, '[_ ]');
}
}


Baris 985: Baris 1.007:
toUpperCaseFirstChar: function(str) {
toUpperCaseFirstChar: function(str) {
str = str.toString();
str = str.toString();
return str.substr( 0, 1 ).toUpperCase() + str.substr( 1 );
return str.substr(0, 1).toUpperCase() + str.substr(1);
},
},
toLowerCaseFirstChar: function(str) {
toLowerCaseFirstChar: function(str) {
str = str.toString();
str = str.toString();
return str.substr( 0, 1 ).toLowerCase() + str.substr( 1 );
return str.substr(0, 1).toLowerCase() + str.substr(1);
},
},


Baris 1.001: Baris 1.023:
* @returns {String[]}
* @returns {String[]}
*/
*/
splitWeightedByKeys: function( str, start, end, skiplist ) {
splitWeightedByKeys: function(str, start, end, skiplist) {
if( start.length !== end.length ) {
if (start.length !== end.length) {
throw new Error( 'start marker and end marker must be of the same length' );
throw new Error('start marker and end marker must be of the same length');
}
}
var level = 0;
var level = 0;
var initial = null;
var initial = null;
var result = [];
var result = [];
if( ! Array.isArray( skiplist ) ) {
if (!Array.isArray(skiplist)) {
if( skiplist === undefined ) {
if (skiplist === undefined) {
skiplist = [];
skiplist = [];
} else if( typeof skiplist === 'string' ) {
} else if (typeof skiplist === 'string') {
skiplist = [ skiplist ];
skiplist = [ skiplist ];
} else {
} else {
throw new Error( "non-applicable skiplist parameter" );
throw new Error('non-applicable skiplist parameter');
}
}
}
}
for( var i = 0; i < str.length; ++i ) {
for (var i = 0; i < str.length; ++i) {
for( var j = 0; j < skiplist.length; ++j ) {
for (var j = 0; j < skiplist.length; ++j) {
if( str.substr( i, skiplist[j].length ) === skiplist[j] ) {
if (str.substr(i, skiplist[j].length) === skiplist[j]) {
i += skiplist[j].length - 1;
i += skiplist[j].length - 1;
continue;
continue;
}
}
}
}
if( str.substr( i, start.length ) === start ) {
if (str.substr(i, start.length) === start) {
if( initial === null ) {
if (initial === null) {
initial = i;
initial = i;
}
}
++level;
++level;
i += start.length - 1;
i += start.length - 1;
} else if( str.substr( i, end.length ) === end ) {
} else if (str.substr(i, end.length) === end) {
--level;
--level;
i += end.length - 1;
i += end.length - 1;
}
}
if( !level && initial !== null ) {
if (!level && initial !== null) {
result.push( str.substring( initial, i + 1 ) );
result.push(str.substring(initial, i + 1));
initial = null;
initial = null;
}
}
Baris 1.049: Baris 1.071:
* @returns {string}
* @returns {string}
*/
*/
formatReasonText: function( str ) {
formatReasonText: function(str) {
var result = str.toString().trim();
var result = str.toString().trim();
var unbinder = new Morebits.unbinder(result);
var unbinder = new Morebits.unbinder(result);
unbinder.unbind("<no" + "wiki>", "</no" + "wiki>");
unbinder.unbind('<no' + 'wiki>', '</no' + 'wiki>');
unbinder.content = unbinder.content.replace(/\|/g, "{{subst:!}}");
unbinder.content = unbinder.content.replace(/\|/g, '{{subst:!}}');
return unbinder.rebind();
return unbinder.rebind();
},
},


/**
/**
* Replacement for `String.prototype.replace()` when the second parameter
* Like `String.prototype.replace()`, but escapes any dollar signs in the replacement string.
* (the replacement string) is arbitrary, such as a username or freeform user input,
* Useful when the the replacement string is arbitrary, such as a username or freeform user input,
* and may contain dollar signs
* and could contain dollar signs.
* @param {string} string - text in which to replace
* @param {(string|RegExp)} pattern
* @param {string} replacement
* @returns {string}
*/
*/
safeReplace: function morebitsStringSafeReplace(string, pattern, replacement) {
safeReplace: function morebitsStringSafeReplace(string, pattern, replacement) {
return string.replace(pattern, replacement.replace(/\$/g, "$$$$"));
return string.replace(pattern, replacement.replace(/\$/g, '$$$$'));
}
}
};
};
Baris 1.077: Baris 1.103:
*/
*/
uniq: function(arr) {
uniq: function(arr) {
if ( ! Array.isArray( arr ) ) {
if (!Array.isArray(arr)) {
throw "A non-array object passed to Morebits.array.uniq";
throw 'A non-array object passed to Morebits.array.uniq';
}
}
var result = [];
var result = [];
for( var i = 0; i < arr.length; ++i ) {
for (var i = 0; i < arr.length; ++i) {
var current = arr[i];
var current = arr[i];
if( result.indexOf( current ) === -1 ) {
if (result.indexOf(current) === -1) {
result.push( current );
result.push(current);
}
}
}
}
Baris 1.095: Baris 1.121:
*/
*/
dups: function(arr) {
dups: function(arr) {
if ( ! Array.isArray( arr ) ) {
if (!Array.isArray(arr)) {
throw "A non-array object passed to Morebits.array.dups";
throw 'A non-array object passed to Morebits.array.dups';
}
}
var uniques = [];
var uniques = [];
var result = [];
var result = [];
for( var i = 0; i < arr.length; ++i ) {
for (var i = 0; i < arr.length; ++i) {
var current = arr[i];
var current = arr[i];
if( uniques.indexOf( current ) === -1 ) {
if (uniques.indexOf(current) === -1) {
uniques.push( current );
uniques.push(current);
} else {
} else {
result.push( current );
result.push(current);
}
}
}
}
Baris 1.113: Baris 1.139:


/**
/**
* breaks up `arr` into smaller arrays of length `size`, and
* Break up an array into smaller arrays.
* @param {Array} arr
* @returns an array of these "chunked" arrays
* @param {number} size - Size of each chunk (except the last, which could be different)
* @param {array} arr
* @returns {Array} an array of these smaller arrays
* @param {number} size
* @returns {Array}
*/
*/
chunk: function( arr, size ) {
chunk: function(arr, size) {
if ( ! Array.isArray( arr ) ) {
if (!Array.isArray(arr)) {
throw "A non-array object passed to Morebits.array.chunk";
throw 'A non-array object passed to Morebits.array.chunk';
}
}
if( typeof size !== 'number' || size <= 0 ) { // pretty impossible to do anything :)
if (typeof size !== 'number' || size <= 0) { // pretty impossible to do anything :)
return [ arr ]; // we return an array consisting of this array.
return [ arr ]; // we return an array consisting of this array.
}
}
var result = [];
var result = [];
var current;
var current;
for( var i = 0; i < arr.length; ++i ) {
for (var i = 0; i < arr.length; ++i) {
if( i % size === 0 ) { // when 'i' is 0, this is always true, so we start by creating one.
if (i % size === 0) { // when 'i' is 0, this is always true, so we start by creating one.
current = [];
current = [];
result.push( current );
result.push(current);
}
}
current.push( arr[i] );
current.push(arr[i]);
}
}
return result;
return result;
}
}
};

/**
* ************ Morebits.select2 ***************
* Utilities to enhance select2 menus
* See twinklewarn, twinklexfd, twinkleblock for sample usages
*/
Morebits.select2 = {

matchers: {
/**
* Custom matcher in which if the optgroup name matches, all options in that
* group are shown, like in jquery.chosen
*/
optgroupFull: function(params, data) {
var originalMatcher = $.fn.select2.defaults.defaults.matcher;
var result = originalMatcher(params, data);

if (result && params.term &&
data.text.toUpperCase().indexOf(params.term.toUpperCase()) !== -1) {
result.children = data.children;
}
return result;
},

/** Custom matcher that matches from the beginning of words only */
wordBeginning: function(params, data) {
var originalMatcher = $.fn.select2.defaults.defaults.matcher;
var result = originalMatcher(params, data);
if (!params.term || (result &&
new RegExp('\\b' + mw.util.escapeRegExp(params.term), 'i').test(result.text))) {
return result;
}
return null;
}
},

/** Underline matched part of options */
highlightSearchMatches: function(data) {
var searchTerm = Morebits.select2SearchQuery;
if (!searchTerm || data.loading) {
return data.text;
}
var idx = data.text.toUpperCase().indexOf(searchTerm.toUpperCase());
if (idx < 0) {
return data.text;
}

return $('<span>').append(
data.text.slice(0, idx),
$('<span>').css('text-decoration', 'underline').text(data.text.slice(idx, idx + searchTerm.length)),
data.text.slice(idx + searchTerm.length)
);
},

/** Intercept query as it is happening, for use in highlightSearchMatches */
queryInterceptor: function(params) {
Morebits.select2SearchQuery = params && params.term;
},

/**
* Open dropdown and begin search when the .select2-selection has focus and a key is pressed
* https://github.com/select2/select2/issues/3279#issuecomment-442524147
*/
autoStart: function(ev) {
if (ev.which < 48) {
return;
}
var target = $(ev.target).closest('.select2-container');
if (!target.length) {
return;
}
target = target.prev();
target.select2('open');
var search = target.data('select2').dropdown.$search ||
target.data('select2').selection.$search;
search.focus();
}

};
};


Baris 1.152: Baris 1.256:
* For a page name 'Foo bar', returns the string '[Ff]oo bar'
* For a page name 'Foo bar', returns the string '[Ff]oo bar'
* @param {string} pageName - page name without namespace
* @param {string} pageName - page name without namespace
* @returns {string}
*/
*/
Morebits.pageNameRegex = function(pageName) {
Morebits.pageNameRegex = function(pageName) {
Baris 1.163: Baris 1.268:
*
*
* eg. var u = new Morebits.unbinder("Hello world <!-- world --> world");
* eg. var u = new Morebits.unbinder("Hello world <!-- world --> world");
* u.unbind('<!--','-->');
* u.unbind('<!--','-->');
* u.content = u.content.replace(/world/g, 'earth');
* u.content = u.content.replace(/world/g, 'earth');
* u.rebind() // gives "Hello earth <!-- world --> earth"
* u.rebind(); // gives "Hello earth <!-- world --> earth"
*
*
* Text within the 'unbinded' part (in this case, the HTML comment) remains intact
* Text within the 'unbinded' part (in this case, the HTML comment) remains intact
Baris 1.177: Baris 1.282:
* @param {string} string
* @param {string} string
*/
*/
Morebits.unbinder = function Unbinder( string ) {
Morebits.unbinder = function Unbinder(string) {
if( typeof string !== 'string' ) {
if (typeof string !== 'string') {
throw new Error( "not a string" );
throw new Error('not a string');
}
}
this.content = string;
this.content = string;
Baris 1.193: Baris 1.298:
* @param {string} postfix
* @param {string} postfix
*/
*/
unbind: function UnbinderUnbind( prefix, postfix ) {
unbind: function UnbinderUnbind(prefix, postfix) {
var re = new RegExp( prefix + '(.*?)' + postfix, 'g' );
var re = new RegExp(prefix + '([\\s\\S]*?)' + postfix, 'g');
this.content = this.content.replace( re, Morebits.unbinder.getCallback( this ) );
this.content = this.content.replace(re, Morebits.unbinder.getCallback(this));
},
},


/** @returns {string} The output */
/**
* @returns {string} The output
*/
rebind: function UnbinderRebind() {
rebind: function UnbinderRebind() {
var content = this.content;
var content = this.content;
content.self = this;
content.self = this;
for( var current in this.history ) {
for (var current in this.history) {
if( this.history.hasOwnProperty( current ) ) {
if (Object.prototype.hasOwnProperty.call(this.history, current)) {
content = content.replace( current, this.history[current] );
content = content.replace(current, this.history[current]);
}
}
}
}
Baris 1.219: Baris 1.322:


Morebits.unbinder.getCallback = function UnbinderGetCallback(self) {
Morebits.unbinder.getCallback = function UnbinderGetCallback(self) {
return function UnbinderCallback( match ) {
return function UnbinderCallback(match) {
var current = self.prefix + self.counter + self.postfix;
var current = self.prefix + self.counter + self.postfix;
self.history[current] = match;
self.history[current] = match;
Baris 1.226: Baris 1.329:
};
};
};
};





Baris 1.233: Baris 1.335:
* Helper functions to get the month as a string instead of a number
* Helper functions to get the month as a string instead of a number
*
*
* @deprecated Since early 2020 in favor of Morebits.date (#814)
* Normally it is poor form to play with prototypes of primitive types, but it
* is fairly unlikely that anyone will iterate over a Date object.
*/
*/


Date.monthNames = ['January', 'February', 'March', 'April', 'May', 'June',
Date.monthNames = ['January', 'February', 'March', 'April', 'May', 'June',
'July', 'August', 'September', 'October', 'November','December' ];
'July', 'August', 'September', 'October', 'November', 'December' ];

Date.monthNamesAbbrev = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
Date.monthNamesAbbrev = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
Date.prototype.getUTCMonthName = function() {

console.warn("NOTE: Date prototypes from Twinkle's Morebits (such as getUTCMonthName) have been deprecated, use Morebits.date instead"); // eslint-disable-line no-console
Date.prototype.getMonthName = function() {
return Date.monthNames[ this.getMonth() ];
return Date.monthNames[this.getUTCMonth()];
};
};
Date.prototype.getUTCMonthNameAbbrev = function() {

console.warn("NOTE: Date prototypes from Twinkle's Morebits (such as getUTCMonthNameAbbrev) have been deprecated, use Morebits.date instead"); // eslint-disable-line no-console
Date.prototype.getMonthNameAbbrev = function() {
return Date.monthNamesAbbrev[ this.getMonth() ];
return Date.monthNamesAbbrev[this.getUTCMonth()];
};
};



Date.prototype.getUTCMonthName = function() {
/**
return Date.monthNames[ this.getUTCMonth() ];
* **************** Morebits.date ****************
*/

/**
* @constructor
* Create a date object. MediaWiki timestamp format is also acceptable,
* in addition to everything that JS Date() accepts.
*/
Morebits.date = function() {
var args = Array.prototype.slice.call(arguments);

if (typeof args[0] === 'string') {
// Attempt to remove a comma and paren-wrapped timezone, to get MediaWiki timestamps to parse
// Firefox (at least in 75) seems to be okay with the comma, though
args[0] = args[0].replace(/(\d\d:\d\d),/, '$1').replace(/\(UTC\)/, 'UTC');
}
this._d = new (Function.prototype.bind.apply(Date, [Date].concat(args)));
};
};


Morebits.date.localeData = {
Date.prototype.getUTCMonthNameAbbrev = function() {
months: ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'],
return Date.monthNamesAbbrev[ this.getUTCMonth() ];
monthsShort: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],
days: ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'],
daysShort: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'],
relativeTimes: {
thisDay: '[Today at] h:mm A',
prevDay: '[Yesterday at] h:mm A',
nextDay: '[Tomorrow at] h:mm A',
thisWeek: 'dddd [at] h:mm A',
pastWeek: '[Last] dddd [at] h:mm A',
other: 'YYYY-MM-DD'
}
};
};


// Allow native Date.prototype methods to be used on Morebits.date objects
Object.getOwnPropertyNames(Date.prototype).forEach(function(func) {
Morebits.date.prototype[func] = function() {
return this._d[func].apply(this._d, Array.prototype.slice.call(arguments));
};
});

$.extend(Morebits.date.prototype, {

isValid: function() {
return !isNaN(this.getTime());
},

/** @param {(Date|Morebits.date)} date */
isBefore: function(date) {
return this.getTime() < date.getTime();
},
isAfter: function(date) {
return this.getTime() > date.getTime();
},

/** @return {string} */
getUTCMonthName: function() {
return Morebits.date.localeData.months[this.getUTCMonth()];
},
getUTCMonthNameAbbrev: function() {
return Morebits.date.localeData.monthsShort[this.getUTCMonth()];
},
getMonthName: function() {
return Morebits.date.localeData.months[this.getMonth()];
},
getMonthNameAbbrev: function() {
return Morebits.date.localeData.monthsShort[this.getMonth()];
},
getUTCDayName: function() {
return Morebits.date.localeData.days[this.getUTCDay()];
},
getUTCDayNameAbbrev: function() {
return Morebits.date.localeData.daysShort[this.getUTCDay()];
},
getDayName: function() {
return Morebits.date.localeData.days[this.getDay()];
},
getDayNameAbbrev: function() {
return Morebits.date.localeData.daysShort[this.getDay()];
},

/**
* Add a given number of minutes, hours, days, months or years to the date.
* This is done in-place. The modified date object is also returned, allowing chaining.
* @param {number} number - should be an integer
* @param {string} unit
* @throws {Error} if invalid or unsupported unit is given
* @returns {Morebits.date}
*/
add: function(number, unit) {
// mapping time units with getter/setter function names
var unitMap = {
seconds: 'Seconds',
minutes: 'Minutes',
hours: 'Hours',
days: 'Date',
months: 'Month',
years: 'FullYear'
};
var unitNorm = unitMap[unit] || unitMap[unit + 's']; // so that both singular and plural forms work
if (unitNorm) {
this['set' + unitNorm](this['get' + unitNorm]() + number);
return this;
}
throw new Error('Invalid unit "' + unit + '": Only ' + Object.keys(unitMap).join(', ') + ' are allowed.');
},

/**
* Subtracts a given number of minutes, hours, days, months or years to the date.
* This is done in-place. The modified date object is also returned, allowing chaining.
* @param {number} number - should be an integer
* @param {string} unit
* @throws {Error} if invalid or unsupported unit is given
* @returns {Morebits.date}
*/
subtract: function(number, unit) {
return this.add(-number, unit);
},

/**
* Formats the date into a string per the given format string.
* Replacement syntax is a subset of that in moment.js.
* @param {string} formatstr
* @param {(string|number)} [zone=system] - 'system' (for browser-default time zone),
* 'utc' (for UTC), or specify a time zone as number of minutes past UTC.
* @returns {string}
*/
format: function(formatstr, zone) {
var udate = this;
// create a new date object that will contain the date to display as system time
if (zone === 'utc') {
udate = new Morebits.date(this.getTime()).add(this.getTimezoneOffset(), 'minutes');
} else if (typeof zone === 'number') {
// convert to utc, then add the utc offset given
udate = new Morebits.date(this.getTime()).add(this.getTimezoneOffset() + zone, 'minutes');
}

var pad = function(num) {
return num < 10 ? '0' + num : num;
};
var h24 = udate.getHours(), m = udate.getMinutes(), s = udate.getSeconds();
var D = udate.getDate(), M = udate.getMonth() + 1, Y = udate.getFullYear();
var h12 = h24 % 12 || 12, amOrPm = h24 >= 12 ? 'PM' : 'AM';
var replacementMap = {
'HH': pad(h24), 'H': h24, 'hh': pad(h12), 'h': h12, 'A': amOrPm,
'mm': pad(m), 'm': m,
'ss': pad(s), 's': s,
'dddd': udate.getDayName(), 'ddd': udate.getDayNameAbbrev(), 'd': udate.getDay(),
'DD': pad(D), 'D': D,
'MMMM': udate.getMonthName(), 'MMM': udate.getMonthNameAbbrev(), 'MM': pad(M), 'M': M,
'YYYY': Y, 'YY': pad(Y % 100), 'Y': Y
};

var unbinder = new Morebits.unbinder(formatstr); // escape stuff between [...]
unbinder.unbind('\\[', '\\]');
unbinder.content = unbinder.content.replace(
/* Regex notes:
* d(d{2,3})? matches exactly 1, 3 or 4 occurrences of 'd' ('dd' is treated as a double match of 'd')
* Y{1,2}(Y{2})? matches exactly 1, 2 or 4 occurrences of 'Y'
*/
/H{1,2}|h{1,2}|m{1,2}|s{1,2}|d(d{2,3})?|D{1,2}|M{1,4}|Y{1,2}(Y{2})?|A/g,
function(match) {
return replacementMap[match];
}
);
return unbinder.rebind().replace(/\[(.*?)\]/g, '$1');
},

/**
* Gives a readable relative time string such as "Yesterday at 6:43 PM" or "Last Thursday at 11:45 AM".
* Similar to calendar in moment.js, but with time zone support.
* @param {(string|number)} [zone=system] - 'system' (for browser-default time zone),
* 'utc' (for UTC), or specify a time zone as number of minutes past UTC
* @returns {string}
*/
calendar: function(zone) {
// Zero out the hours, minutes, seconds and milliseconds - keeping only the date;
// find the difference. Note that setHours() returns the same thing as getTime().
var dateDiff = (new Date().setHours(0, 0, 0, 0) -
new Date(this).setHours(0, 0, 0, 0)) / 8.64e7;
switch (true) {
case dateDiff === 0:
return this.format(Morebits.date.localeData.relativeTimes.thisDay, zone);
case dateDiff === 1:
return this.format(Morebits.date.localeData.relativeTimes.prevDay, zone);
case dateDiff > 0 && dateDiff < 7:
return this.format(Morebits.date.localeData.relativeTimes.pastWeek, zone);
case dateDiff === -1:
return this.format(Morebits.date.localeData.relativeTimes.nextDay, zone);
case dateDiff < 0 && dateDiff > -7:
return this.format(Morebits.date.localeData.relativeTimes.thisWeek, zone);
default:
return this.format(Morebits.date.localeData.relativeTimes.other, zone);
}
},

/**
* @returns {RegExp} that matches wikitext section titles such as ==December 2019== or
* === Jan 2018 ===
*/
monthHeaderRegex: function() {
return new RegExp('^==+\\s*(?:' + this.getUTCMonthName() + '|' + this.getUTCMonthNameAbbrev() +
')\\s+' + this.getUTCFullYear() + '\\s*==+', 'mg');
},

/**
* Creates a wikitext section header with the month and year.
* @param {number} [level=2] - Header level (default 2)
* @returns {string}
*/
monthHeader: function(level) {
level = level || 2;
var header = Array(level + 1).join('='); // String.prototype.repeat not supported in IE 11
return header + ' ' + this.getUTCMonthName() + ' ' + this.getUTCFullYear() + ' ' + header;
}

});


// Morebits.wikipedia.namespaces is deprecated - use mw.config.get('wgFormattedNamespaces') or mw.config.get('wgNamespaceIds') instead


/**
/**
Baris 1.270: Baris 1.580:
* Determines whether the current page is a redirect or soft redirect
* Determines whether the current page is a redirect or soft redirect
* (fails to detect soft redirects on edit, history, etc. pages)
* (fails to detect soft redirects on edit, history, etc. pages)
* @returns {boolean}
*/
*/
Morebits.wiki.isPageRedirect = function wikipediaIsPageRedirect() {
Morebits.wiki.isPageRedirect = function wikipediaIsPageRedirect() {
return !!(mw.config.get("wgIsRedirect") || document.getElementById("softredirect"));
return !!(mw.config.get('wgIsRedirect') || document.getElementById('softredirect'));
};
};


Baris 1.309: Baris 1.620:
Morebits.wiki.nbrOfCheckpointsLeft = 0;
Morebits.wiki.nbrOfCheckpointsLeft = 0;


Morebits.wiki.actionCompleted = function( self ) {
Morebits.wiki.actionCompleted = function(self) {
if( --Morebits.wiki.numberOfActionsLeft <= 0 && Morebits.wiki.nbrOfCheckpointsLeft <= 0 ) {
if (--Morebits.wiki.numberOfActionsLeft <= 0 && Morebits.wiki.nbrOfCheckpointsLeft <= 0) {
Morebits.wiki.actionCompleted.event( self );
Morebits.wiki.actionCompleted.event(self);
}
}
};
};
Baris 1.317: Baris 1.628:
// Change per action wanted
// Change per action wanted
Morebits.wiki.actionCompleted.event = function() {
Morebits.wiki.actionCompleted.event = function() {
new Morebits.status( Morebits.wiki.actionCompleted.notice, Morebits.wiki.actionCompleted.postfix, 'info' );
if (Morebits.wiki.actionCompleted.notice) {
if( Morebits.wiki.actionCompleted.redirect ) {
Morebits.status.actionCompleted(Morebits.wiki.actionCompleted.notice);
}
if (Morebits.wiki.actionCompleted.redirect) {
// if it isn't a URL, make it one. TODO: This breaks on the articles 'http://', 'ftp://', and similar ones.
// if it isn't a URL, make it one. TODO: This breaks on the articles 'http://', 'ftp://', and similar ones.
if( !( (/^\w+:\/\//).test( Morebits.wiki.actionCompleted.redirect ) ) ) {
if (!(/^\w+:\/\//).test(Morebits.wiki.actionCompleted.redirect)) {
Morebits.wiki.actionCompleted.redirect = mw.util.getUrl( Morebits.wiki.actionCompleted.redirect );
Morebits.wiki.actionCompleted.redirect = mw.util.getUrl(Morebits.wiki.actionCompleted.redirect);
if( Morebits.wiki.actionCompleted.followRedirect === false ) {
if (Morebits.wiki.actionCompleted.followRedirect === false) {
Morebits.wiki.actionCompleted.redirect += "?redirect=no";
Morebits.wiki.actionCompleted.redirect += '?redirect=no';
}
}
}
}
window.setTimeout( function() { window.location = Morebits.wiki.actionCompleted.redirect; }, Morebits.wiki.actionCompleted.timeOut );
window.setTimeout(function() {
window.location = Morebits.wiki.actionCompleted.redirect;
}, Morebits.wiki.actionCompleted.timeOut);
}
}
};
};


Morebits.wiki.actionCompleted.timeOut = ( typeof window.wpActionCompletedTimeOut === 'undefined' ? 5000 : window.wpActionCompletedTimeOut );
Morebits.wiki.actionCompleted.timeOut = typeof window.wpActionCompletedTimeOut === 'undefined' ? 5000 : window.wpActionCompletedTimeOut;
Morebits.wiki.actionCompleted.redirect = null;
Morebits.wiki.actionCompleted.redirect = null;
Morebits.wiki.actionCompleted.notice = 'Action';
Morebits.wiki.actionCompleted.notice = null;
Morebits.wiki.actionCompleted.postfix = 'completed';


Morebits.wiki.addCheckpoint = function() {
Morebits.wiki.addCheckpoint = function() {
Baris 1.340: Baris 1.654:


Morebits.wiki.removeCheckpoint = function() {
Morebits.wiki.removeCheckpoint = function() {
if( --Morebits.wiki.nbrOfCheckpointsLeft <= 0 && Morebits.wiki.numberOfActionsLeft <= 0 ) {
if (--Morebits.wiki.nbrOfCheckpointsLeft <= 0 && Morebits.wiki.numberOfActionsLeft <= 0) {
Morebits.wiki.actionCompleted.event();
Morebits.wiki.actionCompleted.event();
}
}
Baris 1.351: Baris 1.665:


/**
/**
* In new code, the use of the last 3 parameters should be avoided, instead use setStatusElement() to bind the
* status element (if needed) and use .then() or .catch() on the promise returned by post(), rather than specify
* the onSuccess or onFailure callbacks.
* @constructor
* @constructor
* @param {string} currentAction - The current action (required)
* @param {string} currentAction - The current action (required)
* @param {Object} query - The query (required)
* @param {Object} query - The query (required)
* @param {Function} onSuccess - The function to call when request gotten
* @param {Function} [onSuccess] - The function to call when request gotten
* @param {Object} [statusElement] - A Morebits.status object to use for status messages (optional)
* @param {Morebits.status} [statusElement] - A Morebits.status object to use for status messages (optional)
* @param {Function} [onError] - The function to call if an error occurs (optional)
* @param {Function} [onError] - The function to call if an error occurs (optional)
*/
*/
Morebits.wiki.api = function( currentAction, query, onSuccess, statusElement, onError ) {
Morebits.wiki.api = function(currentAction, query, onSuccess, statusElement, onError) {
this.currentAction = currentAction;
this.currentAction = currentAction;
this.query = query;
this.query = query;
this.query.format = 'xml';
this.query.assert = 'user';
this.query.assert = 'user';
this.onSuccess = onSuccess;
this.onSuccess = onSuccess;
this.onError = onError;
this.onError = onError;
if( statusElement ) {
if (statusElement) {
this.statelem = statusElement;
this.setStatusElement(statusElement);
this.statelem.status( currentAction );
} else {
} else {
this.statelem = new Morebits.status( currentAction );
this.statelem = new Morebits.status(currentAction);
}
if (!query.format) {
this.query.format = 'xml';
} else if (['xml', 'json'].indexOf(query.format) === -1) {
this.statelem.error('Invalid API format: only xml and json are supported.');
}
}
};
};
Baris 1.379: Baris 1.699:
parent: window, // use global context if there is no parent object
parent: window, // use global context if there is no parent object
query: null,
query: null,
responseXML: null,
response: null,
responseXML: null, // use `response` instead; retained for backwards compatibility
setParent: function(parent) { this.parent = parent; }, // keep track of parent object for callbacks
statelem: null, // this non-standard name kept for backwards compatibility
statelem: null, // this non-standard name kept for backwards compatibility
statusText: null, // result received from the API, normally "success" or "error"
statusText: null, // result received from the API, normally "success" or "error"
errorCode: null, // short text error code, if any, as documented in the MediaWiki API
errorCode: null, // short text error code, if any, as documented in the MediaWiki API
errorText: null, // full error description, if any
errorText: null, // full error description, if any

/**
* Keep track of parent object for callbacks
* @param {*} parent
*/
setParent: function(parent) {
this.parent = parent;
},

/** @param {Morebits.status} statusElement */
setStatusElement: function(statusElement) {
this.statelem = statusElement;
this.statelem.status(this.currentAction);
},


/**
/**
Baris 1.390: Baris 1.724:
* @param {Object} callerAjaxParameters Do not specify a parameter unless you really
* @param {Object} callerAjaxParameters Do not specify a parameter unless you really
* really want to give jQuery some extra parameters
* really want to give jQuery some extra parameters
* @returns {promise} - a jQuery promise object that is resolved or rejected with the api object.
*/
*/
post: function( callerAjaxParameters ) {
post: function(callerAjaxParameters) {


++Morebits.wiki.numberOfActionsLeft;
++Morebits.wiki.numberOfActionsLeft;


var ajaxparams = $.extend( {}, {
var queryString = $.map(this.query, function(val, i) {
if (Array.isArray(val)) {
return encodeURIComponent(i) + '=' + val.map(encodeURIComponent).join('|');
} else if (val !== undefined) {
return encodeURIComponent(i) + '=' + encodeURIComponent(val);
}
}).join('&').replace(/^(.*?)(\btoken=[^&]*)&(.*)/, '$1$3&$2');
// token should always be the last item in the query string (bug TW-B-0013)

var ajaxparams = $.extend({}, {
context: this,
context: this,
type: 'POST',
type: 'POST',
url: mw.util.wikiScript('api'),
url: mw.util.wikiScript('api'),
data: Morebits.queryString.create(this.query),
data: queryString,
dataType: 'xml',
dataType: 'xml',
headers: {
headers: {
'Api-User-Agent': morebitsWikiApiUserAgent
'Api-User-Agent': morebitsWikiApiUserAgent
}
}
}, callerAjaxParameters );
}, callerAjaxParameters);


return $.ajax( ajaxparams ).done(
return $.ajax(ajaxparams).then(

function(xml, statusText) {
function onAPIsuccess(response, statusText) {
this.statusText = statusText;
this.statusText = statusText;
this.responseXML = xml;
this.response = this.responseXML = response;
this.errorCode = $(xml).find('error').attr('code');
if (this.query.format === 'json') {
this.errorText = $(xml).find('error').attr('info');
this.errorCode = response.error && response.error.code;
this.errorText = response.error && response.error.info;

} else {
if (typeof this.errorCode === "string") {
this.errorCode = $(response).find('error').attr('code');
this.errorText = $(response).find('error').attr('info');
}


if (typeof this.errorCode === 'string') {
// the API didn't like what we told it, e.g., bad edit token or an error creating a page
// the API didn't like what we told it, e.g., bad edit token or an error creating a page
this.returnError();
return this.returnError();
return;
}
}


// invoke success callback if one was supplied
// invoke success callback if one was supplied
if (this.onSuccess) {
if (this.onSuccess) {

// set the callback context to this.parent for new code and supply the API object
// set the callback context to this.parent for new code and supply the API object
// as the first argument to the callback (for legacy code)
// as the first argument to the callback (for legacy code)
this.onSuccess.call( this.parent, this );
this.onSuccess.call(this.parent, this);
} else {
} else {
this.statelem.info("done");
this.statelem.info('done');
}
}


Morebits.wiki.actionCompleted();
Morebits.wiki.actionCompleted();

}
return $.Deferred().resolveWith(this.parent, [this]);
).fail(
},
// only network and server errors reach here – complaints from the API itself are caught in success()

function(jqXHR, statusText, errorThrown) {
// only network and server errors reach here - complaints from the API itself are caught in success()
function onAPIfailure(jqXHR, statusText, errorThrown) {
this.statusText = statusText;
this.statusText = statusText;
this.errorThrown = errorThrown; // frequently undefined
this.errorThrown = errorThrown; // frequently undefined
this.errorText = statusText + ' "' + jqXHR.statusText + '" occurred while contacting the API.';
this.errorText = statusText + ' "' + jqXHR.statusText + '" occurred while contacting the API.';
this.returnError();
return this.returnError();
}
}

); // the return value should be ignored, unless using callerAjaxParameters with |async: false|
);
},
},


returnError: function() {
returnError: function() {
if ( this.errorCode === "badtoken" ) {
if (this.errorCode === 'badtoken') {
// TODO: automatically retry after getting a new token
this.statelem.error( "Invalid token. Refresh the page and try again" );
this.statelem.error('Invalid token. Refresh the page and try again');
} else {
} else {
this.statelem.error( this.errorText );
this.statelem.error(this.errorText);
}
}


Baris 1.455: Baris 1.806:
// set the callback context to this.parent for new code and supply the API object
// set the callback context to this.parent for new code and supply the API object
// as the first argument to the callback for legacy code
// as the first argument to the callback for legacy code
this.onError.call( this.parent, this );
this.onError.call(this.parent, this);
}
}
// don't complete the action so that the error remains displayed
// don't complete the action so that the error remains displayed

return $.Deferred().rejectWith(this.parent, [this]);
},
},


Baris 1.472: Baris 1.825:
},
},


getXML: function() {
getXML: function() { // retained for backwards compatibility, use getResponse() instead
return this.responseXML;
return this.responseXML;
},

getResponse: function() {
return this.response;
}
}

};
};


Baris 1.485: Baris 1.843:
* @param {string} ua User agent
* @param {string} ua User agent
*/
*/
Morebits.wiki.api.setApiUserAgent = function( ua ) {
Morebits.wiki.api.setApiUserAgent = function(ua) {
morebitsWikiApiUserAgent = ( ua ? ua + ' ' : '' ) + 'morebits.js/2.0 ([[w:WT:TW]])';
morebitsWikiApiUserAgent = (ua ? ua + ' ' : '') + 'morebits.js/2.0 ([[w:WT:TW]])';
};
};


Baris 1.533: Baris 1.891:
* of the page. Does not require calling load() first.
* of the page. Does not require calling load() first.
*
*
* move(onSuccess, [onFailure]): Moves a page to another title
* move([onSuccess], [onFailure]): Moves a page to another title
*
*
* deletePage(onSuccess, [onFailure]): Deletes a page (for admins only)
* patrol(): Patrols a page; ignores errors
*
*
* triage(): Marks page as reviewed using PageTriage, which implies patrolled; ignores most errors
* undeletePage(onSuccess, [onFailure]): Undeletes a page (for admins only)
*
*
* protect(onSuccess, [onFailure]): Protects a page
* deletePage([onSuccess], [onFailure]): Deletes a page (for admins only)
*
* undeletePage([onSuccess], [onFailure]): Undeletes a page (for admins only)
*
* protect([onSuccess], [onFailure]): Protects a page
*
*
* getPageName(): returns a string containing the name of the loaded page, including the namespace
* getPageName(): returns a string containing the name of the loaded page, including the namespace
Baris 1.566: Baris 1.928:
* getCurrentID(): returns a string containing the current revision ID of the page
* getCurrentID(): returns a string containing the current revision ID of the page
*
*
* lookupCreator(onSuccess): Retrieves the username of the user who created the page
* lookupCreation(onSuccess): Retrieves the username and timestamp of page creation
* onSuccess - callback function which is called when the username is found
* onSuccess - callback function which is called when the username and timestamp
* within the callback, the username can be retrieved using the getCreator() function
* are found within the callback.
* The username can be retrieved using the getCreator() function;
* the timestamp can be retrieved using the getCreationTimestamp() function
*
*
* getCreator(): returns the user who created the page following lookupCreator()
* getCreator(): returns the user who created the page following lookupCreation()
*
* getCreationTimestamp(): returns an ISOString timestamp of page creation following lookupCreation()
*
*
*/
*/
Baris 1.642: Baris 2.008:
watchlistOption: 'nochange',
watchlistOption: 'nochange',
creator: null,
creator: null,
timestamp: null,


// - revert
// - revert
Baris 1.657: Baris 2.024:
protectCreate: null,
protectCreate: null,
protectCascade: false,
protectCascade: false,

// - creation lookup
lookupNonRedirectCreator: false,


// - stabilize (FlaggedRevs)
// - stabilize (FlaggedRevs)
Baris 1.663: Baris 2.033:
// internal status
// internal status
pageLoaded: false,
pageLoaded: false,
editToken: null,
csrfToken: null,
loadTime: null,
loadTime: null,
lastEditTime: null,
lastEditTime: null,
pageID: null,
revertCurID: null,
revertCurID: null,
revertUser: null,
revertUser: null,
Baris 1.678: Baris 2.049:
onSaveSuccess: null,
onSaveSuccess: null,
onSaveFailure: null,
onSaveFailure: null,
onLookupCreatorSuccess: null,
onLookupCreationSuccess: null,
onMoveSuccess: null,
onMoveSuccess: null,
onMoveFailure: null,
onMoveFailure: null,
Baris 1.694: Baris 2.065:
loadApi: null,
loadApi: null,
saveApi: null,
saveApi: null,
lookupCreatorApi: null,
lookupCreationApi: null,
moveApi: null,
moveApi: null,
moveProcessApi: null,
moveProcessApi: null,
patrolApi: null,
patrolProcessApi: null,
triageApi: null,
triageProcessApi: null,
deleteApi: null,
deleteApi: null,
deleteProcessApi: null,
deleteProcessApi: null,
Baris 1.712: Baris 2.087:
* Loads the text for the page
* Loads the text for the page
* @param {Function} onSuccess - callback function which is called when the load has succeeded
* @param {Function} onSuccess - callback function which is called when the load has succeeded
* @param {Function} onFailure - callback function which is called when the load fails (optional)
* @param {Function} [onFailure] - callback function which is called when the load fails (optional)
*/
*/
this.load = function(onSuccess, onFailure) {
this.load = function(onSuccess, onFailure) {
Baris 1.720: Baris 2.095:
// Need to be able to do something after the page loads
// Need to be able to do something after the page loads
if (!onSuccess) {
if (!onSuccess) {
ctx.statusElement.error("Internal error: no onSuccess callback provided to load()!");
ctx.statusElement.error('Internal error: no onSuccess callback provided to load()!');
ctx.onLoadFailure(this);
ctx.onLoadFailure(this);
return;
return;
Baris 1.728: Baris 2.103:
action: 'query',
action: 'query',
prop: 'info|revisions',
prop: 'info|revisions',
curtimestamp: '',
intoken: 'edit', // fetch an edit token
meta: 'tokens',
type: 'csrf',
titles: ctx.pageName
titles: ctx.pageName
// don't need rvlimit=1 because we don't need rvstartid here and only one actual rev is returned by default
// don't need rvlimit=1 because we don't need rvstartid here and only one actual rev is returned by default
Baris 1.747: Baris 2.124:
ctx.loadQuery.rvsection = ctx.pageSection;
ctx.loadQuery.rvsection = ctx.pageSection;
}
}
if (Morebits.userIsInGroup('sysop')) {
if (Morebits.userIsSysop) {
ctx.loadQuery.inprop = 'protection';
ctx.loadQuery.inprop = 'protection';
}
}


ctx.loadApi = new Morebits.wiki.api("Retrieving page...", ctx.loadQuery, fnLoadSuccess, ctx.statusElement, ctx.onLoadFailure);
ctx.loadApi = new Morebits.wiki.api('Retrieving page...', ctx.loadQuery, fnLoadSuccess, ctx.statusElement, ctx.onLoadFailure);
ctx.loadApi.setParent(this);
ctx.loadApi.setParent(this);
ctx.loadApi.post();
ctx.loadApi.post();
Baris 1.773: Baris 2.150:
ctx.onSaveFailure = onFailure || emptyFunction;
ctx.onSaveFailure = onFailure || emptyFunction;


// are we getting our edit token from mw.user.tokens?
// are we getting our editing token from mw.user.tokens?
var canUseMwUserToken = fnCanUseMwUserToken('edit');
var canUseMwUserToken = fnCanUseMwUserToken('edit');


if (!ctx.pageLoaded && !canUseMwUserToken) {
if (!ctx.pageLoaded && !canUseMwUserToken) {
ctx.statusElement.error("Internal error: attempt to save a page that has not been loaded!");
ctx.statusElement.error('Internal error: attempt to save a page that has not been loaded!');
ctx.onSaveFailure(this);
ctx.onSaveFailure(this);
return;
return;
}
}
if (!ctx.editSummary) {
if (!ctx.editSummary) {
ctx.statusElement.error("Internal error: edit summary not set before save!");
ctx.statusElement.error('Internal error: edit summary not set before save!');
ctx.onSaveFailure(this);
ctx.onSaveFailure(this);
return;
return;
Baris 1.790: Baris 2.167:
if (ctx.fullyProtected && !ctx.suppressProtectWarning &&
if (ctx.fullyProtected && !ctx.suppressProtectWarning &&
!confirm('You are about to make an edit to the fully protected page "' + ctx.pageName +
!confirm('You are about to make an edit to the fully protected page "' + ctx.pageName +
(ctx.fullyProtected === 'infinity' ? '" (protected indefinitely)' : ('" (protection expiring ' + ctx.fullyProtected + ')')) +
(ctx.fullyProtected === 'infinity' ? '" (protected indefinitely)' : '" (protection expiring ' + new Morebits.date(ctx.fullyProtected).calendar('utc') + ' (UTC))') +
'. \n\nClick OK to proceed with the edit, or Cancel to skip this edit.')) {
'. \n\nClick OK to proceed with the edit, or Cancel to skip this edit.')) {
ctx.statusElement.error("Edit to fully protected page was aborted.");
ctx.statusElement.error('Edit to fully protected page was aborted.');
ctx.onSaveFailure(this);
ctx.onSaveFailure(this);
return;
return;
Baris 1.803: Baris 2.180:
title: ctx.pageName,
title: ctx.pageName,
summary: ctx.editSummary,
summary: ctx.editSummary,
token: canUseMwUserToken ? mw.user.tokens.get('csrfToken') : ctx.editToken,
token: canUseMwUserToken ? mw.user.tokens.get('csrfToken') : ctx.csrfToken,
watchlist: ctx.watchlistOption
watchlist: ctx.watchlistOption
};
};
Baris 1.824: Baris 2.201:


switch (ctx.editMode) {
switch (ctx.editMode) {
case 'append':
case 'append':
query.appendtext = ctx.appendText; // use mode to append to current page contents
query.appendtext = ctx.appendText; // use mode to append to current page contents
break;
break;
case 'prepend':
case 'prepend':
query.prependtext = ctx.prependText; // use mode to prepend to current page contents
query.prependtext = ctx.prependText; // use mode to prepend to current page contents
break;
break;
case 'revert':
case 'revert':
query.undo = ctx.revertCurID;
query.undo = ctx.revertCurID;
query.undoafter = ctx.revertOldID;
query.undoafter = ctx.revertOldID;
if (ctx.lastEditTime) {
if (ctx.lastEditTime) {
query.basetimestamp = ctx.lastEditTime; // check that page hasn't been edited since it was loaded
query.basetimestamp = ctx.lastEditTime; // check that page hasn't been edited since it was loaded
}
}
query.starttimestamp = ctx.loadTime; // check that page hasn't been deleted since it was loaded (don't recreate bad stuff)
query.starttimestamp = ctx.loadTime; // check that page hasn't been deleted since it was loaded (don't recreate bad stuff)
break;
break;
default:
default: // 'all'
query.text = ctx.pageText; // replace entire contents of the page
query.text = ctx.pageText; // replace entire contents of the page
if (ctx.lastEditTime) {
if (ctx.lastEditTime) {
query.basetimestamp = ctx.lastEditTime; // check that page hasn't been edited since it was loaded
query.basetimestamp = ctx.lastEditTime; // check that page hasn't been edited since it was loaded
}
}
query.starttimestamp = ctx.loadTime; // check that page hasn't been deleted since it was loaded (don't recreate bad stuff)
query.starttimestamp = ctx.loadTime; // check that page hasn't been deleted since it was loaded (don't recreate bad stuff)
break;
break;
}
}


Baris 1.855: Baris 2.232:
}
}


ctx.saveApi = new Morebits.wiki.api( "Saving page...", query, fnSaveSuccess, ctx.statusElement, fnSaveError);
ctx.saveApi = new Morebits.wiki.api('Saving page...', query, fnSaveSuccess, ctx.statusElement, fnSaveError);
ctx.saveApi.setParent(this);
ctx.saveApi.setParent(this);
ctx.saveApi.post();
ctx.saveApi.post();
Baris 1.863: Baris 2.240:
* Adds the text provided via setAppendText() to the end of the page.
* Adds the text provided via setAppendText() to the end of the page.
* Does not require calling load() first.
* Does not require calling load() first.
* @param {Function} onSuccess - callback function which is called when the method has succeeded (optional)
* @param {Function} [onSuccess] - callback function which is called when the method has succeeded (optional)
* @param {Function} onFailure - callback function which is called when the method fails (optional)
* @param {Function} [onFailure] - callback function which is called when the method fails (optional)
*/
*/
this.append = function(onSuccess, onFailure) {
this.append = function(onSuccess, onFailure) {
Baris 1.881: Baris 2.258:
* Adds the text provided via setPrependText() to the start of the page.
* Adds the text provided via setPrependText() to the start of the page.
* Does not require calling load() first.
* Does not require calling load() first.
* @param {Function} onSuccess - callback function which is called when the method has succeeded (optional)
* @param {Function} [onSuccess] - callback function which is called when the method has succeeded (optional)
* @param {Function} onFailure - callback function which is called when the method fails (optional)
* @param {Function} [onFailure] - callback function which is called when the method fails (optional)
*/
*/
this.prepend = function(onSuccess, onFailure) {
this.prepend = function(onSuccess, onFailure) {
Baris 1.896: Baris 2.273:
};
};


/** @returns {string} string containing the name of the loaded page, including the namespace */
/**
* @returns {string} string containing the name of the loaded page, including the namespace
*/
this.getPageName = function() {
this.getPageName = function() {
return ctx.pageName;
return ctx.pageName;
};
};


/** @returns {string} string containing the text of the page after a successful load() */
/**
* @returns {string} string containing the text of the page after a successful load()
*/
this.getPageText = function() {
this.getPageText = function() {
return ctx.pageText;
return ctx.pageText;
};
};


/** @param {string} pageText - updated page text that will be saved when save() is called */
/**
* `pageText` - string containing the updated page text that will be saved when save() is called
*/
this.setPageText = function(pageText) {
this.setPageText = function(pageText) {
ctx.editMode = 'all';
ctx.editMode = 'all';
Baris 1.918: Baris 2.289:
};
};


/** @param {string} appendText - text that will be appended to the page when append() is called */
/**
* `appendText` - string containing the text that will be appended to the page when append() is called
*/
this.setAppendText = function(appendText) {
this.setAppendText = function(appendText) {
ctx.editMode = 'append';
ctx.editMode = 'append';
Baris 1.926: Baris 2.295:
};
};


/** @param {string} prependText - text that will be prepended to the page when prepend() is called */
/**
* `prependText` - string containing the text that will be prepended to the page when prepend() is called
*/
this.setPrependText = function(prependText) {
this.setPrependText = function(prependText) {
ctx.editMode = 'prepend';
ctx.editMode = 'prepend';
Baris 1.937: Baris 2.304:


// Edit-related setter methods:
// Edit-related setter methods:
/** @param {string} summary - text of the edit summary that will be used when save() is called */
/**
* `summary` - string containing the text of the edit summary that will be used when save() is called
*/
this.setEditSummary = function(summary) {
this.setEditSummary = function(summary) {
ctx.editSummary = summary;
ctx.editSummary = summary;
Baris 1.945: Baris 2.310:


/**
/**
* `createOption` is a string value:
* @param {string} createOption - can take the following four values:
* 'recreate' - create the page if it does not exist, or edit it if it exists
* `recreate` - create the page if it does not exist, or edit it if it exists.
* 'createonly' - create the page if it does not exist, but return an error if it
* `createonly` - create the page if it does not exist, but return an error if it
* already exists
* already exists.
* 'nocreate' - don't create the page, only edit it if it already exists
* `nocreate` - don't create the page, only edit it if it already exists.
* null - create the page if it does not exist, unless it was deleted in the moment
* null - create the page if it does not exist, unless it was deleted in the moment
* between retrieving the edit token and saving the edit (default)
* between loading the page and saving the edit (default)
*
*
*/
*/
Baris 1.958: Baris 2.323:
};
};


/** @param {boolean} minorEdit - set true to mark the edit as a minor edit. */
/**
* `minorEdit` - boolean value:
* True - When save is called, the resulting edit will be marked as "minor".
* False - When save is called, the resulting edit will not be marked as "minor". (default)
*/
this.setMinorEdit = function(minorEdit) {
this.setMinorEdit = function(minorEdit) {
ctx.minorEdit = minorEdit;
ctx.minorEdit = minorEdit;
};
};


/** @param {boolean} botEdit - set true to mark the edit as a bot edit */
/**
* `botEdit` is a boolean value:
* True - When save is called, the resulting edit will be marked as "bot".
* False - When save is called, the resulting edit will not be marked as "bot". (default)
*/
this.setBotEdit = function(botEdit) {
this.setBotEdit = function(botEdit) {
ctx.botEdit = botEdit;
ctx.botEdit = botEdit;
Baris 1.977: Baris 2.334:


/**
/**
* `pageSection` - integer specifying the section number to load or save.
* @param {number} pageSection - integer specifying the section number to load or save.
* The default is `null`, which means that the entire page will be retrieved.
* If specified as `null`, the entire page will be retrieved.
*/
*/
this.setPageSection = function(pageSection) {
this.setPageSection = function(pageSection) {
Baris 1.985: Baris 2.342:


/**
/**
* `maxRetries` - number of retries for save errors involving an edit conflict or loss of edit token.Default: 2
* @param {number} maxConflictRetries - number of retries for save errors involving an edit conflict or
* loss of token. Default: 2
*/
*/
this.setMaxConflictRetries = function(maxRetries) {
this.setMaxConflictRetries = function(maxConflictRetries) {
ctx.maxConflictRetries = maxRetries;
ctx.maxConflictRetries = maxConflictRetries;
};
};


/**
/**
* `maxRetries` - number of retries for save errors not involving an edit conflict or loss of edit token
* @param {number} maxRetries - number of retries for save errors not involving an edit conflict or
* loss of token. Default: 2
* Default: 2
*/
*/
this.setMaxRetries = function(maxRetries) {
this.setMaxRetries = function(maxRetries) {
Baris 2.000: Baris 2.358:


/**
/**
* `watchlistOption` is a boolean value:
* @param {boolean} watchlistOption
* True - page will be added to the user's watchlist when save() is called
* True - page will be added to the user's watchlist when save() is called
* False - watchlist status of the page will not be changed (default)
* False - watchlist status of the page will not be changed (default)
*/
*/
this.setWatchlist = function(watchlistOption) {
this.setWatchlist = function(watchlistOption) {
Baris 2.013: Baris 2.371:


/**
/**
* `watchlistOption` is a boolean value:
* @param {boolean} watchlistOption
* True - page watchlist status will be set based on the user's
* True - page watchlist status will be set based on the user's
* preference settings when save() is called
* preference settings when save() is called.
* False - watchlist status of the page will not be changed (default)
* False - watchlist status of the page will not be changed (default)
*
*
* Watchlist notes:
* Watchlist notes:
Baris 2.037: Baris 2.395:


/**
/**
* `followRedirect` is a boolean value:
* @param {boolean} followRedirect
* True - a maximum of one redirect will be followed.
* true - a maximum of one redirect will be followed.
* In the event of a redirect, a message is displayed to the user and
* In the event of a redirect, a message is displayed to the user and
* the redirect target can be retrieved with getPageName().
* the redirect target can be retrieved with getPageName().
* False - the requested pageName will be used without regard to any redirect. (default)
* false - the requested pageName will be used without regard to any redirect (default).
*/
*/
this.setFollowRedirect = function(followRedirect) {
this.setFollowRedirect = function(followRedirect) {
if (ctx.pageLoaded) {
if (ctx.pageLoaded) {
ctx.statusElement.error("Internal error: cannot change redirect setting after the page has been loaded!");
ctx.statusElement.error('Internal error: cannot change redirect setting after the page has been loaded!');
return;
return;
}
}
ctx.followRedirect = followRedirect;
ctx.followRedirect = followRedirect;
};

// lookup-creation setter function
/**
* @param {boolean} flag - if set true, the author and timestamp of the first non-redirect
* version of the page is retrieved.
*
* Warning:
* 1. If there are no revisions among the first 50 that are non-redirects, or if there are
* less 50 revisions and all are redirects, the original creation is retrived.
* 2. Revisions that the user is not privileged to access (revdeled/suppressed) will be treated
* as non-redirects.
* 3. Must not be used when the page has a non-wikitext contentmodel
* such as Modulespace Lua or user JavaScript/CSS
*/
this.setLookupNonRedirectCreator = function(flag) {
ctx.lookupNonRedirectCreator = flag;
};
};


// Move-related setter functions
// Move-related setter functions
/** @param {string} destination */
this.setMoveDestination = function(destination) {
this.setMoveDestination = function(destination) {
ctx.moveDestination = destination;
ctx.moveDestination = destination;
};
};


/** @param {boolean} flag */
this.setMoveTalkPage = function(flag) {
this.setMoveTalkPage = function(flag) {
ctx.moveTalkPage = !!flag;
ctx.moveTalkPage = !!flag;
};
};


/** @param {boolean} flag */
this.setMoveSubpages = function(flag) {
this.setMoveSubpages = function(flag) {
ctx.moveSubpages = !!flag;
ctx.moveSubpages = !!flag;
};
};


/** @param {boolean} flag */
this.setMoveSuppressRedirect = function(flag) {
this.setMoveSuppressRedirect = function(flag) {
ctx.moveSuppressRedirect = !!flag;
ctx.moveSuppressRedirect = !!flag;
Baris 2.094: Baris 2.473:
};
};


/** @returns {string} string containing the current revision ID of the page */
/**
* @returns {string} string containing the current revision ID of the page
*/
this.getCurrentID = function() {
this.getCurrentID = function() {
return ctx.revertCurID;
return ctx.revertCurID;
};
};


/** @returns {string} last editor of the page */
this.getRevisionUser = function() {
this.getRevisionUser = function() {
return ctx.revertUser;
return ctx.revertUser;
};

/** @returns {string} ISO 8601 timestamp at which the page was last edited. */
this.getLastEditTime = function() {
return ctx.lastEditTime;
};
};


Baris 2.134: Baris 2.517:
};
};


/**

* @param {string} level The right required for edits not to require
* review. Possible options: none, autoconfirmed, review (not on enWiki).
* @param {string} expiry
*/
this.setFlaggedRevs = function(level, expiry) {
this.setFlaggedRevs = function(level, expiry) {
ctx.flaggedRevs = { level: level, expiry: expiry };
ctx.flaggedRevs = { level: level, expiry: expiry };
Baris 2.147: Baris 2.534:


/**
/**
* @returns {string} the user who created the page following lookupCreator()
* @returns {string} Page ID of the page loaded. 0 if the page doesn't
* exist.
*/
this.getPageID = function() {
return ctx.pageID;
};

/**
* @returns {string} ISO 8601 timestamp at which the page was last loaded
*/
this.getLoadTime = function() {
return ctx.loadTime;
};

/**
* @returns {string} the user who created the page following lookupCreation()
*/
*/
this.getCreator = function() {
this.getCreator = function() {
Baris 2.154: Baris 2.556:


/**
/**
* @returns {string} the ISOString timestamp of page creation following lookupCreation()
* Retrieves the username of the user who created the page
*/
this.getCreationTimestamp = function() {
return ctx.timestamp;
};

/**
* Retrieves the username of the user who created the page as well as
* the timestamp of creation
* @param {Function} onSuccess - callback function (required) which is
* @param {Function} onSuccess - callback function (required) which is
* called when the username is found within the callback, the username
* called when the username and timestamp are found within the callback.
* can be retrieved using the getCreator() function
* The username can be retrieved using the getCreator() function;
* the timestamp can be retrieved using the getCreationTimestamp() function
* Prior to June 2019 known as lookupCreator
*/
*/
this.lookupCreator = function(onSuccess) {
this.lookupCreation = function(onSuccess) {
if (!onSuccess) {
if (!onSuccess) {
ctx.statusElement.error("Internal error: no onSuccess callback provided to lookupCreator()!");
ctx.statusElement.error('Internal error: no onSuccess callback provided to lookupCreation()!');
return;
return;
}
}
ctx.onLookupCreatorSuccess = onSuccess;
ctx.onLookupCreationSuccess = onSuccess;


var query = {
var query = {
Baris 2.171: Baris 2.583:
'titles': ctx.pageName,
'titles': ctx.pageName,
'rvlimit': 1,
'rvlimit': 1,
'rvprop': 'user',
'rvprop': 'user|timestamp',
'rvdir': 'newer'
'rvdir': 'newer'
};
};

// Only the wikitext content model can reliably handle
// rvsection, others return an error when paired with the
// content rvprop. Relatedly, non-wikitext models don't
// understand the #REDIRECT concept, so we shouldn't attempt
// the redirect resolution in fnLookupCreationSuccess
if (ctx.lookupNonRedirectCreator) {
query.rvsection = 0;
query.rvprop += '|content';
}


if (ctx.followRedirect) {
if (ctx.followRedirect) {
Baris 2.179: Baris 2.601:
}
}


ctx.lookupCreatorApi = new Morebits.wiki.api("Retrieving page creator information", query, fnLookupCreatorSuccess, ctx.statusElement);
ctx.lookupCreationApi = new Morebits.wiki.api('Retrieving page creation information', query, fnLookupCreationSuccess, ctx.statusElement);
ctx.lookupCreatorApi.setParent(this);
ctx.lookupCreationApi.setParent(this);
ctx.lookupCreatorApi.post();
ctx.lookupCreationApi.post();
};

/**
* marks the page as patrolled, if possible
*/
this.patrol = function() {
// There's no patrol link on page, so we can't patrol
if ( !$( '.patrollink' ).length ) {
return;
}

// Extract the rcid token from the "Mark page as patrolled" link on page
var patrolhref = $( '.patrollink a' ).attr( 'href' ),
rcid = mw.util.getParamValue( 'rcid', patrolhref );

if ( rcid ) {

var patrolstat = new Morebits.status( 'Marking page as patrolled' );

var wikipedia_api = new Morebits.wiki.api( 'doing...', {
action: 'patrol',
rcid: rcid,
token: mw.user.tokens.get( 'patrolToken' )
}, null, patrolstat );

// We don't really care about the response
wikipedia_api.post();
}
};
};


/**
/**
* Reverts a page to revertOldID
* Reverts a page to revertOldID
* @param {Function} onSuccess - callback function to run on success
* @param {Function} [onSuccess] - callback function to run on success (optional)
* @param {Function} [onFailure] - callback function to run on failure (optional)
* @param {Function} [onFailure] - callback function to run on failure (optional)
*/
*/
Baris 2.222: Baris 2.616:


if (!ctx.revertOldID) {
if (!ctx.revertOldID) {
ctx.statusElement.error("Internal error: revision ID to revert to was not set before revert!");
ctx.statusElement.error('Internal error: revision ID to revert to was not set before revert!');
ctx.onSaveFailure(this);
ctx.onSaveFailure(this);
return;
return;
Baris 2.233: Baris 2.627:
/**
/**
* Moves a page to another title
* Moves a page to another title
* @param {Function} onSuccess - callback function to run on success
* @param {Function} [onSuccess] - callback function to run on success (optional)
* @param {Function} [onFailure] - callback function to run on failure (optional)
* @param {Function} [onFailure] - callback function to run on failure (optional)
*/
*/
Baris 2.241: Baris 2.635:


if (!ctx.editSummary) {
if (!ctx.editSummary) {
ctx.statusElement.error("Internal error: move reason not set before move (use setEditSummary function)!");
ctx.statusElement.error('Internal error: move reason not set before move (use setEditSummary function)!');
ctx.onMoveFailure(this);
ctx.onMoveFailure(this);
return;
return;
}
}
if (!ctx.moveDestination) {
if (!ctx.moveDestination) {
ctx.statusElement.error("Internal error: destination page name was not set before move!");
ctx.statusElement.error('Internal error: destination page name was not set before move!');
ctx.onMoveFailure(this);
ctx.onMoveFailure(this);
return;
return;
}
}


if (fnCanUseMwUserToken('move')) {
var query = {
fnProcessMove.call(this, this);
action: 'query',
} else {
prop: 'info',
intoken: 'move',
var query = fnNeedTokenInfoQuery('move');

titles: ctx.pageName
ctx.moveApi = new Morebits.wiki.api('retrieving token...', query, fnProcessMove, ctx.statusElement, ctx.onMoveFailure);
};
ctx.moveApi.setParent(this);
if (ctx.followRedirect) {
ctx.moveApi.post();
query.redirects = ''; // follow all redirects
}
}
};
if (Morebits.userIsInGroup('sysop')) {

query.inprop = 'protection';
/**
* Marks the page as patrolled, using rcid (if available) or revid
*
* Patrolling as such doesn't need to rely on loading the page in
* question; simply passing a revid to the API is sufficient, so in
* those cases just using Morebits.wiki.api is probably preferable.
*
* No error handling since we don't actually care about the errors
*/
this.patrol = function() {
if (!Morebits.userIsSysop && !Morebits.userIsInGroup('patroller')) {
return;
}
}


// If a link is present, don't need to check if it's patrolled
ctx.moveApi = new Morebits.wiki.api("retrieving move token...", query, fnProcessMove, ctx.statusElement, ctx.onMoveFailure);
if ($('.patrollink').length) {
ctx.moveApi.setParent(this);
var patrolhref = $('.patrollink a').attr('href');
ctx.moveApi.post();
ctx.rcid = mw.util.getParamValue('rcid', patrolhref);
fnProcessPatrol(this, this);
} else {
var patrolQuery = {
action: 'query',
prop: 'info',
meta: 'tokens',
type: 'patrol', // as long as we're querying, might as well get a token
list: 'recentchanges', // check if the page is unpatrolled
titles: ctx.pageName,
rcprop: 'patrolled',
rctitle: ctx.pageName,
rclimit: 1
};

ctx.patrolApi = new Morebits.wiki.api('retrieving token...', patrolQuery, fnProcessPatrol);
ctx.patrolApi.setParent(this);
ctx.patrolApi.post();
}
};

/**
* Marks the page as reviewed by the PageTriage extension
* https://www.mediawiki.org/wiki/Extension:PageTriage
*
* Referred to as "review" on-wiki
*
* Will, by it's nature, mark as patrolled as well. Falls back to
* patrolling if not in an appropriate namespace.
*
* Doesn't inherently rely on loading the page in question; simply
* passing a pageid to the API is sufficient, so in those cases just
* using Morebits.wiki.api is probably preferable.
*
* No error handling since we don't actually care about the errors
*/
this.triage = function() {
// Fall back to patrol if not a valid triage namespace
if (mw.config.get('pageTriageNamespaces').indexOf(mw.config.get('wgNamespaceNumber')) === -1) {
this.patrol();
} else {
if (!Morebits.userIsSysop && !Morebits.userIsInGroup('patroller')) {
return;
}

// If on the page in question, don't need to query for page ID
if (new mw.Title(Morebits.pageNameNorm).getPrefixedText() === new mw.Title(ctx.pageName).getPrefixedText()) {
ctx.pageID = mw.config.get('wgArticleId');
fnProcessTriage(this, this);
} else {
var query = fnNeedTokenInfoQuery('triage');

ctx.triageApi = new Morebits.wiki.api('retrieving token...', query, fnProcessTriage);
ctx.triageApi.setParent(this);
ctx.triageApi.post();
}
}
};
};


Baris 2.272: Baris 2.735:
/**
/**
* Deletes a page (for admins only)
* Deletes a page (for admins only)
* @param {Function} onSuccess - callback function to run on success
* @param {Function} [onSuccess] - callback function to run on success (optional)
* @param {Function} [onFailure] - callback function to run on failure (optional)
* @param {Function} [onFailure] - callback function to run on failure (optional)
*/
*/
Baris 2.280: Baris 2.743:


// if a non-admin tries to do this, don't bother
// if a non-admin tries to do this, don't bother
if (!Morebits.userIsInGroup('sysop')) {
if (!Morebits.userIsSysop) {
ctx.statusElement.error("Cannot delete page: only admins can do that");
ctx.statusElement.error('Cannot delete page: only admins can do that');
ctx.onDeleteFailure(this);
ctx.onDeleteFailure(this);
return;
return;
}
}
if (!ctx.editSummary) {
if (!ctx.editSummary) {
ctx.statusElement.error("Internal error: delete reason not set before delete (use setEditSummary function)!");
ctx.statusElement.error('Internal error: delete reason not set before delete (use setEditSummary function)!');
ctx.onDeleteFailure(this);
ctx.onDeleteFailure(this);
return;
return;
Baris 2.294: Baris 2.757:
fnProcessDelete.call(this, this);
fnProcessDelete.call(this, this);
} else {
} else {
var query = {
var query = fnNeedTokenInfoQuery('delete');
action: 'query',
prop: 'info',
inprop: 'protection',
intoken: 'delete',
titles: ctx.pageName
};
if (ctx.followRedirect) {
query.redirects = ''; // follow all redirects
}


ctx.deleteApi = new Morebits.wiki.api("retrieving delete token...", query, fnProcessDelete, ctx.statusElement, ctx.onDeleteFailure);
ctx.deleteApi = new Morebits.wiki.api('retrieving token...', query, fnProcessDelete, ctx.statusElement, ctx.onDeleteFailure);
ctx.deleteApi.setParent(this);
ctx.deleteApi.setParent(this);
ctx.deleteApi.post();
ctx.deleteApi.post();
Baris 2.313: Baris 2.767:
/**
/**
* Undeletes a page (for admins only)
* Undeletes a page (for admins only)
* @param {Function} onSuccess - callback function to run on success
* @param {Function} [onSuccess] - callback function to run on success (optional)
* @param {Function} [onFailure] - callback function to run on failure (optional)
* @param {Function} [onFailure] - callback function to run on failure (optional)
*/
*/
Baris 2.321: Baris 2.775:


// if a non-admin tries to do this, don't bother
// if a non-admin tries to do this, don't bother
if (!Morebits.userIsInGroup('sysop')) {
if (!Morebits.userIsSysop) {
ctx.statusElement.error("Cannot undelete page: only admins can do that");
ctx.statusElement.error('Cannot undelete page: only admins can do that');
ctx.onUndeleteFailure(this);
ctx.onUndeleteFailure(this);
return;
return;
}
}
if (!ctx.editSummary) {
if (!ctx.editSummary) {
ctx.statusElement.error("Internal error: undelete reason not set before undelete (use setEditSummary function)!");
ctx.statusElement.error('Internal error: undelete reason not set before undelete (use setEditSummary function)!');
ctx.onUndeleteFailure(this);
ctx.onUndeleteFailure(this);
return;
return;
Baris 2.335: Baris 2.789:
fnProcessUndelete.call(this, this);
fnProcessUndelete.call(this, this);
} else {
} else {
var query = {
var query = fnNeedTokenInfoQuery('undelete');
action: 'query',
prop: 'info',
inprop: 'protection',
intoken: 'undelete',
titles: ctx.pageName
};


ctx.undeleteApi = new Morebits.wiki.api("retrieving undelete token...", query, fnProcessUndelete, ctx.statusElement, ctx.onUndeleteFailure);
ctx.undeleteApi = new Morebits.wiki.api('retrieving token...', query, fnProcessUndelete, ctx.statusElement, ctx.onUndeleteFailure);
ctx.undeleteApi.setParent(this);
ctx.undeleteApi.setParent(this);
ctx.undeleteApi.post();
ctx.undeleteApi.post();
Baris 2.351: Baris 2.799:
/**
/**
* Protects a page (for admins only)
* Protects a page (for admins only)
* @param {Function} onSuccess - callback function to run on success
* @param {Function} [onSuccess] - callback function to run on success (optional)
* @param {Function} [onFailure] - callback function to run on failure (optional)
* @param {Function} [onFailure] - callback function to run on failure (optional)
*/
*/
Baris 2.359: Baris 2.807:


// if a non-admin tries to do this, don't bother
// if a non-admin tries to do this, don't bother
if (!Morebits.userIsInGroup('sysop')) {
if (!Morebits.userIsSysop) {
ctx.statusElement.error("Cannot protect page: only admins can do that");
ctx.statusElement.error('Cannot protect page: only admins can do that');
ctx.onProtectFailure(this);
ctx.onProtectFailure(this);
return;
return;
}
}
if (!ctx.protectEdit && !ctx.protectMove && !ctx.protectCreate) {
if (!ctx.protectEdit && !ctx.protectMove && !ctx.protectCreate) {
ctx.statusElement.error("Internal error: you must set edit and/or move and/or create protection before calling protect()!");
ctx.statusElement.error('Internal error: you must set edit and/or move and/or create protection before calling protect()!');
ctx.onProtectFailure(this);
ctx.onProtectFailure(this);
return;
return;
}
}
if (!ctx.editSummary) {
if (!ctx.editSummary) {
ctx.statusElement.error("Internal error: protection reason not set before protect (use setEditSummary function)!");
ctx.statusElement.error('Internal error: protection reason not set before protect (use setEditSummary function)!');
ctx.onProtectFailure(this);
ctx.onProtectFailure(this);
return;
return;
}
}


// because of the way MW API interprets protection levels (absolute, not
// because of the way MW API interprets protection levels
// differential), we need to request protection levels from the server
// (absolute, not differential), we always need to request
// protection levels from the server
var query = {
var query = fnNeedTokenInfoQuery('protect');
action: 'query',
prop: 'info',
inprop: 'protection',
intoken: 'protect',
titles: ctx.pageName,
watchlist: ctx.watchlistOption
};
if (ctx.followRedirect) {
query.redirects = ''; // follow all redirects
}


ctx.protectApi = new Morebits.wiki.api("retrieving protect token...", query, fnProcessProtect, ctx.statusElement, ctx.onProtectFailure);
ctx.protectApi = new Morebits.wiki.api('retrieving token...', query, fnProcessProtect, ctx.statusElement, ctx.onProtectFailure);
ctx.protectApi.setParent(this);
ctx.protectApi.setParent(this);
ctx.protectApi.post();
ctx.protectApi.post();
};
};


/**
// apply FlaggedRevs protection-style settings
* Apply FlaggedRevs protection-style settings
// only works where $wgFlaggedRevsProtection = true (i.e. where FlaggedRevs
* only works where $wgFlaggedRevsProtection = true (i.e. where FlaggedRevs
// settings appear on the wiki's "protect" tab)
* settings appear on the wiki's "protect" tab)
* @param {function} [onSuccess]
* @param {function} [onFailure]
*/
this.stabilize = function(onSuccess, onFailure) {
this.stabilize = function(onSuccess, onFailure) {
ctx.onStabilizeSuccess = onSuccess;
ctx.onStabilizeSuccess = onSuccess;
Baris 2.402: Baris 2.845:


// if a non-admin tries to do this, don't bother
// if a non-admin tries to do this, don't bother
if (!Morebits.userIsInGroup('sysop')) {
if (!Morebits.userIsSysop) {
ctx.statusElement.error("Cannot apply FlaggedRevs settings: only admins can do that");
ctx.statusElement.error('Cannot apply FlaggedRevs settings: only admins can do that');
ctx.onStabilizeFailure(this);
ctx.onStabilizeFailure(this);
return;
return;
}
}
if (!ctx.flaggedRevs) {
if (!ctx.flaggedRevs) {
ctx.statusElement.error("Internal error: you must set flaggedRevs before calling stabilize()!");
ctx.statusElement.error('Internal error: you must set flaggedRevs before calling stabilize()!');
ctx.onStabilizeFailure(this);
ctx.onStabilizeFailure(this);
return;
return;
}
}
if (!ctx.editSummary) {
if (!ctx.editSummary) {
ctx.statusElement.error("Internal error: reason not set before calling stabilize() (use setEditSummary function)!");
ctx.statusElement.error('Internal error: reason not set before calling stabilize() (use setEditSummary function)!');
ctx.onStabilizeFailure(this);
ctx.onStabilizeFailure(this);
return;
return;
}
}


if (fnCanUseMwUserToken('stabilize')) {
var query = {
fnProcessStabilize.call(this, this);
action: 'query',
} else {
prop: 'info|flagged',
var query = fnNeedTokenInfoQuery('stabilize');
intoken: 'edit',

titles: ctx.pageName
ctx.stabilizeApi = new Morebits.wiki.api('retrieving token...', query, fnProcessStabilize, ctx.statusElement, ctx.onStabilizeFailure);
};
ctx.stabilizeApi.setParent(this);
if (ctx.followRedirect) {
ctx.stabilizeApi.post();
query.redirects = ''; // follow all redirects
}
}

ctx.stabilizeApi = new Morebits.wiki.api("retrieving stabilize token...", query, fnProcessStabilize, ctx.statusElement, ctx.onStabilizeFailure);
ctx.stabilizeApi.setParent(this);
ctx.stabilizeApi.post();
};
};


Baris 2.439: Baris 2.878:


/**
/**
* Determines whether we can save an API call by using the edit token sent with the page
* Determines whether we can save an API call by using the csrf token sent with the page
* HTML, or whether we need to ask the server for more info (e.g. protection expiry).
* HTML, or whether we need to ask the server for more info (e.g. protection expiry).
*
*
* Only applicable for csrf token actions, e.g. not patrol
* Currently only used for append, prepend, and deletePage.
*
*
* Currently used for append, prepend, deletePage, undeletePage, move,
* @param {string} action The action being undertaken, e.g. "edit", "delete".
* and stabilize. Can't use for protect since it always needs to
* request protection status.
*
* @param {string} [action=edit] The action being undertaken, e.g.
* "edit" or "delete". In practice, only "edit" or "notedit" matters.
* @returns {boolean}
* @returns {boolean}
*/
*/
var fnCanUseMwUserToken = function(action) {
var fnCanUseMwUserToken = function(action) {
action = typeof action !== 'undefined' ? action : 'edit'; // IE doesn't support default parameters

// API-based redirect resolution only works for action=query and
// API-based redirect resolution only works for action=query and
// action=edit in append/prepend modes (and section=new, but we don't
// action=edit in append/prepend modes (and section=new, but we don't
Baris 2.457: Baris 2.903:


// do we need to fetch the edit protection expiry?
// do we need to fetch the edit protection expiry?
if (Morebits.userIsInGroup('sysop') && !ctx.suppressProtectWarning) {
if (Morebits.userIsSysop && !ctx.suppressProtectWarning) {
if (new mw.Title(Morebits.pageNameNorm).getPrefixedText() === new mw.Title(ctx.pageName).getPrefixedText()) {
// poor man's normalisation
if (Morebits.string.toUpperCaseFirstChar(mw.config.get('wgPageName')).replace(/ /g, '_').trim() !==
Morebits.string.toUpperCaseFirstChar(ctx.pageName).replace(/ /g, '_').trim()) {
return false;
return false;
}
}


// wgRestrictionEdit is null on non-existent pages,
// so this neatly handles nonexistent pages
var editRestriction = mw.config.get('wgRestrictionEdit');
var editRestriction = mw.config.get('wgRestrictionEdit');
if (!editRestriction || editRestriction.indexOf('sysop') !== -1) {
if (!editRestriction || editRestriction.indexOf('sysop') !== -1) {
Baris 2.471: Baris 2.917:


return !!mw.user.tokens.get('csrfToken');
return !!mw.user.tokens.get('csrfToken');
};

/**
* When functions can't use fnCanUseMwUserToken or require checking
* protection, maintain the query in one place. Used for delete,
* undelete, protect, stabilize, and move (basically, just not load)
*
* @param {string} action The action being undertaken, e.g. "edit" or
* "delete"
*/
var fnNeedTokenInfoQuery = function(action) {
var query = {
action: 'query',
meta: 'tokens',
type: 'csrf',
titles: ctx.pageName
};
// Protection not checked for flagged-revs or non-sysop moves
if (action !== 'stabilize' && (action !== 'move' || Morebits.userIsSysop)) {
query.prop = 'info';
query.inprop = 'protection';
}
if (ctx.followRedirect && action !== 'undelete') {
query.redirects = ''; // follow all redirects
}
return query;
};
};


Baris 2.482: Baris 2.954:
var xml = ctx.loadApi.getXML();
var xml = ctx.loadApi.getXML();


if ( !fnCheckPageName(xml, ctx.onLoadFailure) ) {
if (!fnCheckPageName(xml, ctx.onLoadFailure)) {
return; // abort
return; // abort
}
}


ctx.pageExists = ($(xml).find('page').attr('missing') !== "");
ctx.pageExists = $(xml).find('page').attr('missing') !== '';
if (ctx.pageExists) {
if (ctx.pageExists) {
ctx.pageText = $(xml).find('rev').text();
ctx.pageText = $(xml).find('rev').text();
ctx.pageID = $(xml).find('page').attr('pageid');
} else {
} else {
ctx.pageText = ''; // allow for concatenation, etc.
ctx.pageText = ''; // allow for concatenation, etc.
ctx.pageID = 0; // nonexistent in response, matches wgArticleId
}
ctx.csrfToken = $(xml).find('tokens').attr('csrftoken');
if (!ctx.csrfToken) {
ctx.statusElement.error('Failed to retrieve edit token.');
ctx.onLoadFailure(this);
return;
}
ctx.loadTime = $(xml).find('api').attr('curtimestamp');
if (!ctx.loadTime) {
ctx.statusElement.error('Failed to retrieve current timestamp.');
ctx.onLoadFailure(this);
return;
}
}


// extract protection info, to alert admins when they are about to edit a protected page
// extract protection info, to alert admins when they are about to edit a protected page
if (Morebits.userIsInGroup('sysop')) {
if (Morebits.userIsSysop) {
var editprot = $(xml).find('pr[type="edit"]');
var editprot = $(xml).find('pr[type="edit"]');
if (editprot.length > 0 && editprot.attr('level') === 'sysop') {
if (editprot.length > 0 && editprot.attr('level') === 'sysop') {
Baris 2.503: Baris 2.989:
}
}


ctx.editToken = $(xml).find('page').attr('edittoken');
if (!ctx.editToken) {
ctx.statusElement.error("Failed to retrieve edit token.");
ctx.onLoadFailure(this);
return;
}
ctx.loadTime = $(xml).find('page').attr('starttimestamp');
if (!ctx.loadTime) {
ctx.statusElement.error("Failed to retrieve start timestamp.");
ctx.onLoadFailure(this);
return;
}
ctx.lastEditTime = $(xml).find('rev').attr('timestamp');
ctx.lastEditTime = $(xml).find('rev').attr('timestamp');
ctx.revertCurID = $(xml).find('page').attr('lastrevid');
ctx.revertCurID = $(xml).find('page').attr('lastrevid');
Baris 2.521: Baris 2.995:
ctx.revertCurID = $(xml).find('rev').attr('revid');
ctx.revertCurID = $(xml).find('rev').attr('revid');
if (!ctx.revertCurID) {
if (!ctx.revertCurID) {
ctx.statusElement.error("Failed to retrieve current revision ID.");
ctx.statusElement.error('Failed to retrieve current revision ID.');
ctx.onLoadFailure(this);
ctx.onLoadFailure(this);
return;
return;
Baris 2.527: Baris 3.001:
ctx.revertUser = $(xml).find('rev').attr('user');
ctx.revertUser = $(xml).find('rev').attr('user');
if (!ctx.revertUser) {
if (!ctx.revertUser) {
if ($(xml).find('rev').attr('userhidden') === "") { // username was RevDel'd or oversighted
if ($(xml).find('rev').attr('userhidden') === '') { // username was RevDel'd or oversighted
ctx.revertUser = "<username hidden>";
ctx.revertUser = '<username hidden>';
} else {
} else {
ctx.statusElement.error("Failed to retrieve user who made the revision.");
ctx.statusElement.error('Failed to retrieve user who made the revision.');
ctx.onLoadFailure(this);
ctx.onLoadFailure(this);
return;
return;
Baris 2.536: Baris 3.010:
}
}
// set revert edit summary
// set revert edit summary
ctx.editSummary = "[[Help:Revert|Reverted]] to revision " + ctx.revertOldID + " by " + ctx.revertUser + ": " + ctx.editSummary;
ctx.editSummary = '[[Help:Revert|Reverted]] to revision ' + ctx.revertOldID + ' by ' + ctx.revertUser + ': ' + ctx.editSummary;
}
}


Baris 2.552: Baris 3.026:


// check for invalid titles
// check for invalid titles
if ( $(xml).find('page').attr('invalid') === "" ) {
if ($(xml).find('page').attr('invalid') === '') {
ctx.statusElement.error("The page title is invalid: " + ctx.pageName);
ctx.statusElement.error('The page title is invalid: ' + ctx.pageName);
onFailure(this);
onFailure(this);
return false; // abort
return false; // abort
Baris 2.559: Baris 3.033:


// retrieve actual title of the page after normalization and redirects
// retrieve actual title of the page after normalization and redirects
if ( $(xml).find('page').attr('title') ) {
if ($(xml).find('page').attr('title')) {
var resolvedName = $(xml).find('page').attr('title');
var resolvedName = $(xml).find('page').attr('title');


// only notify user for redirects, not normalization
// only notify user for redirects, not normalization
if ( $(xml).find('redirects').length > 0 ) {
if ($(xml).find('redirects').length > 0) {
Morebits.status.info("Info", "Redirected from " + ctx.pageName + " to " + resolvedName );
Morebits.status.info('Info', 'Redirected from ' + ctx.pageName + ' to ' + resolvedName);
}
}
ctx.pageName = resolvedName; // always update in case of normalization
ctx.pageName = resolvedName; // always update in case of normalization
}
} else {
else {
// could be a circular redirect or other problem
// could be a circular redirect or other problem
ctx.statusElement.error("Could not resolve redirects for: " + ctx.pageName);
ctx.statusElement.error('Could not resolve redirects for: ' + ctx.pageName);
onFailure(this);
onFailure(this);


Baris 2.578: Baris 3.051:
}
}
return true; // all OK
return true; // all OK
};

// helper function to get a new token on encountering token errors in save, deletePage, and undeletePage
var fnGetToken = function() {
var tokenApi = new Morebits.wiki.api('Getting token', {
action: 'query',
meta: 'tokens'
});
return tokenApi.post().then(function(apiobj) {
return $(apiobj.responseXML).find('tokens').attr('csrftoken');
});
};
};


Baris 2.586: Baris 3.070:


// see if the API thinks we were successful
// see if the API thinks we were successful
if ($(xml).find('edit').attr('result') === "Success") {
if ($(xml).find('edit').attr('result') === 'Success') {


// real success
// real success
// default on success action - display link for edited page
// default on success action - display link for edited page
var link = document.createElement('a');
var link = document.createElement('a');
link.setAttribute('href', mw.util.getUrl(ctx.pageName) );
link.setAttribute('href', mw.util.getUrl(ctx.pageName));
link.appendChild(document.createTextNode(ctx.pageName));
link.appendChild(document.createTextNode(ctx.pageName));
ctx.statusElement.info(['completed (', link, ')']);
ctx.statusElement.info(['completed (', link, ')']);
Baris 2.600: Baris 3.084:
}
}


// errors here are only generated by extensions which hook APIEditBeforeSave within MediaWiki
// errors here are only generated by extensions which hook APIEditBeforeSave within MediaWiki,
// Wikimedia wikis should only return spam blacklist errors, captchas, and AbuseFilter messages
// which as of 1.34.0-wmf.23 (Sept 2019) should only encompass captcha messages
var $editNode = $(xml).find('edit');
if ($(xml).find('captcha').length > 0) {
ctx.statusElement.error('Could not save the page because the wiki server wanted you to fill out a CAPTCHA.');
var blacklist = $editNode.attr('spamblacklist');

if (blacklist) {
var code = document.createElement('code');
code.style.fontFamily = "monospace";
code.appendChild(document.createTextNode(blacklist));
ctx.statusElement.error(['Could not save the page because the URL ', code, ' is on the spam blacklist.']);
} else if ( $(xml).find('captcha').length > 0 ) {
ctx.statusElement.error("Could not save the page because the wiki server wanted you to fill out a CAPTCHA.");
} else if ( $editNode.attr('code') === 'abusefilter-disallowed' ) {
ctx.statusElement.error('The edit was disallowed by the edit filter rule "' + $editNode.attr('info').substring(17) + '".');
} else if ( $editNode.attr('info').indexOf('Hit AbuseFilter:') === 0 ) {
var div = document.createElement('div');
div.className = "toccolours";
div.style.fontWeight = "normal";
div.style.color = "black";
div.innerHTML = $editNode.attr('warning');
ctx.statusElement.error([ 'The following warning was returned by the edit filter: ', div, 'If you wish to proceed with the edit, please carry it out again. This warning wil not appear a second time.' ]);
// XXX provide the user with a way to automatically retry the action if they so choose -
// I can't see how to do this without creating a UI dependency on Morebits.wiki.page though -- TTO
} else {
} else {
ctx.statusElement.error("Unknown error received from API while saving page");
ctx.statusElement.error('Unknown error received from API while saving page');
}
}


Baris 2.635: Baris 3.100:
// callback from saveApi.post()
// callback from saveApi.post()
var fnSaveError = function() {
var fnSaveError = function() {

var errorCode = ctx.saveApi.getErrorCode();
var errorCode = ctx.saveApi.getErrorCode();


// check for edit conflict
// check for edit conflict
if ( errorCode === "editconflict" && ctx.conflictRetries++ < ctx.maxConflictRetries ) {
if (errorCode === 'editconflict' && ctx.conflictRetries++ < ctx.maxConflictRetries) {


// edit conflicts can occur when the page needs to be purged from the server cache
// edit conflicts can occur when the page needs to be purged from the server cache
Baris 2.647: Baris 3.111:
};
};


var purgeApi = new Morebits.wiki.api("Edit conflict detected, purging server cache", purgeQuery, null, ctx.statusElement);
var purgeApi = new Morebits.wiki.api('Edit conflict detected, purging server cache', purgeQuery, function() {
--Morebits.wiki.numberOfActionsLeft; // allow for normal completion if retry succeeds
purgeApi.post( { async: false } ); // just wait for it, result is for debugging


ctx.statusElement.info('Edit conflict detected, reapplying edit');
--Morebits.wiki.numberOfActionsLeft; // allow for normal completion if retry succeeds
if (fnCanUseMwUserToken('edit')) {

ctx.saveApi.post(); // necessarily append or prepend, so this should work as desired
ctx.statusElement.info("Edit conflict detected, reapplying edit");
} else {
if (fnCanUseMwUserToken('edit')) {
ctx.saveApi.post(); // necessarily append or prepend, so this should work as desired
ctx.loadApi.post(); // reload the page and reapply the edit
} else {
}
}, ctx.statusElement);
ctx.loadApi.post(); // reload the page and reapply the edit
purgeApi.post();
}


// check for loss of edit token
// check for loss of edit token
} else if (errorCode === 'badtoken' && ctx.retries++ < ctx.maxRetries) {
// it's impractical to request a new token here, so invoke edit conflict logic when this happens
} else if ( errorCode === "notoken" && ctx.conflictRetries++ < ctx.maxConflictRetries ) {


ctx.statusElement.info("Edit token is invalid, retrying");
ctx.statusElement.info('Edit token is invalid, retrying');
--Morebits.wiki.numberOfActionsLeft; // allow for normal completion if retry succeeds
--Morebits.wiki.numberOfActionsLeft; // allow for normal completion if retry succeeds
fnGetToken().then(function(token) {
if (fnCanUseMwUserToken('edit')) {
ctx.saveApi.query.token = token;
this.load(fnAutoSave, ctx.onSaveFailure); // try the append or prepend again
ctx.saveApi.post();
} else {
});
ctx.loadApi.post(); // reload the page and reapply the edit
}


// check for network or server error
// check for network or server error
} else if ( errorCode === "undefined" && ctx.retries++ < ctx.maxRetries ) {
} else if (errorCode === 'undefined' && ctx.retries++ < ctx.maxRetries) {


// the error might be transient, so try again
// the error might be transient, so try again
ctx.statusElement.info("Save failed, retrying");
ctx.statusElement.info('Save failed, retrying');
--Morebits.wiki.numberOfActionsLeft; // allow for normal completion if retry succeeds
--Morebits.wiki.numberOfActionsLeft; // allow for normal completion if retry succeeds
ctx.saveApi.post(); // give it another go!
ctx.saveApi.post(); // give it another go!
Baris 2.683: Baris 3.145:


// non-admin attempting to edit a protected page - this gives a friendlier message than the default
// non-admin attempting to edit a protected page - this gives a friendlier message than the default
if ( errorCode === "protectedpage" ) {
if (errorCode === 'protectedpage') {
ctx.statusElement.error( "Failed to save edit: Page is protected" );
ctx.statusElement.error('Failed to save edit: Page is protected');
// check for absuefilter hits: disallowed or warning
} else if (errorCode.indexOf('abusefilter') === 0) {
var desc = $(ctx.saveApi.getXML()).find('abusefilter').attr('description');
if (errorCode === 'abusefilter-disallowed') {
ctx.statusElement.error('The edit was disallowed by the edit filter: "' + desc + '".');
} else if (errorCode === 'abusefilter-warning') {
ctx.statusElement.error([ 'A warning was returned by the edit filter: "', desc, '". If you wish to proceed with the edit, please carry it out again. This warning will not appear a second time.' ]);
// We should provide the user with a way to automatically retry the action if they so choose -
// I can't see how to do this without creating a UI dependency on Morebits.wiki.page though -- TTO
} else { // shouldn't happen but...
ctx.statusElement.error('The edit was disallowed by the edit filter.');
}
// check for blacklist hits
} else if (errorCode === 'spamblacklist') {
// .find('matches') returns an array in case multiple items are blacklisted, we only return the first
var spam = $(ctx.saveApi.getXML()).find('spamblacklist').find('matches').children()[0].textContent;
ctx.statusElement.error('Could not save the page because the URL ' + spam + ' is on the spam blacklist');
} else {
} else {
ctx.statusElement.error( "Failed to save edit: " + ctx.saveApi.getErrorText() );
ctx.statusElement.error('Failed to save edit: ' + ctx.saveApi.getErrorText());
}
}
ctx.editMode = 'all'; // cancel append/prepend/revert modes
ctx.editMode = 'all'; // cancel append/prepend/revert modes
Baris 2.695: Baris 3.174:
};
};


var fnLookupCreatorSuccess = function() {
var fnLookupCreationSuccess = function() {
var xml = ctx.lookupCreatorApi.getXML();
var xml = ctx.lookupCreationApi.getXML();


if ( !fnCheckPageName(xml) ) {
if (!fnCheckPageName(xml)) {
return; // abort
return; // abort
}
}


ctx.creator = $(xml).find('rev').attr('user');
if (!ctx.lookupNonRedirectCreator || !/^\s*#redirect/i.test($(xml).find('rev').text())) {

ctx.creator = $(xml).find('rev').attr('user');
if (!ctx.creator) {
ctx.statusElement.error('Could not find name of page creator');
return;
}
ctx.timestamp = $(xml).find('rev').attr('timestamp');
if (!ctx.timestamp) {
ctx.statusElement.error('Could not find timestamp of page creation');
return;
}
ctx.onLookupCreationSuccess(this);

} else {
ctx.lookupCreationApi.query.rvlimit = 50; // modify previous query to fetch more revisions
ctx.lookupCreationApi.query.titles = ctx.pageName; // update pageName if redirect resolution took place in earlier query

ctx.lookupCreationApi = new Morebits.wiki.api('Retrieving page creation information', ctx.lookupCreationApi.query, fnLookupNonRedirectCreator, ctx.statusElement);
ctx.lookupCreationApi.setParent(this);
ctx.lookupCreationApi.post();
}

};

var fnLookupNonRedirectCreator = function() {
var xml = ctx.lookupCreationApi.getXML();

$(xml).find('rev').each(function(_, rev) {
if (!/^\s*#redirect/i.test(rev.textContent)) { // inaccessible revisions also check out
ctx.creator = rev.getAttribute('user');
ctx.timestamp = rev.getAttribute('timestamp');
return false; // break
}
});

if (!ctx.creator) {
if (!ctx.creator) {
// fallback to give first revision author if no non-redirect version in the first 50
ctx.statusElement.error("Could not find name of page creator");
ctx.creator = $(xml).find('rev')[0].getAttribute('user');
ctx.timestamp = $(xml).find('rev')[0].getAttribute('timestamp');
if (!ctx.creator) {
ctx.statusElement.error('Could not find name of page creator');
return;
}

}
if (!ctx.timestamp) {
ctx.statusElement.error('Could not find timestamp of page creation');
return;
return;
}
}

ctx.onLookupCreatorSuccess(this);
ctx.onLookupCreationSuccess(this);

};
};


var fnProcessMove = function() {
var fnProcessMove = function() {
var pageTitle, token;
var xml = ctx.moveApi.getXML();


if ($(xml).find('page').attr('missing') === "") {
if (fnCanUseMwUserToken('move')) {
token = mw.user.tokens.get('csrfToken');
ctx.statusElement.error("Cannot move the page, because it no longer exists");
ctx.onMoveFailure(this);
pageTitle = ctx.pageName;
} else {
return;
var xml = ctx.moveApi.getXML();
}


if ($(xml).find('page').attr('missing') === '') {
// extract protection info
ctx.statusElement.error('Cannot move the page, because it no longer exists');
if (Morebits.userIsInGroup('sysop')) {
var editprot = $(xml).find('pr[type="edit"]');
if (editprot.length > 0 && editprot.attr('level') === 'sysop' && !ctx.suppressProtectWarning &&
!confirm('You are about to move the fully protected page "' + ctx.pageName +
(editprot.attr('expiry') === 'infinity' ? '" (protected indefinitely)' : ('" (protection expiring ' + editprot.attr('expiry') + ')')) +
'. \n\nClick OK to proceed with the move, or Cancel to skip this move.')) {
ctx.statusElement.error("Move of fully protected page was aborted.");
ctx.onMoveFailure(this);
ctx.onMoveFailure(this);
return;
return;
}
}
}


// extract protection info
var moveToken = $(xml).find('page').attr('movetoken');
if (!moveToken) {
if (Morebits.userIsSysop) {
var editprot = $(xml).find('pr[type="edit"]');
ctx.statusElement.error("Failed to retrieve move token.");
if (editprot.length > 0 && editprot.attr('level') === 'sysop' && !ctx.suppressProtectWarning &&
ctx.onMoveFailure(this);
!confirm('You are about to move the fully protected page "' + ctx.pageName +
return;
(editprot.attr('expiry') === 'infinity' ? '" (protected indefinitely)' : '" (protection expiring ' + new Morebits.date(editprot.attr('expiry')).calendar('utc') + ' (UTC))') +
'. \n\nClick OK to proceed with the move, or Cancel to skip this move.')) {
ctx.statusElement.error('Move of fully protected page was aborted.');
ctx.onMoveFailure(this);
return;
}
}

token = $(xml).find('tokens').attr('csrftoken');
if (!token) {
ctx.statusElement.error('Failed to retrieve move token.');
ctx.onMoveFailure(this);
return;
}

pageTitle = $(xml).find('page').attr('title');
}
}


var query = {
var query = {
'action': 'move',
'action': 'move',
'from': $(xml).find('page').attr('title'),
'from': pageTitle,
'to': ctx.moveDestination,
'to': ctx.moveDestination,
'token': moveToken,
'token': token,
'reason': ctx.editSummary
'reason': ctx.editSummary,
'watchlist': ctx.watchlistOption
};
};
if (ctx.moveTalkPage) {
if (ctx.moveTalkPage) {
Baris 2.750: Baris 3.286:
}
}
if (ctx.moveSubpages) {
if (ctx.moveSubpages) {
query.movesubpages = 'true'; // XXX don't know whether this works for non-admins
query.movesubpages = 'true';
}
}
if (ctx.moveSuppressRedirect) {
if (ctx.moveSuppressRedirect) {
query.noredirect = 'true';
query.noredirect = 'true';
}
if (ctx.watchlistOption === 'watch') {
query.watch = 'true';
}
}


ctx.moveProcessApi = new Morebits.wiki.api("moving page...", query, ctx.onMoveSuccess, ctx.statusElement, ctx.onMoveFailure);
ctx.moveProcessApi = new Morebits.wiki.api('moving page...', query, ctx.onMoveSuccess, ctx.statusElement, ctx.onMoveFailure);
ctx.moveProcessApi.setParent(this);
ctx.moveProcessApi.setParent(this);
ctx.moveProcessApi.post();
ctx.moveProcessApi.post();
};

var fnProcessPatrol = function() {
var query = {
action: 'patrol'
};

// Didn't need to load the page
if (ctx.rcid) {
query.rcid = ctx.rcid;
query.token = mw.user.tokens.get('patrolToken');
} else {
var xml = ctx.patrolApi.getResponse();

// Don't patrol if not unpatrolled
if ($(xml).find('rc').attr('unpatrolled') !== '') {
return;
}

var lastrevid = $(xml).find('page').attr('lastrevid');
if (!lastrevid) {
return;
}
query.revid = lastrevid;

var token = $(xml).find('tokens').attr('patroltoken');
if (!token) {
return;
}

query.token = token;
}

var patrolStat = new Morebits.status('Marking page as patrolled');

ctx.patrolProcessApi = new Morebits.wiki.api('patrolling page...', query, null, patrolStat);
ctx.patrolProcessApi.setParent(this);
ctx.patrolProcessApi.post();
};

var fnProcessTriage = function() {
var pageID, token;

if (ctx.pageID) {
token = mw.user.tokens.get('csrfToken');
pageID = ctx.pageID;
} else {
var xml = ctx.triageApi.getXML();

pageID = $(xml).find('page').attr('pageid');
if (!pageID) {
return;
}

token = $(xml).find('tokens').attr('csrftoken');
if (!token) {
return;
}
}

var query = {
action: 'pagetriageaction',
pageid: pageID,
reviewed: 1,
token: token
};

var triageStat = new Morebits.status('Marking page as curated');

ctx.triageProcessApi = new Morebits.wiki.api('curating page...', query, null, triageStat, fnProcessTriageError);
ctx.triageProcessApi.setParent(this);
ctx.triageProcessApi.post();
};

// callback from triageProcessApi.post()
var fnProcessTriageError = function() {
// Ignore error if page not in queue, see https://github.com/azatoth/twinkle/pull/930
if (ctx.triageProcessApi.getErrorCode() === 'bad-pagetriage-page') {
ctx.triageProcessApi.getStatusElement().unlink();
}
};
};


Baris 2.773: Baris 3.386:
var xml = ctx.deleteApi.getXML();
var xml = ctx.deleteApi.getXML();


if ($(xml).find('page').attr('missing') === "") {
if ($(xml).find('page').attr('missing') === '') {
ctx.statusElement.error("Cannot delete the page, because it no longer exists");
ctx.statusElement.error('Cannot delete the page, because it no longer exists');
ctx.onDeleteFailure(this);
ctx.onDeleteFailure(this);
return;
return;
Baris 2.783: Baris 3.396:
if (editprot.length > 0 && editprot.attr('level') === 'sysop' && !ctx.suppressProtectWarning &&
if (editprot.length > 0 && editprot.attr('level') === 'sysop' && !ctx.suppressProtectWarning &&
!confirm('You are about to delete the fully protected page "' + ctx.pageName +
!confirm('You are about to delete the fully protected page "' + ctx.pageName +
(editprot.attr('expiry') === 'infinity' ? '" (protected indefinitely)' : ('" (protection expiring ' + editprot.attr('expiry') + ')')) +
(editprot.attr('expiry') === 'infinity' ? '" (protected indefinitely)' : '" (protection expiring ' + new Morebits.date(editprot.attr('expiry')).calendar('utc') + ' (UTC))') +
'. \n\nClick OK to proceed with the deletion, or Cancel to skip this deletion.')) {
'. \n\nClick OK to proceed with the deletion, or Cancel to skip this deletion.')) {
ctx.statusElement.error("Deletion of fully protected page was aborted.");
ctx.statusElement.error('Deletion of fully protected page was aborted.');
ctx.onDeleteFailure(this);
ctx.onDeleteFailure(this);
return;
return;
}
}


token = $(xml).find('page').attr('deletetoken');
token = $(xml).find('tokens').attr('csrftoken');
if (!token) {
if (!token) {
ctx.statusElement.error("Failed to retrieve delete token.");
ctx.statusElement.error('Failed to retrieve delete token.');
ctx.onDeleteFailure(this);
ctx.onDeleteFailure(this);
return;
return;
Baris 2.804: Baris 3.417:
'title': pageTitle,
'title': pageTitle,
'token': token,
'token': token,
'reason': ctx.editSummary
'reason': ctx.editSummary,
'watchlist': ctx.watchlistOption
};
};
if (ctx.watchlistOption === 'watch') {
query.watch = 'true';
}


ctx.deleteProcessApi = new Morebits.wiki.api("deleting page...", query, ctx.onDeleteSuccess, ctx.statusElement, fnProcessDeleteError);
ctx.deleteProcessApi = new Morebits.wiki.api('deleting page...', query, ctx.onDeleteSuccess, ctx.statusElement, fnProcessDeleteError);
ctx.deleteProcessApi.setParent(this);
ctx.deleteProcessApi.setParent(this);
ctx.deleteProcessApi.post();
ctx.deleteProcessApi.post();
Baris 2.821: Baris 3.432:


// check for "Database query error"
// check for "Database query error"
if ( errorCode === "internal_api_error_DBQueryError" && ctx.retries++ < ctx.maxRetries ) {
if (errorCode === 'internal_api_error_DBQueryError' && ctx.retries++ < ctx.maxRetries) {
ctx.statusElement.info("Database query error, retrying");
ctx.statusElement.info('Database query error, retrying');
--Morebits.wiki.numberOfActionsLeft; // allow for normal completion if retry succeeds
--Morebits.wiki.numberOfActionsLeft; // allow for normal completion if retry succeeds
ctx.deleteProcessApi.post(); // give it another go!
ctx.deleteProcessApi.post(); // give it another go!
} else if ( errorCode === "badtoken" ) {
} else if (errorCode === 'badtoken' && ctx.retries++ < ctx.maxRetries) {
ctx.statusElement.info('Invalid token, retrying');
// this is pathetic, but given the current state of Morebits.wiki.page it would
--Morebits.wiki.numberOfActionsLeft;
// be a dog's breakfast to try and fix this
fnGetToken().then(function(token) {
ctx.statusElement.error("Invalid token. Please refresh the page and try again.");
ctx.deleteProcessApi.query.token = token;
if (ctx.onDeleteFailure) {
ctx.deleteProcessApi.post();
ctx.onDeleteFailure.call(this, this, ctx.deleteProcessApi);
}
});
} else if ( errorCode === "missingtitle" ) {
} else if (errorCode === 'missingtitle') {
ctx.statusElement.error("Cannot delete the page, because it no longer exists");
ctx.statusElement.error('Cannot delete the page, because it no longer exists');
if (ctx.onDeleteFailure) {
if (ctx.onDeleteFailure) {
ctx.onDeleteFailure.call(this, ctx.deleteProcessApi); // invoke callback
ctx.onDeleteFailure.call(this, ctx.deleteProcessApi); // invoke callback
Baris 2.839: Baris 3.450:
// hard error, give up
// hard error, give up
} else {
} else {
ctx.statusElement.error( "Failed to delete the page: " + ctx.deleteProcessApi.getErrorText() );
ctx.statusElement.error('Failed to delete the page: ' + ctx.deleteProcessApi.getErrorText());
if (ctx.onDeleteFailure) {
if (ctx.onDeleteFailure) {
ctx.onDeleteFailure.call(this, ctx.deleteProcessApi); // invoke callback
ctx.onDeleteFailure.call(this, ctx.deleteProcessApi); // invoke callback
Baris 2.849: Baris 3.460:
var pageTitle, token;
var pageTitle, token;


// The whole handling of tokens in Morebits is outdated (#615)
// but has generally worked since intoken has been deprecated
// but remains. intoken does not, however, take undelete, so
// fnCanUseMwUserToken('undelete') is no good. Everything
// except watching and patrolling should eventually use csrf,
// but until then (#615) the stupid hack below should work for
// undeletion.
if (fnCanUseMwUserToken('undelete')) {
if (fnCanUseMwUserToken('undelete')) {
token = mw.user.tokens.get('csrfToken');
token = mw.user.tokens.get('csrfToken');
Baris 2.862: Baris 3.466:
var xml = ctx.undeleteApi.getXML();
var xml = ctx.undeleteApi.getXML();


if ($(xml).find('page').attr('missing') !== "") {
if ($(xml).find('page').attr('missing') !== '') {
ctx.statusElement.error("Cannot undelete the page, because it already exists");
ctx.statusElement.error('Cannot undelete the page, because it already exists');
ctx.onUndeleteFailure(this);
ctx.onUndeleteFailure(this);
return;
return;
Baris 2.872: Baris 3.476:
if (editprot.length > 0 && editprot.attr('level') === 'sysop' && !ctx.suppressProtectWarning &&
if (editprot.length > 0 && editprot.attr('level') === 'sysop' && !ctx.suppressProtectWarning &&
!confirm('You are about to undelete the fully create protected page "' + ctx.pageName +
!confirm('You are about to undelete the fully create protected page "' + ctx.pageName +
(editprot.attr('expiry') === 'infinity' ? '" (protected indefinitely)' : ('" (protection expiring ' + editprot.attr('expiry') + ')')) +
(editprot.attr('expiry') === 'infinity' ? '" (protected indefinitely)' : '" (protection expiring ' + new Morebits.date(editprot.attr('expiry')).calendar('utc') + ' (UTC))') +
'. \n\nClick OK to proceed with the undeletion, or Cancel to skip this undeletion.')) {
'. \n\nClick OK to proceed with the undeletion, or Cancel to skip this undeletion.')) {
ctx.statusElement.error("Undeletion of fully create protected page was aborted.");
ctx.statusElement.error('Undeletion of fully create protected page was aborted.');
ctx.onUndeleteFailure(this);
ctx.onUndeleteFailure(this);
return;
return;
}
}


token = $(xml).find('tokens').attr('csrftoken');
// KLUDGE:
if (!token) {
token = mw.user.tokens.get('csrfToken');
ctx.statusElement.error('Failed to retrieve undelete token.');
pageTitle = ctx.pageName;
ctx.onUndeleteFailure(this);
return;
}

pageTitle = $(xml).find('page').attr('title');
}
}


Baris 2.888: Baris 3.497:
'title': pageTitle,
'title': pageTitle,
'token': token,
'token': token,
'reason': ctx.editSummary
'reason': ctx.editSummary,
'watchlist': ctx.watchlistOption
};
};
if (ctx.watchlistOption === 'watch') {
query.watch = 'true';
}


ctx.undeleteProcessApi = new Morebits.wiki.api("undeleting page...", query, ctx.onUndeleteSuccess, ctx.statusElement, fnProcessUndeleteError);
ctx.undeleteProcessApi = new Morebits.wiki.api('undeleting page...', query, ctx.onUndeleteSuccess, ctx.statusElement, fnProcessUndeleteError);
ctx.undeleteProcessApi.setParent(this);
ctx.undeleteProcessApi.setParent(this);
ctx.undeleteProcessApi.post();
ctx.undeleteProcessApi.post();
Baris 2.905: Baris 3.512:


// check for "Database query error"
// check for "Database query error"
if ( errorCode === "internal_api_error_DBQueryError" && ctx.retries++ < ctx.maxRetries ) {
if (errorCode === 'internal_api_error_DBQueryError' && ctx.retries++ < ctx.maxRetries) {
ctx.statusElement.info("Database query error, retrying");
ctx.statusElement.info('Database query error, retrying');
--Morebits.wiki.numberOfActionsLeft; // allow for normal completion if retry succeeds
--Morebits.wiki.numberOfActionsLeft; // allow for normal completion if retry succeeds
ctx.undeleteProcessApi.post(); // give it another go!
ctx.undeleteProcessApi.post(); // give it another go!
} else if ( errorCode === "badtoken" ) {
} else if (errorCode === 'badtoken' && ctx.retries++ < ctx.maxRetries) {
ctx.statusElement.info('Invalid token, retrying');
// this is pathetic, but given the current state of Morebits.wiki.page it would
--Morebits.wiki.numberOfActionsLeft;
// be a dog's breakfast to try and fix this
fnGetToken().then(function(token) {
ctx.statusElement.error("Invalid token. Please refresh the page and try again.");
ctx.undeleteProcessApi.query.token = token;
if (ctx.onUndeleteFailure) {
ctx.undeleteProcessApi.post();
ctx.onUndeleteFailure.call(this, this, ctx.undeleteProcessApi);
}
});
} else if ( errorCode === "cantundelete" ) {
} else if (errorCode === 'cantundelete') {
ctx.statusElement.error("Cannot undelete the page, either because there are no revisions to undelete or because it has already been undeleted");
ctx.statusElement.error('Cannot undelete the page, either because there are no revisions to undelete or because it has already been undeleted');
if (ctx.onUndeleteFailure) {
if (ctx.onUndeleteFailure) {
ctx.onUndeleteFailure.call(this, ctx.undeleteProcessApi); // invoke callback
ctx.onUndeleteFailure.call(this, ctx.undeleteProcessApi); // invoke callback
Baris 2.923: Baris 3.530:
// hard error, give up
// hard error, give up
} else {
} else {
ctx.statusElement.error( "Failed to undelete the page: " + ctx.undeleteProcessApi.getErrorText() );
ctx.statusElement.error('Failed to undelete the page: ' + ctx.undeleteProcessApi.getErrorText());
if (ctx.onUndeleteFailure) {
if (ctx.onUndeleteFailure) {
ctx.onUndeleteFailure.call(this, ctx.undeleteProcessApi); // invoke callback
ctx.onUndeleteFailure.call(this, ctx.undeleteProcessApi); // invoke callback
Baris 2.933: Baris 3.540:
var xml = ctx.protectApi.getXML();
var xml = ctx.protectApi.getXML();


var missing = ($(xml).find('page').attr('missing') === "");
var missing = $(xml).find('page').attr('missing') === '';
if (((ctx.protectEdit || ctx.protectMove) && missing)) {
if ((ctx.protectEdit || ctx.protectMove) && missing) {
ctx.statusElement.error("Cannot protect the page, because it no longer exists");
ctx.statusElement.error('Cannot protect the page, because it no longer exists');
ctx.onProtectFailure(this);
ctx.onProtectFailure(this);
return;
return;
}
}
if (ctx.protectCreate && !missing) {
if (ctx.protectCreate && !missing) {
ctx.statusElement.error("Cannot create protect the page, because it already exists");
ctx.statusElement.error('Cannot create protect the page, because it already exists');
ctx.onProtectFailure(this);
ctx.onProtectFailure(this);
return;
return;
Baris 2.947: Baris 3.554:
// TODO cascading protection not possible on edit<sysop
// TODO cascading protection not possible on edit<sysop


var protectToken = $(xml).find('page').attr('protecttoken');
var token = $(xml).find('tokens').attr('csrftoken');
if (!protectToken) {
if (!token) {
ctx.statusElement.error("Failed to retrieve protect token.");
ctx.statusElement.error('Failed to retrieve protect token.');
ctx.onProtectFailure(this);
ctx.onProtectFailure(this);
return;
return;
}
}

var pageTitle = $(xml).find('page').attr('title');


// fetch existing protection levels
// fetch existing protection levels
Baris 2.967: Baris 3.576:
expirys.push(ctx.protectEdit.expiry);
expirys.push(ctx.protectEdit.expiry);
} else if (editprot.length) {
} else if (editprot.length) {
protections.push('edit=' + editprot.attr("level"));
protections.push('edit=' + editprot.attr('level'));
expirys.push(editprot.attr("expiry").replace("infinity", "indefinite"));
expirys.push(editprot.attr('expiry').replace('infinity', 'indefinite'));
}
}


Baris 2.975: Baris 3.584:
expirys.push(ctx.protectMove.expiry);
expirys.push(ctx.protectMove.expiry);
} else if (moveprot.length) {
} else if (moveprot.length) {
protections.push('move=' + moveprot.attr("level"));
protections.push('move=' + moveprot.attr('level'));
expirys.push(moveprot.attr("expiry").replace("infinity", "indefinite"));
expirys.push(moveprot.attr('expiry').replace('infinity', 'indefinite'));
}
}


Baris 2.983: Baris 3.592:
expirys.push(ctx.protectCreate.expiry);
expirys.push(ctx.protectCreate.expiry);
} else if (createprot.length) {
} else if (createprot.length) {
protections.push('create=' + createprot.attr("level"));
protections.push('create=' + createprot.attr('level'));
expirys.push(createprot.attr("expiry").replace("infinity", "indefinite"));
expirys.push(createprot.attr('expiry').replace('infinity', 'indefinite'));
}
}


var query = {
var query = {
action: 'protect',
action: 'protect',
title: $(xml).find('page').attr('title'),
title: pageTitle,
token: protectToken,
token: token,
protections: protections.join('|'),
protections: protections.join('|'),
expiry: expirys.join('|'),
expiry: expirys.join('|'),
reason: ctx.editSummary
reason: ctx.editSummary,
watchlist: ctx.watchlistOption
};
};
if (ctx.protectCascade) {
if (ctx.protectCascade) {
query.cascade = 'true';
query.cascade = 'true';
}
if (ctx.watchlistOption === 'watch') {
query.watch = 'true';
}
}


ctx.protectProcessApi = new Morebits.wiki.api("protecting page...", query, ctx.onProtectSuccess, ctx.statusElement, ctx.onProtectFailure);
ctx.protectProcessApi = new Morebits.wiki.api('protecting page...', query, ctx.onProtectSuccess, ctx.statusElement, ctx.onProtectFailure);
ctx.protectProcessApi.setParent(this);
ctx.protectProcessApi.setParent(this);
ctx.protectProcessApi.post();
ctx.protectProcessApi.post();
Baris 3.008: Baris 3.615:


var fnProcessStabilize = function() {
var fnProcessStabilize = function() {
var pageTitle, token;
var xml = ctx.stabilizeApi.getXML();


if (fnCanUseMwUserToken('stabilize')) {
var missing = ($(xml).find('page').attr('missing') === "");
token = mw.user.tokens.get('csrfToken');
if (missing) {
pageTitle = ctx.pageName;
ctx.statusElement.error("Cannot protect the page, because it no longer exists");
} else {
ctx.onStabilizeFailure(this);
var xml = ctx.stabilizeApi.getXML();
return;
}


var stabilizeToken = $(xml).find('page').attr('edittoken');
var missing = $(xml).find('page').attr('missing') === '';
if (!stabilizeToken) {
if (missing) {
ctx.statusElement.error("Failed to retrieve stabilize token.");
ctx.statusElement.error('Cannot protect the page, because it no longer exists');
ctx.onStabilizeFailure(this);
ctx.onStabilizeFailure(this);
return;
return;
}

token = $(xml).find('tokens').attr('csrftoken');
if (!token) {
ctx.statusElement.error('Failed to retrieve stabilize token.');
ctx.onStabilizeFailure(this);
return;
}

pageTitle = $(xml).find('page').attr('title');
}
}


var query = {
var query = {
action: 'stabilize',
action: 'stabilize',
title: $(xml).find('page').attr('title'),
title: pageTitle,
token: stabilizeToken,
token: token,
protectlevel: ctx.flaggedRevs.level,
protectlevel: ctx.flaggedRevs.level,
expiry: ctx.flaggedRevs.expiry,
expiry: ctx.flaggedRevs.expiry,
reason: ctx.editSummary
reason: ctx.editSummary
};
};
// [[phab:T247915]]
if (ctx.watchlistOption === 'watch') {
if (ctx.watchlistOption === 'watch') {
query.watch = 'true';
query.watchlist = 'true';
}
}


ctx.stabilizeProcessApi = new Morebits.wiki.api("configuring stabilization settings...", query, ctx.onStabilizeSuccess, ctx.statusElement, ctx.onStabilizeFailure);
ctx.stabilizeProcessApi = new Morebits.wiki.api('configuring stabilization settings...', query, ctx.onStabilizeSuccess, ctx.statusElement, ctx.onStabilizeFailure);
ctx.stabilizeProcessApi.setParent(this);
ctx.stabilizeProcessApi.setParent(this);
ctx.stabilizeProcessApi.post();
ctx.stabilizeProcessApi.post();
Baris 3.063: Baris 3.680:
/**
/**
* @constructor
* @constructor
* @param {HTMLDivElement} previewbox - the <div> element that will contain the rendered HTML
* @param {HTMLElement} previewbox - the element that will contain the rendered HTML,
* usually a <div> element
*/
*/
Morebits.wiki.preview = function(previewbox) {
Morebits.wiki.preview = function(previewbox) {
this.previewbox = previewbox;
this.previewbox = previewbox;
$(previewbox).addClass("morebits-previewbox").hide();
$(previewbox).addClass('morebits-previewbox').hide();


/**
/**
Baris 3.073: Baris 3.691:
* to render the specified wikitext.
* to render the specified wikitext.
* @param {string} wikitext - wikitext to render; most things should work, including subst: and ~~~~
* @param {string} wikitext - wikitext to render; most things should work, including subst: and ~~~~
* @param {string} [pageTitle] - optional parameter for the page this should be rendered as being on
* @param {string} [pageTitle] - optional parameter for the page this should be rendered as being on, if omitted it is taken as the current page
*/
*/
this.beginRender = function(wikitext, pageTitle) {
this.beginRender = function(wikitext, pageTitle) {
Baris 3.089: Baris 3.707:
title: pageTitle || mw.config.get('wgPageName')
title: pageTitle || mw.config.get('wgPageName')
};
};
var renderApi = new Morebits.wiki.api("loading...", query, fnRenderSuccess, new Morebits.status("Preview"));
var renderApi = new Morebits.wiki.api('loading...', query, fnRenderSuccess, new Morebits.status('Preview'));
renderApi.post();
renderApi.post();
};
};
Baris 3.097: Baris 3.715:
var html = $(xml).find('text').text();
var html = $(xml).find('text').text();
if (!html) {
if (!html) {
apiobj.statelem.error("failed to retrieve preview, or template was blanked");
apiobj.statelem.error('failed to retrieve preview, or template was blanked');
return;
return;
}
}
previewbox.innerHTML = html;
previewbox.innerHTML = html;
$(previewbox).find("a").attr("target", "_blank"); // this makes links open in new tab
$(previewbox).find('a').attr('target', '_blank'); // this makes links open in new tab
};
};


/** Hides the preview box and clears it. */
/**
* Hides the preview box and clears it.
*/
this.closePreview = function() {
this.closePreview = function() {
$(previewbox).empty().hide();
$(previewbox).empty().hide();
Baris 3.122: Baris 3.738:


Morebits.wikitext.template = {
Morebits.wikitext.template = {
parse: function( text, start ) {
parse: function(text, start) {
var count = -1;
var count = -1;
var level = -1;
var level = -1;
Baris 3.133: Baris 3.749:
var key, value;
var key, value;


for( var i = start; i < text.length; ++i ) {
for (var i = start; i < text.length; ++i) {
var test3 = text.substr( i, 3 );
var test3 = text.substr(i, 3);
if( test3 === '{{{' ) {
if (test3 === '{{{') {
current += '{{{';
current += '{{{';
i += 2;
i += 2;
Baris 3.141: Baris 3.757:
continue;
continue;
}
}
if( test3 === '}}}' ) {
if (test3 === '}}}') {
current += '}}}';
current += '}}}';
i += 2;
i += 2;
Baris 3.147: Baris 3.763:
continue;
continue;
}
}
var test2 = text.substr( i, 2 );
var test2 = text.substr(i, 2);
if( test2 === '{{' || test2 === '[[' ) {
if (test2 === '{{' || test2 === '[[') {
current += test2;
current += test2;
++i;
++i;
Baris 3.154: Baris 3.770:
continue;
continue;
}
}
if( test2 === ']]' ) {
if (test2 === ']]') {
current += ']]';
current += ']]';
++i;
++i;
Baris 3.160: Baris 3.776:
continue;
continue;
}
}
if( test2 === '}}' ) {
if (test2 === '}}') {
current += test2;
current += test2;
++i;
++i;
--level;
--level;


if( level <= 0 ) {
if (level <= 0) {
if( count === -1 ) {
if (count === -1) {
result.name = current.substring(2).trim();
result.name = current.substring(2).trim();
++count;
++count;
} else {
} else {
if( equals !== -1 ) {
if (equals !== -1) {
key = current.substring( 0, equals ).trim();
key = current.substring(0, equals).trim();
value = current.substring( equals ).trim();
value = current.substring(equals).trim();
result.parameters[key] = value;
result.parameters[key] = value;
equals = -1;
equals = -1;
Baris 3.185: Baris 3.801:
}
}


if( text.charAt(i) === '|' && level <= 0 ) {
if (text.charAt(i) === '|' && level <= 0) {
if( count === -1 ) {
if (count === -1) {
result.name = current.substring(2).trim();
result.name = current.substring(2).trim();
++count;
++count;
} else {
} else {
if( equals !== -1 ) {
if (equals !== -1) {
key = current.substring( 0, equals ).trim();
key = current.substring(0, equals).trim();
value = current.substring( equals + 1 ).trim();
value = current.substring(equals + 1).trim();
result.parameters[key] = value;
result.parameters[key] = value;
equals = -1;
equals = -1;
Baris 3.201: Baris 3.817:
}
}
current = '';
current = '';
} else if( equals === -1 && text.charAt(i) === '=' && level <= 0 ) {
} else if (equals === -1 && text.charAt(i) === '=' && level <= 0) {
equals = current.length;
equals = current.length;
current += text.charAt(i);
current += text.charAt(i);
Baris 3.217: Baris 3.833:
* @param {string} text
* @param {string} text
*/
*/
Morebits.wikitext.page = function mediawikiPage( text ) {
Morebits.wikitext.page = function mediawikiPage(text) {
this.text = text;
this.text = text;
};
};
Baris 3.228: Baris 3.844:
* @param {string} link_target
* @param {string} link_target
*/
*/
removeLink: function( link_target ) {
removeLink: function(link_target) {
var first_char = link_target.substr( 0, 1 );
var first_char = link_target.substr(0, 1);
var link_re_string = "[" + first_char.toUpperCase() + first_char.toLowerCase() + ']' + RegExp.escape( link_target.substr( 1 ), true );
var link_re_string = '[' + first_char.toUpperCase() + first_char.toLowerCase() + ']' + RegExp.escape(link_target.substr(1), true);


// Files and Categories become links with a leading colon.
// Files and Categories become links with a leading colon, e.g. [[:File:Test.png]]
// e.g. [[:File:Test.png]]
// Otherwise, allow for an optional leading colon, e.g. [[:User:Test]]
var special_ns_re = /^(?:[Ff]ile|[Ii]mage|[Cc]ategory):/;
var special_ns_re = /^(?:[Ff]ile|[Ii]mage|[Cc]ategory):/;
var colon = special_ns_re.test( link_target ) ? ':' : '';
var colon = special_ns_re.test(link_target) ? ':' : ':?';


var link_simple_re = new RegExp( "\\[\\[" + colon + "(" + link_re_string + ")\\]\\]", 'g' );
var link_simple_re = new RegExp('\\[\\[' + colon + '(' + link_re_string + ')\\]\\]', 'g');
var link_named_re = new RegExp( "\\[\\[" + colon + link_re_string + "\\|(.+?)\\]\\]", 'g' );
var link_named_re = new RegExp('\\[\\[' + colon + link_re_string + '\\|(.+?)\\]\\]', 'g');
this.text = this.text.replace( link_simple_re, "$1" ).replace( link_named_re, "$1" );
this.text = this.text.replace(link_simple_re, '$1').replace(link_named_re, '$1');
},
},


Baris 3.248: Baris 3.864:
* @param {string} reason - Reason to be included in comment, alongside the commented-out image
* @param {string} reason - Reason to be included in comment, alongside the commented-out image
*/
*/
commentOutImage: function( image, reason ) {
commentOutImage: function(image, reason) {
var unbinder = new Morebits.unbinder( this.text );
var unbinder = new Morebits.unbinder(this.text);
unbinder.unbind( '<!--', '-->' );
unbinder.unbind('<!--', '-->');


reason = reason ? (reason + ': ') : '';
reason = reason ? reason + ': ' : '';
var first_char = image.substr( 0, 1 );
var first_char = image.substr(0, 1);
var image_re_string = "[" + first_char.toUpperCase() + first_char.toLowerCase() + ']' + RegExp.escape( image.substr( 1 ), true );
var image_re_string = '[' + first_char.toUpperCase() + first_char.toLowerCase() + ']' + RegExp.escape(image.substr(1), true);


// Check for normal image links, i.e. [[File:Foobar.png|...]]
// Check for normal image links, i.e. [[File:Foobar.png|...]]
// Will eat the whole link
// Will eat the whole link
var links_re = new RegExp( "\\[\\[(?:[Ii]mage|[Ff]ile):\\s*" + image_re_string );
var links_re = new RegExp('\\[\\[(?:[Ii]mage|[Ff]ile):\\s*' + image_re_string);
var allLinks = Morebits.array.uniq(Morebits.string.splitWeightedByKeys( unbinder.content, '[[', ']]' ));
var allLinks = Morebits.array.uniq(Morebits.string.splitWeightedByKeys(unbinder.content, '[[', ']]'));
for( var i = 0; i < allLinks.length; ++i ) {
for (var i = 0; i < allLinks.length; ++i) {
if( links_re.test( allLinks[i] ) ) {
if (links_re.test(allLinks[i])) {
var replacement = '<!-- ' + reason + allLinks[i] + ' -->';
var replacement = '<!-- ' + reason + allLinks[i] + ' -->';
unbinder.content = unbinder.content.replace( allLinks[i], replacement, 'g' );
unbinder.content = unbinder.content.replace(allLinks[i], replacement, 'g');
}
}
}
}
// unbind the newly created comments
// unbind the newly created comments
unbinder.unbind( '<!--', '-->' );
unbinder.unbind('<!--', '-->');


// Check for gallery images, i.e. instances that must start on a new line,
// Check for gallery images, i.e. instances that must start on a new line,
// eventually preceded with some space, and must include File: prefix
// eventually preceded with some space, and must include File: prefix
// Will eat the whole line.
// Will eat the whole line.
var gallery_image_re = new RegExp( "(^\\s*(?:[Ii]mage|[Ff]ile):\\s*" + image_re_string + ".*?$)", 'mg' );
var gallery_image_re = new RegExp('(^\\s*(?:[Ii]mage|[Ff]ile):\\s*' + image_re_string + '.*?$)', 'mg');
unbinder.content = unbinder.content.replace( gallery_image_re, "<!-- " + reason + "$1 -->" );
unbinder.content = unbinder.content.replace(gallery_image_re, '<!-- ' + reason + '$1 -->');


// unbind the newly created comments
// unbind the newly created comments
unbinder.unbind( '<!--', '-->' );
unbinder.unbind('<!--', '-->');


// Check free image usages, for example as template arguments, might have the File: prefix excluded, but must be preceeded by an |
// Check free image usages, for example as template arguments, might have the File: prefix excluded, but must be preceeded by an |
// Will only eat the image name and the preceeding bar and an eventual named parameter
// Will only eat the image name and the preceeding bar and an eventual named parameter
var free_image_re = new RegExp( "(\\|\\s*(?:[\\w\\s]+\\=)?\\s*(?:(?:[Ii]mage|[Ff]ile):\\s*)?" + image_re_string + ")", 'mg' );
var free_image_re = new RegExp('(\\|\\s*(?:[\\w\\s]+\\=)?\\s*(?:(?:[Ii]mage|[Ff]ile):\\s*)?' + image_re_string + ')', 'mg');
unbinder.content = unbinder.content.replace( free_image_re, "<!-- " + reason + "$1 -->" );
unbinder.content = unbinder.content.replace(free_image_re, '<!-- ' + reason + '$1 -->');
// Rebind the content now, we are done!
// Rebind the content now, we are done!
this.text = unbinder.rebind();
this.text = unbinder.rebind();
Baris 3.291: Baris 3.907:
* @param {string} data
* @param {string} data
*/
*/
addToImageComment: function( image, data ) {
addToImageComment: function(image, data) {
var first_char = image.substr( 0, 1 );
var first_char = image.substr(0, 1);
var first_char_regex = RegExp.escape( first_char, true );
var first_char_regex = RegExp.escape(first_char, true);
if( first_char.toUpperCase() !== first_char.toLowerCase() ) {
if (first_char.toUpperCase() !== first_char.toLowerCase()) {
first_char_regex = '[' + RegExp.escape( first_char.toUpperCase(), true ) + RegExp.escape( first_char.toLowerCase(), true ) + ']';
first_char_regex = '[' + RegExp.escape(first_char.toUpperCase(), true) + RegExp.escape(first_char.toLowerCase(), true) + ']';
}
}
var image_re_string = "(?:[Ii]mage|[Ff]ile):\\s*" + first_char_regex + RegExp.escape( image.substr( 1 ), true );
var image_re_string = '(?:[Ii]mage|[Ff]ile):\\s*' + first_char_regex + RegExp.escape(image.substr(1), true);
var links_re = new RegExp( "\\[\\[" + image_re_string );
var links_re = new RegExp('\\[\\[' + image_re_string);
var allLinks = Morebits.array.uniq(Morebits.string.splitWeightedByKeys( this.text, '[[', ']]' ));
var allLinks = Morebits.array.uniq(Morebits.string.splitWeightedByKeys(this.text, '[[', ']]'));
for( var i = 0; i < allLinks.length; ++i ) {
for (var i = 0; i < allLinks.length; ++i) {
if( links_re.test( allLinks[i] ) ) {
if (links_re.test(allLinks[i])) {
var replacement = allLinks[i];
var replacement = allLinks[i];
// just put it at the end?
// just put it at the end?
replacement = replacement.replace( /\]\]$/, '|' + data + ']]' );
replacement = replacement.replace(/\]\]$/, '|' + data + ']]');
this.text = this.text.replace( allLinks[i], replacement, 'g' );
this.text = this.text.replace(allLinks[i], replacement, 'g');
}
}
}
}
var gallery_re = new RegExp( "^(\\s*" + image_re_string + '.*?)\\|?(.*?)$', 'mg' );
var gallery_re = new RegExp('^(\\s*' + image_re_string + '.*?)\\|?(.*?)$', 'mg');
var newtext = "$1|$2 " + data;
var newtext = '$1|$2 ' + data;
this.text = this.text.replace( gallery_re, newtext );
this.text = this.text.replace(gallery_re, newtext);
},
},


Baris 3.318: Baris 3.934:
* include namespace prefix only if not in template namespace
* include namespace prefix only if not in template namespace
*/
*/
removeTemplate: function( template ) {
removeTemplate: function(template) {
var first_char = template.substr( 0, 1 );
var first_char = template.substr(0, 1);
var template_re_string = "(?:[Tt]emplate:)?\\s*[" + first_char.toUpperCase() + first_char.toLowerCase() + ']' + RegExp.escape( template.substr( 1 ), true );
var template_re_string = '(?:[Tt]emplate:)?\\s*[' + first_char.toUpperCase() + first_char.toLowerCase() + ']' + RegExp.escape(template.substr(1), true);
var links_re = new RegExp( "\\{\\{" + template_re_string );
var links_re = new RegExp('\\{\\{' + template_re_string);
var allTemplates = Morebits.array.uniq(Morebits.string.splitWeightedByKeys( this.text, '{{', '}}', [ '{{{', '}}}' ] ));
var allTemplates = Morebits.array.uniq(Morebits.string.splitWeightedByKeys(this.text, '{{', '}}', [ '{{{', '}}}' ]));
for( var i = 0; i < allTemplates.length; ++i ) {
for (var i = 0; i < allTemplates.length; ++i) {
if( links_re.test( allTemplates[i] ) ) {
if (links_re.test(allTemplates[i])) {
this.text = this.text.replace( allTemplates[i], '', 'g' );
this.text = this.text.replace(allTemplates[i], '', 'g');
}
}
}
}
},
},


/** @returns {string} */
getText: function() {
getText: function() {
return this.text;
return this.text;
}
}
};
};




/**
/**
* **************** Morebits.queryString ****************
* *********** Morebits.userspaceLogger ************
* Handles logging actions to a userspace log, used in
* Maps the querystring to an JS object
* twinklespeedy and twinkleprod.
*
* In static context, the value of location.search.substring(1), else the value given
* to the constructor is going to be used. The mapped hash is saved in the object.
*
* Example:
*
* var value = Morebits.queryString.get('key');
* var obj = new Morebits.queryString('foo=bar&baz=quux');
* value = obj.get('foo');
*/
*/


Morebits.userspaceLogger = function(logPageName) {
/**
if (!logPageName) {
* @constructor
throw new Error('no log page name specified');
* @param {string} qString The query string
*/
Morebits.queryString = function QueryString(qString) {
this.string = qString;
this.params = {};

if( !qString.length ) {
return;
}
}
this.initialText = '';
this.headerLevel = 3;


this.log = function(logText, summaryText) {
qString.replace(/\+/, ' ');
if (!logText) {
var args = qString.split('&');
return;

for( var i = 0; i < args.length; ++i ) {
var pair = args[i].split( '=' );
var key = decodeURIComponent( pair[0] ), value = key;

if( pair.length === 2 ) {
value = decodeURIComponent( pair[1] );
}
}
var page = new Morebits.wiki.page('User:' + mw.config.get('wgUserName') + '/' + logPageName,
'Adding entry to userspace log'); // make this '... to ' + logPageName ?
return page.load(function(pageobj) {
// add blurb if log page doesn't exist or is blank
var text = pageobj.getPageText() || this.initialText;


// create monthly header if it doesn't exist already
this.params[key] = value;
var date = new Morebits.date(pageobj.getLoadTime());
}
if (!date.monthHeaderRegex().exec(text)) {
};
text += '\n\n' + date.monthHeader(this.headerLevel);

Morebits.queryString.staticstr = null;

Morebits.queryString.staticInit = function() {
if( !Morebits.queryString.staticstr ) {
Morebits.queryString.staticstr = new Morebits.queryString(location.search.substring(1));
}
};

Morebits.queryString.get = function(key) {
Morebits.queryString.staticInit();
return Morebits.queryString.staticstr.get(key);
};

Morebits.queryString.exists = function(key) {
Morebits.queryString.staticInit();
return Morebits.queryString.staticstr.exists(key);
};

Morebits.queryString.equals = function(key, value) {
Morebits.queryString.staticInit();
return Morebits.queryString.staticstr.equals(key, value);
};

Morebits.queryString.toString = function() {
Morebits.queryString.staticInit();
return Morebits.queryString.staticstr.toString();
};

Morebits.queryString.create = function( arr ) {
var resarr = [];
var editToken; // KLUGE: this should always be the last item in the query string (bug TW-B-0013)
for( var i in arr ) {
if( arr[i] === undefined ) {
continue;
}
var res;
if( Array.isArray( arr[i] ) ){
var v = [];
for(var j = 0; j < arr[i].length; ++j ) {
v[j] = encodeURIComponent( arr[i][j] );
}
}
res = v.join('|');
} else {
res = encodeURIComponent( arr[i] );
}
if( i === 'token' ) {
editToken = res;
} else {
resarr.push( encodeURIComponent( i ) + '=' + res );
}
}
if( editToken !== undefined ) {
resarr.push( 'token=' + editToken );
}
return resarr.join('&');
};


pageobj.setPageText(text + '\n' + logText);
/**
pageobj.setEditSummary(summaryText);
* @returns {string} the value associated to the given `key`
pageobj.setCreateOption('recreate');
* @param {string} key
pageobj.save();
*/
}.bind(this));
Morebits.queryString.prototype.get = function(key) {
};
return this.params[key] || null;
};
};


/**
/**
* **************** Morebits.status ****************
* @returns {boolean} true if the given `key` is set
* @param {string} key
*/
*/
Morebits.queryString.prototype.exists = function(key) {
return !!this.params[key];
};


/**
/**
* @constructor
* @returns {boolean} true if the value associated with given `key` equals given `value`
* Morebits.status.init() must be called before any status object is created, otherwise
* @param {string} key
* those statuses won't be visible.
* @param {string} value
* @param {String} text - Text before the the colon `:`
*/
* @param {String} stat - Text after the colon `:`
Morebits.queryString.prototype.equals = function(key, value) {
* @param {String} [type=status] - This parameter determines the font color of the status line,
return this.params[key] === value;
* this can be 'status' (blue), 'info' (green), 'warn' (red), or 'error' (bold red)
};
* The default is 'status'

/**
* @returns {string}
*/
Morebits.queryString.prototype.toString = function() {
return this.string || null;
};

/**
* Creates a querystring and encodes strings via `encodeURIComponent` and joins arrays with `|`
* @param {Array} arr
* @returns {string}
*/
Morebits.queryString.prototype.create = Morebits.queryString.create;



/**
* **************** Morebits.status ****************
*/
*/


Morebits.status = function Status( text, stat, type ) {
Morebits.status = function Status(text, stat, type) {
this.textRaw = text;
this.textRaw = text;
this.text = this.codify(text);
this.text = this.codify(text);
this.type = type || 'status';
this.type = type || 'status';
this.generate();
this.generate();
if( stat ) {
if (stat) {
this.update( stat, type );
this.update(stat, type);
}
}
};
};


/**
Morebits.status.init = function( root ) {
* Specify an area for status message elements to be added to
if( !( root instanceof Element ) ) {
* @param {HTMLElement} root - usually a div element
throw new Error( 'object not an instance of Element' );
*/
Morebits.status.init = function(root) {
if (!(root instanceof Element)) {
throw new Error('object not an instance of Element');
}
}
while( root.hasChildNodes() ) {
while (root.hasChildNodes()) {
root.removeChild( root.firstChild );
root.removeChild(root.firstChild);
}
}
Morebits.status.root = root;
Morebits.status.root = root;
Baris 3.503: Baris 4.031:
Morebits.status.root = null;
Morebits.status.root = null;


/** @param {Function} handler - function to execute on error */
Morebits.status.onError = function( handler ) {
if ( typeof handler === 'function' ) {
Morebits.status.onError = function(handler) {
if (typeof handler === 'function') {
Morebits.status.errorEvent = handler;
Morebits.status.errorEvent = handler;
} else {
} else {
throw "Morebits.status.onError: handler is not a function";
throw 'Morebits.status.onError: handler is not a function';
}
}
};
};
Baris 3.519: Baris 4.048:
node: null,
node: null,
linked: false,
linked: false,

/** Add the status element node to the DOM */
link: function() {
link: function() {
if( ! this.linked && Morebits.status.root ) {
if (!this.linked && Morebits.status.root) {
Morebits.status.root.appendChild( this.node );
Morebits.status.root.appendChild(this.node);
this.linked = true;
this.linked = true;
}
}
},
},

/** Remove the status element node from the DOM */
unlink: function() {
unlink: function() {
if( this.linked ) {
if (this.linked) {
Morebits.status.root.removeChild( this.node );
Morebits.status.root.removeChild(this.node);
this.linked = false;
this.linked = false;
}
}
},
},

codify: function( obj ) {
/**
if ( ! Array.isArray( obj ) ) {
* Create a document fragment with the status text
* @param {(string|Element|Array)} obj
* @returns {DocumentFragment}
*/
codify: function(obj) {
if (!Array.isArray(obj)) {
obj = [ obj ];
obj = [ obj ];
}
}
var result;
var result;
result = document.createDocumentFragment();
result = document.createDocumentFragment();
for( var i = 0; i < obj.length; ++i ) {
for (var i = 0; i < obj.length; ++i) {
if( typeof obj[i] === 'string' ) {
if (typeof obj[i] === 'string') {
result.appendChild( document.createTextNode( obj[i] ) );
result.appendChild(document.createTextNode(obj[i]));
} else if( obj[i] instanceof Element ) {
} else if (obj[i] instanceof Element) {
result.appendChild( obj[i] );
result.appendChild(obj[i]);
} // Else cosmic radiation made something shit
} // Else cosmic radiation made something shit
}
}
Baris 3.547: Baris 4.086:


},
},

update: function( status, type ) {
/**
this.stat = this.codify( status );
* Update the status
if( type ) {
* @param {String} status - Part of status message after colon `:`
* @param {String} type - 'status' (blue), 'info' (green), 'warn' (red), or 'error' (bold red)
*/
update: function(status, type) {
this.stat = this.codify(status);
if (type) {
this.type = type;
this.type = type;
if (type === 'error') {
if (type === 'error') {
Baris 3.561: Baris 4.106:


// also log error messages in the browser console
// also log error messages in the browser console
console.error(this.textRaw + ": " + status); // eslint-disable-line no-console
console.error(this.textRaw + ': ' + status); // eslint-disable-line no-console
}
}
}
}
this.render();
this.render();
},
},

/** Produce the html for first part of the status message */
generate: function() {
generate: function() {
this.node = document.createElement( 'div' );
this.node = document.createElement('div');
this.node.appendChild( document.createElement('span') ).appendChild( this.text );
this.node.appendChild(document.createElement('span')).appendChild(this.text);
this.node.appendChild( document.createElement('span') ).appendChild( document.createTextNode( ': ' ) );
this.node.appendChild(document.createElement('span')).appendChild(document.createTextNode(': '));
this.target = this.node.appendChild( document.createElement( 'span' ) );
this.target = this.node.appendChild(document.createElement('span'));
this.target.appendChild( document.createTextNode( '' ) ); // dummy node
this.target.appendChild(document.createTextNode('')); // dummy node
},
},

/** Complete the html, for the second part of the status message */
render: function() {
render: function() {
this.node.className = 'tw_status_' + this.type;
this.node.className = 'morebits_status_' + this.type;
while( this.target.hasChildNodes() ) {
while (this.target.hasChildNodes()) {
this.target.removeChild( this.target.firstChild );
this.target.removeChild(this.target.firstChild);
}
}
this.target.appendChild( this.stat );
this.target.appendChild(this.stat);
this.link();
this.link();
},
},
status: function( status ) {
status: function(status) {
this.update( status, 'status');
this.update(status, 'status');
},
},
info: function( status ) {
info: function(status) {
this.update( status, 'info');
this.update(status, 'info');
},
},
warn: function( status ) {
warn: function(status) {
this.update( status, 'warn');
this.update(status, 'warn');
},
},
error: function( status ) {
error: function(status) {
this.update( status, 'error');
this.update(status, 'error');
}
}
};
};


Morebits.status.info = function( text, status ) {
Morebits.status.info = function(text, status) {
return new Morebits.status( text, status, 'info' );
return new Morebits.status(text, status, 'info');
};
};


Morebits.status.warn = function( text, status ) {
Morebits.status.warn = function(text, status) {
return new Morebits.status( text, status, 'warn' );
return new Morebits.status(text, status, 'warn');
};
};


Morebits.status.error = function( text, status ) {
Morebits.status.error = function(text, status) {
return new Morebits.status( text, status, 'error' );
return new Morebits.status(text, status, 'error');
};

/**
* For the action complete message at the end, create a status line without
* a colon separator.
* @param {String} text
*/
Morebits.status.actionCompleted = function(text) {
var node = document.createElement('div');
node.appendChild(document.createElement('span')).appendChild(document.createTextNode(text));
node.className = 'morebits_status_info';
if (Morebits.status.root) {
Morebits.status.root.appendChild(node);
}
};
};


/**
/**
* Display the user's rationale, comments, etc. back to them after a failure,
* Display the user's rationale, comments, etc. back to them after a failure,
* so they don't use it
* so that they may re-use it
* @param {string} comments
* @param {string} message
*/
*/
Morebits.status.printUserText = function( comments, message ) {
Morebits.status.printUserText = function(comments, message) {
var p = document.createElement( 'p' );
var p = document.createElement('p');
p.textContent = message;
p.innerHTML = message;
var div = document.createElement( 'div' );
var div = document.createElement('div');
div.className = 'toccolours';
div.className = 'toccolours';
div.style.marginTop = '0';
div.style.marginTop = '0';
div.style.whiteSpace = 'pre-wrap';
div.style.whiteSpace = 'pre-wrap';
div.textContent = comments;
div.textContent = comments;
p.appendChild( div );
p.appendChild(div);
Morebits.status.root.appendChild( p );
Morebits.status.root.appendChild(p);
};
};


Baris 3.628: Baris 4.193:
* **************** Morebits.htmlNode() ****************
* **************** Morebits.htmlNode() ****************
* Simple helper function to create a simple node
* Simple helper function to create a simple node
* @param {string} type - type of HTML element
* @param {string} text - text content
* @param {string} [color] - font color
* @returns {HTMLElement}
*/
*/
Morebits.htmlNode = function (type, content, color) {

var node = document.createElement(type);
Morebits.htmlNode = function ( type, content, color ) {
if (color) {
var node = document.createElement( type );
if( color ) {
node.style.color = color;
node.style.color = color;
}
}
node.appendChild( document.createTextNode( content ) );
node.appendChild(document.createTextNode(content));
return node;
return node;
};
};
Baris 3.642: Baris 4.210:


/**
/**
* **************** Morebits.checkboxClickHandler() ****************
* **************** Morebits.checkboxShiftClickSupport() ****************
* shift-click-support for checkboxes
* shift-click-support for checkboxes
* wikibits version (window.addCheckboxClickHandlers) has some restrictions, and
* wikibits version (window.addCheckboxClickHandlers) has some restrictions, and
* doesn't work with checkboxes inside a sortable table, so let's build our own.
* doesn't work with checkboxes inside a sortable table, so let's build our own.
*/
*/

Morebits.checkboxShiftClickSupport = function (jQuerySelector, jQueryContext) {
Morebits.checkboxShiftClickSupport = function (jQuerySelector, jQueryContext) {
var lastCheckbox = null;
var lastCheckbox = null;
Baris 3.654: Baris 4.221:
var thisCb = this;
var thisCb = this;
if (event.shiftKey && lastCheckbox !== null) {
if (event.shiftKey && lastCheckbox !== null) {
var cbs = $(jQuerySelector, jQueryContext); //can't cache them, obviously, if we want to support resorting
var cbs = $(jQuerySelector, jQueryContext); // can't cache them, obviously, if we want to support resorting
var index = -1, lastIndex = -1, i;
var index = -1, lastIndex = -1, i;
for (i = 0; i < cbs.length; i++) {
for (i = 0; i < cbs.length; i++) {
if (cbs[i] === thisCb) {
if (cbs[i] === thisCb) {
index = i;
index = i;
if (lastIndex > -1)
if (lastIndex > -1) {
break;
break;
}
}
}
if (cbs[i] === lastCheckbox) {
if (cbs[i] === lastCheckbox) {
lastIndex = i;
lastIndex = i;
if (index > -1)
if (index > -1) {
break;
break;
}
}
}
}
}


if (index > -1 && lastIndex > -1) {
if (index > -1 && lastIndex > -1) {
//inspired by wikibits
// inspired by wikibits
var endState = thisCb.checked;
var endState = thisCb.checked;
var start, finish;
var start, finish;
Baris 3.682: Baris 4.251:


for (i = start; i <= finish; i++) {
for (i = start; i <= finish; i++) {
cbs[i].checked = endState;
if (cbs[i].checked !== endState) {
cbs[i].click();
}
}
}
}
}
Baris 3.696: Baris 4.267:


/** **************** Morebits.batchOperation ****************
/** **************** Morebits.batchOperation ****************
* Iterates over a group of pages and executes a worker function for each.
* Iterates over a group of pages (or arbitrary objects) and executes a worker function
* for each.
*
*
* Constructor: Morebits.batchOperation(currentAction)
* Constructor: Morebits.batchOperation(currentAction)
Baris 3.705: Baris 4.277:
* setOption(optionName, optionValue): Sets a known option:
* setOption(optionName, optionValue): Sets a known option:
* - chunkSize (integer): the size of chunks to break the array into (default 50).
* - chunkSize (integer): the size of chunks to break the array into (default 50).
* Setting this to a small value (<5) can cause problems.
* Setting this to a small value (<5) can cause problems.
* - preserveIndividualStatusLines (boolean): keep each page's status element visible
* - preserveIndividualStatusLines (boolean): keep each page's status element visible
* when worker is complete? See note below
* when worker is complete? See note below
*
*
* run(worker): Runs the given callback for each page in the list.
* run(worker, postFinish): Runs the callback `worker` for each page in the list.
* The callback must call workerSuccess when succeeding, or workerFailure
* The callback must call workerSuccess when succeeding, or workerFailure
* when failing. If using Morebits.wiki.api or Morebits.wiki.page, this is easily
* when failing. If using Morebits.wiki.api or Morebits.wiki.page, this is easily
Baris 3.718: Baris 4.290:
* chunk! Also ensure that either workerSuccess or workerFailure is called no more
* chunk! Also ensure that either workerSuccess or workerFailure is called no more
* than once.
* than once.
* The second callback `postFinish` is executed when the entire batch has been processed.
*
*
* If using preserveIndividualStatusLines, you should try to ensure that the
* If using preserveIndividualStatusLines, you should try to ensure that the
Baris 3.742: Baris 4.315:


// internal counters, etc.
// internal counters, etc.
statusElement: new Morebits.status(currentAction || "Performing batch operation"),
statusElement: new Morebits.status(currentAction || 'Performing batch operation'),
worker: null,
worker: null, // function that executes for each item in pageList
postFinish: null, // function that executes when the whole batch has been processed
countStarted: 0,
countStarted: 0,
countFinished: 0,
countFinished: 0,
Baris 3.759: Baris 4.333:
/**
/**
* Sets the list of pages to work on
* Sets the list of pages to work on
* @param {String[]} pageList Array of page names (strings)
* @param {Array} pageList Array of objects over which you wish to execute the worker function
* This is usually the list of page names (strings).
*/
*/
this.setPageList = function(pageList) {
this.setPageList = function(pageList) {
Baris 3.768: Baris 4.343:
* Sets a known option:
* Sets a known option:
* - chunkSize (integer):
* - chunkSize (integer):
* The size of chunks to break the array into (default 50).
* The size of chunks to break the array into (default 50).
* Setting this to a small value (<5) can cause problems.
* Setting this to a small value (<5) can cause problems.
* - preserveIndividualStatusLines (boolean):
* - preserveIndividualStatusLines (boolean):
* Keep each page's status element visible when worker is complete?
* Keep each page's status element visible when worker is complete?
*/
*/
this.setOption = function(optionName, optionValue) {
this.setOption = function(optionName, optionValue) {
Baris 3.778: Baris 4.353:


/**
/**
* Runs the given callback for each page in the list.
* Runs the first callback for each page in the list.
* The callback must call workerSuccess when succeeding, or workerFailure when failing.
* The callback must call workerSuccess when succeeding, or workerFailure when failing.
* Runs the second callback when the whole batch has been processed (optional)
* @param {Function} worker
* @param {Function} worker
* @param {Function} [postFinish]
*/
*/
this.run = function(worker) {
this.run = function(worker, postFinish) {
if (ctx.running) {
if (ctx.running) {
ctx.statusElement.error("Batch operation is already running");
ctx.statusElement.error('Batch operation is already running');
return;
return;
}
}
Baris 3.790: Baris 4.367:


ctx.worker = worker;
ctx.worker = worker;
ctx.postFinish = postFinish;
ctx.countStarted = 0;
ctx.countStarted = 0;
ctx.countFinished = 0;
ctx.countFinished = 0;
Baris 3.798: Baris 4.376:
var total = ctx.pageList.length;
var total = ctx.pageList.length;
if (!total) {
if (!total) {
ctx.statusElement.info("nothing to do");
ctx.statusElement.info('no pages specified');
ctx.running = false;
ctx.running = false;
if (ctx.postFinish) {
ctx.postFinish();
}
return;
return;
}
}
Baris 3.808: Baris 4.389:
// start the process
// start the process
Morebits.wiki.addCheckpoint();
Morebits.wiki.addCheckpoint();
ctx.statusElement.status("0%");
ctx.statusElement.status('0%');
fnStartNewChunk();
fnStartNewChunk();
};
};


/**
this.workerSuccess = function(apiobj) {
* To be called by worker before it terminates succesfully
// update or remove status line
* @param {(Morebits.wiki.page|Morebits.wiki.api|string)} arg
if (apiobj && apiobj.getStatusElement) {
* This should be the `Morebits.wiki.page` or `Morebits.wiki.api` object used by worker
var statelem = apiobj.getStatusElement();
* (for the adjustment of status lines emitted by them).
* If no Morebits.wiki.* object is used (eg. you're using mw.Api() or something else), and
* `preserveIndividualStatusLines` option is on, give the page name (string) as argument.
*/
this.workerSuccess = function(arg) {

var createPageLink = function(pageName) {
var link = document.createElement('a');
link.setAttribute('href', mw.util.getUrl(pageName));
link.appendChild(document.createTextNode(pageName));
return link;
};

if (arg instanceof Morebits.wiki.api || arg instanceof Morebits.wiki.page) {
// update or remove status line
var statelem = arg.getStatusElement();
if (ctx.options.preserveIndividualStatusLines) {
if (ctx.options.preserveIndividualStatusLines) {
if (apiobj.getPageName || apiobj.pageName || (apiobj.query && apiobj.query.title)) {
if (arg.getPageName || arg.pageName || (arg.query && arg.query.title)) {
// we know the page title - display a relevant message
// we know the page title - display a relevant message
var pageName = apiobj.getPageName ? apiobj.getPageName() :
var pageName = arg.getPageName ? arg.getPageName() : arg.pageName || arg.query.title;
statelem.info(['completed (', createPageLink(pageName), ')']);
(apiobj.pageName || apiobj.query.title);
var link = document.createElement('a');
link.setAttribute('href', mw.util.getUrl(pageName));
link.appendChild(document.createTextNode(pageName));
statelem.info(['completed (', link, ')']);
} else {
} else {
// we don't know the page title - just display a generic message
// we don't know the page title - just display a generic message
Baris 3.830: Baris 4.423:
}
}
} else {
} else {
// remove the status line from display
// remove the status line automatically produced by Morebits.wiki.*
statelem.unlink();
statelem.unlink();
}
}

} else if (typeof arg === 'string' && ctx.options.preserveIndividualStatusLines) {
new Morebits.status(arg, ['done (', createPageLink(arg), ')']);
}
}


ctx.countFinishedSuccess++;
ctx.countFinishedSuccess++;
fnDoneOne(apiobj);
fnDoneOne();
};
};


this.workerFailure = function(apiobj) {
this.workerFailure = function() {
fnDoneOne(apiobj);
fnDoneOne();
};
};


Baris 3.866: Baris 4.462:
var total = ctx.pageList.length;
var total = ctx.pageList.length;
if (ctx.countFinished === total) {
if (ctx.countFinished === total) {
var statusString = "Done (" + ctx.countFinishedSuccess +
var statusString = 'Done (' + ctx.countFinishedSuccess +
"/" + ctx.countFinished + " actions completed successfully)";
'/' + ctx.countFinished + ' actions completed successfully)';
if (ctx.countFinishedSuccess < ctx.countFinished) {
if (ctx.countFinishedSuccess < ctx.countFinished) {
ctx.statusElement.warn(statusString);
ctx.statusElement.warn(statusString);
} else {
} else {
ctx.statusElement.info(statusString);
ctx.statusElement.info(statusString);
}
if (ctx.postFinish) {
ctx.postFinish();
}
}
Morebits.wiki.removeCheckpoint();
Morebits.wiki.removeCheckpoint();
Baris 3.880: Baris 4.479:
// just for giggles! (well, serious debugging, actually)
// just for giggles! (well, serious debugging, actually)
if (ctx.countFinished > total) {
if (ctx.countFinished > total) {
ctx.statusElement.warn("Done (overshot by " + (ctx.countFinished - total) + ")");
ctx.statusElement.warn('Done (overshot by ' + (ctx.countFinished - total) + ')');
Morebits.wiki.removeCheckpoint();
Morebits.wiki.removeCheckpoint();
ctx.running = false;
ctx.running = false;
Baris 3.886: Baris 4.485:
}
}


ctx.statusElement.status(parseInt(100 * ctx.countFinished / total, 10) + "%");
ctx.statusElement.status(parseInt(100 * ctx.countFinished / total, 10) + '%');


// start a new chunk if we're close enough to the end of the previous chunk, and
// start a new chunk if we're close enough to the end of the previous chunk, and
Baris 3.903: Baris 4.502:
* A simple draggable window
* A simple draggable window
* now a wrapper for jQuery UI's dialog feature
* now a wrapper for jQuery UI's dialog feature
* @requires {jquery.ui.dialog}
*/
*/


Baris 3.910: Baris 4.510:
* @param {number} height The maximum allowable height for the content area.
* @param {number} height The maximum allowable height for the content area.
*/
*/
Morebits.simpleWindow = function SimpleWindow( width, height ) {
Morebits.simpleWindow = function SimpleWindow(width, height) {
var content = document.createElement( 'div' );
var content = document.createElement('div');
this.content = content;
this.content = content;
content.className = 'morebits-dialog-content';
content.className = 'morebits-dialog-content';
Baris 3.920: Baris 4.520:
$(this.content).dialog({
$(this.content).dialog({
autoOpen: false,
autoOpen: false,
buttons: { "Placeholder button": function() {} },
buttons: { 'Placeholder button': function() {} },
dialogClass: 'morebits-dialog',
dialogClass: 'morebits-dialog',
width: Math.min(parseInt(window.innerWidth, 10), parseInt(width ? width : 800, 10)),
width: Math.min(parseInt(window.innerWidth, 10), parseInt(width ? width : 800, 10)),
Baris 3.930: Baris 4.530:
close: function(event) {
close: function(event) {
// dialogs and their content can be destroyed once closed
// dialogs and their content can be destroyed once closed
$(event.target).dialog("destroy").remove();
$(event.target).dialog('destroy').remove();
},
},
resizeStart: function() {
resizeStart: function() {
this.scrollbox = $(this).find(".morebits-scrollbox")[0];
this.scrollbox = $(this).find('.morebits-scrollbox')[0];
if (this.scrollbox) {
if (this.scrollbox) {
this.scrollbox.style.maxHeight = "none";
this.scrollbox.style.maxHeight = 'none';
}
}
},
},
Baris 3.942: Baris 4.542:
},
},
resize: function() {
resize: function() {
this.style.maxHeight = "";
this.style.maxHeight = '';
if (this.scrollbox) {
if (this.scrollbox) {
this.scrollbox.style.width = "";
this.scrollbox.style.width = '';
}
}
}
}
});
});


var $widget = $(this.content).dialog("widget");
var $widget = $(this.content).dialog('widget');

// add background gradient to titlebar
var $titlebar = $widget.find(".ui-dialog-titlebar");
var oldstyle = $titlebar.attr("style");
$titlebar.attr("style", (oldstyle ? oldstyle : "") + '; background-image: url(data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAkCAMAAAB%2FqqA%2BAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAAEhQTFRFr73ZobTPusjdsMHZp7nVwtDhzNbnwM3fu8jdq7vUt8nbxtDkw9DhpbfSvMrfssPZqLvVztbno7bRrr7W1d%2Fs1N7qydXk0NjpkW7Q%2BgAAADVJREFUeNoMwgESQCAAAMGLkEIi%2FP%2BnbnbpdB59app5Vdg0sXAoMZCpGoFbK6ciuy6FX4ABAEyoAef0BXOXAAAAAElFTkSuQmCC) !important;');


// delete the placeholder button (it's only there so the buttonpane gets created)
// delete the placeholder button (it's only there so the buttonpane gets created)
$widget.find("button").each(function(key, value) {
$widget.find('button').each(function(key, value) {
value.parentNode.removeChild(value);
value.parentNode.removeChild(value);
});
});


// add container for the buttons we add, and the footer links (if any)
// add container for the buttons we add, and the footer links (if any)
var buttonspan = document.createElement("span");
var buttonspan = document.createElement('span');
buttonspan.className = "morebits-dialog-buttons";
buttonspan.className = 'morebits-dialog-buttons';
var linksspan = document.createElement("span");
var linksspan = document.createElement('span');
linksspan.className = "morebits-dialog-footerlinks";
linksspan.className = 'morebits-dialog-footerlinks';
$widget.find(".ui-dialog-buttonpane").append(buttonspan, linksspan);
$widget.find('.ui-dialog-buttonpane').append(buttonspan, linksspan);


// resize the scrollbox with the dialog, if one is present
// resize the scrollbox with the dialog, if one is present
$widget.resizable("option", "alsoResize", "#" + this.content.id + " .morebits-scrollbox, #" + this.content.id);
$widget.resizable('option', 'alsoResize', '#' + this.content.id + ' .morebits-scrollbox, #' + this.content.id);
};
};


Baris 3.983: Baris 4.578:
*/
*/
focus: function() {
focus: function() {
$(this.content).dialog("moveToTop");
$(this.content).dialog('moveToTop');
return this;
return this;
},
},
Baris 3.996: Baris 4.591:
event.preventDefault();
event.preventDefault();
}
}
$(this.content).dialog("close");
$(this.content).dialog('close');
return this;
return this;
},
},
Baris 4.007: Baris 4.602:
display: function() {
display: function() {
if (this.scriptName) {
if (this.scriptName) {
var $widget = $(this.content).dialog("widget");
var $widget = $(this.content).dialog('widget');
$widget.find(".morebits-dialog-scriptname").remove();
$widget.find('.morebits-dialog-scriptname').remove();
var scriptnamespan = document.createElement("span");
var scriptnamespan = document.createElement('span');
scriptnamespan.className = "morebits-dialog-scriptname";
scriptnamespan.className = 'morebits-dialog-scriptname';
scriptnamespan.textContent = this.scriptName + " \u00B7 "; // U+00B7 MIDDLE DOT = &middot;
scriptnamespan.textContent = this.scriptName + ' \u00B7 '; // U+00B7 MIDDLE DOT = &middot;
$widget.find(".ui-dialog-title").prepend(scriptnamespan);
$widget.find('.ui-dialog-title').prepend(scriptnamespan);
}
}


var dialog = $(this.content).dialog("open");
var dialog = $(this.content).dialog('open');
if (window.setupTooltips && window.pg && window.pg.re && window.pg.re.diff) { // tie in with NAVPOP
if (window.setupTooltips && window.pg && window.pg.re && window.pg.re.diff) { // tie in with NAVPOP
dialog.parent()[0].ranSetupTooltipsAlready = false;
dialog.parent()[0].ranSetupTooltipsAlready = false;
window.setupTooltips(dialog.parent()[0]);
window.setupTooltips(dialog.parent()[0]);
}
}
this.setHeight( this.height ); // init height algorithm
this.setHeight(this.height); // init height algorithm
return this;
return this;
},
},
Baris 4.029: Baris 4.624:
* @returns {Morebits.simpleWindow}
* @returns {Morebits.simpleWindow}
*/
*/
setTitle: function( title ) {
setTitle: function(title) {
$(this.content).dialog("option", "title", title);
$(this.content).dialog('option', 'title', title);
return this;
return this;
},
},
Baris 4.040: Baris 4.635:
* @returns {Morebits.simpleWindow}
* @returns {Morebits.simpleWindow}
*/
*/
setScriptName: function( name ) {
setScriptName: function(name) {
this.scriptName = name;
this.scriptName = name;
return this;
return this;
Baris 4.050: Baris 4.645:
* @returns {Morebits.simpleWindow}
* @returns {Morebits.simpleWindow}
*/
*/
setWidth: function( width ) {
setWidth: function(width) {
$(this.content).dialog("option", "width", width);
$(this.content).dialog('option', 'width', width);
return this;
return this;
},
},
Baris 4.061: Baris 4.656:
* @returns {Morebits.simpleWindow}
* @returns {Morebits.simpleWindow}
*/
*/
setHeight: function( height ) {
setHeight: function(height) {
this.height = height;
this.height = height;


Baris 4.069: Baris 4.664:
// chrome has in height in addition to the height of an equivalent "classic"
// chrome has in height in addition to the height of an equivalent "classic"
// Morebits.simpleWindow
// Morebits.simpleWindow
if (parseInt(getComputedStyle($(this.content).dialog("widget")[0], null).height, 10) > window.innerHeight) {
if (parseInt(getComputedStyle($(this.content).dialog('widget')[0], null).height, 10) > window.innerHeight) {
$(this.content).dialog("option", "height", window.innerHeight - 2).dialog("option", "position", "top");
$(this.content).dialog('option', 'height', window.innerHeight - 2).dialog('option', 'position', 'top');
} else {
} else {
$(this.content).dialog("option", "height", "auto");
$(this.content).dialog('option', 'height', 'auto');
}
}
$(this.content).dialog("widget").find(".morebits-dialog-content")[0].style.maxHeight = parseInt(this.height - 30, 10) + "px";
$(this.content).dialog('widget').find('.morebits-dialog-content')[0].style.maxHeight = parseInt(this.height - 30, 10) + 'px';
return this;
return this;
},
},
Baris 4.086: Baris 4.681:
* @returns {Morebits.simpleWindow}
* @returns {Morebits.simpleWindow}
*/
*/
setContent: function( content ) {
setContent: function(content) {
this.purgeContent();
this.purgeContent();
this.addContent( content );
this.addContent(content);
return this;
return this;
},
},
Baris 4.097: Baris 4.692:
* @returns {Morebits.simpleWindow}
* @returns {Morebits.simpleWindow}
*/
*/
addContent: function( content ) {
addContent: function(content) {
this.content.appendChild( content );
this.content.appendChild(content);


// look for submit buttons in the content, hide them, and add a proxy button to the button pane
// look for submit buttons in the content, hide them, and add a proxy button to the button pane
var thisproxy = this;
var thisproxy = this;
$(this.content).find('input[type="submit"], button[type="submit"]').each(function(key, value) {
$(this.content).find('input[type="submit"], button[type="submit"]').each(function(key, value) {
value.style.display = "none";
value.style.display = 'none';
var button = document.createElement("button");
var button = document.createElement('button');
button.textContent = (value.hasAttribute("value") ? value.getAttribute("value") : (value.textContent ? value.textContent : "Submit Query"));
button.textContent = value.hasAttribute('value') ? value.getAttribute('value') : value.textContent ? value.textContent : 'Submit Query';
button.className = value.className || 'submitButtonProxy';
// here is an instance of cheap coding, probably a memory-usage hit in using a closure here
// here is an instance of cheap coding, probably a memory-usage hit in using a closure here
button.addEventListener("click", function() { value.click(); }, false);
button.addEventListener('click', function() {
value.click();
}, false);
thisproxy.buttons.push(button);
thisproxy.buttons.push(button);
});
});
// remove all buttons from the button pane and re-add them
// remove all buttons from the button pane and re-add them
if (this.buttons.length > 0) {
if (this.buttons.length > 0) {
$(this.content).dialog("widget").find(".morebits-dialog-buttons").empty().append(this.buttons)[0].removeAttribute("data-empty");
$(this.content).dialog('widget').find('.morebits-dialog-buttons').empty().append(this.buttons)[0].removeAttribute('data-empty');
} else {
} else {
$(this.content).dialog("widget").find(".morebits-dialog-buttons")[0].setAttribute("data-empty", "data-empty"); // used by CSS
$(this.content).dialog('widget').find('.morebits-dialog-buttons')[0].setAttribute('data-empty', 'data-empty'); // used by CSS
}
}
return this;
return this;
Baris 4.126: Baris 4.724:
this.buttons = [];
this.buttons = [];
// delete all buttons in the buttonpane
// delete all buttons in the buttonpane
$(this.content).dialog("widget").find(".morebits-dialog-buttons").empty();
$(this.content).dialog('widget').find('.morebits-dialog-buttons').empty();


while( this.content.hasChildNodes() ) {
while (this.content.hasChildNodes()) {
this.content.removeChild( this.content.firstChild );
this.content.removeChild(this.content.firstChild);
}
}
return this;
return this;
Baris 4.139: Baris 4.737:
* For example, Twinkle's CSD module adds a link to the CSD policy page,
* For example, Twinkle's CSD module adds a link to the CSD policy page,
* as well as a link to Twinkle's documentation.
* as well as a link to Twinkle's documentation.
* @param {string} text Link's text content
* @param {string} text Link's text content
* @param {string} wikiPage Link target
* @param {string} wikiPage Link target
* @param {boolean} [prep=false] Set true to prepend rather than append
* @returns {Morebits.simpleWindow}
* @returns {Morebits.simpleWindow}
*/
*/
addFooterLink: function( text, wikiPage ) {
addFooterLink: function(text, wikiPage, prep) {
var $footerlinks = $(this.content).dialog("widget").find(".morebits-dialog-footerlinks");
var $footerlinks = $(this.content).dialog('widget').find('.morebits-dialog-footerlinks');
if (this.hasFooterLinks) {
if (this.hasFooterLinks) {
var bullet = document.createElement("span");
var bullet = document.createElement('span');
bullet.textContent = " \u2022 "; // U+2022 BULLET
bullet.textContent = ' \u2022 '; // U+2022 BULLET
if (prep) {
$footerlinks.append(bullet);
$footerlinks.prepend(bullet);
} else {
$footerlinks.append(bullet);
}
}
}
var link = document.createElement("a");
var link = document.createElement('a');
link.setAttribute("href", mw.util.getUrl(wikiPage) );
link.setAttribute('href', mw.util.getUrl(wikiPage));
link.setAttribute("title", wikiPage);
link.setAttribute('title', wikiPage);
link.setAttribute("target", "_blank");
link.setAttribute('target', '_blank');
link.textContent = text;
link.textContent = text;
if (prep) {
$footerlinks.append(link);
$footerlinks.prepend(link);
} else {
$footerlinks.append(link);
}
this.hasFooterLinks = true;
this.hasFooterLinks = true;
return this;
return this;
Baris 4.170: Baris 4.777:
* @returns {Morebits.simpleWindow}
* @returns {Morebits.simpleWindow}
*/
*/
setModality: function( modal ) {
setModality: function(modal) {
$(this.content).dialog("option", "modal", modal);
$(this.content).dialog('option', 'modal', modal);
return this;
return this;
}
}
Baris 4.185: Baris 4.792:
* @param {boolean} enabled
* @param {boolean} enabled
*/
*/
Morebits.simpleWindow.setButtonsEnabled = function( enabled ) {
Morebits.simpleWindow.setButtonsEnabled = function(enabled) {
$(".morebits-dialog-buttons button").prop("disabled", !enabled);
$('.morebits-dialog-buttons button').prop('disabled', !enabled);
};
};


Baris 4.194: Baris 4.801:




} ( window, document, jQuery )); // End wrap with anonymous function
}(window, document, jQuery)); // End wrap with anonymous function




Baris 4.206: Baris 4.813:
*/
*/


if ( typeof arguments === "undefined" ) { // typeof is here for a reason...
if (typeof arguments === 'undefined') { // typeof is here for a reason...
/* global Morebits */
/* global Morebits */
window.SimpleWindow = Morebits.simpleWindow;
window.SimpleWindow = Morebits.simpleWindow;
Baris 4.212: Baris 4.819:
window.Wikipedia = Morebits.wiki;
window.Wikipedia = Morebits.wiki;
window.Status = Morebits.status;
window.Status = Morebits.status;
window.QueryString = Morebits.queryString;
}
}


//</nowiki>
// </nowiki>

Revisi per 19 Juni 2020 14.13

// <nowiki>
/**
 * morebits.js
 * ===========
 * A library full of lots of goodness for user scripts on MediaWiki wikis, including Wikipedia.
 *
 * The highlights include:
 *   - Morebits.quickForm class - generates quick HTML forms on the fly
 *   - Morebits.wiki.api class - makes calls to the MediaWiki API
 *   - Morebits.wiki.page class - modifies pages on the wiki (edit, revert, delete, etc.)
 *   - Morebits.wikitext class - contains some utilities for dealing with wikitext
 *   - Morebits.status class - a rough-and-ready status message displayer, used by the Morebits.wiki classes
 *   - Morebits.simpleWindow class - a wrapper for jQuery UI Dialog with a custom look and extra features
 *
 * Dependencies:
 *   - The whole thing relies on jQuery.  But most wikis should provide this by default.
 *   - Morebits.quickForm, Morebits.simpleWindow, and Morebits.status rely on the "morebits.css" file for their styling.
 *   - Morebits.simpleWindow relies on jquery UI Dialog (from ResourceLoader module name 'jquery.ui').
 *   - Morebits.quickForm tooltips rely on Tipsy (ResourceLoader module name 'jquery.tipsy').
 *     For external installations, Tipsy is available at [http://onehackoranother.com/projects/jquery/tipsy].
 *   - To create a gadget based on morebits.js, use this syntax in MediaWiki:Gadgets-definition:
 *       * GadgetName[ResourceLoader|dependencies=mediawiki.user,mediawiki.util,jquery.ui,jquery.tipsy]|morebits.js|morebits.css|GadgetName.js
 *   - Alternatively, you can configure morebits.js as a hidden gadget in MediaWiki:Gadgets-definition:
 *       * morebits[ResourceLoader|dependencies=mediawiki.user,mediawiki.util,jquery.ui,jquery.tipsy|hidden]|morebits.js|morebits.css
 *     and then load ext.gadget.morebits as one of the dependencies for the new gadget
 *
 * All the stuff here works on all browsers for which MediaWiki provides JavaScript support.
 *
 * This library is maintained by the maintainers of Twinkle.
 * For queries, suggestions, help, etc., head to [[Wikipedia talk:Twinkle]] on English Wikipedia [http://en.wikipedia.org].
 * The latest development source is available at [https://github.com/azatoth/twinkle/blob/master/morebits.js].
 */


(function (window, document, $) { // Wrap entire file with anonymous function

var Morebits = {};
window.Morebits = Morebits;  // allow global access



/**
 * **************** Morebits.userIsInGroup() ****************
 * Simple helper function to see what groups a user might belong
 * @param {string} group  eg. `sysop`, `extendedconfirmed`, etc
 * @returns {boolean}
 */
Morebits.userIsInGroup = function (group) {
	return mw.config.get('wgUserGroups').indexOf(group) !== -1;
};
// Used a lot
Morebits.userIsSysop = Morebits.userIsInGroup('sysop');



/**
 * **************** Morebits.sanitizeIPv6() ****************
 * JavaScript translation of the MediaWiki core function IP::sanitizeIP() in
 * includes/utils/IP.php.
 * Converts an IPv6 address to the canonical form stored and used by MediaWiki.
 * @param {string} address - The IPv6 address
 * @returns {string}
 */
Morebits.sanitizeIPv6 = function (address) {
	address = address.trim();
	if (address === '') {
		return null;
	}
	if (!mw.util.isIPv6Address(address)) {
		return address; // nothing else to do for IPv4 addresses or invalid ones
	}
	// Remove any whitespaces, convert to upper case
	address = address.toUpperCase();
	// Expand zero abbreviations
	var abbrevPos = address.indexOf('::');
	if (abbrevPos > -1) {
		// We know this is valid IPv6. Find the last index of the
		// address before any CIDR number (e.g. "a:b:c::/24").
		var CIDRStart = address.indexOf('/');
		var addressEnd = CIDRStart > -1 ? CIDRStart - 1 : address.length - 1;
		// If the '::' is at the beginning...
		var repeat, extra, pad;
		if (abbrevPos === 0) {
			repeat = '0:';
			extra = address === '::' ? '0' : ''; // for the address '::'
			pad = 9; // 7+2 (due to '::')
		// If the '::' is at the end...
		} else if (abbrevPos === (addressEnd - 1)) {
			repeat = ':0';
			extra = '';
			pad = 9; // 7+2 (due to '::')
		// If the '::' is in the middle...
		} else {
			repeat = ':0';
			extra = ':';
			pad = 8; // 6+2 (due to '::')
		}
		var replacement = repeat;
		pad -= address.split(':').length - 1;
		for (var i = 1; i < pad; i++) {
			replacement += repeat;
		}
		replacement += extra;
		address = address.replace('::', replacement);
	}
	// Remove leading zeros from each bloc as needed
	address = address.replace(/(^|:)0+([0-9A-Fa-f]{1,4})/g, '$1$2');

	return address;
};



/**
 * **************** Morebits.quickForm ****************
 * Morebits.quickForm is a class for creation of simple and standard forms without much
 * specific coding.
 *
 * Index to Morebits.quickForm element types:
 *
 *   select    A combo box (aka drop-down).
 *              - Attributes: name, label, multiple, size, list, event, disabled
 *   option    An element for a combo box.
 *              - Attributes: value, label, selected, disabled
 *   optgroup  A group of "option"s.
 *              - Attributes: label, list
 *   field     A fieldset (aka group box).
 *              - Attributes: name, label, disabled
 *   checkbox  A checkbox. Must use "list" parameter.
 *              - Attributes: name, list, event
 *              - Attributes (within list): name, label, value, checked, disabled, event, subgroup
 *   radio     A radio button. Must use "list" parameter.
 *              - Attributes: name, list, event
 *              - Attributes (within list): name, label, value, checked, disabled, event, subgroup
 *   input     A text box.
 *              - Attributes: name, label, value, size, disabled, required, readonly, maxlength, event
 *   dyninput  A set of text boxes with "Remove" buttons and an "Add" button.
 *              - Attributes: name, label, min, max, sublabel, value, size, maxlength, event
 *   hidden    An invisible form field.
 *              - Attributes: name, value
 *   header    A level 5 header.
 *              - Attributes: label
 *   div       A generic placeholder element or label.
 *              - Attributes: name, label
 *   submit    A submit button. Morebits.simpleWindow moves these to the footer of the dialog.
 *              - Attributes: name, label, disabled
 *   button    A generic button.
 *              - Attributes: name, label, disabled, event
 *   textarea  A big, multi-line text box.
 *              - Attributes: name, label, value, cols, rows, disabled, required, readonly
 *   fragment  A DocumentFragment object.
 *              - No attributes, and no global attributes except adminonly
 *
 * Global attributes: id, className, style, tooltip, extra, adminonly
 */

/**
 * @constructor
 * @param {event} event - Function to execute when form is submitted
 * @param {string} [eventType=submit] - Type of the event (default: submit)
 */
Morebits.quickForm = function QuickForm(event, eventType) {
	this.root = new Morebits.quickForm.element({ type: 'form', event: event, eventType: eventType });
};

/**
 * Renders the HTML output of the quickForm
 * @returns {HTMLElement}
 */
Morebits.quickForm.prototype.render = function QuickFormRender() {
	var ret = this.root.render();
	ret.names = {};
	return ret;
};

/**
 * Append element to the form
 * @param {(Object|Morebits.quickForm.element)} data - a quickform element, or the object with which
 * a quickform element is constructed.
 * @returns {Morebits.quickForm.element} - same as what is passed to the function
 */
Morebits.quickForm.prototype.append = function QuickFormAppend(data) {
	return this.root.append(data);
};

/**
 * @constructor
 * @param {Object} data - Object representing the quickform element. See class documentation
 * comment for available types and attributes for each.
 */
Morebits.quickForm.element = function QuickFormElement(data) {
	this.data = data;
	this.childs = [];
	this.id = Morebits.quickForm.element.id++;
};

Morebits.quickForm.element.id = 0;

/**
 * Appends an element to current element
 * @param {Morebits.quickForm.element} data  A quickForm element or the object required to
 * create the quickForm element
 * @returns {Morebits.quickForm.element} The same element passed in
 */
Morebits.quickForm.element.prototype.append = function QuickFormElementAppend(data) {
	var child;
	if (data instanceof Morebits.quickForm.element) {
		child = data;
	} else {
		child = new Morebits.quickForm.element(data);
	}
	this.childs.push(child);
	return child;
};

/**
 * Renders the HTML output for the quickForm element
 * This should be called without parameters: form.render()
 * @returns {HTMLElement}
 */
Morebits.quickForm.element.prototype.render = function QuickFormElementRender(internal_subgroup_id) {
	var currentNode = this.compute(this.data, internal_subgroup_id);

	for (var i = 0; i < this.childs.length; ++i) {
		// do not pass internal_subgroup_id to recursive calls
		currentNode[1].appendChild(this.childs[i].render());
	}
	return currentNode[0];
};

Morebits.quickForm.element.prototype.compute = function QuickFormElementCompute(data, in_id) {
	var node;
	var childContainder = null;
	var label;
	var id = (in_id ? in_id + '_' : '') + 'node_' + this.id;
	if (data.adminonly && !Morebits.userIsSysop) {
		// hell hack alpha
		data.type = 'hidden';
	}

	var i, current, subnode;
	switch (data.type) {
		case 'form':
			node = document.createElement('form');
			node.className = 'quickform';
			node.setAttribute('action', 'javascript:void(0);');
			if (data.event) {
				node.addEventListener(data.eventType || 'submit', data.event, false);
			}
			break;
		case 'fragment':
			node = document.createDocumentFragment();
			// fragments can't have any attributes, so just return it straight away
			return [ node, node ];
		case 'select':
			node = document.createElement('div');

			node.setAttribute('id', 'div_' + id);
			if (data.label) {
				label = node.appendChild(document.createElement('label'));
				label.setAttribute('for', id);
				label.appendChild(document.createTextNode(data.label));
			}
			var select = node.appendChild(document.createElement('select'));
			if (data.event) {
				select.addEventListener('change', data.event, false);
			}
			if (data.multiple) {
				select.setAttribute('multiple', 'multiple');
			}
			if (data.size) {
				select.setAttribute('size', data.size);
			}
			if (data.disabled) {
				select.setAttribute('disabled', 'disabled');
			}
			select.setAttribute('name', data.name);

			if (data.list) {
				for (i = 0; i < data.list.length; ++i) {

					current = data.list[i];

					if (current.list) {
						current.type = 'optgroup';
					} else {
						current.type = 'option';
					}

					subnode = this.compute(current);
					select.appendChild(subnode[0]);
				}
			}
			childContainder = select;
			break;
		case 'option':
			node = document.createElement('option');
			node.values = data.value;
			node.setAttribute('value', data.value);
			if (data.selected) {
				node.setAttribute('selected', 'selected');
			}
			if (data.disabled) {
				node.setAttribute('disabled', 'disabled');
			}
			node.setAttribute('label', data.label);
			node.appendChild(document.createTextNode(data.label));
			break;
		case 'optgroup':
			node = document.createElement('optgroup');
			node.setAttribute('label', data.label);

			if (data.list) {
				for (i = 0; i < data.list.length; ++i) {

					current = data.list[i];
					current.type = 'option'; // must be options here

					subnode = this.compute(current);
					node.appendChild(subnode[0]);
				}
			}
			break;
		case 'field':
			node = document.createElement('fieldset');
			label = node.appendChild(document.createElement('legend'));
			label.appendChild(document.createTextNode(data.label));
			if (data.name) {
				node.setAttribute('name', data.name);
			}
			if (data.disabled) {
				node.setAttribute('disabled', 'disabled');
			}
			break;
		case 'checkbox':
		case 'radio':
			node = document.createElement('div');
			if (data.list) {
				for (i = 0; i < data.list.length; ++i) {
					var cur_id = id + '_' + i;
					current = data.list[i];
					var cur_div;
					if (current.type === 'header') {
					// inline hack
						cur_div = node.appendChild(document.createElement('h6'));
						cur_div.appendChild(document.createTextNode(current.label));
						if (current.tooltip) {
							Morebits.quickForm.element.generateTooltip(cur_div, current);
						}
						continue;
					}
					cur_div = node.appendChild(document.createElement('div'));
					subnode = cur_div.appendChild(document.createElement('input'));
					subnode.values = current.value;
					subnode.setAttribute('value', current.value);
					subnode.setAttribute('name', current.name || data.name);
					subnode.setAttribute('type', data.type);
					subnode.setAttribute('id', cur_id);

					if (current.checked) {
						subnode.setAttribute('checked', 'checked');
					}
					if (current.disabled) {
						subnode.setAttribute('disabled', 'disabled');
					}
					label = cur_div.appendChild(document.createElement('label'));
					label.appendChild(document.createTextNode(current.label));
					label.setAttribute('for', cur_id);
					if (current.tooltip) {
						Morebits.quickForm.element.generateTooltip(label, current);
					}
					// styles go on the label, doesn't make sense to style a checkbox/radio
					if (current.style) {
						label.setAttribute('style', current.style);
					}

					var event;
					if (current.subgroup) {
						var tmpgroup = current.subgroup;

						if (!Array.isArray(tmpgroup)) {
							tmpgroup = [ tmpgroup ];
						}

						var subgroupRaw = new Morebits.quickForm.element({
							type: 'div',
							id: id + '_' + i + '_subgroup'
						});
						$.each(tmpgroup, function(idx, el) {
							var newEl = $.extend({}, el);
							if (!newEl.type) {
								newEl.type = data.type;
							}
							newEl.name = (current.name || data.name) + '.' + newEl.name;
							subgroupRaw.append(newEl);
						});

						var subgroup = subgroupRaw.render(cur_id);
						subgroup.className = 'quickformSubgroup';
						subnode.subgroup = subgroup;
						subnode.shown = false;

						event = function(e) {
							if (e.target.checked) {
								e.target.parentNode.appendChild(e.target.subgroup);
								if (e.target.type === 'radio') {
									var name = e.target.name;
									if (e.target.form.names[name] !== undefined) {
										e.target.form.names[name].parentNode.removeChild(e.target.form.names[name].subgroup);
									}
									e.target.form.names[name] = e.target;
								}
							} else {
								e.target.parentNode.removeChild(e.target.subgroup);
							}
						};
						subnode.addEventListener('change', event, true);
						if (current.checked) {
							subnode.parentNode.appendChild(subgroup);
						}
					} else if (data.type === 'radio') {
						event = function(e) {
							if (e.target.checked) {
								var name = e.target.name;
								if (e.target.form.names[name] !== undefined) {
									e.target.form.names[name].parentNode.removeChild(e.target.form.names[name].subgroup);
								}
								delete e.target.form.names[name];
							}
						};
						subnode.addEventListener('change', event, true);
					}
					// add users' event last, so it can interact with the subgroup
					if (data.event) {
						subnode.addEventListener('change', data.event, false);
					} else if (current.event) {
						subnode.addEventListener('change', current.event, true);
					}
				}
			}
			break;
		case 'input':
			node = document.createElement('div');
			node.setAttribute('id', 'div_' + id);

			if (data.label) {
				label = node.appendChild(document.createElement('label'));
				label.appendChild(document.createTextNode(data.label));
				label.setAttribute('for', data.id || id);
			}

			subnode = node.appendChild(document.createElement('input'));
			if (data.value) {
				subnode.setAttribute('value', data.value);
			}
			subnode.setAttribute('name', data.name);
			subnode.setAttribute('type', 'text');
			if (data.size) {
				subnode.setAttribute('size', data.size);
			}
			if (data.disabled) {
				subnode.setAttribute('disabled', 'disabled');
			}
			if (data.required) {
				subnode.setAttribute('required', 'required');
			}
			if (data.readonly) {
				subnode.setAttribute('readonly', 'readonly');
			}
			if (data.maxlength) {
				subnode.setAttribute('maxlength', data.maxlength);
			}
			if (data.event) {
				subnode.addEventListener('keyup', data.event, false);
			}
			childContainder = subnode;
			break;
		case 'dyninput':
			var min = data.min || 1;
			var max = data.max || Infinity;

			node = document.createElement('div');

			label = node.appendChild(document.createElement('h5'));
			label.appendChild(document.createTextNode(data.label));

			var listNode = node.appendChild(document.createElement('div'));

			var more = this.compute({
				type: 'button',
				label: 'more',
				disabled: min >= max,
				event: function(e) {
					var new_node = new Morebits.quickForm.element(e.target.sublist);
					e.target.area.appendChild(new_node.render());

					if (++e.target.counter >= e.target.max) {
						e.target.setAttribute('disabled', 'disabled');
					}
					e.stopPropagation();
				}
			});

			node.appendChild(more[0]);
			var moreButton = more[1];

			var sublist = {
				type: '_dyninput_element',
				label: data.sublabel || data.label,
				name: data.name,
				value: data.value,
				size: data.size,
				remove: false,
				maxlength: data.maxlength,
				event: data.event
			};

			for (i = 0; i < min; ++i) {
				var elem = new Morebits.quickForm.element(sublist);
				listNode.appendChild(elem.render());
			}
			sublist.remove = true;
			sublist.morebutton = moreButton;
			sublist.listnode = listNode;

			moreButton.sublist = sublist;
			moreButton.area = listNode;
			moreButton.max = max - min;
			moreButton.counter = 0;
			break;
		case '_dyninput_element': // Private, similar to normal input
			node = document.createElement('div');

			if (data.label) {
				label = node.appendChild(document.createElement('label'));
				label.appendChild(document.createTextNode(data.label));
				label.setAttribute('for', id);
			}

			subnode = node.appendChild(document.createElement('input'));
			if (data.value) {
				subnode.setAttribute('value', data.value);
			}
			subnode.setAttribute('name', data.name);
			subnode.setAttribute('type', 'text');
			if (data.size) {
				subnode.setAttribute('size', data.size);
			}
			if (data.maxlength) {
				subnode.setAttribute('maxlength', data.maxlength);
			}
			if (data.event) {
				subnode.addEventListener('keyup', data.event, false);
			}
			if (data.remove) {
				var remove = this.compute({
					type: 'button',
					label: 'remove',
					event: function(e) {
						var list = e.target.listnode;
						var node = e.target.inputnode;
						var more = e.target.morebutton;

						list.removeChild(node);
						--more.counter;
						more.removeAttribute('disabled');
						e.stopPropagation();
					}
				});
				node.appendChild(remove[0]);
				var removeButton = remove[1];
				removeButton.inputnode = node;
				removeButton.listnode = data.listnode;
				removeButton.morebutton = data.morebutton;
			}
			break;
		case 'hidden':
			node = document.createElement('input');
			node.setAttribute('type', 'hidden');
			node.values = data.value;
			node.setAttribute('value', data.value);
			node.setAttribute('name', data.name);
			break;
		case 'header':
			node = document.createElement('h5');
			node.appendChild(document.createTextNode(data.label));
			break;
		case 'div':
			node = document.createElement('div');
			if (data.name) {
				node.setAttribute('name', data.name);
			}
			if (data.label) {
				if (!Array.isArray(data.label)) {
					data.label = [ data.label ];
				}
				var result = document.createElement('span');
				result.className = 'quickformDescription';
				for (i = 0; i < data.label.length; ++i) {
					if (typeof data.label[i] === 'string') {
						result.appendChild(document.createTextNode(data.label[i]));
					} else if (data.label[i] instanceof Element) {
						result.appendChild(data.label[i]);
					}
				}
				node.appendChild(result);
			}
			break;
		case 'submit':
			node = document.createElement('span');
			childContainder = node.appendChild(document.createElement('input'));
			childContainder.setAttribute('type', 'submit');
			if (data.label) {
				childContainder.setAttribute('value', data.label);
			}
			childContainder.setAttribute('name', data.name || 'submit');
			if (data.disabled) {
				childContainder.setAttribute('disabled', 'disabled');
			}
			break;
		case 'button':
			node = document.createElement('span');
			childContainder = node.appendChild(document.createElement('input'));
			childContainder.setAttribute('type', 'button');
			if (data.label) {
				childContainder.setAttribute('value', data.label);
			}
			childContainder.setAttribute('name', data.name);
			if (data.disabled) {
				childContainder.setAttribute('disabled', 'disabled');
			}
			if (data.event) {
				childContainder.addEventListener('click', data.event, false);
			}
			break;
		case 'textarea':
			node = document.createElement('div');
			node.setAttribute('id', 'div_' + id);
			if (data.label) {
				label = node.appendChild(document.createElement('h5'));
				var labelElement = document.createElement('label');
				labelElement.textContent = data.label;
				labelElement.setAttribute('for', data.id || id);
				label.appendChild(labelElement);
			}
			subnode = node.appendChild(document.createElement('textarea'));
			subnode.setAttribute('name', data.name);
			if (data.cols) {
				subnode.setAttribute('cols', data.cols);
			}
			if (data.rows) {
				subnode.setAttribute('rows', data.rows);
			}
			if (data.disabled) {
				subnode.setAttribute('disabled', 'disabled');
			}
			if (data.required) {
				subnode.setAttribute('required', 'required');
			}
			if (data.readonly) {
				subnode.setAttribute('readonly', 'readonly');
			}
			if (data.value) {
				subnode.value = data.value;
			}
			childContainder = subnode;
			break;
		default:
			throw new Error('Morebits.quickForm: unknown element type ' + data.type.toString());
	}

	if (!childContainder) {
		childContainder = node;
	}
	if (data.tooltip) {
		Morebits.quickForm.element.generateTooltip(label || node, data);
	}

	if (data.extra) {
		childContainder.extra = data.extra;
	}
	if (data.style) {
		childContainder.setAttribute('style', data.style);
	}
	if (data.className) {
		childContainder.className = childContainder.className ?
			childContainder.className + ' ' + data.className :
			data.className;
	}
	childContainder.setAttribute('id', data.id || id);

	return [ node, childContainder ];
};

Morebits.quickForm.element.autoNWSW = function() {
	return $(this).offset().top > ($(document).scrollTop() + ($(window).height() / 2)) ? 'sw' : 'nw';
};

/**
 * Create a jquery.tipsy-based tooltip.
 * @requires jquery.tipsy
 * @param {HTMLElement} node - the HTML element beside which a tooltip is to be generated
 * @param {Object} data - tooltip-related configuration data
 */
Morebits.quickForm.element.generateTooltip = function QuickFormElementGenerateTooltip(node, data) {
	$('<span/>', {
		'class': 'ui-icon ui-icon-help ui-icon-inline morebits-tooltip'
	}).appendTo(node).tipsy({
		'fallback': data.tooltip,
		'fade': true,
		'gravity': data.type === 'input' || data.type === 'select' ?
			Morebits.quickForm.element.autoNWSW : $.fn.tipsy.autoWE,
		'html': true,
		'delayOut': 250
	});
};


// Some utility methods for manipulating quickForms after their creation:
// (None of these work for "dyninput" type fields at present)


/**
 * Returns all form elements with a given field name or ID
 * @param {HTMLFormElement} form
 * @param {string} fieldName - the name or id of the fields
 * @returns {HTMLElement[]} - array of matching form elements
 */
Morebits.quickForm.getElements = function QuickFormGetElements(form, fieldName) {
	var $form = $(form);
	var $elements = $form.find('[name="' + fieldName + '"]');
	if ($elements.length > 0) {
		return $elements.toArray();
	}
	$elements = $form.find('#' + fieldName);
	if ($elements.length > 0) {
		return $elements.toArray();
	}
	return null;
};

/**
 * Searches the array of elements for a checkbox or radio button with a certain
 * `value` attribute, and returns the first such element. Returns null if not found.
 * @param {HTMLInputElement[]} elementArray - array of checkbox or radio elements
 * @param {string} value - value to search for
 * @returns {HTMLInputElement}
 */
Morebits.quickForm.getCheckboxOrRadio = function QuickFormGetCheckboxOrRadio(elementArray, value) {
	var found = $.grep(elementArray, function(el) {
		return el.value === value;
	});
	if (found.length > 0) {
		return found[0];
	}
	return null;
};

/**
 * Returns the <div> containing the form element, or the form element itself
 * May not work as expected on checkboxes or radios
 * @param {HTMLElement} element
 * @returns {HTMLElement}
 */
Morebits.quickForm.getElementContainer = function QuickFormGetElementContainer(element) {
	// for divs, headings and fieldsets, the container is the element itself
	if (element instanceof HTMLFieldSetElement || element instanceof HTMLDivElement ||
			element instanceof HTMLHeadingElement) {
		return element;
	}

	// for others, just return the parent node
	return element.parentNode;
};

/**
 * Gets the HTML element that contains the label of the given form element
 * (mainly for internal use)
 * @param {(HTMLElement|Morebits.quickForm.element)} element
 * @returns {HTMLElement}
 */
Morebits.quickForm.getElementLabelObject = function QuickFormGetElementLabelObject(element) {
	// for buttons, divs and headers, the label is on the element itself
	if (element.type === 'button' || element.type === 'submit' ||
			element instanceof HTMLDivElement || element instanceof HTMLHeadingElement) {
		return element;
	// for fieldsets, the label is the child <legend> element
	} else if (element instanceof HTMLFieldSetElement) {
		return element.getElementsByTagName('legend')[0];
	// for textareas, the label is the sibling <h5> element
	} else if (element instanceof HTMLTextAreaElement) {
		return element.parentNode.getElementsByTagName('h5')[0];
	}
	// for others, the label is the sibling <label> element
	return element.parentNode.getElementsByTagName('label')[0];
};

/**
 * Gets the label text of the element
 * @param {(HTMLElement|Morebits.quickForm.element)} element
 * @returns {string}
 */
Morebits.quickForm.getElementLabel = function QuickFormGetElementLabel(element) {
	var labelElement = Morebits.quickForm.getElementLabelObject(element);

	if (!labelElement) {
		return null;
	}
	return labelElement.firstChild.textContent;
};

/**
 * Sets the label of the element to the given text
 * @param {(HTMLElement|Morebits.quickForm.element)} element
 * @param {string} labelText
 * @returns {boolean} true if succeeded, false if the label element is unavailable
 */
Morebits.quickForm.setElementLabel = function QuickFormSetElementLabel(element, labelText) {
	var labelElement = Morebits.quickForm.getElementLabelObject(element);

	if (!labelElement) {
		return false;
	}
	labelElement.firstChild.textContent = labelText;
	return true;
};

/**
 * Stores the element's current label, and temporarily sets the label to the given text
 * @param {(HTMLElement|Morebits.quickForm.element)} element
 * @param {string} temporaryLabelText
 * @returns {boolean} true if succeeded, false if the label element is unavailable
 */
Morebits.quickForm.overrideElementLabel = function QuickFormOverrideElementLabel(element, temporaryLabelText) {
	if (!element.hasAttribute('data-oldlabel')) {
		element.setAttribute('data-oldlabel', Morebits.quickForm.getElementLabel(element));
	}
	return Morebits.quickForm.setElementLabel(element, temporaryLabelText);
};

/**
 * Restores the label stored by overrideElementLabel
 * @param {(HTMLElement|Morebits.quickForm.element)} element
 * @returns {boolean} true if succeeded, false if the label element is unavailable
 */
Morebits.quickForm.resetElementLabel = function QuickFormResetElementLabel(element) {
	if (element.hasAttribute('data-oldlabel')) {
		return Morebits.quickForm.setElementLabel(element, element.getAttribute('data-oldlabel'));
	}
	return null;
};

/**
 * Shows or hides a form element plus its label and tooltip
 * @param {(HTMLElement|jQuery|string)} element  HTML/jQuery element, or jQuery selector string
 * @param {boolean} [visibility] Skip this to toggle visibility
 */
Morebits.quickForm.setElementVisibility = function QuickFormSetElementVisibility(element, visibility) {
	$(element).toggle(visibility);
};

/**
 * Shows or hides the "question mark" icon (which displays the tooltip) next to a form element
 * @param {(HTMLElement|jQuery)} element
 * @param {boolean} [visibility] Skip this to toggle visibility
 */
Morebits.quickForm.setElementTooltipVisibility = function QuickFormSetElementTooltipVisibility(element, visibility) {
	$(Morebits.quickForm.getElementContainer(element)).find('.morebits-tooltip').toggle(visibility);
};



/**
 * **************** HTMLFormElement ****************
 */

/**
 * Returns an array containing the values of elements with the given name, that has it's
 * checked property set to true. (i.e. a checkbox or a radiobutton is checked), or select
 * options that have selected set to true. (don't try to mix selects with radio/checkboxes,
 * please)
 * Type is optional and can specify if either radio or checkbox (for the event
 * that both checkboxes and radiobuttons have the same name.
 *
 * XXX: Doesn't seem to work reliably across all browsers at the moment. -- see getChecked2
 * in twinkleunlink.js, which is better
 */
HTMLFormElement.prototype.getChecked = function(name, type) {
	var elements = this.elements[name];
	if (!elements) {
		// if the element doesn't exists, return null.
		return null;
	}
	var return_array = [];
	var i;
	if (elements instanceof HTMLSelectElement) {
		var options = elements.options;
		for (i = 0; i < options.length; ++i) {
			if (options[i].selected) {
				if (options[i].values) {
					return_array.push(options[i].values);
				} else {
					return_array.push(options[i].value);
				}

			}
		}
	} else if (elements instanceof HTMLInputElement) {
		if (type && elements.type !== type) {
			return [];
		} else if (elements.checked) {
			return [ elements.value ];
		}
	} else {
		for (i = 0; i < elements.length; ++i) {
			if (elements[i].checked) {
				if (type && elements[i].type !== type) {
					continue;
				}
				if (elements[i].values) {
					return_array.push(elements[i].values);
				} else {
					return_array.push(elements[i].value);
				}
			}
		}
	}
	return return_array;
};

/**
 * getUnchecked:
 *   Does the same as getChecked above, but with unchecked elements.
 */

HTMLFormElement.prototype.getUnchecked = function(name, type) {
	var elements = this.elements[name];
	if (!elements) {
		// if the element doesn't exists, return null.
		return null;
	}
	var return_array = [];
	var i;
	if (elements instanceof HTMLSelectElement) {
		var options = elements.options;
		for (i = 0; i < options.length; ++i) {
			if (!options[i].selected) {
				if (options[i].values) {
					return_array.push(options[i].values);
				} else {
					return_array.push(options[i].value);
				}

			}
		}
	} else if (elements instanceof HTMLInputElement) {
		if (type && elements.type !== type) {
			return [];
		} else if (!elements.checked) {
			return [ elements.value ];
		}
	} else {
		for (i = 0; i < elements.length; ++i) {
			if (!elements[i].checked) {
				if (type && elements[i].type !== type) {
					continue;
				}
				if (elements[i].values) {
					return_array.push(elements[i].values);
				} else {
					return_array.push(elements[i].value);
				}
			}
		}
	}
	return return_array;
};


/**
 * **************** RegExp ****************
 *
 * Escapes a string to be used in a RegExp
 * @param {string} text - string to be escaped
 * @param {boolean} [space_fix=false] - Set true to replace spaces and underscores with `[ _]` as they are
 * often equivalent
 * @returns {string} - the escaped text
 */
RegExp.escape = function(text, space_fix) {
	text = mw.util.escapeRegExp(text);

	// Special MediaWiki escape - underscore/space are often equivalent
	if (space_fix) {
		text = text.replace(/ |_/g, '[_ ]');
	}

	return text;
};


/**
 * **************** String; Morebits.string ****************
 */

Morebits.string = {
	// Helper functions to change case of a string
	toUpperCaseFirstChar: function(str) {
		str = str.toString();
		return str.substr(0, 1).toUpperCase() + str.substr(1);
	},
	toLowerCaseFirstChar: function(str) {
		str = str.toString();
		return str.substr(0, 1).toLowerCase() + str.substr(1);
	},

	/**
	 * Gives an array of substrings of `str` starting with `start` and
	 * ending with `end`, which is not in `skiplist`
	 * @param {string} str
	 * @param {string} start
	 * @param {string} end
	 * @param {(string[]|string)} [skiplist]
	 * @returns {String[]}
	 */
	splitWeightedByKeys: function(str, start, end, skiplist) {
		if (start.length !== end.length) {
			throw new Error('start marker and end marker must be of the same length');
		}
		var level = 0;
		var initial = null;
		var result = [];
		if (!Array.isArray(skiplist)) {
			if (skiplist === undefined) {
				skiplist = [];
			} else if (typeof skiplist === 'string') {
				skiplist = [ skiplist ];
			} else {
				throw new Error('non-applicable skiplist parameter');
			}
		}
		for (var i = 0; i < str.length; ++i) {
			for (var j = 0; j < skiplist.length; ++j) {
				if (str.substr(i, skiplist[j].length) === skiplist[j]) {
					i += skiplist[j].length - 1;
					continue;
				}
			}
			if (str.substr(i, start.length) === start) {
				if (initial === null) {
					initial = i;
				}
				++level;
				i += start.length - 1;
			} else if (str.substr(i, end.length) === end) {
				--level;
				i += end.length - 1;
			}
			if (!level && initial !== null) {
				result.push(str.substring(initial, i + 1));
				initial = null;
			}
		}

		return result;
	},

	/**
	 * Formats freeform "reason" (from a textarea) for deletion/other templates
	 * that are going to be substituted, (e.g. PROD, XFD, RPP)
	 * @param {string} str
	 * @returns {string}
	 */
	formatReasonText: function(str) {
		var result = str.toString().trim();
		var unbinder = new Morebits.unbinder(result);
		unbinder.unbind('<no' + 'wiki>', '</no' + 'wiki>');
		unbinder.content = unbinder.content.replace(/\|/g, '{{subst:!}}');
		return unbinder.rebind();
	},

	/**
	 * Like `String.prototype.replace()`, but escapes any dollar signs in the replacement string.
	 * Useful when the the replacement string is arbitrary, such as a username or freeform user input,
	 * and could contain dollar signs.
	 * @param {string} string - text in which to replace
	 * @param {(string|RegExp)} pattern
	 * @param {string} replacement
	 * @returns {string}
	 */
	safeReplace: function morebitsStringSafeReplace(string, pattern, replacement) {
		return string.replace(pattern, replacement.replace(/\$/g, '$$$$'));
	}
};


/**
 * **************** Morebits.array ****************
 */

Morebits.array = {
	/**
	 * @returns {Array} a copy of the array with duplicates removed
	 */
	uniq: function(arr) {
		if (!Array.isArray(arr)) {
			throw 'A non-array object passed to Morebits.array.uniq';
		}
		var result = [];
		for (var i = 0; i < arr.length; ++i) {
			var current = arr[i];
			if (result.indexOf(current) === -1) {
				result.push(current);
			}
		}
		return result;
	},

	/**
	 * @returns {Array} a copy of the array with the first instance of each value
	 * removed; subsequent instances of those values (duplicates) remain
	 */
	dups: function(arr) {
		if (!Array.isArray(arr)) {
			throw 'A non-array object passed to Morebits.array.dups';
		}
		var uniques = [];
		var result = [];
		for (var i = 0; i < arr.length; ++i) {
			var current = arr[i];
			if (uniques.indexOf(current) === -1) {
				uniques.push(current);
			} else {
				result.push(current);
			}
		}
		return result;
	},


	/**
	 * Break up an array into smaller arrays.
	 * @param {Array} arr
	 * @param {number} size - Size of each chunk (except the last, which could be different)
	 * @returns {Array} an array of these smaller arrays
	 */
	chunk: function(arr, size) {
		if (!Array.isArray(arr)) {
			throw 'A non-array object passed to Morebits.array.chunk';
		}
		if (typeof size !== 'number' || size <= 0) { // pretty impossible to do anything :)
			return [ arr ]; // we return an array consisting of this array.
		}
		var result = [];
		var current;
		for (var i = 0; i < arr.length; ++i) {
			if (i % size === 0) { // when 'i' is 0, this is always true, so we start by creating one.
				current = [];
				result.push(current);
			}
			current.push(arr[i]);
		}
		return result;
	}
};

/**
 * ************ Morebits.select2 ***************
 * Utilities to enhance select2 menus
 * See twinklewarn, twinklexfd, twinkleblock for sample usages
 */
Morebits.select2 = {

	matchers: {
		/**
		 * Custom matcher in which if the optgroup name matches, all options in that
		 * group are shown, like in jquery.chosen
		 */
		optgroupFull: function(params, data) {
			var originalMatcher = $.fn.select2.defaults.defaults.matcher;
			var result = originalMatcher(params, data);

			if (result && params.term &&
				data.text.toUpperCase().indexOf(params.term.toUpperCase()) !== -1) {
				result.children = data.children;
			}
			return result;
		},

		/** Custom matcher that matches from the beginning of words only */
		wordBeginning: function(params, data) {
			var originalMatcher = $.fn.select2.defaults.defaults.matcher;
			var result = originalMatcher(params, data);
			if (!params.term || (result &&
				new RegExp('\\b' + mw.util.escapeRegExp(params.term), 'i').test(result.text))) {
				return result;
			}
			return null;
		}
	},

	/** Underline matched part of options */
	highlightSearchMatches: function(data) {
		var searchTerm = Morebits.select2SearchQuery;
		if (!searchTerm || data.loading) {
			return data.text;
		}
		var idx = data.text.toUpperCase().indexOf(searchTerm.toUpperCase());
		if (idx < 0) {
			return data.text;
		}

		return $('<span>').append(
			data.text.slice(0, idx),
			$('<span>').css('text-decoration', 'underline').text(data.text.slice(idx, idx + searchTerm.length)),
			data.text.slice(idx + searchTerm.length)
		);
	},

	/** Intercept query as it is happening, for use in highlightSearchMatches */
	queryInterceptor: function(params) {
		Morebits.select2SearchQuery = params && params.term;
	},

	/**
	 * Open dropdown and begin search when the .select2-selection has focus and a key is pressed
	 * https://github.com/select2/select2/issues/3279#issuecomment-442524147
	 */
	autoStart: function(ev) {
		if (ev.which < 48) {
			return;
		}
		var target = $(ev.target).closest('.select2-container');
		if (!target.length) {
			return;
		}
		target = target.prev();
		target.select2('open');
		var search = target.data('select2').dropdown.$search ||
			target.data('select2').selection.$search;
		search.focus();
	}

};


/**
 * **************** Morebits.pageNameNorm ****************
 * Stores a normalized version of the wgPageName variable (underscores converted to spaces).
 * For queen/king/whatever and country!
 */
Morebits.pageNameNorm = mw.config.get('wgPageName').replace(/_/g, ' ');


/**
 * *************** Morebits.pageNameRegex *****************
 * For a page name 'Foo bar', returns the string '[Ff]oo bar'
 * @param {string} pageName - page name without namespace
 * @returns {string}
 */
Morebits.pageNameRegex = function(pageName) {
	return '[' + pageName[0].toUpperCase() + pageName[0].toLowerCase() + ']' + pageName.slice(1);
};


/**
 * **************** Morebits.unbinder ****************
 * Used for temporarily hiding a part of a string while processing the rest of it.
 *
 * eg.  var u = new Morebits.unbinder("Hello world <!-- world --> world");
 *      u.unbind('<!--','-->');
 *      u.content = u.content.replace(/world/g, 'earth');
 *      u.rebind(); // gives "Hello earth <!-- world --> earth"
 *
 * Text within the 'unbinded' part (in this case, the HTML comment) remains intact
 * unbind() can be called multiple times to unbind multiple parts of the string.
 *
 * Used by Morebits.wikitext.page.commentOutImage
 */

/**
 * @constructor
 * @param {string} string
 */
Morebits.unbinder = function Unbinder(string) {
	if (typeof string !== 'string') {
		throw new Error('not a string');
	}
	this.content = string;
	this.counter = 0;
	this.history = {};
	this.prefix = '%UNIQ::' + Math.random() + '::';
	this.postfix = '::UNIQ%';
};

Morebits.unbinder.prototype = {
	/**
	 * @param {string} prefix
	 * @param {string} postfix
	 */
	unbind: function UnbinderUnbind(prefix, postfix) {
		var re = new RegExp(prefix + '([\\s\\S]*?)' + postfix, 'g');
		this.content = this.content.replace(re, Morebits.unbinder.getCallback(this));
	},

	/** @returns {string} The output */
	rebind: function UnbinderRebind() {
		var content = this.content;
		content.self = this;
		for (var current in this.history) {
			if (Object.prototype.hasOwnProperty.call(this.history, current)) {
				content = content.replace(current, this.history[current]);
			}
		}
		return content;
	},
	prefix: null, // %UNIQ::0.5955981644938324::
	postfix: null, // ::UNIQ%
	content: null, // string
	counter: null, // 0++
	history: null // {}
};

Morebits.unbinder.getCallback = function UnbinderGetCallback(self) {
	return function UnbinderCallback(match) {
		var current = self.prefix + self.counter + self.postfix;
		self.history[current] = match;
		++self.counter;
		return current;
	};
};


/**
 * **************** Date ****************
 * Helper functions to get the month as a string instead of a number
 *
 * @deprecated Since early 2020 in favor of Morebits.date (#814)
 */

Date.monthNames = ['January', 'February', 'March', 'April', 'May', 'June',
	'July', 'August', 'September', 'October', 'November', 'December' ];
Date.monthNamesAbbrev = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
Date.prototype.getUTCMonthName = function() {
	console.warn("NOTE: Date prototypes from Twinkle's Morebits (such as getUTCMonthName) have been deprecated, use Morebits.date instead"); // eslint-disable-line no-console
	return Date.monthNames[this.getUTCMonth()];
};
Date.prototype.getUTCMonthNameAbbrev = function() {
	console.warn("NOTE: Date prototypes from Twinkle's Morebits (such as getUTCMonthNameAbbrev) have been deprecated, use Morebits.date instead"); // eslint-disable-line no-console
	return Date.monthNamesAbbrev[this.getUTCMonth()];
};


/**
 * **************** Morebits.date ****************
 */

/**
 * @constructor
 * Create a date object. MediaWiki timestamp format is also acceptable,
 * in addition to everything that JS Date() accepts.
 */
Morebits.date = function() {
	var args = Array.prototype.slice.call(arguments);

	if (typeof args[0] === 'string') {
		// Attempt to remove a comma and paren-wrapped timezone, to get MediaWiki timestamps to parse
		// Firefox (at least in 75) seems to be okay with the comma, though
		args[0] = args[0].replace(/(\d\d:\d\d),/, '$1').replace(/\(UTC\)/, 'UTC');
	}
	this._d = new (Function.prototype.bind.apply(Date, [Date].concat(args)));
};

Morebits.date.localeData = {
	months: ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'],
	monthsShort: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],
	days: ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'],
	daysShort: ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'],
	relativeTimes: {
		thisDay: '[Today at] h:mm A',
		prevDay: '[Yesterday at] h:mm A',
		nextDay: '[Tomorrow at] h:mm A',
		thisWeek: 'dddd [at] h:mm A',
		pastWeek: '[Last] dddd [at] h:mm A',
		other: 'YYYY-MM-DD'
	}
};

// Allow native Date.prototype methods to be used on Morebits.date objects
Object.getOwnPropertyNames(Date.prototype).forEach(function(func) {
	Morebits.date.prototype[func] = function() {
		return this._d[func].apply(this._d, Array.prototype.slice.call(arguments));
	};
});

$.extend(Morebits.date.prototype, {

	isValid: function() {
		return !isNaN(this.getTime());
	},

	/** @param {(Date|Morebits.date)} date */
	isBefore: function(date) {
		return this.getTime() < date.getTime();
	},
	isAfter: function(date) {
		return this.getTime() > date.getTime();
	},

	/** @return {string} */
	getUTCMonthName: function() {
		return Morebits.date.localeData.months[this.getUTCMonth()];
	},
	getUTCMonthNameAbbrev: function() {
		return Morebits.date.localeData.monthsShort[this.getUTCMonth()];
	},
	getMonthName: function() {
		return Morebits.date.localeData.months[this.getMonth()];
	},
	getMonthNameAbbrev: function() {
		return Morebits.date.localeData.monthsShort[this.getMonth()];
	},
	getUTCDayName: function() {
		return Morebits.date.localeData.days[this.getUTCDay()];
	},
	getUTCDayNameAbbrev: function() {
		return Morebits.date.localeData.daysShort[this.getUTCDay()];
	},
	getDayName: function() {
		return Morebits.date.localeData.days[this.getDay()];
	},
	getDayNameAbbrev: function() {
		return Morebits.date.localeData.daysShort[this.getDay()];
	},

	/**
	 * Add a given number of minutes, hours, days, months or years to the date.
	 * This is done in-place. The modified date object is also returned, allowing chaining.
	 * @param {number} number - should be an integer
	 * @param {string} unit
	 * @throws {Error} if invalid or unsupported unit is given
	 * @returns {Morebits.date}
	 */
	add: function(number, unit) {
		// mapping time units with getter/setter function names
		var unitMap = {
			seconds: 'Seconds',
			minutes: 'Minutes',
			hours: 'Hours',
			days: 'Date',
			months: 'Month',
			years: 'FullYear'
		};
		var unitNorm = unitMap[unit] || unitMap[unit + 's']; // so that both singular and  plural forms work
		if (unitNorm) {
			this['set' + unitNorm](this['get' + unitNorm]() + number);
			return this;
		}
		throw new Error('Invalid unit "' + unit + '": Only ' + Object.keys(unitMap).join(', ') + ' are allowed.');
	},

	/**
	 * Subtracts a given number of minutes, hours, days, months or years to the date.
	 * This is done in-place. The modified date object is also returned, allowing chaining.
	 * @param {number} number - should be an integer
	 * @param {string} unit
	 * @throws {Error} if invalid or unsupported unit is given
	 * @returns {Morebits.date}
	 */
	subtract: function(number, unit) {
		return this.add(-number, unit);
	},

	/**
	 * Formats the date into a string per the given format string.
	 * Replacement syntax is a subset of that in moment.js.
	 * @param {string} formatstr
	 * @param {(string|number)} [zone=system] - 'system' (for browser-default time zone),
	 * 'utc' (for UTC), or specify a time zone as number of minutes past UTC.
	 * @returns {string}
	 */
	format: function(formatstr, zone) {
		var udate = this;
		// create a new date object that will contain the date to display as system time
		if (zone === 'utc') {
			udate = new Morebits.date(this.getTime()).add(this.getTimezoneOffset(), 'minutes');
		} else if (typeof zone === 'number') {
			// convert to utc, then add the utc offset given
			udate = new Morebits.date(this.getTime()).add(this.getTimezoneOffset() + zone, 'minutes');
		}

		var pad = function(num) {
			return num < 10 ? '0' + num : num;
		};
		var h24 = udate.getHours(), m = udate.getMinutes(), s = udate.getSeconds();
		var D = udate.getDate(), M = udate.getMonth() + 1, Y = udate.getFullYear();
		var h12 = h24 % 12 || 12, amOrPm = h24 >= 12 ? 'PM' : 'AM';
		var replacementMap = {
			'HH': pad(h24), 'H': h24, 'hh': pad(h12), 'h': h12, 'A': amOrPm,
			'mm': pad(m), 'm': m,
			'ss': pad(s), 's': s,
			'dddd': udate.getDayName(), 'ddd': udate.getDayNameAbbrev(), 'd': udate.getDay(),
			'DD': pad(D), 'D': D,
			'MMMM': udate.getMonthName(), 'MMM': udate.getMonthNameAbbrev(), 'MM': pad(M), 'M': M,
			'YYYY': Y, 'YY': pad(Y % 100), 'Y': Y
		};

		var unbinder = new Morebits.unbinder(formatstr); // escape stuff between [...]
		unbinder.unbind('\\[', '\\]');
		unbinder.content = unbinder.content.replace(
			/* Regex notes:
			 * d(d{2,3})? matches exactly 1, 3 or 4 occurrences of 'd' ('dd' is treated as a double match of 'd')
			 * Y{1,2}(Y{2})? matches exactly 1, 2 or 4 occurrences of 'Y'
			 */
			/H{1,2}|h{1,2}|m{1,2}|s{1,2}|d(d{2,3})?|D{1,2}|M{1,4}|Y{1,2}(Y{2})?|A/g,
			function(match) {
				return replacementMap[match];
			}
		);
		return unbinder.rebind().replace(/\[(.*?)\]/g, '$1');
	},

	/**
	 * Gives a readable relative time string such as "Yesterday at 6:43 PM" or "Last Thursday at 11:45 AM".
	 * Similar to calendar in moment.js, but with time zone support.
	 * @param {(string|number)} [zone=system] - 'system' (for browser-default time zone),
	 * 'utc' (for UTC), or specify a time zone as number of minutes past UTC
	 * @returns {string}
	 */
	calendar: function(zone) {
		// Zero out the hours, minutes, seconds and milliseconds - keeping only the date;
		// find the difference. Note that setHours() returns the same thing as getTime().
		var dateDiff = (new Date().setHours(0, 0, 0, 0) -
			new Date(this).setHours(0, 0, 0, 0)) / 8.64e7;
		switch (true) {
			case dateDiff === 0:
				return this.format(Morebits.date.localeData.relativeTimes.thisDay, zone);
			case dateDiff === 1:
				return this.format(Morebits.date.localeData.relativeTimes.prevDay, zone);
			case dateDiff > 0 && dateDiff < 7:
				return this.format(Morebits.date.localeData.relativeTimes.pastWeek, zone);
			case dateDiff === -1:
				return this.format(Morebits.date.localeData.relativeTimes.nextDay, zone);
			case dateDiff < 0 && dateDiff > -7:
				return this.format(Morebits.date.localeData.relativeTimes.thisWeek, zone);
			default:
				return this.format(Morebits.date.localeData.relativeTimes.other, zone);
		}
	},

	/**
	 * @returns {RegExp} that matches wikitext section titles such as ==December 2019== or
	 * === Jan 2018 ===
	 */
	monthHeaderRegex: function() {
		return new RegExp('^==+\\s*(?:' + this.getUTCMonthName() + '|' + this.getUTCMonthNameAbbrev() +
			')\\s+' + this.getUTCFullYear() + '\\s*==+', 'mg');
	},

	/**
	 * Creates a wikitext section header with the month and year.
	 * @param {number} [level=2] - Header level (default 2)
	 * @returns {string}
	 */
	monthHeader: function(level) {
		level = level || 2;
		var header = Array(level + 1).join('='); // String.prototype.repeat not supported in IE 11
		return header + ' ' + this.getUTCMonthName() + ' ' + this.getUTCFullYear() + ' ' + header;
	}

});


/**
 * **************** Morebits.wiki ****************
 * Various objects for wiki editing and API access
 */
Morebits.wiki = {};

/**
 * Determines whether the current page is a redirect or soft redirect
 * (fails to detect soft redirects on edit, history, etc. pages)
 * @returns {boolean}
 */
Morebits.wiki.isPageRedirect = function wikipediaIsPageRedirect() {
	return !!(mw.config.get('wgIsRedirect') || document.getElementById('softredirect'));
};



/**
 * **************** Morebits.wiki.actionCompleted ****************
 *
 *    Use of Morebits.wiki.actionCompleted():
 *    Every call to Morebits.wiki.api.post() results in the dispatch of
 *    an asynchronous callback. Each callback can in turn
 *    make an additional call to Morebits.wiki.api.post() to continue a
 *    processing sequence. At the conclusion of the final callback
 *    of a processing sequence, it is not possible to simply return to the
 *    original caller because there is no call stack leading back to
 *    the original context. Instead, Morebits.wiki.actionCompleted.event() is
 *    called to display the result to the user and to perform an optional
 *    page redirect.
 *
 *    The determination of when to call Morebits.wiki.actionCompleted.event()
 *    is managed through the globals Morebits.wiki.numberOfActionsLeft and
 *    Morebits.wiki.nbrOfCheckpointsLeft. Morebits.wiki.numberOfActionsLeft is
 *    incremented at the start of every Morebits.wiki.api call and decremented
 *    after the completion of a callback function. If a callback function
 *    does not create a new Morebits.wiki.api object before exiting, it is the
 *    final step in the processing chain and Morebits.wiki.actionCompleted.event()
 *    will then be called.
 *
 *    Optionally, callers may use Morebits.wiki.addCheckpoint() to indicate that
 *    processing is not complete upon the conclusion of the final callback function.
 *    This is used for batch operations. The end of a batch is signaled by calling
 *    Morebits.wiki.removeCheckpoint().
 */

Morebits.wiki.numberOfActionsLeft = 0;
Morebits.wiki.nbrOfCheckpointsLeft = 0;

Morebits.wiki.actionCompleted = function(self) {
	if (--Morebits.wiki.numberOfActionsLeft <= 0 && Morebits.wiki.nbrOfCheckpointsLeft <= 0) {
		Morebits.wiki.actionCompleted.event(self);
	}
};

// Change per action wanted
Morebits.wiki.actionCompleted.event = function() {
	if (Morebits.wiki.actionCompleted.notice) {
		Morebits.status.actionCompleted(Morebits.wiki.actionCompleted.notice);
	}
	if (Morebits.wiki.actionCompleted.redirect) {
		// if it isn't a URL, make it one. TODO: This breaks on the articles 'http://', 'ftp://', and similar ones.
		if (!(/^\w+:\/\//).test(Morebits.wiki.actionCompleted.redirect)) {
			Morebits.wiki.actionCompleted.redirect = mw.util.getUrl(Morebits.wiki.actionCompleted.redirect);
			if (Morebits.wiki.actionCompleted.followRedirect === false) {
				Morebits.wiki.actionCompleted.redirect += '?redirect=no';
			}
		}
		window.setTimeout(function() {
			window.location = Morebits.wiki.actionCompleted.redirect;
		}, Morebits.wiki.actionCompleted.timeOut);
	}
};

Morebits.wiki.actionCompleted.timeOut = typeof window.wpActionCompletedTimeOut === 'undefined' ? 5000 : window.wpActionCompletedTimeOut;
Morebits.wiki.actionCompleted.redirect = null;
Morebits.wiki.actionCompleted.notice = null;

Morebits.wiki.addCheckpoint = function() {
	++Morebits.wiki.nbrOfCheckpointsLeft;
};

Morebits.wiki.removeCheckpoint = function() {
	if (--Morebits.wiki.nbrOfCheckpointsLeft <= 0 && Morebits.wiki.numberOfActionsLeft <= 0) {
		Morebits.wiki.actionCompleted.event();
	}
};

/**
 * **************** Morebits.wiki.api ****************
 * An easy way to talk to the MediaWiki API.
 */

/**
 * In new code, the use of the last 3 parameters should be avoided, instead use setStatusElement() to bind the
 * status element (if needed) and use .then() or .catch() on the promise returned by post(), rather than specify
 * the onSuccess or onFailure callbacks.
 * @constructor
 * @param {string} currentAction - The current action (required)
 * @param {Object} query - The query (required)
 * @param {Function} [onSuccess] - The function to call when request gotten
 * @param {Morebits.status} [statusElement] - A Morebits.status object to use for status messages (optional)
 * @param {Function} [onError] - The function to call if an error occurs (optional)
 */
Morebits.wiki.api = function(currentAction, query, onSuccess, statusElement, onError) {
	this.currentAction = currentAction;
	this.query = query;
	this.query.assert = 'user';
	this.onSuccess = onSuccess;
	this.onError = onError;
	if (statusElement) {
		this.setStatusElement(statusElement);
	} else {
		this.statelem = new Morebits.status(currentAction);
	}
	if (!query.format) {
		this.query.format = 'xml';
	} else if (['xml', 'json'].indexOf(query.format) === -1) {
		this.statelem.error('Invalid API format: only xml and json are supported.');
	}
};

Morebits.wiki.api.prototype = {
	currentAction: '',
	onSuccess: null,
	onError: null,
	parent: window,  // use global context if there is no parent object
	query: null,
	response: null,
	responseXML: null,  // use `response` instead; retained for backwards compatibility
	statelem: null,  // this non-standard name kept for backwards compatibility
	statusText: null, // result received from the API, normally "success" or "error"
	errorCode: null, // short text error code, if any, as documented in the MediaWiki API
	errorText: null, // full error description, if any

	/**
	 * Keep track of parent object for callbacks
	 * @param {*} parent
     */
	setParent: function(parent) {
		this.parent = parent;
	},

	/** @param {Morebits.status} statusElement */
	setStatusElement: function(statusElement) {
		this.statelem = statusElement;
		this.statelem.status(this.currentAction);
	},

	/**
	 * Carries out the request.
	 * @param {Object} callerAjaxParameters Do not specify a parameter unless you really
	 * really want to give jQuery some extra parameters
	 * @returns {promise} - a jQuery promise object that is resolved or rejected with the api object.
	 */
	post: function(callerAjaxParameters) {

		++Morebits.wiki.numberOfActionsLeft;

		var queryString = $.map(this.query, function(val, i) {
			if (Array.isArray(val)) {
				return encodeURIComponent(i) + '=' + val.map(encodeURIComponent).join('|');
			} else if (val !== undefined) {
				return encodeURIComponent(i) + '=' + encodeURIComponent(val);
			}
		}).join('&').replace(/^(.*?)(\btoken=[^&]*)&(.*)/, '$1$3&$2');
		// token should always be the last item in the query string (bug TW-B-0013)

		var ajaxparams = $.extend({}, {
			context: this,
			type: 'POST',
			url: mw.util.wikiScript('api'),
			data: queryString,
			dataType: 'xml',
			headers: {
				'Api-User-Agent': morebitsWikiApiUserAgent
			}
		}, callerAjaxParameters);

		return $.ajax(ajaxparams).then(

			function onAPIsuccess(response, statusText) {
				this.statusText = statusText;
				this.response = this.responseXML = response;
				if (this.query.format === 'json') {
					this.errorCode = response.error && response.error.code;
					this.errorText = response.error && response.error.info;
				} else {
					this.errorCode = $(response).find('error').attr('code');
					this.errorText = $(response).find('error').attr('info');
				}

				if (typeof this.errorCode === 'string') {
					// the API didn't like what we told it, e.g., bad edit token or an error creating a page
					return this.returnError();
				}

				// invoke success callback if one was supplied
				if (this.onSuccess) {
					// set the callback context to this.parent for new code and supply the API object
					// as the first argument to the callback (for legacy code)
					this.onSuccess.call(this.parent, this);
				} else {
					this.statelem.info('done');
				}

				Morebits.wiki.actionCompleted();

				return $.Deferred().resolveWith(this.parent, [this]);
			},

			// only network and server errors reach here - complaints from the API itself are caught in success()
			function onAPIfailure(jqXHR, statusText, errorThrown) {
				this.statusText = statusText;
				this.errorThrown = errorThrown; // frequently undefined
				this.errorText = statusText + ' "' + jqXHR.statusText + '" occurred while contacting the API.';
				return this.returnError();
			}

		);
	},

	returnError: function() {
		if (this.errorCode === 'badtoken') {
			// TODO: automatically retry after getting a new token
			this.statelem.error('Invalid token. Refresh the page and try again');
		} else {
			this.statelem.error(this.errorText);
		}

		// invoke failure callback if one was supplied
		if (this.onError) {

			// set the callback context to this.parent for new code and supply the API object
			// as the first argument to the callback for legacy code
			this.onError.call(this.parent, this);
		}
		// don't complete the action so that the error remains displayed

		return $.Deferred().rejectWith(this.parent, [this]);
	},

	getStatusElement: function() {
		return this.statelem;
	},

	getErrorCode: function() {
		return this.errorCode;
	},

	getErrorText: function() {
		return this.errorText;
	},

	getXML: function() { // retained for backwards compatibility, use getResponse() instead
		return this.responseXML;
	},

	getResponse: function() {
		return this.response;
	}

};

// Custom user agent header, used by WMF for server-side logging
// See https://lists.wikimedia.org/pipermail/mediawiki-api-announce/2014-November/000075.html
var morebitsWikiApiUserAgent = 'morebits.js/2.0 ([[w:WT:TW]])';

/**
 * Sets the custom user agent header
 * @param {string} ua   User agent
 */
Morebits.wiki.api.setApiUserAgent = function(ua) {
	morebitsWikiApiUserAgent = (ua ? ua + ' ' : '') + 'morebits.js/2.0 ([[w:WT:TW]])';
};



/**
 * **************** Morebits.wiki.page ****************
 * Uses the MediaWiki API to load a page and optionally edit it, move it, etc.
 *
 * Callers are not permitted to directly access the properties of this class!
 * All property access is through the appropriate get___() or set___() method.
 *
 * Callers should set Morebits.wiki.actionCompleted.notice and Morebits.wiki.actionCompleted.redirect
 * before the first call to Morebits.wiki.page.load().
 *
 * Each of the callback functions takes one parameter, which is a
 * reference to the Morebits.wiki.page object that registered the callback.
 * Callback functions may invoke any Morebits.wiki.page prototype method using this reference.
 *
 *
 * HIGHLIGHTS:
 *
 * Constructor: Morebits.wiki.page(pageName, currentAction)
 *    pageName - the name of the page, prefixed by the namespace (if any)
 *               (for the current page, use mw.config.get('wgPageName'))
 *    currentAction - a string describing the action about to be undertaken (optional)
 *
 * onSuccess and onFailure are callback functions called when the operation is a success or failure
 * if enclosed in [brackets], it indicates that it is optional
 *
 * load(onSuccess, [onFailure]): Loads the text for the page
 *
 * getPageText(): returns a string containing the text of the page after a successful load()
 *
 * save([onSuccess], [onFailure]):  Saves the text set via setPageText() for the page.
 * Must be preceded by calling load().
 *    Warning: Calling save() can result in additional calls to the previous load() callbacks to
 *             recover from edit conflicts!
 *             In this case, callers must make the same edit to the new pageText and reinvoke save().
 *             This behavior can be disabled with setMaxConflictRetries(0).
 *
 * append([onSuccess], [onFailure]): Adds the text provided via setAppendText() to the end of
 * the page. Does not require calling load() first.
 *
 * prepend([onSuccess], [onFailure]): Adds the text provided via setPrependText() to the start
 * of the page. Does not require calling load() first.
 *
 * move([onSuccess], [onFailure]): Moves a page to another title
 *
 * patrol(): Patrols a page; ignores errors
 *
 * triage(): Marks page as reviewed using PageTriage, which implies patrolled; ignores most errors
 *
 * deletePage([onSuccess], [onFailure]): Deletes a page (for admins only)
 *
 * undeletePage([onSuccess], [onFailure]): Undeletes a page (for admins only)
 *
 * protect([onSuccess], [onFailure]): Protects a page
 *
 * getPageName(): returns a string containing the name of the loaded page, including the namespace
 *
 * setPageText(pageText) sets the updated page text that will be saved when save() is called
 *
 * setAppendText(appendText) sets the text that will be appended to the page when append() is called
 *
 * setPrependText(prependText) sets the text that will be prepended to the page when prepend() is called
 *
 * setCallbackParameters(callbackParameters)
 *    callbackParameters - an object for use in a callback function
 *
 * getCallbackParameters(): returns the object previous set by setCallbackParameters()
 *
 *    Callback notes: callbackParameters is for use by the caller only. The parameters
 *                    allow a caller to pass the proper context into its callback function.
 *                    Callers must ensure that any changes to the callbackParameters object
 *                    within a load() callback still permit a proper re-entry into the
 *                    load() callback if an edit conflict is detected upon calling save().
 *
 * getStatusElement(): returns the Status element created by the constructor
 *
 * exists(): returns true if the page existed on the wiki when it was last loaded
 *
 * getCurrentID(): returns a string containing the current revision ID of the page
 *
 * lookupCreation(onSuccess): Retrieves the username and timestamp of page creation
 *    onSuccess - callback function which is called when the username and timestamp
 *                are found within the callback.
 *                The username can be retrieved using the getCreator() function;
 *                the timestamp can be retrieved using the getCreationTimestamp() function
 *
 * getCreator(): returns the user who created the page following lookupCreation()
 *
 * getCreationTimestamp(): returns an ISOString timestamp of page creation following lookupCreation()
 *
 */

/**
 * Call sequence for common operations (optional final user callbacks not shown):
 *
 *    Edit current contents of a page (no edit conflict):
 *       .load(userTextEditCallback) -> ctx.loadApi.post() -> ctx.loadApi.post.success() ->
 *             ctx.fnLoadSuccess() -> userTextEditCallback() -> .save() ->
 *             ctx.saveApi.post() -> ctx.loadApi.post.success() -> ctx.fnSaveSuccess()
 *
 *    Edit current contents of a page (with edit conflict):
 *       .load(userTextEditCallback) -> ctx.loadApi.post() -> ctx.loadApi.post.success() ->
 *             ctx.fnLoadSuccess() -> userTextEditCallback() -> .save() ->
 *             ctx.saveApi.post() -> ctx.loadApi.post.success() -> ctx.fnSaveError() ->
 *             ctx.loadApi.post() -> ctx.loadApi.post.success() ->
 *             ctx.fnLoadSuccess() -> userTextEditCallback() -> .save() ->
 *             ctx.saveApi.post() -> ctx.loadApi.post.success() -> ctx.fnSaveSuccess()
 *
 *    Append to a page (similar for prepend):
 *       .append() -> ctx.loadApi.post() -> ctx.loadApi.post.success() ->
 *             ctx.fnLoadSuccess() -> ctx.fnAutoSave() -> .save() ->
 *             ctx.saveApi.post() -> ctx.loadApi.post.success() -> ctx.fnSaveSuccess()
 *
 *    Notes:
 *       1. All functions following Morebits.wiki.api.post() are invoked asynchronously
 *          from the jQuery AJAX library.
 *       2. The sequence for append/prepend could be slightly shortened, but it would require
 *          significant duplication of code for little benefit.
 */

/**
 * @constructor
 * @param {string} pageName The name of the page, prefixed by the namespace (if any)
 * For the current page, use mw.config.get('wgPageName')
 * @param {string} [currentAction] A string describing the action about to be undertaken (optional)
 */
Morebits.wiki.page = function(pageName, currentAction) {

	if (!currentAction) {
		currentAction = 'Opening page "' + pageName + '"';
	}

	/**
	 * Private context variables
	 *
	 * This context is not visible to the outside, thus all the data here
	 * must be accessed via getter and setter functions.
	 */
	var ctx = {
		// backing fields for public properties
		pageName: pageName,
		pageExists: false,
		editSummary: null,
		callbackParameters: null,
		statusElement: new Morebits.status(currentAction),

		// - edit
		pageText: null,
		editMode: 'all',  // save() replaces entire contents of the page by default
		appendText: null,   // can't reuse pageText for this because pageText is needed to follow a redirect
		prependText: null,  // can't reuse pageText for this because pageText is needed to follow a redirect
		createOption: null,
		minorEdit: false,
		botEdit: false,
		pageSection: null,
		maxConflictRetries: 2,
		maxRetries: 2,
		followRedirect: false,
		watchlistOption: 'nochange',
		creator: null,
		timestamp: null,

		// - revert
		revertOldID: null,

		// - move
		moveDestination: null,
		moveTalkPage: false,
		moveSubpages: false,
		moveSuppressRedirect: false,

		// - protect
		protectEdit: null,
		protectMove: null,
		protectCreate: null,
		protectCascade: false,

		// - creation lookup
		lookupNonRedirectCreator: false,

		// - stabilize (FlaggedRevs)
		flaggedRevs: null,

		// internal status
		pageLoaded: false,
		csrfToken: null,
		loadTime: null,
		lastEditTime: null,
		pageID: null,
		revertCurID: null,
		revertUser: null,
		fullyProtected: false,
		suppressProtectWarning: false,
		conflictRetries: 0,
		retries: 0,

		// callbacks
		onLoadSuccess: null,
		onLoadFailure: null,
		onSaveSuccess: null,
		onSaveFailure: null,
		onLookupCreationSuccess: null,
		onMoveSuccess: null,
		onMoveFailure: null,
		onDeleteSuccess: null,
		onDeleteFailure: null,
		onUndeleteSuccess: null,
		onUndeleteFailure: null,
		onProtectSuccess: null,
		onProtectFailure: null,
		onStabilizeSuccess: null,
		onStabilizeFailure: null,

		// internal objects
		loadQuery: null,
		loadApi: null,
		saveApi: null,
		lookupCreationApi: null,
		moveApi: null,
		moveProcessApi: null,
		patrolApi: null,
		patrolProcessApi: null,
		triageApi: null,
		triageProcessApi: null,
		deleteApi: null,
		deleteProcessApi: null,
		undeleteApi: null,
		undeleteProcessApi: null,
		protectApi: null,
		protectProcessApi: null,
		stabilizeApi: null,
		stabilizeProcessApi: null
	};

	var emptyFunction = function() { };

	/**
	 * Loads the text for the page
	 * @param {Function} onSuccess - callback function which is called when the load has succeeded
	 * @param {Function} [onFailure] - callback function which is called when the load fails (optional)
	 */
	this.load = function(onSuccess, onFailure) {
		ctx.onLoadSuccess = onSuccess;
		ctx.onLoadFailure = onFailure || emptyFunction;

		// Need to be able to do something after the page loads
		if (!onSuccess) {
			ctx.statusElement.error('Internal error: no onSuccess callback provided to load()!');
			ctx.onLoadFailure(this);
			return;
		}

		ctx.loadQuery = {
			action: 'query',
			prop: 'info|revisions',
			curtimestamp: '',
			meta: 'tokens',
			type: 'csrf',
			titles: ctx.pageName
			// don't need rvlimit=1 because we don't need rvstartid here and only one actual rev is returned by default
		};

		if (ctx.editMode === 'all') {
			ctx.loadQuery.rvprop = 'content|timestamp';  // get the page content at the same time, if needed
		} else if (ctx.editMode === 'revert') {
			ctx.loadQuery.rvprop = 'timestamp';
			ctx.loadQuery.rvlimit = 1;
			ctx.loadQuery.rvstartid = ctx.revertOldID;
		}

		if (ctx.followRedirect) {
			ctx.loadQuery.redirects = '';  // follow all redirects
		}
		if (typeof ctx.pageSection === 'number') {
			ctx.loadQuery.rvsection = ctx.pageSection;
		}
		if (Morebits.userIsSysop) {
			ctx.loadQuery.inprop = 'protection';
		}

		ctx.loadApi = new Morebits.wiki.api('Retrieving page...', ctx.loadQuery, fnLoadSuccess, ctx.statusElement, ctx.onLoadFailure);
		ctx.loadApi.setParent(this);
		ctx.loadApi.post();
	};

	/**
	 * Saves the text for the page to Wikipedia
	 * Must be preceded by successfully calling load().
	 *
	 * Warning: Calling save() can result in additional calls to the previous load() callbacks
	 * to recover from edit conflicts!
	 * In this case, callers must make the same edit to the new pageText and reinvoke save().
	 * This behavior can be disabled with setMaxConflictRetries(0).
	 * @param {Function} [onSuccess] - callback function which is called when the save has
	 * succeeded (optional)
	 * @param {Function} [onFailure] - callback function which is called when the save fails
	 * (optional)
	 */
	this.save = function(onSuccess, onFailure) {
		ctx.onSaveSuccess = onSuccess;
		ctx.onSaveFailure = onFailure || emptyFunction;

		// are we getting our editing token from mw.user.tokens?
		var canUseMwUserToken = fnCanUseMwUserToken('edit');

		if (!ctx.pageLoaded && !canUseMwUserToken) {
			ctx.statusElement.error('Internal error: attempt to save a page that has not been loaded!');
			ctx.onSaveFailure(this);
			return;
		}
		if (!ctx.editSummary) {
			ctx.statusElement.error('Internal error: edit summary not set before save!');
			ctx.onSaveFailure(this);
			return;
		}

		// shouldn't happen if canUseMwUserToken === true
		if (ctx.fullyProtected && !ctx.suppressProtectWarning &&
			!confirm('You are about to make an edit to the fully protected page "' + ctx.pageName +
			(ctx.fullyProtected === 'infinity' ? '" (protected indefinitely)' : '" (protection expiring ' + new Morebits.date(ctx.fullyProtected).calendar('utc') + ' (UTC))') +
			'.  \n\nClick OK to proceed with the edit, or Cancel to skip this edit.')) {
			ctx.statusElement.error('Edit to fully protected page was aborted.');
			ctx.onSaveFailure(this);
			return;
		}

		ctx.retries = 0;

		var query = {
			action: 'edit',
			title: ctx.pageName,
			summary: ctx.editSummary,
			token: canUseMwUserToken ? mw.user.tokens.get('csrfToken') : ctx.csrfToken,
			watchlist: ctx.watchlistOption
		};

		if (typeof ctx.pageSection === 'number') {
			query.section = ctx.pageSection;
		}

		// Set minor edit attribute. If these parameters are present with any value, it is interpreted as true
		if (ctx.minorEdit) {
			query.minor = true;
		} else {
			query.notminor = true;  // force Twinkle config to override user preference setting for "all edits are minor"
		}

		// Set bot edit attribute. If this paramter is present with any value, it is interpreted as true
		if (ctx.botEdit) {
			query.bot = true;
		}

		switch (ctx.editMode) {
			case 'append':
				query.appendtext = ctx.appendText;  // use mode to append to current page contents
				break;
			case 'prepend':
				query.prependtext = ctx.prependText;  // use mode to prepend to current page contents
				break;
			case 'revert':
				query.undo = ctx.revertCurID;
				query.undoafter = ctx.revertOldID;
				if (ctx.lastEditTime) {
					query.basetimestamp = ctx.lastEditTime; // check that page hasn't been edited since it was loaded
				}
				query.starttimestamp = ctx.loadTime; // check that page hasn't been deleted since it was loaded (don't recreate bad stuff)
				break;
			default: // 'all'
				query.text = ctx.pageText; // replace entire contents of the page
				if (ctx.lastEditTime) {
					query.basetimestamp = ctx.lastEditTime; // check that page hasn't been edited since it was loaded
				}
				query.starttimestamp = ctx.loadTime; // check that page hasn't been deleted since it was loaded (don't recreate bad stuff)
				break;
		}

		if (['recreate', 'createonly', 'nocreate'].indexOf(ctx.createOption) !== -1) {
			query[ctx.createOption] = '';
		}

		if (canUseMwUserToken && ctx.followRedirect) {
			query.redirect = true;
		}

		ctx.saveApi = new Morebits.wiki.api('Saving page...', query, fnSaveSuccess, ctx.statusElement, fnSaveError);
		ctx.saveApi.setParent(this);
		ctx.saveApi.post();
	};

	/**
	 * Adds the text provided via setAppendText() to the end of the page.
	 * Does not require calling load() first.
	 * @param {Function} [onSuccess] - callback function which is called when the method has succeeded (optional)
	 * @param {Function} [onFailure] - callback function which is called when the method fails (optional)
	 */
	this.append = function(onSuccess, onFailure) {
		ctx.editMode = 'append';

		if (fnCanUseMwUserToken('edit')) {
			this.save(onSuccess, onFailure);
		} else {
			ctx.onSaveSuccess = onSuccess;
			ctx.onSaveFailure = onFailure || emptyFunction;
			this.load(fnAutoSave, ctx.onSaveFailure);
		}
	};

	/**
	 * Adds the text provided via setPrependText() to the start of the page.
	 * Does not require calling load() first.
	 * @param {Function}  [onSuccess] - callback function which is called when the method has succeeded (optional)
	 * @param {Function}  [onFailure] - callback function which is called when the method fails (optional)
	 */
	this.prepend = function(onSuccess, onFailure) {
		ctx.editMode = 'prepend';

		if (fnCanUseMwUserToken('edit')) {
			this.save(onSuccess, onFailure);
		} else {
			ctx.onSaveSuccess = onSuccess;
			ctx.onSaveFailure = onFailure || emptyFunction;
			this.load(fnAutoSave, ctx.onSaveFailure);
		}
	};

	/** @returns {string} string containing the name of the loaded page, including the namespace */
	this.getPageName = function() {
		return ctx.pageName;
	};

	/** @returns {string} string containing the text of the page after a successful load() */
	this.getPageText = function() {
		return ctx.pageText;
	};

	/** @param {string} pageText - updated page text that will be saved when save() is called */
	this.setPageText = function(pageText) {
		ctx.editMode = 'all';
		ctx.pageText = pageText;
	};

	/** @param {string} appendText - text that will be appended to the page when append() is called */
	this.setAppendText = function(appendText) {
		ctx.editMode = 'append';
		ctx.appendText = appendText;
	};

	/** @param {string} prependText - text that will be prepended to the page when prepend() is called */
	this.setPrependText = function(prependText) {
		ctx.editMode = 'prepend';
		ctx.prependText = prependText;
	};



	// Edit-related setter methods:
	/** @param {string} summary - text of the edit summary that will be used when save() is called */
	this.setEditSummary = function(summary) {
		ctx.editSummary = summary;
	};

	/**
	 * @param {string} createOption - can take the following four values:
	 *     `recreate`   - create the page if it does not exist, or edit it if it exists.
	 *     `createonly` - create the page if it does not exist, but return an error if it
	 *                    already exists.
	 *     `nocreate`   - don't create the page, only edit it if it already exists.
	 *     null         - create the page if it does not exist, unless it was deleted in the moment
	 *                    between loading the page and saving the edit (default)
	 *
	 */
	this.setCreateOption = function(createOption) {
		ctx.createOption = createOption;
	};

	/** @param {boolean} minorEdit - set true to mark the edit as a minor edit. */
	this.setMinorEdit = function(minorEdit) {
		ctx.minorEdit = minorEdit;
	};

	/** @param {boolean} botEdit - set true to mark the edit as a bot edit */
	this.setBotEdit = function(botEdit) {
		ctx.botEdit = botEdit;
	};

	/**
	 * @param {number} pageSection - integer specifying the section number to load or save.
	 * If specified as `null`, the entire page will be retrieved.
	 */
	this.setPageSection = function(pageSection) {
		ctx.pageSection = pageSection;
	};

	/**
	 * @param {number} maxConflictRetries - number of retries for save errors involving an edit conflict or
	 * loss of token. Default: 2
	 */
	this.setMaxConflictRetries = function(maxConflictRetries) {
		ctx.maxConflictRetries = maxConflictRetries;
	};

	/**
	 * @param {number} maxRetries - number of retries for save errors not involving an edit conflict or
	 * loss of token. Default: 2
	 */
	this.setMaxRetries = function(maxRetries) {
		ctx.maxRetries = maxRetries;
	};

	/**
	 * @param {boolean} watchlistOption
	 *     True  - page will be added to the user's watchlist when save() is called
	 *     False - watchlist status of the page will not be changed (default)
	 */
	this.setWatchlist = function(watchlistOption) {
		if (watchlistOption) {
			ctx.watchlistOption = 'watch';
		} else {
			ctx.watchlistOption = 'nochange';
		}
	};

	/**
	 * @param {boolean} watchlistOption
	 *     True  - page watchlist status will be set based on the user's
	 *             preference settings when save() is called.
	 *     False - watchlist status of the page will not be changed (default)
	 *
	 *    Watchlist notes:
	 *       1. The MediaWiki API value of 'unwatch', which explicitly removes the page from the
	 *          user's watchlist, is not used.
	 *       2. If both setWatchlist() and setWatchlistFromPreferences() are called,
	 *          the last call takes priority.
	 *       3. Twinkle modules should use the appropriate preference to set the watchlist options.
	 *       4. Most Twinkle modules use setWatchlist().
	 *          setWatchlistFromPreferences() is only needed for the few Twinkle watchlist preferences
	 *          that accept a string value of 'default'.
	 */
	this.setWatchlistFromPreferences = function(watchlistOption) {
		if (watchlistOption) {
			ctx.watchlistOption = 'preferences';
		} else {
			ctx.watchlistOption = 'nochange';
		}
	};

	/**
	 * @param {boolean} followRedirect
	 *     true  - a maximum of one redirect will be followed.
	 *             In the event of a redirect, a message is displayed to the user and
	 *             the redirect target can be retrieved with getPageName().
	 *     false - the requested pageName will be used without regard to any redirect (default).
	 */
	this.setFollowRedirect = function(followRedirect) {
		if (ctx.pageLoaded) {
			ctx.statusElement.error('Internal error: cannot change redirect setting after the page has been loaded!');
			return;
		}
		ctx.followRedirect = followRedirect;
	};

	// lookup-creation setter function
	/**
	 * @param {boolean} flag - if set true, the author and timestamp of the first non-redirect
	 * version of the page is retrieved.
	 *
	 * Warning:
	 * 1. If there are no revisions among the first 50 that are non-redirects, or if there are
	 *    less 50 revisions and all are redirects, the original creation is retrived.
	 * 2. Revisions that the user is not privileged to access (revdeled/suppressed) will be treated
	 *    as non-redirects.
	 * 3. Must not be used when the page has a non-wikitext contentmodel
	 *    such as Modulespace Lua or user JavaScript/CSS
	 */
	this.setLookupNonRedirectCreator = function(flag) {
		ctx.lookupNonRedirectCreator = flag;
	};

	// Move-related setter functions
	/** @param {string} destination */
	this.setMoveDestination = function(destination) {
		ctx.moveDestination = destination;
	};

	/** @param {boolean} flag */
	this.setMoveTalkPage = function(flag) {
		ctx.moveTalkPage = !!flag;
	};

	/** @param {boolean} flag */
	this.setMoveSubpages = function(flag) {
		ctx.moveSubpages = !!flag;
	};

	/** @param {boolean} flag */
	this.setMoveSuppressRedirect = function(flag) {
		ctx.moveSuppressRedirect = !!flag;
	};

	// Protect-related setter functions
	this.setEditProtection = function(level, expiry) {
		ctx.protectEdit = { level: level, expiry: expiry };
	};

	this.setMoveProtection = function(level, expiry) {
		ctx.protectMove = { level: level, expiry: expiry };
	};

	this.setCreateProtection = function(level, expiry) {
		ctx.protectCreate = { level: level, expiry: expiry };
	};

	this.setCascadingProtection = function(flag) {
		ctx.protectCascade = !!flag;
	};

	this.suppressProtectWarning = function() {
		ctx.suppressProtectWarning = true;
	};

	// Revert-related getters/setters:
	this.setOldID = function(oldID) {
		ctx.revertOldID = oldID;
	};

	/** @returns {string} string containing the current revision ID of the page */
	this.getCurrentID = function() {
		return ctx.revertCurID;
	};

	/** @returns {string} last editor of the page */
	this.getRevisionUser = function() {
		return ctx.revertUser;
	};

	/** @returns {string} ISO 8601 timestamp at which the page was last edited. */
	this.getLastEditTime = function() {
		return ctx.lastEditTime;
	};

	// Miscellaneous getters/setters:

	/**
	 * `callbackParameters` - an object for use in a callback function
	 *
	 * Callback notes: callbackParameters is for use by the caller only. The parameters
	 * allow a caller to pass the proper context into its callback function.
	 * Callers must ensure that any changes to the callbackParameters object
	 * within a load() callback still permit a proper re-entry into the
	 * load() callback if an edit conflict is detected upon calling save().
	 */
	this.setCallbackParameters = function(callbackParameters) {
		ctx.callbackParameters = callbackParameters;
	};

	/**
	 * @returns the object previous set by setCallbackParameters()
	 */
	this.getCallbackParameters = function() {
		return ctx.callbackParameters;
	};

	/**
	 * @returns {Morebits.status} Status element created by the constructor
	 */
	this.getStatusElement = function() {
		return ctx.statusElement;
	};

	/**
	 * @param {string} level  The right required for edits not to require
	 * review. Possible options: none, autoconfirmed, review (not on enWiki).
	 * @param {string} expiry
	 */
	this.setFlaggedRevs = function(level, expiry) {
		ctx.flaggedRevs = { level: level, expiry: expiry };
	};

	/**
	 * @returns {boolean} true if the page existed on the wiki when it was last loaded
	 */
	this.exists = function() {
		return ctx.pageExists;
	};

	/**
	 * @returns {string} Page ID of the page loaded. 0 if the page doesn't
	 * exist.
	 */
	this.getPageID = function() {
		return ctx.pageID;
	};

	/**
	 * @returns {string} ISO 8601 timestamp at which the page was last loaded
	 */
	this.getLoadTime = function() {
		return ctx.loadTime;
	};

	/**
	 * @returns {string} the user who created the page following lookupCreation()
	 */
	this.getCreator = function() {
		return ctx.creator;
	};

	/**
	 * @returns {string} the ISOString timestamp of page creation following lookupCreation()
	 */
	this.getCreationTimestamp = function() {
		return ctx.timestamp;
	};

	/**
	 * Retrieves the username of the user who created the page as well as
	 * the timestamp of creation
	 * @param {Function} onSuccess - callback function (required) which is
	 * called when the username and timestamp are found within the callback.
	 * The username can be retrieved using the getCreator() function;
	 * the timestamp can be retrieved using the getCreationTimestamp() function
	 * Prior to June 2019 known as lookupCreator
	 */
	this.lookupCreation = function(onSuccess) {
		if (!onSuccess) {
			ctx.statusElement.error('Internal error: no onSuccess callback provided to lookupCreation()!');
			return;
		}
		ctx.onLookupCreationSuccess = onSuccess;

		var query = {
			'action': 'query',
			'prop': 'revisions',
			'titles': ctx.pageName,
			'rvlimit': 1,
			'rvprop': 'user|timestamp',
			'rvdir': 'newer'
		};

		// Only the wikitext content model can reliably handle
		// rvsection, others return an error when paired with the
		// content rvprop. Relatedly, non-wikitext models don't
		// understand the #REDIRECT concept, so we shouldn't attempt
		// the redirect resolution in fnLookupCreationSuccess
		if (ctx.lookupNonRedirectCreator) {
			query.rvsection = 0;
			query.rvprop += '|content';
		}

		if (ctx.followRedirect) {
			query.redirects = '';  // follow all redirects
		}

		ctx.lookupCreationApi = new Morebits.wiki.api('Retrieving page creation information', query, fnLookupCreationSuccess, ctx.statusElement);
		ctx.lookupCreationApi.setParent(this);
		ctx.lookupCreationApi.post();
	};

	/**
	 * Reverts a page to revertOldID
	 * @param {Function} [onSuccess] - callback function to run on success (optional)
	 * @param {Function} [onFailure] - callback function to run on failure (optional)
	 */
	this.revert = function(onSuccess, onFailure) {
		ctx.onSaveSuccess = onSuccess;
		ctx.onSaveFailure = onFailure || emptyFunction;

		if (!ctx.revertOldID) {
			ctx.statusElement.error('Internal error: revision ID to revert to was not set before revert!');
			ctx.onSaveFailure(this);
			return;
		}

		ctx.editMode = 'revert';
		this.load(fnAutoSave, ctx.onSaveFailure);
	};

	/**
	 * Moves a page to another title
	 * @param {Function} [onSuccess] - callback function to run on success (optional)
	 * @param {Function} [onFailure] - callback function to run on failure (optional)
	 */
	this.move = function(onSuccess, onFailure) {
		ctx.onMoveSuccess = onSuccess;
		ctx.onMoveFailure = onFailure || emptyFunction;

		if (!ctx.editSummary) {
			ctx.statusElement.error('Internal error: move reason not set before move (use setEditSummary function)!');
			ctx.onMoveFailure(this);
			return;
		}
		if (!ctx.moveDestination) {
			ctx.statusElement.error('Internal error: destination page name was not set before move!');
			ctx.onMoveFailure(this);
			return;
		}

		if (fnCanUseMwUserToken('move')) {
			fnProcessMove.call(this, this);
		} else {
			var query = fnNeedTokenInfoQuery('move');

			ctx.moveApi = new Morebits.wiki.api('retrieving token...', query, fnProcessMove, ctx.statusElement, ctx.onMoveFailure);
			ctx.moveApi.setParent(this);
			ctx.moveApi.post();
		}
	};

	/**
	 * Marks the page as patrolled, using rcid (if available) or revid
	 *
	 * Patrolling as such doesn't need to rely on loading the page in
	 * question; simply passing a revid to the API is sufficient, so in
	 * those cases just using Morebits.wiki.api is probably preferable.
	 *
	 * No error handling since we don't actually care about the errors
	 */
	this.patrol = function() {
		if (!Morebits.userIsSysop && !Morebits.userIsInGroup('patroller')) {
			return;
		}

		// If a link is present, don't need to check if it's patrolled
		if ($('.patrollink').length) {
			var patrolhref = $('.patrollink a').attr('href');
			ctx.rcid = mw.util.getParamValue('rcid', patrolhref);
			fnProcessPatrol(this, this);
		} else {
			var patrolQuery = {
				action: 'query',
				prop: 'info',
				meta: 'tokens',
				type: 'patrol', // as long as we're querying, might as well get a token
				list: 'recentchanges', // check if the page is unpatrolled
				titles: ctx.pageName,
				rcprop: 'patrolled',
				rctitle: ctx.pageName,
				rclimit: 1
			};

			ctx.patrolApi = new Morebits.wiki.api('retrieving token...', patrolQuery, fnProcessPatrol);
			ctx.patrolApi.setParent(this);
			ctx.patrolApi.post();
		}
	};

	/**
	 * Marks the page as reviewed by the PageTriage extension
	 * https://www.mediawiki.org/wiki/Extension:PageTriage
	 *
	 * Referred to as "review" on-wiki
	 *
	 * Will, by it's nature, mark as patrolled as well. Falls back to
	 * patrolling if not in an appropriate namespace.
	 *
	 * Doesn't inherently rely on loading the page in question; simply
	 * passing a pageid to the API is sufficient, so in those cases just
	 * using Morebits.wiki.api is probably preferable.
	 *
	 * No error handling since we don't actually care about the errors
	 */
	this.triage = function() {
		// Fall back to patrol if not a valid triage namespace
		if (mw.config.get('pageTriageNamespaces').indexOf(mw.config.get('wgNamespaceNumber')) === -1) {
			this.patrol();
		} else {
			if (!Morebits.userIsSysop && !Morebits.userIsInGroup('patroller')) {
				return;
			}

			// If on the page in question, don't need to query for page ID
			if (new mw.Title(Morebits.pageNameNorm).getPrefixedText() === new mw.Title(ctx.pageName).getPrefixedText()) {
				ctx.pageID = mw.config.get('wgArticleId');
				fnProcessTriage(this, this);
			} else {
				var query = fnNeedTokenInfoQuery('triage');

				ctx.triageApi = new Morebits.wiki.api('retrieving token...', query, fnProcessTriage);
				ctx.triageApi.setParent(this);
				ctx.triageApi.post();
			}
		}
	};

	// |delete| is a reserved word in some flavours of JS
	/**
	 * Deletes a page (for admins only)
	 * @param {Function} [onSuccess] - callback function to run on success (optional)
	 * @param {Function} [onFailure] - callback function to run on failure (optional)
	 */
	this.deletePage = function(onSuccess, onFailure) {
		ctx.onDeleteSuccess = onSuccess;
		ctx.onDeleteFailure = onFailure || emptyFunction;

		// if a non-admin tries to do this, don't bother
		if (!Morebits.userIsSysop) {
			ctx.statusElement.error('Cannot delete page: only admins can do that');
			ctx.onDeleteFailure(this);
			return;
		}
		if (!ctx.editSummary) {
			ctx.statusElement.error('Internal error: delete reason not set before delete (use setEditSummary function)!');
			ctx.onDeleteFailure(this);
			return;
		}

		if (fnCanUseMwUserToken('delete')) {
			fnProcessDelete.call(this, this);
		} else {
			var query = fnNeedTokenInfoQuery('delete');

			ctx.deleteApi = new Morebits.wiki.api('retrieving token...', query, fnProcessDelete, ctx.statusElement, ctx.onDeleteFailure);
			ctx.deleteApi.setParent(this);
			ctx.deleteApi.post();
		}
	};

	/**
	 * Undeletes a page (for admins only)
	 * @param {Function} [onSuccess] - callback function to run on success (optional)
	 * @param {Function} [onFailure] - callback function to run on failure (optional)
	 */
	this.undeletePage = function(onSuccess, onFailure) {
		ctx.onUndeleteSuccess = onSuccess;
		ctx.onUndeleteFailure = onFailure || emptyFunction;

		// if a non-admin tries to do this, don't bother
		if (!Morebits.userIsSysop) {
			ctx.statusElement.error('Cannot undelete page: only admins can do that');
			ctx.onUndeleteFailure(this);
			return;
		}
		if (!ctx.editSummary) {
			ctx.statusElement.error('Internal error: undelete reason not set before undelete (use setEditSummary function)!');
			ctx.onUndeleteFailure(this);
			return;
		}

		if (fnCanUseMwUserToken('undelete')) {
			fnProcessUndelete.call(this, this);
		} else {
			var query = fnNeedTokenInfoQuery('undelete');

			ctx.undeleteApi = new Morebits.wiki.api('retrieving token...', query, fnProcessUndelete, ctx.statusElement, ctx.onUndeleteFailure);
			ctx.undeleteApi.setParent(this);
			ctx.undeleteApi.post();
		}
	};

	/**
	 * Protects a page (for admins only)
	 * @param {Function} [onSuccess] - callback function to run on success (optional)
	 * @param {Function} [onFailure] - callback function to run on failure (optional)
	 */
	this.protect = function(onSuccess, onFailure) {
		ctx.onProtectSuccess = onSuccess;
		ctx.onProtectFailure = onFailure || emptyFunction;

		// if a non-admin tries to do this, don't bother
		if (!Morebits.userIsSysop) {
			ctx.statusElement.error('Cannot protect page: only admins can do that');
			ctx.onProtectFailure(this);
			return;
		}
		if (!ctx.protectEdit && !ctx.protectMove && !ctx.protectCreate) {
			ctx.statusElement.error('Internal error: you must set edit and/or move and/or create protection before calling protect()!');
			ctx.onProtectFailure(this);
			return;
		}
		if (!ctx.editSummary) {
			ctx.statusElement.error('Internal error: protection reason not set before protect (use setEditSummary function)!');
			ctx.onProtectFailure(this);
			return;
		}

		// because of the way MW API interprets protection levels
		// (absolute, not differential), we always need to request
		// protection levels from the server
		var query = fnNeedTokenInfoQuery('protect');

		ctx.protectApi = new Morebits.wiki.api('retrieving token...', query, fnProcessProtect, ctx.statusElement, ctx.onProtectFailure);
		ctx.protectApi.setParent(this);
		ctx.protectApi.post();
	};

	/**
	 * Apply FlaggedRevs protection-style settings
	 * only works where $wgFlaggedRevsProtection = true (i.e. where FlaggedRevs
	 * settings appear on the wiki's "protect" tab)
	 * @param {function} [onSuccess]
	 * @param {function} [onFailure]
	 */
	this.stabilize = function(onSuccess, onFailure) {
		ctx.onStabilizeSuccess = onSuccess;
		ctx.onStabilizeFailure = onFailure || emptyFunction;

		// if a non-admin tries to do this, don't bother
		if (!Morebits.userIsSysop) {
			ctx.statusElement.error('Cannot apply FlaggedRevs settings: only admins can do that');
			ctx.onStabilizeFailure(this);
			return;
		}
		if (!ctx.flaggedRevs) {
			ctx.statusElement.error('Internal error: you must set flaggedRevs before calling stabilize()!');
			ctx.onStabilizeFailure(this);
			return;
		}
		if (!ctx.editSummary) {
			ctx.statusElement.error('Internal error: reason not set before calling stabilize() (use setEditSummary function)!');
			ctx.onStabilizeFailure(this);
			return;
		}

		if (fnCanUseMwUserToken('stabilize')) {
			fnProcessStabilize.call(this, this);
		} else {
			var query = fnNeedTokenInfoQuery('stabilize');

			ctx.stabilizeApi = new Morebits.wiki.api('retrieving token...', query, fnProcessStabilize, ctx.statusElement, ctx.onStabilizeFailure);
			ctx.stabilizeApi.setParent(this);
			ctx.stabilizeApi.post();
		}
	};

	/*
	 * Private member functions
	 * These are not exposed outside
	 */

	/**
	 * Determines whether we can save an API call by using the csrf token sent with the page
	 * HTML, or whether we need to ask the server for more info (e.g. protection expiry).
	 *
	 * Only applicable for csrf token actions, e.g. not patrol
	 *
	 * Currently used for append, prepend, deletePage, undeletePage, move,
	 * and stabilize.  Can't use for protect since it always needs to
	 * request protection status.
	 *
	 * @param {string} [action=edit]  The action being undertaken, e.g.
	 * "edit" or "delete". In practice, only "edit" or "notedit" matters.
	 * @returns {boolean}
	 */
	var fnCanUseMwUserToken = function(action) {
		action = typeof action !== 'undefined' ? action : 'edit'; // IE doesn't support default parameters

		// API-based redirect resolution only works for action=query and
		// action=edit in append/prepend modes (and section=new, but we don't
		// really support that)
		if (ctx.followRedirect && (action !== 'edit' ||
			(ctx.editMode !== 'append' && ctx.editMode !== 'prepend'))) {
			return false;
		}

		// do we need to fetch the edit protection expiry?
		if (Morebits.userIsSysop && !ctx.suppressProtectWarning) {
			if (new mw.Title(Morebits.pageNameNorm).getPrefixedText() === new mw.Title(ctx.pageName).getPrefixedText()) {
				return false;
			}

			// wgRestrictionEdit is null on non-existent pages,
			// so this neatly handles nonexistent pages
			var editRestriction = mw.config.get('wgRestrictionEdit');
			if (!editRestriction || editRestriction.indexOf('sysop') !== -1) {
				return false;
			}
		}

		return !!mw.user.tokens.get('csrfToken');
	};

	/**
	 * When functions can't use fnCanUseMwUserToken or require checking
	 * protection, maintain the query in one place. Used for delete,
	 * undelete, protect, stabilize, and move (basically, just not load)
	 *
	 * @param {string} action  The action being undertaken, e.g. "edit" or
	 * "delete"
	 */
	var fnNeedTokenInfoQuery = function(action) {
		var query = {
			action: 'query',
			meta: 'tokens',
			type: 'csrf',
			titles: ctx.pageName
		};
		// Protection not checked for flagged-revs or non-sysop moves
		if (action !== 'stabilize' && (action !== 'move' || Morebits.userIsSysop)) {
			query.prop = 'info';
			query.inprop = 'protection';
		}
		if (ctx.followRedirect && action !== 'undelete') {
			query.redirects = ''; // follow all redirects
		}
		return query;
	};

	// callback from loadSuccess() for append() and prepend() threads
	var fnAutoSave = function(pageobj) {
		pageobj.save(ctx.onSaveSuccess, ctx.onSaveFailure);
	};

	// callback from loadApi.post()
	var fnLoadSuccess = function() {
		var xml = ctx.loadApi.getXML();

		if (!fnCheckPageName(xml, ctx.onLoadFailure)) {
			return; // abort
		}

		ctx.pageExists = $(xml).find('page').attr('missing') !== '';
		if (ctx.pageExists) {
			ctx.pageText = $(xml).find('rev').text();
			ctx.pageID = $(xml).find('page').attr('pageid');
		} else {
			ctx.pageText = '';  // allow for concatenation, etc.
			ctx.pageID = 0; // nonexistent in response, matches wgArticleId
		}
		ctx.csrfToken = $(xml).find('tokens').attr('csrftoken');
		if (!ctx.csrfToken) {
			ctx.statusElement.error('Failed to retrieve edit token.');
			ctx.onLoadFailure(this);
			return;
		}
		ctx.loadTime = $(xml).find('api').attr('curtimestamp');
		if (!ctx.loadTime) {
			ctx.statusElement.error('Failed to retrieve current timestamp.');
			ctx.onLoadFailure(this);
			return;
		}

		// extract protection info, to alert admins when they are about to edit a protected page
		if (Morebits.userIsSysop) {
			var editprot = $(xml).find('pr[type="edit"]');
			if (editprot.length > 0 && editprot.attr('level') === 'sysop') {
				ctx.fullyProtected = editprot.attr('expiry');
			} else {
				ctx.fullyProtected = false;
			}
		}

		ctx.lastEditTime = $(xml).find('rev').attr('timestamp');
		ctx.revertCurID = $(xml).find('page').attr('lastrevid');

		if (ctx.editMode === 'revert') {
			ctx.revertCurID = $(xml).find('rev').attr('revid');
			if (!ctx.revertCurID) {
				ctx.statusElement.error('Failed to retrieve current revision ID.');
				ctx.onLoadFailure(this);
				return;
			}
			ctx.revertUser = $(xml).find('rev').attr('user');
			if (!ctx.revertUser) {
				if ($(xml).find('rev').attr('userhidden') === '') {  // username was RevDel'd or oversighted
					ctx.revertUser = '<username hidden>';
				} else {
					ctx.statusElement.error('Failed to retrieve user who made the revision.');
					ctx.onLoadFailure(this);
					return;
				}
			}
			// set revert edit summary
			ctx.editSummary = '[[Help:Revert|Reverted]] to revision ' + ctx.revertOldID + ' by ' + ctx.revertUser + ': ' + ctx.editSummary;
		}

		ctx.pageLoaded = true;

		// alert("Generate edit conflict now");  // for testing edit conflict recovery logic
		ctx.onLoadSuccess(this);  // invoke callback
	};

	// helper function to parse the page name returned from the API
	var fnCheckPageName = function(xml, onFailure) {
		if (!onFailure) {
			onFailure = emptyFunction;
		}

		// check for invalid titles
		if ($(xml).find('page').attr('invalid') === '') {
			ctx.statusElement.error('The page title is invalid: ' + ctx.pageName);
			onFailure(this);
			return false; // abort
		}

		// retrieve actual title of the page after normalization and redirects
		if ($(xml).find('page').attr('title')) {
			var resolvedName = $(xml).find('page').attr('title');

			// only notify user for redirects, not normalization
			if ($(xml).find('redirects').length > 0) {
				Morebits.status.info('Info', 'Redirected from ' + ctx.pageName + ' to ' + resolvedName);
			}
			ctx.pageName = resolvedName;  // always update in case of normalization
		} else {
			// could be a circular redirect or other problem
			ctx.statusElement.error('Could not resolve redirects for: ' + ctx.pageName);
			onFailure(this);

			// force error to stay on the screen
			++Morebits.wiki.numberOfActionsLeft;
			return false; // abort
		}
		return true; // all OK
	};

	// helper function to get a new token on encountering token errors in save, deletePage, and undeletePage
	var fnGetToken = function() {
		var tokenApi = new Morebits.wiki.api('Getting token', {
			action: 'query',
			meta: 'tokens'
		});
		return tokenApi.post().then(function(apiobj) {
			return $(apiobj.responseXML).find('tokens').attr('csrftoken');
		});
	};

	// callback from saveApi.post()
	var fnSaveSuccess = function() {
		ctx.editMode = 'all';  // cancel append/prepend/revert modes
		var xml = ctx.saveApi.getXML();

		// see if the API thinks we were successful
		if ($(xml).find('edit').attr('result') === 'Success') {

			// real success
			// default on success action - display link for edited page
			var link = document.createElement('a');
			link.setAttribute('href', mw.util.getUrl(ctx.pageName));
			link.appendChild(document.createTextNode(ctx.pageName));
			ctx.statusElement.info(['completed (', link, ')']);
			if (ctx.onSaveSuccess) {
				ctx.onSaveSuccess(this);  // invoke callback
			}
			return;
		}

		// errors here are only generated by extensions which hook APIEditBeforeSave within MediaWiki,
		// which as of 1.34.0-wmf.23 (Sept 2019) should only encompass captcha messages
		if ($(xml).find('captcha').length > 0) {
			ctx.statusElement.error('Could not save the page because the wiki server wanted you to fill out a CAPTCHA.');
		} else {
			ctx.statusElement.error('Unknown error received from API while saving page');
		}

		// force error to stay on the screen
		++Morebits.wiki.numberOfActionsLeft;

		ctx.onSaveFailure(this);
	};

	// callback from saveApi.post()
	var fnSaveError = function() {
		var errorCode = ctx.saveApi.getErrorCode();

		// check for edit conflict
		if (errorCode === 'editconflict' && ctx.conflictRetries++ < ctx.maxConflictRetries) {

			// edit conflicts can occur when the page needs to be purged from the server cache
			var purgeQuery = {
				action: 'purge',
				titles: ctx.pageName  // redirects are already resolved
			};

			var purgeApi = new Morebits.wiki.api('Edit conflict detected, purging server cache', purgeQuery, function() {
				--Morebits.wiki.numberOfActionsLeft;  // allow for normal completion if retry succeeds

				ctx.statusElement.info('Edit conflict detected, reapplying edit');
				if (fnCanUseMwUserToken('edit')) {
					ctx.saveApi.post(); // necessarily append or prepend, so this should work as desired
				} else {
					ctx.loadApi.post(); // reload the page and reapply the edit
				}
			}, ctx.statusElement);
			purgeApi.post();

		// check for loss of edit token
		} else if (errorCode === 'badtoken' && ctx.retries++ < ctx.maxRetries) {

			ctx.statusElement.info('Edit token is invalid, retrying');
			--Morebits.wiki.numberOfActionsLeft;  // allow for normal completion if retry succeeds
			fnGetToken().then(function(token) {
				ctx.saveApi.query.token = token;
				ctx.saveApi.post();
			});

		// check for network or server error
		} else if (errorCode === 'undefined' && ctx.retries++ < ctx.maxRetries) {

			// the error might be transient, so try again
			ctx.statusElement.info('Save failed, retrying');
			--Morebits.wiki.numberOfActionsLeft;  // allow for normal completion if retry succeeds
			ctx.saveApi.post(); // give it another go!

		// hard error, give up
		} else {

			// non-admin attempting to edit a protected page - this gives a friendlier message than the default
			if (errorCode === 'protectedpage') {
				ctx.statusElement.error('Failed to save edit: Page is protected');
			// check for absuefilter hits: disallowed or warning
			} else if (errorCode.indexOf('abusefilter') === 0) {
				var desc = $(ctx.saveApi.getXML()).find('abusefilter').attr('description');
				if (errorCode === 'abusefilter-disallowed') {
					ctx.statusElement.error('The edit was disallowed by the edit filter: "' + desc + '".');
				} else if (errorCode === 'abusefilter-warning') {
					ctx.statusElement.error([ 'A warning was returned by the edit filter: "', desc, '". If you wish to proceed with the edit, please carry it out again. This warning will not appear a second time.' ]);
					// We should provide the user with a way to automatically retry the action if they so choose -
					// I can't see how to do this without creating a UI dependency on Morebits.wiki.page though -- TTO
				} else { // shouldn't happen but...
					ctx.statusElement.error('The edit was disallowed by the edit filter.');
				}
			// check for blacklist hits
			} else if (errorCode === 'spamblacklist') {
				// .find('matches') returns an array in case multiple items are blacklisted, we only return the first
				var spam = $(ctx.saveApi.getXML()).find('spamblacklist').find('matches').children()[0].textContent;
				ctx.statusElement.error('Could not save the page because the URL ' + spam + ' is on the spam blacklist');
			} else {
				ctx.statusElement.error('Failed to save edit: ' + ctx.saveApi.getErrorText());
			}
			ctx.editMode = 'all';  // cancel append/prepend/revert modes
			if (ctx.onSaveFailure) {
				ctx.onSaveFailure(this);  // invoke callback
			}
		}
	};

	var fnLookupCreationSuccess = function() {
		var xml = ctx.lookupCreationApi.getXML();

		if (!fnCheckPageName(xml)) {
			return; // abort
		}

		if (!ctx.lookupNonRedirectCreator || !/^\s*#redirect/i.test($(xml).find('rev').text())) {

			ctx.creator = $(xml).find('rev').attr('user');
			if (!ctx.creator) {
				ctx.statusElement.error('Could not find name of page creator');
				return;
			}
			ctx.timestamp = $(xml).find('rev').attr('timestamp');
			if (!ctx.timestamp) {
				ctx.statusElement.error('Could not find timestamp of page creation');
				return;
			}
			ctx.onLookupCreationSuccess(this);

		} else {
			ctx.lookupCreationApi.query.rvlimit = 50; // modify previous query to fetch more revisions
			ctx.lookupCreationApi.query.titles = ctx.pageName; // update pageName if redirect resolution took place in earlier query

			ctx.lookupCreationApi = new Morebits.wiki.api('Retrieving page creation information', ctx.lookupCreationApi.query, fnLookupNonRedirectCreator, ctx.statusElement);
			ctx.lookupCreationApi.setParent(this);
			ctx.lookupCreationApi.post();
		}

	};

	var fnLookupNonRedirectCreator = function() {
		var xml = ctx.lookupCreationApi.getXML();

		$(xml).find('rev').each(function(_, rev) {
			if (!/^\s*#redirect/i.test(rev.textContent)) { // inaccessible revisions also check out
				ctx.creator = rev.getAttribute('user');
				ctx.timestamp = rev.getAttribute('timestamp');
				return false; // break
			}
		});

		if (!ctx.creator) {
			// fallback to give first revision author if no non-redirect version in the first 50
			ctx.creator = $(xml).find('rev')[0].getAttribute('user');
			ctx.timestamp = $(xml).find('rev')[0].getAttribute('timestamp');
			if (!ctx.creator) {
				ctx.statusElement.error('Could not find name of page creator');
				return;
			}

		}
		if (!ctx.timestamp) {
			ctx.statusElement.error('Could not find timestamp of page creation');
			return;
		}

		ctx.onLookupCreationSuccess(this);

	};

	var fnProcessMove = function() {
		var pageTitle, token;

		if (fnCanUseMwUserToken('move')) {
			token = mw.user.tokens.get('csrfToken');
			pageTitle = ctx.pageName;
		} else {
			var xml = ctx.moveApi.getXML();

			if ($(xml).find('page').attr('missing') === '') {
				ctx.statusElement.error('Cannot move the page, because it no longer exists');
				ctx.onMoveFailure(this);
				return;
			}

			// extract protection info
			if (Morebits.userIsSysop) {
				var editprot = $(xml).find('pr[type="edit"]');
				if (editprot.length > 0 && editprot.attr('level') === 'sysop' && !ctx.suppressProtectWarning &&
					!confirm('You are about to move the fully protected page "' + ctx.pageName +
					(editprot.attr('expiry') === 'infinity' ? '" (protected indefinitely)' : '" (protection expiring ' + new Morebits.date(editprot.attr('expiry')).calendar('utc') + ' (UTC))') +
					'.  \n\nClick OK to proceed with the move, or Cancel to skip this move.')) {
					ctx.statusElement.error('Move of fully protected page was aborted.');
					ctx.onMoveFailure(this);
					return;
				}
			}

			token = $(xml).find('tokens').attr('csrftoken');
			if (!token) {
				ctx.statusElement.error('Failed to retrieve move token.');
				ctx.onMoveFailure(this);
				return;
			}

			pageTitle = $(xml).find('page').attr('title');
		}

		var query = {
			'action': 'move',
			'from': pageTitle,
			'to': ctx.moveDestination,
			'token': token,
			'reason': ctx.editSummary,
			'watchlist': ctx.watchlistOption
		};
		if (ctx.moveTalkPage) {
			query.movetalk = 'true';
		}
		if (ctx.moveSubpages) {
			query.movesubpages = 'true';
		}
		if (ctx.moveSuppressRedirect) {
			query.noredirect = 'true';
		}

		ctx.moveProcessApi = new Morebits.wiki.api('moving page...', query, ctx.onMoveSuccess, ctx.statusElement, ctx.onMoveFailure);
		ctx.moveProcessApi.setParent(this);
		ctx.moveProcessApi.post();
	};

	var fnProcessPatrol = function() {
		var query = {
			action: 'patrol'
		};

		// Didn't need to load the page
		if (ctx.rcid) {
			query.rcid = ctx.rcid;
			query.token = mw.user.tokens.get('patrolToken');
		} else {
			var xml = ctx.patrolApi.getResponse();

			// Don't patrol if not unpatrolled
			if ($(xml).find('rc').attr('unpatrolled') !== '') {
				return;
			}

			var lastrevid = $(xml).find('page').attr('lastrevid');
			if (!lastrevid) {
				return;
			}
			query.revid = lastrevid;

			var token = $(xml).find('tokens').attr('patroltoken');
			if (!token) {
				return;
			}

			query.token = token;
		}

		var patrolStat = new Morebits.status('Marking page as patrolled');

		ctx.patrolProcessApi = new Morebits.wiki.api('patrolling page...', query, null, patrolStat);
		ctx.patrolProcessApi.setParent(this);
		ctx.patrolProcessApi.post();
	};

	var fnProcessTriage = function() {
		var pageID, token;

		if (ctx.pageID) {
			token = mw.user.tokens.get('csrfToken');
			pageID = ctx.pageID;
		} else {
			var xml = ctx.triageApi.getXML();

			pageID = $(xml).find('page').attr('pageid');
			if (!pageID) {
				return;
			}

			token = $(xml).find('tokens').attr('csrftoken');
			if (!token) {
				return;
			}
		}

		var query = {
			action: 'pagetriageaction',
			pageid: pageID,
			reviewed: 1,
			token: token
		};

		var triageStat = new Morebits.status('Marking page as curated');

		ctx.triageProcessApi = new Morebits.wiki.api('curating page...', query, null, triageStat, fnProcessTriageError);
		ctx.triageProcessApi.setParent(this);
		ctx.triageProcessApi.post();
	};

	// callback from triageProcessApi.post()
	var fnProcessTriageError = function() {
		// Ignore error if page not in queue, see https://github.com/azatoth/twinkle/pull/930
		if (ctx.triageProcessApi.getErrorCode() === 'bad-pagetriage-page') {
			ctx.triageProcessApi.getStatusElement().unlink();
		}
	};

	var fnProcessDelete = function() {
		var pageTitle, token;

		if (fnCanUseMwUserToken('delete')) {
			token = mw.user.tokens.get('csrfToken');
			pageTitle = ctx.pageName;
		} else {
			var xml = ctx.deleteApi.getXML();

			if ($(xml).find('page').attr('missing') === '') {
				ctx.statusElement.error('Cannot delete the page, because it no longer exists');
				ctx.onDeleteFailure(this);
				return;
			}

			// extract protection info
			var editprot = $(xml).find('pr[type="edit"]');
			if (editprot.length > 0 && editprot.attr('level') === 'sysop' && !ctx.suppressProtectWarning &&
				!confirm('You are about to delete the fully protected page "' + ctx.pageName +
				(editprot.attr('expiry') === 'infinity' ? '" (protected indefinitely)' : '" (protection expiring ' + new Morebits.date(editprot.attr('expiry')).calendar('utc') + ' (UTC))') +
				'.  \n\nClick OK to proceed with the deletion, or Cancel to skip this deletion.')) {
				ctx.statusElement.error('Deletion of fully protected page was aborted.');
				ctx.onDeleteFailure(this);
				return;
			}

			token = $(xml).find('tokens').attr('csrftoken');
			if (!token) {
				ctx.statusElement.error('Failed to retrieve delete token.');
				ctx.onDeleteFailure(this);
				return;
			}

			pageTitle = $(xml).find('page').attr('title');
		}

		var query = {
			'action': 'delete',
			'title': pageTitle,
			'token': token,
			'reason': ctx.editSummary,
			'watchlist': ctx.watchlistOption
		};

		ctx.deleteProcessApi = new Morebits.wiki.api('deleting page...', query, ctx.onDeleteSuccess, ctx.statusElement, fnProcessDeleteError);
		ctx.deleteProcessApi.setParent(this);
		ctx.deleteProcessApi.post();
	};

	// callback from deleteProcessApi.post()
	var fnProcessDeleteError = function() {

		var errorCode = ctx.deleteProcessApi.getErrorCode();

		// check for "Database query error"
		if (errorCode === 'internal_api_error_DBQueryError' && ctx.retries++ < ctx.maxRetries) {
			ctx.statusElement.info('Database query error, retrying');
			--Morebits.wiki.numberOfActionsLeft;  // allow for normal completion if retry succeeds
			ctx.deleteProcessApi.post(); // give it another go!
		} else if (errorCode === 'badtoken' && ctx.retries++ < ctx.maxRetries) {
			ctx.statusElement.info('Invalid token, retrying');
			--Morebits.wiki.numberOfActionsLeft;
			fnGetToken().then(function(token) {
				ctx.deleteProcessApi.query.token = token;
				ctx.deleteProcessApi.post();
			});
		} else if (errorCode === 'missingtitle') {
			ctx.statusElement.error('Cannot delete the page, because it no longer exists');
			if (ctx.onDeleteFailure) {
				ctx.onDeleteFailure.call(this, ctx.deleteProcessApi);  // invoke callback
			}
		// hard error, give up
		} else {
			ctx.statusElement.error('Failed to delete the page: ' + ctx.deleteProcessApi.getErrorText());
			if (ctx.onDeleteFailure) {
				ctx.onDeleteFailure.call(this, ctx.deleteProcessApi);  // invoke callback
			}
		}
	};

	var fnProcessUndelete = function() {
		var pageTitle, token;

		if (fnCanUseMwUserToken('undelete')) {
			token = mw.user.tokens.get('csrfToken');
			pageTitle = ctx.pageName;
		} else {
			var xml = ctx.undeleteApi.getXML();

			if ($(xml).find('page').attr('missing') !== '') {
				ctx.statusElement.error('Cannot undelete the page, because it already exists');
				ctx.onUndeleteFailure(this);
				return;
			}

			// extract protection info
			var editprot = $(xml).find('pr[type="create"]');
			if (editprot.length > 0 && editprot.attr('level') === 'sysop' && !ctx.suppressProtectWarning &&
				!confirm('You are about to undelete the fully create protected page "' + ctx.pageName +
				(editprot.attr('expiry') === 'infinity' ? '" (protected indefinitely)' : '" (protection expiring ' + new Morebits.date(editprot.attr('expiry')).calendar('utc') + ' (UTC))') +
				'.  \n\nClick OK to proceed with the undeletion, or Cancel to skip this undeletion.')) {
				ctx.statusElement.error('Undeletion of fully create protected page was aborted.');
				ctx.onUndeleteFailure(this);
				return;
			}

			token = $(xml).find('tokens').attr('csrftoken');
			if (!token) {
				ctx.statusElement.error('Failed to retrieve undelete token.');
				ctx.onUndeleteFailure(this);
				return;
			}

			pageTitle = $(xml).find('page').attr('title');
		}

		var query = {
			'action': 'undelete',
			'title': pageTitle,
			'token': token,
			'reason': ctx.editSummary,
			'watchlist': ctx.watchlistOption
		};

		ctx.undeleteProcessApi = new Morebits.wiki.api('undeleting page...', query, ctx.onUndeleteSuccess, ctx.statusElement, fnProcessUndeleteError);
		ctx.undeleteProcessApi.setParent(this);
		ctx.undeleteProcessApi.post();
	};

	// callback from undeleteProcessApi.post()
	var fnProcessUndeleteError = function() {

		var errorCode = ctx.undeleteProcessApi.getErrorCode();

		// check for "Database query error"
		if (errorCode === 'internal_api_error_DBQueryError' && ctx.retries++ < ctx.maxRetries) {
			ctx.statusElement.info('Database query error, retrying');
			--Morebits.wiki.numberOfActionsLeft;  // allow for normal completion if retry succeeds
			ctx.undeleteProcessApi.post(); // give it another go!
		} else if (errorCode === 'badtoken' && ctx.retries++ < ctx.maxRetries) {
			ctx.statusElement.info('Invalid token, retrying');
			--Morebits.wiki.numberOfActionsLeft;
			fnGetToken().then(function(token) {
				ctx.undeleteProcessApi.query.token = token;
				ctx.undeleteProcessApi.post();
			});
		} else if (errorCode === 'cantundelete') {
			ctx.statusElement.error('Cannot undelete the page, either because there are no revisions to undelete or because it has already been undeleted');
			if (ctx.onUndeleteFailure) {
				ctx.onUndeleteFailure.call(this, ctx.undeleteProcessApi);  // invoke callback
			}
		// hard error, give up
		} else {
			ctx.statusElement.error('Failed to undelete the page: ' + ctx.undeleteProcessApi.getErrorText());
			if (ctx.onUndeleteFailure) {
				ctx.onUndeleteFailure.call(this, ctx.undeleteProcessApi);  // invoke callback
			}
		}
	};

	var fnProcessProtect = function() {
		var xml = ctx.protectApi.getXML();

		var missing = $(xml).find('page').attr('missing') === '';
		if ((ctx.protectEdit || ctx.protectMove) && missing) {
			ctx.statusElement.error('Cannot protect the page, because it no longer exists');
			ctx.onProtectFailure(this);
			return;
		}
		if (ctx.protectCreate && !missing) {
			ctx.statusElement.error('Cannot create protect the page, because it already exists');
			ctx.onProtectFailure(this);
			return;
		}

		// TODO cascading protection not possible on edit<sysop

		var token = $(xml).find('tokens').attr('csrftoken');
		if (!token) {
			ctx.statusElement.error('Failed to retrieve protect token.');
			ctx.onProtectFailure(this);
			return;
		}

		var pageTitle = $(xml).find('page').attr('title');

		// fetch existing protection levels
		var prs = $(xml).find('pr');
		var editprot = prs.filter('[type="edit"]');
		var moveprot = prs.filter('[type="move"]');
		var createprot = prs.filter('[type="create"]');

		var protections = [], expirys = [];

		// set edit protection level
		if (ctx.protectEdit) {
			protections.push('edit=' + ctx.protectEdit.level);
			expirys.push(ctx.protectEdit.expiry);
		} else if (editprot.length) {
			protections.push('edit=' + editprot.attr('level'));
			expirys.push(editprot.attr('expiry').replace('infinity', 'indefinite'));
		}

		if (ctx.protectMove) {
			protections.push('move=' + ctx.protectMove.level);
			expirys.push(ctx.protectMove.expiry);
		} else if (moveprot.length) {
			protections.push('move=' + moveprot.attr('level'));
			expirys.push(moveprot.attr('expiry').replace('infinity', 'indefinite'));
		}

		if (ctx.protectCreate) {
			protections.push('create=' + ctx.protectCreate.level);
			expirys.push(ctx.protectCreate.expiry);
		} else if (createprot.length) {
			protections.push('create=' + createprot.attr('level'));
			expirys.push(createprot.attr('expiry').replace('infinity', 'indefinite'));
		}

		var query = {
			action: 'protect',
			title: pageTitle,
			token: token,
			protections: protections.join('|'),
			expiry: expirys.join('|'),
			reason: ctx.editSummary,
			watchlist: ctx.watchlistOption
		};
		if (ctx.protectCascade) {
			query.cascade = 'true';
		}

		ctx.protectProcessApi = new Morebits.wiki.api('protecting page...', query, ctx.onProtectSuccess, ctx.statusElement, ctx.onProtectFailure);
		ctx.protectProcessApi.setParent(this);
		ctx.protectProcessApi.post();
	};

	var fnProcessStabilize = function() {
		var pageTitle, token;

		if (fnCanUseMwUserToken('stabilize')) {
			token = mw.user.tokens.get('csrfToken');
			pageTitle = ctx.pageName;
		} else {
			var xml = ctx.stabilizeApi.getXML();

			var missing = $(xml).find('page').attr('missing') === '';
			if (missing) {
				ctx.statusElement.error('Cannot protect the page, because it no longer exists');
				ctx.onStabilizeFailure(this);
				return;
			}

			token = $(xml).find('tokens').attr('csrftoken');
			if (!token) {
				ctx.statusElement.error('Failed to retrieve stabilize token.');
				ctx.onStabilizeFailure(this);
				return;
			}

			pageTitle = $(xml).find('page').attr('title');
		}

		var query = {
			action: 'stabilize',
			title: pageTitle,
			token: token,
			protectlevel: ctx.flaggedRevs.level,
			expiry: ctx.flaggedRevs.expiry,
			reason: ctx.editSummary
		};
		// [[phab:T247915]]
		if (ctx.watchlistOption === 'watch') {
			query.watchlist = 'true';
		}

		ctx.stabilizeProcessApi = new Morebits.wiki.api('configuring stabilization settings...', query, ctx.onStabilizeSuccess, ctx.statusElement, ctx.onStabilizeFailure);
		ctx.stabilizeProcessApi.setParent(this);
		ctx.stabilizeProcessApi.post();
	};
}; // end Morebits.wiki.page

/* Morebits.wiki.page TODO: (XXX)
* - Should we retry loads also?
* - Need to reset current action before the save?
* - Deal with action.completed stuff
* - Need to reset all parameters once done (e.g. edit summary, move destination, etc.)
*/



/**
 * **************** Morebits.wiki.preview ****************
 * Uses the API to parse a fragment of wikitext and render it as HTML.
 *
 * The suggested implementation pattern (in Morebits.simpleWindow + Morebits.quickForm situations) is to
 * construct a Morebits.wiki.preview object after rendering a Morebits.quickForm, and bind the object
 * to an arbitrary property of the form (e.g. |previewer|).  For an example, see
 * twinklewarn.js.
 */

/**
 * @constructor
 * @param {HTMLElement} previewbox - the element that will contain the rendered HTML,
 * usually a <div> element
 */
Morebits.wiki.preview = function(previewbox) {
	this.previewbox = previewbox;
	$(previewbox).addClass('morebits-previewbox').hide();

	/**
	 * Displays the preview box, and begins an asynchronous attempt
	 * to render the specified wikitext.
	 * @param {string} wikitext - wikitext to render; most things should work, including subst: and ~~~~
	 * @param {string} [pageTitle] - optional parameter for the page this should be rendered as being on, if omitted it is taken as the current page
	 */
	this.beginRender = function(wikitext, pageTitle) {
		$(previewbox).show();

		var statusspan = document.createElement('span');
		previewbox.appendChild(statusspan);
		Morebits.status.init(statusspan);

		var query = {
			action: 'parse',
			prop: 'text',
			pst: 'true',  // PST = pre-save transform; this makes substitution work properly
			text: wikitext,
			title: pageTitle || mw.config.get('wgPageName')
		};
		var renderApi = new Morebits.wiki.api('loading...', query, fnRenderSuccess, new Morebits.status('Preview'));
		renderApi.post();
	};

	var fnRenderSuccess = function(apiobj) {
		var xml = apiobj.getXML();
		var html = $(xml).find('text').text();
		if (!html) {
			apiobj.statelem.error('failed to retrieve preview, or template was blanked');
			return;
		}
		previewbox.innerHTML = html;
		$(previewbox).find('a').attr('target', '_blank'); // this makes links open in new tab
	};

	/** Hides the preview box and clears it. */
	this.closePreview = function() {
		$(previewbox).empty().hide();
	};
};



/**
 * **************** Morebits.wikitext ****************
 * Wikitext manipulation
 */

Morebits.wikitext = {};

Morebits.wikitext.template = {
	parse: function(text, start) {
		var count = -1;
		var level = -1;
		var equals = -1;
		var current = '';
		var result = {
			name: '',
			parameters: {}
		};
		var key, value;

		for (var i = start; i < text.length; ++i) {
			var test3 = text.substr(i, 3);
			if (test3 === '{{{') {
				current += '{{{';
				i += 2;
				++level;
				continue;
			}
			if (test3 === '}}}') {
				current += '}}}';
				i += 2;
				--level;
				continue;
			}
			var test2 = text.substr(i, 2);
			if (test2 === '{{' || test2 === '[[') {
				current += test2;
				++i;
				++level;
				continue;
			}
			if (test2 === ']]') {
				current += ']]';
				++i;
				--level;
				continue;
			}
			if (test2 === '}}') {
				current += test2;
				++i;
				--level;

				if (level <= 0) {
					if (count === -1) {
						result.name = current.substring(2).trim();
						++count;
					} else {
						if (equals !== -1) {
							key = current.substring(0, equals).trim();
							value = current.substring(equals).trim();
							result.parameters[key] = value;
							equals = -1;
						} else {
							result.parameters[count] = current;
							++count;
						}
					}
					break;
				}
				continue;
			}

			if (text.charAt(i) === '|' && level <= 0) {
				if (count === -1) {
					result.name = current.substring(2).trim();
					++count;
				} else {
					if (equals !== -1) {
						key = current.substring(0, equals).trim();
						value = current.substring(equals + 1).trim();
						result.parameters[key] = value;
						equals = -1;
					} else {
						result.parameters[count] = current;
						++count;
					}
				}
				current = '';
			} else if (equals === -1 && text.charAt(i) === '=' && level <= 0) {
				equals = current.length;
				current += text.charAt(i);
			} else {
				current += text.charAt(i);
			}
		}

		return result;
	}
};

/**
 * @constructor
 * @param {string} text
 */
Morebits.wikitext.page = function mediawikiPage(text) {
	this.text = text;
};

Morebits.wikitext.page.prototype = {
	text: '',

	/**
	 * Removes links to `link_target` from the page text.
	 * @param {string} link_target
	 */
	removeLink: function(link_target) {
		var first_char = link_target.substr(0, 1);
		var link_re_string = '[' + first_char.toUpperCase() + first_char.toLowerCase() + ']' + RegExp.escape(link_target.substr(1), true);

		// Files and Categories become links with a leading colon, e.g. [[:File:Test.png]]
		// Otherwise, allow for an optional leading colon, e.g. [[:User:Test]]
		var special_ns_re = /^(?:[Ff]ile|[Ii]mage|[Cc]ategory):/;
		var colon = special_ns_re.test(link_target) ? ':' : ':?';

		var link_simple_re = new RegExp('\\[\\[' + colon + '(' + link_re_string + ')\\]\\]', 'g');
		var link_named_re = new RegExp('\\[\\[' + colon + link_re_string + '\\|(.+?)\\]\\]', 'g');
		this.text = this.text.replace(link_simple_re, '$1').replace(link_named_re, '$1');
	},

	/**
	 * Comments out images from page text. If used in a gallery, deletes the whole line.
	 * If used as a template argument (not necessarily with File: prefix), the template parameter is commented out.
	 * @param {string} image - Image name without File: prefix
	 * @param {string} reason - Reason to be included in comment, alongside the commented-out image
	 */
	commentOutImage: function(image, reason) {
		var unbinder = new Morebits.unbinder(this.text);
		unbinder.unbind('<!--', '-->');

		reason = reason ? reason + ': ' : '';
		var first_char = image.substr(0, 1);
		var image_re_string = '[' + first_char.toUpperCase() + first_char.toLowerCase() + ']' + RegExp.escape(image.substr(1), true);

		// Check for normal image links, i.e. [[File:Foobar.png|...]]
		// Will eat the whole link
		var links_re = new RegExp('\\[\\[(?:[Ii]mage|[Ff]ile):\\s*' + image_re_string);
		var allLinks = Morebits.array.uniq(Morebits.string.splitWeightedByKeys(unbinder.content, '[[', ']]'));
		for (var i = 0; i < allLinks.length; ++i) {
			if (links_re.test(allLinks[i])) {
				var replacement = '<!-- ' + reason + allLinks[i] + ' -->';
				unbinder.content = unbinder.content.replace(allLinks[i], replacement, 'g');
			}
		}
		// unbind the newly created comments
		unbinder.unbind('<!--', '-->');

		// Check for gallery images, i.e. instances that must start on a new line,
		// eventually preceded with some space, and must include File: prefix
		// Will eat the whole line.
		var gallery_image_re = new RegExp('(^\\s*(?:[Ii]mage|[Ff]ile):\\s*' + image_re_string + '.*?$)', 'mg');
		unbinder.content = unbinder.content.replace(gallery_image_re, '<!-- ' + reason + '$1 -->');

		// unbind the newly created comments
		unbinder.unbind('<!--', '-->');

		// Check free image usages, for example as template arguments, might have the File: prefix excluded, but must be preceeded by an |
		// Will only eat the image name and the preceeding bar and an eventual named parameter
		var free_image_re = new RegExp('(\\|\\s*(?:[\\w\\s]+\\=)?\\s*(?:(?:[Ii]mage|[Ff]ile):\\s*)?' + image_re_string + ')', 'mg');
		unbinder.content = unbinder.content.replace(free_image_re, '<!-- ' + reason + '$1 -->');
		// Rebind the content now, we are done!
		this.text = unbinder.rebind();
	},

	/**
	 * Converts first usage of [[File:`image`]] to [[File:`image`|`data`]]
	 * @param {string} image - Image name without File: prefix
	 * @param {string} data
	 */
	addToImageComment: function(image, data) {
		var first_char = image.substr(0, 1);
		var first_char_regex = RegExp.escape(first_char, true);
		if (first_char.toUpperCase() !== first_char.toLowerCase()) {
			first_char_regex = '[' + RegExp.escape(first_char.toUpperCase(), true) + RegExp.escape(first_char.toLowerCase(), true) + ']';
		}
		var image_re_string = '(?:[Ii]mage|[Ff]ile):\\s*' + first_char_regex + RegExp.escape(image.substr(1), true);
		var links_re = new RegExp('\\[\\[' + image_re_string);
		var allLinks = Morebits.array.uniq(Morebits.string.splitWeightedByKeys(this.text, '[[', ']]'));
		for (var i = 0; i < allLinks.length; ++i) {
			if (links_re.test(allLinks[i])) {
				var replacement = allLinks[i];
				// just put it at the end?
				replacement = replacement.replace(/\]\]$/, '|' + data + ']]');
				this.text = this.text.replace(allLinks[i], replacement, 'g');
			}
		}
		var gallery_re = new RegExp('^(\\s*' + image_re_string + '.*?)\\|?(.*?)$', 'mg');
		var newtext = '$1|$2 ' + data;
		this.text = this.text.replace(gallery_re, newtext);
	},

	/**
	 * Removes transclusions of template from page text
	 * @param {string} template - Page name whose transclusions are to be removed,
	 * include namespace prefix only if not in template namespace
	 */
	removeTemplate: function(template) {
		var first_char = template.substr(0, 1);
		var template_re_string = '(?:[Tt]emplate:)?\\s*[' + first_char.toUpperCase() + first_char.toLowerCase() + ']' + RegExp.escape(template.substr(1), true);
		var links_re = new RegExp('\\{\\{' + template_re_string);
		var allTemplates = Morebits.array.uniq(Morebits.string.splitWeightedByKeys(this.text, '{{', '}}', [ '{{{', '}}}' ]));
		for (var i = 0; i < allTemplates.length; ++i) {
			if (links_re.test(allTemplates[i])) {
				this.text = this.text.replace(allTemplates[i], '', 'g');
			}
		}
	},

	/** @returns {string} */
	getText: function() {
		return this.text;
	}
};

/**
 * *********** Morebits.userspaceLogger ************
 * Handles logging actions to a userspace log, used in
 * twinklespeedy and twinkleprod.
 */

Morebits.userspaceLogger = function(logPageName) {
	if (!logPageName) {
		throw new Error('no log page name specified');
	}
	this.initialText = '';
	this.headerLevel = 3;

	this.log = function(logText, summaryText) {
		if (!logText) {
			return;
		}
		var page = new Morebits.wiki.page('User:' + mw.config.get('wgUserName') + '/' + logPageName,
			'Adding entry to userspace log'); // make this '... to ' + logPageName ?
		return page.load(function(pageobj) {
			// add blurb if log page doesn't exist or is blank
			var text = pageobj.getPageText() || this.initialText;

			// create monthly header if it doesn't exist already
			var date = new Morebits.date(pageobj.getLoadTime());
			if (!date.monthHeaderRegex().exec(text)) {
				text += '\n\n' + date.monthHeader(this.headerLevel);
			}

			pageobj.setPageText(text + '\n' + logText);
			pageobj.setEditSummary(summaryText);
			pageobj.setCreateOption('recreate');
			pageobj.save();
		}.bind(this));
	};
};

/**
 * **************** Morebits.status ****************
 */

/**
 * @constructor
 * Morebits.status.init() must be called before any status object is created, otherwise
 * those statuses won't be visible.
 * @param {String} text - Text before the the colon `:`
 * @param {String} stat - Text after the colon `:`
 * @param {String} [type=status] - This parameter determines the font color of the status line,
 * this can be 'status' (blue), 'info' (green), 'warn' (red), or 'error' (bold red)
 * The default is 'status'
 */

Morebits.status = function Status(text, stat, type) {
	this.textRaw = text;
	this.text = this.codify(text);
	this.type = type || 'status';
	this.generate();
	if (stat) {
		this.update(stat, type);
	}
};

/**
 * Specify an area for status message elements to be added to
 * @param {HTMLElement} root - usually a div element
 */
Morebits.status.init = function(root) {
	if (!(root instanceof Element)) {
		throw new Error('object not an instance of Element');
	}
	while (root.hasChildNodes()) {
		root.removeChild(root.firstChild);
	}
	Morebits.status.root = root;
	Morebits.status.errorEvent = null;
};

Morebits.status.root = null;

/** @param {Function} handler - function to execute on error */
Morebits.status.onError = function(handler) {
	if (typeof handler === 'function') {
		Morebits.status.errorEvent = handler;
	} else {
		throw 'Morebits.status.onError: handler is not a function';
	}
};

Morebits.status.prototype = {
	stat: null,
	text: null,
	textRaw: null,
	type: 'status',
	target: null,
	node: null,
	linked: false,

	/** Add the status element node to the DOM */
	link: function() {
		if (!this.linked && Morebits.status.root) {
			Morebits.status.root.appendChild(this.node);
			this.linked = true;
		}
	},

	/** Remove the status element node from the DOM */
	unlink: function() {
		if (this.linked) {
			Morebits.status.root.removeChild(this.node);
			this.linked = false;
		}
	},

	/**
	 * Create a document fragment with the status text
	 * @param {(string|Element|Array)} obj
	 * @returns {DocumentFragment}
	 */
	codify: function(obj) {
		if (!Array.isArray(obj)) {
			obj = [ obj ];
		}
		var result;
		result = document.createDocumentFragment();
		for (var i = 0; i < obj.length; ++i) {
			if (typeof obj[i] === 'string') {
				result.appendChild(document.createTextNode(obj[i]));
			} else if (obj[i] instanceof Element) {
				result.appendChild(obj[i]);
			} // Else cosmic radiation made something shit
		}
		return result;

	},

	/**
	 * Update the status
	 * @param {String} status - Part of status message after colon `:`
	 * @param {String} type - 'status' (blue), 'info' (green), 'warn' (red), or 'error' (bold red)
	 */
	update: function(status, type) {
		this.stat = this.codify(status);
		if (type) {
			this.type = type;
			if (type === 'error') {
				// hack to force the page not to reload when an error is output - see also Morebits.status() above
				Morebits.wiki.numberOfActionsLeft = 1000;

				// call error callback
				if (Morebits.status.errorEvent) {
					Morebits.status.errorEvent();
				}

				// also log error messages in the browser console
				console.error(this.textRaw + ': ' + status); // eslint-disable-line no-console
			}
		}
		this.render();
	},

	/** Produce the html for first part of the status message */
	generate: function() {
		this.node = document.createElement('div');
		this.node.appendChild(document.createElement('span')).appendChild(this.text);
		this.node.appendChild(document.createElement('span')).appendChild(document.createTextNode(': '));
		this.target = this.node.appendChild(document.createElement('span'));
		this.target.appendChild(document.createTextNode('')); // dummy node
	},

	/** Complete the html, for the second part of the status message */
	render: function() {
		this.node.className = 'morebits_status_' + this.type;
		while (this.target.hasChildNodes()) {
			this.target.removeChild(this.target.firstChild);
		}
		this.target.appendChild(this.stat);
		this.link();
	},
	status: function(status) {
		this.update(status, 'status');
	},
	info: function(status) {
		this.update(status, 'info');
	},
	warn: function(status) {
		this.update(status, 'warn');
	},
	error: function(status) {
		this.update(status, 'error');
	}
};

Morebits.status.info = function(text, status) {
	return new Morebits.status(text, status, 'info');
};

Morebits.status.warn = function(text, status) {
	return new Morebits.status(text, status, 'warn');
};

Morebits.status.error = function(text, status) {
	return new Morebits.status(text, status, 'error');
};

/**
 * For the action complete message at the end, create a status line without
 * a colon separator.
 * @param {String} text
 */
Morebits.status.actionCompleted = function(text) {
	var node = document.createElement('div');
	node.appendChild(document.createElement('span')).appendChild(document.createTextNode(text));
	node.className = 'morebits_status_info';
	if (Morebits.status.root) {
		Morebits.status.root.appendChild(node);
	}
};

/**
 * Display the user's rationale, comments, etc. back to them after a failure,
 * so that they may re-use it
 * @param {string} comments
 * @param {string} message
 */
Morebits.status.printUserText = function(comments, message) {
	var p = document.createElement('p');
	p.innerHTML = message;
	var div = document.createElement('div');
	div.className = 'toccolours';
	div.style.marginTop = '0';
	div.style.whiteSpace = 'pre-wrap';
	div.textContent = comments;
	p.appendChild(div);
	Morebits.status.root.appendChild(p);
};



/**
 * **************** Morebits.htmlNode() ****************
 * Simple helper function to create a simple node
 * @param {string} type - type of HTML element
 * @param {string} text - text content
 * @param {string} [color] - font color
 * @returns {HTMLElement}
 */
Morebits.htmlNode = function (type, content, color) {
	var node = document.createElement(type);
	if (color) {
		node.style.color = color;
	}
	node.appendChild(document.createTextNode(content));
	return node;
};



/**
 * **************** Morebits.checkboxShiftClickSupport() ****************
 * shift-click-support for checkboxes
 * wikibits version (window.addCheckboxClickHandlers) has some restrictions, and
 * doesn't work with checkboxes inside a sortable table, so let's build our own.
 */
Morebits.checkboxShiftClickSupport = function (jQuerySelector, jQueryContext) {
	var lastCheckbox = null;

	function clickHandler(event) {
		var thisCb = this;
		if (event.shiftKey && lastCheckbox !== null) {
			var cbs = $(jQuerySelector, jQueryContext); // can't cache them, obviously, if we want to support resorting
			var index = -1, lastIndex = -1, i;
			for (i = 0; i < cbs.length; i++) {
				if (cbs[i] === thisCb) {
					index = i;
					if (lastIndex > -1) {
						break;
					}
				}
				if (cbs[i] === lastCheckbox) {
					lastIndex = i;
					if (index > -1) {
						break;
					}
				}
			}

			if (index > -1 && lastIndex > -1) {
				// inspired by wikibits
				var endState = thisCb.checked;
				var start, finish;
				if (index < lastIndex) {
					start = index + 1;
					finish = lastIndex;
				} else {
					start = lastIndex;
					finish = index - 1;
				}

				for (i = start; i <= finish; i++) {
					if (cbs[i].checked !== endState) {
						cbs[i].click();
					}
				}
			}
		}
		lastCheckbox = thisCb;
		return true;
	}

	$(jQuerySelector, jQueryContext).click(clickHandler);
};



/** **************** Morebits.batchOperation ****************
 * Iterates over a group of pages (or arbitrary objects) and executes a worker function
 * for each.
 *
 * Constructor: Morebits.batchOperation(currentAction)
 *
 * setPageList(wikitext): Sets the list of pages to work on.
 *    It should be an array of page names (strings).
 *
 * setOption(optionName, optionValue): Sets a known option:
 *    - chunkSize (integer): the size of chunks to break the array into (default 50).
 *          Setting this to a small value (<5) can cause problems.
 *    - preserveIndividualStatusLines (boolean): keep each page's status element visible
 *          when worker is complete?  See note below
 *
 * run(worker, postFinish): Runs the callback `worker` for each page in the list.
 *    The callback must call workerSuccess when succeeding, or workerFailure
 *    when failing.  If using Morebits.wiki.api or Morebits.wiki.page, this is easily
 *    done by passing these two functions as parameters to the methods on those
 *    objects, for instance, page.save(batchOp.workerSuccess, batchOp.workerFailure).
 *    Make sure the methods are called directly if special success/failure cases arise.
 *    If you omit to call these methods, the batch operation will stall after the first
 *    chunk!  Also ensure that either workerSuccess or workerFailure is called no more
 *    than once.
 *    The second callback `postFinish` is executed when the entire batch has been processed.
 *
 * If using preserveIndividualStatusLines, you should try to ensure that the
 * workerSuccess callback has access to the page title.  This is no problem for
 * Morebits.wiki.page objects.  But when using the API, please set the
 * |pageName| property on the Morebits.wiki.api object.
 *
 * There are sample batchOperation implementations using Morebits.wiki.page in
 * twinklebatchdelete.js, twinklebatchundelete.js, and twinklebatchprotect.js.
 */

/**
 * @constructor
 * @param {string} [currentAction]
 */
Morebits.batchOperation = function(currentAction) {
	var ctx = {
		// backing fields for public properties
		pageList: null,
		options: {
			chunkSize: 50,
			preserveIndividualStatusLines: false
		},

		// internal counters, etc.
		statusElement: new Morebits.status(currentAction || 'Performing batch operation'),
		worker: null, // function that executes for each item in pageList
		postFinish: null, // function that executes when the whole batch has been processed
		countStarted: 0,
		countFinished: 0,
		countFinishedSuccess: 0,
		currentChunkIndex: -1,
		pageChunks: [],
		running: false
	};

	// shouldn't be needed by external users, but provided anyway for maximum flexibility
	this.getStatusElement = function() {
		return ctx.statusElement;
	};

	/**
	 * Sets the list of pages to work on
	 * @param {Array} pageList  Array of objects over which you wish to execute the worker function
	 * This is usually the list of page names (strings).
	 */
	this.setPageList = function(pageList) {
		ctx.pageList = pageList;
	};

	/**
	 * Sets a known option:
	 * - chunkSize (integer):
	 *        The size of chunks to break the array into (default 50).
	 *        Setting this to a small value (<5) can cause problems.
	 * - preserveIndividualStatusLines (boolean):
	 *        Keep each page's status element visible when worker is complete?
	 */
	this.setOption = function(optionName, optionValue) {
		ctx.options[optionName] = optionValue;
	};

	/**
	 * Runs the first callback for each page in the list.
	 * The callback must call workerSuccess when succeeding, or workerFailure when failing.
	 * Runs the second callback when the whole batch has been processed (optional)
	 * @param {Function} worker
	 * @param {Function} [postFinish]
	 */
	this.run = function(worker, postFinish) {
		if (ctx.running) {
			ctx.statusElement.error('Batch operation is already running');
			return;
		}
		ctx.running = true;

		ctx.worker = worker;
		ctx.postFinish = postFinish;
		ctx.countStarted = 0;
		ctx.countFinished = 0;
		ctx.countFinishedSuccess = 0;
		ctx.currentChunkIndex = -1;
		ctx.pageChunks = [];

		var total = ctx.pageList.length;
		if (!total) {
			ctx.statusElement.info('no pages specified');
			ctx.running = false;
			if (ctx.postFinish) {
				ctx.postFinish();
			}
			return;
		}

		// chunk page list into more manageable units
		ctx.pageChunks = Morebits.array.chunk(ctx.pageList, ctx.options.chunkSize);

		// start the process
		Morebits.wiki.addCheckpoint();
		ctx.statusElement.status('0%');
		fnStartNewChunk();
	};

	/**
	 * To be called by worker before it terminates succesfully
	 * @param {(Morebits.wiki.page|Morebits.wiki.api|string)} arg
	 * This should be the `Morebits.wiki.page` or `Morebits.wiki.api` object used by worker
	 * (for the adjustment of status lines emitted by them).
	 * If no Morebits.wiki.* object is used (eg. you're using mw.Api() or something else), and
	 * `preserveIndividualStatusLines` option is on, give the page name (string) as argument.
	 */
	this.workerSuccess = function(arg) {

		var createPageLink = function(pageName) {
			var link = document.createElement('a');
			link.setAttribute('href', mw.util.getUrl(pageName));
			link.appendChild(document.createTextNode(pageName));
			return link;
		};

		if (arg instanceof Morebits.wiki.api || arg instanceof Morebits.wiki.page) {
			// update or remove status line
			var statelem = arg.getStatusElement();
			if (ctx.options.preserveIndividualStatusLines) {
				if (arg.getPageName || arg.pageName || (arg.query && arg.query.title)) {
					// we know the page title - display a relevant message
					var pageName = arg.getPageName ? arg.getPageName() : arg.pageName || arg.query.title;
					statelem.info(['completed (', createPageLink(pageName), ')']);
				} else {
					// we don't know the page title - just display a generic message
					statelem.info('done');
				}
			} else {
				// remove the status line automatically produced by Morebits.wiki.*
				statelem.unlink();
			}

		} else if (typeof arg === 'string' && ctx.options.preserveIndividualStatusLines) {
			new Morebits.status(arg, ['done (', createPageLink(arg), ')']);
		}

		ctx.countFinishedSuccess++;
		fnDoneOne();
	};

	this.workerFailure = function() {
		fnDoneOne();
	};

	// private functions

	var thisProxy = this;

	var fnStartNewChunk = function() {
		var chunk = ctx.pageChunks[++ctx.currentChunkIndex];
		if (!chunk) {
			return;  // done! yay
		}

		// start workers for the current chunk
		ctx.countStarted += chunk.length;
		chunk.forEach(function(page) {
			ctx.worker(page, thisProxy);
		});
	};

	var fnDoneOne = function() {
		ctx.countFinished++;

		// update overall status line
		var total = ctx.pageList.length;
		if (ctx.countFinished === total) {
			var statusString = 'Done (' + ctx.countFinishedSuccess +
				'/' + ctx.countFinished + ' actions completed successfully)';
			if (ctx.countFinishedSuccess < ctx.countFinished) {
				ctx.statusElement.warn(statusString);
			} else {
				ctx.statusElement.info(statusString);
			}
			if (ctx.postFinish) {
				ctx.postFinish();
			}
			Morebits.wiki.removeCheckpoint();
			ctx.running = false;
			return;
		}

		// just for giggles! (well, serious debugging, actually)
		if (ctx.countFinished > total) {
			ctx.statusElement.warn('Done (overshot by ' + (ctx.countFinished - total) + ')');
			Morebits.wiki.removeCheckpoint();
			ctx.running = false;
			return;
		}

		ctx.statusElement.status(parseInt(100 * ctx.countFinished / total, 10) + '%');

		// start a new chunk if we're close enough to the end of the previous chunk, and
		// we haven't already started the next one
		if (ctx.countFinished >= (ctx.countStarted - Math.max(ctx.options.chunkSize / 10, 2)) &&
			Math.floor(ctx.countFinished / ctx.options.chunkSize) > ctx.currentChunkIndex) {
			fnStartNewChunk();
		}
	};
};



/**
 * **************** Morebits.simpleWindow ****************
 * A simple draggable window
 * now a wrapper for jQuery UI's dialog feature
 * @requires {jquery.ui.dialog}
 */

/**
 * @constructor
 * @param {number} width
 * @param {number} height  The maximum allowable height for the content area.
 */
Morebits.simpleWindow = function SimpleWindow(width, height) {
	var content = document.createElement('div');
	this.content = content;
	content.className = 'morebits-dialog-content';
	content.id = 'morebits-dialog-content-' + Math.round(Math.random() * 1e15);

	this.height = height;

	$(this.content).dialog({
		autoOpen: false,
		buttons: { 'Placeholder button': function() {} },
		dialogClass: 'morebits-dialog',
		width: Math.min(parseInt(window.innerWidth, 10), parseInt(width ? width : 800, 10)),
		// give jQuery the given height value (which represents the anticipated height of the dialog) here, so
		// it can position the dialog appropriately
		// the 20 pixels represents adjustment for the extra height of the jQuery dialog "chrome", compared
		// to that of the old SimpleWindow
		height: height + 20,
		close: function(event) {
			// dialogs and their content can be destroyed once closed
			$(event.target).dialog('destroy').remove();
		},
		resizeStart: function() {
			this.scrollbox = $(this).find('.morebits-scrollbox')[0];
			if (this.scrollbox) {
				this.scrollbox.style.maxHeight = 'none';
			}
		},
		resizeEnd: function() {
			this.scrollbox = null;
		},
		resize: function() {
			this.style.maxHeight = '';
			if (this.scrollbox) {
				this.scrollbox.style.width = '';
			}
		}
	});

	var $widget = $(this.content).dialog('widget');

	// delete the placeholder button (it's only there so the buttonpane gets created)
	$widget.find('button').each(function(key, value) {
		value.parentNode.removeChild(value);
	});

	// add container for the buttons we add, and the footer links (if any)
	var buttonspan = document.createElement('span');
	buttonspan.className = 'morebits-dialog-buttons';
	var linksspan = document.createElement('span');
	linksspan.className = 'morebits-dialog-footerlinks';
	$widget.find('.ui-dialog-buttonpane').append(buttonspan, linksspan);

	// resize the scrollbox with the dialog, if one is present
	$widget.resizable('option', 'alsoResize', '#' + this.content.id + ' .morebits-scrollbox, #' + this.content.id);
};

Morebits.simpleWindow.prototype = {
	buttons: [],
	height: 600,
	hasFooterLinks: false,
	scriptName: null,

	/**
	 * Focuses the dialog. This might work, or on the contrary, it might not.
	 * @returns {Morebits.simpleWindow}
	 */
	focus: function() {
		$(this.content).dialog('moveToTop');
		return this;
	},

	/**
	 * Closes the dialog. If this is set as an event handler, it will stop the event
	 * from doing anything more.
	 * @returns {Morebits.simpleWindow}
	 */
	close: function(event) {
		if (event) {
			event.preventDefault();
		}
		$(this.content).dialog('close');
		return this;
	},

	/**
	 * Shows the dialog. Calling display() on a dialog that has previously been closed
	 * might work, but it is not guaranteed.
	 * @returns {Morebits.simpleWindow}
	 */
	display: function() {
		if (this.scriptName) {
			var $widget = $(this.content).dialog('widget');
			$widget.find('.morebits-dialog-scriptname').remove();
			var scriptnamespan = document.createElement('span');
			scriptnamespan.className = 'morebits-dialog-scriptname';
			scriptnamespan.textContent = this.scriptName + ' \u00B7 ';  // U+00B7 MIDDLE DOT = &middot;
			$widget.find('.ui-dialog-title').prepend(scriptnamespan);
		}

		var dialog = $(this.content).dialog('open');
		if (window.setupTooltips && window.pg && window.pg.re && window.pg.re.diff) {  // tie in with NAVPOP
			dialog.parent()[0].ranSetupTooltipsAlready = false;
			window.setupTooltips(dialog.parent()[0]);
		}
		this.setHeight(this.height);  // init height algorithm
		return this;
	},

	/**
	 * Sets the dialog title.
	 * @param {string} title
	 * @returns {Morebits.simpleWindow}
	 */
	setTitle: function(title) {
		$(this.content).dialog('option', 'title', title);
		return this;
	},

	/**
	 * Sets the script name, appearing as a prefix to the title to help users determine which
	 * user script is producing which dialog. For instance, Twinkle modules set this to "Twinkle".
	 * @param {string} name
	 * @returns {Morebits.simpleWindow}
	 */
	setScriptName: function(name) {
		this.scriptName = name;
		return this;
	},

	/**
	 * Sets the dialog width.
	 * @param {number} width
	 * @returns {Morebits.simpleWindow}
	 */
	setWidth: function(width) {
		$(this.content).dialog('option', 'width', width);
		return this;
	},

	/**
	 * Sets the dialog's maximum height. The dialog will auto-size to fit its contents,
	 * but the content area will grow no larger than the height given here.
	 * @param {number} height
	 * @returns {Morebits.simpleWindow}
	 */
	setHeight: function(height) {
		this.height = height;

		// from display time onwards, let the browser determine the optimum height,
		// and instead limit the height at the given value
		// note that the given height will exclude the approx. 20px that the jQuery UI
		// chrome has in height in addition to the height of an equivalent "classic"
		// Morebits.simpleWindow
		if (parseInt(getComputedStyle($(this.content).dialog('widget')[0], null).height, 10) > window.innerHeight) {
			$(this.content).dialog('option', 'height', window.innerHeight - 2).dialog('option', 'position', 'top');
		} else {
			$(this.content).dialog('option', 'height', 'auto');
		}
		$(this.content).dialog('widget').find('.morebits-dialog-content')[0].style.maxHeight = parseInt(this.height - 30, 10) + 'px';
		return this;
	},

	/**
	 * Sets the content of the dialog to the given element node, usually from rendering
	 * a Morebits.quickForm.
	 * Re-enumerates the footer buttons, but leaves the footer links as they are.
	 * Be sure to call this at least once before the dialog is displayed...
	 * @param {HTMLElement} content
	 * @returns {Morebits.simpleWindow}
	 */
	setContent: function(content) {
		this.purgeContent();
		this.addContent(content);
		return this;
	},

	/**
	 * Adds the given element node to the dialog content.
	 * @param {HTMLElement} content
	 * @returns {Morebits.simpleWindow}
	 */
	addContent: function(content) {
		this.content.appendChild(content);

		// look for submit buttons in the content, hide them, and add a proxy button to the button pane
		var thisproxy = this;
		$(this.content).find('input[type="submit"], button[type="submit"]').each(function(key, value) {
			value.style.display = 'none';
			var button = document.createElement('button');
			button.textContent = value.hasAttribute('value') ? value.getAttribute('value') : value.textContent ? value.textContent : 'Submit Query';
			button.className = value.className || 'submitButtonProxy';
			// here is an instance of cheap coding, probably a memory-usage hit in using a closure here
			button.addEventListener('click', function() {
				value.click();
			}, false);
			thisproxy.buttons.push(button);
		});
		// remove all buttons from the button pane and re-add them
		if (this.buttons.length > 0) {
			$(this.content).dialog('widget').find('.morebits-dialog-buttons').empty().append(this.buttons)[0].removeAttribute('data-empty');
		} else {
			$(this.content).dialog('widget').find('.morebits-dialog-buttons')[0].setAttribute('data-empty', 'data-empty');  // used by CSS
		}
		return this;
	},

	/**
	 * Removes all contents from the dialog, barring any footer links
	 * @returns {Morebits.simpleWindow}
	 */
	purgeContent: function() {
		this.buttons = [];
		// delete all buttons in the buttonpane
		$(this.content).dialog('widget').find('.morebits-dialog-buttons').empty();

		while (this.content.hasChildNodes()) {
			this.content.removeChild(this.content.firstChild);
		}
		return this;
	},

	/**
	 * Adds a link in the bottom-right corner of the dialog.
	 * This can be used to provide help or policy links.
	 * For example, Twinkle's CSD module adds a link to the CSD policy page,
	 * as well as a link to Twinkle's documentation.
	 * @param {string} text  Link's text content
	 * @param {string} wikiPage  Link target
	 * @param {boolean} [prep=false] Set true to prepend rather than append
	 * @returns {Morebits.simpleWindow}
	 */
	addFooterLink: function(text, wikiPage, prep) {
		var $footerlinks = $(this.content).dialog('widget').find('.morebits-dialog-footerlinks');
		if (this.hasFooterLinks) {
			var bullet = document.createElement('span');
			bullet.textContent = ' \u2022 ';  // U+2022 BULLET
			if (prep) {
				$footerlinks.prepend(bullet);
			} else {
				$footerlinks.append(bullet);
			}
		}
		var link = document.createElement('a');
		link.setAttribute('href', mw.util.getUrl(wikiPage));
		link.setAttribute('title', wikiPage);
		link.setAttribute('target', '_blank');
		link.textContent = text;
		if (prep) {
			$footerlinks.prepend(link);
		} else {
			$footerlinks.append(link);
		}
		this.hasFooterLinks = true;
		return this;
	},

	/**
	 * Set whether the window should be modal or not.
	 * If set to true, other items on the page will be disabled, i.e., cannot be
	 * interacted with. Modal dialogs create an overlay below the dialog but above
	 * other page elements.
	 * This must be used (if necessary) before calling display()
	 * Default: false
	 * @param {boolean} modal
	 * @returns {Morebits.simpleWindow}
	 */
	setModality: function(modal) {
		$(this.content).dialog('option', 'modal', modal);
		return this;
	}
};

/**
 * Enables or disables all footer buttons on all Morebits.simpleWindows in the current page.
 * This should be called with `false` when the button(s) become irrelevant (e.g. just before
 * Morebits.status.init is called).
 * This is not an instance method so that consumers don't have to keep a reference to the
 * original Morebits.simpleWindow object sitting around somewhere. Anyway, most of the time
 * there will only be one Morebits.simpleWindow open, so this shouldn't matter.
 * @param {boolean} enabled
 */
Morebits.simpleWindow.setButtonsEnabled = function(enabled) {
	$('.morebits-dialog-buttons button').prop('disabled', !enabled);
};


// Twinkle blacklist was removed per consensus at http://en.wikipedia.org/wiki/Wikipedia:Administrators%27_noticeboard/Archive221#New_Twinkle_blacklist_proposal



}(window, document, jQuery)); // End wrap with anonymous function


/**
 * If this script is being executed outside a ResourceLoader context, we add some
 * global assignments for legacy scripts, hopefully these can be removed down the line
 *
 * IMPORTANT NOTE:
 * PLEASE DO NOT USE THESE ALIASES IN NEW CODE!
 * Thanks.
 */

if (typeof arguments === 'undefined') {  // typeof is here for a reason...
	/* global Morebits */
	window.SimpleWindow = Morebits.simpleWindow;
	window.QuickForm = Morebits.quickForm;
	window.Wikipedia = Morebits.wiki;
	window.Status = Morebits.status;
}

// </nowiki>