User:94rain/Twinkle/twinkle.js

From Meta, a Wikimedia project coordination wiki

Note: After publishing, you may have to bypass your browser's cache to see the changes.

  • Firefox / Safari: Hold Shift while clicking Reload, or press either Ctrl-F5 or Ctrl-R (⌘-R on a Mac)
  • Google Chrome: Press Ctrl-Shift-R (⌘-Shift-R on a Mac)
  • Internet Explorer / Edge: Hold Ctrl while clicking Refresh, or press Ctrl-F5
  • Opera: Press Ctrl-F5.
/**
 * +-------------------------------------------------------------------------+
 * |                  === WARNING: GLOBAL GADGET FILE ===                    |
 * |                Changes to this page affect many users.                  |
 * |           Please discuss changes at [[WT:TW]] before editing.           |
 * +-------------------------------------------------------------------------+
 *
 * Imported from github [https://github.com/azatoth/twinkle].
 * All changes should be made in the repository, otherwise they will be lost.
 *
 * To update this script from github, you must have a local repository set up. Then
 * follow the instructions at [https://github.com/azatoth/twinkle/blob/master/README.md].
 *
 * ----------
 *
 * This is AzaToth's Twinkle, the popular script sidekick for newbies, admins, and
 * every Wikipedian in between. Visit [[WP:TW]] for more information.
 */
// <nowiki>

/* global MorebitsGlobal */

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

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

// Check if account is experienced enough to use Twinkle
TwinkleGlobal.userAuthorized = MorebitsGlobal.userIsInGroup('autoconfirmed') || MorebitsGlobal.userIsInGroup('confirmed');

// for use by custom modules (normally empty)
TwinkleGlobal.initCallbacks = [];
TwinkleGlobal.addInitCallback = function twinkleAddInitCallback(func) {
	TwinkleGlobal.initCallbacks.push(func);
};

TwinkleGlobal.defaultConfig = {};
/**
 * Twinkle.defaultConfig.twinkle and Twinkle.defaultConfig.friendly
 *
 * This holds the default set of preferences used by Twinkle. (The |friendly| object holds preferences stored in the FriendlyConfig object.)
 * It is important that all new preferences added here, especially admin-only ones, are also added to
 * |Twinkle.config.sections| in twinkleconfig.js, so they are configurable via the Twinkle preferences panel.
 * For help on the actual preferences, see the comments in twinkleconfig.js.
 */
TwinkleGlobal.defaultConfig.twinkle = {
	// General
	summaryAd: '',
	deletionSummaryAd: '',
	protectionSummaryAd: '',
	userTalkPageMode: 'tab',
	dialogLargeFont: false,

	// ARV
	spiWatchReport: 'yes',
	customSRGReasonList: [],
	arvDisabledWikis: [
		{ 'value': 'zhwiki', 'label': '' },
		{ 'value': 'zhwiktionary', 'label': '' }
	],

	// Block
	blankTalkpageOnIndefBlock: false,

	// Fluff (revert and rollback)
	openTalkPage: [ 'agf', 'norm', 'vand' ],
	openTalkPageOnAutoRevert: false,
	markRevertedPagesAsMinor: [ 'vand' ],
	watchRevertedPages: [ 'agf', 'norm', 'vand', 'torev' ],
	offerReasonOnNormalRevert: true,
	confirmOnFluff: false,
	showRollbackLinks: [ 'diff', 'others' ],
	fluffDisabledWikis: [
		{ 'value': 'enwiki', 'label': '' },
		{ 'value': 'zh_classicalwiki', 'label': '' },
		{ 'value': 'zhwiki', 'label': '' },
		{ 'value': 'zhwikibooks', 'label': '' },
		{ 'value': 'zhwikiquote', 'label': '' },
		{ 'value': 'zhwikiversity', 'label': '' },
		{ 'value': 'zhwikivoyage', 'label': '' },
		{ 'value': 'zhwiktionary', 'label': '' }
	],

	// DI (twinkleimage)
	notifyUserOnDeli: true,
	deliWatchPage: 'default',
	deliWatchUser: 'default',

	// PROD
	watchProdPages: true,
	prodReasonDefault: '',
	logProdPages: false,
	prodLogPageName: 'PROD log',

	// CSD
	speedySelectionStyle: 'buttonClick',
	watchSpeedyPages: [ 'g3', 'g5', 'g10', 'g11', 'g12' ],
	markSpeedyPagesAsPatrolled: false,

	// these next two should probably be identical by default
	welcomeUserOnSpeedyDeletionNotification: [ 'db', 'g1', 'g2', 'g3', 'g4', 'g6', 'g10', 'g11', 'g12', 'g13', 'g14', 'a1', 'a2', 'a3', 'a5', 'a7', 'a9', 'a10', 'a11', 'f1', 'f2', 'f3', 'f7', 'f9', 'f10', 'u3', 'u5', 't2', 't3', 'p1', 'p2' ],
	notifyUserOnSpeedyDeletionNomination: [ 'db', 'g1', 'g2', 'g3', 'g4', 'g6', 'g10', 'g11', 'g12', 'g13', 'g14', 'a1', 'a2', 'a3', 'a5', 'a7', 'a9', 'a10', 'a11', 'f1', 'f2', 'f3', 'f7', 'f9', 'f10', 'u3', 'u5', 't2', 't3', 'p1', 'p2' ],
	warnUserOnSpeedyDelete: [ 'db', 'g1', 'g2', 'g3', 'g4', 'g6', 'g10', 'g11', 'g12', 'g13', 'g14', 'a1', 'a2', 'a3', 'a5', 'a7', 'a9', 'a10', 'a11', 'f1', 'f2', 'f3', 'f7', 'f9', 'f10', 'u3', 'u5', 't2', 't3', 'p1', 'p2' ],
	promptForSpeedyDeletionSummary: [],
	deleteTalkPageOnDelete: true,
	deleteRedirectsOnDelete: true,
	deleteSysopDefaultToTag: false,
	speedyWindowHeight: 500,
	speedyWindowWidth: 800,
	logSpeedyNominations: false,
	speedyLogPageName: 'CSD log',
	noLogOnSpeedyNomination: [ 'u1' ],

	// Unlink
	unlinkNamespaces: [ '0', '10', '100', '118' ],

	// Warn
	defaultWarningGroup: '1',
	showSharedIPNotice: true,
	watchWarnings: true,
	oldSelect: false,
	customWarningList: [],
	autoMenuAfterRollback: false,

	// XfD
	xfdWatchDiscussion: 'default',
	xfdWatchList: 'no',
	xfdWatchPage: 'default',
	xfdWatchUser: 'default',
	xfdWatchRelated: 'default',
	markXfdPagesAsPatrolled: true,

	// Diff
	diffDisabledWikis: [
		{ 'value': 'enwiki', 'label': '' },
		{ 'value': 'zh_classicalwiki', 'label': '' },
		{ 'value': 'zhwiki', 'label': '' },
		{ 'value': 'zhwikibooks', 'label': '' },
		{ 'value': 'zhwikiquote', 'label': '' },
		{ 'value': 'zhwikiversity', 'label': '' },
		{ 'value': 'zhwikivoyage', 'label': '' },
		{ 'value': 'zhwiktionary', 'label': '' }
	],

	// Hidden preferences
	revertMaxRevisions: 50,
	batchdeleteChunks: 50,
	batchMax: 5000,
	batchProtectChunks: 50,
	batchundeleteChunks: 50,
	proddeleteChunks: 50,
	configPage: '//meta.wikimedia.org/wiki/User:Xiplus/Twinkle/Preferences',
	metaApi: mw.config.get('wgServer') === '//meta.wikimedia.org'
		? new mw.Api()
		: new mw.ForeignApi('https://meta.wikimedia.org/w/api.php')
};

// now some skin dependent config.
if (mw.config.get('skin') === 'vector') {
	TwinkleGlobal.defaultConfig.twinkle.portletArea = 'right-navigation';
	TwinkleGlobal.defaultConfig.twinkle.portletId = 'p-twinkle';
	TwinkleGlobal.defaultConfig.twinkle.portletName = 'TW';
	TwinkleGlobal.defaultConfig.twinkle.portletType = 'menu';
	TwinkleGlobal.defaultConfig.twinkle.portletNext = 'p-search';
} else {
	TwinkleGlobal.defaultConfig.twinkle.portletArea = null;
	TwinkleGlobal.defaultConfig.twinkle.portletId = 'p-cactions';
	TwinkleGlobal.defaultConfig.twinkle.portletName = null;
	TwinkleGlobal.defaultConfig.twinkle.portletType = null;
	TwinkleGlobal.defaultConfig.twinkle.portletNext = null;
}

TwinkleGlobal.defaultConfig.friendly = {
	// Tag
	groupByDefault: true,
	watchTaggedPages: true,
	watchMergeDiscussions: true,
	markTaggedPagesAsMinor: false,
	markTaggedPagesAsPatrolled: true,
	tagArticleSortOrder: 'cat',
	customTagList: [],
	customFileTagList: [],
	customRedirectTagList: [],

	// Welcome
	topWelcomes: false,
	watchWelcomes: true,
	welcomeHeading: 'Welcome',
	insertHeadings: true,
	insertUsername: true,
	insertSignature: true,  // sign welcome templates, where appropriate
	quickWelcomeMode: 'norm',
	quickWelcomeTemplate: 'welcome',
	customWelcomeList: [],
	customWelcomeSignature: true,

	// Talkback
	markTalkbackAsMinor: true,
	insertTalkbackSignature: true,  // always sign talkback templates
	talkbackHeading: 'New message from ' + mw.config.get('wgUserName'),
	adminNoticeHeading: 'Notice',
	mailHeading: "You've got mail!",

	// Shared
	markSharedIPAsMinor: true
};

TwinkleGlobal.getPref = function twinkleGetPref(name) {
	var result;
	if (typeof TwinkleGlobal.prefs === 'object' && typeof TwinkleGlobal.prefs.twinkle === 'object') {
		// look in Twinkle.prefs (twinkleoptions.js)
		result = TwinkleGlobal.prefs.twinkle[name];
	} else if (typeof window.TwinkleConfig === 'object') {
		// look in TwinkleConfig
		result = window.TwinkleConfig[name];
	}

	if (result === undefined) {
		return TwinkleGlobal.defaultConfig.twinkle[name];
	}
	return result;
};

TwinkleGlobal.getFriendlyPref = function twinkleGetFriendlyPref(name) {
	var result;
	if (typeof TwinkleGlobal.prefs === 'object' && typeof TwinkleGlobal.prefs.friendly === 'object') {
		// look in Twinkle.prefs (twinkleoptions.js)
		result = TwinkleGlobal.prefs.friendly[name];
	} else if (typeof window.FriendlyConfig === 'object') {
		// look in FriendlyConfig
		result = window.FriendlyConfig[name];
	}

	if (result === undefined) {
		return TwinkleGlobal.defaultConfig.friendly[name];
	}
	return result;
};



/**
 * **************** Twinkle.addPortlet() ****************
 *
 * Adds a portlet menu to one of the navigation areas on the page.
 * This is necessarily quite a hack since skins, navigation areas, and
 * portlet menu types all work slightly different.
 *
 * Available navigation areas depend on the skin used.
 * Monobook:
 *  "column-one", outer div class "portlet", inner div class "pBody". Existing portlets: "p-cactions", "p-personal", "p-logo", "p-navigation", "p-search", "p-interaction", "p-tb", "p-coll-print_export"
 *  Special layout of p-cactions and p-personal through specialized styles.
 * Vector:
 *  "mw-panel", outer div class "portal", inner div class "body". Existing portlets/elements: "p-logo", "p-navigation", "p-interaction", "p-tb", "p-coll-print_export"
 *  "left-navigation", outer div class "vectorTabs" or "vectorMenu", inner div class "" or "menu". Existing portlets: "p-namespaces", "p-variants" (menu)
 *  "right-navigation", outer div class "vectorTabs" or "vectorMenu", inner div class "" or "menu". Existing portlets: "p-views", "p-cactions" (menu), "p-search"
 *  Special layout of p-personal portlet (part of "head") through specialized styles.
 * Modern:
 *  "mw_contentwrapper" (top nav), outer div class "portlet", inner div class "pBody". Existing portlets or elements: "p-cactions", "mw_content"
 *  "mw_portlets" (sidebar), outer div class "portlet", inner div class "pBody". Existing portlets: "p-navigation", "p-search", "p-interaction", "p-tb", "p-coll-print_export"
 *
 * @param String navigation -- id of the target navigation area (skin dependant, on vector either of "left-navigation", "right-navigation", or "mw-panel")
 * @param String id -- id of the portlet menu to create, preferably start with "p-".
 * @param String text -- name of the portlet menu to create. Visibility depends on the class used.
 * @param String type -- type of portlet. Currently only used for the vector non-sidebar portlets, pass "menu" to make this portlet a drop down menu.
 * @param Node nextnodeid -- the id of the node before which the new item should be added, should be another item in the same list, or undefined to place it at the end.
 *
 * @return Node -- the DOM node of the new item (a DIV element) or null
 */
TwinkleGlobal.addPortlet = function(navigation, id, text, type, nextnodeid) {
	// sanity checks, and get required DOM nodes
	var root = document.getElementById(navigation);
	if (!root) {
		return null;
	}

	var item = document.getElementById(id);
	if (item) {
		if (item.parentNode && item.parentNode === root) {
			return item;
		}
		return null;
	}

	var nextnode;
	if (nextnodeid) {
		nextnode = document.getElementById(nextnodeid);
	}

	// verify/normalize input
	var skin = mw.config.get('skin');
	type = skin === 'vector' && type === 'menu' && (navigation === 'left-navigation' || navigation === 'right-navigation') ? 'menu' : '';
	var outerDivClass;
	var innerDivClass;
	switch (skin) {
		case 'vector':
			if (navigation !== 'portal' && navigation !== 'left-navigation' && navigation !== 'right-navigation') {
				navigation = 'mw-panel';
			}
			outerDivClass = navigation === 'mw-panel' ? 'portal' : type === 'menu' ? 'vectorMenu' : 'vectorTabs';
			innerDivClass = navigation === 'mw-panel' ? 'body' : type === 'menu' ? 'menu' : '';
			break;
		case 'modern':
			if (navigation !== 'mw_portlets' && navigation !== 'mw_contentwrapper') {
				navigation = 'mw_portlets';
			}
			outerDivClass = 'portlet';
			innerDivClass = 'pBody';
			break;
		default:
			navigation = 'column-one';
			outerDivClass = 'portlet';
			innerDivClass = 'pBody';
			break;
	}

	// Build the DOM elements.
	var outerDiv = document.createElement('div');
	outerDiv.className = outerDivClass + ' emptyPortlet';
	outerDiv.id = id;
	if (nextnode && nextnode.parentNode === root) {
		root.insertBefore(outerDiv, nextnode);
	} else {
		root.appendChild(outerDiv);
	}

	if (outerDivClass === 'vectorMenu') {
		// add invisible checkbox to make menu keyboard accessible
		// similar to the p-cactions ("More") menu
		var chkbox = document.createElement('input');
		chkbox.className = 'vectorMenuCheckbox';
		chkbox.setAttribute('type', 'checkbox');
		chkbox.setAttribute('aria-labelledby', 'p-twinkle-label');
		outerDiv.appendChild(chkbox);
	}
	var h5 = document.createElement('h3');
	if (outerDivClass === 'vectorMenu') {
		h5.id = 'p-twinkle-label';
	}
	if (type === 'menu') {
		var span = document.createElement('span');
		span.appendChild(document.createTextNode(text));
		h5.appendChild(span);

		var a = document.createElement('a');
		a.href = '#';

		$(a).click(function (e) {
			e.preventDefault();

			if (!TwinkleGlobal.userAuthorized) {
				alert('Sorry, your account is too new to use Twinkle.');
			}
		});

		h5.appendChild(a);
	} else {
		h5.appendChild(document.createTextNode(text));
	}
	outerDiv.appendChild(h5);

	var innerDiv = null;
	if (type === 'menu') {
		innerDiv = document.createElement('div');
		innerDiv.className = innerDivClass;
		outerDiv.appendChild(innerDiv);
	}

	var ul = document.createElement('ul');
	(innerDiv || outerDiv).appendChild(ul);

	return outerDiv;
};


/**
 * **************** Twinkle.addPortletLink() ****************
 * Builds a portlet menu if it doesn't exist yet, and add the portlet link.
 * @param task: Either a URL for the portlet link or a function to execute.
 */
TwinkleGlobal.addPortletLink = function(task, text, id, tooltip) {
	if (TwinkleGlobal.getPref('portletArea') !== null) {
		TwinkleGlobal.addPortlet(TwinkleGlobal.getPref('portletArea'), TwinkleGlobal.getPref('portletId'), TwinkleGlobal.getPref('portletName'), TwinkleGlobal.getPref('portletType'), TwinkleGlobal.getPref('portletNext'));
	}
	var link = mw.util.addPortletLink(TwinkleGlobal.getPref('portletId'), typeof task === 'string' ? task : '#', text, id, tooltip);
	$('.client-js .skin-vector #p-cactions').css('margin-right', 'initial');
	if (typeof task === 'function') {
		$(link).click(function (ev) {
			task();
			ev.preventDefault();
		});
	}
	if ($.collapsibleTabs) {
		$.collapsibleTabs.handleResize();
	}
	return link;
};


/**
 * **************** General initialization code ****************
 */

var scriptpathbefore = '//meta.wikimedia.org/w/index.php?title=',
	scriptpathafter = '&action=raw&ctype=text/javascript&happy=yes';

// Retrieve the user's Twinkle preferences
mw.loader.getScript(scriptpathbefore + 'User:' + encodeURIComponent(mw.config.get('wgUserName')) + '/twinkleoptions.js' + scriptpathafter)
	.fail(function () {
		mw.notify('Could not load twinkleoptions.js');
	})
	.always(function () {
		$(TwinkleGlobal.load);
	});

// Developers: you can import custom Twinkle modules here
// For example, mw.loader.load(scriptpathbefore + "User:UncleDouggie/morebits-test.js" + scriptpathafter);

TwinkleGlobal.load = function () {
	// Don't activate on special pages other than those on the whitelist so that
	// they load faster, especially the watchlist.
	var specialPageWhitelist = [ 'Contributions', 'DeletedContributions', 'Prefixindex' ];
	var isSpecialPage = mw.config.get('wgNamespaceNumber') === -1 &&
		specialPageWhitelist.indexOf(mw.config.get('wgCanonicalSpecialPageName')) === -1;

	// Also, Twinkle is incompatible with Internet Explorer versions 8 or lower,
	// so don't load there either.
	var isOldIE = $.client.profile().name === 'msie' &&
		$.client.profile().versionNumber < 9;

	// Prevent users that are not autoconfirmed from loading Twinkle as well.
	if (isSpecialPage || isOldIE || !TwinkleGlobal.userAuthorized) {
		return;
	}

	// Prevent clickjacking
	if (window.top !== window.self) {
		return;
	}

	// Set custom Api-User-Agent header, for server-side logging purposes
	MorebitsGlobal.wiki.api.setApiUserAgent('Twinkle/2.0 (' + mw.config.get('wgDBname') + ')');

	// Load the modules in the order that the tabs should appear
	// User/user talk-related
	TwinkleGlobal.arv();
	// TwinkleGlobal.warn();
	if (MorebitsGlobal.userIsInGroup('sysop')) {
		// TwinkleGlobal.block();
	}
	 TwinkleGlobal.welcome();
	// TwinkleGlobal.shared();
	// TwinkleGlobal.talkback();
	// Deletion
	// TwinkleGlobal.speedy();
	// TwinkleGlobal.prod();
	// TwinkleGlobal.xfd();
	// TwinkleGlobal.image();
	// Maintenance
	// TwinkleGlobal.protect();
	// TwinkleGlobal.tag();
	// Misc. ones last
	TwinkleGlobal.diff();
	// TwinkleGlobal.unlink();
	TwinkleGlobal.config.init();
	TwinkleGlobal.fluff.init();
	if (MorebitsGlobal.userIsInGroup('sysop')) {
		// TwinkleGlobal.deprod();
		// TwinkleGlobal.batchdelete();
		// TwinkleGlobal.batchprotect();
		// TwinkleGlobal.batchundelete();
	}

	TwinkleGlobal.addPortletLink(TwinkleGlobal.getPref('configPage'), 'Pref', 'twg-config', 'Set Twinkle preferences');

	// Run the initialization callbacks for any custom modules
	TwinkleGlobal.initCallbacks.forEach(function (func) {
		func();
	});
	TwinkleGlobal.addInitCallback = function (func) {
		func();
	};

	// Increases text size in Twinkle dialogs, if so configured
	if (TwinkleGlobal.getPref('dialogLargeFont')) {
		mw.util.addCSS('.morebits-dialog-content, .morebits-dialog-footerlinks { font-size: 100% !important; } ' +
			'.morebits-dialog input, .morebits-dialog select, .morebits-dialog-content button { font-size: inherit !important; }');
	}
};

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

// </nowiki>