Texty a jazyky

Widget mluví německy, anglicky a polsky. Každý z jeho přibližně 200 textů lze nahradit: v účtu pro všechny stránky nebo v kódu pro jednotlivé stránky.

Jak widget vybírá jazyk

Widget je součástí vaší stránky. To, co návštěvník právě čte, má proto větší váhu než nastavení prohlížeče. Pořadí:

1. Jazyk, který vaše stránka zvolila pro návštěvníka pomocí ReactiveChat('setLocale', …) (viz níže).
2. Pevně nastavený jazyk ve vkládacím kódu (data-rc-locale) nebo v konfiguraci.
3. Jinak jazyk vaší stránky z <html lang="…">.
4. Jinak výchozí jazyk z vašeho účtu.
5. Jinak jazyk prohlížeče a nakonec angličtina.

Regionální kódy se zkracují: z de-AT se stane de. Jazyk, který widget nezná, se změní na angličtinu.

Nejdůležitější je tedy správné <html lang> na vašich stránkách. Widget pak sám následuje každou jazykovou verzi vašeho webu.

Výchozí jazyk v účtu

Na adrese /app/projects/{id} na kartě Instalace, oddíl Základní údaje, vyberete Výchozí jazyk: de, en nebo pl. Má dvě úlohy:

• Platí pro návštěvníky na stránkách bez <html lang>, pokud vkládací kód neurčuje jazyk.
• Je to jazyk, ve kterém píšete vlastní znění, úvodní obrazovku a reklamní kartu (viz níže).

Nastavení jazyka v kódu

Pevně pro jednu stránku ve vkládacím kódu:

<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-locale="pl"
        async></script>

Za běhu, například z vašeho přepínače jazyků:

ReactiveChat('setLocale', 'en');

setLocale okamžitě změní texty widgetu. Widget si volbu v prohlížeči návštěvníka pamatuje rok a má pak přednost před data-rc-locale i na dalších stránkách. V samotném widgetu výběr jazyka není. Pokud si návštěvníci mají vybírat, volejte setLocale ze svého přepínače.

Vlastní znění v účtu

Na kartě Texty a formuláře, oddíl Vlastní znění, jsou všechny texty widgetu uvedené s klíčem, seskupené podle oblastí a sbalené. Náš text je v poli zobrazený šedě. Co zadáte, ho nahradí. Nadpis ukazuje, kolik vlastních textů už máte.

• Nejvýše 400 znaků na text.
• Prázdné znamená náš text.
• Text přesně stejný jako náš se neukládá.
• Widget doplňuje zástupné symboly ve složených závorkách, například {n}, {name} nebo {time}. Pokud chcete hodnotu zobrazit, ponechte je v textu.

Důležité k jazyku: texty zadáváte ve výchozím jazyce projektu a v něm se uplatní. Návštěvníci, jejichž widget běží v jiném jazyce, tam nadále vidí námi dodané texty. Pro vlastní texty v dalších jazycích použijte kód (níže), ideálně na stránkách příslušné jazykové verze.

Změny se k návštěvníkům dostanou do minuty.

Nejdůležitější klíče

Výběr podle oblastí:

• launcher.text, launcher.subtext – popisek a druhý řádek tlačítka chatu. Ve výchozím stavu prázdné; zadání má přednost před poli v části Vzhled → Značka.
• launcher.label – popisek tlačítka chatu čtený čtečkami obrazovky („Otevřít chat“).
• header.title, header.subtitle_online, header.subtitle_bot, header.response_time – nadpis a druhé řádky v záhlaví.
• home.greeting, home.sub, home.start, home.start_sub – pozdrav a vstupní bod na úvodní obrazovce (pozdrav snáze nastavíte v části Úvodní obrazovka).
• tabs.home, tabs.messages, tabs.help – karty.
• input.placeholder a další input.* – vstupní pole.
• offline.* – formulář „Zanechte zprávu“.
• prechat.* – formulář před chatem.
• bh.* – upozornění na provozní dobu.
• ds.* a daten.* – souhlas a datová karta „Vaše data“.
• msg.ki_notice – upozornění před první odpovědí asistenta AI.
• csat.* – hodnocení po konverzaci.
• transcript.*, upload.*, handoff.*, queue.*, teaser.*, err.* – přepis e-mailem, přílohy, předání týmu, fronta, tooltipová bublina a chybové zprávy.

Úplný seznam vidíte v účtu.

Upozornění „Powered by reactive.chat“ (viz Okno chatu) a texty prohlídek produktu (viz Prohlídky produktu) nelze měnit přes texty.

Nahrazení textů v kódu

Ve vkládacím kódu pomocí data-rc-strings jako JSON s klíči v tečkové notaci:

<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-locale="en"
        data-rc-strings='{"input.placeholder":"Your question about your order …","header.title":"Customer service"}'
        async></script>

Nebo v konfiguraci:

ReactiveChat('boot', {
  strings: { 'input.placeholder': 'Your question about your order …' }
});

Druhé volání boot na stejné stránce načte nové strings. Tak můžete změnit texty například po přihlášení.

Texty nastavené v kódu platí stejně ve všech jazycích. Nastavujte je proto na stránkách s pevným jazykem a nastavte tam také jazyk.

Pořadí přednosti, od nejsilnější po nejslabší:

1. Texty v kódu (strings) – platí pouze pro stránku, na které jsou.
2. Vlastní znění z účtu ve výchozím jazyce.
3. Námi dodané texty v jazyce návštěvníka.
4. Angličtina.

Kód má přednost záměrně: pokud chcete jinak pojmenovat něco na jediné stránce, uděláte to tam, aniž změníte nastavení pro všechny ostatní stránky.

Další texty jinde

Některé texty mají vlastní pole, často pro každý jazyk:

• Pozdrav, dlaždice a úvodní obrazovka: Úvodní obrazovka chatu
• Věta nad formulářem před chatem (pro každý jazyk): Dostupnost, formuláře a servis
• Věta souhlasu a odkaz na zásady ochrany osobních údajů (pro každý jazyk): Ochrana soukromí a souhlas
• Texty tooltipů a proaktivních zpráv: Proaktivní zprávy
• Jméno a tón asistenta AI: Asistent AI
• Reklamní karta, v kódu i pro jednotlivé jazyky: Reklamní karta v chatu