e8632ab0f6
This introduces PageUpdater to replace WikiPage::doEditContent, and DerivedPageDataUpdater, to replace WikiPage::doEditUpdates and WikiPage::prepareContentForEdit. See docs/pageupdater.txt for a description of their functionality. MCR migration notes: * The interface of PageUpdater is expected to remain mostly stable after this patch. Code that has been using WikiPage::doEditContent can be confidently migrated to using the new mechanism for revision creation. * This patch keeps the code inside PageUpdater largely aligned with the old code in WikiPage, to make review easier to to avoid mistakes. It is intended to be refactored further, moving application logic into stateless services. * DerivedPageDataUpdate is intended as a stepping stone for further refactoring. Its behavior is designed to be compatible with callback code that currently relies on WikiPage::prepareContentForEdit. Much of the code that currently lives in DerivedPageDataUpdate should be factored out into services, all behavior relevant to calling code should be exposed via narrow interfaces. Bug: T174038 Bug: T196653 Change-Id: If610c68f4912e89af616cdcac1d35a1be3946afa
92 lines
1.7 KiB
PHP
92 lines
1.7 KiB
PHP
<?php
|
|
/**
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
* http://www.gnu.org/copyleft/gpl.html
|
|
*
|
|
* @file
|
|
*/
|
|
|
|
namespace MediaWiki\Edit;
|
|
|
|
use Content;
|
|
use ParserOptions;
|
|
use ParserOutput;
|
|
|
|
/**
|
|
* Represents information returned by WikiPage::prepareContentForEdit()
|
|
*
|
|
* @deprecated since 1.32, use DerivedPageDataUpdater instead.
|
|
*
|
|
* @since 1.30
|
|
*/
|
|
class PreparedEdit {
|
|
|
|
/**
|
|
* Time this prepared edit was made
|
|
*
|
|
* @var string
|
|
*/
|
|
public $timestamp;
|
|
|
|
/**
|
|
* Revision ID
|
|
*
|
|
* @var int|null
|
|
*/
|
|
public $revid;
|
|
|
|
/**
|
|
* Content after going through pre-save transform
|
|
*
|
|
* @var Content|null
|
|
*/
|
|
public $pstContent;
|
|
|
|
/**
|
|
* Content format
|
|
*
|
|
* @var string
|
|
*/
|
|
public $format;
|
|
|
|
/**
|
|
* Parser options used to get parser output
|
|
*
|
|
* @var ParserOptions
|
|
*/
|
|
public $popts;
|
|
|
|
/**
|
|
* Parser output
|
|
*
|
|
* @var ParserOutput|null
|
|
*/
|
|
public $output;
|
|
|
|
/**
|
|
* Content that is being saved (before PST)
|
|
*
|
|
* @var Content
|
|
*/
|
|
public $newContent;
|
|
|
|
/**
|
|
* Current content of the page, if any
|
|
*
|
|
* @var Content|null
|
|
*/
|
|
public $oldContent;
|
|
|
|
}
|