Skip to content
Tallker Tallker
Kostenlos starten

Docs · Integrations · i18n

Dokumentation

Kurzreferenz zur Mehrsprachigkeit: Sprachauswahl, Textspeicher und Export/Update von Übersetzungen.

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 de
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.

Spracherkennung

Priorität: URL-Parameter lang → Cookie lang → Header 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');

Übersetzungsschlüssel

Schlüssel dieser Seite haben das Präfix docs_. Schlüssel stabil halten — Updates bleiben sicher.

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.

Export & Import

Der Export erzeugt ein SQL-Dump aus tk_translations für den gewählten Umfang (docs oder 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.

PHP-Beispiel

Minimal: Sprache erkennen, Übersetzungen per Query laden, Strings via t('key') auflösen.

<?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');
?>

Texte in der DB

Unten stehen Zeilen für Umfang und Sprache. Suche nach Schlüssel ist verfügbar.

file_download Export SQL refresh Reset filters
32 rows for de · docs_*
Tip: click a key to copy.
Schlüssel Wert Updated
Anwenden 2026-02-01 22:24:02
SQL exportieren 2026-02-01 22:24:02
Minimal: Sprache erkennen, Übersetzungen per Query laden, Strings via t('key') auflösen. 2026-02-01 22:24:02
PHP-Beispiel 2026-02-01 22:24:02
Der Export erzeugt ein SQL-Dump aus tk_translations für den gewählten Umfang (docs oder all). 2026-02-01 22:24:02
Für Produktion I18N_EXPORT_TOKEN setzen und token in der URL übergeben. 2026-02-01 22:24:02
Export & Import 2026-02-01 22:24:02
Dokumentation 2026-02-01 22:24:02
Priorität: URL-Parameter lang → Cookie lang → Header Accept-Language → ru. 2026-02-01 22:24:02
Standardmäßig unterstützte Sprachen: ru, en, de, fr, es, tr. 2026-02-01 22:24:02
Spracherkennung 2026-02-01 22:24:02
Schlüssel dieser Seite haben das Präfix docs_. Schlüssel stabil halten — Updates bleiben sicher. 2026-02-01 22:24:02
Empfehlung: Zweck im Schlüssel abbilden (z. B. docs_btn_export, docs_overview_p1). 2026-02-01 22:24:02
Übersetzungsschlüssel 2026-02-01 22:24:02
Sprache 2026-02-01 22:24:02
Kurzreferenz zur Mehrsprachigkeit: Sprachauswahl, Textspeicher und Export/Update von Übersetzungen. 2026-02-01 22:24:02
Dokumentation zum Tallker-Übersetzungssystem: Schlüssel, Spracherkennung, Export/Import. 2026-02-01 22:24:02
Dokumentation — Tallker 2026-02-01 22:24:02
Texte werden in der Tabelle tk_translations gespeichert (lang, tkey, tvalue). 2026-02-01 22:24:02
Die Seite /docs nutzt Fallback: gewählte Sprache → EN → RU. So bleiben UI-Texte nie leer. 2026-02-01 22:24:02
Überblick 2026-02-01 22:24:02
Alle Texte 2026-02-01 22:24:02
Nur /docs 2026-02-01 22:24:02
Umfang 2026-02-01 22:24:02
Nach Schlüssel suchen… 2026-02-01 22:24:02
Neue Sprache? In tk_languages hinzufügen und tk_translations befüllen. Kein Code-Change nötig. 2026-02-01 22:24:02
Support 2026-02-01 22:24:02
Keine Zeilen für den aktuellen Filter. 2026-02-01 22:24:02
Unten stehen Zeilen für Umfang und Sprache. Suche nach Schlüssel ist verfügbar. 2026-02-01 22:24:02
Schlüssel 2026-02-01 22:24:02
Wert 2026-02-01 22:24:02
Texte in der DB 2026-02-01 22:24:02

Support

Neue Sprache? In tk_languages hinzufügen und tk_translations befüllen. Kein Code-Change nötig.

Back to home Open dashboard