includes/revisiondelete/RevDelRevisionItem.php

   1 <?php
   2 /**
   3  * This program is free software; you can redistribute it and/or modify
   4  * it under the terms of the GNU General Public License as published by
   5  * the Free Software Foundation; either version 2 of the License, or
   6  * (at your option) any later version.
   7  *
   8  * This program is distributed in the hope that it will be useful,
   9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  11  * GNU General Public License for more details.
  12  *
  13  * You should have received a copy of the GNU General Public License along
  14  * with this program; if not, write to the Free Software Foundation, Inc.,
  15  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  16  * http://www.gnu.org/copyleft/gpl.html
  17  *
  18  * @file
  19  * @ingroup RevisionDelete
  20  */
  21
  22 /**
  23  * Item class for a live revision table row
  24  */
  25 class RevDelRevisionItem extends RevDelItem {
  26         /** @var Revision */
  27         public $revision;
  28
  29         public function __construct( $list, $row ) {
  30                 parent::__construct( $list, $row );
  31                 $this->revision = static::initRevision( $list, $row );
  32         }
  33
  34         /**
  35          * Create revision object from $row sourced from $list
  36          *
  37          * @param RevisionListBase $list
  38          * @param mixed $row
  39          * @return Revision
  40          */
  41         protected static function initRevision( $list, $row ) {
  42                 return new Revision( $row );
  43         }
  44
  45         public function getIdField() {
  46                 return 'rev_id';
  47         }
  48
  49         public function getTimestampField() {
  50                 return 'rev_timestamp';
  51         }
  52
  53         public function getAuthorIdField() {
  54                 return 'rev_user';
  55         }
  56
  57         public function getAuthorNameField() {
  58                 return 'rev_user_text';
  59         }
  60
  61         public function getAuthorActorField() {
  62                 return 'rev_actor';
  63         }
  64
  65         public function canView() {
  66                 return $this->revision->userCan( Revision::DELETED_RESTRICTED, $this->list->getUser() );
  67         }
  68
  69         public function canViewContent() {
  70                 return $this->revision->userCan( Revision::DELETED_TEXT, $this->list->getUser() );
  71         }
  72
  73         public function getBits() {
  74                 return $this->revision->getVisibility();
  75         }
  76
  77         public function setBits( $bits ) {
  78                 $dbw = wfGetDB( DB_MASTER );
  79                 // Update revision table
  80                 $dbw->update( 'revision',
  81                         [ 'rev_deleted' => $bits ],
  82                         [
  83                                 'rev_id' => $this->revision->getId(),
  84                                 'rev_page' => $this->revision->getPage(),
  85                                 'rev_deleted' => $this->getBits() // cas
  86                         ],
  87                         __METHOD__
  88                 );
  89                 if ( !$dbw->affectedRows() ) {
  90                         // Concurrent fail!
  91                         return false;
  92                 }
  93                 // Update recentchanges table
  94                 $dbw->update( 'recentchanges',
  95                         [
  96                                 'rc_deleted' => $bits,
  97                                 'rc_patrolled' => RecentChange::PRC_PATROLLED
  98                         ],
  99                         [
 100                                 'rc_this_oldid' => $this->revision->getId(), // condition
 101                                 // non-unique timestamp index
 102                                 'rc_timestamp' => $dbw->timestamp( $this->revision->getTimestamp() ),
 103                         ],
 104                         __METHOD__
 105                 );
 106
 107                 return true;
 108         }
 109
 110         public function isDeleted() {
 111                 return $this->revision->isDeleted( Revision::DELETED_TEXT );
 112         }
 113
 114         public function isHideCurrentOp( $newBits ) {
 115                 return ( $newBits & Revision::DELETED_TEXT )
 116                         && $this->list->getCurrent() == $this->getId();
 117         }
 118
 119         /**
 120          * Get the HTML link to the revision text.
 121          * Overridden by RevDelArchiveItem.
 122          * @return string
 123          */
 124         protected function getRevisionLink() {
 125                 $date = $this->list->getLanguage()->userTimeAndDate(
 126                         $this->revision->getTimestamp(), $this->list->getUser() );
 127
 128                 if ( $this->isDeleted() && !$this->canViewContent() ) {
 129                         return htmlspecialchars( $date );
 130                 }
 131
 132                 return $this->getLinkRenderer()->makeKnownLink(
 133                         $this->list->title,
 134                         $date,
 135                         [],
 136                         [
 137                                 'oldid' => $this->revision->getId(),
 138                                 'unhide' => 1
 139                         ]
 140                 );
 141         }
 142
 143         /**
 144          * Get the HTML link to the diff.
 145          * Overridden by RevDelArchiveItem
 146          * @return string
 147          */
 148         protected function getDiffLink() {
 149                 if ( $this->isDeleted() && !$this->canViewContent() ) {
 150                         return $this->list->msg( 'diff' )->escaped();
 151                 } else {
 152                         return $this->getLinkRenderer()->makeKnownLink(
 153                                         $this->list->title,
 154                                         $this->list->msg( 'diff' )->text(),
 155                                         [],
 156                                         [
 157                                                 'diff' => $this->revision->getId(),
 158                                                 'oldid' => 'prev',
 159                                                 'unhide' => 1
 160                                         ]
 161                                 );
 162                 }
 163         }
 164
 165         /**
 166          * @return string A HTML <li> element representing this revision, showing
 167          * change tags and everything
 168          */
 169         public function getHTML() {
 170                 $difflink = $this->list->msg( 'parentheses' )
 171                         ->rawParams( $this->getDiffLink() )->escaped();
 172                 $revlink = $this->getRevisionLink();
 173                 $userlink = Linker::revUserLink( $this->revision );
 174                 $comment = Linker::revComment( $this->revision );
 175                 if ( $this->isDeleted() ) {
 176                         $revlink = "<span class=\"history-deleted\">$revlink</span>";
 177                 }
 178                 $content = "$difflink $revlink $userlink $comment";
 179                 $attribs = [];
 180                 $tags = $this->getTags();
 181                 if ( $tags ) {
 182                         list( $tagSummary, $classes ) = ChangeTags::formatSummaryRow(
 183                                 $tags,
 184                                 'revisiondelete',
 185                                 $this->list->getContext()
 186                         );
 187                         $content .= " $tagSummary";
 188                         $attribs['class'] = implode( ' ', $classes );
 189                 }
 190                 return Xml::tags( 'li', $attribs, $content );
 191         }
 192
 193         /**
 194          * @return string Comma-separated list of tags
 195          */
 196         public function getTags() {
 197                 return $this->row->ts_tags;
 198         }
 199
 200         public function getApiData( ApiResult $result ) {
 201                 $rev = $this->revision;
 202                 $user = $this->list->getUser();
 203                 $ret = [
 204                         'id' => $rev->getId(),
 205                         'timestamp' => wfTimestamp( TS_ISO_8601, $rev->getTimestamp() ),
 206                         'userhidden' => (bool)$rev->isDeleted( Revision::DELETED_USER ),
 207                         'commenthidden' => (bool)$rev->isDeleted( Revision::DELETED_COMMENT ),
 208                         'texthidden' => (bool)$rev->isDeleted( Revision::DELETED_TEXT ),
 209                 ];
 210                 if ( $rev->userCan( Revision::DELETED_USER, $user ) ) {
 211                         $ret += [
 212                                 'userid' => $rev->getUser( Revision::FOR_THIS_USER ),
 213                                 'user' => $rev->getUserText( Revision::FOR_THIS_USER ),
 214                         ];
 215                 }
 216                 if ( $rev->userCan( Revision::DELETED_COMMENT, $user ) ) {
 217                         $ret += [
 218                                 'comment' => $rev->getComment( Revision::FOR_THIS_USER ),
 219                         ];
 220                 }
 221
 222                 return $ret;
 223         }
 224 }