oxlang.php

Go to the documentation of this file.

<?php

class oxLang extends oxSuperCfg
{
    private static $_instance = null;

    protected $_sName = 'lang';

    protected $_iBaseLanguageId = null;

    protected $_iTplLanguageId = null;

    protected $_iEditLanguageId = null;

    protected $_aLangCache = array();

    protected $_aAdminLangCache = array();

    public static function getInstance()
    {
        if ( defined('OXID_PHP_UNIT')) {
            if ( ($oClassMod = modInstances::getMod(__CLASS__))  && is_object($oClassMod) ) {
                return $oClassMod;
            } else {
                $inst = oxNew( 'oxLang' );
                 modInstances::addMod( __CLASS__, $inst );
                 return $inst;
            }
        }

        if ( !self::$_instance instanceof oxLang ) {

            self::$_instance = oxNew( 'oxLang');
        }
        return self::$_instance;
    }

    public function resetBaseLanguage()
    {
        $this->_iBaseLanguageId = null;
    }

    public function getBaseLanguage()
    {
        $myConfig = $this->getConfig();
        //$this->_iBaseLanguageId = null;

        if ( $this->_iBaseLanguageId !== null ) {
            return $this->_iBaseLanguageId;
        }

        $blAdmin = $this->isAdmin();

        // languages and search engines
        if ( $blAdmin && ( ( $iSeLang = oxConfig::getParameter( 'changelang' ) ) !== null ) ) {
            $this->_iBaseLanguageId = $iSeLang;
        }

        if ( is_null( $this->_iBaseLanguageId ) ) {
            $this->_iBaseLanguageId = oxConfig::getParameter( 'lang' );
        }

        //or determining by domain
        $aLanguageUrls = $myConfig->getConfigParam( 'aLanguageURLs' );

        if ( !$blAdmin && is_array( $aLanguageUrls ) ) {
            foreach ( $aLanguageUrls as $iId => $sUrl ) {
                if ( $myConfig->isCurrentUrl( $sUrl ) ) {
                    $this->_iBaseLanguageId = $iId;
                    break;
                }
            }
        }

        if ( is_null( $this->_iBaseLanguageId ) ) {
            $this->_iBaseLanguageId = oxConfig::getParameter( 'language' );
        }

        // if language still not setted and not search engine browsing,
        // getting language from browser
        if ( is_null( $this->_iBaseLanguageId ) && !$blAdmin && !oxUtils::getInstance()->isSearchEngine() ) {

            // getting from cookie
            $this->_iBaseLanguageId = oxUtilsServer::getInstance()->getOxCookie( 'language' );

            // getting from browser
            if ( is_null( $this->_iBaseLanguageId ) ) {
                $this->_iBaseLanguageId = $this->detectLanguageByBrowser();
            }
        }

        if ( is_null( $this->_iBaseLanguageId ) ) {
            $this->_iBaseLanguageId = $myConfig->getConfigParam( 'sDefaultLang' );
        }

        $this->_iBaseLanguageId = (int) $this->_iBaseLanguageId;

        // validating language
        $this->_iBaseLanguageId = $this->validateLanguage( $this->_iBaseLanguageId );

        // setting language to cookie
        oxUtilsServer::getInstance()->setOxCookie( 'language', $this->_iBaseLanguageId );

        return $this->_iBaseLanguageId;
    }

    public function getTplLanguage()
    {
        if ( $this->_iTplLanguageId === null ) {
            if ( !$this->isAdmin() ) {
                $this->_iTplLanguageId = $this->getBaseLanguage();
            } else {

                //admin area
                if ( is_null( $this->_iTplLanguageId ) ) {
                    $this->_iTplLanguageId = oxSession::getVar( 'tpllanguage' );
                }

                if ( is_null( $this->_iTplLanguageId ) ) {
                    $this->_iTplLanguageId = $this->getBaseLanguage();
                }
            }

            // validating language
            $this->_iTplLanguageId = $this->validateLanguage( $this->_iTplLanguageId );
        }
        return $this->_iTplLanguageId;
    }

    public function getEditLanguage()
    {
        if ( $this->_iEditLanguageId !== null ) {
            return $this->_iEditLanguageId;
        }

        if ( !$this->isAdmin() ) {
            $this->_iEditLanguageId = $this->getBaseLanguage();
        } else {

            $this->_iEditLanguageId = oxConfig::getParameter( 'editlanguage' );

            // check if we really need to set the new language
            if ( "saveinnlang" == $this->getConfig()->getActiveView()->getFncName() ) {
                $iNewLanguage = oxConfig::getParameter( "new_lang");
            }

            if ( isset( $iNewLanguage ) ) {
                $this->_iEditLanguageId = $iNewLanguage;
                oxSession::deleteVar( "new_lang" );
            }

            if ( is_null( $this->_iEditLanguageId ) ) {

                $this->_iEditLanguageId = $this->getBaseLanguage();
            }
        }

        // validating language
        $this->_iEditLanguageId = $this->validateLanguage( $this->_iEditLanguageId );

        return $this->_iEditLanguageId;
    }

    public function getLanguageArray( $iLanguage = null, $blOnlyActive = false, $blSort = false )
    {
        $myConfig = $this->getConfig();

        if ( is_null($iLanguage) ) {
            $iLanguage = $this->_iBaseLanguageId;
        }

        $aLanguages = array();
        $aConfLanguages = $myConfig->getConfigParam( 'aLanguages' );
        $aLangParams    = $myConfig->getConfigParam( 'aLanguageParams' );

        if ( is_array( $aConfLanguages ) ) {
            $i = 0;
            reset( $aConfLanguages );
            while ( list( $key, $val ) = each( $aConfLanguages ) ) {

                if ( $blOnlyActive && is_array($aLangParams) ) {
                    //skipping non active languages
                    if ( !$aLangParams[$key]['active'] ) {
                        $i++;
                        continue;
                    }
                }

                if ( $val) {
                    $oLang = new oxStdClass();
                    if ( isset($aLangParams[$key]['baseId']) ) {
                        $oLang->id  = $aLangParams[$key]['baseId'];
                    } else {
                        $oLang->id  = $i;
                    }
                    $oLang->oxid    = $key;
                    $oLang->abbr    = $key;
                    $oLang->name    = $val;

                    if ( is_array($aLangParams) ) {
                        $oLang->active  = $aLangParams[$key]['active'];
                        $oLang->sort   = $aLangParams[$key]['sort'];
                    }

                    if ( isset( $iLanguage ) && $oLang->id == $iLanguage ) {
                        $oLang->selected = 1;
                    } else {
                        $oLang->selected = 0;
                    }
                    $aLanguages[$oLang->id] = $oLang;
                }
                ++$i;
            }
        }

        if ( $blSort && is_array($aLangParams) ) {
            uasort( $aLanguages, array($this, '_sortLanguagesCallback') );
        }

        return $aLanguages;
    }

    public function getLanguageAbbr( $iLanguage = null)
    {
        $myConfig = $this->getConfig();

        if ( !isset($iLanguage) ) {
            $iLanguage = $this->_iBaseLanguageId;
        }

        $aLangAbbr = $this->getLanguageIds();

        if ( isset($iLanguage,$aLangAbbr[$iLanguage]) ) {
            return $aLangAbbr[$iLanguage];
        }

        return $iLanguage;
    }

    public function getLanguageNames()
    {

        $aConfLanguages = $this->getConfig()->getConfigParam( 'aLanguages' );
        $aLangIds = $this->getLanguageIds();
        $aLanguages = array();
        foreach ( $aLangIds as $iId => $sValue ) {
            $aLanguages[$iId] = $aConfLanguages[$sValue];
        }
        return $aLanguages;
    }

    public function getLanguageIds()
    {
        $aLangParams = $this->getConfig()->getConfigParam( 'aLanguageParams' );

        //if exists language parameters array, extract lang id's from there
        if ( is_array($aLangParams) ) {

            $aIds = array();

            foreach ( $aLangParams as $sAbbr => $aValue ) {
                $iBaseId = (int) $aValue['baseId'];
                $aIds[$iBaseId] = $sAbbr;
            }
            return $aIds;
        }

        return array_keys( $this->getConfig()->getConfigParam( 'aLanguages' ));
    }

    public function translateString( $sStringToTranslate, $iLang = null, $blAdminMode = null )
    {
        $aLangCache = $this->_getLangTranslationArray( $iLang, $blAdminMode );
        $sText = isset( $aLangCache[$sStringToTranslate] ) ? $aLangCache[$sStringToTranslate] : $sStringToTranslate;

            $blIsAdmin = isset( $blAdminMode ) ? $blAdminMode : $this->isAdmin();
            if ( !$blIsAdmin && $sText === $sStringToTranslate ) {
                $sText = $this->_readTranslateStrFromTextFile( $sStringToTranslate, $iLang, $blIsAdmin );
            }

        return $sText;
    }

    public function formatCurrency( $dValue, $oActCur = null )
    {
        if ( !$oActCur ) {
            $oActCur = $this->getConfig()->getActShopCurrencyObject();
        }
        return number_format( $dValue, $oActCur->decimal, $oActCur->dec, $oActCur->thousand );
    }

    public function formatVat( $dValue, $oActCur = null )
    {
        $iDecPos = 0;
        $sValue  = ( string ) $dValue;
        $oStr = getStr();
        if ( ( $iDotPos = $oStr->strpos( $sValue, '.' ) ) !== false ) {
            $iDecPos = $oStr->strlen( $oStr->substr( $sValue, $iDotPos + 1 ) );
        }

        $oActCur = $oActCur ? $oActCur : $this->getConfig()->getActShopCurrencyObject();
        $iDecPos = ( $iDecPos < $oActCur->decimal ) ? $iDecPos : $oActCur->decimal;
        return number_format( $dValue, $iDecPos, $oActCur->dec, $oActCur->thousand );
    }

    public function getLanguageTag( $iLanguage = null)
    {
        if ( !isset( $iLanguage ) ) {
            $iLanguage = $this->getBaseLanguage();
        }

        $iLanguage = (int) $iLanguage;

        return ( ( $iLanguage )?"_$iLanguage":"" );
    }

    public function validateLanguage( $iLang = null )
    {
        $iLang = (int) $iLang;

        // checking if this language is valid
        $aLanguages = $this->getLanguageArray();

        if ( !isset( $aLanguages[$iLang] ) && is_array( $aLanguages ) ) {
            $oLang = current( $aLanguages );
            $iLang = $oLang->id;
        }

        return $iLang;
    }

    public function setBaseLanguage( $iLang = null )
    {
        if ( is_null($iLang) ) {
            $iLang = $this->getBaseLanguage();
        } else {
            $this->_iBaseLanguageId = (int) $iLang;
        }

        if ( defined( 'OXID_PHP_UNIT' ) ) {
            modSession::getInstance();
        }

        oxSession::setVar( 'language', $iLang );
    }

    public function setTplLanguage( $iLang = null )
    {
        if ( is_null($iLang) ) {
            $iLang = $this->getTplLanguage();
        } else {
            $this->_iTplLanguageId = (int) $iLang;
        }

        if ( defined( 'OXID_PHP_UNIT' ) ) {
            modSession::getInstance();
        }

        oxSession::setVar( 'tpllanguage', $iLang );
    }

    protected function _recodeLangArray( $aLangArray, $sCharset )
    {
        foreach ( $aLangArray as $sKey => $sValue ) {
            $aLangArray[$sKey] = iconv( $sCharset, 'UTF-8', $sValue );
        }

        return $aLangArray;
    }

    protected function _getLangFilesPathArray( $blAdmin, $iLang )
    {
        $myConfig = $this->getConfig();
        $aLangFiles = array();

        //get all lang files
        $sStdPath = $myConfig->getStdLanguagePath( "", $blAdmin, $iLang );
        if ( $sStdPath ) {
            $aLangFiles[] = $sStdPath . "lang.php";
            $aLangFiles = array_merge( $aLangFiles, glob( $sStdPath."*_lang.php" ) );
        }

        $sCustPath = $myConfig->getLanguagePath( "", $blAdmin, $iLang );
        if ( $sCustPath && $sCustPath != $sStdPath ) {
            if ( is_readable( $sCustPath . "lang.php" ) ) {
                $aLangFiles[] = $sCustPath . "lang.php";
            }
            $aLangFiles = array_merge( $aLangFiles, glob( $sCustPath."*_lang.php" ) );
        }

        return count( $aLangFiles ) ? $aLangFiles : false;
    }

    protected function _getLangFileCacheName( $blAdmin, $iLang )
    {
        $myConfig = $this->getConfig();
        return "langcache_" . ( (int) $blAdmin ) . "_{$iLang}_" . $myConfig->getShopId() . "_" . $myConfig->getConfigParam( 'sTheme' );
    }

    protected function _getLanguageFileData( $blAdmin = false, $iLang = 0 )
    {
        $myConfig = $this->getConfig();
        $myUtils  = oxUtils::getInstance();

        $sCacheName = $this->_getLangFileCacheName( $blAdmin, $iLang );
        $aLangCache = $myUtils->getLangCache( $sCacheName );
        if ( !$aLangCache && ( $aLangFiles = $this->_getLangFilesPathArray( $blAdmin, $iLang ) ) ) {
            $aLangCache[$iLang] = array();
            $sBaseCharset = false;
            foreach ( $aLangFiles as $sLangFile ) {

                if (!file_exists($sLangFile)) {
                    continue;
                }

                include $sLangFile;

                // including only (!) thoose, which has charset defined
                if ( isset( $aLang['charset'] ) ) {

                    // recoding only in utf
                    if ( $myConfig->isUtf() ) {
                        $aLang = $this->_recodeLangArray( $aLang, $aLang['charset'] );

                        // overriding charset
                        $aLang['charset'] = 'UTF-8';
                    }

                    if ( !$sBaseCharset ) {
                        $sBaseCharset = $aLang['charset'];
                    }

                    $aLangCache[$iLang] = array_merge( $aLangCache[$iLang], $aLang );
                }
            }

            // setting base charset
            if ( $sBaseCharset ) {
                $aLangCache[$iLang]['charset'] = $sBaseCharset;
            }

            //save to cache
            $myUtils->setLangCache( $sCacheName, $aLangCache );
        }

        return $aLangCache;
    }

    protected function _getCacheLanguageId( $blAdmin, $iLang = null )
    {
        $iLang = ( $iLang === null && $blAdmin ) ? $this->getTplLanguage() : $iLang;
        if ( !isset( $iLang ) ) {
            $iLang = $this->getBaseLanguage();
            if ( !isset( $iLang ) ) {
                $iLang = 0;
            }
        }

        return (int) $iLang;
    }

    protected function _getLangTranslationArray( $iLang = null, $blAdmin = null )
    {
        startProfile("<b>_getLangTranslationArray</b>");

        $blAdmin = isset( $blAdmin ) ? $blAdmin : $this->isAdmin();
        $iLang = $this->_getCacheLanguageId( $blAdmin, $iLang );

        $aLangCache = $blAdmin ? $this->_aAdminLangCache : $this->_aLangCache;

        if ( !isset( $aLangCache[$iLang] ) ) {

            // loading lang file data
            $aLangCache = $this->_getLanguageFileData( $blAdmin, $iLang );
            if ( $blAdmin ) {
                $this->_aAdminLangCache = $aLangCache;
            } else {
                $this->_aLangCache = $aLangCache;
            }
        }

        stopProfile("<b>_getLangTranslationArray</b>");

        // if language array exists ..
        return ( isset( $aLangCache[$iLang] ) ? $aLangCache[$iLang] : array() );
    }

    protected function _readTranslateStrFromTextFile( $sStringToTranslate, $iLang = null, $blIsAdmin = null )
    {
        $blIsAdmin = isset( $blIsAdmin ) ? $blIsAdmin : $this->isAdmin();
        $iLang  = ( $iLang === null && $blIsAdmin)?$this->getTplLanguage():$iLang;
        if ( !isset( $iLang ) ) {
            $iLang = $this->getBaseLanguage();
            if ( !isset( $iLang ) ) {
                $iLang = 0;
            }
        }

        $sFileName = $this->getConfig()->getLanguagePath('lang.txt', $blIsAdmin, $iLang);

        if ( is_file ( $sFileName ) ) {

            static $aUserLangCache = array();

            if ( !isset( $aUserLangCache[$sFileName] ) ) {
                $handle = @fopen( $sFileName, "r" );
                if ( $handle === false ) {
                    return $sStringToTranslate;
                }

                $contents = fread( $handle, filesize ( $sFileName ) );
                fclose( $handle );
                $fileArray = explode( "\n", $contents );
                $aUserLangCache[$sFileName] = array();
                $aLang = &$aUserLangCache[$sFileName];
                $oStr = getStr();

                while ( list( $nr,$line ) = each( $fileArray ) ) {
                    $line = ltrim( $line );
                    if ( $line[0]!="#" && $oStr->strpos( $line, "=" ) > 0 ) {
                        $index = trim( $oStr->substr( $line, 0, $oStr->strpos($line, "=" ) ) );
                        $value = trim( $oStr->substr( $line, $oStr->strpos( $line, "=" ) + 1, $oStr->strlen( $line ) ) );
                        $aLang[trim($index)] = trim($value);
                    }
                }
            }

            if ( !isset( $aLang ) && isset( $aUserLangCache[$sFileName] ) ) {
                $aLang = &$aUserLangCache[$sFileName];
            }

            if ( isset( $aLang[$sStringToTranslate] ) ) {
                return $aLang[$sStringToTranslate];
            }
        }

        return $sStringToTranslate;
    }

    protected function _sortLanguagesCallback( $a1, $a2 )
    {
        return ($a1->sort > $a2->sort);
    }

    public function getName()
    {
        return $this->_sName;
    }

    public function getFormLang()
    {
        if ( !$this->isAdmin()) {
            return "<input type=\"hidden\" name=\"".$this->getName()."\" value=\"". $this->getBaseLanguage() . "\">";
        }
    }

    public function getUrlLang( $iLang = null )
    {
        if ( !$this->isAdmin()) {
            $iLang = isset( $iLang ) ? $iLang : $this->getBaseLanguage();
            return $this->getName()."=". $iLang;
        }
    }

    public function processUrl( $sUrl, $iLang = null )
    {
        $iLang = isset( $iLang ) ? $iLang : $this->getBaseLanguage();
        $oStr = getStr();

        if ( !$this->isAdmin() ) {
            $sParam = $this->getUrlLang( $iLang );
            if (!preg_match('/(\?|&(amp;)?)lang=[0-9]+/', $sUrl)  && ($iLang != oxConfig::getInstance()->getConfigParam( 'sDefaultLang' ))) {
                if ( $sUrl ) {
                    if ($oStr->strpos( $sUrl, '?') === false) {
                        $sUrl .= "?";
                    } elseif (!preg_match('/(\?|&(amp;)?)$/', $sUrl)) {
                        $sUrl .= "&amp;";
                    }
                }
                $sUrl .= $sParam."&amp;";
            } else {
                $sUrl = preg_replace('/(\?|&(amp;)?)lang=[0-9]+/', '\1'.$sParam, $sUrl);
            }
        }

        return $sUrl;
    }

    public function detectLanguageByBrowser()
    {
        $sBrowserLang = strtolower( substr( $_SERVER['HTTP_ACCEPT_LANGUAGE'], 0, 2 ) );

        if ( !$sBrowserLang ) {
            return;
        }

        $aLangs = $this->getLanguageArray(null, true );

        foreach ( $aLangs as $oLang ) {
            if ( $oLang->abbr == $sBrowserLang ) {
                return (int) $oLang->id;
            }
        }
    }
}