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 $_aAdminTplLanguageArray = null;

    protected $_aLangAbbr = null;

    protected $_aAdditionalLangFiles = array();

    protected $_aLangMap = array();

    protected $_aActiveModuleInfo = null;

    protected $_aDisabledModuleInfo = null;

    public static function getInstance()
    {
        return oxRegistry::getLang();
    }

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

    public function getBaseLanguage()
    {
        if ( $this->_iBaseLanguageId === null ) {

            $myConfig = $this->getConfig();
            $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 ( $sUrl && $myConfig->isCurrentUrl( $sUrl ) ) {
                        $this->_iBaseLanguageId = $iId;
                        break;
                    }
                }
            }

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

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

                // getting from cookie
                $this->_iBaseLanguageId = oxRegistry::get("oxUtilsServer")->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 );

            oxRegistry::get("oxUtilsServer")->setOxCookie( 'language', $this->_iBaseLanguageId );
        }

        return $this->_iBaseLanguageId;
    }

    public function getObjectTplLanguage()
    {
        if ( $this->_iObjectTplLanguageId === null ) {
            $this->_iObjectTplLanguageId = $this->getTplLanguage();
            $aLanguages = $this->getAdminTplLanguageArray();
            if ( !isset( $aLanguages[$this->_iObjectTplLanguageId] ) ||
                 $aLanguages[$this->_iObjectTplLanguageId]->active == 0 ) {
                $this->_iObjectTplLanguageId = key( $aLanguages );
            }
        }
        return $this->_iObjectTplLanguageId;
    }

    public function getTplLanguage()
    {
        if ( $this->_iTplLanguageId === null ) {
            $iSessLang = oxSession::getVar( 'tpllanguage' );
            $this->_iTplLanguageId = $this->isAdmin() ? $this->setTplLanguage( $iSessLang ) : $this->getBaseLanguage();
        }
        return $this->_iTplLanguageId;
    }

    public function getEditLanguage()
    {
        if ( $this->_iEditLanguageId === null ) {

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

                $iLang = null;
                // choosing language ident
                // check if we really need to set the new language
                if ( "saveinnlang" == $this->getConfig()->getActiveView()->getFncName() ) {
                    $iLang = oxConfig::getParameter( "new_lang");
                }
                $iLang = ( $iLang === null ) ? oxConfig::getParameter( 'editlanguage' ) : $iLang;
                $iLang = ( $iLang === null ) ? oxSession::getVar( 'editlanguage' ) : $iLang;
                $iLang = ( $iLang === null ) ? $this->getBaseLanguage() : $iLang;

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

                // writing to session
                oxSession::setVar( 'editlanguage', $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 stdClass();
                    $oLang->id   = isset($aLangParams[$key]['baseId']) ? $aLangParams[$key]['baseId'] : $i;
                    $oLang->oxid = $key;
                    $oLang->abbr = $key;
                    $oLang->name = $val;

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

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

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

    public function getAdminTplLanguageArray()
    {
        if ( $this->_aAdminTplLanguageArray === null ) {
            $myConfig = $this->getConfig();

            // #656 add admin languages
            $aLangData = array();
            $aLangIds  = $this->getLanguageIds();

            $sSourceDir = $myConfig->getAppDir() . 'views/admin/';
            foreach ( glob( $sSourceDir."*", GLOB_ONLYDIR ) as $sDir ) {
                $sFilePath = "{$sDir}/lang.php";
                if ( file_exists( $sFilePath ) && is_readable( $sFilePath ) ) {
                    $sLangName = "";
                    $sAbbr = strtolower( basename( $sDir ) );
                    if ( !in_array( $sAbbr, $aLangIds ) ) {
                        include $sFilePath;
                        $aLangData[$sAbbr] = new stdClass();
                        $aLangData[$sAbbr]->name = $sLangName;
                        $aLangData[$sAbbr]->abbr = $sAbbr;
                    }
                }
            }

            $this->_aAdminTplLanguageArray = $this->getLanguageArray();
            if ( count( $aLangData ) ) {

                // sorting languages for selection list view
                ksort( $aLangData );
                $iSort = max( array_keys( $this->_aAdminTplLanguageArray ) );

                // appending other languages
                foreach ( $aLangData as $oLang ) {
                    $oLang->id = $oLang->sort = ++$iSort;
                    $oLang->selected = 0;
                    $oLang->active   = 0;
                    $this->_aAdminTplLanguageArray[$iSort] = $oLang;
                }
            }
        }

        // moving pointer to beginning
        reset( $this->_aAdminTplLanguageArray );
        return $this->_aAdminTplLanguageArray;
    }

    public function getLanguageAbbr( $iLanguage = null )
    {
        if ( $this->_aLangAbbr === null ) {
            $this->_aLangAbbr = array();
            if ( $this->isAdmin() ) {
                foreach ( $this->getAdminTplLanguageArray() as $oLang ) {
                    $this->_aLangAbbr[$oLang->id] = $oLang->abbr;
                }
            } else {
                $this->_aLangAbbr = $this->getLanguageIds();
            }
        }

        $iLanguage = isset( $iLanguage ) ? (int) $iLanguage : $this->getBaseLanguage();
        if ( isset( $this->_aLangAbbr[$iLanguage] ) ) {
            $iLanguage = $this->_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()
    {
        $myConfig = $this->getConfig();
        $aIds = array();

        //if exists language parameters array, extract lang id's from there
        $aLangParams = $myConfig->getConfigParam( 'aLanguageParams' );
        if ( is_array( $aLangParams ) ) {
            foreach ( $aLangParams as $sAbbr => $aValue ) {
                $iBaseId = (int) $aValue['baseId'];
                $aIds[$iBaseId] = $sAbbr;
            }
        } else {
            $aIds = array_keys( $myConfig->getConfigParam( 'aLanguages' ) );
        }

        return $aIds;
    }

    public function translateString( $sStringToTranslate, $iLang = null, $blAdminMode = null )
    {
        // checking if in cash exist
        $aLang = $this->_getLangTranslationArray( $iLang, $blAdminMode );
        if ( isset( $aLang[$sStringToTranslate] ) ) {
            return $aLang[$sStringToTranslate];
        }

        // checking if in map exist
        $aMap = $this->_getLanguageMap( $iLang, $blAdminMode );
        if ( isset( $aLang[$aMap[$sStringToTranslate]] ) ) {
            return $aLang[$aMap[$sStringToTranslate]];
        }

        // checking if in theme options exist
        if (count($this->_aAdditionalLangFiles)) {
            $aLang = $this->_getLangTranslationArray( $iLang, $blAdminMode, $this->_aAdditionalLangFiles);
            if (isset( $aLang[$sStringToTranslate] )) {
                return $aLang[$sStringToTranslate];
            }
        }

        return $sStringToTranslate;
    }

    protected function _collectSimilar( $aData, $sKey, $aCollection = array() )
    {
        foreach ( $aData as $sValKey => $sValue ) {
            if ( strpos( $sValKey, $sKey ) === 0 ) {
                $aCollection[$sValKey] = $sValue;
            }
        }

        return $aCollection;
    }

    public function getSimilarByKey( $sKey, $iLang = null, $blAdmin = null )
    {
        startProfile("getSimilarByKey");

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

        // checking if in cash exist
        $aLang = $this->_getLangTranslationArray( $iLang, $blAdmin );
        $aSimilarConst = $this->_collectSimilar( $aLang, $sKey );

        // checking if in map exist
        $aMap = $this->_getLanguageMap( $iLang, $blAdminMode );
        $aSimilarConst = $this->_collectSimilar( $aMap, $sKey, $aSimilarConst );

        // checking if in theme options exist
        if ( count( $this->_aAdditionalLangFiles ) ) {
            $aLang = $this->_getLangTranslationArray( $iLang, $blAdminMode, $this->_aAdditionalLangFiles);
            $aSimilarConst = $this->_collectSimilar( $aLang, $sKey, $aSimilarConst );
        }

        stopProfile("getSimilarByKey");

        return $aSimilarConst;
    }

    public function formatCurrency( $dValue, $oActCur = null )
    {
        if ( !$oActCur ) {
            $oActCur = $this->getConfig()->getActShopCurrencyObject();
        }
        $sValue = oxRegistry::getUtils()->fRound( $dValue, $oActCur );
        return number_format( (double)$sValue, $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( (double)$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( null, !$this->isAdmin() );
        if ( !isset( $aLanguages[$iLang] ) && is_array( $aLanguages ) ) {
            $oLang = current( $aLanguages );
            if (isset($oLang->id)) {
                $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 )
    {
        $this->_iTplLanguageId = isset( $iLang ) ? (int) $iLang : $this->getBaseLanguage();
        if ( $this->isAdmin() ) {
            $aLanguages = $this->getAdminTplLanguageArray();
            if ( !isset( $aLanguages[$this->_iTplLanguageId] ) ) {
                $this->_iTplLanguageId = key( $aLanguages );
            }
        }

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

        oxSession::setVar( 'tpllanguage', $this->_iTplLanguageId );
        return $this->_iTplLanguageId;
    }

    protected function _recodeLangArray( $aLangArray, $sCharset, $blRecodeKeys = false )
    {
        $aLangs = array();
        foreach ( $aLangArray as $sKey => $sValue ) {
            $sItemKey = $sKey;
            if ($blRecodeKeys === true) {
                $sItemKey = iconv($sCharset, 'UTF-8', $sItemKey);
            }

            $aLangs[$sItemKey] = iconv( $sCharset, 'UTF-8', $sValue );
            unset($aLangArray[$sKey]);
        }

        return $aLangs;
    }

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

        $sAppDir        = $oConfig->getAppDir();
        $sLang          = oxRegistry::getLang()->getLanguageAbbr( $iLang );
        $sTheme         = $oConfig->getConfigParam( "sTheme" );
        $sCustomTheme   = $oConfig->getConfigParam( "sCustomTheme" );
        $sShopId        = $oConfig->getShopId();
        $aModulePaths   = $this->_getActiveModuleInfo();

        //get generic lang files
        $sGenericPath = $sAppDir . 'translations/' . $sLang;
        if ( $sGenericPath ) {
            $aLangFiles[] = $sGenericPath . "/lang.php";
            $aLangFiles = $this->_appendLangFile( $aLangFiles, $sGenericPath );
        }

        //get theme lang files
        if ( $sTheme ) {
            $sThemePath = $sAppDir . 'views/' . $sTheme .'/' . $sLang;
            $aLangFiles[] = $sThemePath . "/lang.php";
            $aLangFiles = $this->_appendLangFile( $aLangFiles, $sThemePath );
        }

        //get custom theme lang files
        if ( $sCustomTheme ) {
            $sCustPath = $sAppDir . 'views/' . $sCustomTheme .'/' . $sLang;
            $aLangFiles[] = $sCustPath . "/lang.php";
            $aLangFiles = $this->_appendLangFile( $aLangFiles, $sCustPath );
        }


        // custom theme shop languages

        // modules language files
        $aLangFiles = $this->_appendModuleLangFiles( $aLangFiles, $aModulePaths, $sLang );

        // custom language files
        $aLangFiles = $this->_appendCustomLangFiles( $aLangFiles, $sLang );

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

    protected function _getAdminLangFilesPathArray( $iLang )
    {
        $oConfig = $this->getConfig();
        $aLangFiles = array();

        $sAppDir        = $oConfig->getAppDir();
        $sLang          = oxRegistry::getLang()->getLanguageAbbr( $iLang );

        $aModulePaths = array();
        $aModulePaths = array_merge( $aModulePaths, $this->_getActiveModuleInfo() );
        $aModulePaths = array_merge( $aModulePaths, $this->_getDisabledModuleInfo() );

        // admin lang files
        $sAdminPath = $sAppDir . 'views/admin/' . $sLang;
        $aLangFiles[] = $sAdminPath . "/lang.php";
        $aLangFiles[] = $sAppDir . 'translations/' . $sLang . '/translit_lang.php';
        $aLangFiles = $this->_appendLangFile( $aLangFiles, $sAdminPath );

        // themes options lang files
        $sThemePath = $sAppDir . 'views/*/' . $sLang;
        $aLangFiles = $this->_appendLangFile( $aLangFiles, $sThemePath, "options" );

        // module language files
        $aLangFiles = $this->_appendModuleLangFiles( $aLangFiles, $aModulePaths, $sLang, true );

        // custom language files
        $aLangFiles = $this->_appendCustomLangFiles( $aLangFiles, $sLang, true );

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

    protected function _appendLangFile( $aLangFiles, $sFullPath, $sFilePattern = "lang" )
    {
        $aFiles = glob( $sFullPath . "/*_{$sFilePattern}.php" );
        if ( is_array( $aFiles ) && count( $aFiles ) ) {
            foreach ( $aFiles as $sFile ) {
                if ( !strpos( $sFile, 'cust_lang.php' ) ) {
                    $aLangFiles[] = $sFile;
                }
            }
        }
        return $aLangFiles;
    }

    protected function _appendCustomLangFiles( $aLangFiles, $sLang, $blForAdmin = false  )
    {
        $oConfig      = $this->getConfig();
        $sAppDir      = $oConfig->getAppDir();
        $sTheme       = $oConfig->getConfigParam( "sTheme" );
        $sCustomTheme = $oConfig->getConfigParam( "sCustomTheme" );

        if ( $blForAdmin ) {
            $aLangFiles[] = $sAppDir . 'views/admin/' . $sLang . '/cust_lang.php';
        } else {
            if ( $sTheme ) {
                $aLangFiles[] = $sAppDir . 'views/' . $sTheme . '/' . $sLang . '/cust_lang.php';
            }
            if ( $sCustomTheme ) {
                $aLangFiles[] = $sAppDir . 'views/' . $sCustomTheme . '/' . $sLang . '/cust_lang.php';
            }
        }

        return $aLangFiles;
    }

    protected function _appendModuleLangFiles( $aLangFiles, $aModulePaths, $sLang, $blForAdmin = false )
    {
        if ( is_array( $aModulePaths ) ) {

            $oConfig = $this->getConfig();

            foreach ( $aModulePaths as $sPath ) {
                $sFullPath  = $oConfig->getModulesDir() . $sPath;
                $sFullPath .= ($blForAdmin) ? '/views/admin/' : '/translations/';
                $sFullPath .= $sLang;
                //@deprecated since v4.7.1/5.0.1 (2012-11-20); for < 4.6 modules, since 4.7/5.0 translation files should be in modules/modulepath/views/admin/ dir
                if ( !is_dir( $sFullPath ) ) {
                    $sFullPath = $oConfig->getModulesDir() . $sPath;
                    $sFullPath .= ($blForAdmin) ? '/out/admin/' : '/out/lang/';
                    $sFullPath .= $sLang;
                }
                // END deprecated
                $aLangFiles = $this->_appendLangFile( $aLangFiles, $sFullPath );
                //load admin modules options lang files
                if ( $blForAdmin ) {
                    $aLangFiles[] = $sFullPath . '/module_options.php';
                }
            }
        }

        return $aLangFiles;
    }

    protected function _getLangFileCacheName( $blAdmin, $iLang, $aLangFiles = null )
    {
        $myConfig = $this->getConfig();
        $sLangFilesIdent = '_default';
        if (is_array($aLangFiles) && $aLangFiles) {
            $sLangFilesIdent = '_'.md5(implode('+', $aLangFiles));
        }
        return "langcache_" . ( (int) $blAdmin ) . "_{$iLang}_" . $myConfig->getShopId() . "_" . $myConfig->getConfigParam( 'sTheme' ).$sLangFilesIdent;
    }

    protected function _getLanguageFileData( $blAdmin = false, $iLang = 0, $aLangFiles = null )
    {
        $myConfig = $this->getConfig();
        $myUtils  = oxRegistry::getUtils();

        $sCacheName = $this->_getLangFileCacheName( $blAdmin, $iLang, $aLangFiles );
        $aLangCache = $myUtils->getLangCache( $sCacheName );
        if ( !$aLangCache && $aLangFiles === null ) {
            if ( $blAdmin ) {
                $aLangFiles = $this->_getAdminLangFilesPathArray( $iLang );
            } else {
                $aLangFiles = $this->_getLangFilesPathArray( $iLang );
            }
        }
        if ( !$aLangCache && $aLangFiles ) {
            $aLangCache = array();
            $sBaseCharset = false;
            $aLang = array();
            $aLangSeoReplaceChars = array();
            foreach ( $aLangFiles as $sLangFile ) {

                if ( file_exists( $sLangFile ) && is_readable( $sLangFile ) ) {
                    $aSeoReplaceChars = array();
                    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'] );

                            if (isset($aSeoReplaceChars) && is_array($aSeoReplaceChars)) {
                                $aSeoReplaceChars = $this->_recodeLangArray( $aSeoReplaceChars, $aLang['charset'], true );
                            }

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

                        if (isset($aSeoReplaceChars) && is_array($aSeoReplaceChars)) {
                            $aLangSeoReplaceChars = array_merge($aLangSeoReplaceChars, $aSeoReplaceChars);
                        }

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

                        $aLangCache = array_merge( $aLangCache, $aLang );
                    }
                }
            }

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

            // special character replacement list
            $aLangCache['_aSeoReplaceChars'] = $aLangSeoReplaceChars;

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

        return $aLangCache;
    }

    protected function _getLanguageMap( $iLang, $blAdmin = null )
    {
        $blAdmin = isset( $blAdmin ) ? $blAdmin : $this->isAdmin();
        $sKey = $iLang . ( (int) $blAdmin );
        if ( !isset( $this->_aLangMap[$sKey] ) ) {
            $this->_aLangMap[$sKey] = array();
            $myConfig = $this->getConfig();
            $sMapFile = $myConfig->getAppDir() . '/views/' .  ( $blAdmin ? 'admin' : $myConfig->getConfigParam( "sTheme" ) ) .'/' . oxRegistry::getLang()->getLanguageAbbr( $iLang ) . '/map.php';
            if ( $sMapFile ) {
                if ( file_exists( $sMapFile ) && is_readable( $sMapFile ) ) {
                    include $sMapFile;
                    $this->_aLangMap[$sKey] = $aMap;
                }
            }
        }

        return $this->_aLangMap[$sKey];
    }

    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, $aLangFiles = null )
    {
        startProfile("_getLangTranslationArray");

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

        if ( !isset( $this->_aLangCache[$sCacheName] ) ) {
            $this->_aLangCache[$sCacheName] = array();
        }
        if ( !isset( $this->_aLangCache[$sCacheName][$iLang] ) ) {
            // loading main lang files data
            $this->_aLangCache[$sCacheName][$iLang] = $this->_getLanguageFileData( $blAdmin, $iLang, $aLangFiles );
        }

        stopProfile("_getLangTranslationArray");

        // if language array exists ..
        return ( isset( $this->_aLangCache[$sCacheName][$iLang] ) ? $this->_aLangCache[$sCacheName][$iLang] : array() );
    }

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

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

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

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

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

        if ( !$this->isAdmin() ) {
            $sParam = $this->getUrlLang( $iLang );
            if ( !$oStr->preg_match('/(\?|&(amp;)?)lang=[0-9]+/', $sUrl)  && ($iLang != oxRegistry::getConfig()->getConfigParam( 'sDefaultLang' ))) {
                if ( $sUrl ) {
                    if ($oStr->strpos( $sUrl, '?') === false) {
                        $sUrl .= "?";
                    } elseif ( !$oStr->preg_match('/(\?|&(amp;)?)$/', $sUrl ) ) {
                        $sUrl .= "&amp;";
                    }
                }
                $sUrl .= $sParam."&amp;";
            } else {
                $sUrl = getStr()->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;
            }
        }
    }

    public function getMultiLangTables()
    {
        $aTables = array( "oxarticles", "oxartextends", "oxattribute",
                          "oxcategories", "oxcontents", "oxcountry",
                          "oxdelivery", "oxdiscount", "oxgroups",
                          "oxlinks", "oxnews", "oxobject2attribute",
                          "oxpayments", "oxselectlist", "oxshops",
                          "oxactions", "oxwrapping", "oxdeliveryset",
                          "oxvendor", "oxmanufacturers", "oxmediaurls",
                          "oxstates" );


        $aMultiLangTables = $this->getConfig()->getConfigParam( 'aMultiLangTables' );

        if ( is_array( $aMultiLangTables ) ) {
            $aTables = array_merge($aTables, $aMultiLangTables);
        }

        return $aTables;
    }

    public function getSeoReplaceChars($iLang)
    {
        // get language replace chars
        $aSeoReplaceChars = $this->translateString('_aSeoReplaceChars', $iLang);
        if (!is_array($aSeoReplaceChars)) {
            $aSeoReplaceChars = array();
        }

        return $aSeoReplaceChars;
    }

    protected function _getActiveModuleInfo()
    {
        if ($this->_aActiveModuleInfo === null) {
            $oModulelist = oxNew('oxmodulelist');
            $this->_aActiveModuleInfo = $oModulelist->getActiveModuleInfo();
        }
        return $this->_aActiveModuleInfo;
    }

    protected function _getDisabledModuleInfo()
    {
        if ($this->_aDisabledModuleInfo === null) {
            $oModulelist = oxNew('oxmodulelist');
            $this->_aDisabledModuleInfo = $oModulelist->getDisabledModuleInfo();
        }
        return $this->_aDisabledModuleInfo;
    }

}