# ELMO Forms

# Installation und Konfiguration

Das Plugin bindet ELMO-Anmeldeformulare in WordPress-/WooCommerce-Seiten ein.
Version 1.0.0, Dateien: `cszd-forms.php`, `cszd-mail.php`, `cszd-support.php`.

## Installation

1. Das Plugin-Verzeichnis nach `wp-content/plugins/` hochladen.
2. Unter *Plugins → Installierte Plugins* aktivieren.
3. Zu *Einstellungen → ELMO Forms* wechseln.

## Konfiguration

| Feld | Beschreibung |
|---|---|
| **Base URL** | Adresse der ELMO-Instanz, z. B. `https://elmo.piotrlitwa.com`. Wird ohne abschließenden Schrägstrich gespeichert. |
| **API Key** | Schlüssel aus dem ELMO-Panel, Format `cszd_xxxxxxxx…`. |

Ohne beide Werte werden die Formulare nicht dargestellt.

# Shortcode [elmo_form]

Grundlegende Verwendung — `uuid` ist das einzige erforderliche Attribut:

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

Ohne `uuid` gibt das Plugin eine rote Fehlermeldung statt des Formulars aus.

## Attribute

| Attribut | Standard | Beschreibung |
|---|---|---|
| `uuid` | — | **Erforderlich.** Kennung des Formulars in ELMO. |
| `height` | `400` | Höhe in Pixeln. |
| `width` | `100%` | Breite — Pixel oder Prozent. |
| `mode` | `iframe` | `iframe` oder `native`. |
| `title` | leer | Überschreibt den Titel aus ELMO. |
| `subtitle` | leer | Überschreibt den Untertitel aus ELMO. |

## Beispiel

```
[elmo_form uuid="a1b2c3" mode="native" height="520" title="Jetzt anmelden"]
```

Neben dem Shortcode stellt das Plugin ein Widget und einen Gutenberg-Block bereit.

# Dankeseite

Ein separates Formular, das an die WooCommerce-Dankeseite angehängt wird — typischerweise
eine Newsletter-Anmeldung im Austausch für einen Gutschein. Konfiguration unter
*Einstellungen → ELMO Forms*.

| Option | Standard |
|---|---|
| `elmo_forms_thankyou_uuid` | leer — **ohne diesen Wert erscheint der Abschnitt nicht** |
| `elmo_forms_thankyou_title` | „Dolacz do newslettera!" |
| `elmo_forms_thankyou_subtitle` | „Odbierz kupon rabatowy na nastepne zakupy." |

Titel und Untertitel überschreiben das, was aus ELMO kommt.