Help:Gadget-Cat-a-lot

From Wikimedia Commons, the free media repository
Jump to: navigation, search
Figure 1: Cat-a-lot steps:
1) Select files
2) Select destination category
3) Perform the Operation
Figure 2: Cat-a-lot box
Figure 3: Initial box
Figure 4: Cat-a-lot box after selecting category

Cat-a-lot is a JavaScript gadget that helps with moving images 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.

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. 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 2.
  • Select files: You can also 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.
  • Perform the Operation: There are three possibilities:
  • Copy, which adds the specified category to the highlighted objects (if not already present).
  • Remove from this category which removes the current category -- the one you are working in -- from the highlighted objects.
  • 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.

Categorizing search results[edit]

  • Perform the search, for example for term "Seneca Rocks"
  • Turn on the gadget: by clicking little post-it-note labeled "cat-a-lot" in the lower-right corner of the search result page. Your screen should look similar to Figure 3.
  • Select destination category: by typing a category name in the white text field in top of cat-a-lot box and pressing Enter. Your screen should look similar to Figure 4.
  • Perform the Operation: by clicking "Add" link next to destination category and the destination category will be added to the selected files, if they do not already have it.

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

Open bugs & features[edit]

Note: Add signature to entries below. -~~~
  • Check for empty lines (what's the current behaviour?)
  • Make crosssections (For example, moving all media in "Category:Sailing ships" and "category:Ships of the Netherlands" into "category:Sailing ships of the Netherlands" (removing both prior categories).) Reported by Ibn Battuta.
  • Minor change by default (Reported by Ibn Battuta). ??? Pls explain. --Rillke(q?)
  • More sophisticated categories handling - Example: removing ALL categories from file(s) BUT a selected category. --Kozuch.
    • Symbol strong support vote.svg Strong support! I need it very much. Ain92 (talk) 18:16, 24 October 2013 (UTC)
    • Symbol support vote.svg Support (but in practice image specific categories (like taken on date, men looking whereever) have to be kept. So this can best be handled imho when moving images to a new category by removing all the categories found on both the new category and the moved images from the images moved. --Herzi Pinki (talk) 11:00, 10 March 2014 (UTC)
  • Spinoff: Edit-a-lot for various text replacements? -DieBuche (talk) — done by VisualFileChange RE rillke questions?
  • Add Preference screen:
    • Category sorting?
    • Watchlist preferences only for files moved by Cat-a-lot. -Timeshifter (talk).
  • Keyboard navigation. -(Jean-Fred).
  • #Copying images from categories added through templates.
  • A stop button to abort an operation in progress (and ideally offer to revert changes already made). Rd232 (talk) 18:13, 19 November 2011 (UTC).
  • Remove duplicate categories from pages, if the duplicate category is changed instead of changing both categories (including the duplicate one)
    • Remove redundant categories (category in file == category in category). -- Perhelion (talk) 22:44, 3 October 2012 (UTC)
  • Remove (selectable) more than one category. -- Perhelion (talk) 22:44, 3 October 2012 (UTC)
  • Preferences, double saved as same preferences. [1], [2]--777sms (talk) 18:29, 16 June 2013 (UTC)
  • If a category is added by a template and there is no explicit [[Category:XXX]], the script will stop processing remaining pages. The problem was found when I move templates which use {{documentation}} from one category to another.--Gqqnb (talk) 23:56, 19 June 2013 (UTC)
  • When the category tag contains an unvisible controll character at the bootom (which is inadvertently intruded copying the category name, an example), Cat-a-lot is not able to move or remove the page from the category where it is place, giving a message: "The following pages were skipped, because the old category could not be found:…" HotCat is able to deal such pages. --ŠJů (talk) 10:36, 6 October 2013 (UTC) (Recently identified as char code 8206 (a Left-to-right mark), Substitute character, U+200E, see this (19 June 2012) and this (7 May 2013) report.)
  • A way to copy/move to several categories at once. One way to do that would be to require the user (perhaps only if they've set it so) to click "save" before Cat-a-lot actually does anything - the user could then have clicked several "Copy" and "Move" buttons before and Cat-a-lot would do all these operations. darkweasel94 12:02, 13 October 2013 (UTC)
  • Today the gadget added the same category again. =( Ain92 (talk) 18:16, 24 October 2013 (UTC)
  • An odd bug showed up today, twice (Addendum: the bug persists, either from category or from search list view). I select, say, four files, press "move", catalot responds "4 files moved", all four turn from green to grey. But the target category contains only three files. One was left unchanged. Kaluga.2012 (talk) 20:59, 1 November 2013 (UTC)
  • Have all changes be marked "minor" unless the editor explicitly chooses otherwise. It is a real nuisance when one of our colleagues changes fifty or a hundred files that I have edited and I have to have them on my watch list. .     Jim . . . . (Jameslwoodward) (talk to me) 11:55, 21 November 2013 (UTC)
  • Perhaps change the link to read "Cat-a-lot Preferences" so that it will stand out a little better. I, frankly, never saw it until today and I've been using Cat-a-lot for a long time. .     Jim . . . . (Jameslwoodward) (talk to me) 11:55, 21 November 2013 (UTC)
  • Automatically skipping files that already are in a subcategory of the category which is about to be added. --A.Savin 12:06, 4 January 2014 (UTC)
  • A possibility to add/remove categories to images in galleries or any other pages with embedded thumbnails --A.Savin 12:12, 4 January 2014 (UTC)
  • The option to automatically mark edits as minor seems to be buggy. If you look at my recent contributions, you'll see that it randomly marks edits as minor, but sometimes not (I set it to mark them as minor). I have no idea under what circumstances that happens. darkweasel94 18:42, 9 March 2014 (UTC)
  • It would be nice to be able to add/remove from the selection by regular expression... Junkyardsparkle (talk) 23:16, 6 April 2014 (UTC)
  • Moving files from Category "Media needing categories as of ...". This yields an error message "The following pages were skipped, because the old category could not be found". --hdamm (talk) 17:16, 10 June 2014 (UTC)
    • hdamm (talk · contribs), that is not surprising, it's expected behavior. It applies to all categories that are added through templates, because these aren't in the wikicode, so Cat-a-lot can't really detect them. If you click "Copy" instead of "Move" in a "Media needing categories" category, it will do what you want, as it always removes {{uncategorized}} if you add categories through it. darkweasel94 19:22, 10 June 2014 (UTC)
    • darkweasel94 (talk · contribs), thanks , that does it! --hdamm (talk) 08:45, 11 June 2014 (UTC)
  • An option to highlight files in a given category which are also in its subcategories, so one can click "remove from this category" button. This would be a tool to clean up the overcategorized images.
    • Symbol support vote.svg Support --Jarekt (talk) 17:41, 10 June 2014 (UTC)
  • Preferences do not seem to actually save - need to be changed each time new page is loaded. --Varnent (talk)(COI) 05:17, 3 August 2014 (UTC)