Translate

This bolt.cm extension handles translation of content within bolt. It is recommended to be used in combination with the Labels extension.

Warning: the old (Bolt 3.0) versions of this extension are not compatible with the Bolt 3.1+ version

Installation

Login to your Bolt installation
Go to "Extend" or "Extras > Extend"
Type translate into the input field
Click on the extension name
Click on "Browse Versions"
Click on "Install This Version" on the latest stable version

Configuration

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
```

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
[...]

Add the is_translateable argument to all fields you want to be translatable. To translate templatefields you simply tag the templateselect with is_translateable and all the templatefields will be translateable.
```
[...]
title:
    type: text
    class: large
    group: content
    is_translateable: true
[...]
```
Add the hidden fields to all the contenttypes that have translateable fields, two for each locale: one called your_localedata and one called your_localeslug. So for the above locales example your would put:
```
[...]
dedata:
    type: hidden
deslug:
    type: hidden
    index: true
endata:
    type: hidden
enslug:
    type: hidden
    index: true
[...]
```
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') }}
(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") }}.
(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.

Extras/Info

Localeswitcher in menu

If you want to include the localeswitcher in your menu you can edit the _sub_menu.twig file and add the following right before the closing <ul>:

<li>Language
    {{ localeswitcher(classes = 'menu submenu vertical') }}

Localeswitcher anywhere/anyhow

If you want to output the localeswitcher (or some part of it) anywhere you have access to an array called locales in basically any template that you use. Using this you can craft basically any locale selector you want, see #30 for more info. To see the structure please dump it by using {{ dump(locales) }}. The array locales can be ordered based on the active locale by using the |order() filter, like this: {% for locale in locales|order('-active') %}.

Overrides

This extension overrides Bolt in a few different places and sometimes you want to revert some of it back to it's default state. You can disable the overrides for routing, menus and slug handling in the config.

About

Started by ANIMAL, finished/ported to Bolt 3 by SahAssar

License

This Bolt extension is open-sourced software licensed under the MIT License.

lswest/bolt-translate