2 namespace TYPO3\CMS\Extbase\Utility;
88 public static function translate($key, $extensionName, $arguments = null)
92 $value = self::translateFileReference($key);
94 self::initializeLocalization($extensionName);
96 if (!empty(self::$LOCAL_LANG[$extensionName][self::$languageKey][$key][0][
'target'])
97 || isset(self::$LOCAL_LANG_UNSET[$extensionName][self::$languageKey][$key])
100 $value = self::$LOCAL_LANG[$extensionName][self::$languageKey][$key][0][
'target'];
101 if (!empty(self::$LOCAL_LANG_charset[$extensionName][self::$languageKey][$key])) {
102 $value = self::convertCharset($value, self::$LOCAL_LANG_charset[$extensionName][self::$languageKey][$key]);
104 }
elseif (!empty(self::$alternativeLanguageKeys)) {
105 $languages = array_reverse(self::$alternativeLanguageKeys);
106 foreach ($languages as $language) {
107 if (!empty(self::$LOCAL_LANG[$extensionName][$language][$key][0][
'target'])
108 || isset(self::$LOCAL_LANG_UNSET[$extensionName][$language][$key])
111 $value = self::$LOCAL_LANG[$extensionName][$language][$key][0][
'target'];
112 if (!empty(self::$LOCAL_LANG_charset[$extensionName][$language][$key])) {
113 $value = self::convertCharset($value, self::$LOCAL_LANG_charset[$extensionName][$language][$key]);
119 if ($value === null && (!empty(self::$LOCAL_LANG[$extensionName][
'default'][$key][0][
'target'])
120 || isset(self::$LOCAL_LANG_UNSET[$extensionName][
'default'][$key]))
124 $value = self::$LOCAL_LANG[$extensionName][
'default'][$key][0][
'target'];
127 if (is_array($arguments) && $value !== null) {
128 return vsprintf($value, $arguments);
144 if (TYPO3_MODE ===
'FE') {
145 $value = self::getTypoScriptFrontendController()->sL($key);
146 return $value !==
false ? $value : null;
148 $value = self::getLanguageService()->sL($key);
149 return $value !==
'' ? $value : null;
162 protected static function initializeLocalization($extensionName)
164 if (isset(self::$LOCAL_LANG[$extensionName])) {
168 self::setLanguageKeys();
169 $renderCharset = TYPO3_MODE ===
'FE' ? self::getTypoScriptFrontendController()->renderCharset : self::getLanguageService()->charSet;
174 self::$LOCAL_LANG[$extensionName] = $languageFactory->getParsedData($locallangPathAndFilename, self::$languageKey, $renderCharset);
175 foreach (self::$alternativeLanguageKeys as $language) {
176 $tempLL = $languageFactory->getParsedData($locallangPathAndFilename, $language, $renderCharset);
177 if (self::$languageKey !==
'default' && isset($tempLL[$language])) {
178 self::$LOCAL_LANG[$extensionName][$language] = $tempLL[$language];
181 self::loadTypoScriptLabels($extensionName);
190 protected static function setLanguageKeys()
192 self::$languageKey =
'default';
193 self::$alternativeLanguageKeys = array();
194 if (TYPO3_MODE ===
'FE') {
195 if (isset(self::getTypoScriptFrontendController()->config[
'config'][
'language'])) {
196 self::$languageKey = self::getTypoScriptFrontendController()->config[
'config'][
'language'];
197 if (isset(self::getTypoScriptFrontendController()->config[
'config'][
'language_alt'])) {
198 self::$alternativeLanguageKeys[] = self::getTypoScriptFrontendController()->config[
'config'][
'language_alt'];
202 if (in_array(self::$languageKey,
$locales->getLocales())) {
203 foreach (
$locales->getLocaleDependencies(self::$languageKey) as $language) {
204 self::$alternativeLanguageKeys[] = $language;
210 self::$languageKey =
$GLOBALS[
'BE_USER']->uc[
'lang'];
211 }
elseif (!empty(self::getLanguageService()->lang)) {
212 self::$languageKey = self::getLanguageService()->lang;
228 if (!is_array($frameworkConfiguration[
'_LOCAL_LANG'])) {
231 self::$LOCAL_LANG_UNSET[$extensionName] = array();
232 foreach ($frameworkConfiguration[
'_LOCAL_LANG'] as
$languageKey => $labels) {
233 if (!(is_array($labels) && isset(self::$LOCAL_LANG[$extensionName][
$languageKey]))) {
236 foreach ($labels as $labelKey => $labelValue) {
237 if (is_string($labelValue)) {
238 self::$LOCAL_LANG[$extensionName][
$languageKey][$labelKey][0][
'target'] = $labelValue;
239 if ($labelValue ===
'') {
240 self::$LOCAL_LANG_UNSET[$extensionName][
$languageKey][$labelKey] =
'';
243 self::$LOCAL_LANG_charset[$extensionName][
$languageKey][$labelKey] = self::getLanguageService()->csConvObj->charSetArray[
$languageKey];
245 self::$LOCAL_LANG_charset[$extensionName][
$languageKey][$labelKey] = self::getTypoScriptFrontendController()->csConvObj->charSetArray[
$languageKey];
247 }
elseif (is_array($labelValue)) {
248 $labelValue = self::flattenTypoScriptLabelArray($labelValue, $labelKey);
249 foreach ($labelValue as $key => $value) {
250 self::$LOCAL_LANG[$extensionName][
$languageKey][$key][0][
'target'] = $value;
252 self::$LOCAL_LANG_UNSET[$extensionName][
$languageKey][$key] =
'';
274 foreach ($labelValues as $key => $labelValue) {
275 if (!empty($parentKey)) {
276 $key = $parentKey .
'.' . $key;
278 if (is_array($labelValue)) {
279 $labelValue = self::flattenTypoScriptLabelArray($labelValue, $key);
280 $result = array_merge($result, $labelValue);
282 $result[$key] = $labelValue;
298 if (TYPO3_MODE ===
'FE') {
299 return self::getTypoScriptFrontendController()->csConv($value, $charset);
301 $convertedValue = self::getLanguageService()->csConvObj->conv($value, self::getLanguageService()->csConvObj->parse_charset($charset), self::getLanguageService()->charSet, 1);
302 return $convertedValue !== null ? $convertedValue : $value;
313 if (!is_null(static::$configurationManager)) {
314 return static::$configurationManager;