Formulare – Überblick und Installation
Auf dieser Seite
SALEPIX Formulare ist ein Formular-Generator für JTL-Shop 5. Sie legen Formulare per Drag-and-Drop-Builder im Backend an, binden sie über einen Shortcode oder wahlweise automatisch per CSS-Selektor im Shop ein, sammeln eingehende Anfragen durchsuchbar in einem Archiv und schützen Ihre Formulare mit Cloudflare Turnstile oder dem JTL-Captcha vor Spam. Zusätzlich enthält das Plugin ein Angebotsanfrage-Modul: Kunden fragen auf der Artikelseite oder für den gesamten Warenkorb ein Angebot mit Wunschpreis an, Sie gewähren einen Rabatt und erzeugen mit einem Klick einen JTL-Kupon.
Was das Plugin bietet
- Formular-Generator mit Drag-and-Drop-Builder: Felder aus einer Palette in den Canvas ziehen, per Maus sortieren, im Eigenschaften-Panel bearbeiten.
- Formulare überall einbinden, entweder manuell über einen automatischen Shortcode oder automatisch über eine CSS-Selektor-Platzierung mit Bedingungen (Seitentyp, Kategorie, Kundengruppe, URL, Mindestsummen, Artikel-Funktionsattribut).
- Anfragen-Archiv: eingehende Formulardaten werden in der Datenbank gespeichert, inklusive Anhängen, und sind im Backend filterbar, durchsuchbar und als CSV exportierbar.
- Angebotsanfrage-Modul: Kunde fragt auf der Artikelseite oder im Warenkorb ein Angebot mit Wunschpreis an, Sie gewähren einen Rabatt und erzeugen einen JTL-Kupon, der Kunde übernimmt Artikel und Kupon per Link in den Warenkorb.
- Spamschutz per Cloudflare Turnstile oder JTL-Captcha, jeweils als eigenes Formularelement, das Sie in jedes Formular einfügen können.
- Newsletter-Anmeldung: ein Formularfeld kann direkt in die JTL-Newsletter-Anmeldung (inklusive Double-Opt-in nach Ihrer Shop-Einstellung) münden.
Admin-Menü
Nach der Installation finden Sie das Plugin im Menü Plugins → SALEPIX Formulare mit vier Reitern:
| Reiter | Inhalt |
|---|---|
| Forms | Formulare anlegen, bearbeiten, aktivieren; hier läuft der Drag-and-Drop-Builder und alle Formular-Einstellungen |
| Angebote | Eingegangene Angebotsanfragen verwalten: Rabatt gewähren, Kupon erzeugen, Angebot per Mail senden, Status setzen |
| Anfragen | Archiv aller eingegangenen Formular-Einreichungen mit Filtern und CSV-Export |
| Einstellungen | Aufbewahrungsdauer des Archivs, Cloudflare-Turnstile-Schlüssel, globale Schalter für die Angebotsanfrage |
Voraussetzungen
- JTL-Shop ab Version 5.2.0.
- Für den Betrieb ist eine gültige Lizenz für die jeweilige Shop-Domain erforderlich; ohne Lizenz zeigt das Plugin im Backend einen Hinweis mit einem Link zum Lizenzerwerb.
- Cloudflare Turnstile ist optional. Wird es genutzt, benötigen Sie ein kostenloses Cloudflare-Konto sowie Site Key und Secret Key (siehe eigener Artikel).
Installation
- Im JTL-Shop-Backend unter Plugins → Plugin-Manager in den Reiter Hochladen wechseln und die Plugin-ZIP hochladen.
- Das Plugin unter Verfügbar installieren.
- Anschließend unter Plugins → SALEPIX Formulare einrichten.
Beim Installieren, Aktivieren und Aktualisieren setzt das Plugin automatisch drei Standardwerte, sofern noch keine eigenen Werte gespeichert sind: Das Anfragen-Archiv ist aktiviert, Anhänge werden archiviert, und die Aufbewahrungsdauer beträgt 180 Tage. Außerdem richtet das Plugin bei Installation, Aktivierung und Aktualisierung automatisch einen JTL-Cronjob ein, der das Anfragen-Archiv täglich um 3:00 Uhr bereinigt (siehe Artikel „Anfragen-Archiv“). Voraussetzung dafür ist, dass der Cronjob-Dispatcher Ihres Shops aktiv ist, wie bei den meisten JTL-Shop-Installationen üblich.
Formular in den Shop einfügen
Jedes Formular erhält automatisch einen Shortcode der Form [salepix-forms id=N]. Diesen Code finden Sie sowohl in der Formularliste im Reiter Forms als auch beim Bearbeiten eines Formulars im Feld „Formular-Marker“ – von dort lässt er sich direkt kopieren. Der Marker kann überall dort eingefügt werden, wo im Shop Smarty-Templates oder Freitext-/WYSIWYG-Felder editierbar sind; an der Stelle des Markers erscheint im Shop je nach gewähltem Formular-Typ entweder das Formular direkt oder ein Button, der das Formular in einem Popup-Fenster öffnet. Alternativ kann ein Formular auch automatisch an einer bestimmten Stelle im Shop eingeblendet werden, ohne dass Sie ein Template bearbeiten müssen – siehe der Artikel „Formulare automatisch platzieren“.
Wenn ein Plugin-Update fehlschlägt
Scheitert ein Update des Plugins, entfernt JTL-Shop normalerweise die halb installierte neue Version inklusive aller Daten. SALEPIX Formulare erkennt diesen Fall: Ihre Formulare mit allen Feldern, die archivierten Anfragen, die Angebote mit ihren Positionen, alle Einstellungen und der Aufräum-Cronjob bleiben in diesem Fall erhalten und werden nicht gelöscht. Im Backend erscheint dazu ein Hinweis, dass nichts gelöscht wurde; SALEPIX wird zusätzlich automatisch über den Vorfall informiert, ohne dass dabei Kunden-, Besucher- oder Bestelldaten übermittelt werden.
Support
Bei Fragen erreichen Sie uns über das Kontaktformular auf salepix.de. Bitte nennen Sie die Plugin-Version und Ihre JTL-Shop-Version.
Frage nicht beantwortet?
Unser Support hilft Ihnen gerne weiter – bitte nennen Sie Plugin- bzw. Template-Version und Ihre JTL-Shop-Version.