> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/apps/anpassbares-kontaktformular-fur-die-storefront/einrichtung.md).

# Einrichtung

## 1. Erweiterung installieren

Installieren Sie die Erweiterung über den Shopware Store oder laden Sie die ZIP-Datei unter **Erweiterungen > Meine Erweiterungen** hoch und aktivieren Sie sie.

## 2. Formular in eine Erlebniswelt einfügen

1. Öffnen Sie unter **Inhalte > Erlebniswelten** die gewünschte Seite.
2. Fügen Sie aus der Kategorie **Formular** den Block **(cogi) Anpassbares Formular** ein.
3. Öffnen Sie die Einstellungen des Elements über das Zahnrad. Ein neues Formular bringt die üblichen Kontaktfelder bereits mit.
4. Tragen Sie im Reiter **Formular** die Empfänger-Adressen ein und speichern Sie die Seite.

Mehr dazu unter [Kontaktformulare bearbeiten](/plugin-documentation/apps/anpassbares-kontaktformular-fur-die-storefront/kontaktformulare-bearbeiten.md).

{% hint style="info" %}
Bestehende Formulare aus einer älteren Version der Erweiterung bleiben funktionsfähig. In der Erlebniswelt bietet Ihnen die Seitenleiste an, sie mit einem Klick in das neue Element zu migrieren. Noch nicht migrierte Formulare sind in der [Formularübersicht](/plugin-documentation/apps/anpassbares-kontaktformular-fur-die-storefront/formularubersicht-und-empfanger.md) gekennzeichnet.
{% endhint %}

## 3. E-Mail-Versand prüfen

Ein eigener Flow ist nicht mehr nötig. Die Erweiterung verschickt jede Absendung direkt, solange in der Plugin-Konfiguration **E-Mail-Versand aktivieren** eingeschaltet ist. Das ist die Standardeinstellung.

Die Texte lassen sich unter **Einstellungen > E-Mail-Templates** anpassen. Die Erweiterung bringt dafür eigene Templates mit, die Sie mit dem Suchbegriff „Contact“ finden.

### Versand über den Flow Builder

Möchten Sie den Versand lieber selbst steuern, schalten Sie **E-Mail-Versand aktivieren** aus und legen im Flow Builder einen Flow mit dem Ereignis „Codegiganten / Contact Form / Submit“ und der Aktion „E-Mail senden“ an.

{% hint style="warning" %}
Lassen Sie nicht beides gleichzeitig laufen, sonst kommt jede Absendung doppelt an.
{% endhint %}

## 4. Plugin-Konfiguration

Die Einstellungen finden Sie unter **Erweiterungen > Meine Erweiterungen** bei der Erweiterung über **... > Konfiguration**.

| Bereich                 | Einstellung                  | Wofür                                                                                                                      |
| ----------------------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Spam-Schutz             | Gesperrte Wörter             | Enthält ein Feld eines dieser Wörter, lässt sich das Formular nicht absenden.                                              |
| Grundeinstellungen      | E-Mail-Versand aktivieren    | Direkter Versand durch die Erweiterung (siehe oben).                                                                       |
| Grundeinstellungen      | Reply-To-Header              | Eine Antwort auf die E-Mail geht direkt an den Kunden.                                                                     |
| Grundeinstellungen      | Kunden in CC setzen          | Der Kunde erhält die E-Mail in Kopie.                                                                                      |
| Grundeinstellungen      | Dateiupload Verzeichnis      | Medienordner für hochgeladene Dateien. **Pflicht, sobald ein Formular ein Upload-Feld hat.**                               |
| Grundeinstellungen      | Verzögerung des Buttons      | Der Absenden-Button wird erst nach dieser Zeit aktiv (mindestens 2000 Millisekunden).                                      |
| Weiterleitung           | Fallback-URLs                | Gelten nur, wenn das Formular keine eigene Weiterleitung hat.                                                              |
| Tracking                | Vorherige und aktuelle Seite | Zeigt in der E-Mail, von welcher Seite die Anfrage kommt.                                                                  |
| Medien-Bereinigung      | Dateien automatisch löschen  | Löscht hochgeladene Dateien nach einer festen Anzahl von Tagen.                                                            |
| Widerrufs-Konfiguration | Buttons und Zielseite        | Siehe [Widerrufsformular](/plugin-documentation/apps/anpassbares-kontaktformular-fur-die-storefront/widerrufsformular.md). |

{% hint style="info" %}
Sollten Sie Fragen haben oder Unterstützung bei der Einrichtung benötigen, kontaktieren Sie uns einfach.
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.codegiganten.de/plugin-documentation/apps/anpassbares-kontaktformular-fur-die-storefront/einrichtung.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.