Předloha webu

Co platforma se souborem udělá

• Soubor čte stejnými pravidly jako editor stránek, Vzhled a Úvodní strana. Co by zahodila (neznámý blok, pole mimo popis, nebezpečný odkaz, neplatnou barvu), vám před použitím řekne jedno po druhém.
• Stránky vzniknou jako koncepty a před zveřejněním je zkontrolujete. Existující stránku přepíše jen na výslovnou volbu.
• Obrázky soubor nenese, jen jejich adresy. Cílový obchod je stáhne do své knihovny médií; přijme JPEG, PNG, GIF, WebP a AVIF. Adresa začínající lomítkem se skládá s polem zdroj.
• Kategorie a produkty úvodní strany jsou v souboru podle slugu, ne podle id: id z jednoho obchodu v jiném neplatí.
• Novější verzi formátu, než zná, platforma odmítne celou.

Limity

Velikost souboru

2 MB

Stránek v souboru

300

Bloků na stránce

200

Obrázků na jedno použití

80

Z kódu platformy. Tento seznam se skládá přímo ze zdrojového kódu platformy a každé nasazení ověří, že s ním souhlasí.

Pole souboru

Pole	Co nese
druh	Značka souboru, vždy portican-predvolba. Podle ní platforma pozná, že nejde o libovolný JSON.
verzia	Verze formátu, dnes 2.
nazov	Název, který předloze dala agentura.
vytvorene	Kdy předloha vznikla, ve tvaru ISO 8601. Jen pro člověka.
zdroj	Adresa webu, ze kterého předloha přišla. Z ní se skládají adresy obrázků začínající lomítkem.
tema	Téma webu, pole níže. Může chybět.
stranky	Seznam stránek, pole níže.
uvodnaStrana	Úvodní strana e-shopu, pole níže. Může chybět.
eshop	Podoba e-shopu ze šablony: úvodní pruh, sloupce na telefonu, kategorie a karta produktu, každá volba z uzavřeného seznamu. Může chybět, verze 1 ji nemá.

Pole stránky

Pole	Co nese
slug	Adresa stránky. Prázdná je úvodní strana webu.
jazyk	Kód jazyka stránky, například sk, cs, en.
adresa	Adresa v jazyce stránky, když se liší od slugu.
nazov	Název stránky v menu.
seoTitulok	Titulek pro vyhledávače.
seoPopis	Popis pro vyhledávače.
poradieVMenu	Pořadí v menu webu. Bez čísla je stránka mimo menu.
bloky	Bloky stránky v pořadí, jak jdou pod sebou. Druhy a pole jsou v části Bloky a jejich pole.

Pole tématu

Pole	Co nese
light	Barvy tématu jako #rrggbb: background, foreground, primary, primaryForeground, accent, accentForeground, mutedForeground, surface, line, brand2, brand3.
radius	Zaoblení rohů v rem, například 0.75rem.
tmavyRezim	Nabízí obchod přepínač tmavého režimu (true nebo false).
font	Písmo textu: Geist, Jost, Inter, Lora, Playfair Display, Old Standard TT, Space Grotesk, Bodoni Moda, Archivo, system-ui, Faustina, DM Sans, Montserrat, Work Sans, Manrope, Nunito Sans, Cormorant Garamond, Source Serif 4, Libre Baskerville, Merriweather.
pismo	Psané písmo: Allura, Kaushan Script.
sablona	Šablona: zaklad, expert.
styl	Styl šablony Expert: vyrazny, triezvy, redakcny, produktovy, teply.
fontNadpisov	Písmo nadpisů, ze stejných jako písmo textu.
znacka	Značka textem místo loga: text do 40 znaků a volitelný psaný doplněk.
logo	Adresa loga.
logoWidth	Šířka loga v pixelech.
logoHeight	Výška loga v pixelech.
titulnaFotka	Adresa titulní fotky.
popisZnacky	Krátký popis značky, do 40 znaků.

Pole úvodní strany e-shopu

Pole	Co nese
pas	Texty pásu nahoře na úvodní straně.
sekcie	Sekce úvodní strany v pořadí, vždy všechny.
dlazdice	Dlaždice kategorií; kategorie je slug.
pocetKategorii	Kolik kategorií ukázat při automatickém výběru.
pasy	Pásy produktů; kolekce i produkty jsou slugy.
pocetProduktov	Kolik produktů je v jednom pásu.
vyhody	Výhody obchodu pod pásem.

Ukázka

Nejmenší užitečná předloha: téma a jedna stránka se dvěma bloky. Platforma ji přečte celou, bez jediného nálezu; ověřuje to každé nasazení.

{
  "druh": "portican-predvolba",
  "verzia": 1,
  "nazov": "Květinářství, jednoduchý web",
  "vytvorene": "2026-09-29T10:00:00Z",
  "zdroj": "https://example.com",
  "tema": {
    "light": {
      "primary": "#0f5c4a",
      "primaryForeground": "#ffffff"
    },
    "radius": "0.75rem",
    "font": "Inter",
    "sablona": "expert",
    "styl": "teply"
  },
  "stranky": [
    {
      "slug": "",
      "jazyk": "cs",
      "nazov": "Úvod",
      "poradieVMenu": 1,
      "bloky": [
        {
          "id": "uvod",
          "druh": "hlavicka",
          "obsah": {
            "nadpis": "Květiny na každý den",
            "text": "Kytice vážeme ráno a doručujeme ještě týž den.",
            "tlacidlo": "Prohlédnout nabídku",
            "odkaz": "/nabidka"
          }
        },
        {
          "id": "otazky",
          "druh": "otazky",
          "obsah": {
            "nadpis": "Časté dotazy",
            "polozky": [
              {
                "otazka": "Doručujete i v neděli?",
                "odpoved": "Ano, objednávky do 10:00 doručíme ještě týž den."
              }
            ]
          }
        }
      ]
    }
  ]
}