dachcom-digital / i18n
Pimcore I18n Manager.
Installs: 72 695
Dependents: 0
Suggesters: 0
Security: 0
Stars: 28
Watchers: 14
Forks: 18
Open Issues: 8
Type:pimcore-bundle
Requires
- geoip2/geoip2: ^2.0
- pimcore/pimcore: ^11.0
- symfony/intl: ^6.2
Requires (Dev)
- dev-master
- v5.0.7
- v5.0.6
- v5.0.5
- v5.0.4
- v5.0.3
- v5.0.2
- v5.0.1
- v5.0.0
- 4.x-dev
- v4.1.13
- v4.1.12
- v4.1.11
- v4.1.10
- v4.1.9
- v4.1.8
- v4.1.7
- v4.1.6
- v4.1.5
- v4.1.4
- v4.1.3
- v4.1.2
- v4.1.1
- v4.1.0
- v4.0.6
- v4.0.5
- v4.0.4
- v4.0.3
- v4.0.2
- v4.0.1
- v4.0.0
- 3.x-dev
- v3.2.10
- v3.2.9
- v3.2.8
- v3.2.7
- v3.2.6
- v3.2.5
- v3.2.4
- v3.2.3
- v3.2.2
- v3.2.1
- v3.2.0
- v3.1.1
- v3.1.0
- v3.0.1
- v3.0.0
- 2.4.x-dev
- v2.4.2
- v2.4.1
- v2.4.0
- v2.3.2
- v2.3.1
- v2.3.0
- v2.2.3
- v2.2.2
- v2.2.1
- v2.2.0
- v2.1.4
- v2.1.3
- v2.1.2
- v2.1.1
- v2.1.0
- v2.0.1
- v2.0.0
- dev-php83_fixes
This package is auto-updated.
Last update: 2024-10-30 14:42:56 UTC
README
Scheme
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 read the I18n overview page before starting!
Release Plan
Installation
"require" : { "dachcom-digital/i18n" : "~5.0.0" }
Add Bundle to bundles.php
:
return [ I18nBundle\I18nBundle::class => ['all' => true], ];
- Execute:
$ bin/console pimcore:bundle:install I18nBundle
Upgrading
- Execute:
$ bin/console doctrine:migrations:migrate --prefix 'I18nBundle\Migrations'
Features
- Generate fully qualified URLs in any context with symfony's default router
- 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
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 defaultRouterInterface
instead - extend your
LinkGeneratorInterface
objects with theI18nLinkGeneratorInterface
and adjust dem accordingly - read the How I18nBundle works section
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 geo ip data provider
Further Information
- I18n Overview Page: Learn all about the i18n principals.
- Geo IP/Control: Enable GeoIP Data Provider.
- Zone Definitions: Learn more about i18n zone definitions and how to manage them.
- Custom I18n Context Look-Up] (🔥 New!)
- Href-Lang: Find out more about the href-lang tag generator.
- Language Configuration: Configure languages.
- Country Configuration: Configure countries.
- Route and Alternate Links Generation
- Document Routes: Build document routes
- Static Routes: Build translatable static routes and implement href-lang tags.
- Symfony Route: Build translatable symfony 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!
- Cookie Settings: Change Symfony default cookie settings.
Copyright and License
Copyright: DACHCOM.DIGITAL
For licensing details please visit LICENSE.md
Upgrade Info
Before updating, please check our upgrade notes!