> For the complete documentation index, see [llms.txt](https://napoveda.rocketoo.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://napoveda.rocketoo.cz/rocketoo/rozsireni/konfigurovatelne-produkty.md).

# Konfigurovatelné produkty

Modul Konfigurovatelné produkty vám umožňuje nabízet zákazníkům produkty, u nichž si mohou vybrat parametry přímo v detailu produktu – například vzorek povrchu, rozměr, materiál, doplňkovou montáž nebo nahrát vlastní soubor.

Modul zajišťuje:

* Přidání libovolného počtu konfigurací ke konfigurovatelným produktům
* Šest typů konfigurací – od jednoduchého výběru až po nahrání souboru
* Příplatky k ceně produktu – absolutní částkou nebo procentem ze základní ceny
* Spravované vzorníky s odstíny, barvami a fotografiemi
* Přenos zvolených možností do košíku a objednávky
* Různá nastavení na úrovni každé varianty produktu

## Kde najdu modul?

V hlavním menu klikněte na **Katalog** a vyberte sekci **Konfigurace**. Zobrazí se vám záložková nabídka:

* **Konfigurace** – seznam všech konfigurací a jejich správa
* **Vzorníky** – správa vzorníků (RAL, ICA, vlastní…)

Záložka **Vzorky** je přístupná přímo z každého vzorníku.

## Konfigurace

### Co je konfigurace?

Konfigurace je jedna volba, kterou zákazník učiní v detailu produktu – například výběr vzorku dvířek, výběr výšky nožiček nebo zaškrtnutí „Přeji si montáž".

Konfigurace se vytváří globálně (jednou) a poté se přiřazuje k libovolnému množství produktů nebo variant. Změna konfigurace se okamžitě projeví všude, kde je přiřazena.

### Jak vytvořit novou konfiguraci?

1. V menu klikněte na **Konfigurace**
2. Klikněte na **Vytvořit konfiguraci**
3. Vyplňte záložku **Základní info**:
   * **Název konfigurace** – text, který zákazník uvidí nad výběrem (např. „Vzorek dvířek")
   * **Název pro admina** – interní název pro přehlednost v backendu; nezobrazí se zákazníkovi
   * **Tooltip u názvu** – krátká nápověda, která se zákazníkovi zobrazí po najetí na název
   * **Detailní popis** – delší vysvětlení pod výběrem (nepovinné)
4. Vyplňte záložku **Typ a možnosti výběru**:
   * **Typ konfigurace** – zvolte jeden z šesti typů (viz [Typy konfigurací](#typy-konfigurací))
   * Po zvolení typu se zobrazí odpovídající nastavení pro daný typ
5. Vyplňte záložku **Chování** (nepovinné; viz [Pokročilé nastavení chování](#pokročilé-nastavení-chování))
6. Klikněte **Vytvořit**

### Úprava konfigurace

1. V seznamu konfigurací klikněte na název konfigurace
2. Upravte požadované údaje
3. Klikněte **Uložit**

### Přehled konfigurací

V seznamu konfigurací vidíte:

* **Název konfigurace** – zákaznický název
* **Typ** – jaký typ konfigurace je použit
* **Povinná** – zda musí zákazník hodnotu vybrat před přidáním do košíku
* **Aktualizováno** – datum poslední úpravy

## Typy konfigurací

Každá konfigurace má jeden z šesti typů. Typ určuje, co zákazník v detailu produktu uvidí a jak se jeho volba přenese do objednávky.

### Výběr produktu

Zákazník si vybírá z předdefinovaných variant produktů. Hodí se například pro výběr dvířek kuchyňské linky, typ příslušenství nebo jiného doplňku.

**Jak nastavit:**

1. Zvolte typ **Výběr produktu**
2. V sekci **Varianty k výběru** klikněte na **Přidat variantu**
3. Vyhledejte variantu a potvrďte
4. U každé varianty nastavte příplatek k ceně (předvyplní se z katalogové ceny, lze přepsat) a požadované množství

### Ano/Ne

Zákazník si vybírá mezi dvěma možnostmi – typicky „Ano, chci" a „Ne, děkuji". Hodí se pro doplňkové služby (montáž, dárkové balení, rozšířená záruka).

**Jak nastavit:**

1. Zvolte typ **Ano/Ne**
2. V části **Možnost „Ano"** zadejte text a příplatek
3. V části **Možnost „Ne"** zadejte text a příplatek (obvykle 0)

### Seznam možností

Generický seznam hodnot, u nichž ručně zadáte popis, příplatek a volitelnou barvu swatche nebo fotografii. Hodí se pro výběr výšky, materiálu, typu pojezdu a podobné volby.

**Jak nastavit:**

1. Zvolte typ **Seznam možností**
2. Klikněte na **Přidat možnost**
3. Vyplňte:
   * **Název možnosti** – text, který uvidí zákazník (např. „Blum")
   * **Příplatek** – o kolik se zvýší cena při výběru
   * **Kód možnosti** – nepovinný stabilní identifikátor; pokud necháte prázdné, vygeneruje se z názvu
   * **Barva (swatch)** – hex kód pro barevný čtverec
   * **Foto / dekor** – obrázek možnosti (má přednost před barvou)

### Výběr vzorníků

Zákazník vybírá z katalogu odstínů spravovaných ve vzornících (RAL, ICA, INSI nebo vlastní). Možnosti nejsou zadávány ručně, ale přebírají se z centrálně spravovaných vzorníků (viz [Vzorníky a vzorky](#vzorníky-a-vzorky)).

**Jak nastavit:**

1. Zvolte typ **Výběr vzorníků**
2. V sekci **Vzorníky k výběru** zaškrtněte, ze kterých vzorníků zákazník vybírá
3. Volitelně zapněte **Povolit vlastní RAL kód** – zákazník pak může zadat libovolný kód do poznámky

### Textové pole

Zákazník zadá volný text – například text na rytinu, vlastní vzkaz nebo upřesnění. Text se přenese do objednávky.

**Jak nastavit:**

1. Zvolte typ **Textové pole**
2. Nastavte:
   * **Maximální délka** – kolik znaků může zákazník zadat
   * **Víceřádkový text** – zapněte pro delší texty (textarea místo jednořádkového pole)
   * **Placeholder** – nápověda zobrazená v prázdném poli (nepovinné)
   * **Příplatek za vyplnění** – nepovinný příplatek, pokud zákazník pole vyplní

### Nahrání souboru

Zákazník nahraje soubor – logo, PDF podklad, technický výkres. Soubor se připojí k objednávce.

**Jak nastavit:**

1. Zvolte typ **Nahrání souboru**
2. Nastavte:
   * **Povolené typy souborů** – zaškrtněte skupiny (obrázky, PDF, dokumenty, nebo „jakýkoliv")
   * **Vlastní přípony** – doplňte konkrétní přípony oddělené čárkou (nepovinné, např. `svg, ai`)
   * **Max. velikost (MB)** – maximální velikost nahraného souboru
   * **Příplatek za nahrání** – nepovinný příplatek, pokud zákazník soubor nahraje

## Vzorníky a vzorky

Vzorníky jsou kolekce barevných odstínů. Jeden vzorník (např. RAL Classic) obsahuje desítky nebo stovky vzorků (RAL 9005, RAL 9010…). Vzorníky se přiřazují ke konfiguraci typu **Výběr vzorníků**.

### Jak vytvořit vzorník?

1. V menu klikněte na **Vzorníky**
2. Klikněte na **Nový vzorník**
3. Vyplňte:
   * **Kód** – krátký identifikátor vzorníku (např. `RAL`, `ICA`); předvyplní se z názvu
   * **Název** – plný název vzorníku (např. „RAL Classic")
   * **Popis** – nepovinný popis
4. Klikněte **Vytvořit**

### Jak přidat vzorky do vzorníku?

1. Otevřete vzorník
2. V sekci **Vzorky** klikněte na **Vytvořit vzorek**
3. Vyplňte:
   * **Název** – název odstínu (např. „Magnólie")
   * **Kód** – kód odstínu (např. „N0101" nebo „RAL 9005"); předvyplní se z názvu
   * **Hex barva** – kód barvy pro vizuální čtverec (např. `#F5F5DC`)
   * **Obrázky / galerie** – nahrajte fotografii vzorku nebo realizace; první obrázek se zobrazí jako náhledový vzorek a má přednost před hex barvou
   * **Příplatek** – příplatek za tento odstín (0 = bez příplatku)
   * **Aktivní** – neaktivní vzorky se zákazníkovi nezobrazí
4. Klikněte **Vytvořit vzorek**

### Pořadí vzorníků a vzorků

* **Pořadí vzorníků:** V seznamu vzorníků klikněte na **Pořadí vzorníků**, přetáhněte do požadovaného pořadí a klikněte **Uložit pořadí**
* **Pořadí vzorků:** Uvnitř vzorníku klikněte na **Pořadí odstínů** a vzorky seřaďte přetažením

### Tipy pro vzorníky

✅ Udržujte vzorníky oddělené dle systému – jeden vzorník pro RAL, druhý pro ICA\
✅ U vzorků zadávejte vždy kód i název – zákazník uvidí obojí\
✅ Pro přesnou barvu použijte fotografii; hex barva je jen přibližný vizuál\
❌ Nepoužívejte jeden vzorník pro různé nesouvisející odstínové systémy

## Přiřazení konfigurací k produktu

Aby se konfigurace zobrazila zákazníkovi, musí být přiřazena k produktu. Přiřazení se provádí přímo na produktu.

{% hint style="warning" %}
**Důležité:** Přiřazovat konfigurace lze pouze u produktů typu **Konfigurovatelný produkt**. Typ produktu nastavíte v záložce **Základní info** při úpravě produktu.
{% endhint %}

### Produkt bez variant (master varianta)

1. Otevřete produkt
2. Přejděte na záložku **Konfigurace**
3. Klikněte na **Přidat**
4. Vyhledejte konfiguraci a klikněte **Připojit**
5. Uložte produkt

Konfigurace se zobrazí všem zákazníkům prohlížejícím tento produkt.

### Nastavení pořadí konfigurací

Na záložce **Konfigurace** přetáhněte konfigurace do požadovaného pořadí – v tomto pořadí se zobrazí zákazníkovi.

## Přiřazení konfigurací k variantě

U produktů s variantami se konfigurace přiřazují na úrovni každé varianty zvlášť. To umožňuje mít různé sady možností pro různé varianty (například jiné dostupné vzorky pro variantu „Bílá" a jiné pro „Dubová dýha").

### Jak přiřadit konfiguraci k variantě?

1. Otevřete produkt a přejděte na záložku **Varianty**
2. Klikněte na konkrétní variantu
3. Přejděte na záložku **Konfigurace pro tuto variantu**
4. Klikněte na **Přidat** a vyberte konfiguraci
5. Po přiřazení lze konfiguraci pro tuto variantu přizpůsobit kliknutím na **Upravit přetížení**
6. Uložte variantu

### Per-variant přetížení (override)

Přetížení umožňuje pro konkrétní variantu změnit část nastavení konfigurace – například skrýt některé možnosti nebo upravit příplatky – aniž by se změnila globální konfigurace.

**Příklady využití:**

* U varianty „Bílá" vyloučit tmavé vzorky
* U prémiové varianty upravit příplatky konfigurací

Přetížení se nastaví po kliknutí na **Upravit přetížení** u přiřazené konfigurace.

## Příplatky ke konfiguracím

Každá volba v konfiguraci může mít příplatek k základní ceně produktu. Příplatky jsou přičteny automaticky při výběru zákazníka a přeneseny do košíku i objednávky.

### Dva typy příplatků

Na záložce konfigurace zvolte **Typ příplatku**:

* **Absolutní (částka)** – příplatek je pevná částka v měně (např. 500 Kč za montáž)
* **Procentuální (% ze základní ceny)** – příplatek je procento ze základní ceny produktu (např. 10 % za prémiový vzorek)

{% hint style="info" %}
Typ příplatku platí pro celou konfiguraci – nelze mít absolutní příplatek u jedné možnosti a procentuální u jiné v rámci stejné konfigurace.
{% endhint %}

### Cena v detailu produktu

Zákazník vidí příplatek u každé možnosti (např. „+500 Kč"). Celková cena se přepočítá okamžitě při každém výběru bez nutnosti znovu načíst stránku.

## Pokročilé nastavení chování

Na záložce **Chování** lze pro každou konfiguraci zapnout rozšířené funkce. Vše je ve výchozím stavu vypnuto.

### Mění název produktu

Pokud je zapnuto, zvolená hodnota se automaticky připojí k názvu produktu. Hodí se například pro zobrazení zvoleného vzorku v názvu.

* **Šablona názvu** – nastavte, jak se hodnota připojí; použijte `{value}` pro zvolenou hodnotu (např. `– {value}`)

### Rozpad do feedu

Pokud je zapnuto, každá možnost konfigurace se ve feedu (Heureka, Zboží.cz, Google Merchant…) zobrazí jako samostatná položka. Využijte tehdy, když chcete inzerovat každý barevný odstín nebo vzorek jako samostatný produkt.

### Přidat do sitemap

Pokud je zapnuto, každá možnost konfigurace dostane vlastní URL v sitemap. Napomáhá SEO u produktů s výrazně odlišnými variantami konfigurací.

### Mění URL

Pokud je zapnuto, zvolená možnost se projeví v URL jako query parametr (např. `?vzorek-dvirek=magnolia`). URL s předvyplněnou volbou pak lze sdílet nebo na ni odkazovat z jiných stránek.

* **Název URL parametru** – krátký identifikátor v URL (např. `vzorek-dvirek`); předvyplní se z názvu konfigurace, lze přepsat

## Hromadná aktualizace konfigurací

Pokud chcete nastavit stejné konfigurace najednou pro více konfigurovatelných produktů, použijte hromadnou aktualizaci.

### Jak na to?

1. Přejděte do sekce **Produkty**
2. Označte checkboxy u požadovaných konfigurovatelných produktů
3. V **Hromadné akce** vyberte **Hromadně nastavit konfigurace**
4. V zobrazeném formuláři nastavte konfigurace, které mají být přiřazeny
5. Potvrďte

{% hint style="warning" %}
**Upozornění:** Hromadná aktualizace nahradí stávající konfigurace u vybraných produktů. Ve výběru musí být výhradně produkty typu **Konfigurovatelný produkt** – nelze ji použít pro produkty jiného typu.
{% endhint %}

## Jak zákazník vidí konfigurátor

### Zobrazení na frontendu

Zákazník vidí v detailu konfigurovatelného produktu postupné kroky výběru. Každá konfigurace je zobrazena svým názvem a pod ním možnostmi výběru. Styl výběru závisí na nastavení konfigurace:

* **Rozbalovací seznam** – klasický dropdown se všemi možnostmi
* **Přepínače (radio)** – kulatá tlačítka vedle sebe nebo pod sebou
* **Vzorník (swatch)** – barevné nebo obrázkové čtverce; po najetí se zobrazí název
* **Mřížka** – dlaždice s popisky

Styl se nastaví u každé konfigurace v poli **Styl výběru na frontendu**. Pokud není nastaveno, použije se výchozí styl daného typu.

### Přepočet ceny

Při každém výběru se cena produktu okamžitě přepočítá a zákazník vidí aktuální celkovou cenu včetně všech zvolených příplatků.

### Povinné konfigurace

Konfigurace označené jako **Povinná při objednání** musí zákazník vyplnit před přidáním do košíku. Pokud tak neučiní, zobrazí se upozornění a produkt do košíku přidán nebude.

### Přenos do košíku a objednávky

Zvolené hodnoty se přenesou do košíku a viditelně se zobrazí u každé položky objednávky – jak zákazníkovi v potvrzovacím e-mailu, tak v administraci u detailu objednávky.

## Často kladené otázky

### Obecné

**Q: Musím pro každý produkt vytvářet nové konfigurace?**\
A: Ne. Konfigurace se vytváří jednou a pak přiřazuje k libovolnému množství produktů. Změna konfigurace se projeví všude, kde je použita.

**Q: Kolik konfigurací může mít jeden produkt?**\
A: Neomezený počet. Doporučujeme ale nepřehánět – příliš mnoho kroků výběru může zákazníka odradit.

**Q: Mohu mít různé konfigurace pro různé varianty jednoho produktu?**\
A: Ano. Konfigurace se přiřazují na úrovni každé varianty zvlášť. Navíc lze pro každou variantu nastavit jiné přetížení (odlišné možnosti nebo příplatky).

**Q: Mohu konfiguraci nejdříve vytvořit a teprve poté přiřadit k produktu?**\
A: Ano, přesně tak je to navrženo. Konfigurace existují samostatně a přiřazujete je k produktům podle potřeby.

### Typy konfigurací

**Q: Jaký typ konfigurace mám použít pro výběr barvy?**\
A: Záleží na povaze barev. Pro spravované katalogové barvy (RAL, lakování) použijte **Výběr vzorníků**. Pro malý počet pevně daných barev (2–5 možností) postačí **Seznam možností** s hex barvou nebo obrázkem swatche.

**Q: Mohu mít u jednoho produktu kombinaci více typů konfigurací?**\
A: Ano. Například jeden produkt může mít konfiguraci „Výběr vzorníků" pro barvu, konfiguraci „Seznam možností" pro výšku a konfiguraci „Ano/Ne" pro montáž.

**Q: Co se stane, pokud zákazník nevybere nepovinnou konfiguraci?**\
A: Konfigurace se přidá do košíku bez hodnoty pro tuto konfiguraci. Do objednávky se přenese pouze to, co zákazník skutečně vybral.

### Vzorníky

**Q: Kolik vzorníků mohu mít?**\
A: Neomezený počet. Vytvářejte tolik vzorníků, kolik odpovídá vašim katalogovým systémům (RAL, ICA, vlastní).

**Q: Mohu zákazníkovi nabídnout vzorky z více vzorníků najednou?**\
A: Ano. V konfiguraci typu **Výběr vzorníků** zaškrtněte libovolný počet vzorníků – zákazník uvidí vzorky ze všech najednou.

**Q: Jak skrýt vzorek zákazníkovi, aniž bych ho smazal?**\
A: Otevřete vzorek a přepněte **Aktivní** na neaktivní. Vzorek zůstane v databázi, ale zákazníkovi se nezobrazí.

**Q: Mohu u vzorku nastavit příplatek v procentech místo pevné částky?**\
A: Ano. Na vzorku nastavte **Typ příplatku** na „Procentuální". Musí ale odpovídat nastavení na konfiguraci – pokud je konfigurace nastavena na absolutní příplatek, příplatky vzorků by měly být také absolutní.

### Příplatky

**Q: Mohu mít u jedné konfigurace část možností zdarma a část s příplatkem?**\
A: Ano. U každé možnosti zadáte příplatek zvlášť. Možnost bez příplatku jednoduše nechte na hodnotě 0.

**Q: Jak je příplatek zobrazen zákazníkovi?**\
A: U každé možnosti se zobrazí výše příplatku (např. „+500 Kč"). Celková cena produktu se při výběru okamžitě přepočítá.

**Q: Příplatky se promítají do feedu a sitemap?**\
A: Ano. Pokud je u konfigurace zapnutý rozpad do feedu, každá možnost se do feedu dostane se svou výslednou cenou (základní cena + příplatek).

### Pokročilé chování

**Q: Co znamená „Rozpad do feedu"?**\
A: Každá možnost konfigurace se ve feedu zobrazí jako samostatná položka. Například produkt „Skříňka" s konfiguracemi „Bílá", „Šedá" a „Dub" se do feedu rozpustí jako tři položky.

**Q: Mohu předvyplnit výběr konfigurace z URL?**\
A: Ano, pokud je zapnuto **Mění URL**. Na stránku pak odkazujte s parametrem v URL (např. `?vzorek-dvirek=magnolia`) a zákazník uvidí předvyplněný výběr.

**Q: Co se stane, když smažu konfiguraci, která je přiřazena k produktům?**\
A: Konfigurace se odpojí od všech přiřazených produktů. Zákazníci ji přestanou vidět. Data ze starých objednávek zůstanou zachována.

## Praktické příklady

### Příklad 1: Kuchyňská linka s výběrem vzorků a montáže

1. **Vytvoření vzorníku:**
   * Vytvořte vzorník „ICA" s odstíny (Magnólie, Šedá, Bílá lesk…)
   * U každého odstínu nahrajte fotografii a nastavte příplatek
2. **Vytvoření konfigurací:**
   * Konfigurace „Vzorek dvířek" – typ **Výběr vzorníků**, vzorník „ICA"
   * Konfigurace „Montáž" – typ **Ano/Ne**, příplatek 1 500 Kč za „Ano"
   * Konfigurace „Výška nožiček" – typ **Seznam možností** (10 cm, 15 cm, 20 cm)
3. **Přiřazení k produktu:**
   * Otevřete produkt „Kuchyňská linka"
   * Na záložce **Konfigurace** přidejte všechny tři konfigurace
   * Nastavte pořadí: Vzorek → Výška → Montáž

### Příklad 2: Produkt s potiskem a nahráním grafiky

1. **Vytvoření konfigurací:**
   * Konfigurace „Vaše grafika" – typ **Nahrání souboru**; povolte obrázky + PDF, max. 20 MB
   * Konfigurace „Text produktu" – typ **Textové pole**, max. 50 znaků, příplatek 0
2. **Přiřazení k produktu:**
   * Obě konfigurace nastavte jako **Povinné při objednání**
   * Zákazník musí před přidáním do košíku vyplnit i nahrát soubor

### Příklad 3: Hromadné nasazení konfigurace na celou kategorii

Máte 30 produktů ve stejné kategorii a všechny mají stejnou konfiguraci „Montáž":

1. V sekci **Produkty** filtrujte produkty dle kategorie
2. Označte všechny pomocí hromadného výběru
3. **Hromadné akce → Hromadně nastavit konfigurace**
4. Přidejte konfiguraci „Montáž"
5. Potvrďte