Translation plugin for Bolt CMS

This plugin handles translation of content within bolt. It is recomended to be used in combination with the labels extension.

Setup

1. Add the locales block to the main configuration with your locales, the first one is the default locale and must be the same as bolts own locale:

   locales:
       en_GB:
           label: English
           slug: en
       de_AT:
           label: Deutsch
           slug: de
   

2. Do a database update.

3. Set your contenttype to use the LocalizedContent class and add the locale field in contenttypes.yml:

   pages:
       name: Pages
       slug: pages
       singular_name: Page
       singular_slug: page
       class: \Bolt\Extension\Animal\Translate\Content\LocalizedContent
       fields:
           locale:
               type: locale
               group: content
   [...]
   

4. Add the isTranslatable argument to all fields you want to be translatable:

   [...]
   title:
       type: text
       class: large
       group: content
       isTranslatable: true
   [...]
   

5. Setup routing in routing.yml like below but replacing en with your preferred default locale, a full example is at the bottom of this file:

   contentlink:
       path: '/{_locale}/{contenttypeslug}/{slug}'
       defaults:
           _locale: en
           _controller: 'Bolt\Extension\Animal\Translate\Frontend\LocalizedFrontend::record'
       requirements:
           contenttypeslug: 'Bolt\Controllers\Routing::getAnyContentTypeRequirement'
           _locale: "^[a-zA-Z_]{2,5}$"
   

6. Use the localeswitcher twig-function to render a locale switcher in your theme: {{ localeswitcher()|raw }} or {{ localeswitcher('_my_localeswitcher_template.twig')|raw }}

7. Activate/install the labels extension, set your languages in it's config and mark any hardcoded text in your templates with {{l("Your text here")}}.

8. Translate your boltforms by adding {% set form = translate_form(form) %} at the top of a form template. This requires the labels extension. (the current solution is very hacky, WIP)

9. If you use the menueditor extension it will automatically add fields for translated labels, use these by adding {{ item[app.request.get('_locale')~'label'] ?: item.label|default('-') }} in your menu template.

Links

• https://docs.bolt.cm/howto/building-multilingual-websites
• bolt/bolt#513
• bolt/bolt#234
• bolt/bolt#2484
• bolt/bolt#3933
• https://vivait.co.uk/labs/updating-entities-when-an-insert-has-a-duplicate-key-in-doctrine
• https://dev.mysql.com/doc/refman/5.0/en/insert-on-duplicate.html
• http://stackoverflow.com/questions/1132571/implementing-update-if-exists-in-doctrine-orm

About

Started by ANIMAL, finished by SahAssar (see commit history)

Full routing example:

homepageredir:
    path: '/'
    defaults:
        _controller: 'Bolt\Extension\Animal\Translate\Frontend\LocalizedFrontend::homepageRedirect'

homepage:
    path: '/{_locale}'
    defaults:
        _locale: en
        _controller: 'Bolt\Extension\Animal\Translate\Frontend\LocalizedFrontend::homepage'
    requirements:
        _locale: "^[a-zA-Z_]{2,5}$"

# The next two routes are for when you use the sitemap extension

sitemapxml_with_locale:
    path: /{_locale}/sitemap.xml
    defaults:
        _locale: en
        _controller: 'Bolt\Extension\Bolt\Sitemap\Extension::sitemapXml'
    requirements:
        _locale: "^[a-zA-Z_]{2,5}$"

sitemaphtml_with_locale:
    path: /{_locale}/sitemap
    defaults:
        _locale: en
        _controller: 'Bolt\Extension\Bolt\Sitemap\Extension::sitemap'
    requirements:
        _locale: "^[a-zA-Z_]{2,5}$"

search:
    path: '/{_locale}/search'
    defaults:
        _locale: en
        _controller: 'Bolt\Extension\Animal\Translate\Frontend\LocalizedFrontend::search'
    requirements:
        _locale: "^[a-zA-Z_]{2,5}$"

preview:
    path: '/{_locale}/preview/{contenttypeslug}'
    defaults:
        _locale: en
        _controller: 'Bolt\Extension\Animal\Translate\Frontend\LocalizedFrontend::preview'
    requirements:
        contenttypeslug: 'Bolt\Controllers\Routing::getAnyContentTypeRequirement'
        _locale: "^[a-zA-Z_]{2,5}$"

contentlink:
    path: '/{_locale}/{contenttypeslug}/{slug}'
    defaults:
        _locale: en
        _controller: 'Bolt\Extension\Animal\Translate\Frontend\LocalizedFrontend::record'
    requirements:
        contenttypeslug: 'Bolt\Controllers\Routing::getAnyContentTypeRequirement'
        _locale: "^[a-zA-Z_]{2,5}$"

taxonomylink:
    path: '/{_locale}/{taxonomytype}/{slug}'
    defaults:
        _locale: en
        _controller: 'Bolt\Extension\Animal\Translate\Frontend\LocalizedFrontend::taxonomy'
    requirements:
        taxonomytype: 'Bolt\Controllers\Routing::getAnyTaxonomyTypeRequirement'
        _locale: "^[a-zA-Z_]{2,5}$"

contentlisting:
    path: '/{_locale}/{contenttypeslug}'
    defaults:
        _locale: en
        _controller: 'Bolt\Extension\Animal\Translate\Frontend\LocalizedFrontend::listing'
    requirements:
        contenttypeslug: 'Bolt\Controllers\Routing::getPluralContentTypeRequirement'
        _locale: "^[a-zA-Z_]{2,5}$"

pagebinding:
    path: '/{_locale}/{slug}'
    defaults:
        _locale: en
        _controller: 'Bolt\Extension\Animal\Translate\Frontend\LocalizedFrontend::record'
        contenttypeslug: 'sida'
    contenttype: sidor
    requirements:
        _locale: "^[a-zA-Z_]{2,5}$"