User:CommonsDelinker

From Meta, a Wikimedia project coordination wiki
Jump to: navigation, search
CommonsDelinker.svg CommonsDelinker
Please feel free to create a page locally. Active wikis: Most Wikimedia wikis Approved in 2006 Operators bugtracker

CommonsDelinker is a service brought to local wikis by Wikimedia Commons administrators, maintained by Magnus Manske. It aims to prevent image links from visbily breaking on local wikis after a Commons file is deleted.

"File delinking" is the remedial action performed by CommonsDelinker in response to it detecting a Commons file having been deleted due to policy infractions (Non-free media, vandalism, etc). If you want to know why your file has been removed, please ask to the Commons administrator that deleted your file.

Latest news

  • 15:06, 19 January 2015 (UTC) CommonsDelinker rewritten by Magnus in PHP, see (phabricator:T86483)
  • 23:42, 18 February 2014 (UTC) CommonsDelinker moved to Tool Labs
  • 21:08, 8 November 2007 (UTC) CommonsDelinker is now running two plug-ins: on delinking media inside flag galleries on nl.wp, it does not delink, but replace with a place holder. It does the same on fr.wikibooks with other criteria.
  • 21:06, 8 November 2007 (UTC) Bugs and feature requests can be reported here
  • 21:04, 8 November 2007 (UTC) CommonsDelinker logs are now available here
  • 21:04, 8 November 2007 (UTC) CommonsDelinker is one of the first projects to run on the new stable toolserver

How it works

The bot periodically checks the Commons deletions log and for each deleted file, performs the following:

  • Wait ten minutes to give Commons administrators time to undo accidental deletions.
  • Consult GlobalUsage. If the image "Foobar.jpg" were deleted, for example, the bot would retrieve Special:GlobalUsage/Foobar.jpg
  • For each page returned by GlobalUsage:
  • Skip page if the associated wiki has a local image by that name.
  • Fetch the wikitext source of that page via the API.
  • Search and remove (or replace) any instances of the deleted image (e.g., [[File:Foobar.jpg]], [[File:Foobar.jpg|description|other|parameters]], or <gallery>Image:Foobar.jpg</gallery>).
  • The bot saves the page with a summary in English by default. See #Edit summary for localisation support.

Active wikis

  • All public Wikimedia wikis, except:
    • wikimania****.wikimedia.org wikis
    • uk.wikimania.org

Edit summary

The bot's edit summary can be translated via the following page names on the relevant wiki:

  • [[User:CommonsDelinker/summary-I18n]] (for image removals)
  • [[User:CommonsDelinker/replace-I18n]] (for image replacements).

Note: The page must be created on the target wiki, not on Meta-Wiki! If no such page exists on a wiki, the bot will first (for non-Wikipedia wikis) look for an edit summary in a similar language edition of a Wikipedia, after falling back to the default summary configured in the bot software.

It is recommended to protect these pages to prevent vandalism.

The bot's edit summaries incorporate the collaborative beauty of wikis. Individual wikis should feel free not only to translate the edit summary, but to tweak it, modify the style, add links, etc. Do keep the following variables in mind (all are optional and can be placed anywhere in the summary as many times as desired):

summary-I18n

  • $1 - The name of the file deleted on Commons. This does not include the prefix "Image:"
  • $2 - The username of the administrator on Commons that deleted the image being delinked.
  • $3 - The comment/summary/reason given by the Commons admin.

replace-I18n

  • $1 - The original filename
  • $2 - The new filename
  • $3 - The administrator that issued the replacement.
  • $4 - The reason the administrator gave.

Feedback

Report any comments, feature requests, complaints, bugs, etc. to https://bitbucket.org/magnusmanske/commons-delinquent/issues.

Source code

The old CommonsDelinker code is available under the terms of the MIT license in the pywikipedia Git repository. The new version (rewritten by Magnus Manske) is available at Bitbucket.

License

As administrators we think that the edits of CommonsDelinker are a necessary evil, and not copyrighted. They should be considered Public Domain.