Přeskočit na hlavní obsah

Resource stringy

Resource stringy (RS) jsou textové záznamy identifikované klíčem (např. Common.SaveButton) a jazykem. Hodnota může být prostý text nebo HTML z WYSIWYG editoru — používá se pro popisky tlačítek, hlášky, úryvky v šablonách a pro CMS resolved text v administraci i na webu.

Oprávnění a tenant

Práce s RS vyžaduje přístup k modulu (role Editor nebo dle nastavení menu) a výběr tenanta. Část přehledu může zobrazovat i šablony z tenantu Default jako referenci.

Struktura klíče a jazyk​

  • Klíč je obvykle ve tvaru jmenného prostoru (Form.Label.X, News.ListTitle, …) — konvence závisí na projektu; důležitá je jednoznačnost v rámci tenanta a jazyka.
  • V jedné skupině (stejný klíč) může být více řádků pro různé jazyky (aktuálně typicky cs; další jazyky lze v systému rozšířit).
  • Editor v zásuvce často nabízí více jazykových polí vedle sebe — uložením se aktualizují všechny vyplněné varianty.
Prázdný WYSIWYG

Prázdný obsah v rich text poli (např. jen prázdný odstavec) se může chovat jako „žádná hodnota“ — validace nebo mazání záznamu se může lišit od prostého textového pole. Pro smazání překladu použijte explicitní akci smazání řádku, pokud ji UI nabízí.

Kde se resource stringy používají​

  • Šablony webu (Astro) – načítání přes API / build podle klíče a tenantního kódu.
  • Formuláře a taxonomie v CMS – komponenty typu „label z RS“ propojují pole s prefixem klíčů (např. štítky polí formuláře).
  • Dynamické texty – místo natvrdo psaných řetězců v kódu šablony se použije klíč a hodnota z databáze.

Práce v přehledu​

  • Vyhledávání podle klíče – rychlé dohledání skupiny záznamů.
  • Úprava hodnoty – otevření zásuvky, úprava WYSIWYG nebo plain textu, uložení.
  • Tenant vs. šablona – rozlišujte vlastní hodnoty tenanta a sdílené šablony (záleží na konkrétním nasazení a záložkách v UI).
Konzistence klíčů

Přejmenování klíče nepřejmenuje automaticky všechna místa v kódu, která klíč očekávají. Změny klíčů koordinujte s vývojáři šablony.

Doporučení​

  • Vytvářejte stabilní klíče a měňte raději obsah hodnoty než identifikátor.
  • Pro dlouhé texty používejte WYSIWYG uvážlivě – na výstupu musí být HTML v souladu s bezpečnostní politikou (escaping na webu dle kontextu).
  • Před hromadnou úpravou zálohujte exportem nebo záznamem původních hodnot (provozní proces mimo CMS).