1. class
  2. Concrete
  3. \
  4. Core
  5. \
  6. Localization
  7. \
  8. Localization

Localization

class Localization (View source)

Constants

BASE_LOCALE

The "base" locale identifier.
CONTEXT_SYSTEM

The context (resolving to en_US) to be considered as the "neutral" one.

This context must be used for all strings that are system related in concrete5 and should have their own context. Generally, these are the strings that concrete5 saves in the database, such as package, theme and block type names/descriptions.
CONTEXT_SITE

This is the context for the site interface tranlations.

It contains the page locale, determined by the page-specific locale or by the site section it's contained in. When there's no locale associated to the current page, this context is associated to the locale specified in the concrete.locale configuration option.

These are all the translations that the site visitors see on the site. The editor also sees these strings in the same language as the visitor.
CONTEXT_UI

The context containing the locale of the current user (fallsback to the concrete.locale configuration option).

This should be the context used when showing the edit dialogs, the concrete5 menus...

Properties

protected TranslatorAdapterRepositoryInterface $translatorAdapterRepository

The translator adapter repository to be used.
protected array $contextLocales

The locale identifier to be used for every translation context.
protected string|null $activeContext

The currently active translation context.
protected array $activeContextQueue

Tracks the list of active contexts.

Methods

TranslatorAdapterRepositoryInterface
getTranslatorAdapterRepository()

Gets the translator adapter repository.

setTranslatorAdapterRepository(TranslatorAdapterRepositoryInterface $repository)

Sets the translator adapter repository.

string
getActiveContext()

Returns the currently active translation context.

setActiveContext(string $context)

Sets the active translation context.

pushActiveContext(string $newContext)

Change the active translation context, but remember the previous one.

popActiveContext()

Restore the context that was active before calling pushActiveContext.

mixed
withContext(string $context, callable $callback)

Execute a function using a specific localization context.

TranslatorAdapterInterface
getTranslatorAdapter($context)

Gets the translator adapter object for the given context from the translator adapter repository.

TranslatorAdapterInterface
getActiveTranslatorAdapter()

Gets the translator adapter for the active context.

setContextLocale(string $context, string $locale)

Sets the context locale for the given context as the given locale.

string|null
getContextLocale($context)

Gets the context locale for the given context.

setLocale(string $locale)

Sets the locale for the active context.

string
getLocale()

Gets the locale for the active context.

removeLoadedTranslatorAdapters()

Removes all the loaded translator adapters from the translator adapter repository.

Translator|null
getActiveTranslateObject() deprecated

Gets the translator object for the active context.

static Localization
getInstance()

Gets a singleton instance of this class.

static Translator
getTranslate() deprecated

Gets the translator object for the active context from from the singleton instance of this class.

static 
changeLocale(string $locale)

Sets the locale for the active context for the singleton instance of this class.

static string
activeLocale()

Returns the currently active locale for the currently active context from the singleton instance of this class.

static string
activeLanguage()

Returns the language for the currently active locale for the currently active context from the singleton instance of this class.

static array
getAvailableInterfaceLanguages()

Gets a list of the available site interface languages. Returns an array that where each item is a locale in format xx_XX.

static array
getAvailableInterfaceLanguageDescriptions(string|null $displayLocale = '')

Generates a list of all available languages and returns an array like [ "de_DE" => "Deutsch (Deutschland)", "en_US" => "English (United States)", "fr_FR" => "Francais (France)"] The result will be sorted by the key.

static string
getLanguageDescription(string $locale, string|null $displayLocale = '')

Get the description of a locale consisting of language and region description e.g. "French (France)".

static 
clearCache()

Clear the translations cache.

static 
setupSiteLocalization(Translator $translate = null) deprecated

Load the site language files (must be done after all packages called their setupPackageLocalization).

currentLocaleChanged(string $locale)

To be called every time the current locale changes.

Details

at line 92
TranslatorAdapterRepositoryInterface getTranslatorAdapterRepository()

Gets the translator adapter repository.

Return Value

TranslatorAdapterRepositoryInterface

Exceptions

Exception

at line 109
setTranslatorAdapterRepository(TranslatorAdapterRepositoryInterface $repository)

Sets the translator adapter repository.

Parameters

TranslatorAdapterRepositoryInterface $repository

at line 119
string getActiveContext()

Returns the currently active translation context.

Return Value

string

at line 129
setActiveContext(string $context)

Sets the active translation context.

Parameters

string $context

at line 163
pushActiveContext(string $newContext)

Change the active translation context, but remember the previous one.

Useful when temporarily setting the translation context to something else than the original.

Parameters

string $newContext

The new translation context to activate (default contexts are defined by the Localization::CONTEXT_... constants).

See also

Localization::popActiveContext

Examples

```php
$loc = \Localization::getInstance();
// Let's assume the current context is 'original_context'

$loc->pushActiveContext('new_context');

// Do what you want in context 'new_context'

$loc->popActiveContext();
// Now the context is 'original_context'
```

at line 176
popActiveContext()

Restore the context that was active before calling pushActiveContext.

See also

Localization::pushActiveContext

at line 194
mixed withContext(string $context, callable $callback)

Since: concrete5 8.5.0a2

Execute a function using a specific localization context.

Parameters

string $context

The translation context to use when running $callback (default contexts are defined by the Localization::CONTEXT_... constants).
callable $callback

Return Value

mixed

return the result of $callback

at line 217
TranslatorAdapterInterface getTranslatorAdapter($context)

Gets the translator adapter object for the given context from the translator adapter repository.

Parameters

$context

Return Value

TranslatorAdapterInterface

Exceptions

Exception

at line 235
TranslatorAdapterInterface getActiveTranslatorAdapter()

Gets the translator adapter for the active context.

Return Value

TranslatorAdapterInterface

at line 246
setContextLocale(string $context, string $locale)

Sets the context locale for the given context as the given locale.

Parameters

string $context
string $locale

at line 262
string|null getContextLocale($context)

Gets the context locale for the given context.

Parameters

$context

Return Value

string|null

at line 272
setLocale(string $locale)

Sets the locale for the active context.

Parameters

string $locale

at line 282
string getLocale()

Gets the locale for the active context.

Return Value

string

at line 293
removeLoadedTranslatorAdapters()

Removes all the loaded translator adapters from the translator adapter repository.

at line 307
Translator|null getActiveTranslateObject() deprecated

deprecated Use translator adapters instead

Gets the translator object for the active context.

Return Value

Translator|null

at line 322
static Localization getInstance()

Gets a singleton instance of this class.

Return Value

Localization

at line 337
static Translator getTranslate() deprecated

deprecated Use translator adapters instead

Gets the translator object for the active context from from the singleton instance of this class.

Return Value

Translator

at line 350
static changeLocale(string $locale)

Sets the locale for the active context for the singleton instance of this class.

Parameters

string $locale

at line 364
static string activeLocale()

Returns the currently active locale for the currently active context from the singleton instance of this class.

Return Value

string

Examples

'en_US'

at line 379
static string activeLanguage()

Returns the language for the currently active locale for the currently active context from the singleton instance of this class.

Return Value

string

Examples

'en'

at line 390
static array getAvailableInterfaceLanguages()

Gets a list of the available site interface languages. Returns an array that where each item is a locale in format xx_XX.

Return Value

array

at line 430
static array getAvailableInterfaceLanguageDescriptions(string|null $displayLocale = '')

Generates a list of all available languages and returns an array like [ "de_DE" => "Deutsch (Deutschland)", "en_US" => "English (United States)", "fr_FR" => "Francais (France)"] The result will be sorted by the key.

If the $displayLocale is set, the language- and region-names will be returned in that language.

Parameters

string|null $displayLocale

Language of the description. Set to null to get each locale name in its own language, set to '' to use the current locale, set to a specific locale to get the names in that language

Return Value

array

An associative Array with locale as the key and description as content

at line 457
static string getLanguageDescription(string $locale, string|null $displayLocale = '')

Get the description of a locale consisting of language and region description e.g. "French (France)".

Parameters

string $locale

Locale that should be described
string|null $displayLocale

Language of the description. Set to null to get each locale name in its own language, set to '' to use the current locale, set to a specific locale to get the names in that language

Return Value

string

Description of a language

at line 465
static clearCache()

Clear the translations cache.

at line 484
static setupSiteLocalization(Translator $translate = null) deprecated

deprecated use \Concrete\Core\Localization\Translator\Adapter\Zend\Translation\Loader\Gettext\SiteTranslationLoader instead

Load the site language files (must be done after all packages called their setupPackageLocalization).

Parameters

Translator $translate

at line 505
protected currentLocaleChanged(string $locale)

To be called every time the current locale changes.

Parameters

string $locale