1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
<?php
/**
* Base content handler class for flat text contents.
*
* 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
*
* @since 1.36 (As UnknownContentHandler in 1.34)
*
* @file
* @ingroup Content
*/
namespace MediaWiki\Content;
use MediaWiki\Content\Renderer\ContentParseParams;
use MediaWiki\Context\IContextSource;
use MediaWiki\Html\Html;
use MediaWiki\Parser\ParserOutput;
use SlotDiffRenderer;
use UnsupportedSlotDiffRenderer;
/**
* Content handler implementation for unknown content.
*
* This can be used to handle content for which no ContentHandler exists on the system,
* perhaps because the extension that provided it has been removed.
*
* @ingroup Content
*/
class FallbackContentHandler extends ContentHandler {
/**
* Constructs an FallbackContentHandler. Since FallbackContentHandler can be registered
* for multiple model IDs on a system, multiple instances of FallbackContentHandler may
* coexist.
*
* To preserve the serialization format of the original content model, it must be supplied
* to the constructor via the $formats parameter. If not given, the default format is
* reported as 'application/octet-stream'.
*
* @param string $modelId
* @param string[]|null $formats
*/
public function __construct( $modelId, $formats = null ) {
parent::__construct(
$modelId,
$formats ?? [
'application/octet-stream',
'application/unknown',
'application/x-binary',
'text/unknown',
'unknown/unknown',
]
);
}
/**
* Returns the content's data as-is.
*
* @param Content $content
* @param string|null $format The serialization format to check
*
* @return mixed
*/
public function serializeContent( Content $content, $format = null ) {
/** @var FallbackContent $content */
'@phan-var FallbackContent $content';
return $content->getData();
}
/**
* Constructs an FallbackContent instance wrapping the given data.
*
* @since 1.21
*
* @param string $blob serialized content in an unknown format
* @param string|null $format ignored
*
* @return Content The FallbackContent object wrapping $data
*/
public function unserializeContent( $blob, $format = null ) {
return new FallbackContent( $blob, $this->getModelID() );
}
/**
* Creates an empty FallbackContent object.
*
* @since 1.21
*
* @return Content A new FallbackContent object with empty text.
*/
public function makeEmptyContent() {
return $this->unserializeContent( '' );
}
/**
* @return false
*/
public function supportsDirectEditing() {
return false;
}
/**
* Fills the ParserOutput with an error message.
* @since 1.38
* @param Content $content
* @param ContentParseParams $cpoParams
* @param ParserOutput &$output The output object to fill (reference).
*
*/
protected function fillParserOutput(
Content $content,
ContentParseParams $cpoParams,
ParserOutput &$output
) {
'@phan-var FallbackContent $content';
$msg = wfMessage( 'unsupported-content-model', [ $content->getModel() ] );
$html = Html::rawElement( 'div', [ 'class' => 'error' ], $msg->inContentLanguage()->parse() );
$output->setRawText( $html );
}
/**
* @param IContextSource $context
*
* @return SlotDiffRenderer
*/
protected function getSlotDiffRendererInternal( IContextSource $context ) {
return new UnsupportedSlotDiffRenderer( $context );
}
}
/** @deprecated class alias since 1.43 */
class_alias( FallbackContentHandler::class, 'FallbackContentHandler' );
|
