dachcom-digital / Pimcore I18n
Projects that are alternatives of or similar to Pimcore I18n
Pimcore - i18n Manager
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 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 Plan
Release | Supported Pimcore Versions | Supported Symfony Versions | Release Date | Maintained | Branch |
---|---|---|---|---|---|
3.x |
6.0 - 6.3 , 6.5 - 6.8
|
3.4 , ^4.4
|
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 |
Installation
"require" : {
"dachcom-digital/i18n" : "~3.2.0"
}
Installation via Extension Manager
After you have installed the I18n Bundle via composer, open pimcore backend and go to Tools
=> Extension
:
- Click the green
+
Button inEnable / Disable
row - Click the green
+
Button inInstall/Uninstall
row
Upgrading
Upgrading via Extension Manager
After you have updated the I18n Bundle via composer, open pimcore backend and go to Tools
=> Extension
:
- Click the green
+
Button inUpdate
row
Upgrading via CommandLine
After you have updated the I18n Bundle via composer:
- Execute:
$ bin/console pimcore:bundle:update I18nBundle
Migrate via CommandLine
Does actually the same as the update command and preferred in CI-Workflow:
- Execute:
$ bin/console pimcore:migrations:migrate -b I18nBundle
Features
- 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
Preparation
- If you're using
system
as 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
Further Information
- 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!
Why is there no Version 1?
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 and License
Copyright: DACHCOM.DIGITAL
For licensing details please visit LICENSE.md
Upgrade Info
Before updating, please check our upgrade notes!