|Please feel free to create a page locally.||Active wikis: Most Wikimedia wikis||Approved in 2006||operator||bugreports|
CommonsDelinker is a service brought to local wikis by Wikimedia Commons administrators, maintained by grin (and was originally created and maintained by Magnus Manske). It aims to prevent image links from visibly 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 the Commons administrator that deleted your file.
Emergency bot shutoff buttonAdministrators: Use this button if the bot is malfunctioning (direct link)
Admins: If you are blocking this bot, MAKE SURE TO DISABLE AUTOBLOCK, otherwise you will block a number of bots running on Wikimedia Cloud Services.
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.,
- The bot saves the page with a summary in English by default. See #Edit summary for localisation support.
- All public Wikimedia wikis, except for private, closed and fishbowl wikis and:
The following wikis are disabled due to manual request, SUL errors, bans or other irregular behaviour/errors.
- wikimania wikis
- strategy wiki
- foundation wiki
- test wikidata
- usability wiki
- donate wiki
- en wikinews
- uk wikimedia
- mx wikimedia
- rs wikimedia
- id wikimedia
- bd wikimedia
- mai wikimedia
- am wikimedia
- ge wikimedia
- ten wp
- st wp
- mni wp
- mnw wikt
- mni wikt
- shn wikt
- nia wikt
- waw wsource
- ban wsource
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):
- $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.
- $1 - The original filename
- $2 - The new filename
- $3 - The administrator that issued the replacement.
- $4 - The reason the administrator gave.
Report all problems on User talk:CommonsDelinker and don't forget to ping grin.
Report any comments, feature requests, complaints, bugs, etc. to https://bitbucket.org/magnusmanske/commons-delinquent/issues.
The current source code is not yet publicly available, but you can request it from grin if you feel like browsing.
The very old and outdated CommonsDelinker code is available under the terms of the MIT license in the pywikibot Git repository (github hosted version). The old and outdated version (rewritten by Magnus Manske) is available at Bitbucket.
As administrators we think that the edits of CommonsDelinker are a necessary evil, and not copyrighted. They should be considered Public Domain.