WB 2.08.x

<?php

/**

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * This program is free software: you can redistribute it and/or modify

 * it under the terms of the GNU General Public License as published by

 * the Free Software Foundation, either version 3 of the License, or

 * (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program.  If not, see <http://www.gnu.org/licenses/>.

 */

/**

 * Translate.php

 *

 * @category     Core

 * @package      Core_Translation

 * @license      http://www.gnu.org/licenses/gpl.html   GPL License

 * @version      0.0.1

 * @revision     $Revision$

 * @link         $HeadURL$

 * @lastmodified $Date$

 * @since        File available since 12.01.2013

class Translate {

	protected $bRemoveMissing      = false;

/** can hold up to 31 boolean option settings */

	protected $iOptions            = 0;

/** List of loaded translation tables */

/** TranslationTable object of the core and additional one activated addon */

	protected $aActiveTranslations = array();

	const CACHE_DISABLED = 1; // ( 2^0 )

	const KEEP_MISSING   = 2; // ( 2^1 )

	protected function  __construct() {}

/** prevent from cloning existing instance */

	private function __clone() {}

/**

 * get a valid instance of this class

 * @return object

 */

	static public function getInstance() {

		if( is_null(self::$_oInstance) ) {

            $c = __CLASS__;

            self::$_oInstance = new $c;

		}

		return self::$_oInstance;

	}

/**

 * Initialize the Translations

 * @param string UserLanguage code ('de' || 'de_CH' || 'de_CH_uri')

 * @param integer possible options (DISABLE_CACHE | KEEP_MISSING)

 */

	                           $sDefaultLanguage,

	                           $sUserLanguage = '',

	                           $sAdaptor = 'WbOldStyle',

	                           $iOptions = 0)

		if(!class_exists('TranslateAdaptor'.$sAdaptor)) {

			throw new TranslationException('unable to load adaptor: '.$sAdaptor);

		}

		$this->bRemoveMissing = (!($iOptions & self::KEEP_MISSING));

		$this->sSystemLanguage = (trim($sSystemLanguage) == '' ? 'en' : $sSystemLanguage);

		// if no default language is set then use system language

		$this->sDefaultLanguage = (trim($sDefaultLanguage) == ''

		                            ? $this->sSystemLanguage

		                            : $sDefaultLanguage);

		   preg_match($sPattern, $this->sDefaultLanguage) &&

		   preg_match($sPattern, $this->sUserLanguage))

		// load core translations and activate it

			                             $this->sSystemLanguage,

			                             $this->sDefaultLanguage,

			                             $this->sUserLanguage,

			                             $this->bUseCache);

			$this->aLoadedAddons['core'] = $oTmp->load($this->sAdaptor);

			$this->aActiveTranslations[0] = $this->aLoadedAddons['core'];

			if(sizeof($this->aLoadedAddons['core']) == 0) {

				throw new TranslationException('missing core translations');

			}

		}else {

		// throw an exception for invalid or missing language codes

			      . $this->sDefaultLanguage.'] or ['.$this->sUserLanguage.']';

		}

	}

/**

 * Add new addon

 * @param string Addon descriptor (i.e. 'modules\myAddon')

 */

			if(!class_exists('TranslateAdaptor'.$sAdaptor)) {

				throw new TranslationException('unable to load adaptor: '.$sAdaptor);

			}

			$sAdaptor = 'TranslateAdaptor'.$sAdaptor;

		}else {

			$sAdaptor = $this->sAdaptor;

		}

			                             $this->sSystemLanguage,

			                             $this->sDefaultLanguage,

			                             $this->sUserLanguage,

			                             $this->bUseCache);

	}

/**

 * Activate Addon

 * @param string Addon descriptor (i.e. 'modules\myAddon')

	}

 * Dissable active addon

 */

	{

			unset($this->aActiveTranslations[1]);

	}

/**

 * Is key available

 * @param string Language key

 * @return bool

 */

	public function __isset($sKey)

	{

			// is true if at least one translation is found

				return true;

			}

		}

		return false;

	}

/**

 * Get translation text

 * @param string Language key

 * @return string Translation text

 */

	public function __get($sKey)

	{

			// search the last matching translation (Core -> Addon)

				$sRetval = $oAddon->$sKey;

			}

		}

		return $sRetval;

	}

/**

 * @param string name of property

 * @param mixed value

 * @throws TranslationException

 */

	public function __set($name, $value) {

		throw new TranslationException('tried to set a readonly or nonexisting property ['.$name.']!! ');

	}

/**

 * @param type $sKey

 * @param type $aArguments

 * @return type

 */

    public function __call($sKey, $aArguments)

    {

		$sRetval = '';

		foreach($this->aActiveTranslations as $oAddon) {

			if(isset($oAddon->$sKey)) {

			// search the last matching translation (Core -> Addon)

				$sRetval = $oAddon->$sKey;

			}

		}

		if(sizeof($aArguments) > 0 && $sRetval != '') {

			foreach($aArguments as $iKey=>$sArgument) {

				if(is_string($sArgument)) {

					$sRetval = preg_replace('/\{'.$iKey.'\}/', $sArgument, $sRetval);

				}

			}

		}

		return ($sRetval != '' ? $sRetval : ($this->bRemoveMissing ? '' : '#'.$sKey.'#'));

    }

/**

 * @return array

 * @deprecated for backward compatibility only. Will be removed shortly

 */

	public function getLangArray()

	{

		foreach($this->aActiveTranslations as $oTranslationTable) {

			if(get_class($oTranslationTable) == 'TranslationTable') {

				$aSumTranslations = array_merge($aSumTranslations, $oTranslationTable->getArray());

			}

} // end of class Translate

// //////////////////////////////////////////////////////////////////////////////////// //

/**

 * TranslationException

 *

 * @category     Core

 * @package      Core_Translation

 * @author       Werner v.d.Decken <wkl@isteam.de>

 * @copyright    Werner v.d.Decken <wkl@isteam.de>

 * @license      http://www.gnu.org/licenses/gpl.html   GPL License

 * @version      2.9.0

 * @revision     $Revision$

 * @lastmodified $Date$

 * @description  Exceptionhandler for the Translation class and depending classes

 */

class TranslationException extends AppException {}