Help:Gadget-Cat-a-lot

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

To activate the gadget

In "Preferences" : "gadgets" tab, "Tools for categories" section: click "Cat-a-lot"

Moving files between categories, and removing files from a category

• 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, and the background turns white again. You can also select/de-select all visible images by clicking select all / none in the cat-a-lot box.

• Select destination category: Initially tool loads the current category (→), its parent-category (↑) and subcategories (↓). 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 enter a category name (i.e. "Lions", not "Category:Lions") in the white text field above the list and pushing "ENTER" on your keyboard. The named category will then show up in the middle of the tree below, with its parents and children.

• Perform the Operation: Click on Move or Copy links next to destination category and the selected images will be moved or copied from the current into destination category. The difference between move and copy is that copy leaves a copy in a source category. Alternatively you can click on "Remove from this category" link in order to remove all selected files from the current category. A progress indicator will be shown. After all images were processed, a report is shown including possible problems.

Categorizing search results

• 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 entering a category name in the white text field in top of cat-a-lot box and pushing "ENTER" on your keyboard. Your screen should look similar to Figure 4.
• Perform the Operation: by clicking "Add" link next to destination category and the selected files will be added to that category, if they do not already belong to it.

Watchlist preferences

Go to your preferences at Special:Preferences#mw-prefsection-watchlist to choose whether images you move are added to your watchlist.

Open bugs & features

• Check for empty lines (what's the current behaviour?)
• Resolve double categories
• 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 )
• More sophisticated categories handling - Example: removing ALL categories from file(s) BUT a selected category --Kozuch
• Could you please develop this software so that it can be used to move subcategories from one supercategory to another, the same way as you do with files Teofilo
• Select multiple with shift-click DieBuche (talk)
• Spinoff: Edit-a-lot for various text replacements? DieBuche (talk) — done by VisualFileChange RE rillke questions?
• Add Preference screen:
  • Add user preference for watchlist-behaviour (eg. no-change)
  • Enable predefined fixes
  • Category sorting?
• Keyboard navigation (Jean-Fred)
• #Copying images from categories added through templates
• Watchlist preferences only for files moved by Cat-a-lot. Timeshifter (talk)
• 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)
• When a user types "Category:Bla" into the text input box, strip the "Category:" out to prevent Category:Category:Bla errors, the way HotCat does. (This error can only happen when the user is using a non-existent category, but they may do that if they intend to create the category afterwards.) Rd232 (talk) 18:20, 19 November 2011 (UTC)