Lokalizované texty

Lokalizace pro nový jazyk

Když přidáváte na web nový jazyk (např. en), všechny texty potřebují anglickou verzi. Postup:

1. otevřete každý text v Textech
2. přepněte na anglickou záložku
3. napište anglický překlad
4. uložte

U rozsáhlých projektů (200+ textů) je to časově náročné — zvažte vyžádat export do CSV od podpory, přeložit hromadně, importovat zpět.

Rich vs prostý text

Pole is_rich:

• false (prostý text) — pro krátké hlášky, tlačítka, popisky. HTML značky se zobrazí jako text.
• true (rich text) — pro delší texty s formátováním (cookies banner, GDPR vysvětlení). HTML se interpretuje.

Pro 90 % textů použijte prostý text. Rich jen tam, kde opravdu potřebujete tučné, kurzívu nebo odkaz.

Vytvoření nového textu

Nový text typicky vytvoří vývojář — když potřebuje v šabloně lokalizovanou hlášku, založí internal klíč. Editor pak v adminu doplní obsah.

Pokud potřebujete přidat nový text bez technické podpory:

1. v Textech klikněte Přidat
2. vyplňte internal (kebab-case, např. „novy-popisek-tlacitka")
3. vyplňte text pro každý jazyk
4. uložte

Text se v šabloně použije voláním __("texts.novy-popisek-tlacitka") — ale dokud vývojář nepřidá to volání, text se nikde nezobrazí.

Úprava existujícího textu

Nejčastější použití — opravit překlad nebo přeformulovat hlášku:

1. v menu klikněte Texty
2. vyhledejte text podle internal (např. „cookies-text")
3. otevřete v editaci
4. v jazykové záložce upravte text
5. uložte

Změna se projeví okamžitě (cache se invaliduje při uložení).

Struktura textu

Záznam v modulu Texty má:

• Internal — symbolický identifikátor v kebab-case (např. cookies-text, load-more). Tento klíč používá vývojář v šabloně.
• is_rich — flag, zda obsah obsahuje HTML (true) nebo prostý text (false)
• Lokalizovaný text — pro každý jazyk vlastní obsah

Internal klíč je neměnný — když ho přejmenujete, na webu se text přestane zobrazovat (vývojář v kódu odkazuje na starý klíč).

Modul Texty spravuje UI konstanty — kratké řetězce, které se zobrazují v rozhraní webu (tlačítka, hlášky, popisky), ale nejsou v běžných obsahových polích. Příklady:

• „Načítání…", „Nejsou žádné výsledky", „Pokračovat"
• chybové hlášky („Pole je povinné", „E-mail je neplatný")
• texty na cookies banneru
• nadpisy automaticky generovaných sekcí

Každý text má unikátní klíč (internal) a lokalizovaný obsah pro každý jazyk.