Rechnungsadresse abfragen - WEBSALE Dokumentation

Die Rechnungsadresse wird nicht als fertiger Block ausgegeben. Sie setzen jedes Feld einzeln ins Template, mit vier Tags je Feld. Das ist mehr Schreibarbeit als ein einzelner Platzhalter, gibt Ihnen dafür aber die volle Kontrolle über Reihenfolge, Gruppierung und Auszeichnung. Zwei Abschnitte der shop.config legen vorab fest, womit Sie es zu tun haben: welche Felder es überhaupt gibt und welche davon Pflicht sind.

Abschnitt	Legt fest
`<AddressFields-Txt>`	welche Felder der Käufer ausfüllen kann und wie sie beschriftet sind
`<InputCheck>`	welche Felder Pflichtfelder sind

Referenz: Abschnitt AddressFields-Txt · Abschnitt InputCheck

Der Tag-Aufbau

Zu jedem Adressfeld gehören vier Tags. Der <technischer Name> ist dabei der Parametername aus <AddressFields-Txt>.

Tag	Liefert
`A-<technischer Name>_text`	die Beschriftung des Feldes
`A-<technischer Name>_input`	den Feldnamen für das HTML-Formular
`A-<technischer Name>_max`	die zulässige Zeichenzahl
`A-<technischer Name>`	den bereits eingegebenen Wert

Ein Textfeld sieht damit so aus:

<label for="firstName">~A-FirstName_text~</label>
<input type="text" id="firstName"
   name="~A-FirstName_input~"
   maxlength="~A-FirstName_max~"
   value="~A-FirstName~">

Alle übrigen Textfelder bauen Sie nach demselben Muster. Das gesamte Formular gehört dabei in ~FORM-Addr~. Nehmen Sie die Zeichenzahl aus ~A-FirstName_max~ statt sie fest einzutragen. Dann bleibt das Template richtig, wenn jemand die Länge in der shop.config ändert. Referenz: FORM-Addr

Auswahllisten

Einige Felder sind keine Textfelder, sondern Auswahllisten. Diese füllt der Shop selbst, Sie setzen nur ein Tag. Statt _input, _max und dem Wert gibt es hier ein _list, das die fertige Liste samt umgebendem <select> ausgibt.

<label>~A-Salutation_text~</label>
~A-Salutation_list~

Feld	Tag für die Liste	Inhalt
Anrede	`A-Salutation_list`	Einträge aus der `salutation.dat`
Titel	`A-Title_list`	Einträge aus der `title.dat`
Land	`A-Country_list`	Einträge aus der `country.dat`
Geburtsdatum	`A-DateOfBirth_list`	drei Listen für Tag, Monat und Jahr
Kundentyp	`A-UserType_list`	die konfigurierten Kundentypen

Das <select>-Element kommt mit einer Klasse, an der Sie es gestalten können: select_salutation, select_title, select_country. Bei fehlerhafter Eingabe hängt der Shop an diese Klasse ein _error an.

Beim Land steht im Wert der Auswahl nicht nur der ISO-Code, sondern Name,ISO. Werten Sie die Auswahl per JavaScript aus, müssen Sie am Komma trennen.

Die früheren Auswahllisten A-UserDefList-1 bis A-UserDefList-3 werden nicht mehr unterstützt. Verwenden Sie stattdessen die aktuellen Auswahllisten der Adressdaten. Wegweiser: Auswahllisten der Adressdaten

Besonderheiten einzelner Felder

E-Mail-Adresse: Bei einem angemeldeten Käufer übernimmt der Shop eine Eingabe in diesem Feld nicht. Die Adresse ist Teil des Kundenkontos und wird dort geändert, nicht über das Adressformular.
Kundennummer: Wird vom Shop vergeben und nicht aus dem Formular gelesen. Das Tag ~A-Number~ gibt sie aus.
Geburtsdatum: Die drei Auswahllisten schreiben in drei getrennte Formularfelder, die der Shop danach zu einem Datum zusammensetzt. Behandeln Sie A-DateOfBirth_list deshalb als Ganzes und zerlegen Sie es nicht.

Weitere Tags

Tag	Verwendung	Wo
`MSG-Addr_InputError`	fehlerhafte Eingaben	`ws_address_manage.htm`
`MSG-Addr_Notify`	Hinweismeldungen zur Rechnungsadresse	`ws_address_manage.htm`
`WS-AddrManageLink`	Link zur Adressverwaltung	alle Templates
`ST-Addr_Order`	Klammerung: Adresseingabe im Bestellablauf	`ws_address_combined.htm`, `ws_login.htm`
`ST-Addr_OK`	Klammerung: Adresse ist vollständig	alle Templates
`BT-Addr_Back`	Schaltfläche „Zurück”	`ws_address_manage.htm`
`BT-Addr_Next`	Schaltfläche „Weiter”	`ws_address_manage.htm`
`BT-Addr_Delete`	Schaltfläche „Löschen”	`ws_address_manage.htm`
`BT-Addr_Change`	Schaltfläche „Ändern”	alle Templates
`BT-Change_Addr`	Schaltfläche „Rechnungsadresse ändern”	`ws_place_order.htm`

BT-Addr_Change und BT-Change_Addr unterscheiden sich nur in der Wortstellung und tun nicht dasselbe. BT-Change_Addr gibt ausschließlich auf der Bestellübersichtsseite etwas aus und bleibt auf jedem anderen Template leer. BT-Addr_Change funktioniert überall.

BT-Addr_Delete erscheint nur auf der Verwaltungsseite der Rechnungsadresse und auf der gemeinsamen Adressseite im Bestellablauf. Auf anderen Templates bleibt es leer.

​Der Tag-Aufbau

​Auswahllisten

​Besonderheiten einzelner Felder

​Weitere Tags

​Verwandte Themen

Der Tag-Aufbau

Auswahllisten

Besonderheiten einzelner Felder

Weitere Tags

Verwandte Themen