vendor/isotope/isotope-core/system/modules/isotope/library/Isotope/Translation.php line 101

Open in your IDE?
  1. <?php
  3. /*
  4.  * Isotope eCommerce for Contao Open Source CMS
  5.  *
  6.  * Copyright (C) 2009 - 2019 terminal42 gmbh & Isotope eCommerce Workgroup
  7.  *
  8.  * @link       https://isotopeecommerce.org
  9.  * @license    https://opensource.org/licenses/lgpl-3.0.html
  10.  */
  12. namespace Isotope;
  14. use Contao\Model\Collection;
  15. use Contao\StringUtil;
  16. use Isotope\Model\Label;
  18. /**
  19.  * Translates labels
  20.  */
  21. class Translation
  22. {
  24.     /**
  25.      * Labels
  26.      * @var array
  27.      */
  28.     protected static $arrLabels = array();
  30.     /**
  31.      * Labels loaded
  32.      * @var array
  33.      */
  34.     protected static $arrLoaded = array();
  36.     /**
  37.      * Get a translation of a value using the translation label
  38.      *
  39.      * @param mixed  $varLabel
  40.      * @param string $strLanguage
  41.      *
  42.      * @return mixed
  43.      */
  44.     public static function get($varLabel, $strLanguage = null)
  45.     {
  46.         if (!\Database::getInstance()->tableExists(Label::getTable())) {
  47.             return $varLabel;
  48.         }
  50.         if (null === $strLanguage) {
  51.             $strLanguage = $GLOBALS['TL_LANGUAGE'];
  52.         }
  54.         // Convert Language Tag to Locale ID
  55.         $strLanguage = str_replace('-', '_', $strLanguage);
  57.         // Recursively translate label array
  58.         if (\is_array($varLabel)) {
  59.             foreach ($varLabel as $k => $v) {
  60.                 $varLabel[$k] = static::get($v, $strLanguage);
  61.             }
  63.             return $varLabel;
  64.         }
  66.         // Load labels
  67.         static::initialize($strLanguage);
  69.         $varLabel = StringUtil::decodeEntities($varLabel);
  71.         if (isset(static::$arrLabels[$strLanguage][$varLabel])) {
  72.             return static::$arrLabels[$strLanguage][$varLabel];
  73.         }
  75.         return $varLabel;
  76.     }
  78.     /**
  79.      * Add a translation that is not stored in translation table
  80.      *
  81.      * @param string $strLabel       The label
  82.      * @param string $strReplacement The replacement
  83.      * @param string $strLanguage    The language
  84.      */
  85.     public static function add($strLabel, $strReplacement, $strLanguage = null)
  86.     {
  87.         if (null === $strLanguage) {
  88.             $strLanguage = $GLOBALS['TL_LANGUAGE'];
  89.         }
  91.         static::initialize($strLanguage);
  93.         static::$arrLabels[$strLanguage][StringUtil::decodeEntities($strLabel)] = $strReplacement;
  94.     }
  96.     /**
  97.      * Initialize the data in translation table
  98.      *
  99.      * @param string $strLanguage The language
  100.      */
  101.     protected static function initialize($strLanguage = null)
  102.     {
  103.         if (null === $strLanguage) {
  104.             $strLanguage = $GLOBALS['TL_LANGUAGE'];
  105.         }
  107.         if (!isset(static::$arrLoaded[$strLanguage])) {
  109.             /** @var Label[]|Collection $objLabels */
  110.             $objLabels = Label::findBy('language', $strLanguage);
  112.             if (null !== $objLabels) {
  113.                 while ($objLabels->next()) {
  114.                     static::$arrLabels[$strLanguage][StringUtil::decodeEntities($objLabels->label)] = $objLabels->replacement;
  115.                 }
  116.             }
  118.             static::$arrLoaded[$strLanguage] = true;
  119.         }
  120.     }
  121. }