3 * Helper for displaying edit conflicts to users
5 * Copyright (C) 2017 Kunal Mehta <legoktm@member.fsf.org>
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.
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.
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
25 namespace MediaWiki\EditPage
;
30 use IBufferingStatsdDataFactory
;
35 * Helper for displaying edit conflicts in text content
40 class TextConflictHelper
{
50 public $contentModel = null;
55 public $contentFormat = null;
63 * @var IBufferingStatsdDataFactory
68 * @var string Message key for submit button's label
70 protected $submitLabel;
75 protected $yourtext = '';
80 protected $storedversion = '';
84 * @param OutputPage $out
85 * @param IBufferingStatsdDataFactory $stats
86 * @param string $submitLabel
88 public function __construct( Title
$title, OutputPage
$out, IBufferingStatsdDataFactory
$stats,
91 $this->title
= $title;
93 $this->stats
= $stats;
94 $this->submitLabel
= $submitLabel;
95 $this->contentModel
= $title->getContentModel();
96 $this->contentFormat
= ContentHandler
::getForModelID( $this->contentModel
)->getDefaultFormat();
100 * @param string $yourtext
101 * @param string $storedversion
103 public function setTextboxes( $yourtext, $storedversion ) {
104 $this->yourtext
= $yourtext;
105 $this->storedversion
= $storedversion;
109 * @param string $contentModel
111 public function setContentModel( $contentModel ) {
112 $this->contentModel
= $contentModel;
116 * @param string $contentFormat
118 public function setContentFormat( $contentFormat ) {
119 $this->contentFormat
= $contentFormat;
123 * Record a user encountering an edit conflict
125 public function incrementConflictStats() {
126 $this->stats
->increment( 'edit.failures.conflict' );
127 // Only include 'standard' namespaces to avoid creating unknown numbers of statsd metrics
129 $this->title
->getNamespace() >= NS_MAIN
&&
130 $this->title
->getNamespace() <= NS_CATEGORY_TALK
132 $this->stats
->increment(
133 'edit.failures.conflict.byNamespaceId.' . $this->title
->getNamespace()
139 * Record when a user has resolved an edit conflict
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
145 $this->title
->getNamespace() >= NS_MAIN
&&
146 $this->title
->getNamespace() <= NS_CATEGORY_TALK
148 $this->stats
->increment(
149 'edit.failures.conflict.resolved.byNamespaceId.' . $this->title
->getNamespace()
155 * @return string HTML
157 public function getExplainHeader() {
158 return Html
::rawElement(
160 [ 'class' => 'mw-explainconflict' ],
161 $this->out
->msg( 'explainconflict', $this->out
->msg( $this->submitLabel
)->text() )->parse()
166 * Content to go in the edit form before textbox1
168 * @see EditPage::$editFormTextBeforeContent
169 * @return string HTML
171 public function getEditFormHtmlBeforeContent() {
176 * Content to go in the edit form after textbox1
178 * @see EditPage::$editFormTextAfterContent
179 * @return string HTML
181 public function getEditFormHtmlAfterContent() {
186 * Content to go in the edit form after the footers
187 * (templates on this page, hidden categories, limit report)
189 public function showEditFormTextAfterFooters() {
190 $this->out
->wrapWikiMsg( '<h2>$1</h2>', "yourdiff" );
192 $yourContent = $this->toEditContent( $this->yourtext
);
193 $storedContent = $this->toEditContent( $this->storedversion
);
194 $handler = ContentHandler
::getForModelID( $this->contentModel
);
195 $diffEngine = $handler->createDifferenceEngine( $this->out
);
197 $diffEngine->setContent( $yourContent, $storedContent );
198 $diffEngine->showDiff(
199 $this->out
->msg( 'yourtext' )->parse(),
200 $this->out
->msg( 'storedversion' )->text()
203 $this->out
->wrapWikiMsg( '<h2>$1</h2>', "yourtext" );
205 $builder = new TextboxBuilder();
206 $attribs = $builder->buildTextboxAttribs(
208 [ 'tabindex' => 6, 'readonly' ],
209 $this->out
->getUser(),
214 Html
::textarea( 'wpTextbox2', $builder->addNewLineAtEnd( $this->yourtext
), $attribs )
219 * @param string $text
222 public function toEditContent( $text ) {
223 return ContentHandler
::makeContent(