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 and a dynamic link handling for internal documents. This Bundle helps you mastering this challenges and gives you the freedom to elaborate complex country based localization strategies.
| Release | Supported Pimcore Versions | Supported Symfony Versions | Release Date | Maintained | Branch |
|---|---|---|---|---|---|
| 3.x | 6.0 - 6.3, 6.5 |
3.4, ^4.0 |
18.07.2019 | Feature Branch | dev-master |
| 2.4 | 5.4, 5.5, 5.6, 5.7, 5.8 |
3.4 |
24.05.2019 | Bugfix only | 2.4 |
"require" : {
"dachcom-digital/i18n" : "~3.2.0"
}After you have installed the I18n Bundle via composer, open pimcore backend and go to Tools => Extension:
- Click the green
+Button inEnable / Disablerow - Click the green
+Button inInstall/Uninstallrow
After you have updated the I18n Bundle via composer, open pimcore backend and go to Tools => Extension:
- Click the green
+Button inUpdaterow
After you have updated the I18n Bundle via composer:
- Execute:
$ bin/console pimcore:bundle:update I18nBundle
Does actually the same as the update command and preferred in CI-Workflow:
- Execute:
$ bin/console pimcore:migrations:migrate -b I18nBundle
- Geo redirects (read more about the redirector adapter here)
- 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 tags
- Handle internal link redirects based on hardlink context
- Domain mapping (
domain.com) and/or language slug (/en) strategies - front page mapping for hardlink trees
- If you're using
systemas yourlocale_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.
- If you're using the country detection, you need a valid maxmind geoip data provider
- Geo IP/Control: Enable GeoIP Data Provider.
- Zones: Learn more about i18n zones and how to manage them.
- Href-Lang: Find out more about the href-lang tag generator.
- Language Configuration: Configure languages.
- Country Configuration: Configure countries.
- Static Routes: Configure translatable static routes and implement href-lang tags.
- Front Page Mapping: Learn how to map a custom front page.
- Localized Error Documents: Learn how to create localized error documents.
- Custom Locale Adapter: Learn how to create a custom locale adapter.
- Redirector Adapter: Learn more about redirector adapter and how to implement a custom one.
- Pimcore Redirects with I18n: Learn how to create localized pimcore redirects.
- Code Examples: See some examples.
- Context Switch Event: Detect zone/language/country switches.
- Canonical Links: Canonical links in hardlinks.
- Internal Links: Rewrite Internal links.
- Navigation Caching: Cache your navigation right!
There is already an i18n plugin for pimcore4 which is not public. With Pimcore5 we decided to move this project to a public github repository. You're welcome. :)
Copyright: DACHCOM.DIGITAL
For licensing details please visit LICENSE.md
Before updating, please check our upgrade notes!