Języki widżetu internetowego — 50 out of the box.

Przegląd — co oznacza „obsługiwane”

Język jest udostępniany w widżecie internetowym, gdy każdy tekst widoczny dla użytkownika w interfejsie czatu ma tłumaczenie sprawdzone przez native speakera. Obejmuje to tekst zastępczy w polu wiadomości, podpowiedź przycisku wysyłania, banery stanu połączenia, przyciski szybkich odpowiedzi i wszystkie komunikaty o błędach. Jeśli danego tekstu nie można przetłumaczyć za pomocą bezpośredniego odpowiednika (np. idiomu lub sformułowania specyficznego kulturowo), podczas weryfikacji powstaje wersja odpowiednia dla danego języka zamiast użycia tekstu angielskiego.

Lista na tej stronie jest rzeczywistą tabelą środowiska wykonawczego — moduł ładujący widżet zawiera te kody i pobiera pasujący pakiet przy pierwszym wyświetleniu.

Zakres w skrócie

Jak wykrywany jest język odwiedzającego

Wykrywanie jest uruchamiane jednokrotnie podczas montowania widżetu i wybiera pierwsze dopasowanie w następującej kolejności:

1. Jawne nadpisanie. Jeśli Twoja strona ustawia window.Knocket.locale = 'ja' przed załadowaniem widżetu — to ustawienie ma pierwszeństwo. Zobacz Nadpisanie w kodzie.
2. Atrybut HTML lang. Jeśli obecny jest kod <html lang="fr">, widżet dostosuje się do niego. To najprostsze rozwiązanie dla witryn wielojęzycznych — ustawiaj go po stronie serwera dla każdej strony.
3. Ustawienia regionalne przeglądarki. W razie potrzeby używana jest wartość navigator.languages[0]. Warianty regionalne są sprowadzane do języka bazowego (np. pt-BR → pt).
4. Angielski. Jeśli żaden z powyższych języków nie odpowiada dostępnemu pakietowi, widżet pozostaje w języku angielskim, zamiast wyświetlać częściowo przetłumaczoną wersję.

Pełna lista — 50 languages

Uszeregowane według liczby użytkowników języka na świecie. Każdy wiersz oznacza dostępny pakiet językowy, a kolumna z kodem zawiera dokładny ciąg znaków wymagany przez widżet.

Zastąp w kodzie

Jeśli znasz już preferowany język odwiedzającego (ze stanu aplikacji, ustawień konta lub parametru URL), przekaż go widżetowi bezpośrednio:

<script src="https://knocket.live/knocket-sdk/sdk.js?identifier=YOUR_IDENTIFIER" async></script>

Lub po zamontowaniu widżetu zmień go na żywo:

Knocket('setLocale', 'zh-Hans');

Widżet ponownie renderuje każdy ciąg tekstowy, zmienia kierunek dla języków RTL i zachowuje bieżącą rozmowę.

Zachowanie awaryjne

Warto zwrócić uwagę na dwa przypadki brzegowe:

• Nieobsługiwana wersja językowa. Jeśli przekażesz nieznany kod (np. xx lub rzadki wariant regionalny), widżet po cichu przełączy się na język angielski i zgłosi brak w analityce konsoli.
• Regionalny język zastępczy. Jeśli pakiet regionalny nie jest dostępny, kod regionalny zostaje sprowadzony do języka bazowego. pt-BR → pt, en-GB → en. Chiński uproszczony i tradycyjny mają osobne pakiety (zh-Hans i zh-Hant) — nie traktuj ich jako aliasów.