includes/revisiondelete/RevisionDeleter.php

   1 <?php
   2 /**
   3  * Revision/log/file deletion backend
   4  *
   5  * @file
   6  */
   7
   8 /**
   9  * Temporary b/c interface, collection of static functions.
  10  * @ingroup SpecialPage
  11  */
  12 class RevisionDeleter {
  13         /**
  14          * Checks for a change in the bitfield for a certain option and updates the
  15          * provided array accordingly.
  16          *
  17          * @param $desc String: description to add to the array if the option was
  18          * enabled / disabled.
  19          * @param $field Integer: the bitmask describing the single option.
  20          * @param $diff Integer: the xor of the old and new bitfields.
  21          * @param $new Integer: the new bitfield
  22          * @param $arr Array: the array to update.
  23          */
  24         protected static function checkItem( $desc, $field, $diff, $new, &$arr ) {
  25                 if( $diff & $field ) {
  26                         $arr[ ( $new & $field ) ? 0 : 1 ][] = $desc;
  27                 }
  28         }
  29
  30         /**
  31          * Gets an array of message keys describing the changes made to the visibility
  32          * of the revision. If the resulting array is $arr, then $arr[0] will contain an
  33          * array of strings describing the items that were hidden, $arr[2] will contain
  34          * an array of strings describing the items that were unhidden, and $arr[3] will
  35          * contain an array with a single string, which can be one of "applied
  36          * restrictions to sysops", "removed restrictions from sysops", or null.
  37          *
  38          * @param $n Integer: the new bitfield.
  39          * @param $o Integer: the old bitfield.
  40          * @return An array as described above.
  41          */
  42         protected static function getChanges( $n, $o ) {
  43                 $diff = $n ^ $o;
  44                 $ret = array( 0 => array(), 1 => array(), 2 => array() );
  45                 // Build bitfield changes in language
  46                 self::checkItem( 'revdelete-content',
  47                         Revision::DELETED_TEXT, $diff, $n, $ret );
  48                 self::checkItem( 'revdelete-summary',
  49                         Revision::DELETED_COMMENT, $diff, $n, $ret );
  50                 self::checkItem( 'revdelete-uname',
  51                         Revision::DELETED_USER, $diff, $n, $ret );
  52                 // Restriction application to sysops
  53                 if( $diff & Revision::DELETED_RESTRICTED ) {
  54                         if( $n & Revision::DELETED_RESTRICTED )
  55                                 $ret[2][] = 'revdelete-restricted';
  56                         else
  57                                 $ret[2][] = 'revdelete-unrestricted';
  58                 }
  59                 return $ret;
  60         }
  61
  62         /**
  63          * Gets a log message to describe the given revision visibility change. This
  64          * message will be of the form "[hid {content, edit summary, username}];
  65          * [unhid {...}][applied restrictions to sysops] for $count revisions: $comment".
  66          *
  67          * @param $count Integer: The number of effected revisions.
  68          * @param $nbitfield Integer: The new bitfield for the revision.
  69          * @param $obitfield Integer: The old bitfield for the revision.
  70          * @param $isForLog Boolean
  71          * @param $forContent Boolean
  72          */
  73         public static function getLogMessage( $count, $nbitfield, $obitfield, $isForLog = false, $forContent = false ) {
  74                 global $wgLang, $wgContLang;
  75
  76                 $lang = $forContent ? $wgContLang : $wgLang;
  77                 $msgFunc = $forContent ? "wfMsgForContent" : "wfMsg";
  78
  79                 $changes = self::getChanges( $nbitfield, $obitfield );
  80                 array_walk( $changes, array( __CLASS__, 'expandMessageArray' ), $forContent );
  81
  82                 $changesText = array();
  83
  84                 if( count( $changes[0] ) ) {
  85                         $changesText[] = $msgFunc( 'revdelete-hid', $lang->commaList( $changes[0] ) );
  86                 }
  87                 if( count( $changes[1] ) ) {
  88                         $changesText[] = $msgFunc( 'revdelete-unhid', $lang->commaList( $changes[1] ) );
  89                 }
  90
  91                 $s = $lang->semicolonList( $changesText );
  92                 if( count( $changes[2] ) ) {
  93                         $s .= $s ? ' (' . $changes[2][0] . ')' : ' ' . $changes[2][0];
  94                 }
  95
  96                 $msg = $isForLog ? 'logdelete-log-message' : 'revdelete-log-message';
  97                 return wfMsgExt( $msg, $forContent ? array( 'parsemag', 'content' ) : array( 'parsemag' ), $s, $lang->formatNum($count) );
  98         }
  99
 100         private static function expandMessageArray(& $msg, $key, $forContent) {
 101                 if ( is_array ( $msg ) ) {
 102                         array_walk( $msg, array( __CLASS__, 'expandMessageArray' ), $forContent );
 103                 } else {
 104                         if ( $forContent ) {
 105                                 $msg = wfMsgForContent($msg);
 106                         } else {
 107                                 $msg = wfMsg($msg);
 108                         }
 109                 }
 110         }
 111
 112         // Get DB field name for URL param...
 113         // Future code for other things may also track
 114         // other types of revision-specific changes.
 115         // @returns string One of log_id/rev_id/fa_id/ar_timestamp/oi_archive_name
 116         public static function getRelationType( $typeName ) {
 117                 if ( isset( SpecialRevisionDelete::$deprecatedTypeMap[$typeName] ) ) {
 118                         $typeName = SpecialRevisionDelete::$deprecatedTypeMap[$typeName];
 119                 }
 120                 if ( isset( SpecialRevisionDelete::$allowedTypes[$typeName] ) ) {
 121                         $class = SpecialRevisionDelete::$allowedTypes[$typeName]['list-class'];
 122                         $list = new $class( null, null, null );
 123                         return $list->getIdField();
 124                 } else {
 125                         return null;
 126                 }
 127         }
 128
 129         /**
 130          * Checks if a revision still exists in the revision table.
 131          * If it doesn't, returns the corresponding ar_timestamp field
 132          * so that this key can be used instead.
 133          *
 134          * @static
 135          * @param $title Title
 136          * @param  $revid
 137          * @return bool|mixed
 138          */
 139         public static function checkRevisionExistence( $title, $revid ) {
 140                 $dbr = wfGetDB( DB_SLAVE );
 141                 $exists = $dbr->selectField( 'revision', '1',
 142                                 array( 'rev_id' => $revid ), __METHOD__ );
 143
 144                 if ( $exists ) {
 145                         return true;
 146                 }
 147
 148                 $timestamp = $dbr->selectField( 'archive', 'ar_timestamp',
 149                                 array( 'ar_namespace' => $title->getNamespace(),
 150                                         'ar_title' => $title->getDBkey(),
 151                                         'ar_rev_id' => $revid ), __METHOD__ );
 152
 153                 return $timestamp;
 154         }
 155
 156         /**
 157          * Creates utility links for log entries.
 158          *
 159          * @static
 160          * @param $title Title
 161          * @param $paramArray Array
 162          * @param $skin Skin
 163          * @param $messages
 164          * @return String
 165          */
 166         public static function getLogLinks( $title, $paramArray, $skin, $messages ) {
 167                 global $wgLang;
 168
 169                 if( count($paramArray) >= 2 ) {
 170                         // Different revision types use different URL params...
 171                         $originalKey = $key = $paramArray[0];
 172                         // $paramArray[1] is a CSV of the IDs
 173                         $Ids = explode( ',', $paramArray[1] );
 174
 175                         $revert = array();
 176
 177                         // For if undeleted revisions are found amidst deleted ones.
 178                         $undeletedRevisions = array();
 179
 180                         // This is not going to work if some revs are deleted and some
 181                         //  aren't.
 182                         if ($key == 'revision') {
 183                                 foreach( $Ids as $k => $id ) {
 184                                         $existResult =
 185                                                 self::checkRevisionExistence( $title, $id );
 186
 187                                         if ($existResult !== true) {
 188                                                 $key = 'archive';
 189                                                 $Ids[$k] = $existResult;
 190                                         } else {
 191                                                 // Undeleted revision amidst deleted ones
 192                                                 unset($Ids[$k]);
 193                                                 $undeletedRevisions[] = $id;
 194                                         }
 195                                 }
 196
 197                                 if ( $key == $originalKey ) {
 198                                         $Ids = $undeletedRevisions;
 199                                         $undeletedRevisions = array();
 200                                 }
 201                         }
 202
 203                         // Diff link for single rev deletions
 204                         if( count($Ids) == 1 && !count($undeletedRevisions) ) {
 205                                 // Live revision diffs...
 206                                 if( in_array( $key, array( 'oldid', 'revision' ) ) ) {
 207                                         $revert[] = $skin->link(
 208                                                 $title,
 209                                                 $messages['diff'],
 210                                                 array(),
 211                                                 array(
 212                                                         'diff' => intval( $Ids[0] ),
 213                                                         'unhide' => 1
 214                                                 ),
 215                                                 array( 'known', 'noclasses' )
 216                                         );
 217                                 // Deleted revision diffs...
 218                                 } else if( in_array( $key, array( 'artimestamp','archive' ) ) ) {
 219                                         $revert[] = $skin->link(
 220                                                 SpecialPage::getTitleFor( 'Undelete' ),
 221                                                 $messages['diff'],
 222                                                 array(),
 223                                                 array(
 224                                                         'target'    => $title->getPrefixedDBKey(),
 225                                                         'diff'      => 'prev',
 226                                                         'timestamp' => $Ids[0]
 227                                                 ),
 228                                                 array( 'known', 'noclasses' )
 229                                         );
 230                                 }
 231                         }
 232
 233                         // View/modify link...
 234                         if ( count( $undeletedRevisions ) ) {
 235                                 // FIXME THIS IS A HORRIBLE HORRIBLE HACK AND SHOULD DIE
 236                                 // It's not possible to pass a list of both deleted and
 237                                 // undeleted revisions to SpecialRevisionDelete, so we're
 238                                 // stuck with two links. See bug 23363.
 239                                 $restoreLinks = array();
 240
 241                                 $restoreLinks[] = $skin->link(
 242                                         SpecialPage::getTitleFor( 'Revisiondelete' ),
 243                                         $messages['revdel-restore-visible'],
 244                                         array(),
 245                                         array(
 246                                                 'target' => $title->getPrefixedText(),
 247                                                 'type' => $originalKey,
 248                                                 'ids' => implode( ',', $undeletedRevisions ),
 249                                         ),
 250                                         array( 'known', 'noclasses' )
 251                                 );
 252
 253                                 $restoreLinks[] = $skin->link(
 254                                         SpecialPage::getTitleFor( 'Revisiondelete' ),
 255                                         $messages['revdel-restore-deleted'],
 256                                         array(),
 257                                         array(
 258                                                 'target' => $title->getPrefixedText(),
 259                                                 'type' => $key,
 260                                                 'ids' => implode(',', $Ids),
 261                                         ),
 262                                         array( 'known', 'noclasses' )
 263                                 );
 264
 265                                 $revert[] = $messages['revdel-restore'] . ' [' .
 266                                                 $wgLang->pipeList( $restoreLinks ) . ']';
 267                         } else {
 268                                 $revert[] = $skin->link(
 269                                         SpecialPage::getTitleFor( 'Revisiondelete' ),
 270                                         $messages['revdel-restore'],
 271                                         array(),
 272                                         array(
 273                                                 'target' => $title->getPrefixedText(),
 274                                                 'type' => $key,
 275                                                 'ids' => implode(',', $Ids),
 276                                         ),
 277                                         array( 'known', 'noclasses' )
 278                                 );
 279                         }
 280
 281                         // Pipe links
 282                         return wfMsg( 'parentheses', $wgLang->pipeList( $revert ) );
 283                 }
 284                 return '';
 285         }
 286 }