# ELMO Forms

# Instalace a konfigurace

Plugin vkládá registrační formuláře z ELMO na stránky WordPress/WooCommerce.
Verze 1.0.0, soubory: `cszd-forms.php`, `cszd-mail.php`, `cszd-support.php`.

## Instalace

1. Nahrajte adresář pluginu do `wp-content/plugins/`.
2. Aktivujte jej v *Pluginy → Instalované pluginy*.
3. Přejděte do *Nastavení → ELMO Forms*.

## Konfigurace

| Pole | Popis |
|---|---|
| **Base URL** | Adresa instance ELMO, např. `https://elmo.piotrlitwa.com`. Ukládá se bez koncového lomítka. |
| **API Key** | Klíč z panelu ELMO, formát `cszd_xxxxxxxx…`. |

Bez obou hodnot se formuláře nevykreslí.

# Shortcode [elmo_form]

Základní použití — jediný povinný atribut je `uuid`:

```
[elmo_form uuid="tvoje-uuid"]
```

Bez `uuid` plugin místo formuláře vykreslí červené chybové hlášení.

## Atributy

| Atribut | Výchozí | Popis |
|---|---|---|
| `uuid` | — | **Povinný.** Identifikátor formuláře v ELMO. |
| `height` | `400` | Výška v pixelech. |
| `width` | `100%` | Šířka — pixely nebo procenta. |
| `mode` | `iframe` | `iframe` nebo `native`. |
| `title` | prázdné | Přepíše nadpis přicházející z ELMO. |
| `subtitle` | prázdné | Přepíše podnadpis přicházející z ELMO. |

## Příklad

```
[elmo_form uuid="a1b2c3" mode="native" height="520" title="Přihlásit se"]
```

Kromě shortcode nabízí plugin také widget a blok pro Gutenberg.

# Děkovací stránka

Samostatný formulář připojený k děkovací stránce WooCommerce — typicky přihlášení k newsletteru
výměnou za slevový kupon. Konfigurace v *Nastavení → ELMO Forms*.

| Volba | Výchozí |
|---|---|
| `elmo_forms_thankyou_uuid` | prázdné — **bez toho se sekce nezobrazí** |
| `elmo_forms_thankyou_title` | „Dolacz do newslettera!" |
| `elmo_forms_thankyou_subtitle` | „Odbierz kupon rabatowy na nastepne zakupy." |

Nadpis a podnadpis přepíší to, co přichází z ELMO.