florian25686 / pimcore-i18n

Pimcore - i18n Manager

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 in Enable / Disable row
• Click the green + Button in Install/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 in Update 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
• Domain mapping (domain.com) and/or language slug (/en) strategies
• front page mapping for hardlink trees

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.
• 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.
• 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!