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                 // Only include 'standard' namespaces to avoid creating unknown numbers of statsd metrics
 144                 if (
 145                         $this->title->getNamespace() >= NS_MAIN &&
 146                         $this->title->getNamespace() <= NS_CATEGORY_TALK
 147                 ) {
 148                         $this->stats->increment(
 149                                 'edit.failures.conflict.resolved.byNamespaceId.' . $this->title->getNamespace()
 150                         );
 151                 }
 152         }
 153
 154         /**
 155          * @return string HTML
 156          */
 157         public function getExplainHeader() {
 158                 return Html::rawElement(
 159                         'div',
 160                         [ 'class' => 'mw-explainconflict' ],
 161                         $this->out->msg( 'explainconflict', $this->out->msg( $this->submitLabel )->text() )->parse()
 162                 );
 163         }
 164
 165         /**
 166          * HTML to build the textbox1 on edit conflicts
 167          *
 168          * @param array $customAttribs
 169          */
 170         public function getEditConflictMainTextBox( array $customAttribs = [] ) {
 171                 $builder = new TextboxBuilder();
 172                 $classes = $builder->getTextboxProtectionCSSClasses( $this->title );
 173
 174                 $attribs = [ 'tabindex' => 1 ];
 175                 $attribs += $customAttribs;
 176
 177                 $attribs = $builder->mergeClassesIntoAttributes( $classes, $attribs );
 178
 179                 $attribs = $builder->buildTextboxAttribs(
 180                         'wpTextbox1',
 181                         $attribs,
 182                         $this->out->getUser(),
 183                         $this->title
 184                 );
 185
 186                 $this->out->addHTML(
 187                         Html::textarea( 'wpTextbox1', $builder->addNewLineAtEnd( $this->storedversion ), $attribs )
 188                 );
 189         }
 190
 191         /**
 192          * Content to go in the edit form before textbox1
 193          *
 194          * @see EditPage::$editFormTextBeforeContent
 195          * @return string HTML
 196          */
 197         public function getEditFormHtmlBeforeContent() {
 198                 return '';
 199         }
 200
 201         /**
 202          * Content to go in the edit form after textbox1
 203          *
 204          * @see EditPage::$editFormTextAfterContent
 205          * @return string HTML
 206          */
 207         public function getEditFormHtmlAfterContent() {
 208                 return '';
 209         }
 210
 211         /**
 212          * Content to go in the edit form after the footers
 213          * (templates on this page, hidden categories, limit report)
 214          */
 215         public function showEditFormTextAfterFooters() {
 216                 $this->out->wrapWikiMsg( '<h2>$1</h2>', "yourdiff" );
 217
 218                 $yourContent = $this->toEditContent( $this->yourtext );
 219                 $storedContent = $this->toEditContent( $this->storedversion );
 220                 $handler = ContentHandler::getForModelID( $this->contentModel );
 221                 $diffEngine = $handler->createDifferenceEngine( $this->out );
 222
 223                 $diffEngine->setContent( $yourContent, $storedContent );
 224                 $diffEngine->showDiff(
 225                         $this->out->msg( 'yourtext' )->parse(),
 226                         $this->out->msg( 'storedversion' )->text()
 227                 );
 228
 229                 $this->out->wrapWikiMsg( '<h2>$1</h2>', "yourtext" );
 230
 231                 $builder = new TextboxBuilder();
 232                 $attribs = $builder->buildTextboxAttribs(
 233                         'wpTextbox2',
 234                         [ 'tabindex' => 6, 'readonly' ],
 235                         $this->out->getUser(),
 236                         $this->title
 237                 );
 238
 239                 $this->out->addHTML(
 240                         Html::textarea( 'wpTextbox2', $builder->addNewLineAtEnd( $this->yourtext ), $attribs )
 241                 );
 242         }
 243
 244         /**
 245          * @param string $text
 246          * @return Content
 247          */
 248         public function toEditContent( $text ) {
 249                 return ContentHandler::makeContent(
 250                         $text,
 251                         $this->title,
 252                         $this->contentModel,
 253                         $this->contentFormat
 254                 );
 255         }
 256 }