PHPackages dachcom-digital/i18n - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Localization & i18n](/categories/localization) 4. / 5. dachcom-digital/i18n ActivePimcore-bundle[Localization & i18n](/categories/localization) dachcom-digital/i18n ==================== Pimcore I18n Manager. v5.1.3(8mo ago)27109.0k↑30.6%17[7 issues](https://github.com/dachcom-digital/pimcore-i18n/issues)[2 PRs](https://github.com/dachcom-digital/pimcore-i18n/pulls)GPL-3.0-or-laterPHPCI failing Since Oct 2Pushed 2mo ago12 watchersCompare [ Source](https://github.com/dachcom-digital/pimcore-i18n)[ Packagist](https://packagist.org/packages/dachcom-digital/i18n)[ Docs](https://github.com/dachcom-digital/pimcore-i18n)[ RSS](/packages/dachcom-digital-i18n/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (10)Versions (70)Used By (0) Pimcore - I18n ============== [](#pimcore---i18n) --- Important This bundle will **not** be compatible with Pimcore 12 or any future Pimcore versions. For all future development, updates, and documentation, please refer to [opendxp.io](https://www.opendxp.io): - Access the latest info here: - Migration of Dachcom Digital Bundles: **Note:** We are open to partnerships for those interested in porting this bundle to future versions. For inquiries, please contact: --- [![Software License](https://camo.githubusercontent.com/cad8c16a3d580a69d8923c98d8de25d21cb00fa54fa60a856a8e1ca657f79db4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d47504c76332d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Software License](https://camo.githubusercontent.com/e97037437574223b9032209d2ded216fae3bacdc9e5eeed04eb89f2b83a97ba7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d44434c2d77686974652e7376673f7374796c653d666c61742d73717561726526636f6c6f723d253233666635633563)](LICENSE.md)[![Latest Release](https://camo.githubusercontent.com/27c9679a153b442c424ba78f4520045979e690a8080546c7ea59767e96e604b2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f64616368636f6d2d6469676974616c2f6931386e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/dachcom-digital/i18n)[![Tests](https://camo.githubusercontent.com/9d92acf65ad7cd1e3a0c696d0f7e0cdd374d8c83fdd1e794dfeac255af994247/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f64616368636f6d2d6469676974616c2f70696d636f72652d6931386e2f2e6769746875622f776f726b666c6f77732f636f646563657074696f6e2e796d6c3f6272616e63683d6d6173746572267374796c653d666c61742d737175617265266c6f676f3d676974687562266c6162656c3d636f646563657074696f6e)](https://github.com/dachcom-digital/pimcore-i18n/actions?query=workflow%3ACodeception+branch%3Amaster)[![PhpStan](https://camo.githubusercontent.com/20a44578dd8dd2b2ef83b50ef1a0dfe49b0b2110064a2fdd01908d684ad849a8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f64616368636f6d2d6469676974616c2f70696d636f72652d6931386e2f2e6769746875622f776f726b666c6f77732f7068702d7374616e2e796d6c3f6272616e63683d6d6173746572267374796c653d666c61742d737175617265266c6f676f3d676974687562266c6162656c3d7068707374616e2532306c6576656c25323034)](https://github.com/dachcom-digital/pimcore-i18n/actions?query=workflow%3A%22PHP+Stan%22+branch%3Amaster) [![i18n](https://user-images.githubusercontent.com/700119/27761666-f3ed6746-5e60-11e7-955a-3030453c68ff.jpg)](https://user-images.githubusercontent.com/700119/27761666-f3ed6746-5e60-11e7-955a-3030453c68ff.jpg) Scheme ------ [](#scheme) [![i18n scheme](https://user-images.githubusercontent.com/700119/141124503-59576527-e5b1-47b3-a38e-d06e51555bde.png)](https://user-images.githubusercontent.com/700119/141124503-59576527-e5b1-47b3-a38e-d06e51555bde.png) Introduction ------------ [](#introduction) Pimcore already comes with some great features to build internationalized websites. But there are some gaps we have to handle by ourselves: search engine guidelines, geo based redirects, dynamic link handling for internal documents and of course: full qualified URLs for and in every context. This bundle helps you to master this challenges and gives you the freedom to elaborate complex URL building and (country) based localization strategies. **Please read the [I18n overview page](./docs/1_I18n.md) before starting!** ### Release Plan [](#release-plan) ReleaseSupported Pimcore VersionsSupported Symfony VersionsRelease DateMaintainedBranch**5.x**`11.0``6.2`09.10.2023Feature Branchdev-master**4.x**`10.1` - `10.6``5.4`12.11.2021Unsupported4.x**3.x**`6.0` - `6.3`, `6.5` - `6.9``3.4`, `^4.4`18.07.2019Unsupported3.x**2.4**`5.4`, `5.5`, `5.6`, `5.7`, `5.8``3.4`24.05.2019Unsupported2.4### Installation [](#installation) ``` "require" : { "dachcom-digital/i18n" : "~5.1.0" } ``` Add Bundle to `bundles.php`: ``` return [ I18nBundle\I18nBundle::class => ['all' => true], ]; ``` - Execute: `$ bin/console pimcore:bundle:install I18nBundle` Upgrading --------- [](#upgrading) - Execute: `$ bin/console doctrine:migrations:migrate --prefix 'I18nBundle\Migrations'` Features -------- [](#features) - Generate fully qualified URLs in any context with symfony's default router - Geo redirects (read more about the redirector adapter [here](docs/51_RedirectorAdapter.md)) - Thanks to the hardlink element you can easily create copies of webpages with additional country information without adding and maintaining duplicate content - Manage [href-lang](docs/25_HrefLang.md) tags - Domain mapping (`domain.com`) and/or language slug (`/en`) strategies - [front page mapping](docs/30_FrontPageMapping.md) for hardlink trees ### Before you start [](#before-you-start) When using this bundle, you should: - **not** using any router but the default `RouterInterface` object. - **not** using `pimcore_url` or `$staticRoute->assemble()` but using the default `RouterInterface` instead - extend your `LinkGeneratorInterface` objects with the `I18nLinkGeneratorInterface` and adjust dem accordingly - **read** the [How I18nBundle works](./docs/1_I18n.md) section ### Preparation [](#preparation) - If you're using `system` as your `locale_adapter`, which is the default, you need to enable all required locales in pimcore system settings - Always be sure that every document translation is connected via the [localization tool](https://www.pimcore.org/docs/5.0.0/Multi_Language_i18n/Localize_your_Documents.html). - If you're using the country detection, you need a valid maxmind geo ip [data provider](docs/10_GeoControl.md) Further Information ------------------- [](#further-information) - [I18n Overview Page](./docs/1_I18n.md): Learn all about the i18n principals. - [Geo IP/Control](docs/10_GeoControl.md): Enable GeoIP Data Provider. - [Zone Definitions](docs/20_Zones.md): Learn more about i18n zone definitions and how to manage them. - [Custom I18n Context Look-Up](docs/21_I18nContext.md) (🔥 New!) - [Href-Lang](docs/25_HrefLang.md): Find out more about the href-lang tag generator. - [Language Configuration](docs/26_Languages.md): Configure languages. - [Country Configuration](docs/27_Countries.md): Configure countries. - Route and Alternate Links Generation - [Document Routes](docs/90_DocumentRoutes.md): Build document routes - [Static Routes](docs/91_StaticRoutes.md): Build translatable static routes and implement href-lang tags. - [Symfony Route](docs/92_SymfonyRoutes.md): Build translatable symfony routes and implement href-lang tags. - [Front Page Mapping](docs/30_FrontPageMapping.md): Learn how to map a custom front page. - [Localized Error Documents](docs/40_LocaleErrorDocument.md): Learn how to create localized error documents. - [Custom Locale Adapter](docs/50_CustomLocaleAdapter.md): Learn how to create a custom locale adapter. - [Redirector Adapter](docs/51_RedirectorAdapter.md): Learn more about redirector adapter and how to implement a custom one. - [Pimcore Redirects with I18n](docs/52_PimcoreRedirects.md): Learn how to create localized pimcore redirects. - [Code Examples](docs/60_CodeExamples.md): See some examples. - [Context Switch Event](docs/70_ContextSwitch.md): Detect zone/language/country switches. - [Canonical Links](docs/80_CanonicalLinks.md): Canonical links in hardlinks. - [Navigation Caching](docs/110_NavigationCaching.md): Cache your navigation right! - [Cookie Settings](docs/120_CookieSettings.md): Change Symfony default cookie settings. Upgrade Info ------------ [](#upgrade-info) Before updating, please [check our upgrade notes!](UPGRADE.md) License ------- [](#license) **DACHCOM.DIGITAL AG**, Löwenhofstrasse 15, 9424 Rheineck, Schweiz [dachcom.com](https://www.dachcom.com), Copyright © 2024 DACHCOM.DIGITAL. All rights reserved. For licensing details please visit [LICENSE.md](LICENSE.md) ### Health Score 57 — FairBetter than 98% of packages Maintenance68 Regular maintenance activity Popularity44 Moderate usage in the ecosystem Community24 Small or concentrated contributor base Maturity78 Established project with proven stability Bus Factor1 Top contributor holds 83% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~43 days Recently: every ~111 days Total 68 Last Release 252d ago Major Versions v4.1.9 → v5.0.02023-10-09 v4.1.10 → v5.0.32024-05-15 v4.1.11 → v5.0.42024-05-23 v4.1.12 → v5.0.52024-05-30 4.x-dev → v5.0.72024-06-20 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/700119?v=4)[Stefan Hagspiel](/maintainers/solverat)[@solverat](https://github.com/solverat) --- Top Contributors [![solverat](https://avatars.githubusercontent.com/u/700119?v=4)](https://github.com/solverat "solverat (224 commits)")[![pascalmoser](https://avatars.githubusercontent.com/u/7426193?v=4)](https://github.com/pascalmoser "pascalmoser (15 commits)")[![scrummer](https://avatars.githubusercontent.com/u/15173170?v=4)](https://github.com/scrummer "scrummer (12 commits)")[![benwalch](https://avatars.githubusercontent.com/u/7903333?v=4)](https://github.com/benwalch "benwalch (7 commits)")[![Zodiarc](https://avatars.githubusercontent.com/u/16105706?v=4)](https://github.com/Zodiarc "Zodiarc (4 commits)")[![aarongerig](https://avatars.githubusercontent.com/u/17384333?v=4)](https://github.com/aarongerig "aarongerig (1 commits)")[![mzweifel](https://avatars.githubusercontent.com/u/1950482?v=4)](https://github.com/mzweifel "mzweifel (1 commits)")[![tomhatzer](https://avatars.githubusercontent.com/u/3952168?v=4)](https://github.com/tomhatzer "tomhatzer (1 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")[![alexej-d](https://avatars.githubusercontent.com/u/3934198?v=4)](https://github.com/alexej-d "alexej-d (1 commits)")[![BlackbitDevs](https://avatars.githubusercontent.com/u/8749138?v=4)](https://github.com/BlackbitDevs "BlackbitDevs (1 commits)")[![dlhck](https://avatars.githubusercontent.com/u/24294584?v=4)](https://github.com/dlhck "dlhck (1 commits)")[![GALCF](https://avatars.githubusercontent.com/u/14803394?v=4)](https://github.com/GALCF "GALCF (1 commits)") --- Tags hreflangi18ninternationalizationpimcoreseolocalizationinternationalizationi18npimcore ### Code Quality TestsCodeception Static AnalysisPHPStan Code StyleECS Type Coverage Yes ### Embed Badge ![Health badge](/badges/dachcom-digital-i18n/health.svg) ``` [![Health](https://phpackages.com/badges/dachcom-digital-i18n/health.svg)](https://phpackages.com/packages/dachcom-digital-i18n) ``` ### Alternatives [symfony/intl Provides access to the localization data of the ICU library 2.6k199.8M1.1k](/packages/symfony-intl)[gettext/languages gettext languages with plural rules 7530.3M11](/packages/gettext-languages)[aplus/language Aplus Framework Language Library 2351.7M15](/packages/aplus-language)[punic/punic PHP-Unicode CLDR 1542.9M29](/packages/punic-punic)[aura/intl The Aura Intl package provides internationalization tools, specifically message translation. 898.3M4](/packages/aura-intl)[tractorcow/silverstripe-fluent Simple localisation for Silverstripe 92421.6k26](/packages/tractorcow-silverstripe-fluent) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)