Help:Gadget-Cat-a-lot

From Wikimedia Commons, the free media repository
(Redirected from Help:Cat-a-lot)
Jump to: navigation, search
Translate this page; This page contains changes which are not marked for translation.

Other languages:
বাংলা • ‎Deutsch • ‎Ελληνικά • ‎English • ‎español • ‎euskara • ‎français • ‎galego • ‎italiano • ‎日本語 • ‎മലയാളം • ‎português do Brasil • ‎українська • ‎中文
Figure 1: Cat-a-lot steps:
1) Select files
2) Select destination category
3) Perform the Operation
A video intro to using Cat-a-lot (English)
Figure 2: Initial box
Figure 3: Cat-a-lot box
Figure 4: Cat-a-lot box after selecting category

Cat-a-lot is a JavaScript gadget that helps with moving images (or subcategories) between categories or adding categories to search results.

One time activation[edit]

To activate the gadget
In "Preferences" : "gadgets" tab, "Tools for categories" section: click "Cat-a-lot" and hit "Save" at bottom of page. Or click here and follow the instructions. (For users of the English Wikipedia, see instructions here.)

Moving files between categories, and removing files from a category[edit]

  • Turn on the gadget: after activation, you will see a little post-it-note labeled "cat-a-lot" in the lower-right corner of every category page, as seen in Figure 2. This box will stay in that corner, independent of your position on the page. If the note doesn't appear, try to purge the cache of your browser. Click it to start the tool. This will show a box like the one in the Figure 3.
  • Select files: You can select individual image thumbnails by clicking in the white space of the thumbnail description. The description background will turn green to indicate that this image is now selected. Another click will de-select it, turning the background white again. You can also select/de-select all visible images by clicking select all / none in the cat-a-lot box. To select/de-select multiple files "in a row" (Fig. 1), first select file A, then hold down Shift and select file B. The state of file B will be toggled (selected if it was not previously and vice-versa) and then assigned to all files from A through B.
  • Select destination category: Initially, the tool loads the current category (→), its parents (↑) (categories with which it is tagged) and subcategories (↓) (categories that are tagged with it). You can navigate through the category tree by clicking on a category name. Only the category list in the box will change, you will stay on the original page. Instead of navigating through clicking, you can also type a category name (e.g. "Lions", not "Category:Lions") in the white text field above the list and press Enter. The named category will then show up in the middle of the tree below, with its parents and children.
  • If necessary, create destination category: The cat-a-lot box only shows categories that already exist. So create one if necessary. Reload the category that contains the files you want to categorize better. The cat-a-lot box will now show the newly created category. Or it will when you type the new category name (e.g. "Lions", not "Category:Lions") in the white text field at the top of the box and press Enter.
  • Perform the Operation: There are three possibilities:
  • Copy, which adds the specified category to the highlighted objects (if not already present).
  • Remove, which removes the specified category from the highlighted objects (if present).
  • Move, which does both, removing the current category from the objects and adding the specified category to them (if not already present).

In each case, all of the other categories which might be associated with any of the objects remain unchanged. A progress indicator will be shown. After all images were processed, a report is shown including possible problems, and the whitespace area below each image will indicate what was done to that image.

  • Revert, if you have done a mistake, you can stop (cancel) and reverse your last action, by clicking the button on the lower-right corner of the box.

Preferences[edit]

Cat-a-lot’s preferences

There is preferences menu in Cat-a-lot:

  • Watchlist
  • Whether to mark edits as minor
  • Whether to allow editing pages that aren't files or in gallery boxes
  • Whether to do clean up
  • Numbers of sub-categories to show

Box display[edit]

The Cat-a-lot box display can be toggled by clicking on Cat-a-lot in the lower part of the box.

During the step of selecting the files, the Cat-a-lot box window can be resized by dragging the upper edge of the window.

Open bugs & features[edit]

You can report bugs or request new features on this page: Help:Gadget-Cat-a-lot/Open bugs & features.

Translations[edit]

English phrases from MediaWiki:Gadget-Cat-a-lot.js/translating can be translated and saved in MediaWiki:Gadget-Cat-a-lot.js/de (for example).

Install on other projects[edit]

As your user gadget[edit]

If Cat-a-lot is not present as gadget in your local Wikimedia project (like Wikipedia), you can install it manually in your user JavaScript settings with following code:

//<nowiki>
== Translations ==
/* Cat-a-lot - changes category of multiple files */
mw.loader.using(['jquery.ui.resizable', 'mediawiki.util'], function(){
	mw.loader.load('//commons.wikimedia.org/w/load.php?modules=ext.gadget.Cat-a-lot');
});
////////// Cat-a-lot user preferences //////////
window.catALotPrefs = {"watchlist":"preferences","minor":true,"editpages":true,"docleanup":false,"subcatcount":10};
////////////////////////////////////catALotEnd//
//</nowiki>

The semi-automatic preferences are not loaded with this example, so you need to set this also manually (because it supports only Commons, although it is theoretically possible, if you load all the local needed extra modules).

As a project gadget[edit]

1. Copy the next code into the local MediaWiki:Gadget-Cat-a-lot.js:

/**
 * Cat-a-lot - changes category of multiple files
**/
if (mw.config.get('wgNamespaceNumber') === 14) {
	window.catALotPrefs = { editpages: true, subcatcount: 100 };
	mw.loader.using(['jquery.ui.resizable', 'mediawiki.util']).done(function () {
		mw.util.addCSS("#cat_a_lot_settings { display:none !important;}"); // Preferences depend on some Commons gadgets, not available locally
		mw.loader.load('//commons.wikimedia.org/w/index.php?title=MediaWiki:Gadget-Cat-a-lot.js&action=raw&ctype=text/javascript');
		mw.loader.load('//commons.wikimedia.org/w/index.php?title=MediaWiki:Gadget-Cat-a-lot.css&action=raw&ctype=text/css', 'text/css');
	});
}

Note: The marked lines are optional.

2. Save a description into the local MediaWiki:Gadget-Cat-a-lot (you can translate this one, or one of existing):

Cat-a-lot: A tool that helps with moving multiple files between categories or adding categories to search results.

3. Add a definition to the local MediaWiki:Gadgets-definition:

Cat-a-lot[ResourceLoader|dependencies=mediawiki.util]|Cat-a-lot.js

More local configuration[edit]

To use the solving of soft-redirects (since version 4.0) on your project, you need to put this category name in the preferences manually (on Commons this is "Category redirects", ideally on your MediaWiki:Gadget-Cat-a-lot.js). The example shows the category for the English Wikipedia:

window.catALotPrefs = { "redir_category": "Wikipedia soft redirected categories" };