PLZ-Assistent
WEBSALE V8s bietet einen komfortablen, AJAX-basierenden PLZ-Assistenten an, der sehr einfach in die Adresseingabe-Templates integriert werden kann. Momentan unterstützt der PLZ-Assistent die Länder Deutschland und Österreich.
Hinweis: |
|
|
Der PLZ-Assistent basiert auf einer Datenbank, die von einem externen Partner bereitgestellt und aktualisiert wird. Änderungen oder Aktualisierungen können somit nicht direkt von WEBSALE vorgenommen werden. Ihr WEBSALE-Ansprechpartner steht Ihnen bei Fragen gerne zur Verfügung. |
Inhalt
2 Integration in die Templates für die Rechnungs- und Lieferadresse im Bestellablauf/Kundenkonto
3 Integration in INQUIRY-Formulare
Der PLZ-Assistent funktioniert erst, wenn ein Land ausgewählt wurde, da er nur für Deutschland und Österreich zur Verfügung steht. Ist noch kein Land gewählt, wird der PLZ-Assistent nicht ausgeführt.
Nach der Eingabe von 2 Zeichen in das Postleitzahlen- oder Stadt-Eingabefeld wird automatisch ein div-Container mit passenden Stadt- und PLZ-Optionen angezeigt. Dieser Container für die Stadt- und PLZ-Vorschläge besitzt mehrere CSS-Styles. Diese IDs und Klassen können Sie in Ihre CSS-Datei kopieren und entsprechend anpassen.
Styles: Styles für PLZ-Assistent
Auswahl der angebotenen Ergebnisse besser sortieren
Die in der Auswahlbox angebotenen Treffer können nicht nur durch einen Mausklick, sondern auch durch die Pfeil-Tasten der Tastatur und "Enter" ausgewählt werden.
Eindeutige Ergebnisse werden vorausgefüllt
Gibt es für eine Postleitzahl oder einen Ortsnamen nur einen dazu passenden Treffer, wird dieser automatisch vorausgefüllt.
Eingabebeispiel: Tül
Diese Eingabe wird automatisch vervollständigt zu: 38474 Tülau
Diese Autovervollständigung kann im JavaScript (siehe unten) optional auch ausgeschaltet werden:
...
var params = {
language_list: ["DEU","AUT"],
...
autocomplete: false
...
};
...
2 Integration in die Templates für die Rechnungs- und Lieferadresse im Bestellablauf/Kundenkonto
Voraussetzung für den PLZ-Assistenten ist die WEBSALE Systembibliothek ws-system-1.1.0.js und die Modul-Komponente ws-ziphelp-1.1.0.js. Kopieren Sie die folgenden Zeilen in den <head>-Bereich Ihres Templates:
<head>
...
<script type="text/javascript" src="/$WS/ws_sysdata/js/ws-system-1.1.0.js"></script>
<script type="text/javascript" src="/$WS/ws_sysdata/js/ws-ziphelp-1.1.0.min.js"></script>
<script type="text/javascript">
$(document).ready(function(){
var params = {
language_list: ["DEU","AUT"],
call_url: "~WS-AjaxZipHelpURL~",
zip_field: "input[name=ws_input_zip]",
city_field: "input[name=ws_input_city]",
lang_field: "select[name=ws_input_country]",
close: true,
headline: "PLZ-Assistent",
description: "Hilfe zur Auswahl Ihrer Postleitzahl und Ihres Wohnortes",
};
$.ws_zip_help(params);
var paramsDelivery = {};
$.extend(paramsDelivery, params);
paramsDelivery.zip_field = "input[name=ws_input_delivery_zip]";
paramsDelivery.city_field = "input[name=ws_input_delivery_city]";
paramsDelivery.lang_field = "select[name=ws_input_delivery_country]";
$.ws_zip_help(paramsDelivery);
});
</script>
...
</head>
Referenz: WS-AjaxZIPHelpURL
Die beiden Texte "PLZ-Assistent" und "Hilfe zur Auswahl Ihrer Postleitzahl und Ihres Wohnortes" können Sie nach Ihren Anforderungen ändern/übersetzen.
Für die korrekte Anzeige im Browser Opera soll der Zusatz "autocomplete="off" bei den Eingabefeldern für Zip und City stehen:
<input ... name="~A-ZIP_input~" autocomplete="off" ... >
<input ... name="~A-City_input~" autocomplete="off" ... >
Wegweiser: Auswahl zwischen Privat- und Geschäftsadresse
Wegweiser: Auswahl zwischen postalischer Lieferadresse und Packstation
3 Integration in INQUIRY-Formulare
Der PLZ-Assistent lässt sich auch für Eingabefelder der Rechnungs- oder Lieferadresse in INQUIRY-Formularen, z. B. Kontakt- oder Widerrufsformular, integrieren.
Wegweiser: Integration eines INQUIRY-Formulars
Hinweis: |
|
|
Eine detaillierte technische Beschreibung des Formularprogramms INQUIRY4 finden Sie unter: |
Voraussetzung
Achten Sie darauf, dass jQuery und das WEBSALE-Modul "PLZ-Assistent (ws-ziphelp)" in den entsprechenden Templates eingebunden sind.
Materialien: WEBSALE JavaScript-Bibliothek
Konfiguration des Formulars (INQUIRY) ergänzen
Fügen Sie folgenden Abschnitt in die Konfigurationsdatei (z. B. kontakt.config oder widerruf.config) ein. Die INQUIRY-Konfigurationsdateien befinden sich im Online-Servicebereich im Dienst Konfiguration > Konfigurationen > Formulare (Inquiry).
<Shop-ZIP-Assistant>
MallID = websale
ShopID = ihre-shop-id
SubShopID = ihre-subshop-id
BaseUrl = https://www.ihre-shop-url.de
</Shop-ZIP-Assistant>
JavaScript einbinden
Ergänzen Sie den <head>-Bereich des entsprechenden Templates mit folgendem Skript und tragen die technischen Namen der Eingabefelder aus der INQUIRY-Config ein, z. B. zip_field: "input[name=zip]".
<head>
...
<script type="text/javascript">
$(document).ready(function(){
var params = {
language_list: ["DEU","AUT"],
call_url: "~WS-AjaxZipHelpURL~",
zip_field: "input[name=technischer-Name-des-Feldes]",
city_field: "input[name=technischer-Name-des-Feldes]",
lang_field: "select[name=technischer-Name-des-Feldes]",
close: true,
headline: "PLZ-Assistent",
description: "Hilfe zur Auswahl Ihrer Postleitzahl und Ihres Wohnortes",
};
$.ws_zip_help(params);
var paramsDelivery = {};
$.extend(paramsDelivery, params);
paramsDelivery.zip_field = "input[name=technischer-Name-des-Feldes]";
paramsDelivery.city_field = "input[name=technischer-Name-des-Feldes]";
paramsDelivery.lang_field = "select[name=technischer-Name-des-Feldes]";
$.ws_zip_help(paramsDelivery);
});
</script>
...
</head>
Die beiden Texte "PLZ-Assistent" und "Hilfe zur Auswahl Ihrer Postleitzahl und Ihres Wohnortes" können Sie nach Ihren Anforderungen ändern/übersetzen.