...

Scroll export button

template-id	ef6af82b-f039-4de1-9c19-9b84d787fd5c
scope	current
caption	export to pdf
quick-start	true
add-on	Scroll PDF Exporter

INQUIRY4 ist ein WEBSALE-Programm zur Erstellung von individuellen Kontakt-, Support- und Serviceformularen für Ihren deinen WEBSALE-Onlineshop. Die Formulare können ganz nach Ihren deinen Anforderungen konfiguriert werden.

Formulare über INQUIRY4 können einfach und problemlos an verschiedenen Stellen in Ihr dein Shop-Frontend integriert werden. Auch Links zu den Formularen können überall platziert werden.

Das Look & Feel der Formulare kann mittels HTML und CSS individuell gestaltet werden.

Table of Contents

...

minLevel

...

1
maxLevel	6

...

exclude

include
outline	false
indent

...


type	list
class
printable	false

...

Einleitung

Zielgruppe für diese Dokumentation

Diese Dokumentation richtet sich an Personen, die entsprechendes Wissen über die Erstellung von HTML-Seiten besitzen und die Grundlagen von HTML kennenbeherrschen.

Allgemeine Anwendung des Programms

...

INQUIRY4 bearbeitet und kontrolliert die Eingaben von Anfrageformularen und sendet die Eingaben per E-Mail an einen Formularempfänger. Alternativ können alle Anfragen über den Online-Servicebereich (OSB) der von WEBSALE AG in der Übersicht und im Detail angesehen werden.

...

Der HTTP-Referer-Schutz ist von der WEBSALE AG für INQUIRY4 entwickelt worden, da es im Internet Anbieter gibt, die für deren Kunden automatisiert Formulare ausfüllen und so mit Leichtigkeit mehrere tausend Anfragen pro Stunde generieren können. Dies sind insbesondere Anbieter, die für ihre Kunden Gewinnspiele oder Kataloganfragen etc. automatisiert ausfüllen. Der solcherart an Ihrem Ein auf diese Art an deinem Gewinnspiel teilnehmende “Kunde“ kennt also weder Sie dich noch hat er Ihre deine Website angesehen noch hat er einem Newsletterversand zugestimmt und ist somit für Sie dich weitgehend wertlos.

Auch im Bereich Formulare für Kataloganforderung könnten durch solche Anbieter hohe Kosten ohne Nutzen generiert werden, da keine wirklich an Ihrem eurem Angebot interessierte Kunden die Kataloge erhalten würden.

...

CAPTCHA-Funktion der WEBSALE AG. Kein JavaScript erforderlich und stets verfügbar.
Der Anfragende muss eine kleine Rechenaufgabe lösen, um die Anfrage abzusenden
Externe CAPTCHA-Funktion „ReCaptcha“ mittels Bilderkennung und höchster Sicherheitsstufe. JavaScript ist erforderlich. Die Verfügbarkeit wird jedoch nicht garantiert. Der Anfragende muss eine Zeichenkette aus einem Bild ablesen und korrekt in ein Eingabefeld eingeben, um die Anfrage abzusenden.

SPAM-Vermeidung: Blacklisting

...

“Friendly Captcha”. Sie können das Friendly Captcha-Widget in Ihre Webanwendung einbauen, um Spam zu bekämpfen, ohne die Benutzerfreundlichkeit zu beeinträchtigen.
Friendly Captcha sendet dem Benutzer ein kryptografisches Rätsel, das Gerät des Benutzers benötigt einige Sekunden, um dieses zu lösen, der Benutzer muss nichts tun.

SPAM-Vermeidung: Blacklisting

Zur SPAM-Vermeidung können unterschiedliche Blacklists (z. B. auf Basis der IP-Adress Adresse oder des MX-Records) verwendet werden, um bestimmten, unerwünschten Anfragenden bzw. automatisierten Programmen das Absenden einer Anfrage zu unterbinden.

...

Nach Absenden des Formulars kann dem Benutzer angeboten werden, seine Anfrage als PDF herunterzuladen. Das Template, aus dem die PDF-Datei erzeugt wird, ist frei designbar.

...

Optional können zu einer Anfrage Dateien vom Benutzer hochgeladen werden. Dies wird durch Verwendung des WEBSALE-Upload-Moduls realisiert. Die hochgeladenen Dateien werden an die E-Mail angehängt, die dem Angefragten zugesendet wird, oder in einem eigenen FTP-Verzeichnis gespeichert.

Ein ausführliches Beispiel für ein Anmeldeformular mit Datei-Upload finden Sie in der Frontend-Dokumentation:

https://doku.websale.net/index.html?guide_uploadmodulfuerformulareinquiry.html

Wenn Sie das WEBSALE-Upload-Modul mit INQUIRY4 verwenden wollen müssen Sie dies für jedes Anfrageformular einzeln beauftragen!

...

Code Block
https://www.ihre-domain.de/cgi/INQUIRY4 inquiry4.cgi?inq4=<ihre-shopid>.<ihre subshopid>&cfg=Ihre<ihre-config

Im INQUIRY4-Aufruf müssen mindestens 2 Parameter übergeben werden: “inq4“ und „cfg“.

Parameter beim Aufruf eines Formulars

...

config>

Parameter

Beschreibung

inq4

Erforderlicher Aufruf-Parameter.

In diesem Parameter müssen Sie ihre ShopID und ihre SubShopID durch einen Punkt getrennt angeben.

cfg (veraltet: ".ini")

Erforderlicher Aufruf-Parameter.

Den Namen der Konfigurationsdatei, z. B. „anfrage.config".

m

Optionaler Parameter

Wenn Sie INQUIRY4 in Verbindung mit einem WEBSALE E-Commerce-Testshop oder DevPack verwenden wollen, müssen Sie im Parameter "m" die MallID angeben, z. B. m=test oder m=devpack.

Weitere, optionale Parameter

...

Inquiry-URL:

Code Block
.../cgi/INQUIRY4 inquiry4.cgi?inq4=Ihre<ihre-ShopIDshopid>.Ihre<ihre-SubShopIDsubshopid>&cfg=Ihre<ihre-configconfig>&first_name=Wolfgang

Info
Wichtig: Bei eingeschaltetem aktivem Refererschutz (s. Kapitel “Refererschutz“) und dabei übergebenem ungültigem Referer werden keine Parameter übernommen.

Spezielle Parameter

Parameter	Beschreibung
a_dateofbirth_day a_dateofbirth_month a_dateofbirth_year	Geburtsdatum der Rechnungsadresse Diese Parameter werden verwendet, um Geburtsdaten zu übergeben, wenn automatisch generierte Listboxen zum Einsatz kommen.
d_dateofbirth_day d_dateofbirth_month d_dateofbirth_year	Geburtsdatum der Lieferadresse Diese Parameter werden verwendet, um Geburtsdaten zu übergeben, wenn automatisch generierte Listboxen zum Einsatz kommen.
ref	Angabe eines Referers Dient statistischen Zwecken. Dieser Aufrufparameter sollte nicht verwechselt werden mit dem Konfigurationsparameter “Referer“, der sich auf den HTTP-Referer bezieht (siehe Kapitel „Konfigurationsdatei“ und Kapitel „Refererschutz“).
subref	Angabe eines SubReferers. Dient statistischen Zwecken
a-userindex	Angabe des Userindexes, nur in Verbindung mit dem WEBSALE-Shop.
a-userid	Angabe der User-ID, nur in Verbindung mit dem WEBSALE-Shop.
immediate	Erlaubt “One-Klick“-Anfragen. Wenn dieser Parameter auf „yes“ gesetzt ist, werden die mit dem Aufruf des Formularprogramms übergebenen Parameter auf Vollständigkeit geprüft und dann die Anfrage sofort ausgeführt, ohne dass der Anfragende ein Anfrageformular zum Ausfüllen sieht. Er bekommt also unmittelbar die Bestätigungsseite angezeigt. WICHTIG: Der Parameter “immediate“ wird nur bei aktivem Refererschutz (siehe 3.1 Refererschutz) verarbeitet!

Grundlagen für Anfrageformulare

...

Dieser Dokumentation liegen folgende Beispiele bei:

Fallbeispiel	Beispieldateien
Standardanfrage in eigener Seite mit Download der Anfrage als PDF, Popup oder iFrame	anfrage.config anfrage.htm anfrage.hmail antwort.htm antwort_pdf.htm antwort.hmail
Standardanfrage integriert in WEBSALE E-Commerce mit WS-ExternInclude	externinclude_anfrage.config externinclude_anfrage.htm externinclude_antwort.htm tpl_externinclude_anfrage.htm antwort.hmail anfrage.hmail
Standardanfrage in eigener Seite, Popup oder iFrame mit CAPTCHA-Funktion Rechenaufgabe zur SPAM-Vermeidung	anfrage_captcha_rechnen.config anfrage_captcha_rechnen.htm antwort.htm antwort.hmail anfrage.hmail

Erläuterung der einzelnen Beispieldateien:

Datei	Beschreibung
anfrage.config	Konfigurationsdatei einer Standardanfrage
anfrage.htm	Anfrageseite einer Standardanfrage
antwort.htm	Antwortseite einer Standardanfrage
antwort_pdf.htm	HTML-Template für die Erzeugung der PDF-Datei
antwort.hmail	HTML-E-Mail-Template an den Anfragenden einer Standardanfrage
anfrage.hmail	HTML-E-Mail-Template an den Angefragten einer Standardanfrage
externinclude_anfrage.htm	Anfrageseite einer Standardanfrage, welche mit ExternInclude eingebunden wird
externinclude_anfrage.config	Konfigurationsdatei einer Standardanfrage, welche mit ExternInclude eingebunden wird
externinclude_antwort.htm	Antwortseite einer Standardanfrage, welche mit ExternInclude eingebunden wird
tpl_externinclude_anfrage.htm	Shoptemplate auf dem eine Standardanfrage mit ExternInclude eingebunden wird
anfrage_captcha_rechnen.config	Konfigurationsdatei einer Standardanfrage mit CAPTCHA-Funktion Rechenaufgabe
anfrage_captcha_rechnen.htm	Anfrageseite einer Standardanfrage mit CAPTCHA-Funktion Rechenaufgabe

Speicherort der benötigten Dateien

...

Beschreibung der Parameter:

Parameter	Beschreibung	Werte
InquiryPage	Name der HTML-Anfrageseite.	Dateiname z. B. anfrage.htm
ConfirmPage	Name der HTML-Antwortseite.	Dateiname z. B. antwort.htm
CommonInputRequired	Wenn Sie diesen Parameter auf "yes" setzen, dann muß mindestens ein allgemeines Anfragefeld vom Anfragenden ausgefüllt worden sein, ansonsten erfolgt eine entsprechende Fehlermeldung.	[yes][no]
Language	Die gewünschte Sprache für Anrede und Titel im ISO-Code.	3-stelliger Länder ISO-Code, z. B. DEU
CountryDat	Optionaler Parameter Hier können Sie die Länder-Konfigurationsdatei aus ihrem WEBSALE-Shop verwenden.	Dateiname, z. B. country.dat
SalutationDat	Optionaler Parameter Hier können Sie die Anrede-Konfigurationsdatei aus ihrem WEBSALE-Shop verwenden.	Dateiname, z. B. salutation.dat
TitleDat	Optionaler Parameter Hier können Sie die Titel-Konfigurationsdateiaus ihrem Websale-Shop verwenden.	Dateiname, z. B. title.dat
Referer	Optionaler Parameter Hier können Sie verschiedeneURLs, jeweils durch Komma getrennt, angeben. Eine Referer-URL dient dem Schutz vor unerwünschten automatisierten Anfragen und ist von der Behandlung her einzustufen wie ein Passwort, d. h. ein Referer ist vertraulich zu behandeln. (s. Kapitel “Refererschutz“) Durch Angabe einer oder mehrerer URLs wird der Refererschutz eingeschaltet. Wenn nichts angegeben wird, nimmt INQUIRY4 alle übergebenen Parameter an, der Refererschutz ist damit ausgeschaltet!	URL, www.ihr-shop.de
WSOMAllow	Wenn Sie diesen Parameter auf „yes“ setzen, dann werden alle erzeugten Anfragen vom WSOM (WEBSALE Order Manager) verarbeitet und können somit über den WSOM in Warenwirtschaftssysteme automatisiert eingelesen werden. Anwendungsbeispiel: Anfrage zur Zusendung eines Katalogs.	[yes][no]
TransferEmptyValues	Wenn Sie diesen Parameter auf „yes“ setzen werden alle leeren Felder der Anfrage mit übergeben. Steht dieser Parameter auf "no" so werden leere Felder nicht mit übergeben. Dies betrifft die Tags AUTOGENERATE-Full, AUTOGENERATE-Addr, AUTOGENERATE-Common, AUTOGENERATE-Readable und AUTOGENERATE-Technical sowie die Datenübergabe an den WSOM. Wenn die Anfragedaten durch den WSOM abgeholt werden und optionale Felder in dem Anfrageformular vorhanden sind kann durch die Übertragung der leeren Felder eine einheitliche Felderdefinition erreicht werden.	[yes][no]
Charset	Hier geben Sie den Zeichensatz der Anfrage an. Dieser Zeichensatz wird auch für die erzeugten E-Mails verwendet, wenn in den entsprechenden Sektionen kein anderer Zeichensatz angegeben ist. Der Parameter muss vorhanden sein, um Konvertierungen in UTF-8 per Tag durchführen zu können.	Zeichensatz, z. B. ISO-8859-1
TextAreaWrap	Hier können Sie angeben nach wie vielen Zeichen die Ausgabe einer Textarea in den E-Mails umgebrochen werden soll. Ist dieser Wert 0 erfolgt kein automatischer Umbruch.	Zeichenanzahl, z. B. 30 Standard: 30
NoEmptyCountryListboxEntry	Hier können Sie festlegen ob der erste Eintrag in der Listbox zur Länderauswahl ein leerer Eintrag sein soll. yes: Es wird kein leerer Eintrag erzeugt, der erste Eintrag ist "vorausgewählt". no: Der erste Eintrag wird als leerer (nicht ausgewählter) Eintrag erzeugt.	[yes][no] Standard: no
PresetSTC	Hier können Sie festlegen ob Anrede, Titel und Land vorausgefüllt sein sollen, wenn INQUIRY per ExternInclude eingebunden wird.	[yes][no] Standard: yes
VS4Allow	Hier können Sie festlegen ob Anfragen an das VS/4 weitergeleitet werden sollen.	[yes][no] Standard: yes
InquiryFormatMinorVersion	Parameter zur Beeinflussung von nicht abwärtskompatiblen Änderungen des technischen Ausgabeformats. Momentan max. verwendet: Wert 2. Für Werte >= 2 gilt: In der technischen Übergabe von Textarea-Daten wird als Sektionsname <Value> anstelle von <value> verwendet.	[1][2] Standard: 1

Angaben zur Bestätigungs-E-Mail an den Anfragenden

...

Code Block

<ConfirmEmail>
  SendEmail           	= yes
  EmailSubject        	= Ihre Anfrage
  SenderEmail          	= abc@domain.de  
  SenderName          	= Firma XYZ  
  charset             	= ISO-8859-1    
  EmailTemplate       	= confirm.hmail
  UseExternMailSystem	= no
  ExternMailTemplate	=
</ConfirmEmail>

Parameter	Beschreibung	Werte
SendEmail	Legt fest, ob an den Anfragenden eine Bestätigungsemail geschickt wird. Wenn der Wert von SendEmail userselect ist, muss die Sektion <SendUserEmail> vorhanden sein, in welcher das zugehörige HTML-Element zur Auswahl definiert ist.	[yes][no][userselect]
EmailSubject	Der Betreff der E-Mail.	Text, z. B. Ihre Anfrage
SenderEmail	Die E-Mail-Adresse des Absenders.	E-Mail-Adresse, abc@domain.de
SenderName	Der Name des Absenders.	Text, z. B. Firma XYZ
Charset	Optionaler Parameter Der in der E-Mail verwendete Zeichensatz. Wichtig für die sprachabhängig korrekte Darstellung der Mailtexte beim Empfänger. Ist der Parameter nicht angegeben wird der globale Zeichensatz (Parameter Charset in der Sektion Basic) verwendet.	ISO-Zeichensatz, z. B. ISO-8859-1
EmailTemplate	Das HTML-Template der E-Mail. Weitere Informationen zu “Tags und Templates“ finden Sie im entsprechenden Abschnitt dieses Dokuments.	Dateiname, z. B. confirm.hmail
UseExternMailSystem	Bei Verwendung eines Drittanbieters für den E-Mail-Versand wird dieser Anbieter hier angegeben. Standard ist „no“, d. h., das Shop-eigene Mail-System wird verwendet.	[no][InxMail], Standard: no
ExternMailTemplate	Template, auf dem das JSON-Objekt zur Übergabe an den externen Mail-Anbieter, z. B. InxMail, angelegt wird	Dateiname

Angaben zur Anfrage-E-Mail

...

Code Block

<InquiryEmail>
  SendEMail          	= yes
  EmailSubject       	= Anfrage
  EmailAddress        	= ihreAdresse@ihre-domain.de
  charset	            = ISO-8859-1
  EmailTemplate       	= templates/request.hmail
  SenderAddress	        = optionaleAnfrageadresse@ihre-domain.de
  UseExternMailSystem	= no
  ExternMailTemplate	=
</InquiryEmail>

Parameter	Beschreibung	Werte
SendEmail	Legt fest, ob an den Angefragten eine Bestätigungs-E-Mail geschickt wird.	[yes][no]
EmailSubject	Der Betreff der E-Mail.	Text, z. B. Ihre Anfrage
EmailAddress	Die E-Mail-Adresse zu der die Anfrage gesendet wird. Es können auch mehrere Adressen, durch Komma getrennt, angegeben werden.	E-Mail-Adresse, abc@domain.de
Charset	Optionaler Parameter Der in der E-Mail verwendete Zeichensatz. Ist der Parameter nicht angegeben, so wird der globale Zeichensatz (Parameter Charset in der Sektion „Basic“) verwendet.	ISO-Zeichensatz, z. B. ISO-8859-1
EmailTemplate	Das HTML-Template der E-Mail. Weitere Informationen zu Tags und Templates finden Sie in dieser Dokumentation.	Dateiname, z. B. confirm.hmail
SenderAddress	Optionale Absenderadresse. Ist diese Adresse angegeben, so wird sie als Absenderadresse verwendet. Die vom Benutzer eingegebene Adresse wird dann als Antwortadresse verwendet.	E-Mail-Adresse, abc@domain.de
UseExternMailSystem	Bei Verwendung eines Drittanbieters für den E-Mail-Versand wird dieser Anbieter hier angegeben. Standard ist „no“, d. h., das Shop-eigene Mail-System wird verwendet.	[no][InxMail], Standard: no
ExternMailTemplate	Template, auf dem das JSON-Objekt zur Übergabe an den externen Mail-Anbieter, z. B. InxMail, angelegt wird	Dateiname

PDF-Download der Anfrage

Alle Einstellungen zur PDF-Erzeugung sind in der Sektion <PDF> zu finden.

Code Block
<PDF> Allow = yes Template = antwort_pdf.htm Filename = anfrage.pdf </PDF>

Parameter

Beschreibung

Werte

Allow

Legt fest ob die Anfrage als PDF heruntergeladen werden kann.

[yes][no],

Standard: no

Template

Name des HTML-Templates welches für die PDF-Erzeugung verwendet wird.

Dateiname, z. B. antwort_pdf.htm

Filename

Der Dateiname der erzeugten PDF-Datei.

Dateiname, z. B. anfrage.pdf

Konfiguration des WEBSALE-Upload-Moduls

...

Code Block
<Upload> Allow = yes UploadIni = upload.config UploadDescr = Anhänge AttachUploadsToInquiryEMail-Allow = yes </Upload>

Parameter	Beschreibung	Werte
Allow	Legt fest, ob die Uploadfunktion verwendet werden soll	[yes][no], Standard: no
UploadIni	Konfigurationsdatei des WEBSALE-Upload-Moduls	Dateiname, z. B. upload.config
UploadDescr	Dieser Text erscheint in den automatisch erzeugten Anfragedaten als Text über der Liste der hochgeladenen/angehängten Dateien.	Text, z. B. Anhänge
AttachUploadsToInquiryEMail-Allow	Erlaubt Datei-Anhänge an Mails	[yes][no], Standard: no

Ein ausführliches Beispiel für ein Anmeldeformular mit Datei-Upload finden Sie in der Frontend-Dokumentation:

https://doku.websale.net/index.html?guide_uploadmodulfuerformulareinquiry.html

Konfiguration der CAPTCHA-Funktionalität

Konfiguration

...

Die Einstellungen zur CAPTCHA-Funktion der Rechenaufgabe sind in der Sektion <Captcha> zu finden.

...

Sie können als CAPTCHA-Funktionalität entweder die Rechenaufgabe, das ReCaptcha- oder das ReCaptchaFriendly-Captcha-Verfahren verwenden.

Parameter	Beschreibung	Werte
UseArithmeticCaptcha	Legt fest ob die CAPTCHA-Funktion in Form einer Rechenaufgabe verwendet werden soll.	[yes][no], Standard: no
UseRecaptchaCaptcha	Wenn Sie als CAPTCHA-Funktion die Rechenaufgabe verwenden möchten, muss dieser Parameter auf "no" stehen!	[yes][no], Standard: no
CaptchaDescription	Dieser String beschreibt die CAPTCHA-Funktionalität und kann auf dem Template ausgegeben werden.	Text, z. B. Eine kleine Rechenaufgabe
CaptchaNotFilledIn	Dieser Fehlerstring wird angezeigt, wenn das CAPTCHA-Eingabefeld nicht ausgefüllt wurde.	Text, z. B. Bitte lösen Sie die Rechenaufgabe
CaptchaError	Dieser Fehlerstring wird angezeigt, wenn das CAPTCHA-Eingabefeld falsch ausgefüllt wurde.	Text, z. B. Die Rechenaufgabe wurde nicht gelöst

Die CAPTCHA-Funktion in Form einer Rechenaufgabe stellt die drei Grundrechenarten Addition, Subtraktion und Multiplikation zur Verfügung. Diese drei Grundrechenarten werden standardmäßig mit vorgegebenen Wertebereichen verwendet. Sie können allerdings die Einstellungen für jede dieser Grundrechenarten individuell konfigurieren. Dazu können Sie folgende drei Sektionen verwenden:

Parameter	Beschreibung	Werte
CaptchaOperation+	Addition
CaptchaOperation-	Subtraktion
CaptchaOperation*	Multiplikation

Beispiel:

Code Block
<CaptchaOperation+> Allow = yes Operand1RangeStart = 1 Operand1RangeEnd = 9 Operand2RangeStart = 1 Operand2RangeEnd = 9 +Sign = plus +Sign = + +Sign = und </CaptchaOperation+>

Parameter	Beschreibung	Werte
Allow	Legt fest ob diese Grundrechenart verwendet wird.	[yes][no], Standard: yes
Operand1RangeStart	Legt den kleinsten Wert des ersten Operanden fest. (optional)	Zeichenanzahl, z. B. 1
Operand1RangeEnd	Legt den größten Wert des ersten Operanden fest. (optional)	Zeichenanzahl, z. B. 9
Operand2RangeStart	Legt den kleinsten Wert des zweiten Operanden fest. (optional)	Zeichenanzahl, z. B. 1
Operand2RangeEnd	Legt den größten Wert des zweiten Operanden fest. (optional)	Zeichenanzahl, z. B. 9
+Sign	Bis zu 10 Einträge je Grundrechenart werden unterstützt. Ist mindestens ein Eintrag einer Grundrechenart vorhanden werden die standardmäßig konfigurierten Strings nicht mehr verwendet! Eine textuelle Repräsentation der Rechenoperation.	Text, z. B. plus

Konfiguration Google ReCaptcha (Version 3)

...

Code Block

<Captcha>
  ...
  UseReCaptchaV3 	        = yes
  Site-Key                  =    # z. B. 6Le0SJsUxxxxxxxxxxxxxxxxx_xxxxxxxxxxxxxx
  Secret-Key                =    # z. B. 6Le0SJsUxxxxxx_xxxxxxxxxxxxxxxxxx_xxxxxx
  Api-Url 	                = https://www.google.com/recaptcha/api.js	
  Verify-Url 	            = https://www.google.com/recaptcha/api/siteverify	
  CaptchaV3EmptyToken 	    = Token ist leer	            #
  CaptchaV3EmptySecretKey 	= Secret-Key ist nicht gesetzt	#
  CaptchaV3ResponseError 	= Recaptcha Response ist false	#
  CaptchaV3ScoreError 	    = Score ist weniger als 0.5 	#
  CaptchaV3ActionName 	    =    # z. B. kontakt
  CaptchaV3TechnicalProblem = Techn. Problem, keine Verbindung
  CustomScore	            =    # Wert von 0.1 – 1.0; Standard: 0.5
  ...
</Captcha>

Parameter	Beschreibung	Werte
UseReCaptchaV3		[yes\|no]; Standard: no
Site-Key	Site-Key, wird von Google bezogen
Secret-Key	Secret-Key, wird von Google bezogen
Api-Url	Standardwert von Google	https://www.google.com/recaptcha/api.js
Verify-Url	Standardwert von Google	https://www.google.com/recaptcha/api/siteverify
CaptchaV3EmptyToken	Fehlermeldung, wenn Token leer ist	Text, z. B. Token ist leer
CaptchaV3EmptySecretKey	Fehlermeldung, wenn Secret-Key nicht gesetzt ist	Text, z. B. Secret-Key ist nicht gesetzt
CaptchaV3ResponseError	„Success“-Parameter in Response ist "false"	Text, z. B. Recaptcha Response ist false
CaptchaV3ScoreError	„Score“-Parameter in Response ist weniger als 0.5	Text, z. B. Score ist weniger als 0.5
CaptchaV3ActionName	ActionName für Seite (z. B homepage, login ...)	Text, z. B. Kontakt
CaptchaV3TechnicalProblem	Fehlermeldung bei technischem Problem	Text, z. B. Techn. Problem, keine Verbindung
CustomScore	Recaptcha Custom Score (0.1 – 1.0), wir vergleichen diesen Wert mit der Response von Google, um zu prüfen, ob Form gültig ist	Zeichenanzahl, z. B. 30 Standard: 0.5.

Konfiguration

...

Friendly Captcha

Friendly Captcha sendet dem Benutzer ein kryptografisches Rätsel, das Gerät des Benutzers benötigt einige Sekunden, um dieses zu lösen, der Benutzer muss nichts tun.

Code Block
<Filter><Captcha> IP-Blacklisting = both IP-Blacklist = ip.blacklist MX-Blacklisting = both MX-Blacklist = mx.blacklist ErrorMessage = Ihre IP-Adresse ist gesperrt </Filter>

...

Parameter

...

Beschreibung

...

Werte

...

IP-Blacklisting

...

Legt fest ob geprüft werden soll, ob die IP-Adresse des Anfragenden auf einer
Blacklist steht. Ist dies der Fall, kann der Anfragende die Anfrage nicht absenden:

none: keine Prüfung

global: Es wird nur die globale, von der WEBSALE AG gepflegte Blacklist verwendet

(Für weitere Informationen kontaktieren Sie bitte WEBSALE AG)

local: Es wird nur die lokal angegebene Blacklist verwendet

both: Es wird die lokale und die globale Blacklist verwendet

...

[none][global][local][both]
Standard: none

...

IP-Blacklist

...

Die lokale Blacklist für IP-Adressen wird verwendet, wenn für den Parameter IP-Blacklisting "both" oder "local" gesetzt ist.

...

ip.blacklist

...

MX-Blacklisting

...

Legt fest, ob geprüft werden soll, ob einer der MX-Einträge der E-Mail-Adressen des Anfragenden (soweit vorhanden) auf einer Blacklist steht. Ist dies der Fall, kann der Anfragende die Anfrage nicht absenden.

Dies ist vor allem gegen sogenannte "Gewinnspielclubs" ein Ansatz, Spam zu vermeiden!

none: keine Prüfung

global: Es wird nur die globale, von der WEBSALE AG gepflegte Blacklist verwendet

(Für weitere Informationen kontaktieren Sie bitte WEBSALE AG)

local: Es wird nur die lokal angegebene Blacklist verwendet

both: Es wird die lokale und die globale Blacklist verwendet

...

[none][global][local][both]
Standard: none

...

MX-Blacklist

...

Die lokale Blacklist mit MX-Einträgen, wird verwendet, wenn für den Parameter MX-Blacklisting "both" oder "local" gesetzt ist. Sie kann sowohl Domains als auch IP-Adressen beinhalten.

...

mx.blacklist

...

ErrorMessage

...

Dieser Fehlerstring wird angezeigt, wenn der Anfragende aufgrund einer Blacklist die Anfrage nicht absenden kann.

...

Text, z. B. Ihre IP-Adresse ist gesperrt

Info

Format der Blacklist-Dateien
Pro Zeile kann ein Eintrag stehen, Kommentarzeichen ist #.

Domains
Für Domaineinträge kann ein beliebiger Teil der zu sperrenden Domain angegeben werden.

IP-Adressen
Es können sowohl Bereiche als auch einzelne IP-Adressen angegeben werden.

Beispiel:

Code Block

##########################
# Blacklist für MX-Records
##########################

##########################
# Sperren von Domains:
##########################
# Sperre der Domain xyz.de (Achtung hier wird auch abcxyz.de mit gesperrt!):
xyz.de

# Sperren der Subdomains von xyz.de (Achtung xyz.de wird nicht mitgesperrt, aber z. B. mx0.xyz.de):
.xyz.de

# Sperren von *.abc.xyz.de
.abc.xyz.de

#######################
# Sperren von IP-Adressen
#######################

# Sperre des IP-Bereichs von 13.0.0.0 - 13.255.255.255
13.

# Sperre des IP-Bereichs von 172.16.1.0 - 172.16.1.255
172.16.1.

# Sperren der einzelnen IP-Adresse 172.16.1.10
172.16.1.10

# Teilbereichssperren wie z. B. 172.16.5.12 - 172.16.7.22 sind nicht möglich!

Fehlermeldungen für den Anwender

Alle konfigurierbaren Fehlermeldungen sind in der Sektion <ErrorMessages> zu finden.

Code Block

<ErrorMessages>
  Error    			  = Um Ihre Anfrage bearbeiten zu können, prüfen Sie bitte folgende Angaben:
  AddressEmailError   = Rechnungsanschrift: Ungültige E-Mail-Adresse
  DeliverEmailError   = Lieferanschrift: Ungültige E-Mail-Adresse
  CommonInputMissing  = Treffen Sie bitte ihre Wahl / machen Sie folgende Angaben
  NoInput     		  = Füllen sie bitte mindestens ein Feld aus
</ErrorMessages>

...

Parameter

...

Beschreibung

...

Werte

...

Error

...

Dieser Fehlerstring wird immer angezeigt, wenn mindestens eine Eingabe fehlt oder falsch ist. Darunter werden dann die Details zu dem (den) Fehler(n) gezeigt.

...

AddressEmailError

...

Dieser Fehlerstring wird angezeigt, wenn die Überprüfung der E-Mail-Adresse der Rechnungsadresse fehlschlug.

...

DeliverEmailError

...

Dieser Fehlerstring wird angezeigt, wenn die Überprüfung der E-Mail-Adresse der Lieferadresse fehlschlug.

...

CommonInputMissing

...

Dieser Fehlerstring wird angezeigt, wenn der Benutzer keine Eingaben in einem allgemeinen Anfragefeld (keine Adressdaten) gemacht hat und die Option

Code Block
<Basic> ... CommonInputRequired = yes ... </Basic>

gesetzt ist. Dieser Fehlerstring kann auch leer sein. Die Fehlermeldung wird dann nie angezeigt.

...

Text, z. B. Treffen Sie bitte ihre Wahl / machen Sie folgende Angaben

...

NoInput

...

Dieser Fehlerstring wird angezeigt, wenn überhaupt keine Eingabe gemacht wurde, weder in allgemeinen Feldern noch in Adressfeldern. Dieser Fehlerstring kann auch leer sein. Die Fehlermeldung wird dann nie angezeigt.

...

Text, z. B. Füllen Sie bitte mindestens ein Feld aus

Allgemeine Anfragefelder

INQUIRY4 kann in einem Formular bis zu 1000 allgemeine Anfragefelder bearbeiten. Ein allgemeines Anfragefeld hat folgende Form:

Code Block
<+CommonInput> Allow = yes Type = CheckBox Name = beratung Descr = Ich möchte Beratung Required = no Hide = yes Max = 100 </+CommonInput>

...

Parameter

...

Beschreibung

...

Werte

...

Allow

...

Wenn Sie diesen Parameter auf "yes" setzen, dann wird das Feld von INQUIRY4 bearbeitet und kontrolliert. Bei "no" wird das Eingabefeld nicht bearbeitet bzw. ignoriert.

...

[yes|no];

Standard: yes

...

Type

...

Typ des Eingabefeldes.

...

Text (einzeilige Textfelder)
TextArea (Mehrzeilige Textfelder)
CheckBox
RadioButton
ListBox

...

Name

...

Name des Eingabefeldes, welches Sie im HTML-Formular vergeben.

Bitte beachten Sie:

Die Namen der Eingabefelder müssen für das gesamte Formular eindeutig sein. Ein Feldname, z. B. "beratung", darf somit nicht mehrmals vorkommen. Die Namen der allgemeinen Anfragefelder dürfen nicht mi „A-“ oder „D-“ beginnen.

...

Text, z. B. beratung

...

Descr

...

Textuelle Beschreibung des Feldes. Dieser Text erscheint in den E-Mails.

...

Text, z. B. Ich möchte Beratung

...

Required

...

Wenn Sie diesen Parameter auf "yes" setzen, dann muß dieses Feld vom Anfragenden ausgefüllt oder markiert werden.

...

[yes][no];

Standard: no

...

Hide

...

Wenn dieser Parameter auf „yes“ gesetzt wird, wird dieses Feld NICHT in einer automatisch generierten E-Mail erzeugt.

...

[yes][no];

Standard: no

...

Max

...

Optional, maximale Länge der Eingabe
Wenn dieser Parameter gesetzt ist wird für dieses Eingabefeld maximal die angegebene Anzahl an Zeichen aufgenommen. Der angegebene Wert kann auch per Tag ausgegeben werden um z. B. den HTML-Parameter "maxlength" des Eingabefelds anzugeben.

Zeichenanzahl, z. B. 100

Adressfelder

Adressfelder werden prinzipiell wie die allgemeinen Anfragefelder behandelt, besitzen jedoch jeweils eine eigene, fest definierte Sektion. Der Grund hierfür liegt u.a. darin, dass INQUIRY4 diese Felder der Adresse bzw. einer optionalen Lieferadresse zuordnet und diese gesondert behandelt.

Felder der Adressdaten beginnen mit „A-“, die der Lieferadresse mit „D-“ (für Delivery). Es werden dabei alle von WEBSALE V8 verwendeten Felder von INQUIRY4 unterstützt.

z. B.

...

Wert

...

Feld

...

Vorname

...

<A-FirstName> ... </A-FirstName>

...

Nachname (Lieferadresse)

...

<D-LastName> ... </D-LastName>

...

Anrede

...

<A-Salutation> ... </A-Salutation>

usw.

Spezialfeld: Das Feld <A-MerchantEmail> verhält sich wie ein normales Eingabefeld. Der eingegebene/übergebene Wert wird allerdings als Liste von E-Mail-Adressen (die einzelnen E-Mail-Adressen müssen durch ein Komma voneinander getrennt sein) interpretiert. An diese E-Mail-Adressen wird zusätzlich zu der konfigurierten E-Mail-Adresse die Anfrage-E-Mail gesendet.

Sektion SendUserEmail

Dies ist ein spezielles, fest definiertes Feld, welches vorhanden sein muss, wenn der Parameter SendEmail in der Sektion <ConfirmEmail> den Wert userselect hat.

Mit diesem Feld wird definiert, über welches HTML-Element der Benutzer steuern kann, ob er eine E-Mail erhält oder nicht.

Das Feld hat die Form:

Code Block
<SendUserEmail> Type = CheckBox Name = confirmemail Descr = Ich möchte eine Bestätigungsemail erhalten UseInput = A </SendUserEmail>

...

Parameter

...

Beschreibung

...

Werte

...

Type

...

Typ des Eingabefeldes.

...

CheckBox
RadioButton
ListBox

...

Name

...

Name des Eingabefeldes, welches Sie im HTML-Formular vergeben haben.

...

Text, z. B. confirmemail

...

Descr

...

Textuelle Beschreibung des Feldes.

...

UseInput

...

Wenn dieser Parameter „A“ ist, wird die E-Mail-Adresse zwingend benötigt, wenn der Benutzer eine Bestätigungsemail wünscht.

Wenn dieser Parameter „D“ ist, wird die optionale E-Mail-Adresse der Lieferadresse zwingend benötigt, wenn der Benutzer eine Bestätigungsemail wünscht.

Wenn dieser Parameter „AD“ ist wird sowohl die E-Mail-Adresse als auch die optionale E-Mail-Adresse der Lieferadresse zwingend benötigt, wenn der Benutzer eine Bestätigungsemail wünscht.

...

[A][D][AD]

Standard: A

Tags und Templates

INQUIRY4 bietet Ihnen die Möglichkeit, in Ihren Templates durch bestimmte, wohldefinierte „Tags“ Informationen entsprechend den Benutzereingaben einzufügen bzw. bestimmte Bereiche ein- oder auszublenden.

Verwendung von Tags

Arten von Tags

Es existieren 3 Arten von Tags:

...

Einfache Ersetzungs-Tags

...

Diese haben die Form ~TAG-Name~. Das Tag wird durch den entsprechenden Wert ersetzt.

...

Bereichs-Tags

...

Ein Bereich wird mit {TAG-Name} geöffnet und mit {/TAG-Name} geschlossen. Dieser Bereich wird nur angezeigt, wenn das TAG irgendeinen Wert hat.

...

Negative Bereichs-Tags

...

Ein negativer Bereich wird mit {!TAG-Name} geöffnet und mit {/!TAG-Name} geschlossen. Dieser Bereich wird nur angezeigt, wenn kein Wert für dieses TAG existiert.

...

...
  UseFriendlyCaptchaV1              = yes
  FriendlyCaptchaV1ApplicationID    =  #ApplicationID aus FriendlyCaptcha Backend
  FriendlyCaptchaV1APIKey           = #API-Key aus FriendlyCaptcha
  FriendlyCaptchaV1ApiUrl           = https://eu-api.friendlycaptcha.eu/api/v1/puzzle   #Endpoint (bei FC dokumentiert, global oder EU Endpoint)
  FriendlyCaptchaV1VerifyUrl        = https://eu-api.friendlycaptcha.eu/api/v1/siteverify #Endpoint (bei FC dokumentiert, global oder EU Endpoint)
  FriendlyCaptchaV1TechnicalProblem = #
  FriendlyCaptchaV1Denied           = # 
  FriendlyCaptchaV1EmptySolution    = # 
  ...
</Captcha>

Parameter	Beschreibung	Werte
UseFriendlyCaptchaV1		[yes\|no]; Standard: no
FriendlyCaptchaV1ApplicationID	ApplicationID, wird von FriendlyCaptcha bezogen
FriendlyCaptchaV1APIKey	API-Key, wird von FriendlyCaptcha bezogen
FriendlyCaptchaV1ApiUrl	Standardwert von FriendlyCaptcha	https://eu-api.friendlycaptcha.eu/api/v1/puzzle
FriendlyCaptchaV1VerifyUrl	Standardwert von FriendlyCaptcha	https://eu-api.friendlycaptcha.eu/api/v1/siteverify
FriendlyCaptchaV1TechnicalProblem	Fehlermeldung bei technischem Problem	Text, z. B. Techn. Problem, keine Verbindung
FriendlyCaptchaV1Denied	Fehlermeldung, wenn Zugriff verweigert wird	Text
FriendlyCaptchaV1EmptySolution	Fehlermeldung, wenn Captcha nicht gelöst wurde	Text

Konfiguration des Blacklisting

Alle Einstellungen zu verwendeten Blacklists sind in der Sektion <Filter> zu finden.

Wenn eigene, lokale Blacklists verwendet werden sollen, werden diese im Online-Servicebereich (OSB) in der INQUIRY-Konfiguration als eigenen config-Dateien angelegt (Format siehe unten).

Code Block
<Filter> IP-Blacklisting = both IP-Blacklist = ip.blacklist.config MX-Blacklisting = both MX-Blacklist = mx.blacklist.config ErrorMessage = Ihre IP-Adresse ist gesperrt </Filter>

Parameter	Beschreibung	Werte
IP-Blacklisting	Legt fest ob geprüft werden soll, ob die IP-Adresse des Anfragenden auf einer Blacklist steht. Ist dies der Fall, kann der Anfragende die Anfrage nicht absenden: none: keine Prüfung global: Es wird nur die globale, von der WEBSALE AG gepflegte Blacklist verwendet (Für weitere Informationen kontaktieren Sie bitte WEBSALE AG) local: Es wird nur die lokal angegebene Blacklist verwendet both: Es wird die lokale und die globale Blacklist verwendet	[none][global][local][both] Standard: none
IP-Blacklist	Name der lokalen Blacklist-Datei für IP-Adressen Wird verwendet, wenn für den Parameter IP-Blacklisting "both" oder "local" gesetzt ist.	Beispiel: ip.blacklist.config
MX-Blacklisting	Legt fest, ob geprüft werden soll, ob einer der MX-Einträge der E-Mail-Adressen des Anfragenden (soweit vorhanden) auf einer Blacklist steht. Ist dies der Fall, kann der Anfragende die Anfrage nicht absenden. Dies ist vor allem gegen sogenannte "Gewinnspielclubs" ein Ansatz, Spam zu vermeiden! none: keine Prüfung global: Es wird nur die globale, von der WEBSALE AG gepflegte Blacklist verwendet (Für weitere Informationen kontaktieren Sie bitte WEBSALE AG) local: Es wird nur die lokal angegebene Blacklist verwendet both: Es wird die lokale und die globale Blacklist verwendet	[none][global][local][both] Standard: none
MX-Blacklist	Name der lokalen Blacklist mit MX-Einträgen, wird verwendet, wenn für den Parameter MX-Blacklisting "both" oder "local" gesetzt ist. Sie kann sowohl Domains als auch IP-Adressen beinhalten.	Beispiel: mx.blacklist.config
ErrorMessage	Dieser Fehlerstring wird angezeigt, wenn der Anfragende aufgrund einer Blacklist die Anfrage nicht absenden kann.	Text, z. B. Ihre IP-Adresse ist gesperrt

Info

Format der Blacklist-Dateien
Pro Zeile kann ein Eintrag stehen, Kommentarzeichen ist #.

Domains
Für Domaineinträge kann ein beliebiger Teil der zu sperrenden Domain angegeben werden.

IP-Adressen
Es können sowohl Bereiche als auch einzelne IP-Adressen angegeben werden.

Beispiel:

Code Block

##########################
# Blacklist für MX-Records
##########################

##########################
# Sperren von Domains:
##########################
# Sperre der Domain xyz.de (Achtung hier wird auch abcxyz.de mit gesperrt!):
xyz.de

# Sperren der Subdomains von xyz.de (Achtung xyz.de wird nicht mitgesperrt, aber z. B. mx0.xyz.de):
.xyz.de

# Sperren von *.abc.xyz.de
.abc.xyz.de

#######################
# Sperren von IP-Adressen
#######################

# Sperre des IP-Bereichs von 13.0.0.0 - 13.255.255.255
13.

# Sperre des IP-Bereichs von 172.16.1.0 - 172.16.1.255
172.16.1.

# Sperren der einzelnen IP-Adresse 172.16.1.10
172.16.1.10

# Teilbereichssperren wie z. B. 172.16.5.12 - 172.16.7.22 sind nicht möglich!

Fehlermeldungen für den Anwender

Alle konfigurierbaren Fehlermeldungen sind in der Sektion <ErrorMessages> zu finden.

Code Block

<ErrorMessages>
  Error    			  = Um Ihre Anfrage bearbeiten zu können, prüfen Sie bitte folgende Angaben:
  AddressEmailError   = Rechnungsanschrift: Ungültige E-Mail-Adresse
  DeliverEmailError   = Lieferanschrift: Ungültige E-Mail-Adresse
  CommonInputMissing  = Treffen Sie bitte ihre Wahl / machen Sie folgende Angaben
  NoInput     		  = Füllen sie bitte mindestens ein Feld aus
</ErrorMessages>

Parameter

Beschreibung

Werte

Error

Dieser Fehlerstring wird immer angezeigt, wenn mindestens eine Eingabe fehlt oder falsch ist. Darunter werden dann die Details zu dem (den) Fehler(n) gezeigt.

Text, z. B. Um Ihre Anfrage bearbeiten zu können, prüfen Sie bitte folgende Angaben:

AddressEmailError

Dieser Fehlerstring wird angezeigt, wenn die Überprüfung der E-Mail-Adresse der Rechnungsadresse fehlschlug.

Text, z. B. Rechnungsanschrift: Ungültige E-Mail-Adresse

DeliverEmailError

Dieser Fehlerstring wird angezeigt, wenn die Überprüfung der E-Mail-Adresse der Lieferadresse fehlschlug.

Text, z. B. Lieferanschrift: Ungültige E-Mail-Adresse

CommonInputMissing

Dieser Fehlerstring wird angezeigt, wenn der Benutzer keine Eingaben in einem allgemeinen Anfragefeld (keine Adressdaten) gemacht hat und die Option

Code Block
<Basic> ... CommonInputRequired = yes ... </Basic>

gesetzt ist. Dieser Fehlerstring kann auch leer sein. Die Fehlermeldung wird dann nie angezeigt.

Text, z. B. Treffen Sie bitte ihre Wahl / machen Sie folgende Angaben

NoInput

Dieser Fehlerstring wird angezeigt, wenn überhaupt keine Eingabe gemacht wurde, weder in allgemeinen Feldern noch in Adressfeldern. Dieser Fehlerstring kann auch leer sein. Die Fehlermeldung wird dann nie angezeigt.

Text, z. B. Füllen Sie bitte mindestens ein Feld aus

Allgemeine Anfragefelder

INQUIRY4 kann in einem Formular bis zu 1000 allgemeine Anfragefelder bearbeiten. Ein allgemeines Anfragefeld hat folgende Form:

Code Block
<+CommonInput> Allow = yes Type = CheckBox Name = beratung Descr = Ich möchte Beratung Required = no Hide = yes Max = 100 </+CommonInput>

Parameter	Beschreibung	Werte
Allow	Wenn Sie diesen Parameter auf "yes" setzen, dann wird das Feld von INQUIRY4 bearbeitet und kontrolliert. Bei "no" wird das Eingabefeld nicht bearbeitet bzw. ignoriert.	[yes\|no]; Standard: yes
Type	Typ des Eingabefeldes.	Text (einzeilige Textfelder) TextArea (Mehrzeilige Textfelder) CheckBox RadioButton ListBox
Name	Name des Eingabefeldes, welches Sie im HTML-Formular vergeben. Bitte beachten Sie: Die Namen der Eingabefelder müssen für das gesamte Formular eindeutig sein. Ein Feldname, z. B. "beratung", darf somit nicht mehrmals vorkommen. Die Namen der allgemeinen Anfragefelder dürfen nicht mi „A-“ oder „D-“ beginnen.	Text, z. B. beratung
Descr	Textuelle Beschreibung des Feldes. Dieser Text erscheint in den E-Mails.	Text, z. B. Ich möchte Beratung
Required	Wenn Sie diesen Parameter auf "yes" setzen, dann muß dieses Feld vom Anfragenden ausgefüllt oder markiert werden.	[yes][no]; Standard: no
Hide	Wenn dieser Parameter auf „yes“ gesetzt wird, wird dieses Feld NICHT in einer automatisch generierten E-Mail erzeugt.	[yes][no]; Standard: no
Max	Optional, maximale Länge der Eingabe Wenn dieser Parameter gesetzt ist wird für dieses Eingabefeld maximal die angegebene Anzahl an Zeichen aufgenommen. Der angegebene Wert kann auch per Tag ausgegeben werden um z. B. den HTML-Parameter "maxlength" des Eingabefelds anzugeben.	Zeichenanzahl, z. B. 100

Adressfelder

Adressfelder werden prinzipiell wie die allgemeinen Anfragefelder behandelt, besitzen jedoch jeweils eine eigene, fest definierte Sektion. Der Grund hierfür liegt u.a. darin, dass INQUIRY4 diese Felder der Adresse bzw. einer optionalen Lieferadresse zuordnet und diese gesondert behandelt.

Felder der Adressdaten beginnen mit „A-“, die der Lieferadresse mit „D-“ (für Delivery). Es werden dabei alle von WEBSALE V8 verwendeten Felder von INQUIRY4 unterstützt.

z. B.

Wert	Feld
Vorname	`<A-FirstName> ... </A-FirstName>`
Nachname (Lieferadresse)	`<D-LastName> ... </D-LastName>`
Anrede	`<A-Salutation> ... </A-Salutation>`

usw.

Spezialfeld: Das Feld <A-MerchantEmail> verhält sich wie ein normales Eingabefeld. Der eingegebene/übergebene Wert wird allerdings als Liste von E-Mail-Adressen (die einzelnen E-Mail-Adressen müssen durch ein Komma voneinander getrennt sein) interpretiert. An diese E-Mail-Adressen wird zusätzlich zu der konfigurierten E-Mail-Adresse die Anfrage-E-Mail gesendet.

Sektion SendUserEmail

Dies ist ein spezielles, fest definiertes Feld, welches vorhanden sein muss, wenn der Parameter SendEmail in der Sektion <ConfirmEmail> den Wert userselect hat.

Mit diesem Feld wird definiert, über welches HTML-Element der Benutzer steuern kann, ob er eine E-Mail erhält oder nicht.

Das Feld hat die Form:

Code Block
<SendUserEmail> Type = CheckBox Name = confirmemail Descr = Ich möchte eine Bestätigungsemail erhalten UseInput = A </SendUserEmail>

Parameter	Beschreibung	Werte
Type	Typ des Eingabefeldes.	CheckBox RadioButton ListBox
Name	Name des Eingabefeldes, welches Sie im HTML-Formular vergeben haben.	Text, z. B. confirmemail
Descr	Textuelle Beschreibung des Feldes.	Text, z. B.Ich möchte eine Bestätigungs-E-Mail erhalten
UseInput	Wenn dieser Parameter „A“ ist, wird die E-Mail-Adresse zwingend benötigt, wenn der Benutzer eine Bestätigungsemail wünscht. Wenn dieser Parameter „D“ ist, wird die optionale E-Mail-Adresse der Lieferadresse zwingend benötigt, wenn der Benutzer eine Bestätigungsemail wünscht. Wenn dieser Parameter „AD“ ist wird sowohl die E-Mail-Adresse als auch die optionale E-Mail-Adresse der Lieferadresse zwingend benötigt, wenn der Benutzer eine Bestätigungsemail wünscht.	[A][D][AD] Standard: A

Tags und Templates

INQUIRY4 bietet Ihnen die Möglichkeit, in Ihren Templates durch bestimmte, wohldefinierte „Tags“ Informationen entsprechend den Benutzereingaben einzufügen bzw. bestimmte Bereiche ein- oder auszublenden.

Verwendung von Tags

Arten von Tags

Es existieren 3 Arten von Tags:

Einfache Ersetzungs-Tags	Diese haben die Form ~TAG-Name~. Das Tag wird durch den entsprechenden Wert ersetzt.
Bereichs-Tags	Ein Bereich wird mit {TAG-Name} geöffnet und mit {/TAG-Name} geschlossen. Dieser Bereich wird nur angezeigt, wenn das TAG irgendeinen Wert hat.
Negative Bereichs-Tags	Ein negativer Bereich wird mit {!TAG-Name} geöffnet und mit {/!TAG-Name} geschlossen. Dieser Bereich wird nur angezeigt, wenn kein Wert für dieses TAG existiert.

Ein Tag kann im Template entweder in Form eines einfachen Ersetzungs-Tags und/oder eines Bereichs-Tags und/oder eines negativen Bereichs-Tags eingesetzt werden. Folgende Kodierung soll hierzu gelten:

...

1 bedeutet: wird unterstützt
0 bedeutet: keine Unterstützung

Unterstützt	Einfaches Tag	Bereichs-Tag	neg. Bereichs-Tag
100	ja	nein	nein
011	nein	ja	ja
111	ja	ja	ja

Beispiel 1:

Tag	Unterstützt	Beschreibung	Besonderheit
Beispiel	100	Tag für das Feld ABCDE	Dieser Text wird nicht beim ersten Aufruf des Formulars mit INQUIRY4 angezeigt, sondern nur, wenn beim Absenden des Formulars ein Fehler festgestellt wurde.

Dieses Tag können Sie im Template wie folgt verwenden:

...

Dieses Beispiel-Tag unterstützt mit 100 also nur die Möglichkeiten eines “Einfachen Tags“, ist aber kein “Bereichs-Tag“ bzw. kein “Negatives Bereichs-Tag“.

Beispiel 2:

Tag	Unterstützt	Beschreibung
INFO-Referer	111	Zeigt den als Parameter `ref=...` übergebenen Wert an.

Dieses Tag können Sie im Template wie folgt verwenden:

...

Es existieren drei Suffixe, die in Kombination mit dem Sektionsnamen ein gültiges Tag ergeben:

Suffix	Beschreibung
_value	Der vom Nutzer eingegebene Wert
_descr	Die Beschreibung, wie in der Konfigurationsdatei angegeben
_name	Der HTML-Name, wie in der Konfigurationsdatei angegeben.
_max	Die in der Konfigurationsdatei angegebene maximale Eingabelänge
_error	Fehlerhafte Eingabe: Einfaches Tag: Im Fehlerfall wird das Tag durch „_error“ ersetzt Bereichs-Tag: Im Fehlerfall wird der Bereich angezeigt neg. Bereichs-Tag: Im Fehlerfall wird der Bereich nicht angezeigt

Jedes so erzeugte Tag unterstützt dabei alle drei Arten von Tags.

...

Achtung: Im INQUIRY können maximal 10 Suffix-Felder (<A-Suffix1> bis <A-Suffix10>) genutzt werden. Wenn Sie mehr Zusatzfelder einsetzen möchten, müssen diese mit <+CommonInput> realisiert werden. (Siehe 5.5.10 oben Allgemeine Anfragefelder)

Zusätzliche Tags:

Tag	Unterstützt	Beschreibung	Besonderheit
A-Salutation_list	100	Generiert automatisch eine Listbox mit Anreden. Dabei wird die Datei aus der Sektion `<Basic>`, Parameter SalutationDat verwendet. Besonderheit: Die erzeugte Listbox besitzt die Styles-klasse `„select_a_salut"`.
A-Salutation_complete	100	Die vollständige Anrede. Zur Erzeugung dieser wird die Datei aus der Sektion `<Basic>`, Parameter SalutationDat verwendet.
A-Title_list	100	Generiert automatisch eine Listbox mit Titeln. Dabei wird die Datei aus der Sektion `<Basic>`, Parameter TitleDat verwendet.	Die erzeugte Listbox besitzt die Styles-klasse `„select_a_title"`.
A-Country_list	100	Generiert automatisch eine Listbox mit Ländern. Dabei wird die Datei aus der Sektion `<Basic>`, Parameter CountryDat verwendet.	Die erzeugte Listbox besitzt die Styles-klasse `„select_a_country"`.
A-DateOfBirth_list	100	Generiert automatisch drei Listboxen zur Auswahl des Geburtsdatums.	Die erzeugten Listboxen besitzen die Styles-klasse `„select_a_dateofbirth"`.

Tags der optionalen Lieferadresse

...

Es existieren drei Suffixe, die in Kombination mit dem Sektionsnamen einen gültigen Tag ergeben:

Suffix	Beschreibung
_value	Der vom Nutzer eingegebene Wert
_descr	Die Beschreibung, wie in der Konfigurationsdatei angegeben
_name	Der HTML-Name, wie in der Konfigurationsdatei angegeben.
_max	Die in der Konfigurationsdatei angegebene maximale Eingabelänge
_error	Fehlerhafte Eingabe: Einfaches Tag: Im Fehlerfall wird das Tag durch „_error“ ersetzt Bereichs-Tag: Im Fehlerfall wird der Bereich angezeigt neg. Bereichs-Tag: Im Fehlerfall wird der Bereich nicht angezeigt

Jedes so erzeugte Tag unterstützt dabei alle drei Arten von Tags.

...

Achtung: Im INQUIRY können maximal 10 Suffix-Felder (<D-Suffix1> bis <D-Suffix10>) genutzt werden. Wenn Sie mehr Zusatzfelder einsetzen möchten, müssen diese mit <+CommonInput> realisiert werden (Siehe unten unter oben Allgemeine Anfragefelder).

Zusätzliche Tags:

Tag	Unterstützt	Beschreibung	Besonderheit
D-Salutation_list	100	Generiert automatisch eine Listbox mit Anreden. Dabei wird die Datei aus der Sektion <Basic>, Parameter SalutationDat verwendet.	Die erzeugte Listbox besitzt die Styles-klasse

„ Anchorline1451line1451select

„select_d_salut“.
D-Salutation_complete	100	Die vollständige Anrede. Zur Erzeugung dieser wiird die Datei aus der Sektion `<Basic>`, Parameter SalutationDat verwendet.
D-Title_list	100	Generiert automatisch eine Listbox mit Titeln. Dabei wird die Datei aus der Sektion `<Basic>`, Parameter TitleDat verwendet.	Die erzeugte Listbox besitzt die Styles-klasse `„select_d_title"`.
D-Country_list	100	Generiert automatisch eine Listbox mit Ländern. Dabei wird die Datei aus der Sektion `<Basic>`, Parameter CountryDat verwendet.	Die erzeugte Listbox besitzt die Styles-klasse `„select_d_country"`.
D-DateOfBirth_list	100	Generiert automatisch drei Listboxen zur Auswahl des Geburtsdatums.	Die erzeugten Listboxen besitzen die Styles-klasse `„select_d_dateofbirth"`.

Tags von allgemeinen Eingabefeldern

Die Tags der allgemeinen Eingabefelder beginnen alle mit „C-“ und werden aus diesem Prefix, dem HTML-Namen und dem entsprechenden Suffix gebildet.

Es existieren drei Suffixe, die in Kombination mit dem Prefix „C-“ und dem HTML-Namen ein gültiges Tag ergeben:

Suffix	Beschreibung
_value	Der vom Nutzer eingegebene Wert
_descr	Die Beschreibung, wie in der Konfigurationsdatei angegeben
_name	Der HTML-Name, wie in der Konfigurationsdatei angegeben.
_max	Die in der Konfigurationsdatei angegebene maximale Eingabelänge
_error	Fehlerhafte Eingabe: Einfaches Tag: Im Fehlerfall wird das Tag durch „_error“ ersetzt Bereichs-Tag: Im Fehlerfall wird der Bereich angezeigt neg. Bereichs-Tag: Im Fehlerfall wird der Bereich nicht angezeigt

Jedes so erzeugte Tag unterstützt dabei alle drei Arten von Tags.

...

Code Block
<+CommonInput> Allow = yes Type = TextArea Name = field2 Descr = Bemerkungen Required = no </+CommonInput>

Template Anfrage:

Code Block
~C-field2_descr~: <textarea name="~C-field2_name~"></textarea>

Template E-Mail:

Code Block

{C-field2_value}
  TypeUsereingabe bei ~C-field2_descr~:
  ~C-field2_value~
{/C-field2_value}

{!C-field2_value}
 	= TextAreaUser machte keine NameAngabe zu         	= field2
  Descr         	= Bemerkungen
  Required      	= no
</+CommonInput>

Template Anfrage:

Code Block
~C-field2_descr~: <textarea name="~C-field2_name~"></textarea>

Template E-Mail:

Code Block
{C-field2_value} Usereingabe bei ~C-field2_descr~: ~C-field2_value~ {/C-field2_value} {!C-field2_value} User machte keine Angabe zu ~C-field2_descr~ {/!C-field2_value}

Hier wird eine Textarea als allgemeines Eingabefeld erstellt, im HTML-Template angezeigt und bei einer Benutzereingabe der Wert bzw. bei keiner Eingabe eine alternative Nachricht in der E-Mail verschickt.

Zusätzlich können die Bereichs- und negativen Bereichs-Tags mit dem Suffix _value auf bestimmte eingegebene Werte geklammert werden.

Code Block
{C-field2_value(anfrage)} Dieser Bereich wird nur angezeigt, wenn der Kunde im Feld field2 „anfrage“ eingegeben hat. {/C-field2_value(anfrage)}

Tags der CAPTCHA-Funktionen

...

~C-field2_descr~
{/!C-field2_value}

Hier wird eine Textarea als allgemeines Eingabefeld erstellt, im HTML-Template angezeigt und bei einer Benutzereingabe der Wert bzw. bei keiner Eingabe eine alternative Nachricht in der E-Mail verschickt.

Zusätzlich können die Bereichs- und negativen Bereichs-Tags mit dem Suffix _value auf bestimmte eingegebene Werte geklammert werden.

Code Block
{C-field2_value(anfrage)} Dieser Bereich wird nur angezeigt, wenn der Kunde im Feld field2 „anfrage“ eingegeben hat. {/C-field2_value(anfrage)}

Tags der CAPTCHA-Funktionen

Allgemeines Tag

Tag

Unterstützt

Beschreibung

CAPTCHA-Description

111

Gibt die Beschreibung der CAPTCHA-Funktionalität aus.

(Konfigurationsdatei: Abschnitt <Captcha>,

Parameter CaptchaDescription).

Tags für die Rechenaufgabe und Beispiel

Tag	Unterstützt	Beschreibung	Besonderheit
CAPTCHA-Input_name	100	Der HTML-Name des CAPTCHA-Eingabefelds
CAPTCHA-Input_error	111	Fehlerhafte Eingabe im CAPTCHA-Eingabefeld Einfaches Tag: Im Fehlerfall wird das Tag durch „_error“ ersetzt Bereichs-Tag: Im Fehlerfall wird der Bereich angezeigt neg. Bereichs-Tag: Im Fehlerfall wird der Bereich nicht angezeigt
CAPTCHA-Input_value	111	Der vom Anfragenden eingegebene Wert im CAPTCHA-Eingabefeld	Dieser Wert wird nur nach korrekter Eingabe des CAPTCHA- Eingabefelds ausgegeben!
CAPTCHA-Result	111	Die korrekte erwartete CAPTCHA-Eingabe	NUR ZU TESTZWECKEN VERWENDEN!
CAPTCHA-ArithmeticOperand1	111	Der erste Operand der Rechenaufgabe
CAPTCHA-ArithmeticOperand2	111	Der zweite Operand der Rechenaufgabe
CAPTCHA-ArithmeticOperation	111	Die Rechenoperation der Rechenaufgabe

Beispiel:

Code Block

~CAPTCHA-ArithmeticOperand1~
~CAPTCHA-ArithmeticOperation~
~CAPTCHA-ArithmeticOperand2~ 

=

<input type="text" class="stdinput~CAPTCHA-Input_error~" value="~CAPTCHA-Input_value~" name="~CAPTCHA-Input_name~" size="10" maxlength="10">

Hierbei wird das Eingabefeld im Fall einer fehlerhaften Eingabe markiert.

Wurde versucht, das Formular mit richtig gelöster Rechenaufgabe abzusenden, aber andere Eingaben wurden nicht korrekt ausgeführt, muss der Anfragende keine neue Rechenaufgabe lösen, sondern die bereits gelöste Aufgabe wird inklusive korrekt ausgefüllten Eingabefeldes wieder angezeigt.

Tags für Google ReCaptcha Version 3 und JavaScript

Tag	Unterstützt	Beschreibung
CAPTCHA-

Description

RecaptchaV3SiteKey

111

Gibt die Beschreibung der CAPTCHA-Funktionalität aus.

(Konfigurationsdatei: Abschnitt <Captcha>,

Parameter CaptchaDescription).

Tags für die Rechenaufgabe und Beispiel

...

Tag

...

Unterstützt

...

Beschreibung

...

Besonderheit

...

CAPTCHA-Input_name

...

100

...

Der HTML-Name des CAPTCHA-Eingabefelds

...

CAPTCHA-Input_error

...

111

...

Fehlerhafte Eingabe im CAPTCHA-Eingabefeld

Einfaches Tag: Im Fehlerfall wird das Tag durch „_error“ ersetzt
Bereichs-Tag: Im Fehlerfall wird der Bereich angezeigt
neg. Bereichs-Tag: Im Fehlerfall wird der Bereich nicht angezeigt

...

CAPTCHA-Input_value

...

111

...

Der vom Anfragenden eingegebene Wert im CAPTCHA-Eingabefeld

...

Dieser Wert wird nur nach korrekter Eingabe des CAPTCHA- Eingabefelds ausgegeben!

...

CAPTCHA-Result

...

111

Die korrekte erwartete CAPTCHA-Eingabe

...

NUR ZU TESTZWECKEN VERWENDEN!

...

CAPTCHA-ArithmeticOperand1

...

111

...

Der erste Operand der Rechenaufgabe

...

CAPTCHA-ArithmeticOperand2

...

111

...

Der zweite Operand der Rechenaufgabe

...

CAPTCHA-ArithmeticOperation

...

111

...

Die Rechenoperation der Rechenaufgabe

Beispiel:

...

100	Site-Key, der von Google bezogen und in `inquiry.config` gesetzt wird
CAPTCHA-RecaptchaV3ApiUrl	100	URL von Google bezogen und in `inquiry.config` gesetzt
CAPTCHA-RecaptchaV3ActionName	100	z. B. homepage, login usw., in `inquiry.config` gesetzt
CAPTCHA-RecaptchaV3Error	111	Fehlermeldung von `inquiry.config`, wird im Fehlerfall ausgegeben
CAPTCHA-RecaptchaV3Score	111	Recaptcha Score von Google
CAPTCHA-RecaptchaV3Response	111	technische Antwort von Google, kann zur Fehleranalyse verwendet werden
CAPTCHA-RecaptchaV3ErrorCode	111	interner Fehlercode, kann zur Fehleranalyse verwendet werden

JavaScript-Code, der auf dem Template eingefügt werden muss:

Code Block

<script src="~CAPTCHA-RecaptchaV3ApiUrl~?render=~CAPTCHA-RecaptchaV3SiteKey~"></script>

<script>
	grecaptcha.ready(function() {
		grecaptcha.execute('~CAPTCHA-RecaptchaV3SiteKey~', {action: '~CAPTCHA-RecaptchaV3ActionName~'}).then(function(token) {
			$("[name='g_recaptcha_token']").val(token);	//Token wird bezogen und sein Wert im input-Element im Formular gespeichert
		});
	});
</script>

HTML-Code, der auf dem Formular eingefügt werden muss:

Code Block
<form> ... <input type="texthidden" classname="stdinput~CAPTCHA-Input_error~" value="~CAPTCHA-Input_value~" name="~CAPTCHA-Input_name~" size="10" maxlength="10">

Hierbei wird das Eingabefeld im Fall einer fehlerhaften Eingabe markiert.

Wurde versucht, das Formular mit richtig gelöster Rechenaufgabe abzusenden, aber andere Eingaben wurden nicht korrekt ausgeführt, muss der Anfragende keine neue Rechenaufgabe lösen, sondern die bereits gelöste Aufgabe wird inklusive korrekt ausgefüllten Eingabefeldes wieder angezeigt.

...

g_recaptcha_token">
   ...
</form>

Tags für Friendly Captcha

Tag	Unterstützt	Beschreibung
CAPTCHA-

RecaptchaV3SiteKey

100

Site-Key, der von Google bezogen und in inquiry.config gesetzt wird

CAPTCHA-RecaptchaV3ApiUrl

100

URL von Google

FriendlyCaptchaV1ApiUrl	111	URL von Friendly Captcha bezogen und in `inquiry.config` gesetzt
CAPTCHA-

RecaptchaV3ActionName

FriendlyCaptchaV1ApplicationID

100

z. B. homepage, login usw., in inquiry.config gesetzt

111	ApplicationID aus FriendlyCaptcha Backend
CAPTCHA-

RecaptchaV3Error

FriendlyCaptchaV1Error	111	Fehlermeldung von `inquiry.config`, wird im Fehlerfall ausgegeben
CAPTCHA-

RecaptchaV3Score

111

Recaptcha Score von Google

CAPTCHA-RecaptchaV3Response

FriendlyCaptchaV1Response

111

technische Antwort von

Google

Friendly Captcha, kann zur Fehleranalyse verwendet werden

CAPTCHA-

RecaptchaV3ErrorCode

FriendlyCaptchaV1ErrorCode

111

interner Fehlercode, kann zur Fehleranalyse verwendet

werden

JavaScript-Code, der auf dem Template eingefügt werden muss:

Code Block

<script src="~CAPTCHA-RecaptchaV3ApiUrl~?render=~CAPTCHA-RecaptchaV3SiteKey~"></script>

<script>
	grecaptcha.ready(function() {
		grecaptcha.execute('~CAPTCHA-RecaptchaV3SiteKey~', {action: '~CAPTCHA-RecaptchaV3ActionName~'}).then(function(token) {
			$("[name='g_recaptcha_token']").val(token);	//Token wird bezogen und sein Wert im input-Element im Formular gespeichert
		});
	});
</script>

HTML-Code, der auf dem Formular eingefügt werden muss:

...

werden

Code, der auf dem Template eingefügt werden muss:

Code Block

<script
  type="module"
  src="https://cdn.jsdelivr.net/npm/friendly-challenge@0.9.14/widget.module.min.js"
  async
  defer
></script>
<script nomodule src="https://cdn.jsdelivr.net/npm/friendly-challenge@0.9.14/widget.min.js" async defer></script>

<div class="frc-captcha" data-sitekey="~CAPTCHA-FRIENDLYCAPTCHAV1-ApplicationID~" data-puzzle-endpoint="~CAPTCHA-FRIENDLYCAPTCHAV1-APIUrl~" data-start="focus"></div>

Tags des PDF-Downloads

Tag

Unterstützt

Beschreibung

Werte / Beispiele

PDF-Form

111

Form zur Erzeugung eines PDFs der Anfrage. Wird nur auf der ConfirmPage unterstützt.

Der Bereich wird nicht angezeigt, wenn der Parameter Allow in der

Bereich

Sektion PDF auf no steht.

Code Block
{PDF-Form} <form action="~PDF-Form~" method="post"> .... </form> {/PDF-Form}

PDF-Button

111

Buttonname zur Erzeugung eines PDFs der Anfrage. Wird nur auf der ConfirmPage unterstützt. Der Bereich wird nicht angezeigt, wenn der Parameter Allow in der Sektion PDF auf no steht. Muss innerhalb der PDF-Form stehen.

Code Block
{PDF-Form} <form action="~PDF-Form~" method="post"> ... <input type="submit" name="~PDF-Button~" value="download"> ... </form> {/PDF-Form}

Tags des Dateiuploads

Tag

Unterstützt

Beschreibung

Werte / Beispiele

INQUIRY-Upload

011

Der Bereich wird angezeigt, wenn das WEBSALE-Upload-Modul mit diesem Anfrageformular verwendet werden kann. Dies beinhaltet auch, dass der Upload in der Konfigurationsdatei aktiviert ist (Parameter Allow in der Sektion Upload)

UPLOAD-Link

100

Link zum Upload-Modul. Dieser Link kann als Popup oder als iFrame (als iFrame auch innerhalb einer Colorbox) verwendet werden.

UPLOAD-SSLLink

100

Link zum Upload-Modul im SSL-Modus. Dieser Link kann als Popup oder als iFrame (als iFrame auch innerhalb einer Colorbox) verwendet werden.

UPLOAD-Data

111

Gibt die Anzahl der hochgeladenen Dateien aus bzw. zeigt an, ob Dateien hochgeladen wurden.

Dieses Tag kann auch als Schleifentag verwendet werden, um Informationen zu den hochgeladenen Dateien anzuzeigen.

Beispiel: Anzeige der hochgeladenen Dateien als Schleife:

Code Block
{@UPLOAD-Data} ~UPLOAD-Position~. ~UPLOAD-File~ {/@UPLOAD-Data}

Dies erzeugt bei 3 hochgeladenen Dateien (Datei1.txt, Datei2.txt und Datei3.pdf):

Datei1.txt
Datei2.txt

Datei3.pdf

UPLOAD-File

100

Der Dateiname der hochgeladenen Datei. Kann nur innerhalb der Schleife des Tags UPLOAD-Data verwendet werden.

UPLOAD-Position

100

Die Position der hochgeladenen Datei. Kann nur innerhalb der Schleife des Tags UPLOAD-Data verwendet werden.

UPLOAD-Descr

100

Die Beschreibung der hochgeladenen Dateien (festgelegt in der Konfigurationsdatei, Sektion Upload, Parameter UploadDescr)

UPLOAD-ID

111

Das Einzel-Tag gibt die ID des Uploads aus.

Design Control Tags

INQUIRY4 unterstützt folgende INQDC-FP-Tags, inkl. Tag-in-Tag-Unterstützung. Hinsichtlich Funktionalität und Arbeitsweise entsprechen diese den DC-FP-Tags im Shop (vgl. WEBSALE-Designer-Dokumentation):

Tag	Unterstützt	Beschreibung
INQDC-FPX	111	X ist frei wählbar, darf aber ausschließlich aus alphanumerischen Zeichen bestehen
INQDC-FPX_set	100
INQDC-FPX_reset	100
INQDC-FPX_replace	100
INQDC-FPX_append	100
INQDC-FPX_truncate	100
INQDC-FPX_contains	011
INQDC-FPX_urlencoding	100
INQDC-FPX_slice	100
INQDC-FPX_convertToEncoding	100
INQDC-FPX_extractTaggedData	100
INQDC-FPX_length	100
INQDC-FPX_jsonencoding	100
INQDC-CompareDigitLT	011
INQDC-CompareDigitLTE	011
INQDC-CompareDigitGT	011
INQDC-CompareDigitGTE	011
INQDC-CompareDigitIB	011
INQDC-CompareDigitIBE	011
INQDC-CompareStringInList	011
INQDC-IntX	111	X = 1...3
INQDC-IntX_set	100
INQDC-IntX_add	100
INQDC-IntX_sub	100
INQDC-IntX_mul	100
INQDC-IntX_div	100
INQDC-IntX_mod	100
INQDC-IntX_inc	100
INQDC-LoopX	111	X = 1...3
INQDC-LoopX_set	100
INQDC-LoopX_position	100
INQDC-DateTime_set	100
INQDC-DateTime_hours	111
INQDC-DateTime_minutes	111
INQDC-DateTime_seconds	111
INQDC-DateTime_year	111
INQDC-DateTime_month	111
INQDC-DateTime_day	111
INQDC-DateTime_setunixtimestamp	100
INQDC-DateTime_dayofweek	111
INQDC-DateTime_unixtimestamp	111
INQDC-ZeroLoopX	111
INQDC-ZeroLoopX_set	100
INQDC-ZeroLoopX_position	100
INQDC-DynamicLoopX	111	X = 1...3
INQDC-DynamicLoopX_set	100
INQDC-DynamicLoopX_settaggeddata	100
INQDC-DynamicLoopX_setseparator	100
INQDC-DynamicLoopX_setSeparatorTags	100
INQDC-DynamicLoopX_position	100
INQDC-DynamicLoopX_data	100

Spezielle Tags

Es existieren noch folgende, zusätzliche Tags:

Tag

Unterstützt

Beschreibung

Werte / Beispiel

AUTOGENERATE-full

100

Erzeugt automatisch alle Informationen zu einer Anfrage.

Zur Benutzung in E-Mail-Templates vorgesehen.

Code Block
~AUTOGENERATE-full~

Erzeugt folgenden Inhalt in einer E-Mail:

Code Block

Generated by Inquiry 4.0, http://www.websale-ag.de
-----------------------------------------------------------------

Neue Anfrage / New Inquiry
<--- Customer Inquiry --->
ShopID   ihre-ShopIDSubShopID		ihre-SubShopID
MallID   ihre-MallID
Reference 1180702057381
Subject	Anfrage
Date 01.06.2007
Time 14:47
...

<--- Customer Address --->
Anrede    Herr
Firma     Musterfirma
...

<--- Delivery Address --->
Nachname   Mustermann
...

<--- Inquiry --->
- möchte Beratung
- Art der Kontaktaufnahme  schriftlich
- Anmerkungen  Eine Anregung an die allgemeingültige Anfrage eines allgemeingültigen Anfragenden.

<--- Anhänge --->
...

AUTOGENERATE-header

100

Erzeugt automatisch nur den Header einer Anfrage.

Zur Benutzung in E-Mail-Templates vorgesehen.

Code Block
~AUTOGENERATE-header~

Erzeugt folgenden Inhalt in einer E-Mail:

Code Block

-----------------------------------------------------------------------
Generated by Inquiry 4.0, http://www.websale-ag.de
-----------------------------------------------------------------------

Neue Anfrage / New Inquiry

<--- Customer Inquiry --->
ShopID                      	ihre-ShopIDSubShopID		ihre-SubShopIDMallID			ihre-MallID
Reference                     	1180702057381
Subject                        	Anfrage
Date                           	01.06.2007
Time                           	14:47
Referer                        
SubReferer                     
IPAdress                      	172.16.1.93

AUTOGENERATE-addr

111

Erzeugt automatisch nur die Adress-Informationen.

Zur Benutzung in E-Mail-Templates vorgesehen.

Code Block
{AUTOGENERATE-addr} ~AUTOGENERATE-addr~ {/AUTOGENERATE-addr}

Erzeugt folgenden Inhalt in einer E-Mail:

Code Block
<--- Customer Address ---> Anrede Herr Firma Musterfirma Titel Dipl. Ing. ... E-Mail hans.mustermann@musterdomain.de <--- Delivery Address ---> ... Vorname Hans ...

AUTOGENERATE-common

111

Erzeugt automatisch nur die allgemeinen Anfrageinformationen.

Zur Benutzung in E-Mail-Templates vorgesehen.

Code Block
{AUTOGENERATE-common} ~AUTOGENERATE-common~ {/AUTOGENERATE-common}

Erzeugt folgenden Inhalt in einer E-Mail:

Code Block

<--- Inquiry --->
- möchte Beratung
- Angebot Präsentation
- Art der Kontaktaufnahme     	schriftlich
- mit Anzahl Seiten            	2
- Anmerkungen                  	Eine Anregung an die allgemeingültige Anfrage eines allgemeingültigen Anfragenden.

AUTOGENERATE-upload

111

Erzeugt automatisch nur die Liste der hochgeladenen Dateien.

Zur Benutzung in E-Mail-Templates vorgesehen.

Code Block
{AUTOGENERATE-upload} ~AUTOGENERATE-upload~ {/AUTOGENERATE-upload}

Erzeugt folgenden Inhalt in einer E-Mail:

Code Block
<--- Anhänge ---> Datei1.txt Datei2.txt Datei3.pdf

AUTOGENERATE-technical

111

Erzeugt alle Anfrageinformationen in einem Format, welches von technischen Systemen gelesen werden kann.

Zur Benutzung in E-Mail-Templates vorgesehen.

Code Block
{AUTOGENERATE-technical} ~AUTOGENERATE-technical~ {/AUTOGENERATE-technical}

Erzeugt folgenden Inhalt in einer E-Mail:

Code Block

------------------------------------------------
Technical order format
------------------------------------------------

<TechnicalFormat>
<Header>
   FormatID     = INQUIRY-4
   Generator    = INQUIRY-4
   Copyright(c) = WEBSALE AG, www.websale-ag.de
   Remark       = This File-Format is protected by international copyright laws.
   Remark       = Use only with expressed written allowance of WEBSALE AG.
</Header>

<ID>
   ShopID        = ihre-ShopID   SubShopID		= ihre-SubShopID   MallID		= ihre-MallID
   InquiryNumber = 1180702057381
   Subject       = Anfrage
</ID>

<CustomerAddress>
   <Item>
      Name        = SalutationCode
      Descr       = SalutationCode
      Value       = 01
   </Item>

   <Item>
      TechnicalName = A-Company
      Name          = firma
      Descr         = Firma
      Value         = Musterfirma
   </Item>
   ...
</CustomerAddress>

<DeliveryAddress>
   ...
</DeliveryAddress>

<Inquiry>
   <Item>
      Name      = beratung
      Descr     = - möchte Beratung
      Value     = on
   </Item>

   <Item>
      Name      = anmerkungen
      Descr     = - Anmerkungen
      <value>
        Eine Anregung an die allgemeingültige Anfrage eines allgemeingültigen Anfragenden.
      </value>
   </Item>
...
</Inquiry>
</TechnicalFormat>

INFO-ShopID

100

Die beim ersten Aufruf übergebene ShopID.

Code Block
~INFO-ShopID~

INFO-SubShopID

100

Die beim ersten Aufruf übergebene SubShopID.

Code Block
~INFO-SubShopID~

INFO-MallID

100

Die verwendete MallID.

Code Block
~INFO-MallID~

INFO-Reference

100

Die eindeutige Referenznummer der Anfrage.

Code Block
~INFO-Reference~

INFO-Subject

100

Der Betreff der Anfrage-E-Mail.

(Konfigurationsdatei: Sektion <InquiryEmail>, Parameter:EMailSubject)

Code Block
~INFO-Subject~

INFO-Date

100

Datum der Anfrage. Format: TT.MM.JJJJ

Code Block
~INFO-Date~

INFO-Time

100

Uhrzeit der Anfrage. Format: HH:MM

Code Block
~INFO-Time~

INFO-Referer

111

Der beim ersten Aufruf übergebene Referer

Code Block
{INFO-Referer} ~INFO-Referer~ {/INFO-Referer}

INFO-Subreferer

111

Der beim ersten Aufruf übergebene SubReferer.

Code Block
{INFO-Subreferer} ~INFO-Subreferer~ {/INFO-Subreferer}

INFO-IPAddr

100

Die IP-Adresse des Users

Bei Integration eines Inquiry über die ExternInclude-Technologie gibt der Tag immer die Adresse des WEBSALE Servers aus.

Code Block
~INFO-IPAddr~

INFO-ExternIPAddr

100

Die IP-Adresse des Users

Bei Integration eines Inquiry über die ExternInclude-Technologie gibt dieses Tag die IP-Adresse des Users aus.

Code Block
~INFO-ExternIPAddr~

INFO-ExternIPAddrTimeStamp

111

Der zugehörige Zeitstempel bei Verwendung von ExternInclude

Code Block
{INFO-ExternIPAddrTimeStamp} ~INFO-ExternIPAddrTimeStamp~ {/INFO-ExternIPAddrTimeStamp}

INFO-ExternSessionID

111

SessionID des WEBSALE-Shops bei Verwendung von ExternInclude

Code Block
{INFO-ExternSessionID} ~INFO-ExternSessionID~ {/INFO-ExternSessionID}

INFO-ATitleCode

100

Der zum Titel der Rechnungsanschrift gehörende Code.

Code Block
~INFO-ATitleCode~

INFO-DTitleCode

100

Der zum Titel der Lieferanschrift gehörende Code.

INFO-ASalutationCode

100

Der zur Anrede der Rechnungsanschrift gehörende Code.

INFO-DSalutationCode

100

Der zur Anrede der Lieferanschrift gehörende Code.

INQUIRY-SendUserEmail_name

100

Der Name des HTML-Elements zur Steuerung der Bestätigungsemail durch den Benutzer wie in der Konfigurationsdatei festgelegt.

INQUIRY-SendUserEmail_descr

100

Die textuelle Beschreibung des HTML-Elements zur Steuerung der Bestätigungsemail durch den Benutzer wie in der Konfigurationsdatei angegeben.

INQUIRY-SendUserEmail_value

111

Der vom Benutzer ausgewählte Wert.

INQUIRY-AlreadySent

011

Hiermit kann auf dem Antworttemplate geklammert werden, ob eine Anfrage bereits abgesendet wurde bzw. der Benutzer zu lange inaktiv war. Fehlt dieser Bereich auf dem Antworttemplate und dieser Fall tritt ein, wird ein Standardfehlertemplate angezeigt.

INQUIRY-NewInquiryLink

111

WICHTIG: Dieses Tag wird nur angezeigt bzw. der Link erzeugt, wenn INQUIRY4 NICHT im per ExternInclude eingebunden wird!

Soll ein Link dieser Art per ExternInclude eingebunden werden, so kann ein WEBSALE-Link verwendet werden:

Code Block
~WS-LoadTpl(<Template mit ExternInclude>)~

Erzeugt einen Link zum erneuten Aufruf von INQUIRY4 mit der aktuellen Konfiguration.

INQUIRY-Link

100

Die Form-URL zum Aufruf von INQUIRY4 .

Code Block
... <form action="~INQUIRY-Link~" method="POST"> ... </form> ...

INQUIRY-ReloadButton

100

Buttonname zum Aktualisieren der Anfrage. Es werden alle eingegebenen Daten aufgenommen und die Liste der hochgeladenen Dateien aktualisiert. Die eingegebenen Daten werden nicht geprüft und die Anfrage wird nicht abgesendet.

MSG-Notify

100

Zeigt den allgemeinen Fehlertext an. (Konfigurationsdatei: Sektion <ErrorMessages>, Parameter Error).

Dieser Text wird nicht beim ersten Aufruf von INQUIRY4 angezeigt.

MSG-Input_error

111

Erzeugt eine detaillierte Liste der fehlerhaften Eingaben.

Es wird eine ul/li Liste erzeugt. Verwendete Stylesheet-Klassen: ″input_error_ul″, ″input_error_li″.

Die Reihenfolge der Meldungen in dieser Liste ist dieselbe wie die der zugehörigen Sektionen in der Konfigurationsdatei.

URL-Template

100

Wird durch die URL auf das Template-Verzeichnis ersetzt.

Code Block
... <base href=″~URL-Template″> ...

Regeln für ein HTML-E-Mail-Template

...

INQUIRY4 verwendet folgende Namen für Stylesheet-Klassen und Buttons:

Stylesheet-Klassen

Klasse
.input_error_ul .input_error_li	Liste der Fehlermeldungen
.select_a_dateofbirth	SelectBox des Geburtsdatums der Rechnungsadresse
.select_d_dateofbirth	SelectBox des Geburtsdatums der Lieferadresse
.select_a_country	SelectBox der Länderauswahl der Rechnungsadresse
.select_d_country	SelectBox der Länderauswahl der Lieferadresse
.select_a_title	SelectBox der Titelauswahl der Rechnungsadresse
.select_d_title	SelectBox der Titelauswahl der Lieferadresse
.select_a_salut	SelectBox der Anredeauswahl der Rechnungsadresse
.select_d_salut	SelectBox der Anredeauswahl der Lieferadresse

Verwendung von INQUIRY4 mit WEBSALE E-Commerce

...

INQUIRY4 unterstützt das von WEBSALE angebotene Feature des externen Includes. Dadurch kann INQUIRY4 ohne iFrame auf einem Shoptemplate Shop-Template eingebunden werden (siehe dazu auch Beispieldateien)..

Siehe dazu die Beispieldateien in der Frontend-Dokumentation:

https://doku.websale.net/index.html?mats_materialien_zu_inquiry4.html

Integration auf einem Shop-Template

...

Code Block

...
<body>
...
~WS-ExternInclude(httphttps://~URL$URL-Homepage~Homepage$/cgi/INQUIRY4 inquiry4.cgi?inq4=~WS$WS-ShopID~ShopID$.~WS$WS-SubshopID~SubshopID$&cfg=<Name-Ihrer-Config-Datei>.config)~
...
</body>
...

...

Um das Formular anzeigen zu lassen, muss das Template des Shops geladen werden.

Beispiel:

Code Block
~WS-LoadTpl(tpl_anfrage.htm)~

Anhang

Nicht mehr unterstützte Parameter und Tags

...

Code Block

<Captcha>
  Use ArithmeticCaptcha		=	no
  UseRecaptchaCaptcha		=	yes
  RecaptchaPublicKey		=
  RecaptchaPrivateKey		=	
  RecaptchaTheme		    =	clean # red|white|blackglass|clean
  CaptchaNotFilledIn		=	Dieses Formular ist vor Missbrauch geschützt. Um das Formular absenden zu können, muss die angezeigte Zeichenkette eingegeben werden.
  CaptchaError			    =	Dieses Formular ist vor Missbrauch geschützt. Um das Formular absenden zu können, muss die angezeigte Zeichenkette korrekt eingegeben werden.
  CaptchaTechnicalProblem	=	Die Anfrage kann im Moment aus technischen Gründen nicht bearbeitet werden. Bitte versuchen Sie es zu einem späteren Zeitpunkt noch einmal.
</Captcha>

Parameter	Beschreibung	Werte
UseArithmeticCaptcha	Wenn Sie als CAPTCHA-Funktion ReCaptcha verwenden möchten, muss dieser Parameter auf "no" stehen!	[yes][no] Standard: no
UseRecaptchaCaptcha	Legt fest, ob die CAPTCHA-Funktion ReCaptcha verwendet werden soll.	[yes][no] Standard: no
RecaptchaPublicKey	Für die Nutzung von “ReCaptcha” notwendiger und kostenlos bei Google zu beantragender Schlüssel
RecaptchaPrivateKey	Für die Nutzung von “ReCaptcha” notwendiger und kostenlos bei Google zu beantragender Schlüssel
RecaptchaTheme	Legt die gewünschte Farbgestaltung des ReCaptcha-Widgets fest.	[red][white][blackglass][clean], Standard: clean
CaptchaNotFilledIn	Dieses Formular ist vor Missbrauch geschützt. Um das Formular absenden zu können, muss die angezeigte Zeichenkette eingegeben werden. Dieser Fehlerstring wird angezeigt, wenn die Zeichenkette nicht eingegeben wurde.
CaptchaError	Dieses Formular ist vor Missbrauch geschützt. Um das Formular absenden zu können, muss die angezeigte Zeichenkette korrekt eingegeben werden. Dieser Fehlerstring wird angezeigt, wenn die Zeichenkette falsch eingegeben wurde.
CaptchaTechnicalProblem	Die Anfrage kann im Moment aus technischen Gründen nicht bearbeitet werden. Bitte versuchen Sie es zu späteren Zeitpunkt noch einmal. Dieser Fehlerstring wird angezeigt, wenn der externe Dienst nicht verfügbar ist.

Konfiguration der Rechenaufgabe

Parameter "UseRecaptchaCaptcha =" ist veraltet, wird ersetzt durch "UseReCaptchaV3 =".

...

Die folgenden Angaben dienen lediglich zur Information.

Tag	Unterstützt	Beschreibung
CAPTCHA-Description	111	Gibt die Beschreibung der CAPTCHA-Funktionalität aus. (Konfigurationsdatei: Sektion <Captcha>, Parameter CaptchaDescription).
CAPTCHA-RecaptchaPublicKey	111	Gibt den PublicKey der ReCaptcha-Funktionalität aus.(Konfigurationsdatei: Sektion <Captcha>, Parameter RecaptchaPublicKey).
CAPTCHA-RecaptchaTheme	111	Gibt die gewünschte Farbgestaltung des ReCaptcha-Widgets aus (Konfigurationsdatei: Sektion <Captcha>, Parameter RecaptchaTheme).

Haftungs- und Gewährleistungsausschluss

Die Nutzung des Programms erfolgt auf Grundlage der dem Nutzer bekannten allgemeinen Geschäftsbedingungen der WEBSALE AG unter ausdrücklichem Ausschluss jeglicher Haftung oder Gewährleistung. Die Geschäftsbedingungen können jederzeit bei der WEBSALE AG angefordert werden. Durch die Nutzung des Programms erkennen Sie diese Bedingungen an. Include PageHaftungsausschluss/DisclaimerHaftungsausschluss/Disclaimer

...

Gutenstetter Str. 2, 90449 Nürnberg, +49 (0)911-63 221-0, kontakt@websale.de, www.websale.de

Haftungsausschluss

^{Alle Inhalte werden von der WEBSALE AG ausschließlich zu allgemeinen Informationszwecken veröffentlicht. Für die Richtigkeit, Vollständigkeit und Aktualität der Inhalte können wir jedoch keine Gewähr übernehmen.}

Disclaimer

^{All content is published by WEBSALE AG for general information purposes only. However, we cannot guarantee the correctness, completeness and actuality of the contents.}

Page Comparison

Versions Compared

Old Version 15

New Version Current

Key

Einleitung

Zielgruppe für diese Dokumentation

Allgemeine Anwendung des Programms

SPAM-Vermeidung: Blacklisting

SPAM-Vermeidung: Blacklisting

Parameter beim Aufruf eines Formulars

Weitere, optionale Parameter

Spezielle Parameter

Grundlagen für Anfrageformulare

Speicherort der benötigten Dateien

Beschreibung der Parameter:

Angaben zur Bestätigungs-E-Mail an den Anfragenden

Angaben zur Anfrage-E-Mail

PDF-Download der Anfrage

Konfiguration des WEBSALE-Upload-Moduls

Konfiguration der CAPTCHA-Funktionalität

Konfiguration

Konfiguration Google ReCaptcha (Version 3)

Konfiguration

Friendly Captcha

Fehlermeldungen für den Anwender

Allgemeine Anfragefelder

Adressfelder

Sektion SendUserEmail

Tags und Templates

Verwendung von Tags

Arten von Tags

Konfiguration des Blacklisting

Fehlermeldungen für den Anwender

Allgemeine Anfragefelder

Adressfelder

Sektion SendUserEmail

Tags und Templates

Verwendung von Tags

Arten von Tags

Tags der optionalen Lieferadresse

Tags von allgemeinen Eingabefeldern

Tags der CAPTCHA-Funktionen

Tags der CAPTCHA-Funktionen

Allgemeines Tag

Tags für die Rechenaufgabe und Beispiel

Tags für Google ReCaptcha Version 3 und JavaScript

Tags für die Rechenaufgabe und Beispiel

Tags für Friendly Captcha

Tags des PDF-Downloads

Tags des Dateiuploads

Design Control Tags

Spezielle Tags

Regeln für ein HTML-E-Mail-Template

Stylesheet-Klassen

Verwendung von INQUIRY4 mit WEBSALE E-Commerce

Integration auf einem Shop-Template

Anhang

Nicht mehr unterstützte Parameter und Tags

Konfiguration der Rechenaufgabe

Haftungs- und Gewährleistungsausschluss