Italian Wikipedia Deletion Bot (BotCancellazioni)

This is the software used by the Italian Wikipedia bot "BotCancellazioni" since 2018, running 24/7:

https://it.wikipedia.org/wiki/Utente:BotCancellazioni

The bot "BotCancellazioni" keeps updated the public deletion logs of Italian Wikipedia pages:

https://it.wikipedia.org/wiki/Wikipedia:Pagine_da_cancellare

Bug Reports / Feature Requests

All Italian users are encouraged to discuss in the talk page, on-wiki:

https://it.wikipedia.org/wiki/Discussioni_utente:BotCancellazioni

All English users, or technical users, are encouraged to file a task in Wikimedia Phabricator, under the column "BotCancellazioni":

https://phabricator.wikimedia.org/tag/tool-itwiki/

Installation

To install this software in your computer, run these commands:

sudo apt install git php-cli
git clone --recursive https://gitlab.wikimedia.org/valeriobozzolan/itwiki-deletions-info-bot.git

Update

To pull latest changes, run these commands:

git pull
git submodule update --init --recursive

Configuration

The bot supports a configuration wizard. To start the configuration wizard, just execute the bot at least once (look at "Usage").

If you need to manually configure your bot instead:

1. Open the file config-example.php with a text editor
2. Save-as config.php
3. Fill your bot credentials using a modern "bot password" - https://it.wikipedia.org/wiki/Speciale:BotPasswords

Usage

To list all available options:

$ ./bot.php --help

usage: ./bot.php [OPTIONS]
    --days=DAYS        how many days to be processed (default: 1)
    --from=YYYY-MM-DD  starting date (default: today)
    --minutes-ago=N    quits if the last edit was below N minutes ago (default: 5)
    --ask              ask before saving
    --verbose          verbose mode
    --no-term-wrap     do not automatically wrap output lines to stay inside your terminal
 -h --help             show this help and exit

To run the bot on today:

./bot.php

To run on the latest 10 days from today:

./bot.php --days=10

To run on a specific date (year-month-day):

./bot.php --from=2018-03-13

To run on a specific date and for 10 days before it:

./bot.php --days=10 --from=2018-03-13

To quit if someone was running the bot just 5 minutes ago (that is the default behaviour):

./bot.php --minutes-ago=5

To ask before saving and enable verbose mode (good for debugging):

./bot.php --ask --verbose

Hacking

Most of the behaviours — as the content of the categories, the pages, their edit summaries, etc. — can be changed simply hacking the content of the files from the /templates directory. Trust me, you are able to do it.

Start becoming familiar with their structure:

	<!-- START DOCUMENTATION -->
	This is the place for some documentation, expecially about "placeholders".
	<!-- START SPECIFIC EXAMPLE -->
	This is the place for a specific example
	<!-- START TEMPLATE -->
	This is the place for the most important part of this file.
	This part is what this template will generates.
	It uses stuff like "$1" or "%1%02d" as generic placeholders.

To be honest: everything above the <!-- START TEMPLATE --> line it's pure documentation sugar. It's written to help you. I've spent some minutes on them. Please RTFM. asd

A non-traumatic template example can be found here. It describes the generation of the yearly category.

Framework

You may not want to know this: HTTP connections, MediaWiki APIs (including login and tokens etc.), and other stuff, are handled by the boz-mw framework.

License

Copyright (C) 2018-2026 Valerio Bozzolan, contributors

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Original files released under Creative Commons BY-SA 3.0 International and WMF terms by Mauro742/MauroBot:

• https://it.wikipedia.org/wiki/Utente:MauroBot/BotCancellazioni/main.js
• https://it.wikipedia.org/wiki/Utente:MauroBot/BotCancellazioni/bot.js
• https://it.wikipedia.org/wiki/Utente:MauroBot/BotCancellazioni/category.js
• https://it.wikipedia.org/wiki/Utente:MauroBot/BotCancellazioni/dateFunctions.js
• https://it.wikipedia.org/wiki/Utente:MauroBot/BotCancellazioni/core.js
• https://it.wikipedia.org/wiki/Utente:MauroBot/BotCancellazioni/globals.js
• https://it.wikipedia.org/wiki/Utente:MauroBot/BotCancellazioni/gui.js