Docs · Integrations · i18n
Documentation
Référence rapide multilingue : sélection de langue, stockage des textes, export/mise à jour des traductions.
Set I18N_EXPORT_TOKEN to enable export in production.
Contents
Navigate through the core topics.
Quickstart
Add the widget to your site and start receiving conversations in one place.
1) Add script
Place this snippet before </head>. Replace YOUR_PUBLIC_KEY.
<script>
(function(w,d){
w.Tallker=w.Tallker||function(){(w.Tallker.q=w.Tallker.q||[]).push(arguments)};
var s=d.createElement('script'); s.async=1; s.src='https://tallker.com/widget.js';
d.head.appendChild(s);
})(window,document);
Tallker('init',{ key:'YOUR_PUBLIC_KEY' });
</script>2) Verify
Open your site, send a test message, and confirm it appears in Tallker inbox.
Détection de la langue
Priorité : paramètre URL lang → cookie lang → en-tête Accept-Language → ru.
Strategy
- User choice is sticky (cookie for 180 days).
- Country mapping is optional (tk_country_lang).
- Accept-Language is a safe fallback for first visit.
Translation read
Load default language first and override with selected language.
$tr = load_translations($pdo, $lang, $defaultLang);
$t = fn($key,$fb='') => $tr[$key] ?? ($fb ?: $key);
echo $t('docs_h1','Documentation');Clés de traduction
Les clés de cette page utilisent le préfixe docs_. Gardez les clés stables pour des mises à jour sûres.
Export & import
L’export génère un dump SQL depuis tk_translations pour le périmètre choisi (docs ou all).
Import
Use mysql client. Run in a transaction to keep consistency.
# import example
mysql -uUSER -p DBNAME < tk_translations.sqlExport
Production export should be protected with I18N_EXPORT_TOKEN.
# export (debug=1 OR token)
GET https://tallker.com/docs?export=sql&scope=docs&lang=ru&debug=1
GET https://tallker.com/docs?export=sql&scope=all&lang=en&token=YOUR_TOKENExemple PHP
Minimum : détecter la langue, charger les traductions en une requête, résoudre via t('key').
<?php
$lang = $_GET['lang'] ?? 'ru';
$st = $pdo->prepare('SELECT tkey,tvalue FROM tk_translations WHERE lang=:lang');
$st->execute([':lang' => $lang]);
$bag = $st->fetchAll(PDO::FETCH_KEY_PAIR);
function t(array $bag, string $key, string $fallback=''): string {
return (isset($bag[$key]) && $bag[$key] !== '') ? $bag[$key] : ($fallback !== '' ? $fallback : $key);
}
echo t($bag,'docs_h1','Docs');
?>Textes en base
Ci-dessous : lignes pour le périmètre et la langue sélectionnés. Recherche par clé disponible.
| Clé | Valeur | Updated |
|---|---|---|
| Appliquer | 2026-02-01 22:24:02 | |
| Exporter SQL | 2026-02-01 22:24:02 | |
| Minimum : détecter la langue, charger les traductions en une requête, résoudre via t('key'). | 2026-02-01 22:24:02 | |
| Exemple PHP | 2026-02-01 22:24:02 | |
| L’export génère un dump SQL depuis tk_translations pour le périmètre choisi (docs ou all). | 2026-02-01 22:24:02 | |
| En production, définissez I18N_EXPORT_TOKEN et passez token dans l’URL. | 2026-02-01 22:24:02 | |
| Export & import | 2026-02-01 22:24:02 | |
| Documentation | 2026-02-01 22:24:02 | |
| Priorité : paramètre URL lang → cookie lang → en-tête Accept-Language → ru. | 2026-02-01 22:24:02 | |
| Langues supportées par défaut : ru, en, de, fr, es, tr. | 2026-02-01 22:24:02 | |
| Détection de la langue | 2026-02-01 22:24:02 | |
| Les clés de cette page utilisent le préfixe docs_. Gardez les clés stables pour des mises à jour sûres. | 2026-02-01 22:24:02 | |
| Conseil : encodez l’intention dans la clé (ex. docs_btn_export, docs_overview_p1). | 2026-02-01 22:24:02 | |
| Clés de traduction | 2026-02-01 22:24:02 | |
| Langue | 2026-02-01 22:24:02 | |
| Référence rapide multilingue : sélection de langue, stockage des textes, export/mise à jour des traductions. | 2026-02-01 22:24:02 | |
| Documentation du système de traductions Tallker : clés, détection de langue, export/import. | 2026-02-01 22:24:02 | |
| Documentation — Tallker | 2026-02-01 22:24:02 | |
| Les textes sont stockés dans la table tk_translations (lang, tkey, tvalue). | 2026-02-01 22:24:02 | |
| La page /docs utilise un fallback : langue choisie → EN → RU, pour éviter les champs vides. | 2026-02-01 22:24:02 | |
| Vue d’ensemble | 2026-02-01 22:24:02 | |
| Tous les textes | 2026-02-01 22:24:02 | |
| Uniquement /docs | 2026-02-01 22:24:02 | |
| Périmètre | 2026-02-01 22:24:02 | |
| Rechercher par clé… | 2026-02-01 22:24:02 | |
| Ajouter une langue : ajoutez-la à tk_languages puis remplissez tk_translations. Aucun changement de code. | 2026-02-01 22:24:02 | |
| Support | 2026-02-01 22:24:02 | |
| Aucune ligne pour le filtre actuel. | 2026-02-01 22:24:02 | |
| Ci-dessous : lignes pour le périmètre et la langue sélectionnés. Recherche par clé disponible. | 2026-02-01 22:24:02 | |
| Clé | 2026-02-01 22:24:02 | |
| Valeur | 2026-02-01 22:24:02 | |
| Textes en base | 2026-02-01 22:24:02 |
Support
Ajouter une langue : ajoutez-la à tk_languages puis remplissez tk_translations. Aucun changement de code.