3 * Formatter for delete log entries.
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
21 * @author Niklas Laxström
22 * @license GPL-2.0-or-later
26 use MediaWiki\Storage\RevisionRecord
;
29 * This class formats delete log entries.
33 class DeleteLogFormatter
extends LogFormatter
{
34 /** @var array|null */
35 private $parsedParametersDeleteLog;
40 protected function getMessageKey() {
41 $key = parent
::getMessageKey();
42 if ( in_array( $this->entry
->getSubtype(), [ 'event', 'revision' ] ) ) {
43 if ( count( $this->getMessageParameters() ) < 5 ) {
44 // Messages: logentry-delete-event-legacy, logentry-delete-revision-legacy,
45 // logentry-suppress-event-legacy, logentry-suppress-revision-legacy
48 } elseif ( $this->entry
->getSubtype() === 'restore' ) {
49 $rawParams = $this->entry
->getParameters();
50 if ( !isset( $rawParams[':assoc:count'] ) ) {
51 // Message: logentry-delete-restore-nocount
52 return $key . '-nocount';
62 protected function getMessageParameters() {
63 if ( $this->parsedParametersDeleteLog
!== null ) {
64 return $this->parsedParametersDeleteLog
;
67 $params = parent
::getMessageParameters();
68 $subtype = $this->entry
->getSubtype();
69 if ( in_array( $subtype, [ 'event', 'revision' ] ) ) {
70 // $params[3] here is 'revision' or 'archive' for page revisions, 'oldimage' or
71 // 'filearchive' for file versions, or a comma-separated list of log_ids for log
72 // entries. $subtype here is 'revision' for page revisions and file
73 // versions, or 'event' for log entries.
75 ( $subtype === 'event' && count( $params ) === 6 )
77 $subtype === 'revision' && isset( $params[3] )
78 && in_array( $params[3], [ 'revision', 'archive', 'oldimage', 'filearchive' ] )
81 // See RevDelList::getLogParams()/RevDelLogList::getLogParams()
82 $paramStart = $subtype === 'revision' ?
4 : 3;
84 $old = $this->parseBitField( $params[$paramStart +
1] );
85 $new = $this->parseBitField( $params[$paramStart +
2] );
86 list( $hid, $unhid, $extra ) = RevisionDeleter
::getChanges( $new, $old );
88 // messages used: revdelete-content-hid, revdelete-summary-hid, revdelete-uname-hid
89 foreach ( $hid as $v ) {
90 $changes[] = $this->msg( "$v-hid" )->plain();
92 // messages used: revdelete-content-unhid, revdelete-summary-unhid,
93 // revdelete-uname-unhid
94 foreach ( $unhid as $v ) {
95 $changes[] = $this->msg( "$v-unhid" )->plain();
97 foreach ( $extra as $v ) {
98 $changes[] = $this->msg( $v )->plain();
100 $changeText = $this->context
->getLanguage()->listToText( $changes );
102 $newParams = array_slice( $params, 0, 3 );
103 $newParams[3] = $changeText;
104 $ids = is_array( $params[$paramStart] )
105 ?
$params[$paramStart]
106 : explode( ',', $params[$paramStart] );
107 $newParams[4] = $this->context
->getLanguage()->formatNum( count( $ids ) );
109 $this->parsedParametersDeleteLog
= $newParams;
110 return $this->parsedParametersDeleteLog
;
112 $this->parsedParametersDeleteLog
= array_slice( $params, 0, 3 );
113 return $this->parsedParametersDeleteLog
;
115 } elseif ( $subtype === 'restore' ) {
116 $rawParams = $this->entry
->getParameters();
117 if ( isset( $rawParams[':assoc:count'] ) ) {
119 foreach ( $rawParams[':assoc:count'] as $type => $count ) {
121 // Messages: restore-count-revisions, restore-count-files
122 $countList[] = $this->context
->msg( 'restore-count-' . $type )
123 ->numParams( $count )->plain();
126 $params[3] = $this->context
->getLanguage()->listToText( $countList );
130 $this->parsedParametersDeleteLog
= $params;
131 return $this->parsedParametersDeleteLog
;
134 protected function parseBitField( $string ) {
135 // Input is like ofield=2134 or just the number
136 if ( strpos( $string, 'field=' ) === 1 ) {
137 list( , $field ) = explode( '=', $string );
145 public function getActionLinks() {
146 $user = $this->context
->getUser();
147 $linkRenderer = $this->getLinkRenderer();
148 if ( !$user->isAllowed( 'deletedhistory' )
149 ||
$this->entry
->isDeleted( LogPage
::DELETED_ACTION
)
154 switch ( $this->entry
->getSubtype() ) {
155 case 'delete': // Show undelete link
157 if ( $user->isAllowed( 'undelete' ) ) {
158 $message = 'undeletelink';
160 $message = 'undeleteviewlink';
162 $revert = $linkRenderer->makeKnownLink(
163 SpecialPage
::getTitleFor( 'Undelete' ),
164 $this->msg( $message )->text(),
166 [ 'target' => $this->entry
->getTarget()->getPrefixedDBkey() ]
169 return $this->msg( 'parentheses' )->rawParams( $revert )->escaped();
171 case 'revision': // If an edit was hidden from a page give a review link to the history
172 $params = $this->extractParameters();
173 if ( !isset( $params[3] ) ||
!isset( $params[4] ) ) {
177 // Different revision types use different URL params...
179 // This is a array or CSV of the IDs
180 $ids = is_array( $params[4] )
182 : explode( ',', $params[4] );
186 // If there's only one item, we can show a diff link
187 if ( count( $ids ) == 1 ) {
188 // Live revision diffs...
189 if ( $key == 'oldid' ||
$key == 'revision' ) {
190 $links[] = $linkRenderer->makeKnownLink(
191 $this->entry
->getTarget(),
192 $this->msg( 'diff' )->text(),
195 'diff' => intval( $ids[0] ),
199 // Deleted revision diffs...
200 } elseif ( $key == 'artimestamp' ||
$key == 'archive' ) {
201 $links[] = $linkRenderer->makeKnownLink(
202 SpecialPage
::getTitleFor( 'Undelete' ),
203 $this->msg( 'diff' )->text(),
206 'target' => $this->entry
->getTarget()->getPrefixedDBkey(),
208 'timestamp' => $ids[0]
214 // View/modify link...
215 $links[] = $linkRenderer->makeKnownLink(
216 SpecialPage
::getTitleFor( 'Revisiondelete' ),
217 $this->msg( 'revdel-restore' )->text(),
220 'target' => $this->entry
->getTarget()->getPrefixedText(),
222 'ids' => implode( ',', $ids ),
226 return $this->msg( 'parentheses' )->rawParams(
227 $this->context
->getLanguage()->pipeList( $links ) )->escaped();
229 case 'event': // Hidden log items, give review link
230 $params = $this->extractParameters();
231 if ( !isset( $params[3] ) ) {
234 // This is a CSV of the IDs
236 if ( is_array( $query ) ) {
237 $query = implode( ',', $query );
239 // Link to each hidden object ID, $params[1] is the url param
240 $revert = $linkRenderer->makeKnownLink(
241 SpecialPage
::getTitleFor( 'Revisiondelete' ),
242 $this->msg( 'revdel-restore' )->text(),
245 'target' => $this->entry
->getTarget()->getPrefixedText(),
251 return $this->msg( 'parentheses' )->rawParams( $revert )->escaped();
257 protected function getParametersForApi() {
258 $entry = $this->entry
;
261 $subtype = $this->entry
->getSubtype();
262 if ( in_array( $subtype, [ 'event', 'revision' ] ) ) {
263 $rawParams = $entry->getParameters();
264 if ( $subtype === 'event' ) {
265 array_unshift( $rawParams, 'logging' );
273 '4::ids' => '5::ids',
274 '5::ofield' => '6::ofield',
275 '6::nfield' => '7::nfield',
277 foreach ( $map as $index => $key ) {
278 if ( isset( $rawParams[$index] ) ) {
279 $rawParams[$key] = $rawParams[$index];
280 unset( $rawParams[$index] );
284 if ( !is_array( $rawParams['5::ids'] ) ) {
285 $rawParams['5::ids'] = explode( ',', $rawParams['5::ids'] );
289 '::type' => $rawParams['4::type'],
290 ':array:ids' => $rawParams['5::ids'],
294 RevisionRecord
::DELETED_TEXT
=> 'content',
295 RevisionRecord
::DELETED_COMMENT
=> 'comment',
296 RevisionRecord
::DELETED_USER
=> 'user',
297 RevisionRecord
::DELETED_RESTRICTED
=> 'restricted',
300 if ( isset( $rawParams['6::ofield'] ) ) {
301 $old = $this->parseBitField( $rawParams['6::ofield'] );
302 $params[':assoc:old'] = [ 'bitmask' => $old ];
303 foreach ( $fields as $bit => $key ) {
304 $params[':assoc:old'][$key] = (bool)( $old & $bit );
307 if ( isset( $rawParams['7::nfield'] ) ) {
308 $new = $this->parseBitField( $rawParams['7::nfield'] );
309 $params[':assoc:new'] = [ 'bitmask' => $new ];
310 foreach ( $fields as $bit => $key ) {
311 $params[':assoc:new'][$key] = (bool)( $new & $bit );
314 } elseif ( $subtype === 'restore' ) {
315 $rawParams = $entry->getParameters();
316 if ( isset( $rawParams[':assoc:count'] ) ) {
317 $params[':assoc:count'] = $rawParams[':assoc:count'];
324 public function formatParametersForApi() {
325 $ret = parent
::formatParametersForApi();
326 if ( isset( $ret['ids'] ) ) {
327 ApiResult
::setIndexedTagName( $ret['ids'], 'id' );