Configuration

1. Modify the locales block in the extension configuration (which you can find under the Extend screen in bolt's backend) to suit your needs. The first one is the default locale and must be the same as bolts own locale which you've set in bolts' main config.yml:

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

2. Add the locale field to the contenttypes you want translated in contenttypes.yml:

pages:
    name: Pages
    slug: pages
    singular_name: Page
    singular_slug: page
    fields:
        locale:
            type: locale
            group: content
[...]

3. Add the translatable argument to all fields you want to be translatable.

   Note: In older versions the config translatable was misspelled as is_translateable. The old way is still supported, but deprecated and will be removed in a future version.

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

To translate templatefields you simply tag the templateselect
with `translatable` and all the templatefields will be translatable.

[...]
templateselect:
    type: templateselect
    translatable: true
    filter: '*.twig'
[...]

4. Add the hidden fields to all the contenttypes that have translatable fields, two for each locale: one called your_localedata and one called your_localeslug. So for the above locales example you would put:

fields:
[...]
    dedata:
        type: hidden
    deslug:
        type: locale_data
        index: true
    endata:
        type: hidden
    enslug:
        type: locale_data
        index: true
[...]

5. Use the localeswitcher twig-function to render a locale switcher in your theme: {{ localeswitcher() }} or {{ localeswitcher(template = '_my_localeswitcher_template.twig') }} if you want to use a custom template. The base template being used is '_localeswitcher.twig'.

   The {{ localeswitcher }} function generates an unordered list with the labels of the languages you've set in the config file.

   If you only want to a custom class to the unordered list don't make a custom template. Adding a class is as simple as:

   {{ localeswitcher(classes = 'custom-class another-class') }}

6. (Optional) 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") }}.

7. (Optional) Translate your Boltforms by switching {% form_theme form 'boltforms_custom.twig' %} to {% form_theme form '@bolt/frontend/boltforms_theme_translated.twig' %} at the top of a form template. This requires the Labels extension.

8. (Optional) Translate your menu labels by chaning {{ menu(template = 'partials/_sub_menu.twig') }} to {{ menu(template = '@bolt/frontend/_sub_menu_translated.twig') }} in your template. You can then have locale specific menu labels by adding them like this:

main:
    - label: Home
        delabel: Startseite
        title: This is the first menu item.
        detitle: Dies ist der erste Menüpunkt.
        path: homepage
        class: first
    - label: Second item
        delabel: Zweite Position
        path: entry/1
[...]

If no title/label is set for the current locale it will use the unprefixed ones.