> For the complete documentation index, see [llms.txt](https://docs.premsoft.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.premsoft.de/plugins/formular-baukasten/installation.md).

# Installation

## Plugin installieren

1. Lade das Formular-Werkzeug im **Shopware Store** in deinen Shop.
2. Öffne im Admin **Erweiterungen → Mein Konto**.
3. Klicke beim Eintrag „PremSoft Formular-Werkzeug" auf **Installieren** und anschließend auf den Schalter, um es zu **aktivieren**.

Beim Installieren werden automatisch die nötigen Datenbank-Tabellen sowie der Medien-Ordner **Formular-Werkzeug Uploads** angelegt. Die E-Mail-Vorlagen „Neue Einsendung" und „Bestätigung für Kunden" werden beim ersten Aktivieren importiert.

## Plugin-Konfiguration

Öffne **Erweiterungen → Mein Konto → Formular-Werkzeug → Konfigurieren**.

### Allgemein

| Einstellung                    | Funktion                                                      |
| ------------------------------ | ------------------------------------------------------------- |
| Plugin für Verkaufskanal aktiv | Schaltet das Formular-Werkzeug pro Verkaufskanal ein und aus. |

### Uploads

| Einstellung                           | Funktion                                                                               |
| ------------------------------------- | -------------------------------------------------------------------------------------- |
| Medienordner für hochgeladene Dateien | Wohin Datei-Upload-Felder ihre Inhalte ablegen. Standard: „Formular-Werkzeug Uploads". |
| Erlaubte Dateiendungen                | Kommagetrennte Liste, z. B. `jpg, png, pdf`. Leer = alle Endungen erlaubt.             |

Die Allowlist greift sowohl im Browser (Auswahl-Dialog) als auch serverseitig (Validierung).

## Captcha

Das Plugin nutzt den Captcha-Standard von Shopware Core. Aktiviere deinen bevorzugten Captcha-Provider unter **Einstellungen → Storefront → Captcha**:

* **Honeypot** — unsichtbare Bot-Falle, kein Eingriff für Kund:innen
* **Basic Captcha** — Code-aus-Bild-Eingabe
* **Google reCAPTCHA v2 / v3** — externer Anbieter

Das Formular-Werkzeug bindet den aktiven Provider automatisch ein — du musst nichts pro Formular einstellen.

## Nächste Schritte

* [Quickstart](/plugins/formular-baukasten/quickstart.md) — vom Plugin zum ersten Formular
* [Verwaltungs-Dashboard](/plugins/formular-baukasten/verwaltungs-dashboard.md) — Formulare bauen
* [Storefront-Integration](/plugins/formular-baukasten/storefront-integration.md) — Formulare einbinden


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://docs.premsoft.de/plugins/formular-baukasten/installation.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.