MediaWiki:Gadget-morebits.js: Perbedaan revisi

22.447 bita ditambahkan ,  5 bulan yang lalu
Repo at 5c1e7e3: Update from Github
(Maintenance: mw:RL/MGU - Updated deprecated module name)
(Repo at 5c1e7e3: Update from Github)
// <nowiki>
/**
* morebits.js
* - 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
*
* Most ofAll the stuff here doesn't workworks on IE < 9. Itall isbrowsers yourfor script'swhich responsibilityMediaWiki toprovides enforceJavaScript thissupport.
*
* This library is maintained by the maintainers of Twinkle.
 
 
( function ( window, document, $, undefined ) { // Wrap entire file with anonymous function
 
var Morebits = {};
* @returns {boolean}
*/
Morebits.userIsInGroup = function ( group ) {
return mw.config.get( 'wgUserGroups' ).indexOf( group ) !== -1;
};
// Used a lot
Morebits.userIsSysop = Morebits.userIsInGroup('sysop');
 
 
* 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
}
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 = '';
}
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;
*
* 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
* - 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
* - 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
/**
* @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 } );
};
 
/**
* 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
* @param {Object}
* comment for available types and attributes for each.
*/
Morebits.quickForm.element = function QuickFormElement( data ) {
this.data = data;
this.childs = [];
* @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;
};
* @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.userIsInGroup( 'sysop' ) 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( 'name', data.name );
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;
childContainder = select;
case 'option':
break;
case node = document.createElement('option':);
node.values = documentdata.createElement( 'option' )value;
node.values =setAttribute('value', data.value);
if (data.selected) {
node.setAttribute( 'value', data.value );
if node.setAttribute('selected', data.'selected ') {;
}
node.setAttribute( 'selected', 'selected' );
if (data.disabled) {
}
if node.setAttribute('disabled', data.'disabled ') {;
}
node.setAttribute( 'disabled', 'disabled' );
node.setAttribute('label', data.label);
}
node.setAttributeappendChild(document.createTextNode( 'label', data.label ));
break;
node.appendChild( document.createTextNode( data.label ) );
case 'optgroup':
break;
case node = document.createElement('optgroup':);
node = document.createElementsetAttribute( 'optgrouplabel', data.label);
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':
break;
node = document.createElement('fieldset');
case 'field':
node label = node.appendChild(document.createElement( 'fieldsetlegend' ));
label = node.appendChild( document.createElementcreateTextNode( 'legend' data.label) );
if (data.name) {
label.appendChild( document.createTextNode( data.label ) );
if node.setAttribute('name', data.name ) {;
}
node.setAttribute( 'name', data.name );
if (data.disabled) {
}
if node.setAttribute('disabled', data.'disabled ') {;
}
node.setAttribute( 'disabled', 'disabled' );
} break;
case 'checkbox':
break;
case 'checkboxradio':
node = document.createElement('div');
case 'radio':
if (data.list) {
node = document.createElement( 'div' );
if for (i = 0; i < data.list.length; ++i) {
for( var icur_id = 0;id i+ <'_' data.list.length;+ ++i ) {;
var cur_id current = id + '_' + data.list[i];
current var = data.list[i]cur_div;
if (current.type === 'header') {
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'));
continue;
subnode = cur_div.appendChild(document.createElement('input'));
}
subnode.values = current.value;
cur_div = node.appendChild( document.createElement( 'div' ) );
subnode = cur_div.appendChildsetAttribute( document.createElement( 'inputvalue', ) current.value);
subnode.values =setAttribute('name', current.valuename || data.name);
subnode.setAttribute( 'valuetype', currentdata.value type);
subnode.setAttribute( 'nameid', current.name || data.name 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 ( ! Arraycurrent.isArray( tmpgroup ) 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:var idtmpgroup += '_' + i + '_subgroup'current.subgroup;
 
});
$ if (!Array.eachisArray( tmpgroup, function( idx, el )) {
var newEl tmpgroup = $.extend( {},[ eltmpgroup )];
if( ! newEl.type ) {
newEl.type = data.type;
}
newEl.name = (current.name || data.name) + '.' + newEl.name;
subgroupRaw.append( newEl );
} );
 
var subgroupsubgroupRaw = subgroupRawnew Morebits.renderquickForm.element( cur_id );{
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 var subgroup = functionsubgroupRaw.render(ecur_id) {;
subgroup.className = 'quickformSubgroup';
if( e.target.checked ) {
esubnode.target.parentNode.appendChild(subgroup = e.target.subgroup );
if( esubnode.target.typeshown === 'radio' ) {false;
 
var name = e.target.name;
if(event e.target.form.names[name] !== undefined 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(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( delete e.target.checked ) {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
} else if( data(current.event ) {
subnode.addEventListener( 'change', datacurrent.event, false true);
}
} else if ( current.event ) {
subnode.addEventListener( 'change', current.event, true );
}
}
} break;
case 'input':
break;
node = document.createElement('div');
case 'input':
node = document.createElementsetAttribute('id', 'divdiv_' + id);
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( 'idtype', id 'text');
if (data.size) {
subnode.setAttribute( 'type', 'text' );
if subnode.setAttribute('size', data.size ) {;
}
subnode.setAttribute( 'size', data.size );
if (data.disabled) {
}
if subnode.setAttribute('disabled', data.'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' );
 
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',
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 ];
}
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 ) {
resultnode.appendChildsetAttribute('name', data.label[i] 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( 'typevalue', 'submit' data.label);
}
if( data.label ) {
childContainder.setAttribute( 'valuename', data.labelname || 'submit');
if (data.disabled) {
}
childContainder.setAttribute( 'namedisabled', data.name || 'submitdisabled' );
}
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( 'typevalue', 'button' data.label);
}
if( data.label ) {
childContainder.setAttribute( 'valuename', data.label name);
if (data.disabled) {
}
childContainder.setAttribute( 'namedisabled', data.name '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.appendChildsetAttribute( document.createElement( 'textareaname', ) data.name);
if (data.cols) {
subnode.setAttribute( 'name', data.name );
if subnode.setAttribute('cols', data.cols ) {;
}
subnode.setAttribute( 'cols', data.cols );
if (data.rows) {
}
if subnode.setAttribute('rows', data.rows ) {;
}
subnode.setAttribute( 'rows', data.rows );
if (data.disabled) {
}
if subnode.setAttribute('disabled', data.'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 ) {
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.
* @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 ) {
$('<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
});
};
 
/**
* Returns all form elements with a given field name or ID
* @returnsparam {HTMLElement[]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) {
* 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.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];
} else {
return element.parentNode.getElementsByTagName("label")[0];
}
};
 
*/
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);
*/
Morebits.quickForm.resetElementLabel = function QuickFormResetElementLabel(element) {
if (element.hasAttribute("'data-oldlabel"')) {
return Morebits.quickForm.setElementLabel(element, element.getAttribute("'data-oldlabel"'));
}
return null;
*/
Morebits.quickForm.setElementTooltipVisibility = function QuickFormSetElementTooltipVisibility(element, visibility) {
$(Morebits.quickForm.getElementContainer(element)).find("'.morebits-tooltip"').toggle(visibility);
};
 
* 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 );
}
}
*/
 
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 );
}
}
* Escapes a string to be used in a RegExp
* @param {string} text - string to be escaped
* @param {boolean} [space_fix=false] - Set this true to replace spaces and underscoreunderscores with `[ _]` as they are often equivalent
* 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
if ( space_fix ) {
text = text.replace( / |_/g, '[_ ]' );
}
 
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 );
},
 
* @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;
}
* @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();
},
 
/**
* Replacement forLike `String.prototype.replace()`, whenbut escapes any dollar signs in the secondreplacement parameterstring.
* (Useful when the the replacement string) is arbitrary, such as a username or freeform user input,
* and maycould 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, "'$$$$"'));
}
};
*/
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 );
}
}
*/
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 );
}
}
 
/**
* breaksBreak up `arr`an array into smaller arrays of length `size`, and.
* @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 ) {
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();
}
 
};
 
* 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) {
*
* 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
* @param {string} string
*/
Morebits.unbinder = function Unbinder( string ) {
if ( typeof string !== 'string' ) {
throw new Error( "'not a string" ');
}
this.content = string;
* @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 */
/**
* @returns {string} The output
*/
rebind: function UnbinderRebind() {
var content = this.content;
content.self = this;
for ( var current in this.history ) {
if( this(Object.historyprototype.hasOwnProperty.call(this.history, current ) ) {
content = content.replace( current, this.history[current] );
}
}
 
Morebits.unbinder.getCallback = function UnbinderGetCallback(self) {
return function UnbinderCallback( match ) {
var current = self.prefix + self.counter + self.postfix;
self.history[current] = match;
};
};
 
 
 
* 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',
'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
Date.prototype.getMonthName = function() {
return Date.monthNames[ this.getMonthgetUTCMonth() ];
};
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.getMonthgetUTCMonth() ];
};
 
 
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
 
/**
* 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.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() {
newif Morebits.status( Morebits.wiki.actionCompleted.notice,) Morebits.wiki.actionCompleted.postfix, 'info' );{
if Morebits.status.actionCompleted( Morebits.wiki.actionCompleted.redirect 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 );
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 = 'Action'null;
Morebits.wiki.actionCompleted.postfix = 'completed';
 
Morebits.wiki.addCheckpoint = function() {
 
Morebits.wiki.removeCheckpoint = function() {
if( (--Morebits.wiki.nbrOfCheckpointsLeft <= 0 && Morebits.wiki.numberOfActionsLeft <= 0 ) {
Morebits.wiki.actionCompleted.event();
}
 
/**
* 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 {ObjectMorebits.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.format = 'xml';
this.query.assert = 'user';
this.onSuccess = onSuccess;
this.onError = onError;
if ( statusElement ) {
this.statelem = setStatusElement(statusElement);
this.statelem.status( currentAction );
} 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.');
}
};
parent: window, // use global context if there is no parent object
query: null,
responseXMLresponse: 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
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);
},
 
/**
* @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 ajaxparamsqueryString = $.extendmap(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: Morebits.queryString.create(this.query),
dataType: 'xml',
headers: {
'Api-User-Agent': morebitsWikiApiUserAgent
}
}, callerAjaxParameters );
 
return $.ajax( ajaxparams ).donethen(
 
function(xml, statusText) {
function onAPIsuccess(response, statusText) {
this.statusText = statusText;
this.response = this.responseXML = xmlresponse;
if (this.errorCodequery.format === $(xml).find('errorjson').attr('code'); {
this.errorTexterrorCode = $(xml)response.error && response.find('error').attr('info')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
return this.returnError();
return;
}
 
// 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]);
).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.errorThrown = errorThrown; // frequently undefined
this.errorText = statusText + ' "' + jqXHR.statusText + '" occurred while contacting the API.';
return this.returnError();
}
 
); // the return value should be ignored, unless using callerAjaxParameters with |async: false|
);
},
 
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" );
this.statelem.error('Invalid token. Refresh the page and try again');
} else {
this.statelem.error( this.errorText );
}
 
// 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]);
},
 
},
 
getXML: function() { // retained for backwards compatibility, use getResponse() instead
return this.responseXML;
},
 
getResponse: function() {
return this.response;
}
 
};
 
* @param {string} ua User agent
*/
Morebits.wiki.api.setApiUserAgent = function( ua ) {
morebitsWikiApiUserAgent = ( ua ? ua + ' ' : '' ) + 'morebits.js/2.0 ([[w:WT:TW]])';
};
 
* of the page. Does not require calling load() first.
*
* move([onSuccess], [onFailure]): Moves a page to another title
*
* deletePagepatrol(onSuccess, [onFailure]): DeletesPatrols a page; (forignores admins only)errors
*
* triage(): Marks page as reviewed using PageTriage, which implies patrolled; ignores most errors
* undeletePage(onSuccess, [onFailure]): Undeletes a page (for admins only)
*
* protectdeletePage([onSuccess], [onFailure]): ProtectsDeletes 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
* getCurrentID(): returns a string containing the current revision ID of the page
*
* lookupCreatorlookupCreation(onSuccess): Retrieves the username ofand thetimestamp userof whopage created the pagecreation
* onSuccess - callback function which is called when the username isand foundtimestamp
* are found within the callback, the username 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
*
* getCreator(): returns the user who created the page following lookupCreatorlookupCreation()
*
* getCreationTimestamp(): returns an ISOString timestamp of page creation following lookupCreation()
*
*/
watchlistOption: 'nochange',
creator: null,
timestamp: null,
 
// - revert
protectCreate: null,
protectCascade: false,
 
// - creation lookup
lookupNonRedirectCreator: false,
 
// - stabilize (FlaggedRevs)
// internal status
pageLoaded: false,
editTokencsrfToken: null,
loadTime: null,
lastEditTime: null,
pageID: null,
revertCurID: null,
revertUser: null,
onSaveSuccess: null,
onSaveFailure: null,
onLookupCreatorSuccessonLookupCreationSuccess: null,
onMoveSuccess: null,
onMoveFailure: null,
loadApi: null,
saveApi: null,
lookupCreatorApilookupCreationApi: null,
moveApi: null,
moveProcessApi: null,
patrolApi: null,
patrolProcessApi: null,
triageApi: null,
triageProcessApi: null,
deleteApi: null,
deleteProcessApi: null,
* 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) {
// 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;
action: 'query',
prop: 'info|revisions',
curtimestamp: '',
intoken: 'edit', // fetch an edit token
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
ctx.loadQuery.rvsection = ctx.pageSection;
}
if (Morebits.userIsInGroup('sysop')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();
ctx.onSaveFailure = onFailure || emptyFunction;
 
// are we getting our editediting 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;
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;
title: ctx.pageName,
summary: ctx.editSummary,
token: canUseMwUserToken ? mw.user.tokens.get('csrfToken') : ctx.editTokencsrfToken,
watchlist: ctx.watchlistOption
};
 
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;
}
 
}
 
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) {
* 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) {
};
 
/** @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() {
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() {
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) {
ctx.editMode = 'all';
};
 
/** @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) {
ctx.editMode = 'append';
};
 
/** @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) {
ctx.editMode = 'prepend';
 
// 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) {
ctx.editSummary = summary;
 
/**
* @param {string} `createOption` is- acan stringtake the following four valuevalues:
* '`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 retrievingloading the edit tokenpage and saving the edit (default)
*
*/
};
 
/** @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) {
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) {
ctx.botEdit = botEdit;
 
/**
* `@param {number} pageSection` - integer specifying the section number to load or save.
* TheIf defaultspecified isas `null`, which means that the entire page will be retrieved.
*/
this.setPageSection = function(pageSection) {
 
/**
* `maxRetries`@param {number} maxConflictRetries - number of retries for save errors involving an edit conflict or loss of edit token.Default: 2
* loss of token. Default: 2
*/
this.setMaxConflictRetries = function(maxRetriesmaxConflictRetries) {
ctx.maxConflictRetries = maxRetriesmaxConflictRetries;
};
 
/**
* `@param {number} maxRetries` - number of retries for save errors not involving an edit conflict or loss of edit token
* loss of token. Default: 2
*/
this.setMaxRetries = function(maxRetries) {
 
/**
* @param `watchlistOption` is a {boolean} value: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) {
 
/**
* @param {boolean} `watchlistOption` is a boolean value:
* 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:
 
/**
* @param {boolean} `followRedirect` is a boolean value:
* Truetrue - 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().
* Falsefalse - 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;
};
 
/** @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() {
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;
};
 
};
 
/**
 
* @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 {string} Page ID of the userpage wholoaded. created0 if the page following lookupCreator()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() {
 
/**
* @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
* called when the username isand timestamp are found within the callback, the username.
* 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.lookupCreatorlookupCreation = function(onSuccess) {
if (!onSuccess) {
ctx.statusElement.error("'Internal error: no onSuccess callback provided to lookupCreatorlookupCreation()!"');
return;
}
ctx.onLookupCreatorSuccessonLookupCreationSuccess = onSuccess;
 
var query = {
'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) {
}
 
ctx.lookupCreatorApilookupCreationApi = new Morebits.wiki.api("'Retrieving page creatorcreation information"', query, fnLookupCreatorSuccessfnLookupCreationSuccess, ctx.statusElement);
ctx.lookupCreatorApilookupCreationApi.setParent(this);
ctx.lookupCreatorApilookupCreationApi.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
* @param {Function} [onSuccess] - callback function to run on success (optional)
* @param {Function} [onFailure] - callback function to run on failure (optional)
*/
 
if (!ctx.revertOldID) {
ctx.statusElement.error("'Internal error: revision ID to revert to was not set before revert!"');
ctx.onSaveFailure(this);
return;
/**
* 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)
*/
 
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')) {
var query = {
fnProcessMove.call(this, this);
action: 'query',
} else {
prop: 'info',
intoken: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();
}
}
};
 
/**
* 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)
*/
 
// if a non-admin tries to do this, don't bother
if (!Morebits.userIsInGroup('sysop')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;
fnProcessDelete.call(this, this);
} else {
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.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)
*/
 
// if a non-admin tries to do this, don't bother
if (!Morebits.userIsInGroup('sysop')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;
fnProcessUndelete.call(this, this);
} else {
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.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)
*/
 
// if a non-admin tries to do this, don't bother
if (!Morebits.userIsInGroup('sysop')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
// (absolute, not differential), we always need to request protection levels from the server
// 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.setParent(this);
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) {
ctx.onStabilizeSuccess = onSuccess;
 
// if a non-admin tries to do this, don't bother
if (!Morebits.userIsInGroup('sysop')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')) {
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();
};
 
 
/**
* Determines whether we can save an API call by using the editcsrf 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 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}
*/
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
 
// do we need to fetch the edit protection expiry?
if (Morebits.userIsInGroup('sysop')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;
}
 
// 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 !!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;
};
 
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.userIsInGroup('sysop')userIsSysop) {
var editprot = $(xml).find('pr[type="edit"]');
if (editprot.length > 0 && editprot.attr('level') === 'sysop') {
}
 
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.revertCurID = $(xml).find('page').attr('lastrevid');
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;
}
 
 
// 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 {
else {
// could be a circular redirect or other problem
ctx.statusElement.error("'Could not resolve redirects for: "' + ctx.pageName);
onFailure(this);
 
}
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');
});
};
 
 
// 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, ')']);
}
 
// errors here are only generated by extensions which hook APIEditBeforeSave within MediaWiki,
// Wikimediawhich wikisas shouldof only1.34.0-wmf.23 return(Sept spam2019) blacklistshould errors, captchas,only andencompass AbuseFiltercaptcha messages
var $editNode =if ($(xml).find('editcaptcha');.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 {
ctx.statusElement.error("'Unknown error received from API while saving page"');
}
 
// 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 purgeApi = new Morebits.wiki.api("'Edit conflict detected, purging server cache"', purgeQuery, null,function() ctx.statusElement);{
--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.saveApiloadApi.post(); // necessarilyreload appendthe orpage prepend,and soreapply thisthe should work as desirededit
} else {
}, ctx.statusElement);
ctx.loadApi.post(); // reload the page and reapply the edit
purgeApi.post();
}
 
// 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"');
--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
} 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!
 
// 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
};
 
var fnLookupCreatorSuccessfnLookupCreationSuccess = function() {
var xml = ctx.lookupCreatorApilookupCreationApi.getXML();
 
if ( !fnCheckPageName(xml) ) {
return; // abort
}
 
if (!ctx.creatorlookupNonRedirectCreator =|| !/^\s*#redirect/i.test($(xml).find('rev').attrtext('user');)) {
 
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.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;
}
 
ctx.onLookupCreatorSuccess(this);
ctx.onLookupCreationSuccess(this);
 
};
 
var fnProcessMove = function() {
var pageTitle, token;
var xml = ctx.moveApi.getXML();
 
if ($(xml).find('page').attrfnCanUseMwUserToken('missingmove') === "") {
token = mw.user.tokens.get('csrfToken');
ctx.statusElement.error("Cannot move the page, because it no longer exists");
pageTitle = ctx.onMoveFailure(this)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);
return;
}
}
 
// extract protection info
var moveToken = $(xml).find('page').attr('movetoken');
if (!moveTokenMorebits.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 = {
'action': 'move',
'from': $(xml).find('page').attr('title')pageTitle,
'to': ctx.moveDestination,
'token': moveTokentoken,
'reason': ctx.editSummary,
'watchlist': ctx.watchlistOption
};
if (ctx.moveTalkPage) {
}
if (ctx.moveSubpages) {
query.movesubpages = 'true'; // XXX don't know whether this works for non-admins
}
if (ctx.moveSuppressRedirect) {
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.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 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;
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('pagetokens').attr('deletetokencsrftoken');
if (!token) {
ctx.statusElement.error("'Failed to retrieve delete token."');
ctx.onDeleteFailure(this);
return;
'title': pageTitle,
'token': token,
'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.setParent(this);
ctx.deleteProcessApi.post();
 
// 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');
// 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" ') {
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 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')) {
token = mw.user.tokens.get('csrfToken');
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;
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');
// 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');
}
 
'title': pageTitle,
'token': token,
'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.setParent(this);
ctx.undeleteProcessApi.post();
 
// 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');
// 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" ') {
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 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 protectTokentoken = $(xml).find('pagetokens').attr('protecttokencsrftoken');
if (!protectTokentoken) {
ctx.statusElement.error("'Failed to retrieve protect token."');
ctx.onProtectFailure(this);
return;
}
 
var pageTitle = $(xml).find('page').attr('title');
 
// fetch existing protection levels
expirys.push(ctx.protectEdit.expiry);
} else if (editprot.length) {
protections.push('edit=' + editprot.attr("'level"'));
expirys.push(editprot.attr("'expiry"').replace("'infinity"', "'indefinite"'));
}
 
expirys.push(ctx.protectMove.expiry);
} else if (moveprot.length) {
protections.push('move=' + moveprot.attr("'level"'));
expirys.push(moveprot.attr("'expiry"').replace("'infinity"', "'indefinite"'));
}
 
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: $(xml).find('page').attr('title')pageTitle,
token: protectTokentoken,
protections: protections.join('|'),
expiry: expirys.join('|'),
reason: ctx.editSummary,
watchlist: ctx.watchlistOption
};
if (ctx.protectCascade) {
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.setParent(this);
ctx.protectProcessApi.post();
 
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 stabilizeTokenmissing = $(xml).find('page').attr('edittokenmissing') === '';
if (!stabilizeTokenmissing) {
ctx.statusElement.error("Failed'Cannot toprotect retrievethe stabilizepage, token."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: $(xml).find('page').attr('title')pageTitle,
token: stabilizeTokentoken,
protectlevel: ctx.flaggedRevs.level,
expiry: ctx.flaggedRevs.expiry,
reason: ctx.editSummary
};
// [[phab:T247915]]
if (ctx.watchlistOption === 'watch') {
query.watchwatchlist = 'true';
}
 
ctx.stabilizeProcessApi = new Morebits.wiki.api("'configuring stabilization settings..."', query, ctx.onStabilizeSuccess, ctx.statusElement, ctx.onStabilizeFailure);
ctx.stabilizeProcessApi.setParent(this);
ctx.stabilizeProcessApi.post();
/**
* @constructor
* @param {HTMLDivElementHTMLElement} previewbox - the <div> element that will contain the rendered HTML,
* usually a <div> element
*/
Morebits.wiki.preview = function(previewbox) {
this.previewbox = previewbox;
$(previewbox).addClass("'morebits-previewbox"').hide();
 
/**
* 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) {
title: pageTitle || mw.config.get('wgPageName')
};
var renderApi = new Morebits.wiki.api("'loading..."', query, fnRenderSuccess, new Morebits.status("'Preview"'));
renderApi.post();
};
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. */
/**
* Hides the preview box and clears it.
*/
this.closePreview = function() {
$(previewbox).empty().hide();
 
Morebits.wikitext.template = {
parse: function( text, start ) {
var count = -1;
var level = -1;
var key, value;
 
for( (var i = start; i < text.length; ++i ) {
var test3 = text.substr( i, 3 );
if ( test3 === '{{{' ) {
current += '{{{';
i += 2;
continue;
}
if ( test3 === '}}}' ) {
current += '}}}';
i += 2;
continue;
}
var test2 = text.substr( i, 2 );
if( (test2 === '{{' || test2 === '[[' ) {
current += test2;
++i;
continue;
}
if ( test2 === ']]' ) {
current += ']]';
++i;
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;
}
 
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;
}
current = '';
} else if( (equals === -1 && text.charAt(i) === '=' && level <= 0 ) {
equals = current.length;
current += text.charAt(i);
* @param {string} text
*/
Morebits.wikitext.page = function mediawikiPage( text ) {
this.text = 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. [[:FileUser:Test.png]]
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" ');
},
 
* @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();
* @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 );
},
 
* 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.queryStringuserspaceLogger ****************
* 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 ) {
this.textRaw = text;
this.text = this.codify(text);
this.type = type || 'status';
this.generate();
if ( stat ) {
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() ) {
root.removeChild( root.firstChild );
}
Morebits.status.root = root;
Morebits.status.root = null;
 
/** @param {Function} handler - function to execute on error */
Morebits.status.onError = function( handler ) {
if ( typeof handlerMorebits.status.onError === 'function' (handler) {
if (typeof handler === 'function') {
Morebits.status.errorEvent = handler;
} else {
throw "'Morebits.status.onError: handler is not a function"';
}
};
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;
}
},
 
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 ];
}
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
}
 
},
 
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;
if (type === 'error') {
 
// 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 = 'tw_status_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 don'tmay re-use it
* @param {string} comments
* @param {string} message
*/
Morebits.status.printUserText = function( comments, message ) {
var p = document.createElement( 'p' );
p.textContentinnerHTML = 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);
Morebits.htmlNode = function ( type, content, color ) {
if (color) {
var node = document.createElement( type );
if( color ) {
node.style.color = color;
}
node.appendChild( document.createTextNode( content ) );
return node;
};
 
/**
* **************** Morebits.checkboxClickHandlercheckboxShiftClickSupport() ****************
* 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;
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;
 
for (i = start; i <= finish; i++) {
if (cbs[i].checked !== endState;) {
cbs[i].click();
}
}
}
 
/** **************** Morebits.batchOperation ****************
* Iterates over a group of pages (or arbitrary objects) and executes a worker function for each.
* for each.
*
* Constructor: Morebits.batchOperation(currentAction)
* 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 given 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
* 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
 
// 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,
/**
* Sets the list of pages to work on
* @param {String[]Array} pageList Array of pageobjects over which you wish to execute the namesworker (strings)function
* This is usually the list of page names (strings).
*/
this.setPageList = function(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) {
 
/**
* Runs the givenfirst 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.worker = worker;
ctx.postFinish = postFinish;
ctx.countStarted = 0;
ctx.countFinished = 0;
var total = ctx.pageList.length;
if (!total) {
ctx.statusElement.info("nothing'no topages do"specified');
ctx.running = false;
if (ctx.postFinish) {
ctx.postFinish();
}
return;
}
// start the process
Morebits.wiki.addCheckpoint();
ctx.statusElement.status("'0%"');
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 (apiobjarg.getPageName || apiobjarg.pageName || (apiobjarg.query && apiobjarg.query.title)) {
// we know the page title - display a relevant message
var pageName = apiobjarg.getPageName ? apiobjarg.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 {
// we don't know the page title - just display a generic message
}
} else {
// remove the status line fromautomatically displayproduced by Morebits.wiki.*
statelem.unlink();
}
 
} else if (typeof arg === 'string' && ctx.options.preserveIndividualStatusLines) {
new Morebits.status(arg, ['done (', createPageLink(arg), ')']);
}
 
ctx.countFinishedSuccess++;
fnDoneOne(apiobj);
};
 
this.workerFailure = function(apiobj) {
fnDoneOne(apiobj);
};
 
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();
// 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;
}
 
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
* A simple draggable window
* now a wrapper for jQuery UI's dialog feature
* @requires {jquery.ui.dialog}
*/
 
* @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';
$(this.content).dialog({
autoOpen: false,
buttons: { "'Placeholder button"': function() {} },
dialogClass: 'morebits-dialog',
width: Math.min(parseInt(window.innerWidth, 10), parseInt(width ? width : 800, 10)),
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"';
}
},
},
resize: function() {
this.style.maxHeight = ""'';
if (this.scrollbox) {
this.scrollbox.style.width = ""'';
}
}
});
 
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)
$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);
};
 
*/
focus: function() {
$(this.content).dialog("'moveToTop"');
return this;
},
event.preventDefault();
}
$(this.content).dialog("'close"');
return this;
},
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;
},
* @returns {Morebits.simpleWindow}
*/
setTitle: function( title ) {
$(this.content).dialog("'option"', "'title"', title);
return this;
},
* @returns {Morebits.simpleWindow}
*/
setScriptName: function( name ) {
this.scriptName = name;
return this;
* @returns {Morebits.simpleWindow}
*/
setWidth: function( width ) {
$(this.content).dialog("'option"', "'width"', width);
return this;
},
* @returns {Morebits.simpleWindow}
*/
setHeight: function( height ) {
this.height = height;
 
// 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;
},
* @returns {Morebits.simpleWindow}
*/
setContent: function( content ) {
this.purgeContent();
this.addContent( content );
return this;
},
* @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);
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;
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;
* 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.append(bullet);
$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.append(link);
$footerlinks.prepend(link);
} else {
$footerlinks.append(link);
}
this.hasFooterLinks = true;
return this;
* @returns {Morebits.simpleWindow}
*/
setModality: function( modal ) {
$(this.content).dialog("'option"', "'modal"', modal);
return this;
}
* @param {boolean} enabled
*/
Morebits.simpleWindow.setButtonsEnabled = function( enabled ) {
$("'.morebits-dialog-buttons button"').prop("'disabled"', !enabled);
};
 
 
 
} ( window, document, jQuery )); // End wrap with anonymous function
 
 
*/
 
if ( typeof arguments === "'undefined" ') { // typeof is here for a reason...
/* global Morebits */
window.SimpleWindow = Morebits.simpleWindow;
window.Wikipedia = Morebits.wiki;
window.Status = Morebits.status;
window.QueryString = Morebits.queryString;
}
 
// </nowiki>