Integration eines INQUIRY-Formulars
Inhalt
2.1 Konfiguration im Online-Servicebereich
2.2 Formular-Templates auswählen und bearbeiten
2.3 Aufruf des Formulars integrieren
3 Captcha für WEBSALE Formulare
Die folgende Anleitung zeigt anhand eines schematischen Beispiels, wie Sie ein INQUIRY-Formular in einen Subshop integrieren.
Hinweis: |
|
|
Eine detaillierte technische Beschreibung finden Sie in der separaten Dokumentation unter: |
Folgende Vorüberlegungen sollten Sie berücksichtigen, bevor Sie mit der Implementierung beginnen:
▪Welche erforderlichen und optionalen Templates sollen verwendet werden?
▪Welche Sicherheitsmerkmale sollen berücksichtigt werden?
▪Welche Eingabefelder sollen abgefragt werden?
▪Welche Eingabefelder sollen Pflichtfelder und welche optional sein?
▪Sollen nach erfolgreichem Absenden der Anfrage E-Mails an den Kunden versendet werden?
▪Soll nach erfolgreichem Absenden der Anfrage eine E-Mail an den Shopbetreiber versendet werden?
Standardmäßig besteht ein INQUIRY aus mindestens drei Komponenten: einer Konfigurationsdatei, einem Template für das Anfrage-Formular und einem für das Antwort-Formular. Weitere optionale Templates sind für E-Mails an Kunden und Shopbetreiber sowie für ein Antwort-PDF vorgesehen.
In den Materialien zum INQUIRY-Modul finden Sie Template-/Konfigurations-Sets, die nur noch angepasst werden müssen. Je nachdem, welche Sicherheitsmerkmale und weiteren E-Mail-Optionen Sie planen, können Sie ein entsprechendes Set wählen:
▪Kontaktformular mit PDF-Anhang
▪Kontaktformular mit Captcha-Sicherheitsabfrage
Materialien: Materialien zu INQUIRY
Die Shop-Integration umfasst 3 Schritte:
1.Konfiguration im Online-Servicebereich
2.Formular-Templates auswählen und anpassen
3.Aufruf des Formulars integrieren
2.1 Konfiguration im Online-Servicebereich
Jedes Anfrageformular (Inquiry) benötigt eine eigene Formular-Konfiguration, die Sie im Online-Servicebereich anlegen müssen.
Öffnen Sie im Online-Servicebereich die Konfiguration Ihres Shops. Klicken Sie auf den Tab "Formulare (Inquiry)" und wählen Sie in der Namensliste den Subshop, in dem Sie ein INQUIRY verwenden möchten.
Klicken Sie auf das Dokumentsymbol hinter dem Subshop-Namen. Geben Sie im daraufhin angezeigten Dialogfenster "Neue Konfiguration erstellen" eine selbst gewählte Bezeichnung ein (z. B. "anfrage", "anfrage_captcha_rechnen", je nachdem, welche Sicherheitsmerkmale Sie verwenden wollen). Klicken Sie auf "Erstellen" (Die Erweiterung ist immer config). Der Name für die neue Konfiguration wird jetzt links in der Navigation aufgelistet.
Klicken Sie auf den Namen und anschließend im rechten Teil des Fensters auf "Bearbeiten".
Passen Sie jetzt die Abschnitte Ihrer Formular-Konfiguration an. Eine Dokumentation aller Abschnitte und Parameter finden Sie hier:
Dokumentation: Formulare mit INQUIRY4
Haben Sie Ihre Einstellungen vorgenommen, speichern und aktivieren Sie die neue Konfiguration.
2.2 Formular-Templates auswählen und bearbeiten
Ein Anfrageformular (INQUIRY) enthält mindestens zwei Templates: das Anfrage-Formular und das Antwort-Formular. Weitere optionale Templates sind für E-Mails an Kunden und Shopbetreiber sowie für ein Antwort-PDF vorgesehen. WEBSALE V8s stellt Ihnen hierfür Vorlagen-Templates unter Materialien > Materialien INQUIRY zur Verfügung.
Materialien: Materialien zu INQUIRY
Entscheiden Sie, welche Templates Sie für Ihr Anfrageformular (Inquiry) benötigten und gehen Sie für jedes Template wie folgt vor:
1.Wählen Sie Materialien > Materialien INQUIRY und öffnen Sie den Ordner mit dem Namen des gewünschten Template-/Konfigurations-Sets
2.Wählen Sie ein Template mit der Dateiendung .htm und speichern Sie das Template unter dem angegebenen Namen in Ihr Templateverzeichnis, z. B. benutzer/templates/translation.
Achten Sie darauf, zusammengehörige Templates eines Sets zu wählen.
Führen Sie diesen Vorgang für jedes der benötigten Templates des gewählten Template-/Konfigurationssets aus. Als Ergebnis sind alle Templates des Sets mit der Dateiendung .htm in Ihrem Templateverzeichnis gespeichert.
Die gespeicherten Templates können Sie direkt verwenden oder mit einem HTML-Editor bearbeiten, um z. B. die Eingabefelder, Texte und Ihr Design anzupassen.
Weitere Details zur Bearbeitung der Templates sowie die Tag-Beschreibungen finden Sie den Abschnitten Eingabefelder für Formulare und Allgemeine Anfragefelder der separaten Dokumentation.
Dokumentation: Formulare mit INQUIRY4
2.3 Aufruf des Formulars integrieren
Um das Formular aufzurufen, fügen Sie an einer beliebigen Position im Shop den folgenden Link ein:
...
<a href="~WS-SSLLoadTpl(tpl_anfrage.htm)~">Zum Kontaktformular</a>
...
Referenz: WS-SSLLoadTpl()
3 Captcha für WEBSALE Formulare
Das Captcha (Akronym für "Completely Automated Public Turing Test to Tell Computers and Humans Apart") wurde eingeführt, um den Spam in Gästebüchern, Foren, Kontaktformularen usw. zu bekämpfen. Da Spam von sogenannten Robots eingetragen wird, welche eine Webseite nach Formularen durchsuchen, kann solcher "Datenmüll" mithilfe von Aufgaben abgefangen werden, die maschinell nicht oder nur mit sehr großem Aufwand lösbar sind.
Es gibt unterschiedliche Arten von Captchas, z. B. Rechenaufgaben, Eingabe willkürlicher Zahlenkombinationen und das Erkennen bestimmter Objekte auf Fotos.
Zu den von WEBSALE V8s unterstützten Captchas und Unterstützung von Google reCAPTCHA sowie "Friendly Captcha" siehe Dokumentation: Formulare mit INQUIRY4
Verweise
Materialien: Materialien zu INQUIRY4
Wegweiser: Formulare per AJAX nachladen und absenden
Wegweiser: Template-Typen: Inquiry-Templates
Anwendungsbeispiel: DSGVO-konforme Integration von Google reCAPTCHA