User:Smallman12q/cal.js

From Wikimedia Commons, the free media repository
Jump to navigation Jump to search
Note: After saving, you have to bypass your browser's cache to see the changes. Internet Explorer: press Ctrl-F5, Mozilla: hold down Shift while clicking Reload (or press Ctrl-Shift-R), Opera/Konqueror: press F5, Safari: hold down Shift + Alt while clicking Reload, Chrome: hold down Shift while clicking Reload.
// <nowiki>
//
// Cat-A-Lot
// Changes category of multiple files
//
// Originally by Magnus Manske
// RegExes by Ilmari Karonen
// Completely rewritten by DieBuche
//
// READ THIS PAGE IF YOU WANT TO TRANSLATE OR USE THIS ON ANOTHER SITE:
// http://commons.wikimedia.org/wiki/MediaWiki:Gadget-Cat-a-lot.js/translating
//
 
/*global jQuery:false, mediaWiki:false */
/*jshint curly:false*/
 
(function($, mw) {
'use strict';
 
var nsNumber = mw.config.get('wgNamespaceNumber');
 
// Temporary to show a watchlist note targeted to cat-a-lot users
if (-1 === nsNumber && 'Watchlist' === mw.config.get('wgCanonicalSpecialPageName')) {
	$('#catALotChange').show();
}
 
window.catALot = {
	apiUrl: wgScriptPath + "/api.php",
	searchmode: false,
	version: 2.5,
	setHeight: 450,
	init: function() {
		$("body").append('<div id="cat_a_lot">' + '<div id="cat_a_lot_data"><div>' + '<input type="text" id="cat_a_lot_searchcatname" placeholder="' + this.i18n.enterName + '"/>' + '</div><div id="cat_a_lot_category_list"></div>' + '<div id="cat_a_lot_mark_counter"> </div>' + '<div id="cat_a_lot_selections">' + this.i18n.select + ' <a id="cat_a_lot_select_all">' + this.i18n.all + '</a> / ' + '<a id="cat_a_lot_select_none">' + this.i18n.none + '</a>' + '</div></div><div id="cat_a_lot_head">' + '<a id="cat_a_lot_toggle">Cat-a-lot</a></div></div>');
 
		if (!this.searchmode) $('#cat_a_lot_selections').append('<br><a id="cat_a_lot_remove"><b>' + this.i18n.removeFromCat + '</b></a>');
 
		$('#cat_a_lot_searchcatname').keypress(function(e) {
			if (e.which == 13) catALot.updateCats($(this).val());
		}).autocomplete({
			source: function(request, response) {
				catALot.doAPICall({
					action: 'opensearch',
					search: request.term,
					namespace: 14
				}, function(data) {
					if (data[1]) response($(data[1]).map(function(index, item) {
						return item.replace(/.*:/, '');
					}));
				});
			},
			open: function() {
				$(".ui-autocomplete").position({
					my: $('body').is('.rtl') ? "left bottom" : "right bottom",
					at: $('body').is('.rtl') ? "left top" : "right top",
					of: $('#cat_a_lot_searchcatname')
				});
			}
		});
		$('#cat_a_lot_remove').click(function() {
			catALot.remove();
		});
		$('#cat_a_lot_select_all').click(function() {
			catALot.toggleAll(true);
		});
		$('#cat_a_lot_select_none').click(function() {
			catALot.toggleAll(false);
		});
		$('#cat_a_lot_toggle').click(function() {
			$(this).toggleClass('cat_a_lot_enabled');
			catALot.run();
		});
 
		mw.loader.load('//commons.wikimedia.org/w/index.php?action=raw&ctype=text/css&title=MediaWiki:Gadget-Cat-a-lot.css', 'text/css');
		this.localCatName = mw.config.get('wgFormattedNamespaces')[14];
	},
	findAllLabels: function() {
		// It's possible to allow any kind of pages as well but what happens if you click on "select all" and don't expect it
		if (this.searchmode) this.labels = $('table.searchResultImage').find('tr>td:eq(1)'); //.add('div.mw-search-result-heading')
		else this.labels = $('div.gallerytext'); // , div#mw-pages li, div#mw-category-media li
	},
 
	getTitleFromLink: function(href) {
		try {
			return decodeURIComponent(href).match(/wiki\/(.+?)(?:#.+)?$/)[1].replace(/_/g, ' ');
		} catch (ex) {
			return '';
		}
	},
 
	getMarkedLabels: function() {
		var marked = [];
		this.selectedLabels = this.labels.filter('.cat_a_lot_selected');
		this.selectedLabels.each(function() {
			var file = $(this).find('a[title]');
			marked.push([file.attr('title') || catALot.getTitleFromLink(file.attr('href')), $(this)]);
		});
		return marked;
	},
 
	updateSelectionCounter: function() {
		this.selectedLabels = this.labels.filter('.cat_a_lot_selected');
		$('#cat_a_lot_mark_counter').show().html(this.selectedLabels.length + this.i18n.filesSelected);
	},
 
	makeClickable: function() {
		this.findAllLabels();
		this.labels.click(function() {
			$(this).toggleClass('cat_a_lot_selected');
			catALot.updateSelectionCounter();
		});
	},
 
	toggleAll: function(select) {
		this.labels.toggleClass('cat_a_lot_selected', select);
		this.updateSelectionCounter();
	},
 
	getSubCats: function() {
		var data = {
			action: 'query',
			list: 'categorymembers',
			cmtype: 'subcat',
			cmlimit: 50,
			cmtitle: 'Category:' + this.currentCategory
		};
 
		this.doAPICall(data, function(result) {
 
			var cats = result.query.categorymembers;
 
			catALot.subCats = [];
			for (var i = 0; i < cats.length; i++) {
				catALot.subCats.push(cats[i].title.replace(/^[^:]+:/, ""));
			}
			catALot.catCounter++;
			if (catALot.catCounter == 2) catALot.showCategoryList();
		});
	},
 
 
	getParentCats: function() {
		var data = {
			action: 'query',
			prop: 'categories',
			titles: 'Category:' + this.currentCategory
		};
		this.doAPICall(data, function(result) {
			catALot.parentCats = [];
			var cats, pages = result.query.pages;
			if (pages[-1] && pages[-1].missing === '') {
				catALot.catlist.html('<span id="cat_a_lot_no_found">' + catALot.i18n.catNotFound + '</span>');
				document.body.style.cursor = 'auto';
 
				catALot.catlist.append('<ul></ul>');
				catALot.createCatLinks("→", [catALot.currentCategory]);
				return;
			}
			// there should be only one, but we don't know its ID
			for (var id in pages) {
				cats = pages[id].categories;
			}
			for (var i = 0; i < cats.length; i++) {
				catALot.parentCats.push(cats[i].title.replace(/^[^:]+:/, ""));
			}
 
			catALot.catCounter++;
			if (catALot.catCounter == 2) catALot.showCategoryList();
		});
	},
	localizedRegex: function(namespaceNumber, fallback) {
		//Copied from HotCat. Thanks Lupo.
		var wikiTextBlank = '[\\t _\\xA0\\u1680\\u180E\\u2000-\\u200A\\u2028\\u2029\\u202F\\u205F\\u3000]+';
		var wikiTextBlankRE = new RegExp(wikiTextBlank, 'g');
 
		var createRegexStr = function(name) {
				if (!name || name.length === 0) return "";
				var regex_name = "";
				for (var i = 0; i < name.length; i++) {
					var initial = name.substr(i, 1);
					var ll = initial.toLowerCase();
					var ul = initial.toUpperCase();
					if (ll == ul) {
						regex_name += initial;
					} else {
						regex_name += '[' + ll + ul + ']';
					}
				}
				return regex_name.replace(/([\\\^\$\.\?\*\+\(\)])/g, '\\$1').replace(wikiTextBlankRE, wikiTextBlank);
		};
 
		fallback = fallback.toLowerCase();
		var canonical = mw.config.get('wgFormattedNamespaces',{})[namespaceNumber].toLowerCase();
		var RegexString = createRegexStr(canonical);
		if (fallback && canonical != fallback) RegexString += '|' + createRegexStr(fallback);
		for (var catName in wgNamespaceIds) {
			if (typeof(catName) == 'string' && catName.toLowerCase() != canonical && catName.toLowerCase() != fallback && wgNamespaceIds[catName] == namespaceNumber) {
				RegexString += '|' + createRegexStr(catName);
			}
		}
		return RegexString;
	},
	regexBuilder: function(category) {
		var catname = this.localizedRegex(14, 'Category');
 
		// Build a regexp string for matching the given category:
		// trim leading/trailing whitespace and underscores
		category = category.replace(/^[\s_]+/, "").replace(/[\s_]+$/, "");
 
		// escape regexp metacharacters (= any ASCII punctuation except _)
		category = category.replace(/([!-\/:-@\[-^`{-~])/g, '\\$1');
 
		// any sequence of spaces and underscores should match any other
		category = category.replace(/[\s_]+/g, '[\\s_]+');
 
		// Make the first character case-insensitive:
		var first = category.substr(0, 1);
		if (first.toUpperCase() != first.toLowerCase()) category = '[' + first.toUpperCase() + first.toLowerCase() + ']' + category.substr(1);
 
		// Compile it into a RegExp that matches MediaWiki category syntax (yeah, it looks ugly):
		// XXX: the first capturing parens are assumed to match the sortkey, if present, including the | but excluding the ]]
		return new RegExp('\\[\\[[\\s_]*' + catname + '[\\s_]*:[\\s_]*' + category + '[\\s_]*(\\|[^\\]]*(?:\\][^\\]]+)*)?\\]\\]', 'g');
	},
 
	getContent: function(file, targetcat, mode) {
 
		var data = {
			action: 'query',
			prop: 'info|revisions',
			rvprop: 'content|timestamp',
			intoken: 'edit',
			titles: file[0]
		};
 
		this.doAPICall(data, function(result) {
			catALot.editCategories(result, file, targetcat, mode);
		});
	},
 
	// Remove {{Uncategorized}}. No need to replace it with anything.
	removeUncat: function(text) {
		return text.replace(/\{\{\s*[Uu]ncategorized\s*(\|?.*?)\}\}/, "");
	},
 
	editCategories: function(result, file, targetcat, mode) {
		var otext, starttimestamp, timestamp;
		if (result == null) {
			//Happens on unstable wifi connections..
			this.connectionError.push(file[0]);
			this.updateCounter();
			return;
		}
		var pages = result.query.pages;
 
		// there should be only one, but we don't know its ID
		for (var id in pages) {
			// The edittoken only changes between logins
			this.edittoken = pages[id].edittoken;
			otext = pages[id].revisions[0]['*'];
			starttimestamp = pages[id].starttimestamp;
			timestamp = pages[id].revisions[0]['timestamp'];
		}
 
 
		var sourcecat = wgTitle;
		// Check if that file is already in that category
		if (mode != "remove" && this.regexBuilder(targetcat).test(otext)) {
 
			//If the new cat is already there, just remove the old one.
			if (mode == 'move') {
				mode = 'remove';
			} else {
				this.alreadyThere.push(file[0]);
				this.updateCounter();
				return;
			}
		}
 
		var text = otext;
		var comment;
 
		// Fix text
		switch (mode) {
		case 'add':
			text += "\n[[" + this.localCatName + ":" + targetcat + "]]\n";
			comment = this.i18n.summaryAdd + targetcat + "]]";
			break;
		case 'copy':
			text = text.replace(this.regexBuilder(sourcecat), "[[" + this.localCatName + ":" + sourcecat + "$1]]\n[[" + this.localCatName + ":" + targetcat + "$1]]");
			comment = this.i18n.summaryCopy + sourcecat + "]] " + this.i18n.to + targetcat + "]]";
			//If category is added through template:
			if (otext == text) {
				text += "\n[[" + this.localCatName + ":" + targetcat + "]]";
			}
			break;
		case 'move':
			text = text.replace(this.regexBuilder(sourcecat), "[[" + this.localCatName + ":" + targetcat + "$1]]");
			comment = this.i18n.summaryMove + sourcecat + "]] " + this.i18n.to + targetcat + "]]";
			break;
		case 'remove':
			text = text.replace(this.regexBuilder(sourcecat), "");
			comment = this.i18n.summaryRemove + sourcecat + "]]";
			break;
		}
 
		if (text == otext) {
			this.notFound.push(file[0]);
			this.updateCounter();
			return;
		}
 
		// Remove uncat after we checked whether we changed the text successfully.
		// Otherwise we might fail to do the changes, but still replace {{uncat}}
		if (mode != 'remove') {
			text = this.removeUncat(text);
		}
		var data = {
			action: 'edit',
			summary: comment,
			title: file[0],
			token: this.edittoken,
			starttimestamp: starttimestamp,
			basetimestamp: timestamp,
			text: text
		};
		this.doAPICall(data, function(ret) {
			catALot.updateCounter();
		});
		this.markAsDone(file[1], mode, targetcat);
	},
	markAsDone: function(label, mode, targetcat) {
 
		label.addClass('cat_a_lot_markAsDone');
		switch (mode) {
		case 'add':
			label.append('<br>' + this.i18n.addedCat + ' ' + targetcat);
			break;
		case 'copy':
			label.append('<br>' + this.i18n.copiedCat + ' ' + targetcat);
			break;
		case 'move':
			label.append('<br>' + this.i18n.movedCat + ' ' + targetcat);
			break;
		case 'remove':
			label.append('<br>' + this.i18n.movedCat);
			break;
		}
	},
	updateCounter: function() {
 
		this.counterCurrent++;
		if (this.counterCurrent > this.counterNeeded) this.displayResult();
		else this.domCounter.text(this.counterCurrent);
	},
 
	displayResult: function() {
 
		document.body.style.cursor = 'auto';
		$('.cat_a_lot_feedback').addClass('cat_a_lot_done');
		$('.ui-dialog-content').height('auto');
		var rep = this.domCounter.parent();
		rep.html('<h3>' + this.i18n.done + '</h3>');
		rep.append(this.i18n.allDone + '<br />');
 
		var close = $('<a>').append(this.i18n.returnToPage);
		close.click(function() {
			catALot.progressDialog.remove();
			catALot.toggleAll(false);
		});
		rep.append(close);
		if (this.alreadyThere.length) {
			rep.append(this.i18n.skippedAlready);
			rep.append(this.alreadyThere.join('<br>'));
		}
		if (this.notFound.length) {
			rep.append(this.i18n.skippedNotFound);
			rep.append(this.notFound.join('<br>'));
		}
		if (this.connectionError.length) {
			rep.append(this.i18n.skippedServer);
			rep.append(this.connectionError.join('<br>'));
		}
 
	},
 
	moveHere: function(targetcat) {
		this.doSomething(targetcat, 'move');
	},
 
	copyHere: function(targetcat) {
		this.doSomething(targetcat, 'copy');
	},
 
	addHere: function(targetcat) {
		this.doSomething(targetcat, 'add');
	},
 
	remove: function() {
		this.doSomething('', 'remove');
	},
 
	doSomething: function(targetcat, mode) {
		var files = this.getMarkedLabels();
		if (files.length === 0) {
			alert(this.i18n.noneSelected);
			return;
		}
		this.notFound = [];
		this.alreadyThere = [];
		this.connectionError = [];
		this.counterCurrent = 1;
		this.counterNeeded = files.length;
		this.showProgress();
		for (var i = 0; i < files.length; i++) {
			this.getContent(files[i], targetcat, mode);
		}
	},
 
	doAPICall: function(params, callback) {
		params.format = 'json';
		var i = 0;
		var apiUrl = this.apiUrl;
		var handleError = function(jqXHR, textStatus, errorThrown) {
				if (console && console.log) {
					console.log('Error: ', jqXHR, textStatus, errorThrown);
				}
				if (i < 4) {
					window.setTimeout(doCall, 300);
					i++;
				} else if (params.title) {
					this.connectionError.push(params.title);
					this.updateCounter();
					return;
				}
			};
		var doCall = function() {
				$.ajax({
					url: apiUrl,
					cache: false,
					dataType: 'json',
					data: params,
					type: 'POST',
					success: callback,
					error: handleError
				});
			};
		doCall();
	},
 
	createCatLinks: function(symbol, list) {
		list.sort();
		var domlist = this.catlist.find('ul');
		for (var i = 0; i < list.length; i++) {
			var li = $('<li></li>');
 
			var link = $('<a></a>');
			link.text(list[i]);
			li.data('cat', list[i]);
			link.click(function() {
				catALot.updateCats($(this).parent().data('cat'));
			});
 
			if (this.searchmode) {
				var add = $('<a class="cat_a_lot_action"><b>' + this.i18n.add + '</b></a>');
				add.click(function() {
					catALot.addHere($(this).parent().data('cat'));
				});
			} else {
				var move = $('<a class="cat_a_lot_move"><b>' + this.i18n.move + '</b></a>');
				move.click(function() {
					catALot.moveHere($(this).parent().data('cat'));
				});
 
				var copy = $('<a class="cat_a_lot_action"><b>' + this.i18n.copy + '</b></a>');
				copy.click(function() {
					catALot.copyHere($(this).parent().data('cat'));
				});
			}
 
			li.append(symbol).append(' ').append(link);
 
			// Can't move to source category
			if (list[i] != wgTitle && this.searchmode) li.append(' ').append(add);
			else if (list[i] != wgTitle && !this.searchmode) li.append(' ').append(move).append(' ').append(copy);
 
			domlist.append(li);
		}
	},
 
	getCategoryList: function() {
		this.catCounter = 0;
		this.getParentCats();
		this.getSubCats();
	},
 
	showCategoryList: function() {
		var thiscat = [this.currentCategory];
 
		this.catlist.empty();
		this.catlist.append('<ul></ul>');
 
		this.createCatLinks("↑", this.parentCats);
		this.createCatLinks("→", thiscat);
		this.createCatLinks("↓", this.subCats);
 
		document.body.style.cursor = 'auto';
		//Reset width
		var cat = $('#cat_a_lot');
		cat.width('');
		cat.height('');
		cat.width(Math.min(cat.width() * 1.05, $(window).width() - 10));
		var list = $('#cat_a_lot_category_list');
		list.css({
			maxHeight: this.setHeight + 'px',
			height: ''
		});
	},
 
	updateCats: function(newcat) {
		document.body.style.cursor = 'wait';
 
		this.currentCategory = newcat;
		this.catlist = $('#cat_a_lot_category_list');
		this.catlist.html('<div class="cat_a_lot_loading">' + this.i18n.loading + '</div>');
		this.getCategoryList();
	},
	showProgress: function() {
		document.body.style.cursor = 'wait';
 
		this.progressDialog = $('<div></div>').html(this.i18n.editing + ' <span id="cat_a_lot_current">' + this.counterCurrent + '</span> ' + this.i18n.of + this.counterNeeded).dialog({
			width: 450,
			height: 90,
			minHeight: 90,
			modal: true,
			resizable: false,
			draggable: false,
			closeOnEscape: false,
			dialogClass: "cat_a_lot_feedback"
		});
		$('.ui-dialog-titlebar').hide();
		this.domCounter = $('#cat_a_lot_current');
 
	},
 
	run: function() {
		if ($('.cat_a_lot_enabled').length) {
			this.makeClickable();
			$("#cat_a_lot_data").show();
			$('#cat_a_lot').resizable({
				handles: 'n',
				alsoResize: '#cat_a_lot_category_list',
				resize: function(event, ui) {
					$(this).css({
						left: "",
						top: ""
					});
					catALot.setHeight = $(this).height();
					$('#cat_a_lot_category_list').css({
						maxHeight: '',
						width: ''
					});
				}
			});
			$('#cat_a_lot_category_list').css({
				maxHeight: '450px'
			});
			if (this.searchmode) this.updateCats("Pictures and images");
			else this.updateCats(wgTitle);
 
		} else {
			$("#cat_a_lot_data").hide();
			$("#cat_a_lot").resizable("destroy");
			//Unbind click handlers
			this.labels.unbind('click');
		}
	},
	i18n: {
		//Progress
		loading: 'Loading...',
		editing: 'Editing page',
		of: 'of ',
		skippedAlready: '<h5>The following pages were skipped, because the page was already in the category:</h5>',
		skippedNotFound: '<h5>The following pages were skipped, because the old category could not be found:</h5>',
		skippedServer: '<h5>The following pages couldn\'t be changed, since there were problems connecting to the server:</h5>',
		allDone: 'All pages are processed.',
		done: 'Done!',
		addedCat: 'Added category',
		copiedCat: 'Copied to category',
		movedCat: 'Moved to category',
		removedCat: 'Removed from category',
		returnToPage: 'Return to page',
		catNotFound: 'Category not found.',
 
 
		//as in 17 files selected
		filesSelected: ' files selected.',
 
		//Actions
		copy: 'Copy',
		move: 'Move',
		add: 'Add',
		removeFromCat: 'Remove from this category',
		enterName: 'Enter category name',
		select: 'Select',
		all: 'all',
		none: 'none',
 
		noneSelected: 'No files selected!',
 
		//Summaries:
		summaryAdd: 'Cat-a-lot: Adding [[Category:',
		summaryCopy: 'Cat-a-lot: Copying from [[Category:',
		to: 'to [[Category:',
		summaryMove: 'Cat-a-lot: Moving from [[Category:',
		summaryRemove: 'Cat-a-lot: Removing from [[Category:'
	}
};
 
if ((nsNumber === -1 && mw.config.get('wgCanonicalSpecialPageName') === "Search") || nsNumber === 2) {
	if (nsNumber === -1) {
		catALot.searchmode = true;
	}
	var loadingLocalizations = 1;
	var loadLocalization = function(lang, cb) {
		loadingLocalizations++;
		$.ajax({
			url: mw.util.wikiScript(),
			dataType: 'script',
			data: {
				title: 'MediaWiki:Gadget-Cat-a-lot.js/' + lang,
				action: 'raw',
				ctype: 'text/javascript',
				// Allow caching for 28 days
				maxage: 2419200,
				smaxage: 2419200
			},
			cache: true,
			success: cb,
			error: cb
		});
	};
	var maybeLaunch = function() {
		loadingLocalizations--;
		if (0 === loadingLocalizations) {
			mw.loader.using(['jquery.ui'], function() {
				$(document).ready(function() {
					catALot.init();
				});
			});
		}
	};
 
	if (mw.config.get('wgUserLanguage') !== 'en') {
		loadLocalization(mw.config.get('wgUserLanguage'), maybeLaunch);
	}
	if (mw.config.get('wgContentLanguage') !== 'en') {
		loadLocalization(mw.config.get('wgContentLanguage'), maybeLaunch);
	}
	maybeLaunch();
}
 
})(jQuery, mediaWiki);
 
// </nowiki>