Code Coverage
 
Lines
Functions and Methods
Classes and Traits
Total
94.59% covered (success)
94.59%
105 / 111
66.67% covered (warning)
66.67%
2 / 3
CRAP
0.00% covered (danger)
0.00%
0 / 1
DeleteEqualMessages
94.59% covered (success)
94.59%
105 / 111
66.67% covered (warning)
66.67%
2 / 3
26.11
0.00% covered (danger)
0.00%
0 / 1
 __construct
100.00% covered (success)
100.00%
8 / 8
100.00% covered (success)
100.00%
1 / 1
1
 fetchMessageInfo
100.00% covered (success)
100.00%
34 / 34
100.00% covered (success)
100.00%
1 / 1
9
 execute
91.30% covered (success)
91.30%
63 / 69
0.00% covered (danger)
0.00%
0 / 1
16.17
1<?php
2/**
3 * @license GPL-2.0-or-later
4 * @file
5 * @ingroup Maintenance
6 */
7
8use MediaWiki\Language\LanguageNameUtils;
9use MediaWiki\Maintenance\Maintenance;
10use MediaWiki\Specials\Pager\AllMessagesTablePager;
11use MediaWiki\Title\Title;
12use MediaWiki\User\User;
13
14// @codeCoverageIgnoreStart
15require_once __DIR__ . '/Maintenance.php';
16// @codeCoverageIgnoreEnd
17
18/**
19 * Maintenance script that deletes all pages in the MediaWiki namespace
20 * of which the content is equal to the system default.
21 *
22 * @ingroup Maintenance
23 */
24class DeleteEqualMessages extends Maintenance {
25    public function __construct() {
26        parent::__construct();
27        $this->addDescription( 'Deletes all pages in the MediaWiki namespace that are equal to '
28            . 'the default message' );
29        $this->addOption( 'delete', 'Actually delete the pages (default: dry run)' );
30        $this->addOption( 'delete-talk', 'Don\'t leave orphaned talk pages behind during deletion' );
31        $this->addOption( 'lang-code', 'Check for subpages of this language code (default: root '
32            . 'page against content language). Use value "*" to run for all mwfile language code '
33            . 'subpages (including the base pages that override content language).', false, true );
34    }
35
36    /**
37     * @param string|false $langCode See --lang-code option.
38     * @param array &$messageInfo
39     */
40    protected function fetchMessageInfo( $langCode, array &$messageInfo ) {
41        $services = $this->getServiceContainer();
42        $contLang = $services->getContentLanguage();
43        if ( $langCode ) {
44            $this->output( "\n... fetching message info for language: $langCode" );
45            $nonContentLanguage = true;
46        } else {
47            $this->output( "\n... fetching message info for content language" );
48            $langCode = $contLang->getCode();
49            $nonContentLanguage = false;
50        }
51
52        /* Based on SpecialAllmessages::reallyDoQuery #filter=modified */
53
54        $l10nCache = $services->getLocalisationCache();
55        $messageNames = $l10nCache->getSubitemList( 'en', 'messages' );
56        // Normalise message names for NS_MEDIAWIKI page_title
57        $messageNames = array_map( $contLang->ucfirst( ... ), $messageNames );
58
59        $statuses = AllMessagesTablePager::getCustomisedStatuses(
60            $messageNames,
61            $langCode,
62            $nonContentLanguage,
63            $this->getReplicaDB()
64        );
65        // getCustomisedStatuses is stripping the subpage from the page titles, add it back
66        $titleSuffix = $nonContentLanguage ? "/$langCode" : '';
67
68        foreach ( $messageNames as $key ) {
69            $customised = isset( $statuses['pages'][$key] );
70            if ( $customised ) {
71                $actual = wfMessage( $key )->inLanguage( $langCode )->plain();
72                $default = wfMessage( $key )->inLanguage( $langCode )->useDatabase( false )->plain();
73
74                $messageInfo['relevantPages']++;
75
76                if (
77                    // Exclude messages that are empty by default, such as sitenotice, specialpage
78                    // summaries and accesskeys.
79                    $default !== '' && $default !== '-' &&
80                        $actual === $default
81                ) {
82                    $hasTalk = isset( $statuses['talks'][$key] );
83                    $messageInfo['results'][] = [
84                        'title' => $key . $titleSuffix,
85                        'hasTalk' => $hasTalk,
86                    ];
87                    $messageInfo['equalPages']++;
88                    if ( $hasTalk ) {
89                        $messageInfo['equalPagesTalks']++;
90                    }
91                }
92            }
93        }
94    }
95
96    public function execute() {
97        $doDelete = $this->hasOption( 'delete' );
98        $doDeleteTalk = $this->hasOption( 'delete-talk' );
99        $langCode = $this->getOption( 'lang-code' );
100
101        $messageInfo = [
102            'relevantPages' => 0,
103            'equalPages' => 0,
104            'equalPagesTalks' => 0,
105            'results' => [],
106        ];
107
108        $this->output( 'Checking for pages with default message...' );
109
110        $services = $this->getServiceContainer();
111        // Load message information
112        if ( $langCode ) {
113            $langCodes = $services->getLanguageNameUtils()
114                ->getLanguageNames( LanguageNameUtils::AUTONYMS, LanguageNameUtils::SUPPORTED );
115            if ( $langCode === '*' ) {
116                // All valid lang-code subpages in NS_MEDIAWIKI that
117                // override the messages in that language
118                foreach ( $langCodes as $key => $value ) {
119                    $this->fetchMessageInfo( $key, $messageInfo );
120                }
121                // Lastly, the base pages in NS_MEDIAWIKI that override
122                // messages in content language
123                $this->fetchMessageInfo( false, $messageInfo );
124            } else {
125                if ( !isset( $langCodes[$langCode] ) ) {
126                    $this->fatalError( 'Invalid language code: ' . $langCode );
127                }
128                $this->fetchMessageInfo( $langCode, $messageInfo );
129            }
130        } else {
131            $this->fetchMessageInfo( false, $messageInfo );
132        }
133
134        if ( $messageInfo['equalPages'] === 0 ) {
135            // No more equal messages left
136            $this->output( "\ndone.\n" );
137
138            return;
139        }
140
141        $this->output( "\n{$messageInfo['relevantPages']} pages in the MediaWiki namespace "
142            . "override messages." );
143        $this->output( "\n{$messageInfo['equalPages']} pages are equal to the default message "
144            . "(+ {$messageInfo['equalPagesTalks']} talk pages).\n" );
145
146        if ( !$doDelete ) {
147            $list = '';
148            foreach ( $messageInfo['results'] as $result ) {
149                $title = Title::makeTitle( NS_MEDIAWIKI, $result['title'] );
150                $list .= "* [[$title]]\n";
151                if ( $result['hasTalk'] ) {
152                    $title = Title::makeTitle( NS_MEDIAWIKI_TALK, $result['title'] );
153                    $list .= "* [[$title]]\n";
154                }
155            }
156            $this->output( "\nList:\n$list\nRun the script again with --delete to delete these pages" );
157            if ( $messageInfo['equalPagesTalks'] !== 0 ) {
158                $this->output( " (include --delete-talk to also delete the talk pages)" );
159            }
160            $this->output( "\n" );
161
162            return;
163        }
164
165        $user = User::newSystemUser( 'MediaWiki default', [ 'steal' => true ] );
166        if ( !$user ) {
167            $this->fatalError( "Invalid username" );
168        }
169
170        // Hide deletions from RecentChanges
171        $userGroupManager = $services->getUserGroupManager();
172        $userGroupManager->addUserToGroup( $user, 'bot' );
173
174        // Handle deletion
175        $this->output( "\n...deleting equal messages (this may take a long time!)..." );
176        $dbw = $this->getPrimaryDB();
177        $wikiPageFactory = $services->getWikiPageFactory();
178        $delPageFactory = $services->getDeletePageFactory();
179        foreach ( $messageInfo['results'] as $result ) {
180            $this->waitForReplication();
181            $dbw->ping();
182            $title = Title::makeTitle( NS_MEDIAWIKI, $result['title'] );
183            $this->output( "\n* [[$title]]" );
184            $page = $wikiPageFactory->newFromTitle( $title );
185            $status = $delPageFactory->newDeletePage( $page, $user )->deleteUnsafe( 'No longer required' );
186            if ( !$status->isOK() ) {
187                $this->output( " (Failed!)" );
188            }
189            if ( $result['hasTalk'] && $doDeleteTalk ) {
190                $title = Title::makeTitle( NS_MEDIAWIKI_TALK, $result['title'] );
191                $this->output( "\n* [[$title]]" );
192                $page = $wikiPageFactory->newFromTitle( $title );
193                $status = $delPageFactory->newDeletePage( $page, $user )
194                    ->deleteUnsafe( 'Orphaned talk page of no longer required message' );
195                if ( !$status->isOK() ) {
196                    $this->output( " (Failed!)" );
197                }
198            }
199        }
200        $this->output( "\n\ndone!\n" );
201    }
202}
203
204// @codeCoverageIgnoreStart
205$maintClass = DeleteEqualMessages::class;
206require_once RUN_MAINTENANCE_IF_MAIN;
207// @codeCoverageIgnoreEnd