Predvoľba webu

Čo platforma so súborom urobí

• Súbor číta tými istými pravidlami ako editor stránok, Vzhľad a Úvodná strana. Čo by zahodila (neznámy blok, pole mimo popisu, nebezpečný odkaz, neplatnú farbu), vám pred použitím povie po jednom.
• Stránky vzniknú ako koncepty a pred zverejnením ich skontrolujete. Existujúcu stránku prepíše len na výslovnú voľbu.
• Obrázky súbor nenesie, len ich adresy. Cieľový obchod ich stiahne do svojej knižnice médií; prijme JPEG, PNG, GIF, WebP a AVIF. Adresa od lomky sa skladá s poľom zdroj.
• Kategórie a produkty úvodnej strany sú v súbore podľa slugu, nie podľa id: id z jedného obchodu v druhom neplatí.
• Novšiu verziu formátu, než pozná, platforma odmietne celú.

Stropy

Veľkosť súboru

2 MB

Stránok v súbore

300

Blokov na stránke

200

Obrázkov na jedno použitie

80

Z kódu platformy. Tento zoznam sa skladá priamo zo zdrojového kódu platformy a každé nasadenie overí, že s ním sedí.

Polia súboru

Pole	Čo nesie
druh	Značka súboru, vždy portican-predvolba. Podľa nej platforma pozná, že nejde o ľubovoľný JSON.
verzia	Verzia formátu, dnes 2.
nazov	Meno, ktoré predvoľbe dala agentúra.
vytvorene	Kedy predvoľba vznikla, v tvare ISO 8601. Len pre človeka.
zdroj	Adresa webu, z ktorého predvoľba prišla. Z nej sa skladajú adresy obrázkov od lomky.
tema	Téma webu, polia nižšie. Môže chýbať.
stranky	Zoznam stránok, polia nižšie.
uvodnaStrana	Úvodná strana e-shopu, polia nižšie. Môže chýbať.
eshop	Podoba e-shopu zo šablóny: úvodný pás, stĺpce na telefóne, kategórie a karta produktu, každá voľba z uzavretého zoznamu. Môže chýbať, verzia 1 ju nemá.

Polia stránky

Pole	Čo nesie
slug	Adresa stránky. Prázdna je úvodná strana webu.
jazyk	Kód jazyka stránky, napríklad sk, cs, en.
adresa	Adresa v jazyku stránky, keď sa líši od slugu.
nazov	Názov stránky v ponuke.
seoTitulok	Titulok pre vyhľadávače.
seoPopis	Popis pre vyhľadávače.
poradieVMenu	Poradie v ponuke webu. Bez čísla je stránka mimo ponuky.
bloky	Bloky stránky v poradí, ako idú pod sebou. Druhy a polia sú v časti Bloky a ich polia.

Polia témy

Pole	Čo nesie
light	Farby témy ako #rrggbb: background, foreground, primary, primaryForeground, accent, accentForeground, mutedForeground, surface, line, brand2, brand3.
radius	Zaoblenie rohov v rem, napríklad 0.75rem.
tmavyRezim	Ponúka obchod prepínač tmavého režimu (true alebo 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	Písané písmo: Allura, Kaushan Script.
sablona	Šablóna: zaklad, expert.
styl	Štýl šablóny Expert: vyrazny, triezvy, redakcny, produktovy, teply.
fontNadpisov	Písmo nadpisov, z tých istých ako písmo textu.
znacka	Značka textom namiesto loga: text do 40 znakov a voliteľný písaný doplnok.
logo	Adresa loga.
logoWidth	Šírka loga v pixeloch.
logoHeight	Výška loga v pixeloch.
titulnaFotka	Adresa titulnej fotky.
popisZnacky	Krátky popis značky, do 40 znakov.

Polia úvodnej strany e-shopu

Pole	Čo nesie
pas	Texty pásu na vrchu úvodnej strany.
sekcie	Sekcie úvodnej strany v poradí, vždy všetky.
dlazdice	Dlaždice kategórií; kategória je slug.
pocetKategorii	Koľko kategórií ukázať pri automatickom výbere.
pasy	Pásy produktov; kolekcia aj produkty sú slugy.
pocetProduktov	Koľko produktov je v jednom páse.
vyhody	Výhody obchodu pod pásom.

Ukážka

Najmenšia užitočná predvoľba: téma a jedna stránka s dvoma blokmi. Platforma ju prečíta celú, bez jediného nálezu; overuje to každé nasadenie.

{
  "druh": "portican-predvolba",
  "verzia": 1,
  "nazov": "Kvetinárstvo, 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": "sk",
      "nazov": "Úvod",
      "poradieVMenu": 1,
      "bloky": [
        {
          "id": "uvod",
          "druh": "hlavicka",
          "obsah": {
            "nadpis": "Kvety na každý deň",
            "text": "Kytice viažeme ráno a doručujeme v ten istý deň.",
            "tlacidlo": "Pozrieť ponuku",
            "odkaz": "/ponuka"
          }
        },
        {
          "id": "otazky",
          "druh": "otazky",
          "obsah": {
            "nadpis": "Časté otázky",
            "polozky": [
              {
                "otazka": "Doručujete aj v nedeľu?",
                "odpoved": "Áno, objednávky do 10:00 doručíme v ten istý deň."
              }
            ]
          }
        }
      ]
    }
  ]
}