# Formuláře

Modul **Formuláře** vám umožní jednoduše vytvářet a spravovat vlastní formuláře na e‑shopu, například:

* Kontaktní formulář
* Poptávkový formulář
* Formulář pro reklamace nebo vrácení zboží
* Přihlášku do soutěže či newsletteru

Bez programování si nastavíte:

* jaká pole má formulář obsahovat (jméno, e‑mail, telefon, zpráva, soubor…),
* texty e‑mailů, které přijdou vám (administrátorům) a zákazníkovi,
* jak se budou odeslané formuláře ukládat a jak je stáhnete.

### Kde najdu modul?

{% hint style="info" %}
Modul je nutné nejprve nainstalovat ve **Správci rozšíření**. 
{% endhint %}

V administraci e‑shopu přejděte do:

* **Formuláře → Formuláře** – správa všech formulářů (vytvoření, úprava, aktivace),
* **Formuláře → Odeslané formuláře** – přehled všech vyplněných formulářů od zákazníků.

Nastavení modulu najdete v:

* **Nastavení → Rozšíření → Formuláře**

## Jak vytvořit nový formulář

{% stepper %}
{% step %}

#### Založení formuláře

* V menu klikněte na **Formuláře → Formuláře**.
* Klikněte na tlačítko **Vytvořit formulář**.
  {% endstep %}

{% step %}

#### Vyplnění základních údajů

Vyplňte:

* **Název formuláře** – v administraci podle něj formulář poznáte (např. „Kontaktní formulář“).
* **E-maily na které se formulář odešle** – kam mají chodit oznámení o nových odeslaných formulářích.
  * Více e‑mailů oddělujte **středníkem** (např. `info@firma.cz; objednavky@firma.cz`).
  * Pokud pole necháte prázdné, použijí se výchozí příjemci z nastavení notifikací.
    {% endstep %}

{% step %}

#### Texty e‑mailů a pole formuláře

* Nastavte texty e‑mailů (viz kapitola E-maily po odeslání formuláře).
* Nastavte pole formuláře (viz kapitola Nastavení polí formuláře).
  {% endstep %}

{% step %}

#### Tlačítko a aktivace

* Zadejte **Text tlačítka pro odeslání** – co uvidí zákazník na tlačítku (např. „Odeslat“, „Odeslat dotaz“).
* V pravém panelu zkontrolujte přepínač **Aktivní formulář** – pokud je zapnutý, formulář může být na webu použit.
  {% endstep %}

{% step %}

#### Uložení

Klikněte na **Vytvořit** / **Uložit**.
{% endstep %}

{% step %}

#### Vložení na stránku

Formulář vložíte do stránky jako [nový blok](/navody/stranky-vytvareni-sekci.md).
{% endstep %}
{% endstepper %}

## Nastavení polí formuláře

V části **Definice polí** určujete, co všechno má zákazník vyplnit.

{% stepper %}
{% step %}

#### Přidání nového pole

* U formuláře sjeďte k sekci **Definice polí**.
* Klikněte na **Přidat pole**.
* Vyplňte:
  * **Popisek pole (label)** – text, který uvidí zákazník (např. „Jméno“, „E‑mail“, „Telefon“, „Vaše zpráva“).
  * **Název pole (name)** – interní název, generuje se automaticky podle popisku, můžete ho nechat tak, jak je.
  * **Typ pole** – určete, jaký typ vstupu to má být:
    * Text (krátký text, např. jméno),
    * E‑mail,
    * Telefon,
    * Checkbox (zaškrtávací políčko),
    * Textarea (delší text, např. zpráva),
    * Dropdown (rozbalovací seznam předpřipravených možností),
    * Soubor (nahrání přílohy, např. obrázek, PDF),
    * Nadpis (pouze text – pro rozdělení formuláře do sekcí).
  * **Pozice pole** – zda má být vlevo, vpravo nebo přes celou šířku (pouze pro rozložení do sloupců).
  * **CSS třída** – pro grafické úpravy vzhledu (můžete nechat prázdné, pokud neřešíte vlastní grafiku).
  * **Povinné pole** – zaškrtněte, pokud musí zákazník pole vyplnit (např. e‑mail).
    {% endstep %}

{% step %}

#### Možnosti pro dropdown (rozbalovací seznam)

Pokud vyberete typ **Dropdown**:

* Zobrazí se sekce **Možnosti dropdown**.
* Přes **Přidat možnost** přidejte jednotlivé volby (např. „Reklamace“, „Dotaz na produkt“, „Obchodní spolupráce“).
* U každé možnosti vyplňte:
  * **Hodnota (name)** – interní hodnota (můžete vyplnit bez diakritiky, např. `reklamace`),
  * **Zobrazený text** – co uvidí zákazník (např. „Reklamace“).
    {% endstep %}
    {% endstepper %}

## E-maily po odeslání formuláře

Po odeslání formuláře mohou odejít **dva typy e‑mailů**:

* **E-mail administrátorům** – upozornění, že někdo vyplnil formulář.
* **E-mail zákazníkovi** – potvrzení, že formulář úspěšně odeslal.

### E-mail pro administrátora

V detailu formuláře je pole **Text e-mailu pro administrátora**:

* Sem napište text, který přijde vám (např. „Byl odeslán nový kontaktní formulář z webu, viz detaily níže.“).
* Do e‑mailu se automaticky přidají i konkrétní vyplněná data z formuláře, abyste měli všechny informace pohromadě.

V záložce **Nastavení → Formuláře** můžete mít také obecně nastavené chování e‑mailů, ale pro každý formulář můžete text upravit zvlášť.

### E-mail pro zákazníka

V detailu formuláře:

* **Předmět e-mailu pro odesílatele** – např. „Děkujeme za váš dotaz“.
  * Pokud pole necháte prázdné, použije se výchozí předmět z nastavení modulu.
* **Text e-mailu pro odesílatele** – např. „Dobrý den, děkujeme za váš dotaz, ozveme se vám co nejdříve…“.

Zákazník tak získá potvrzení do své e‑mailové schránky, že byl formulář úspěšně odeslán.

## Odeslané formuláře (odpovědi zákazníků)

Všechny vyplněné formuláře se ukládají do administrace, abyste:

* nic neztratili, i kdyby e‑mail nedorazil,
* mohli kdykoli zpětně dohledat staré záznamy,
* mohli exportovat data nebo stáhnout přílohy.

{% stepper %}
{% step %}

#### Jak zobrazit odeslané formuláře

* V menu klikněte na **Formuláře → Odeslané formuláře**.
* V seznamu uvidíte:
  * **Název formuláře** (např. „Kontaktní formulář“),
  * **Datum odeslání**,
  * případně další přehledové údaje.
    {% endstep %}

{% step %}

#### Detail odeslaného formuláře

* Klikněte na vybraný záznam.
* Uvidíte:
  * výpis všech polí a vyplněných hodnot,
  * případné **připojené soubory** (můžete je stáhnout jednotlivě nebo najednou jako ZIP),
  * základní informace o čase odeslání.

Záznam můžete v případě potřeby smazat (např. kvůli GDPR nebo úklidu).
{% endstep %}
{% endstepper %}

## Nastavení souborů (příloh)

Pokud ve formuláři používáte typ pole **Soubor**, je vhodné zkontrolovat si omezení v nastavení modulu.

V administraci otevřete:

* **Nastavení → Formuláře**

Zde můžete nastavit:

* **Maximální velikost souboru (MB)** – např. 5 MB, 10 MB apod.,
* **Povolené typy souborů** – seznam přípon oddělených čárkou, např. `jpg,png,pdf,docx`.

Pokud zákazník zkusí nahrát příliš velký nebo zakázaný typ souboru, systém ho na to upozorní a soubor nepřijme.

## Často kladené otázky

<details>

<summary>Musím mít pro každý formulář programátora?</summary>

Ne. Běžné změny (název, texty, přidání/odebrání polí, povinné/nepovinné pole, text tlačítka) zvládnete v administraci sami.

</details>

<details>

<summary>Můžu mít více různých formulářů?</summary>

Ano. Můžete si vytvořit libovolný počet formulářů (např. Kontaktní, Reklamační, Poptávkový…) a každý zobrazit na jiné stránce.

</details>

<details>

<summary>Kam chodí e‑maily z formulářů?</summary>

Na e‑mailové adresy, které zadáte v poli **E-maily na které se formulář odešle**. Když pole necháte prázdné, použije se výchozí nastavení příjemců z modulu notifikací (typ Formuláře).

</details>

<details>

<summary>Co když e‑mail nedorazí?</summary>

I když e‑mail nedorazí (např. spadne do spamu), **odeslané formuláře najdete vždy v administraci** v sekci **Formuláře → Odeslané formuláře**.

</details>

<details>

<summary>Jak omezím špatné nebo nevyžádané soubory?</summary>

V **Nastavení → Formuláře** určete:

* maximální velikost souboru,
* seznam povolených přípon (např. jen `jpg,png,pdf`).

Systém ostatní soubory odmítne.

</details>

## Praktické příklady

#### Jednoduchý kontaktní formulář

* Vytvořte formulář s názvem **„Kontaktní formulář“**.
* Přidejte pole:
  * Jméno (text, povinné),
  * E‑mail (typ e‑mail, povinné),
  * Telefon (typ telefon, nepovinné),
  * Vaše zpráva (textarea, povinné).
* Nastavte text tlačítka na **„Odeslat dotaz“**.
* Vyplňte text e‑mailu pro administrátora a zákazníka.

Formulář pak vložte na stránku „Kontakt“ (obvykle pomocí připraveného bloku/komponenty).

#### Reklamační formulář s přílohou

* Vytvořte formulář **„Reklamace objednávky“**.
* Přidejte pole:
  * Číslo objednávky (text, povinné),
  * E‑mail (e‑mail, povinné),
  * Popis závady (textarea, povinné),
  * Přiložit fotografie (soubor, nepovinné – ale doporučené).
* V nastavení Formulářů povolte typy souborů `jpg,png,pdf` a nastavte limit velikosti (např. 10 MB).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://napoveda.rocketoo.cz/rocketoo/rozsireni/formulare.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.