Wikipedia:FurMe

FurMe was a set of JavaScripts that gives registered users a convenient way to manage Image namespace specific tasks, primarily to generate non-free use rationales to images that lack them. FurMe is based on the morebits.js library, and therefore is subject to all usage restrictions inherited from that library (please see the TWINKLE doc page for more information).

Notes
 * 1) This script is tested only on Mozilla Firefox (and unofficially Opera and Safari). It will not work on Microsoft Internet Explorer.

Installation
To install FurMe, including all future updates and additions:

mw.loader.load('//en.wikipedia.org/w/index.php?title=User:AWeenieMan/furme.js&action=raw&ctype=text/javascript'); mw.loader.load('//en.wikipedia.org/w/index.php?title=User:AzaToth/morebits.js&action=raw&ctype=text/javascript'); mw.loader.load('//en.wikipedia.org/w/index.php?title=User:AWeenieMan/furme.js&action=raw&ctype=text/javascript'); mw.loader.load('//en.wikipedia.org/w/index.php?title=User:AWeenieMan/furmeScroller.js&action=raw&ctype=text/javascript');
 * If you have Twinkle installed, copy the text below and paste it into the bottom of your skin.js file:
 * If you do not have Twinkle installed, copy the text below and paste it into the bottom of your skin.js file:
 * If you would also like FurMeScroller functionality, copy the text below and paste it into the bottom of your skin.js file:
 * Save the new skin.js page, and
 * Completely refresh your browser by bypassing your cache (Firefox: Control-Shift-R / Firefox Mac: Command-Shift-R / Explorer: Control-F5)
 * Done!

Functionality of FurMe
FurMe adds a "fur" tab to the top of pages in the Image namespace. Through this tab, you can select to add one of the following templates to the summary section of the image.


 * non-free use rationale
 * logo fur
 * album cover fur
 * book cover fur
 * film cover fur

To make this task easier, you are prompted to enter values into the most commonly used fields

Auto fill-in of fields
FurMe attempts to fill in certain fields, as described below.


 * non-free use rationale
 * The "Article" field is automatically populated if there is only one field listed in the "File links" section of the page.
 * The "Source" field is automatically populated if there is a single external URL in the text of the page.
 * The "Low_resolution" field is automatically populated as "Yes" if the image is below 300px in width or height.


 * logo fur
 * The "Website" field is automatically populated if there is a single external URL in the text of the page.
 * If there is only one article listed in the "File links" section of the page
 * The "Article" field is automatically populated
 * The infobox option is automatically selected if the image is found in a templated infobox in that article.


 * album cover fur
 * The "Source" field is automatically populated if there is a single external URL in the text of the page.
 * If there is only one article listed in the "File links" section of the page
 * The "Article" field is automatically populated
 * The infobox option is automatically selected if the image is found in a templated infobox in that article.
 * The "Album" field is populated with the value from the infobox
 * The "Artist" field is populated with the value from the infobox
 * The "Label" field is populated with the value from the infobox


 * book cover fur
 * The "Website" field is automatically populated if there is a single external URL in the text of the page.
 * If there is only one article listed in the "File links" section of the page
 * The "Article" field is automatically populated
 * The infobox option is automatically selected if the image is found in a templated infobox in that article.
 * The "Title" field is populated with the value from the infobox
 * The "Author" field is populated with the value from the infobox
 * The "Publisher" field is populated with the value from the infobox
 * The "Cover Artist" field is populated with the value from the infobox
 * The "Year" field is populated with the value from the infobox


 * film cover fur
 * The "Website" field is automatically populated if there is a single external URL in the text of the page.
 * If there is only one article listed in the "File links" section of the page
 * The "Article" field is automatically populated
 * The infobox option is automatically selected if the image is found in a templated infobox in that article.
 * The "Name" field is populated with the value from the infobox
 * The "Distributor" field is populated with the value from the infobox

Removal of templates
FurMe will remove the following templates from the page (a proper fair use rationale should fix any of the problems described in these templates).


 * Di-no source (redirects: No source, Unspecified, Unknownsource, Fairuseunknownsource, Fuus, Nosource, No source since, No source notified, No info, Nosources, Di-no-source)
 * Di-disputed fair use rationale (redirects: Di-disputed rationale, Improve rationale)
 * Di-no fair use rationale (redirects: No rationale, Fairuse rationale needed, Fu-ra-ne, Norat, Norationale, Di-no rationale)

Removal of categories
FurMe will remove the following categories from pages it edits.


 * Category:Disputed non-free images (and date based subcategories)

Preview/Saving changes
By default, FurMe does not automatically save your changes. After submitting the form, you will be prompted with a diff of the proposed changes. See the Configuration section for details on how to change this behavior.

General Cleanup
FurMe makes the following minor cleanup to the page.


 * Will change ==Summary== to == Summary ==
 * Will add == Summary == (if it does not already exist)
 * Will add == Licensing == (if it does not already exist) above the non-free license template
 * Will clean Amazon URLs, stripping extraneous parameters and normalizing format

Tag tab
FurMe also adds an additional "Tags" tab to pages in the Image namespace, allowing the management of image templates with a simple checklist, and a dropdown for automatically changing the licence tag of an image.

Functionality of FurMeScroller
FurMeScroller is an add-on to FurMe. It allows for scrolling through a specially crafted list of image links, opening FurMe after each image opens. After the image changes are saved, the next image is opened.

This technique allows for going through a large number of images fairly quickly (note: this technique may not be useful for all image lists, it is useful, however, for album covers used only in one article, for example).

It is possible to have FurMeScroller automatically open any article in which an image is used, but in which it is not used in an infobox. When FurMeScroller opens this article, it will highlight the image in question in pink and give you the option of removing the image. See the Configuration section for removal options.

By default, FurMeScroller goes through ten images at a time. See the Configuration section for details on how to change this behavior.

Image lists for FurMeScroller
The following image lists are available. They are updated periodically (or upon request).


 * Album Covers
 * All disputed fair use album covers
 * Fair use album covers used in one article
 * Fair use album covers used in two articles
 * Fair use album covers used in three or more articles
 * Book Covers
 * All disputed fair use book covers
 * Fair use book covers used in one article
 * Fair use book covers used in two articles
 * Fair use book covers used in three or more articles
 * Historic Images
 * All disputed fair use historic images
 * Fair use historic images used in one article
 * Fair use historic images used in two articles
 * Fair use historic images used in three or more articles
 * Logos
 * All disputed fair use logos
 * Fair use logos used in one article
 * Fair use logos used in two articles
 * Fair use logos used in three or more articles
 * Video Covers
 * All disputed fair use video covers
 * Fair use video covers used in one article
 * Fair use video covers used in two articles
 * Fair use video covers used in three or more articles

Configuration
To configure FurMe, copy the text below called FurMeConfig, and paste it in your monobook.js file.

This is the default configuration:

actionOnSubmit
Defines the action taken when you hit the "Submit Query" button.

Argument is a string, and the values might be 'none', 'diff', 'preview' and 'save'

cleanAmazonURLs
Defines if Amazon URLs should be cleaned of extraneous URL parameters and normalized to the http://www.amazon.com/o/ASIN/%ASIN% format (note: this is domain sensitive, keeping the link to its current domain).

Argument is a boolean.

furmeLocation
Defines where the link to initialize FurMe is located.

Argument is a string with following values:
 * 'filetoc': in the file table of contents (box that says Image, File history, File links, etc)
 * 'personal': with the personal links (my talk, my preferences, my watchlist, etc)
 * 'tab': as a tab (discussion, history, etc)
 * 'toolbox': in the toolbox

imageRemovalMethod
Defines the method of removing an invalid fair-use image (only used when FurMe auto-opens an article).

Argument is a string with following values:
 * 'comment': comments the image in the fashion
 * 'nonfreeimageremoved': replaces image with Image:NonFreeImageRemoved.svg
 * 'pixel': replaces image with Image:Pixel.gif

linkFreeLogo
Defines if a new tab or link will be visible that allows the removal of non-free use rationales and license templates and places a PD-textlogo license in its place. This option will place the new link using the furmeLocation option.

Argument is a boolean.

linkImageTags
Defines if a new tab or link will be visible that allows the replacement of license templates as well as the addition of various other image tags. This option will place the new link using the furmeLocation option.

Argument is a boolean.

openAllArticles
Defines if FurMeScroller will open multiple articles in which the image is used (to a max of ten). This option will not work with openArticleMode set to 'none' or 'window.'

Argument is a boolean.

openArticleMode
Defines if the article page should be opened when the image is used in only one article and not in that articles infobox.

Argument is a string with following values:
 * 'window': opens a (named) popup window
 * 'tab': tries if possible to open in a new tab (may or may not work)
 * 'blank': similar to window mode, but force it into a clean new window, instead of remembering the window
 * 'browser': Let the browser choose how to handle the (uniquely named) pop-up window (recommended)
 * 'none' : do not open the article

renameMethod
Defines the template used to mark an image for renaming.

Argument is a string with the following values:
 * 'ifd': Uses the template
 * 'bot': Uses the template. See Image renaming.

scrollerMax
Defines the number of images through which to scroll when FurMeScroller is activated.

Argument is an integer value.

scrollerSkipDone
Defines if FurMeScroller should skip past images that do not have a deletion template.

Argument is a boolean.

tagsImageLicenseFavorites
Defines the favorites (listed at the top of the menu) for the license menu on the "tags" tab.

Argument is an array. Example: [ 'PD-self', 'GFDL', 'PD-textlogo' ]

tagsImageTagFavorites
Defines the favorites section for the templates listed on the "tags" tab.

Argument is an array. Example: [ , , '' ] ;

watchMyEdits
Defines whether to add edits made using FurMe to your watchlist.

Argument is a boolean.

windowHeight
Defines the height of the FurMe window. It is recommended that you do not include this preference unless you are experiencing problems with the default window height. The default value is subject to change (and will always be large enough to have the FurMe window appear without a scrollbar).

Argument is an integer value.