MediaWiki REL1_37
TrivialLanguageConverter.php
Go to the documentation of this file.
1<?php
23
38
42 protected $language;
43
48
57 public function __construct( $langobj ) {
58 $this->language = $langobj;
59 $this->titleFormatter = MediaWikiServices::getInstance()->getTitleFormatter();
60 }
61
62 public function autoConvert( $text, $variant = false ) {
63 return $text;
64 }
65
66 public function autoConvertToAllVariants( $text ) {
67 return [ $this->language->getCode() => $text ];
68 }
69
70 public function convert( $t ) {
71 return $t;
72 }
73
74 public function convertTo( $text, $variant ) {
75 return $text;
76 }
77
82 public function convertTitle( $title ) {
83 return $this->titleFormatter->getPrefixedText( $title );
84 }
85
86 public function convertNamespace( $index, $variant = null ) {
87 return $this->language->getFormattedNsText( $index );
88 }
89
93 public function getVariants() {
94 return [ $this->language->getCode() ];
95 }
96
97 public function getVariantFallbacks( $variant ) {
98 return $this->language->getCode();
99 }
100
101 public function getPreferredVariant() {
102 return $this->language->getCode();
103 }
104
105 public function getDefaultVariant() {
106 return $this->language->getCode();
107 }
108
109 public function getURLVariant() {
110 return '';
111 }
112
113 public function getConvRuleTitle() {
114 return false;
115 }
116
117 public function findVariantLink( &$l, &$n, $ignoreOtherCond = false ) {
118 }
119
120 public function getExtraHashOptions() {
121 return '';
122 }
123
124 public function guessVariant( $text, $variant ) {
125 return false;
126 }
127
128 public function markNoConversion( $text, $noParse = false ) {
129 return $text;
130 }
131
132 public function convertCategoryKey( $key ) {
133 return $key;
134 }
135
136 public function validateVariant( $variant = null ) {
137 if ( $variant === null ) {
138 return null;
139 }
140 $variant = strtolower( $variant );
141 return $variant === $this->language->getCode() ? $variant : null;
142 }
143
144 public function translate( $text, $variant ) {
145 return $text;
146 }
147
148 public function updateConversionTable( LinkTarget $linkTarget ) {
149 }
150
156 private function reloadTables() {
157 }
158
166 public function hasVariants() {
167 return count( $this->getVariants() ) > 1;
168 }
169
180 public function hasVariant( $variant ) {
181 return $variant && ( $variant === $this->validateVariant( $variant ) );
182 }
183
192 public function convertHtml( $text ) {
193 return htmlspecialchars( $this->convert( $text ) );
194 }
195}
196
200class_alias( TrivialLanguageConverter::class, 'FakeConverter' );
Internationalisation code See https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation for more...
Definition Language.php:42
MediaWikiServices is the service locator for the application scope of MediaWiki.
A trivial language converter.
convertHtml( $text)
Perform output conversion on a string, and encode for safe HTML output.
translate( $text, $variant)
Translate a string to a variant.
hasVariants()
Check if this is a language with variants.
convert( $t)
Convert text to different variants of a language.
getURLVariant()
Get the variant specified in the URL.
getPreferredVariant()
Get preferred language variant.
__construct( $langobj)
Creates a converter for languages that don't have variants.
markNoConversion( $text, $noParse=false)
Enclose a string with the "no conversion" tag.
autoConvertToAllVariants( $text)
Call translate() to convert text to all valid variants.
getConvRuleTitle()
Get the title produced by the conversion rule.
getDefaultVariant()
This function would not be affected by user's settings.
findVariantLink(&$l, &$n, $ignoreOtherCond=false)
If a language supports multiple variants, it is possible that non-existing link in one variant actual...
autoConvert( $text, $variant=false)
Dictionary-based conversion.
convertTo( $text, $variant)
Same as convert() except a extra parameter to custom variant.
getExtraHashOptions()
Returns language specific hash options.
guessVariant( $text, $variant)
Guess if a text is written in a variant.
reloadTables()
Used by test suites which need to reset the converter state.
updateConversionTable(LinkTarget $linkTarget)
Refresh the cache of conversion tables when MediaWiki:Conversiontable* is updated.
validateVariant( $variant=null)
Validate the variant and return an appropriate strict internal variant code if one exists.
convertCategoryKey( $key)
Convert the sorting key for category links.
convertNamespace( $index, $variant=null)
Get the namespace display name in the preferred variant.
hasVariant( $variant)
Strict check if the language has the specific variant.
getVariantFallbacks( $variant)
In case some variant is not defined in the markup, we need to have some fallback.
The shared interface for all language converters.
Interface for objects (potentially) representing a page that can be viewable and linked to on a wiki.
A title formatter service for MediaWiki.