Jazyky a mutace
Jak Revelor obsluhuje vícejazyčný e-shop — jazykové mutace, co všechno se překládá a jak přidat další jazyk.
Prodáváte-li do více zemí, musí vyhledávač mluvit stejným jazykem jako zbytek e-shopu — včetně názvů kategorií a adres, na které odkazuje. Revelor to řeší jazykovými mutacemi: jeden e-shop, jedna instalace, ale každá jazyková verze má vlastní data a vlastní nastavení.
Jak to funguje
E-shop běží v Revelor jako jedna instance se základní jazykovou verzí (typicky češtinou) a jednou mutací pro každý další jazyk. Mutace vznikne jako kopie základního nastavení, do které se doplní to, co je pro daný jazyk odlišné — především produktový feed dané jazykové verze a základní adresa storefrontu v tomto jazyce.
Na straně e-shopu není potřeba samostatná doména. Jazykové verze Shoptetu obvykle žijí na jedné doméně s jazykovým prefixem v adrese (/de/, /en/, …) a vyhledávací widget se na každé z nich inicializuje s identifikátorem příslušné jazykové mutace. Revelor tak ví, ze kterých dat má čerpat a v jakém jazyce má odpovídat.
Mechanismus není vázaný na konkrétní jazyky — mutace se zakládá pro každý jazyk, který má e-shop ve Shoptetu vyplněný. Když je v jazykových datech některé pole prázdné, Revelor sáhne po základní jazykové verzi, takže výsledek nikdy nezůstane prázdný.
Připravené jazyky rozhraní
Texty vyhledávače — placeholder, popisky, hlášky o počtu výsledků — jsou připravené ve 13 jazycích: čeština, slovenština, angličtina, němčina, polština, maďarština, rumunština, bulharština, francouzština, italština, španělština, chorvatština a vietnamština. V ostrém provozu dnes Revelor běží v šesti z nich: česky, slovensky, německy, maďarsky, chorvatsky a rumunsky. Další jazyk rozhraní tedy zpravidla nečeká na překlad — stačí založit mutaci.
Co je v mutaci vlastní
| Oblast | Jak je řešená |
|---|---|
| Produkty | Z produktového feedu dané jazykové verze — názvy, popisy i názvy kategorií v drobečkové navigaci přicházejí přeložené |
| Kategorie | Z vícejazyčného exportu kategorií — pro každý jazyk vlastní název, vlastní URL slug, texty a meta údaje |
| Odkazy na výsledkové stránky | Adresy kategorií i produktů se skládají nad základní adresou dané jazykové mutace, takže návštěvník zůstává ve své jazykové verzi |
| Texty vyhledávače | Placeholder ve vyhledávacím poli a další texty rozhraní se nastavují zvlášť pro každou mutaci |
| Nadpisy doporučovacích bloků | Vracejí se v jazyce dané mutace |
| Měna a kurz | Každá mutace má vlastní nastavení měny včetně přepočítacího kurzu |
| Analytika | Každá zaznamenaná událost nese jazyk (kód podle ISO 639-1), takže přehledy jdou filtrovat po jazycích |
Rozhraní pro doporučování navíc přijímá parametr jazyka, takže i integrace na míru může vyžádat výstup v konkrétní jazykové variantě.
Kategorie: proč vícejazyčný export
Standardní XML export kategorií ze Shoptetu jazykové varianty nerozlišuje — pro všechny jazyky vrací stejná data. Proto se pro vícejazyčný e-shop napojuje CSV export kategorií se všemi jazyky, který má pro každý jazyk vlastní sloupce: název, URL slug, text odkazu, popis i meta údaje.
Ten samý export obslouží všechny jazykové mutace najednou — Revelor si z něj vybere sloupce odpovídající jazyku mutace. Díky tomu má vyhledávač k dispozici i skutečné lokalizované slugy, ne jen přeložené názvy: odkaz na kategorii v cizojazyčné verzi vede na její vlastní adresu, ne na českou.
Jak přidat další jazyk
- Připravte jazyk ve Shoptetu — jazyková verze musí mít vyplněné názvy produktů a kategorií a fungující produktový feed.
- Založíme jazykovou mutaci — vytvoří se jako kopie základního nastavení e-shopu, aby si nesla stejná pravidla vyhledávání, synonyma a konfiguraci funkcí.
- Napojíme feedy — produktový feed dané jazykové verze a vícejazyčný CSV export kategorií.
- Nastavíme základní adresu storefrontu pro tento jazyk, aby odkazy ve výsledcích mířily do správné jazykové verze.
- Doplníme měnu a kurz pro danou mutaci a ověříme je proti reálným cenám v e-shopu.
- Přeložíme texty rozhraní — placeholder ve vyhledávacím poli a další viditelné řetězce.
- Přeindexujeme a ověříme — kontrolní vyhledávání v nové mutaci musí vrátit lokalizované kategorie, správné odkazy i ceny ve správné měně.
Zprovoznění další jazykové mutace je otázkou konfigurace, ne vývoje — do šablony e-shopu se přidává jen inicializace widgetu s identifikátorem dané mutace.
Na co si dát pozor
- Kvalita překladu dat rozhoduje o kvalitě vyhledávání. Pokud jazyková verze nemá vyplněné názvy kategorií nebo produktů, Revelor použije základní jazyk — vyhledávání bude fungovat, ale výsledky nebudou lokalizované.
- Synonyma jsou jazykové. Každá mutace potřebuje vlastní sadu synonym a přepisů; česká synonyma v cizojazyčné mutaci relevanci nepomohou.
- Kurz měny nastavujte podle skutečnosti. Odhadnutý kurz se v e-shopu projeví jako drobný, ale nápadný rozdíl proti cenám na produktových stránkách.