Go to the documentation of this file.
55 if ( $text ===
null || $text ===
false ) {
56 wfWarn(
"TextContent constructed with \$text = " . var_export( $text,
true ) .
"! "
57 .
"This may indicate an error in the caller's scope.", 2 );
62 if ( !is_string( $text ) ) {
63 throw new MWException(
"TextContent expects a string in the constructor." );
75 return $this; # NOTE:
this is ok since
TextContent are immutable.
88 $truncatedtext = MediaWikiServices::getInstance()->getContentLanguage()->
89 truncateForDatabase( preg_replace(
"/[\n\r]/",
' ', $text ), max( 0, $maxlength ) );
91 return $truncatedtext;
104 return strlen( $text );
125 if ( $wgArticleCountMethod ===
'any' ) {
181 '@phan-var WikitextContent $wikitext';
184 return $wikitext->getText();
204 return str_replace( [
"\r\n",
"\r" ],
"\n", rtrim( $text ) );
225 return ( $text === $pst ) ? $this :
new static( $pst, $this->
getModel() );
244 '@phan-var self $that';
248 $lang = MediaWikiServices::getInstance()->getContentLanguage();
252 $ntext = $that->getText();
254 # Note: Use native PHP diff, external engines don't give us abstract output
255 $ota = explode(
"\n",
$lang->segmentForDiff( $otext ) );
256 $nta = explode(
"\n",
$lang->segmentForDiff( $ntext ) );
258 $diff =
new Diff( $ota, $nta );
287 if ( in_array( $this->
getModel(), $wgTextModelsToParse ) ) {
289 $output = MediaWikiServices::getInstance()->getParser()
290 ->parse( $this->
getText(), $title, $options,
true,
true, $revId );
293 if ( $generateHtml ) {
317 if ( method_exists( $this,
'getHighlightHtml' ) ) {
319 throw new Exception(
'getHighlightHtml() is not called any more!' );
321 return htmlspecialchars( $this->
getText() );
340 public function convert( $toModel, $lossy =
'' ) {
341 $converted = parent::convert( $toModel, $lossy );
343 if ( $converted !==
false ) {
352 $converted = $toHandler->unserializeContent( $text );
__construct( $text, $model_id=CONTENT_MODEL_TEXT)
Stable to call.
Set options of the Parser.
getTextForSearchIndex()
Returns the text represented by this Content object, as a string.
getWikitextForTransclusion()
Returns attempts to convert this content object to wikitext, and then returns the text string.
if(!isset( $args[0])) $lang
getContentHandlerFactory()
getHtml()
Generates an HTML version of the content, for display.
getText()
Returns the text represented by this Content object, as a string.
getTextForSummary( $maxlength=250)
Stable to override.
wfDeprecated( $function, $version=false, $component=false, $callerOffset=2)
Logs a warning that $function is deprecated.
preSaveTransform(Title $title, User $user, ParserOptions $popts)
Returns a Content object with pre-save transformations applied.
clearWrapperDivClass()
Clears the CSS class to use for the wrapping div, effectively disabling the wrapper div until addWrap...
getSize()
Returns the text's size in bytes.
Base implementation for content objects.
isCountable( $hasLinks=null)
Returns true if this content is not a redirect, and $wgArticleCountMethod is "any".
Base content handler implementation for flat text contents.
const CONTENT_MODEL_WIKITEXT
Content object implementation for representing flat text.
Base interface for content objects.
string $model_id
Name of the content model this Content object represents.
Represents a title within MediaWiki.
getModel()
Returns the ID of the content model used by this Content object.
static normalizeLineEndings( $text)
Do a "\\r\\n" -> "\\n" and "\\r" -> "\\n" transformation as well as trim trailing whitespace.
$wgTextModelsToParse
Determines which types of text are parsed as wikitext.
wfWarn( $msg, $callerOffset=1, $level=E_USER_NOTICE)
Send a warning either to the debug log or in a PHP error depending on $wgDevelopmentWarnings.
$wgArticleCountMethod
Method used to determine if a page in a content namespace should be counted as a valid article.
diff(Content $that, Language $lang=null)
Diff this content object with another content object.
The User object encapsulates all of the user-specific settings (user_id, name, rights,...
Internationalisation code See https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation for more...
fillParserOutput(Title $title, $revId, ParserOptions $options, $generateHtml, ParserOutput &$output)
Fills the provided ParserOutput object with information derived from the content.
convert( $toModel, $lossy='')
This implementation provides lossless conversion between content models based on TextContent.
getNativeData()
Returns the text represented by this Content object, as a string.
Class representing a 'diff' between two sequences of strings.