68publishers / i18n
Internationalization and localization your app with a minimum effort.
Installs: 3 417
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 3
Forks: 0
Open Issues: 4
Requires
- php: ^7.3 || ^8.1
- ext-json: *
- nette/di: ^3.0.3
- nette/http: ^3.0
- nette/schema: ^1.0.2
- nette/utils: ^3.0 || ^4.0
- umpirsky/locale-list: ^1.0
Requires (Dev)
- 68publishers/translation-bridge: ^1.2.1
- contributte/translation: ^0.8.1
- friendsofphp/php-cs-fixer: ^2.0
- mockery/mockery: ^1.4
- nette/bootstrap: ^3.0
- nette/tester: ^2.3.4
- roave/security-advisories: dev-master
- tracy/tracy: ^2.6
Suggests
- 68publishers/translation-bridge: For integration with Translator component.
- tracy/tracy: A compiler extension adds a custom Panel if the Tracy is required.
README
⚠️ Warning! This package does not have active support, it exists only for the historical needs of the author.
i18n
This package helps you to deal with regions with different languages, currencies and countries. It could be helpful even if you have single region project.
Installation
The best way to install 68publishers/i18n is using Composer:
$ composer require 68publishers/i18n
then you can register extension into DIC:
extensions: 68publishers.i18n: SixtyEightPublishers\i18n\DI\I18nExtension(%debugMode%)
Configuration
68publishers.i18n: profiles: europe: language: [ sk_SK, en_GB, de_DE, pl_PL ] currency: [ EUR, PLZ, GBP ] country: [ SK, GB, DE, PL ] domain: [ 'europe\.example\.com' ] # regex north_america: language: en_US currency: USD country: US domain: 'example\.com\/na' enabled: no # default is `yes` default: # If the default profile doesn't exists, the first profile is taken as default language: cs_CZ currency: CZK country: CZ lists: fallback_language: en # default default_language: null # default translation_bridge: locale_resolver: enabled: yes # registers custom TranslatorLocaleResolver through 68publishers/translation-bridge extension use_default: yes # use language of default's profile if profile is not detected, default is `no` priority: 15 # if you want to use custom profile storage or profile detector: storage: My\Custom\ProfileStorage detector: My\Custom\Detector
Integration with 68publishers/translation-bridge
Translator Locale Resolving
The Translator's locale can be resolved by the currently active profile.
That is done with custom TranslatorLocaleResolver
that is automatically registered if an option translation_bridge.locale_resolver.enabled
is set to TRUE
.
Synchronization Between Profile's Language and Translator's Locale
The Translator's locale is automatically changed when the active profile's language is changed.
<?php /** @var \SixtyEightPublishers\i18n\Profile\ActiveProfile $activeProfile */ /** @var \SixtyEightPublishers\TranslationBridge\Localization\TranslatorLocalizerInterface $localizer */ $activeProfile->changeLanguage('en_GB'); $localizer->getLocale(); # en_GB $activeProfile->changeLanguage('cs_CZ'); $localizer->getLocale(); # cs_CZ
Contributing
Before committing any changes, don't forget to run
$ vendor/bin/php-cs-fixer fix --config=.php_cs.dist -v --dry-run
and
$ composer run tests