Skip to content
Tallker Tallker
Ücretsiz başla

Docs · Integrations · i18n

Dokümantasyon

Çok dilli hızlı rehber: dil seçimi, metinlerin tutulduğu yer ve çeviri dışa aktarma/güncelleme.

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

Dil algılama

Öncelik: URL lang parametresi → lang çerezi → Accept-Language başlığı → 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');

Çeviri anahtarları

Bu sayfanın anahtarları docs_ önekiyle başlar. Anahtarları stabil tutmak güncellemeleri güvenli kılar.

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.

Dışa aktarma ve içe aktarma

Dışa aktarma, seçilen kapsam (docs veya all) için tk_translations tablosundan SQL dump üretir.

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 kullanım örneği

Minimum: dili algıla, çevirileri tek sorguda yükle, t('key') ile çöz.

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

Veritabanındaki metinler

Aşağıda seçilen kapsam ve dil için satırlar var. Anahtara göre arama mevcut.

file_download Export SQL refresh Reset filters
32 rows for tr · docs_*
Tip: click a key to copy.
Anahtar Değer Updated
Uygula 2026-02-01 22:24:02
SQL dışa aktar 2026-02-01 22:24:02
Minimum: dili algıla, çevirileri tek sorguda yükle, t('key') ile çöz. 2026-02-01 22:24:02
PHP kullanım örneği 2026-02-01 22:24:02
Dışa aktarma, seçilen kapsam (docs veya all) için tk_translations tablosundan SQL dump üretir. 2026-02-01 22:24:02
Production için I18N_EXPORT_TOKEN ayarlayın ve URL'de token gönderin. 2026-02-01 22:24:02
Dışa aktarma ve içe aktarma 2026-02-01 22:24:02
Dokümantasyon 2026-02-01 22:24:02
Öncelik: URL lang parametresi → lang çerezi → Accept-Language başlığı → ru. 2026-02-01 22:24:02
Varsayılan desteklenen diller: ru, en, de, fr, es, tr. 2026-02-01 22:24:02
Dil algılama 2026-02-01 22:24:02
Bu sayfanın anahtarları docs_ önekiyle başlar. Anahtarları stabil tutmak güncellemeleri güvenli kılar. 2026-02-01 22:24:02
Öneri: amacı anahtara yansıtın (örn. docs_btn_export, docs_overview_p1). 2026-02-01 22:24:02
Çeviri anahtarları 2026-02-01 22:24:02
Dil 2026-02-01 22:24:02
Çok dilli hızlı rehber: dil seçimi, metinlerin tutulduğu yer ve çeviri dışa aktarma/güncelleme. 2026-02-01 22:24:02
Tallker çeviri sistemi dokümanı: anahtar yapısı, dil algılama, dışa/içe aktarma. 2026-02-01 22:24:02
Dokümantasyon — Tallker 2026-02-01 22:24:02
Metinler tk_translations tablosunda saklanır (lang, tkey, tvalue). 2026-02-01 22:24:02
/docs sayfası fallback kullanır: seçilen dil → EN → RU. Böylece arayüz metinleri boş kalmaz. 2026-02-01 22:24:02
Genel bakış 2026-02-01 22:24:02
Tüm metinler 2026-02-01 22:24:02
Sadece /docs 2026-02-01 22:24:02
Kapsam 2026-02-01 22:24:02
Anahtara göre ara… 2026-02-01 22:24:02
Yeni dil mi? tk_languages'a ekleyin ve tk_translations'ı doldurun. Kod değişikliği gerekmez. 2026-02-01 22:24:02
Destek 2026-02-01 22:24:02
Mevcut filtre için satır yok. 2026-02-01 22:24:02
Aşağıda seçilen kapsam ve dil için satırlar var. Anahtara göre arama mevcut. 2026-02-01 22:24:02
Anahtar 2026-02-01 22:24:02
Değer 2026-02-01 22:24:02
Veritabanındaki metinler 2026-02-01 22:24:02

Destek

Yeni dil mi? tk_languages'a ekleyin ve tk_translations'ı doldurun. Kod değişikliği gerekmez.

Back to home Open dashboard