Skip to content
Tallker Tallker
Empezar gratis

Docs · Integrations · i18n

Documentación

Referencia de multilenguaje: cómo se elige el idioma, dónde viven los textos y cómo exportar/actualizar traducciones.

Open quickstart Translations in DB
Copy-paste ready
Snippets and practical defaults.
i18n from DB
lang → cookie → geo → Accept-Language.
Controlled export
SQL export via token or debug.
Workspace settings
Choose language, browse keys, export SQL.
description
Coverage
Rows in scope / rows for selected language.
192
32 for es
Open table Export SQL

Set I18N_EXPORT_TOKEN to enable export in production.

Contents

Navigate through the core topics.

rocket_launch
Quickstart
Minimal integration steps.
translate
Language detection
Cookie + geo + header strategy.
key
Key conventions
Naming and scoping.
file_download
Export / import
Controlled SQL operations.
code
Examples
PHP usage patterns.
table
Translations table
Browse keys in DB.

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.

Tip
Use staging domain first.
Security
Keep private keys server-side.
Next
Read i18n and export/import sections below.

Detección de idioma

Prioridad: parámetro lang → cookie lang → encabezado 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');

Claves de traducción

Las claves de esta página usan el prefijo docs_. Mantenga las claves estables para actualizaciones seguras.

layers
Scopes
docs_* for docs, nav_* for header, footer_* for footer.
badge
Stability
Keys should not change; only values change.
tune
Fallbacks
Always provide fallback in code to keep UI resilient.

Exportación e importación

La exportación genera un dump SQL desde tk_translations para el alcance elegido (docs o all).

Import

Use mysql client. Run in a transaction to keep consistency.

# import example
mysql -uUSER -p DBNAME < tk_translations.sql

Export

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_TOKEN
Policy
If token is not set — export works only with debug=1.

Ejemplo en PHP

Patrón mínimo: detectar idioma, cargar traducciones en una consulta, resolver 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');
?>

Textos en la BD

Abajo: filas para el alcance y el idioma seleccionados. Búsqueda por clave disponible.

file_download Export SQL refresh Reset filters
32 rows for es · docs_*
Tip: click a key to copy.
Clave Valor Updated
Aplicar 2026-02-01 22:24:02
Exportar SQL 2026-02-01 22:24:02
Patrón mínimo: detectar idioma, cargar traducciones en una consulta, resolver via t('key'). 2026-02-01 22:24:02
Ejemplo en PHP 2026-02-01 22:24:02
La exportación genera un dump SQL desde tk_translations para el alcance elegido (docs o all). 2026-02-01 22:24:02
En producción, configure I18N_EXPORT_TOKEN y pase token en la URL. 2026-02-01 22:24:02
Exportación e importación 2026-02-01 22:24:02
Documentación 2026-02-01 22:24:02
Prioridad: parámetro lang → cookie lang → encabezado Accept-Language → ru. 2026-02-01 22:24:02
Idiomas soportados por defecto: ru, en, de, fr, es, tr. 2026-02-01 22:24:02
Detección de idioma 2026-02-01 22:24:02
Las claves de esta página usan el prefijo docs_. Mantenga las claves estables para actualizaciones seguras. 2026-02-01 22:24:02
Recomendación: refleje el propósito en la clave (p. ej. docs_btn_export, docs_overview_p1). 2026-02-01 22:24:02
Claves de traducción 2026-02-01 22:24:02
Idioma 2026-02-01 22:24:02
Referencia de multilenguaje: cómo se elige el idioma, dónde viven los textos y cómo exportar/actualizar traducciones. 2026-02-01 22:24:02
Docs del sistema de traducciones de Tallker: claves, detección de idioma, exportación/importación. 2026-02-01 22:24:02
Documentación — Tallker 2026-02-01 22:24:02
Los textos se almacenan en la tabla tk_translations (lang, tkey, tvalue). 2026-02-01 22:24:02
La página /docs usa fallback: idioma elegido → EN → RU, para evitar textos vacíos. 2026-02-01 22:24:02
Resumen 2026-02-01 22:24:02
Todos los textos 2026-02-01 22:24:02
Solo /docs 2026-02-01 22:24:02
Alcance 2026-02-01 22:24:02
Buscar por clave… 2026-02-01 22:24:02
¿Nuevo idioma? Añádalo a tk_languages y complete tk_translations. No requiere cambios de código. 2026-02-01 22:24:02
Soporte 2026-02-01 22:24:02
No hay filas para el filtro actual. 2026-02-01 22:24:02
Abajo: filas para el alcance y el idioma seleccionados. Búsqueda por clave disponible. 2026-02-01 22:24:02
Clave 2026-02-01 22:24:02
Valor 2026-02-01 22:24:02
Textos en la BD 2026-02-01 22:24:02

Soporte

¿Nuevo idioma? Añádalo a tk_languages y complete tk_translations. No requiere cambios de código.

Back to home Open dashboard