Manual:recountCategories.php
| MediaWiki version: | ≥ 1.30 |
| MediaWiki file: recountCategories.php | |
|---|---|
| Location: | maintenance/ |
| Source code: | master • 1.43.0 • 1.42.4 • 1.39.11 |
| Classes: | RecountCategories |
Details
editrecountCategories.php is a maintenance script used to update the counts of category members, if the numbers displayed on category pages are inaccurate. During normal operation, it shouldn't be needed to run this script. However, a bug may cause the counts to not update properly (see T18036 and T85696 and T170737, the script was run on all public Wikimedia wikis 2021-06-23).
Options/Arguments
edit| Option | Description | Required? |
|---|---|---|
| --mode | Which category count column to recompute: one of pages, subcats or files.
|
Required |
| --begin | Only recount categories with cat_id greater than the given value | Optional |
| --throttle | Wait this many milliseconds after each batch. Default: 0 | Optional |
| --skip-cleanup | Skip running cleanupEmptyCategories if the "page" mode is selected | Optional |
Usage
editphp maintenance/run.php recountCategories --mode modeName [ --begin| --throttle| --skip-cleanup ]
In MediaWiki version 1.39.10 and earlier, you must invoke maintenance scripts using
php maintenance/scriptName.php instead of php maintenance/run.php scriptName.With pages mode
editTerminal
$ php maintenance/run.php recountCategories --mode pages Starting to recount pages counts. Finding up to 500 drifted rows greater than cat_id 0... Updated the pages counts of 0 categories. Done! Now run the script using the other --mode options if you haven't already. Running cleanupEmptyCategories.php Adding empty categories with description pages... Removing empty categories without description pages... Category cleanup complete.
With subcats mode
editTerminal
$ php maintenance/run.php recountCategories --mode subcats Starting to recount subcats counts. Finding up to 500 drifted rows greater than cat_id 0... Updated the subcats counts of 0 categories. Done! Now run the script using the other --mode options if you haven't already.
With files mode
editTerminal
$ php maintenance/run.php recountCategories --mode files Starting to recount files counts. Finding up to 500 drifted rows greater than cat_id 0... Updated the files counts of 0 categories. Done! Now run the script using the other --mode options if you haven't already.