DokumentaceObsah a pole

Obsah a pole

Hodnoty v projektu — text, přepínač a pole hodnot. Jak je vytvořit, upravit a napojit na web přes odkaz.

V eCMS vytváříte hodnoty. Hodnota je jedna konkrétní věc na webu, kterou chcete měnit bez zásahu do kódu: nadpis, cena, přepínač „zobrazit banner“, seznam otevíracích dob. Každá hodnota má vlastní odkaz. Ten jednou vložíte do kódu webu a od té chvíle se změna v eCMS projeví i tam.

Hodnoty spravujete na stránce projektu v záložce Správa hodnot.

Tři typy hodnot

Typ K čemu je Příklad
Text Formátovaný text (tučné písmo, odkazy, seznamy, obrázky). Nadpis, ceník, text v patičce
Přepínač ANO/NE (boolean) Zapnuto, nebo vypnuto. Zobrazit banner „jsme na dovolené“
Pole hodnot Víc údajů najednou ve vlastní struktuře. Hodí se spíš pro vývojáře než pro běžné editory. Seznam týmu: jméno, role, datum nástupu

Typ zvolíte při vytvoření hodnoty a pak už ho nejde změnit.

Přidání hodnoty

Hodnoty přidává admin projektu.

  1. V záložce Správa hodnot klikněte na Přidat hodnotu.
  2. Vyplňte ID hodnoty.
  3. Vyberte typ: Text, Pole hodnot nebo Přepínač ANO/NE.
  4. Vyplňte obsah podle typu (viz níže).
  5. Potvrďte tlačítkem Uložit.

ID hodnoty

ID je název, podle kterého hodnotu v projektu poznáte, např. homepage.hero.title. Po vytvoření ho nejde změnit.

  • Nepoužívejte mezery, diakritiku ani speciální znaky. Appka na ně upozorní, protože mohou dělat potíže při použití v API.
  • Pokud v projektu už hodnota se stejným ID existuje, appka vás varuje. Při použití Zkopírujte vše by se totiž jedna z nich tiše přepsala.

Text

Do pole Hodnota píšete v editoru s lištou formátování: nadpisy, velikost písma, tučné písmo, kurzíva, odkazy, citace, zarovnání, barvy, seznamy, odsazení, obrázky nebo kód.

Přepínač ANO/NE

Pomocí přepínače nastavíte výchozí stav, Ano nebo Ne.

Pole hodnot

U pole nejdřív popíšete strukturu a hodnoty doplníte až potom.

  1. V části Pole struktury klikněte na Přidat pole.
  2. U každého pole zadejte Klíč (název) a Typ: Text, Datum nebo Datum a čas.
  3. Hodnotu uložte.
  4. Potom ji otevřete k úpravě a přes Přidat položku vytvořte jednotlivé položky. Každá obsahuje všechna pole struktury.

Strukturu pole (klíče a jejich typy) nejde po vytvoření změnit. Dobře ji promyslete předem. Pole musí mít při ukládání aspoň jednu položku s vyplněnými všemi poli.

Přehled hodnot

Každá hodnota je v seznamu karta s ikonou typu a ID. Podle typu se na ní zobrazuje:

  • u textu náhled obsahu,
  • u přepínače samotný přepínač se stavem Ano / Ne,
  • u pole počet položek a možnost rozbalit je tlačítkem Zobrazit hodnoty (Skrýt hodnoty).

V seznamu můžete:

  • Hledat v poli Hledat…,
  • filtrovat přes Filtry podle typu: Vše, Text, Boolean, Pole,
  • řadit podle názvu: Název A–Z, Název Z–A nebo Bez řazení.

Nápovědu k typům hodnot najdete přímo v appce v části Návod (Jak fungují hodnoty?).

Úprava hodnoty

Úpravy mohou dělat admin i editor.

  • Text a pole — v nabídce hodnoty (tři tečky na kartě) zvolte Upravit, změňte obsah a klikněte na Uložit. ID se při úpravě změnit nedá.
  • Přepínač — přepnete ho přímo na kartě. Změna se uloží hned, bez dalšího potvrzení.

Smazání hodnoty

Hodnotu smaže jen admin, přes nabídku na kartě. Pozor: odkaz na smazanou hodnotu pak na webu přestane fungovat.

Napojení na web

U každé hodnoty je v nabídce na kartě (tři tečky) volba Kopírovat link. Zkopírovaný odkaz vložíte do kódu webu nebo aplikace libovolným způsobem. Když pak hodnotu v eCMS změníte, změní se i tam, kam jste odkaz vložili.

Pokud chcete načíst všechny hodnoty projektu jedním dotazem, použijte pod seznamem tlačítko Zkopírujte vše.

Odkaz na hodnotu je veřejný a nevyžaduje přihlášení. Kdo odkaz zná, hodnotu přečte. Nevkládejte proto do hodnot nic důvěrného.

Příklad: banner „jsme na dovolené“

Klient chce sám měnit upozornění o dovolené, ale nemá se dotýkat zbytku webu.

  1. Jako admin vytvořte hodnotu Text s ID banner.text a obsahem třeba „Jsme na dovolené do 15. 8.“.
  2. Vytvořte hodnotu Přepínač ANO/NE s ID banner.show.
  3. Zkopírujte odkazy obou hodnot a vložte je do kódu webu. Banner se zobrazuje jen tehdy, když je banner.show zapnutý.
  4. Klienta přidejte do projektu jako editora. Klient pak sám změní datum v textu a banner zapne nebo vypne přepínačem.

O přidání uživatelů a rolích se dočtete v další kapitole.