# Tłumaczenia i wersje językowe

## Ustawienia

Miejsce z którego pobieramy tłumaczenia ogólne definiowane jest zmienną `envoirnment`, która możemy podać przy budowaniu/wystawianiu frontendu. W przypadku `environment` ustawionego jako `development` użyjemy lokalnych tłumaczeń, które są zawarte w projekcie apollo-frontend w folderze translations. Ember automatycznie przerzuci je do folderu `dist` przy budowaniu/wystawianiu serwera i z tamtad będzie je sobie pobierał.

W przypadku pozostałych środowisk (`test`, `production`) będziemy pobierać tłumaczenia z zewnętrznego źródla (cloudflare r2).

> url dla test: [https://translations-test.logintegra.eu/pl.json](<https://translations-test.logintegra.eu/pl.json>)
>
> url dla production: [https://translations.logintegra.eu/pl.json](<https://translations.logintegra.eu/pl.json>)
>
> dostępne języki pl/cs/de/en/es/it/tr

Lokalizacja tłumaczeń specyficznych dla pryncypała sterowana jest parametrem TRANSLATIONS\_URL (`Parameter#TRANSLATIONS_URL`)\`

## Tłumaczenia ogólne

Tłumaczenia ogólne są wspólne dla wszystkich klientów i muszą zawierać wszystkie klucze występujące w aplikacji. Pobierane są na stronie logowania.

## Tłumaczenia specyficzne dla pryncypała

Po zalogowaniu, do mapy użytkowika dodajemy tłumaczenia specyficzne dla danego pryncypała. Mapa ta jest keszowana w `USERS_ACCOUNT_SETTINGS_CACHE`. Możemy w nich zdefiniować dowolną ilość kluczy, w przypadku zgodności nazw kluczy z tłumaczeniami ogólnymi, tłumaczenia specyficzne nadpiszą tłumaczenia ogólne. Np.: Pryncypał `logintegra` posiada specyficzne tłumaczenie dla klucza `common.plan`:

```
teamcity@logintegra-dev:~$ cat translations/logintegra/pl.json 
{
    "common": {
        "plan": "Trololo"
    }
}
```

Dlatego zamiast Zaplanuj: ![Default label](<https://docs.logintegra.com/apollo-backend/static/Translations/common-plan.png>) Ma zmieniony label: ![Changed label](<https://docs.logintegra.com/apollo-backend/static/Translations/common-plan-changed.png>)

## Dodawanie nowych tłumaczeń

Tłumaczenia dostępne są w repozytorium na [bitbucket](<https://bitbucket.org/logintegraspzoo/translations/>): Rozdzielone są na 2 brancze: - test — dla tłumaczeń testowych ([https://translations-test.logintegra.eu](<https://translations-test.logintegra.eu>)) - prod — dla tłumaczeń produkcyjnych ([https://translations.logintegra.eu](<https://translations.logintegra.eu>))

Po dodaniu tłumaczenia należy wykonać skrypt znajdujący się na serwerze `logintegra-dev (151.115.54.238)`:

```
teamcity@logintegra-dev:~/translations$ ./update-translations.sh 
Podaj parametr test lub prod
np.: ./update-translations.sh test
teamcity@logintegra-dev:~/translations$ ./update-translations.sh test
Already on 'test'
Your branch is up to date with 'origin/test'.
Already up to date.
{
    "ETag": "\"86ec4ea2850d94534d160ef32017afde\"",
    "VersionId": "7e6b723231eb791f251d08fbec5c3f45"
}
{
    "ETag": "\"68f72869a28a50fa0a1690bc834dbd33\"",
    "VersionId": "7e6b72322eddcec0f4290f3dd8ab00cf"
}
{
    "ETag": "\"8c207f1120924e8b23668da63aa20fcb\"",
    "VersionId": "7e6b72322beb39ccb7b8c2f78257b420"
}
{
    "ETag": "\"32caca3fe8a55fcbbb496a0aa6d56fc1\"",
    "VersionId": "7e6b7232284c2d1213150d4e9f0b2910"
}
{
    "ETag": "\"64f075cc2226d69b485f52562eaa5d92\"",
    "VersionId": "7e6b723225c461233241c06c360ac918"
}
{
    "ETag": "\"0eed89500e99df4a51b1a76a7e4954f9\"",
    "VersionId": "7e6b723222f3c72f561125291d4c2d18"
}
{
    "ETag": "\"3e778662ea488f9cdc330e80d9366f48\"",
    "VersionId": "7e6b72321f708481185bce4505e1c367"
}
```

Docelowo skrypt będzie wykonywał się automatycznie po zmergowaniu zmian do odpowiednich branczy.

## Konfiguracja bucketów:

Buckety skonfigurowane są w r2 na cloudflare. Należy po zalogowaniu przenieść się do przestrzeni konta Kacpra:

![Cloudflare account](<https://docs.logintegra.com/apollo-backend/static/Translations/cloudflare-account.png>)

Następnie przejść do zakładki `R2 Object Storage`:

![Cloudflare account](<https://docs.logintegra.com/apollo-backend/static/Translations/cloudflare-r2.png>)
