includes/revisiondelete/RevisionDelete.php

   1 <?php
   2 /**
   3  * Base implementations for deletable items.
   4  *
   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.
   9  *
  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.
  14  *
  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
  19  *
  20  * @file
  21  * @ingroup RevisionDelete
  22  */
  23
  24 /**
  25  * List for revision table items
  26  *
  27  * This will check both the 'revision' table for live revisions and the
  28  * 'archive' table for traditionally-deleted revisions that have an
  29  * ar_rev_id saved.
  30  *
  31  * See RevDelRevisionItem and RevDelArchivedRevisionItem for items.
  32  */
  33 class RevDelRevisionList extends RevDelList {
  34         /** @var int */
  35         var $currentRevId;
  36
  37         public function getType() {
  38                 return 'revision';
  39         }
  40
  41         public static function getRelationType() {
  42                 return 'rev_id';
  43         }
  44
  45         public static function getRestriction() {
  46                 return 'deleterevision';
  47         }
  48
  49         public static function getRevdelConstant() {
  50                 return Revision::DELETED_TEXT;
  51         }
  52
  53         public static function suggestTarget( $target, array $ids ) {
  54                 $rev = Revision::newFromId( $ids[0] );
  55                 return $rev ? $rev->getTitle() : $target;
  56         }
  57
  58         /**
  59          * @param DatabaseBase $db
  60          * @return mixed
  61          */
  62         public function doQuery( $db ) {
  63                 $ids = array_map( 'intval', $this->ids );
  64                 $live = $db->select(
  65                         array( 'revision', 'page', 'user' ),
  66                         array_merge( Revision::selectFields(), Revision::selectUserFields() ),
  67                         array(
  68                                 'rev_page' => $this->title->getArticleID(),
  69                                 'rev_id' => $ids,
  70                         ),
  71                         __METHOD__,
  72                         array( 'ORDER BY' => 'rev_id DESC' ),
  73                         array(
  74                                 'page' => Revision::pageJoinCond(),
  75                                 'user' => Revision::userJoinCond() )
  76                 );
  77
  78                 if ( $live->numRows() >= count( $ids ) ) {
  79                         // All requested revisions are live, keeps things simple!
  80                         return $live;
  81                 }
  82
  83                 // Check if any requested revisions are available fully deleted.
  84                 $archived = $db->select( array( 'archive' ), Revision::selectArchiveFields(),
  85                         array(
  86                                 'ar_rev_id' => $ids
  87                         ),
  88                         __METHOD__,
  89                         array( 'ORDER BY' => 'ar_rev_id DESC' )
  90                 );
  91
  92                 if ( $archived->numRows() == 0 ) {
  93                         return $live;
  94                 } elseif ( $live->numRows() == 0 ) {
  95                         return $archived;
  96                 } else {
  97                         // Combine the two! Whee
  98                         $rows = array();
  99                         foreach ( $live as $row ) {
 100                                 $rows[$row->rev_id] = $row;
 101                         }
 102                         foreach ( $archived as $row ) {
 103                                 $rows[$row->ar_rev_id] = $row;
 104                         }
 105                         krsort( $rows );
 106                         return new FakeResultWrapper( array_values( $rows ) );
 107                 }
 108         }
 109
 110         public function newItem( $row ) {
 111                 if ( isset( $row->rev_id ) ) {
 112                         return new RevDelRevisionItem( $this, $row );
 113                 } elseif ( isset( $row->ar_rev_id ) ) {
 114                         return new RevDelArchivedRevisionItem( $this, $row );
 115                 } else {
 116                         // This shouldn't happen. :)
 117                         throw new MWException( 'Invalid row type in RevDelRevisionList' );
 118                 }
 119         }
 120
 121         public function getCurrent() {
 122                 if ( is_null( $this->currentRevId ) ) {
 123                         $dbw = wfGetDB( DB_MASTER );
 124                         $this->currentRevId = $dbw->selectField(
 125                                 'page', 'page_latest', $this->title->pageCond(), __METHOD__ );
 126                 }
 127                 return $this->currentRevId;
 128         }
 129
 130         public function getSuppressBit() {
 131                 return Revision::DELETED_RESTRICTED;
 132         }
 133
 134         public function doPreCommitUpdates() {
 135                 $this->title->invalidateCache();
 136                 return Status::newGood();
 137         }
 138
 139         public function doPostCommitUpdates() {
 140                 $this->title->purgeSquid();
 141                 // Extensions that require referencing previous revisions may need this
 142                 wfRunHooks( 'ArticleRevisionVisibilitySet', array( &$this->title ) );
 143                 return Status::newGood();
 144         }
 145 }
 146
 147 /**
 148  * Item class for a live revision table row
 149  */
 150 class RevDelRevisionItem extends RevDelItem {
 151         /** @var Revision */
 152         var $revision;
 153
 154         public function __construct( $list, $row ) {
 155                 parent::__construct( $list, $row );
 156                 $this->revision = new Revision( $row );
 157         }
 158
 159         public function getIdField() {
 160                 return 'rev_id';
 161         }
 162
 163         public function getTimestampField() {
 164                 return 'rev_timestamp';
 165         }
 166
 167         public function getAuthorIdField() {
 168                 return 'rev_user';
 169         }
 170
 171         public function getAuthorNameField() {
 172                 return 'rev_user_text';
 173         }
 174
 175         public function canView() {
 176                 return $this->revision->userCan( Revision::DELETED_RESTRICTED, $this->list->getUser() );
 177         }
 178
 179         public function canViewContent() {
 180                 return $this->revision->userCan( Revision::DELETED_TEXT, $this->list->getUser() );
 181         }
 182
 183         public function getBits() {
 184                 return $this->revision->getVisibility();
 185         }
 186
 187         public function setBits( $bits ) {
 188                 $dbw = wfGetDB( DB_MASTER );
 189                 // Update revision table
 190                 $dbw->update( 'revision',
 191                         array( 'rev_deleted' => $bits ),
 192                         array(
 193                                 'rev_id' => $this->revision->getId(),
 194                                 'rev_page' => $this->revision->getPage(),
 195                                 'rev_deleted' => $this->getBits()
 196                         ),
 197                         __METHOD__
 198                 );
 199                 if ( !$dbw->affectedRows() ) {
 200                         // Concurrent fail!
 201                         return false;
 202                 }
 203                 // Update recentchanges table
 204                 $dbw->update( 'recentchanges',
 205                         array(
 206                                 'rc_deleted' => $bits,
 207                                 'rc_patrolled' => 1
 208                         ),
 209                         array(
 210                                 'rc_this_oldid' => $this->revision->getId(), // condition
 211                                 // non-unique timestamp index
 212                                 'rc_timestamp' => $dbw->timestamp( $this->revision->getTimestamp() ),
 213                         ),
 214                         __METHOD__
 215                 );
 216                 return true;
 217         }
 218
 219         public function isDeleted() {
 220                 return $this->revision->isDeleted( Revision::DELETED_TEXT );
 221         }
 222
 223         public function isHideCurrentOp( $newBits ) {
 224                 return ( $newBits & Revision::DELETED_TEXT )
 225                         && $this->list->getCurrent() == $this->getId();
 226         }
 227
 228         /**
 229          * Get the HTML link to the revision text.
 230          * Overridden by RevDelArchiveItem.
 231          * @return string
 232          */
 233         protected function getRevisionLink() {
 234                 $date = htmlspecialchars( $this->list->getLanguage()->userTimeAndDate(
 235                         $this->revision->getTimestamp(), $this->list->getUser() ) );
 236
 237                 if ( $this->isDeleted() && !$this->canViewContent() ) {
 238                         return $date;
 239                 }
 240                 return Linker::linkKnown(
 241                         $this->list->title,
 242                         $date,
 243                         array(),
 244                         array(
 245                                 'oldid' => $this->revision->getId(),
 246                                 'unhide' => 1
 247                         )
 248                 );
 249         }
 250
 251         /**
 252          * Get the HTML link to the diff.
 253          * Overridden by RevDelArchiveItem
 254          * @return string
 255          */
 256         protected function getDiffLink() {
 257                 if ( $this->isDeleted() && !$this->canViewContent() ) {
 258                         return $this->list->msg( 'diff' )->escaped();
 259                 } else {
 260                         return Linker::linkKnown(
 261                                         $this->list->title,
 262                                         $this->list->msg( 'diff' )->escaped(),
 263                                         array(),
 264                                         array(
 265                                                 'diff' => $this->revision->getId(),
 266                                                 'oldid' => 'prev',
 267                                                 'unhide' => 1
 268                                         )
 269                                 );
 270                 }
 271         }
 272
 273         public function getHTML() {
 274                 $difflink = $this->list->msg( 'parentheses' )
 275                         ->rawParams( $this->getDiffLink() )->escaped();
 276                 $revlink = $this->getRevisionLink();
 277                 $userlink = Linker::revUserLink( $this->revision );
 278                 $comment = Linker::revComment( $this->revision );
 279                 if ( $this->isDeleted() ) {
 280                         $revlink = "<span class=\"history-deleted\">$revlink</span>";
 281                 }
 282                 return "<li>$difflink $revlink $userlink $comment</li>";
 283         }
 284
 285         public function getApiData( ApiResult $result ) {
 286                 $rev = $this->revision;
 287                 $user = $this->list->getUser();
 288                 $ret = array(
 289                         'id' => $rev->getId(),
 290                         'timestamp' => wfTimestamp( TS_ISO_8601, $rev->getTimestamp() ),
 291                 );
 292                 $ret += $rev->isDeleted( Revision::DELETED_USER ) ? array( 'userhidden' => '' ) : array();
 293                 $ret += $rev->isDeleted( Revision::DELETED_COMMENT ) ? array( 'commenthidden' => '' ) : array();
 294                 $ret += $rev->isDeleted( Revision::DELETED_TEXT ) ? array( 'texthidden' => '' ) : array();
 295                 if ( $rev->userCan( Revision::DELETED_USER, $user ) ) {
 296                         $ret += array(
 297                                 'userid' => $rev->getUser( Revision::FOR_THIS_USER ),
 298                                 'user' => $rev->getUserText( Revision::FOR_THIS_USER ),
 299                         );
 300                 }
 301                 if ( $rev->userCan( Revision::DELETED_COMMENT, $user ) ) {
 302                         $ret += array(
 303                                 'comment' => $rev->getComment( Revision::FOR_THIS_USER ),
 304                         );
 305                 }
 306                 return $ret;
 307         }
 308 }
 309
 310 /**
 311  * List for archive table items, i.e. revisions deleted via action=delete
 312  */
 313 class RevDelArchiveList extends RevDelRevisionList {
 314         public function getType() {
 315                 return 'archive';
 316         }
 317
 318         public static function getRelationType() {
 319                 return 'ar_timestamp';
 320         }
 321
 322         /**
 323          * @param DatabaseBase $db
 324          * @return mixed
 325          */
 326         public function doQuery( $db ) {
 327                 $timestamps = array();
 328                 foreach ( $this->ids as $id ) {
 329                         $timestamps[] = $db->timestamp( $id );
 330                 }
 331                 return $db->select( 'archive', Revision::selectArchiveFields(),
 332                                 array(
 333                                         'ar_namespace' => $this->title->getNamespace(),
 334                                         'ar_title' => $this->title->getDBkey(),
 335                                         'ar_timestamp' => $timestamps
 336                                 ),
 337                                 __METHOD__,
 338                                 array( 'ORDER BY' => 'ar_timestamp DESC' )
 339                         );
 340         }
 341
 342         public function newItem( $row ) {
 343                 return new RevDelArchiveItem( $this, $row );
 344         }
 345
 346         public function doPreCommitUpdates() {
 347                 return Status::newGood();
 348         }
 349
 350         public function doPostCommitUpdates() {
 351                 return Status::newGood();
 352         }
 353 }
 354
 355 /**
 356  * Item class for a archive table row
 357  */
 358 class RevDelArchiveItem extends RevDelRevisionItem {
 359         public function __construct( $list, $row ) {
 360                 RevDelItem::__construct( $list, $row );
 361                 $this->revision = Revision::newFromArchiveRow( $row,
 362                         array( 'page' => $this->list->title->getArticleID() ) );
 363         }
 364
 365         public function getIdField() {
 366                 return 'ar_timestamp';
 367         }
 368
 369         public function getTimestampField() {
 370                 return 'ar_timestamp';
 371         }
 372
 373         public function getAuthorIdField() {
 374                 return 'ar_user';
 375         }
 376
 377         public function getAuthorNameField() {
 378                 return 'ar_user_text';
 379         }
 380
 381         public function getId() {
 382                 # Convert DB timestamp to MW timestamp
 383                 return $this->revision->getTimestamp();
 384         }
 385
 386         public function setBits( $bits ) {
 387                 $dbw = wfGetDB( DB_MASTER );
 388                 $dbw->update( 'archive',
 389                         array( 'ar_deleted' => $bits ),
 390                         array(
 391                                 'ar_namespace' => $this->list->title->getNamespace(),
 392                                 'ar_title' => $this->list->title->getDBkey(),
 393                                 // use timestamp for index
 394                                 'ar_timestamp' => $this->row->ar_timestamp,
 395                                 'ar_rev_id' => $this->row->ar_rev_id,
 396                                 'ar_deleted' => $this->getBits()
 397                         ),
 398                         __METHOD__ );
 399                 return (bool)$dbw->affectedRows();
 400         }
 401
 402         protected function getRevisionLink() {
 403                 $date = htmlspecialchars( $this->list->getLanguage()->userTimeAndDate(
 404                         $this->revision->getTimestamp(), $this->list->getUser() ) );
 405
 406                 if ( $this->isDeleted() && !$this->canViewContent() ) {
 407                         return $date;
 408                 }
 409
 410                 return Linker::link(
 411                         SpecialPage::getTitleFor( 'Undelete' ),
 412                         $date,
 413                         array(),
 414                         array(
 415                                 'target' => $this->list->title->getPrefixedText(),
 416                                 'timestamp' => $this->revision->getTimestamp()
 417                         )
 418                 );
 419         }
 420
 421         protected function getDiffLink() {
 422                 if ( $this->isDeleted() && !$this->canViewContent() ) {
 423                         return $this->list->msg( 'diff' )->escaped();
 424                 }
 425
 426                 return Linker::link(
 427                         SpecialPage::getTitleFor( 'Undelete' ),
 428                         $this->list->msg( 'diff' )->escaped(),
 429                         array(),
 430                         array(
 431                                 'target' => $this->list->title->getPrefixedText(),
 432                                 'diff' => 'prev',
 433                                 'timestamp' => $this->revision->getTimestamp()
 434                         )
 435                 );
 436         }
 437 }
 438
 439 /**
 440  * Item class for a archive table row by ar_rev_id -- actually
 441  * used via RevDelRevisionList.
 442  */
 443 class RevDelArchivedRevisionItem extends RevDelArchiveItem {
 444         public function __construct( $list, $row ) {
 445                 RevDelItem::__construct( $list, $row );
 446
 447                 $this->revision = Revision::newFromArchiveRow( $row,
 448                         array( 'page' => $this->list->title->getArticleID() ) );
 449         }
 450
 451         public function getIdField() {
 452                 return 'ar_rev_id';
 453         }
 454
 455         public function getId() {
 456                 return $this->revision->getId();
 457         }
 458
 459         public function setBits( $bits ) {
 460                 $dbw = wfGetDB( DB_MASTER );
 461                 $dbw->update( 'archive',
 462                         array( 'ar_deleted' => $bits ),
 463                         array( 'ar_rev_id' => $this->row->ar_rev_id,
 464                                 'ar_deleted' => $this->getBits()
 465                         ),
 466                         __METHOD__ );
 467                 return (bool)$dbw->affectedRows();
 468         }
 469 }
 470
 471 /**
 472  * List for oldimage table items
 473  */
 474 class RevDelFileList extends RevDelList {
 475         /** @var array */
 476         var $storeBatch;
 477
 478         /** @var array */
 479         var $deleteBatch;
 480
 481         /** @var array */
 482         var $cleanupBatch;
 483
 484         public function getType() {
 485                 return 'oldimage';
 486         }
 487
 488         public static function getRelationType() {
 489                 return 'oi_archive_name';
 490         }
 491
 492         public static function getRestriction() {
 493                 return 'deleterevision';
 494         }
 495
 496         public static function getRevdelConstant() {
 497                 return File::DELETED_FILE;
 498         }
 499
 500         /**
 501          * @param DatabaseBase $db
 502          * @return mixed
 503          */
 504         public function doQuery( $db ) {
 505                 $archiveNames = array();
 506                 foreach ( $this->ids as $timestamp ) {
 507                         $archiveNames[] = $timestamp . '!' . $this->title->getDBkey();
 508                 }
 509                 return $db->select(
 510                         'oldimage',
 511                         OldLocalFile::selectFields(),
 512                         array(
 513                                 'oi_name' => $this->title->getDBkey(),
 514                                 'oi_archive_name' => $archiveNames
 515                         ),
 516                         __METHOD__,
 517                         array( 'ORDER BY' => 'oi_timestamp DESC' )
 518                 );
 519         }
 520
 521         public function newItem( $row ) {
 522                 return new RevDelFileItem( $this, $row );
 523         }
 524
 525         public function clearFileOps() {
 526                 $this->deleteBatch = array();
 527                 $this->storeBatch = array();
 528                 $this->cleanupBatch = array();
 529         }
 530
 531         public function doPreCommitUpdates() {
 532                 $status = Status::newGood();
 533                 $repo = RepoGroup::singleton()->getLocalRepo();
 534                 if ( $this->storeBatch ) {
 535                         $status->merge( $repo->storeBatch( $this->storeBatch, FileRepo::OVERWRITE_SAME ) );
 536                 }
 537                 if ( !$status->isOK() ) {
 538                         return $status;
 539                 }
 540                 if ( $this->deleteBatch ) {
 541                         $status->merge( $repo->deleteBatch( $this->deleteBatch ) );
 542                 }
 543                 if ( !$status->isOK() ) {
 544                         // Running cleanupDeletedBatch() after a failed storeBatch() with the DB already
 545                         // modified (but destined for rollback) causes data loss
 546                         return $status;
 547                 }
 548                 if ( $this->cleanupBatch ) {
 549                         $status->merge( $repo->cleanupDeletedBatch( $this->cleanupBatch ) );
 550                 }
 551                 return $status;
 552         }
 553
 554         public function doPostCommitUpdates() {
 555                 $file = wfLocalFile( $this->title );
 556                 $file->purgeCache();
 557                 $file->purgeDescription();
 558                 $purgeUrls = array();
 559                 foreach ( $this->ids as $timestamp ) {
 560                         $archiveName = $timestamp . '!' . $this->title->getDBkey();
 561                         $file->purgeOldThumbnails( $archiveName );
 562                         $purgeUrls[] = $file->getArchiveUrl( $archiveName );
 563                 }
 564                 if ( $this->getConfig()->get( 'UseSquid' ) ) {
 565                         // purge full images from cache
 566                         SquidUpdate::purge( $purgeUrls );
 567                 }
 568                 return Status::newGood();
 569         }
 570
 571         public function getSuppressBit() {
 572                 return File::DELETED_RESTRICTED;
 573         }
 574 }
 575
 576 /**
 577  * Item class for an oldimage table row
 578  */
 579 class RevDelFileItem extends RevDelItem {
 580         /** @var File */
 581         var $file;
 582
 583         public function __construct( $list, $row ) {
 584                 parent::__construct( $list, $row );
 585                 $this->file = RepoGroup::singleton()->getLocalRepo()->newFileFromRow( $row );
 586         }
 587
 588         public function getIdField() {
 589                 return 'oi_archive_name';
 590         }
 591
 592         public function getTimestampField() {
 593                 return 'oi_timestamp';
 594         }
 595
 596         public function getAuthorIdField() {
 597                 return 'oi_user';
 598         }
 599
 600         public function getAuthorNameField() {
 601                 return 'oi_user_text';
 602         }
 603
 604         public function getId() {
 605                 $parts = explode( '!', $this->row->oi_archive_name );
 606                 return $parts[0];
 607         }
 608
 609         public function canView() {
 610                 return $this->file->userCan( File::DELETED_RESTRICTED, $this->list->getUser() );
 611         }
 612
 613         public function canViewContent() {
 614                 return $this->file->userCan( File::DELETED_FILE, $this->list->getUser() );
 615         }
 616
 617         public function getBits() {
 618                 return $this->file->getVisibility();
 619         }
 620
 621         public function setBits( $bits ) {
 622                 # Queue the file op
 623                 # @todo FIXME: Move to LocalFile.php
 624                 if ( $this->isDeleted() ) {
 625                         if ( $bits & File::DELETED_FILE ) {
 626                                 # Still deleted
 627                         } else {
 628                                 # Newly undeleted
 629                                 $key = $this->file->getStorageKey();
 630                                 $srcRel = $this->file->repo->getDeletedHashPath( $key ) . $key;
 631                                 $this->list->storeBatch[] = array(
 632                                         $this->file->repo->getVirtualUrl( 'deleted' ) . '/' . $srcRel,
 633                                         'public',
 634                                         $this->file->getRel()
 635                                 );
 636                                 $this->list->cleanupBatch[] = $key;
 637                         }
 638                 } elseif ( $bits & File::DELETED_FILE ) {
 639                         # Newly deleted
 640                         $key = $this->file->getStorageKey();
 641                         $dstRel = $this->file->repo->getDeletedHashPath( $key ) . $key;
 642                         $this->list->deleteBatch[] = array( $this->file->getRel(), $dstRel );
 643                 }
 644
 645                 # Do the database operations
 646                 $dbw = wfGetDB( DB_MASTER );
 647                 $dbw->update( 'oldimage',
 648                         array( 'oi_deleted' => $bits ),
 649                         array(
 650                                 'oi_name' => $this->row->oi_name,
 651                                 'oi_timestamp' => $this->row->oi_timestamp,
 652                                 'oi_deleted' => $this->getBits()
 653                         ),
 654                         __METHOD__
 655                 );
 656                 return (bool)$dbw->affectedRows();
 657         }
 658
 659         public function isDeleted() {
 660                 return $this->file->isDeleted( File::DELETED_FILE );
 661         }
 662
 663         /**
 664          * Get the link to the file.
 665          * Overridden by RevDelArchivedFileItem.
 666          * @return string
 667          */
 668         protected function getLink() {
 669                 $date = htmlspecialchars( $this->list->getLanguage()->userTimeAndDate(
 670                         $this->file->getTimestamp(), $this->list->getUser() ) );
 671
 672                 if ( !$this->isDeleted() ) {
 673                         # Regular files...
 674                         return Html::rawElement( 'a', array( 'href' => $this->file->getUrl() ), $date );
 675                 }
 676
 677                 # Hidden files...
 678                 if ( !$this->canViewContent() ) {
 679                         $link = $date;
 680                 } else {
 681                         $link = Linker::link(
 682                                 SpecialPage::getTitleFor( 'Revisiondelete' ),
 683                                 $date,
 684                                 array(),
 685                                 array(
 686                                         'target' => $this->list->title->getPrefixedText(),
 687                                         'file' => $this->file->getArchiveName(),
 688                                         'token' => $this->list->getUser()->getEditToken(
 689                                                 $this->file->getArchiveName() )
 690                                 )
 691                         );
 692                 }
 693                 return '<span class="history-deleted">' . $link . '</span>';
 694         }
 695
 696         /**
 697          * Generate a user tool link cluster if the current user is allowed to view it
 698          * @return string HTML
 699          */
 700         protected function getUserTools() {
 701                 if ( $this->file->userCan( Revision::DELETED_USER, $this->list->getUser() ) ) {
 702                         $uid = $this->file->getUser( 'id' );
 703                         $name = $this->file->getUser( 'text' );
 704                         $link = Linker::userLink( $uid, $name ) . Linker::userToolLinks( $uid, $name );
 705                 } else {
 706                         $link = $this->list->msg( 'rev-deleted-user' )->escaped();
 707                 }
 708                 if ( $this->file->isDeleted( Revision::DELETED_USER ) ) {
 709                         return '<span class="history-deleted">' . $link . '</span>';
 710                 }
 711                 return $link;
 712         }
 713
 714         /**
 715          * Wrap and format the file's comment block, if the current
 716          * user is allowed to view it.
 717          *
 718          * @return string HTML
 719          */
 720         protected function getComment() {
 721                 if ( $this->file->userCan( File::DELETED_COMMENT, $this->list->getUser() ) ) {
 722                         $block = Linker::commentBlock( $this->file->getDescription() );
 723                 } else {
 724                         $block = ' ' . $this->list->msg( 'rev-deleted-comment' )->escaped();
 725                 }
 726                 if ( $this->file->isDeleted( File::DELETED_COMMENT ) ) {
 727                         return "<span class=\"history-deleted\">$block</span>";
 728                 }
 729                 return $block;
 730         }
 731
 732         public function getHTML() {
 733                 $data =
 734                         $this->list->msg( 'widthheight' )->numParams(
 735                                 $this->file->getWidth(), $this->file->getHeight() )->text() .
 736                         ' (' . $this->list->msg( 'nbytes' )->numParams( $this->file->getSize() )->text() . ')';
 737
 738                 return '<li>' . $this->getLink() . ' ' . $this->getUserTools() . ' ' .
 739                         $data . ' ' . $this->getComment() . '</li>';
 740         }
 741
 742         public function getApiData( ApiResult $result ) {
 743                 $file = $this->file;
 744                 $user = $this->list->getUser();
 745                 $ret = array(
 746                         'title' => $this->list->title->getPrefixedText(),
 747                         'archivename' => $file->getArchiveName(),
 748                         'timestamp' => wfTimestamp( TS_ISO_8601, $file->getTimestamp() ),
 749                         'width' => $file->getWidth(),
 750                         'height' => $file->getHeight(),
 751                         'size' => $file->getSize(),
 752                 );
 753                 $ret += $file->isDeleted( Revision::DELETED_USER ) ? array( 'userhidden' => '' ) : array();
 754                 $ret += $file->isDeleted( Revision::DELETED_COMMENT ) ? array( 'commenthidden' => '' ) : array();
 755                 $ret += $this->isDeleted() ? array( 'contenthidden' => '' ) : array();
 756                 if ( !$this->isDeleted() ) {
 757                         $ret += array(
 758                                 'url' => $file->getUrl(),
 759                         );
 760                 } elseif ( $this->canViewContent() ) {
 761                         $ret += array(
 762                                 'url' => SpecialPage::getTitleFor( 'Revisiondelete' )->getLinkURL(
 763                                         array(
 764                                                 'target' => $this->list->title->getPrefixedText(),
 765                                                 'file' => $file->getArchiveName(),
 766                                                 'token' => $user->getEditToken( $file->getArchiveName() )
 767                                         ),
 768                                         false, PROTO_RELATIVE
 769                                 ),
 770                         );
 771                 }
 772                 if ( $file->userCan( Revision::DELETED_USER, $user ) ) {
 773                         $ret += array(
 774                                 'userid' => $file->user,
 775                                 'user' => $file->user_text,
 776                         );
 777                 }
 778                 if ( $file->userCan( Revision::DELETED_COMMENT, $user ) ) {
 779                         $ret += array(
 780                                 'comment' => $file->description,
 781                         );
 782                 }
 783                 return $ret;
 784         }
 785 }
 786
 787 /**
 788  * List for filearchive table items
 789  */
 790 class RevDelArchivedFileList extends RevDelFileList {
 791         public function getType() {
 792                 return 'filearchive';
 793         }
 794
 795         public static function getRelationType() {
 796                 return 'fa_id';
 797         }
 798
 799         /**
 800          * @param DatabaseBase $db
 801          * @return mixed
 802          */
 803         public function doQuery( $db ) {
 804                 $ids = array_map( 'intval', $this->ids );
 805                 return $db->select(
 806                         'filearchive',
 807                         ArchivedFile::selectFields(),
 808                         array(
 809                                 'fa_name' => $this->title->getDBkey(),
 810                                 'fa_id' => $ids
 811                         ),
 812                         __METHOD__,
 813                         array( 'ORDER BY' => 'fa_id DESC' )
 814                 );
 815         }
 816
 817         public function newItem( $row ) {
 818                 return new RevDelArchivedFileItem( $this, $row );
 819         }
 820 }
 821
 822 /**
 823  * Item class for a filearchive table row
 824  */
 825 class RevDelArchivedFileItem extends RevDelFileItem {
 826         public function __construct( $list, $row ) {
 827                 RevDelItem::__construct( $list, $row );
 828                 $this->file = ArchivedFile::newFromRow( $row );
 829         }
 830
 831         public function getIdField() {
 832                 return 'fa_id';
 833         }
 834
 835         public function getTimestampField() {
 836                 return 'fa_timestamp';
 837         }
 838
 839         public function getAuthorIdField() {
 840                 return 'fa_user';
 841         }
 842
 843         public function getAuthorNameField() {
 844                 return 'fa_user_text';
 845         }
 846
 847         public function getId() {
 848                 return $this->row->fa_id;
 849         }
 850
 851         public function setBits( $bits ) {
 852                 $dbw = wfGetDB( DB_MASTER );
 853                 $dbw->update( 'filearchive',
 854                         array( 'fa_deleted' => $bits ),
 855                         array(
 856                                 'fa_id' => $this->row->fa_id,
 857                                 'fa_deleted' => $this->getBits(),
 858                         ),
 859                         __METHOD__
 860                 );
 861                 return (bool)$dbw->affectedRows();
 862         }
 863
 864         protected function getLink() {
 865                 $date = htmlspecialchars( $this->list->getLanguage()->userTimeAndDate(
 866                         $this->file->getTimestamp(), $this->list->getUser() ) );
 867
 868                 # Hidden files...
 869                 if ( !$this->canViewContent() ) {
 870                         $link = $date;
 871                 } else {
 872                         $undelete = SpecialPage::getTitleFor( 'Undelete' );
 873                         $key = $this->file->getKey();
 874                         $link = Linker::link( $undelete, $date, array(),
 875                                 array(
 876                                         'target' => $this->list->title->getPrefixedText(),
 877                                         'file' => $key,
 878                                         'token' => $this->list->getUser()->getEditToken( $key )
 879                                 )
 880                         );
 881                 }
 882                 if ( $this->isDeleted() ) {
 883                         $link = '<span class="history-deleted">' . $link . '</span>';
 884                 }
 885                 return $link;
 886         }
 887
 888         public function getApiData( ApiResult $result ) {
 889                 $file = $this->file;
 890                 $user = $this->list->getUser();
 891                 $ret = array(
 892                         'title' => $this->list->title->getPrefixedText(),
 893                         'timestamp' => wfTimestamp( TS_ISO_8601, $file->getTimestamp() ),
 894                         'width' => $file->getWidth(),
 895                         'height' => $file->getHeight(),
 896                         'size' => $file->getSize(),
 897                 );
 898                 $ret += $file->isDeleted( Revision::DELETED_USER ) ? array( 'userhidden' => '' ) : array();
 899                 $ret += $file->isDeleted( Revision::DELETED_COMMENT ) ? array( 'commenthidden' => '' ) : array();
 900                 $ret += $this->isDeleted() ? array( 'contenthidden' => '' ) : array();
 901                 if ( $this->canViewContent() ) {
 902                         $ret += array(
 903                                 'url' => SpecialPage::getTitleFor( 'Revisiondelete' )->getLinkURL(
 904                                         array(
 905                                                 'target' => $this->list->title->getPrefixedText(),
 906                                                 'file' => $file->getKey(),
 907                                                 'token' => $user->getEditToken( $file->getKey() )
 908                                         ),
 909                                         false, PROTO_RELATIVE
 910                                 ),
 911                         );
 912                 }
 913                 if ( $file->userCan( Revision::DELETED_USER, $user ) ) {
 914                         $ret += array(
 915                                 'userid' => $file->getUser( 'id' ),
 916                                 'user' => $file->getUser( 'text' ),
 917                         );
 918                 }
 919                 if ( $file->userCan( Revision::DELETED_COMMENT, $user ) ) {
 920                         $ret += array(
 921                                 'comment' => $file->getRawDescription(),
 922                         );
 923                 }
 924                 return $ret;
 925         }
 926 }
 927
 928 /**
 929  * List for logging table items
 930  */
 931 class RevDelLogList extends RevDelList {
 932         public function getType() {
 933                 return 'logging';
 934         }
 935
 936         public static function getRelationType() {
 937                 return 'log_id';
 938         }
 939
 940         public static function getRestriction() {
 941                 return 'deletelogentry';
 942         }
 943
 944         public static function getRevdelConstant() {
 945                 return LogPage::DELETED_ACTION;
 946         }
 947
 948         public static function suggestTarget( $target, array $ids ) {
 949                 $result = wfGetDB( DB_SLAVE )->select( 'logging',
 950                         'log_type',
 951                         array( 'log_id' => $ids ),
 952                         __METHOD__,
 953                         array( 'DISTINCT' )
 954                 );
 955                 if ( $result->numRows() == 1 ) {
 956                         // If there's only one type, the target can be set to include it.
 957                         return SpecialPage::getTitleFor( 'Log', $result->current()->log_type );
 958                 }
 959                 return SpecialPage::getTitleFor( 'Log' );
 960         }
 961
 962         /**
 963          * @param DatabaseBase $db
 964          * @return mixed
 965          */
 966         public function doQuery( $db ) {
 967                 $ids = array_map( 'intval', $this->ids );
 968                 return $db->select( 'logging', array(
 969                                 'log_id',
 970                                 'log_type',
 971                                 'log_action',
 972                                 'log_timestamp',
 973                                 'log_user',
 974                                 'log_user_text',
 975                                 'log_namespace',
 976                                 'log_title',
 977                                 'log_page',
 978                                 'log_comment',
 979                                 'log_params',
 980                                 'log_deleted'
 981                         ),
 982                         array( 'log_id' => $ids ),
 983                         __METHOD__,
 984                         array( 'ORDER BY' => 'log_id DESC' )
 985                 );
 986         }
 987
 988         public function newItem( $row ) {
 989                 return new RevDelLogItem( $this, $row );
 990         }
 991
 992         public function getSuppressBit() {
 993                 return Revision::DELETED_RESTRICTED;
 994         }
 995
 996         public function getLogAction() {
 997                 return 'event';
 998         }
 999
1000         public function getLogParams( $params ) {
1001                 return array(
1002                         implode( ',', $params['ids'] ),
1003                         "ofield={$params['oldBits']}",
1004                         "nfield={$params['newBits']}"
1005                 );
1006         }
1007 }
1008
1009 /**
1010  * Item class for a logging table row
1011  */
1012 class RevDelLogItem extends RevDelItem {
1013         public function getIdField() {
1014                 return 'log_id';
1015         }
1016
1017         public function getTimestampField() {
1018                 return 'log_timestamp';
1019         }
1020
1021         public function getAuthorIdField() {
1022                 return 'log_user';
1023         }
1024
1025         public function getAuthorNameField() {
1026                 return 'log_user_text';
1027         }
1028
1029         public function canView() {
1030                 return LogEventsList::userCan( $this->row, Revision::DELETED_RESTRICTED, $this->list->getUser() );
1031         }
1032
1033         public function canViewContent() {
1034                 return true; // none
1035         }
1036
1037         public function getBits() {
1038                 return $this->row->log_deleted;
1039         }
1040
1041         public function setBits( $bits ) {
1042                 $dbw = wfGetDB( DB_MASTER );
1043                 $dbw->update( 'recentchanges',
1044                         array(
1045                                 'rc_deleted' => $bits,
1046                                 'rc_patrolled' => 1
1047                         ),
1048                         array(
1049                                 'rc_logid' => $this->row->log_id,
1050                                 'rc_timestamp' => $this->row->log_timestamp // index
1051                         ),
1052                         __METHOD__
1053                 );
1054                 $dbw->update( 'logging',
1055                         array( 'log_deleted' => $bits ),
1056                         array(
1057                                 'log_id' => $this->row->log_id,
1058                                 'log_deleted' => $this->getBits()
1059                         ),
1060                         __METHOD__
1061                 );
1062                 return (bool)$dbw->affectedRows();
1063         }
1064
1065         public function getHTML() {
1066                 $date = htmlspecialchars( $this->list->getLanguage()->userTimeAndDate(
1067                         $this->row->log_timestamp, $this->list->getUser() ) );
1068                 $title = Title::makeTitle( $this->row->log_namespace, $this->row->log_title );
1069                 $formatter = LogFormatter::newFromRow( $this->row );
1070                 $formatter->setContext( $this->list->getContext() );
1071                 $formatter->setAudience( LogFormatter::FOR_THIS_USER );
1072
1073                 // Log link for this page
1074                 $loglink = Linker::link(
1075                         SpecialPage::getTitleFor( 'Log' ),
1076                         $this->list->msg( 'log' )->escaped(),
1077                         array(),
1078                         array( 'page' => $title->getPrefixedText() )
1079                 );
1080                 $loglink = $this->list->msg( 'parentheses' )->rawParams( $loglink )->escaped();
1081                 // User links and action text
1082                 $action = $formatter->getActionText();
1083                 // Comment
1084                 $comment = $this->list->getLanguage()->getDirMark()
1085                         . Linker::commentBlock( $this->row->log_comment );
1086
1087                 if ( LogEventsList::isDeleted( $this->row, LogPage::DELETED_COMMENT ) ) {
1088                         $comment = '<span class="history-deleted">' . $comment . '</span>';
1089                 }
1090
1091                 return "<li>$loglink $date $action $comment</li>";
1092         }
1093
1094         public function getApiData( ApiResult $result ) {
1095                 $logEntry = DatabaseLogEntry::newFromRow( $this->row );
1096                 $user = $this->list->getUser();
1097                 $ret = array(
1098                         'id' => $logEntry->getId(),
1099                         'type' => $logEntry->getType(),
1100                         'action' => $logEntry->getSubtype(),
1101                 );
1102                 $ret += $logEntry->isDeleted( LogPage::DELETED_USER )
1103                         ? array( 'userhidden' => '' )
1104                         : array();
1105                 $ret += $logEntry->isDeleted( LogPage::DELETED_COMMENT )
1106                         ? array( 'commenthidden' => '' )
1107                         : array();
1108                 $ret += $logEntry->isDeleted( LogPage::DELETED_ACTION )
1109                         ? array( 'actionhidden' => '' )
1110                         : array();
1111
1112                 if ( LogEventsList::userCan( $this->row, LogPage::DELETED_ACTION, $user ) ) {
1113                         ApiQueryLogEvents::addLogParams(
1114                                 $result,
1115                                 $ret,
1116                                 $logEntry->getParameters(),
1117                                 $logEntry->getType(),
1118                                 $logEntry->getSubtype(),
1119                                 $logEntry->getTimestamp(),
1120                                 $logEntry->isLegacy()
1121                         );
1122                 }
1123                 if ( LogEventsList::userCan( $this->row, LogPage::DELETED_USER, $user ) ) {
1124                         $ret += array(
1125                                 'userid' => $this->row->log_user,
1126                                 'user' => $this->row->log_user_text,
1127                         );
1128                 }
1129                 if ( LogEventsList::userCan( $this->row, LogPage::DELETED_COMMENT, $user ) ) {
1130                         $ret += array(
1131                                 'comment' => $this->row->log_comment,
1132                         );
1133                 }
1134                 return $ret;
1135         }
1136 }