User:CommonsDelinker/commands/documentation

User:CommonsDelinker/commands is a protected page that CommonsDelinker and other bots read periodically to retrieve and perform the tasks indicated there. If you are not a sysop, you can add your requests here or ask any of the many sysops you may see in recent changes to edit the page with your request. Sysops can edit the commands page directly.

Rules:

  1. The Commands page must always be protected. We don't want to give just anyone the power to control the bot.
  2. You must be sure about what you're doing before you edit Commands.
  3. Indicate the desired changes only as described here. Do not try to get something done by "tricking" the bot.
  4. Commands doesn't need to look pretty, it doesn't matter in the least bit.
  5. Put one command per line.

Controlling the category rename bot edit

To rename (move) a category to another, use the template {{move cat|cat1|cat2}}. Do not include the namespace here. To move Category:Foo to Category:Bar, for example, you would put

{{move cat|Foo|Bar|reason=reason of renaming|user=JohnDoe}}
Rename Category:Foo to Category:Bar (1 entries moved, 8 to go) (Requested by JohnDoe) give reason here

The parameter reason can be omitted, the parameter user is mandatory.

If the destination category does not exist, it is created first with a copy of the source category. If the destination category does exist, only the items belonging to the source category are moved. Be careful if the destination is a redirect because cross redirects are not yet detected automatically during the cat move.

Controlling CommonsDelinker (Universal image replacements) edit

To replace one image with another across all Wikimedia projects, use the template {{Universal replace}} with three parameters. The first parameter should be the name of the old image (the image that is to be replaced), the second parameter should be the name of the new image (the image with which the old image will be replaced), the third the reason for replacing the image.

Thus, to replace File:Foo.jpg with File:Bar.jpg because it is a duplicate, we place in /commands:

{{universal replace|Foo.jpg|Bar.jpg|reason=duplicates}}
CommonsDelinker: Replace File:Foo.jpg with File:Bar.jpg across all Wikimedia projects. Reason: duplicates

Notes:

  • To avoid World War III, if the new image is svg and the original is not, CommonsDelinker will ignore the command.
  • The parameter reason is mandatory. If it is missing, the command will not be executed (although it stays listed) without further notice.

Issues edit

https://bitbucket.org/magnusmanske/commons-delinquent/issues