includes/editpage/TextConflictHelper.php

   1 <?php
   2 /**
   3  * Helper for displaying edit conflicts to users
   4  *
   5  * Copyright (C) 2017 Kunal Mehta <legoktm@member.fsf.org>
   6  *
   7  * This program is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation; either version 2 of the License, or
  10  * (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License along
  18  * with this program; if not, write to the Free Software Foundation, Inc.,
  19  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  20  * http://www.gnu.org/copyleft/gpl.html
  21  *
  22  * @file
  23  */
  24
  25 namespace MediaWiki\EditPage;
  26
  27 use Content;
  28 use ContentHandler;
  29 use Html;
  30 use IBufferingStatsdDataFactory;
  31 use OutputPage;
  32 use Title;
  33
  34 /**
  35  * Helper for displaying edit conflicts in text content
  36  * models to users
  37  *
  38  * @since 1.31
  39  */
  40 class TextConflictHelper {
  41
  42         /**
  43          * @var Title
  44          */
  45         protected $title;
  46
  47         /**
  48          * @var null|string
  49          */
  50         public $contentModel = null;
  51
  52         /**
  53          * @var null|string
  54          */
  55         public $contentFormat = null;
  56
  57         /**
  58          * @var OutputPage
  59          */
  60         protected $out;
  61
  62         /**
  63          * @var IBufferingStatsdDataFactory
  64          */
  65         protected $stats;
  66
  67         /**
  68          * @var string Message key for submit button's label
  69          */
  70         protected $submitLabel;
  71
  72         /**
  73          * @var string
  74          */
  75         protected $yourtext = '';
  76
  77         /**
  78          * @var string
  79          */
  80         protected $storedversion = '';
  81
  82         /**
  83          * @param Title $title
  84          * @param OutputPage $out
  85          * @param IBufferingStatsdDataFactory $stats
  86          * @param string $submitLabel
  87          */
  88         public function __construct( Title $title, OutputPage $out, IBufferingStatsdDataFactory $stats,
  89                 $submitLabel
  90         ) {
  91                 $this->title = $title;
  92                 $this->out = $out;
  93                 $this->stats = $stats;
  94                 $this->submitLabel = $submitLabel;
  95                 $this->contentModel = $title->getContentModel();
  96                 $this->contentFormat = ContentHandler::getForModelID( $this->contentModel )->getDefaultFormat();
  97         }
  98
  99         /**
 100          * @param string $yourtext
 101          * @param string $storedversion
 102          */
 103         public function setTextboxes( $yourtext, $storedversion ) {
 104                 $this->yourtext = $yourtext;
 105                 $this->storedversion = $storedversion;
 106         }
 107
 108         /**
 109          * @param string $contentModel
 110          */
 111         public function setContentModel( $contentModel ) {
 112                 $this->contentModel = $contentModel;
 113         }
 114
 115         /**
 116          * @param string $contentFormat
 117          */
 118         public function setContentFormat( $contentFormat ) {
 119                 $this->contentFormat = $contentFormat;
 120         }
 121
 122         /**
 123          * Record a user encountering an edit conflict
 124          */
 125         public function incrementConflictStats() {
 126                 $this->stats->increment( 'edit.failures.conflict' );
 127                 // Only include 'standard' namespaces to avoid creating unknown numbers of statsd metrics
 128                 if (
 129                         $this->title->getNamespace() >= NS_MAIN &&
 130                         $this->title->getNamespace() <= NS_CATEGORY_TALK
 131                 ) {
 132                         $this->stats->increment(
 133                                 'edit.failures.conflict.byNamespaceId.' . $this->title->getNamespace()
 134                         );
 135                 }
 136         }
 137
 138         /**
 139          * Record when a user has resolved an edit conflict
 140          */
 141         public function incrementResolvedStats() {
 142                 $this->stats->increment( 'edit.failures.conflict.resolved' );
 143         }
 144
 145         /**
 146          * @return string HTML
 147          */
 148         public function getExplainHeader() {
 149                 return Html::rawElement(
 150                         'div',
 151                         [ 'class' => 'mw-explainconflict' ],
 152                         $this->out->msg( 'explainconflict', $this->out->msg( $this->submitLabel )->text() )->parse()
 153                 );
 154         }
 155
 156         /**
 157          * Content to go in the edit form before textbox1
 158          *
 159          * @see EditPage::$editFormTextBeforeContent
 160          * @return string HTML
 161          */
 162         public function getEditFormHtmlBeforeContent() {
 163                 return '';
 164         }
 165
 166         /**
 167          * Content to go in the edit form after textbox1
 168          *
 169          * @see EditPage::$editFormTextAfterContent
 170          * @return string HTML
 171          */
 172         public function getEditFormHtmlAfterContent() {
 173                 return '';
 174         }
 175
 176         /**
 177          * Content to go in the edit form after the footers
 178          * (templates on this page, hidden categories, limit report)
 179          */
 180         public function showEditFormTextAfterFooters() {
 181                 $this->out->wrapWikiMsg( '<h2>$1</h2>', "yourdiff" );
 182
 183                 $yourContent = $this->toEditContent( $this->yourtext );
 184                 $storedContent = $this->toEditContent( $this->storedversion );
 185                 $handler = ContentHandler::getForModelID( $this->contentModel );
 186                 $diffEngine = $handler->createDifferenceEngine( $this->out );
 187
 188                 $diffEngine->setContent( $yourContent, $storedContent );
 189                 $diffEngine->showDiff(
 190                         $this->out->msg( 'yourtext' )->parse(),
 191                         $this->out->msg( 'storedversion' )->text()
 192                 );
 193
 194                 $this->out->wrapWikiMsg( '<h2>$1</h2>', "yourtext" );
 195
 196                 $builder = new TextboxBuilder();
 197                 $attribs = $builder->buildTextboxAttribs(
 198                         'wpTextbox2',
 199                         [ 'tabindex' => 6, 'readonly' ],
 200                         $this->out->getUser(),
 201                         $this->title
 202                 );
 203
 204                 $this->out->addHTML(
 205                         Html::textarea( 'wpTextbox2', $builder->addNewLineAtEnd( $this->yourtext ), $attribs )
 206                 );
 207         }
 208
 209         /**
 210          * @param string $text
 211          * @return Content
 212          */
 213         public function toEditContent( $text ) {
 214                 return ContentHandler::makeContent(
 215                         $text,
 216                         $this->title,
 217                         $this->contentModel,
 218                         $this->contentFormat
 219                 );
 220         }
 221 }