LocalizationUtility.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Extbase\Utility;

class LocalizationUtility {

    static protected $locallangPath = 'Resources/Private/Language/';

    static protected $LOCAL_LANG = array();

    static protected $LOCAL_LANG_UNSET = array();

    static protected $LOCAL_LANG_charset = array();

    static protected $languageKey = 'default';

    static protected $alternativeLanguageKeys = array();

    static protected $configurationManager = NULL;

    static public function translate($key, $extensionName, $arguments = NULL) {
        $value = NULL;
        if (\TYPO3\CMS\Core\Utility\GeneralUtility::isFirstPartOfStr($key, 'LLL:')) {
            $value = self::translateFileReference($key);
        } else {
            self::initializeLocalization($extensionName);
            // The "from" charset of csConv() is only set for strings from TypoScript via _LOCAL_LANG
            if (!empty(self::$LOCAL_LANG[$extensionName][self::$languageKey][$key][0]['target'])
                || isset(self::$LOCAL_LANG_UNSET[$extensionName][self::$languageKey][$key])
            ) {
                // Local language translation for key exists
                $value = self::$LOCAL_LANG[$extensionName][self::$languageKey][$key][0]['target'];
                if (!empty(self::$LOCAL_LANG_charset[$extensionName][self::$languageKey][$key])) {
                    $value = self::convertCharset($value, self::$LOCAL_LANG_charset[$extensionName][self::$languageKey][$key]);
                }
            } elseif (count(self::$alternativeLanguageKeys)) {
                $languages = array_reverse(self::$alternativeLanguageKeys);
                foreach ($languages as $language) {
                    if (!empty(self::$LOCAL_LANG[$extensionName][$language][$key][0]['target'])
                        || isset(self::$LOCAL_LANG_UNSET[$extensionName][$language][$key])
                    ) {
                        // Alternative language translation for key exists
                        $value = self::$LOCAL_LANG[$extensionName][$language][$key][0]['target'];
                        if (!empty(self::$LOCAL_LANG_charset[$extensionName][$language][$key])) {
                            $value = self::convertCharset($value, self::$LOCAL_LANG_charset[$extensionName][$language][$key]);
                        }
                        break;
                    }
                }
            }
            if ($value === NULL && (!empty(self::$LOCAL_LANG[$extensionName]['default'][$key][0]['target'])
                || isset(self::$LOCAL_LANG_UNSET[$extensionName]['default'][$key]))
            ) {
                // Default language translation for key exists
                // No charset conversion because default is English and thereby ASCII
                $value = self::$LOCAL_LANG[$extensionName]['default'][$key][0]['target'];
            }
        }
        if (is_array($arguments) && $value !== NULL) {
            return vsprintf($value, $arguments);
        } else {
            return $value;
        }
    }

    static protected function translateFileReference($key) {
        if (TYPO3_MODE === 'FE') {
            $value = $GLOBALS['TSFE']->sL($key);
            return $value !== FALSE ? $value : NULL;
        } elseif (is_object($GLOBALS['LANG'])) {
            $value = $GLOBALS['LANG']->sL($key);
            return $value !== '' ? $value : NULL;
        } else {
            return $key;
        }
    }

    static protected function initializeLocalization($extensionName) {
        if (isset(self::$LOCAL_LANG[$extensionName])) {
            return;
        }
        $locallangPathAndFilename = 'EXT:' . \TYPO3\CMS\Core\Utility\GeneralUtility::camelCaseToLowerCaseUnderscored($extensionName) . '/' . self::$locallangPath . 'locallang.xml';
        self::setLanguageKeys();
        $renderCharset = TYPO3_MODE === 'FE' ? $GLOBALS['TSFE']->renderCharset : $GLOBALS['LANG']->charSet;
        self::$LOCAL_LANG[$extensionName] = \TYPO3\CMS\Core\Utility\GeneralUtility::readLLfile($locallangPathAndFilename, self::$languageKey, $renderCharset);
        foreach (self::$alternativeLanguageKeys as $language) {
            $tempLL = \TYPO3\CMS\Core\Utility\GeneralUtility::readLLfile($locallangPathAndFilename, $language, $renderCharset);
            if (self::$languageKey !== 'default' && isset($tempLL[$language])) {
                self::$LOCAL_LANG[$extensionName][$language] = $tempLL[$language];
            }
        }
        self::loadTypoScriptLabels($extensionName);
    }

    static protected function setLanguageKeys() {
        self::$languageKey = 'default';
        self::$alternativeLanguageKeys = array();
        if (TYPO3_MODE === 'FE') {
            if (isset($GLOBALS['TSFE']->config['config']['language'])) {
                self::$languageKey = $GLOBALS['TSFE']->config['config']['language'];
                if (isset($GLOBALS['TSFE']->config['config']['language_alt'])) {
                    self::$alternativeLanguageKeys[] = $GLOBALS['TSFE']->config['config']['language_alt'];
                } else {
                    $locales = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\\CMS\\Core\\Localization\\Locales');
                    if (in_array(self::$languageKey, $locales->getLocales())) {
                        foreach ($locales->getLocaleDependencies(self::$languageKey) as $language) {
                            self::$alternativeLanguageKeys[] = $language;
                        }
                    }
                }
            }
        } elseif (strlen($GLOBALS['BE_USER']->uc['lang']) > 0) {
            self::$languageKey = $GLOBALS['BE_USER']->uc['lang'];
        }
    }

    static protected function loadTypoScriptLabels($extensionName) {
        $configurationManager = static::getConfigurationManager();
        $frameworkConfiguration = $configurationManager->getConfiguration(\TYPO3\CMS\Extbase\Configuration\ConfigurationManagerInterface::CONFIGURATION_TYPE_FRAMEWORK, $extensionName);
        if (!is_array($frameworkConfiguration['_LOCAL_LANG'])) {
            return;
        }
        self::$LOCAL_LANG_UNSET[$extensionName] = array();
        foreach ($frameworkConfiguration['_LOCAL_LANG'] as $languageKey => $labels) {
            if (!(is_array($labels) && isset(self::$LOCAL_LANG[$extensionName][$languageKey]))) {
                continue;
            }
            foreach ($labels as $labelKey => $labelValue) {
                if (is_string($labelValue)) {
                    self::$LOCAL_LANG[$extensionName][$languageKey][$labelKey][0]['target'] = $labelValue;
                    if ($labelValue === '') {
                        self::$LOCAL_LANG_UNSET[$extensionName][$languageKey][$labelKey] = '';
                    }
                    if (is_object($GLOBALS['LANG'])) {
                        self::$LOCAL_LANG_charset[$extensionName][$languageKey][$labelKey] = $GLOBALS['LANG']->csConvObj->charSetArray[$languageKey];
                    } else {
                        self::$LOCAL_LANG_charset[$extensionName][$languageKey][$labelKey] = $GLOBALS['TSFE']->csConvObj->charSetArray[$languageKey];
                    }
                } elseif (is_array($labelValue)) {
                    $labelValue = self::flattenTypoScriptLabelArray($labelValue, $labelKey);
                    foreach ($labelValue as $key => $value) {
                        self::$LOCAL_LANG[$extensionName][$languageKey][$key][0]['target'] = $value;
                        if ($value === '') {
                            self::$LOCAL_LANG_UNSET[$extensionName][$languageKey][$key] = '';
                        }
                    }
                }
            }
        }
    }

    static protected function flattenTypoScriptLabelArray(array $labelValues, $parentKey = '') {
        $result = array();
        foreach ($labelValues as $key => $labelValue) {
            if (!empty($parentKey)) {
                $key = $parentKey . '.' . $key;
            }
            if (is_array($labelValue)) {
                $labelValue = self::flattenTypoScriptLabelArray($labelValue, $key);
                $result = array_merge($result, $labelValue);
            } else {
                $result[$key] = $labelValue;
            }
        }
        return $result;
    }

    static protected function convertCharset($value, $charset) {
        if (TYPO3_MODE === 'FE') {
            return $GLOBALS['TSFE']->csConv($value, $charset);
        } else {
            $convertedValue = $GLOBALS['LANG']->csConvObj->conv($value, $GLOBALS['LANG']->csConvObj->parse_charset($charset), $GLOBALS['LANG']->charSet, 1);
            return $convertedValue !== NULL ? $convertedValue : $value;
        }
    }

    static protected function getConfigurationManager() {
        if (!is_null(static::$configurationManager)) {
            return static::$configurationManager;
        }
        $objectManager = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\\CMS\\Extbase\\Object\\ObjectManager');
        $configurationManager = $objectManager->get('TYPO3\\CMS\\Extbase\\Configuration\\ConfigurationManagerInterface');
        static::$configurationManager = $configurationManager;
        return $configurationManager;
    }
}