View source for Wiki143:HotCat

{{Short description|JavaScript program to manage categories in Wikipedia pages}}
<noinclude>{{pp-move|small=yes}}</noinclude>{{redirect|WP:HC|hat collecting|Wikipedia:Hat collecting}}
{{shortcut|WP:HOTCAT|WP:HC}} 
{{Tool warning}}
{{2019 Coolest tool award|HotCat|Tiny}}
{{infobox Wikipedia user script
|name               = HotCat
|logo               = Nuvola apps package toys svg.svg
|logosize           = 150px
|logoupright        = 
|logoalt            = 
|logo-caption       = 
<!-- |screenshot         = HotCat.png
|screenshotsize     = 
|screenshotupright  = 
|screenshotalt      = 
|screenshot-caption = 
|desc               = An example of HotCat in use, in this case attempting to predict the next word. -->
|author             = [[commons:User:Magnus Manske]],{{r|r=Initially developed for [[Wikimedia Commons]].|n=c1}} [[User:Lupo]], [[User:Dschwen]], [[User:TheDJ]], [[User:Superm401]], [[User:Merlissimo]], and others.{{r|n=c2|r=Later adapted and improved for use on the English Wikipedia.}}
|maintainer         = 
|status             = 
|released           = 
|version            = 
|updated            = 
|browsers           = 
|skins              = 
|source             = [[MediaWiki:Gadget-HotCat.js]]
|github             = 
|categorize         = <!-- or " |cat = " -->
}}

'''HotCat''' is a [[Wikipedia:Gadget|gadget]] that helps [[WP:REGISTER|registered user]]s easily remove, change, and add [[WP:CAT|categories]] to Wikipedia pages. It has a suggestions list that will propose existing categories for auto-completion.

==How to enable/disable== 
You must be logged in to use HotCat.

To turn HotCat on or off, first make sure you are logged in. Then, click on "Preferences" in the upper-right corner, go to the "Gadgets" tab (or use [[Special:Preferences#mw-prefsection-gadgets|this link]]), and scroll down to the "Editing" section. Check the box near ''HotCat'' to enable it, or uncheck the box to disable HotCat. Scroll down to the bottom of the page and click {{button|Save}}. You will get a "Your preferences have been saved" message. You can now navigate back to the page you started from; you may need to reload the page you were viewing or [[WP:BYPASS|bypass your cache]].

==How to use==
Whenever a page is loaded, HotCat looks for the category bar. If there are visible categories, it adds links to easily remove, change or add categories. Example:

[[File:HotCat enwp Category bar.png|left|A category bar as modified by HotCat]]{{clear}}

This appears at the very bottom of the page.

The new links are:
* "(−)" after a category: when clicked, the category is automatically [[#Removing a single category|removed]].
* "(±)" after a category: when clicked, an input field to [[#Changing a category|change this category]] is opened.
* "(+)" at the end of the list of categories: when clicked, an input field to [[#Adding a category|add a category]] is opened.
* "(+<sup>+</sup>)" at the front: when clicked, enters [[#Making more than one category change|multi-change mode]], allowing modifying more than one category.

If HotCat can detect that a certain category is not in the page text itself but was transcluded onto the page from a template or other transclusion, it will ''not'' add these links. Only categories that ''are'' present in the wikitext of the page itself can be modified through HotCat.

[[Image:HotCat.png|thumb|500px|An example of HotCat in use, in this case attempting to predict the next word.]]

=== Removing a single category ===

To remove a category, simply click the "(−)" link next to the category name. If the page does indeed contain this category, HotCat will remove it automatically. It will:
#open a new window or tab in your browser with the current page opened for editing,
#''hide'' the whole edit form, so that you cannot edit,
#edit the page to remove the category, and
#save the page.

=== Changing a category ===

To change a category, click the "(±)" link next to the category name. This will open the [[#Input box|input box]] where you can enter a new category name.

=== Adding a category ===

To add a category, click the "(+)" link at the end of the category line. This will open the [[#Input box|input box]] where you can enter a new category name.+

=== Input box ===

[[File:HotCat Input Box plain.png|right|thumb|250px|The input box of HotCat]]
The input box of HotCat is very simple: a text field to enter the new category name, an indicator icon, and an "OK" and a "Cancel" button.

The indicator icon tells you whether the category name you've entered exists. A [[File:P_no.svg|20px|alt=|link=]] icon means that there is no such category yet. You can still add the category, but it will show up as a red link, and you should, after having added the category, click that red link and enter a brief description and parent categories to this new category. A [[File:P_yes.svg|20px|alt=|link=]] icon shows that there already is a category with the name you've entered.

[[File:HotCat suggestions.png|right|thumb|250px|HotCat's input box with a suggestion list]]
When you start typing, HotCat will display a list of suggestions above or below the text input field. Clicking one of these suggestions will copy it into the text field. Double-clicking a suggestion is the same as clicking once and then clicking the "OK" button: HotCat will add the double-clicked suggestion automatically. The suggestion list is populated by the [[#Search engines|search engine]] chosen in the selector between the list and the text input field.

In the example shown here, we've entered "Alps of", and HotCat presents us with a list of possible completions. The first suggestion has already been copied into the text box, but the added text is selected, so that it will be overwritten when we keep on typing. Entering " S" reduces the suggestion list accordingly.

Clicking on "Alps of Switzerland" will then copy that into the text field and close the suggestion list (since there are no more suggestions, i.e., categories beginning with "Alps of Switzerland" as a prefix).

Clicking the "Cancel"-button would now abort the operation, clicking "OK" would tell HotCat to go on and add the chosen category.

=== Making more than one category change ===

[[File:HotCat save button.png|thumb|In multi-change mode, category changes are saved only when the "save" button is clicked.]]
The user interface of HotCat is minimalistic on purpose and geared towards making interactions simple and fast. When you just click on a "(−)" link to remove a category, the edit is executed right away, and likewise when you submit a single category addition or change.

Still, HotCat fully supports changing more than one category at once. If you click the "(+<sup>+</sup>)" link at the beginning of the category line, HotCat will enter its multi-change mode. The "(+<sup>+</sup>)" link is replaced by a "save" button, and all changes you make from now on will be written to the page only when that button is clicked. Initially, this button may appear disabled. It is enabled only when there are indeed category changes that need saving.

[[File:HotCat multimode.png|800px|In multi-change mode, changes are reflected on the page view, but are saved only when the "save" button is clicked.]]

This multi-change mode is also entered automatically if you have one category input box open and, while it is still open, add, change, or remove another category.

In multi-change mode, submitting a category change or removal will ''not'' perform the edit immediately. Instead, the change will only be reflected on the screen, allowing you to make more category changes. HotCat will add "(×)" links after each changed category. This is an "undo" link; it'll undo the last action on that category. Category removals are indicated by <s>striking through</s> the category name. HotCat will also highlight unsaved category changes by changing the background of the category link.

Once the "Save" button is clicked, HotCat will make all the changes, and then opens the page in an edit screen, showing the changes made. The changes are at that point not yet saved! Review the changes to make sure that the script did what you intended it to do, and then submit the edit like any other edit you'd make.

Note that while HotCat normally automatically submits single category changes, it will never do so when operating in multi-change mode. It will always open a screen showing the changes made, which you should review before submitting the edit manually.

==Advanced usage tips==
===Avoid auto saving===
Normally HotCat automatically saves your edit. However, sometimes you might wish to go to the edit box instead to verify and then execute the save yourself. Instead of clicking OK, click OK while you have the modifier key pressed. On Windows computers this is the [[Control key|Ctrl key]], on Apple computers it should be the [[Command key|Command (⌘) key]].

=== Sort keys ===

You can even give a sort key together with the category. Just type a vertical bar ("|") after the category, followed by the sort key under which the page shall be sorted within that category's list.

* Input "Foo" will add a new category "Foo" without sort key, or change an existing category to "Foo", preserving the sort key.
* Input "Foo|Key" will add a new category "Foo" or change an existing category to "Foo", using the given sort key "Key" in both cases.
* Input "Foo|" (with a trailing vertical bar) will add a new category "Foo" without sort key, or change an existing category to "Foo", removing any sort key the changed category might have had.

Note that, to remove an existing sortkey, you should change "Foo|Key" to "Foo|". Changing it to "Foo" has no effect.

===Easy categorizing to child or parent categories===
Users who do a lot of category maintenance might want to enable the quick access links for categorizing to child or parent categories. To enable this add the following to [[Special:MyPage/common.js|your JavaScript page]]:
<div style="margin-left:3em;">
<syntaxhighlight lang="javascript">
window.hotcat_use_category_links = true;
</syntaxhighlight>
</div>

(You may need to [[MediaWiki:Clearyourcache|make your browser re-load the JavaScript]] after the change.)

The following controls will be added: 
* "(↓)" after a category: when clicked, the input field is opened, and a list of available subcategories is displayed.
* "(↑)" after a category: when clicked, the input field is opened, and a list of available parent categories is shown.
Note that the "(↓)" and "(↑)" links are shown only for existing categories. Red-linked categories, i.e. non-existing categories, can have neither parent nor subcategories, and thus showing these links wouldn't make sense. Also note that it is possible that only the input box is shown when these links are clicked, but no list. That indicates that this category does not have parent categories or subcategories, respectively. See also "[[#Search engines|Search engines]]" below.

=== Search engines ===

Between the suggestion list and the text input field, there is a search engine selector to select the search method which populates the suggestion list. HotCat supports a number of search engines.

The MediaWiki servers offer two general ways to search for categories. The first is through the page list of the wiki. This list is always up to date, but is strictly alphabetic and also case-sensitive, so "similar" suggestions (for instance, suggesting "[[:Category:Bláhnjúkur|Bláhnjúkur]]" when "Blahn" was entered) are not shown. The second search engine is the search ''index'' that is also used by the "search" box on all pages. It does find "similar" suggestions and is not case-sensitive, but as its index is updated only at intervals, it may not show newly created categories.

HotCat by default combines these two search engines to get the best of both worlds: similar suggestions ''and'' newly created categories. However, to do so, it must make two requests to the server. Normally, that's not a problem, but if it turns out to be too slow on a slow connection, you can use the engine selector to choose which search engine you want to use. It is also possible to [[#User configuration|configure]] which search engine HotCat should use by default.

In addition to these general searches, HotCat also provides two additional, more specialized search engines. A first one can be used to search for subcategories of the category given by the current input. A second one returns the parent categories of the category given by the current input. Both engines may return empty results, in which case no suggestion list is shown. (For instance, if the current input is a name of a non-existing category, or if a category has no subcategories). In this case, the search engine is automatically reset to the default search engine after the first non-deleting input.

Note that there is no way to "page" through a list of subcategories. The script just tries to get as many subcategories as it can (normally at most 500, the limits for administrators are somewhat higher). Subcategory queries can also be slow if a category contains many items (not just many subcategories), and the input field is made non-editable for the time of the request. If it doesn't become editable in reasonable time, just click cancel.

:<small>For the technically inclined: the problem is that subcategory continuation queries appear not to work in the MediaWiki API. On the (hidden) category Category:Media with locations, the API returns (with a limit of 5000) only the first 1540 subcategories of more than 4800 that exist, and continuation queries seem to return no further subcategories at all. Related bug reports on this are [[bugzilla:1211]] and [[bugzilla:23682]]. Until this is fixed, there will be no paging through subcategories in HotCat.</small>

===User configuration===
You can adapt many of the aspects of HotCat. Please see its full [[:commons:Help:Gadget-HotCat|documentation page on Wikimedia Commons]].

==History==
HotCat was initially developed for [[Wikimedia Commons]] by [[:commons:User:Magnus Manske|Magnus Manske]] and later adapted and improved by many users, including, but not limited to [[User:Lupo]], [[User:Dschwen]], [[User:TheDJ]], [[User:Superm401]] and [[User:Merlissimo]].

The version on English Wikipedia is the same as the [[:commons:MediaWiki:Gadget-HotCat.js|version on Commons]] but with a different default user configuration.

==Compatibility==
*Safari 3 and 4: Tested and fully working
*Safari 2: Has a non-harmful issue with displaying the "change" (±) link.
*Firefox 2, 3, 16.0.2: Tested and fully working
*IE 6, 7, and 8: Tested and fully working
*Google Chrome: Tested and fully working
*Opera: Tested and fully working

It is also tested and confirmed to be working in combination with [[Wikipedia:Tools/Navigation popups|Navigation popups]], [[User:Cacycle/wikEd|wikEd]] and the modern skin.

Not completely compatible with the [[mw:Timeless|Timeless skin]] – in wide-screen, category links are displayed as a sidebar instead of the bottom bar, and HotCat does not work. Add the following codes in your [[Special:MyPage/timeless.css|Timeless custom css page]], forcing category links always displayed as the bottom bar, which might be helpful:
<syntaxhighlight lang="css">
#catlinks-sidebar { display: none; }
#catlinks { display: inherit !important; }
</syntaxhighlight>

== Userboxes ==

{{usbktop}}
{{usbk|User:Scarce/Userboxes/HotCat}}
{{usbk|User:Cj005257/userbox/hotcat}}
{{usbk|Template:User HotCat only}}
{{usbkbottom}}

Also, there is the HotCat topicon. {{tl|HotCat topicon}}.

By using any of the above userboxes or topicon, a person can add their name into the [[:Category:Wikipedians who use HotCat|List of Wikipedians who use HotCat]].

== Adverts ==

HotCat has advertisements too! By using '''{{tlx|Wikipedia ads|ad{{=}}286}}''', will generate this:
{{Wikipedia ads|ad=286}}

== Notes ==

{{reflist}}

{{Wikipedia technical help|collapsed}}

[[Category:Wikipedia scripts| HotCat]]
[[Category:Wikipedia categorization tools]]
[[Category:Wikipedia mobile-friendly tools]]