Zum Hauptinhalt springen
Die Konfiguration title.dat definiert die Titel, die der Käufer bei der Eingabe seiner Rechnungsadresse und seiner abweichenden Lieferadresse auswählen kann. Sie legt außerdem fest, wie der gewählte Titel später in der Anredezeile erscheint. Konfig Titel Die Form der Anrede selbst legen Sie in der Konfiguration salutation.dat fest. Dort bestimmen Sie auch, ob der Titel in der Anredezeile überhaupt vorkommt. Referenz: Konfiguration salutation.dat · Wegweiser: Bildung von Anreden und Titeln festlegen, Auswahllisten der Adressdaten · Grundlagen: Grundlagen zu Konfigurationen

Wo die Datei liegt

Der Shop sucht die Datei an zwei Stellen, in dieser Reihenfolge:
Zuerst gilt die Datei des Subshops. Fehlt sie, greift der Shop auf die gemeinsame Datei eine Ebene höher zurück.
Eine der beiden Dateien muss vorhanden sein, und die gefundene Datei darf nicht leer sein. Andernfalls bricht der Shop mit einer Fehlermeldung ab.Achten Sie dabei auf einen Unterschied zur salutation.dat: Eine leere Datei im Subshop-Verzeichnis löst bei der title.dat keinen Rückfall auf die gemeinsame Datei aus, sondern führt direkt zum Abbruch. Löschen Sie die Datei im Subshop-Verzeichnis also ganz, statt ihren Inhalt zu leeren.

Aufbau

Die Datei ist tabulatorgetrennt aufgebaut. Die erste Zeile enthält die Spaltennamen, ab der zweiten Zeile folgt je Titel eine Zeile.
Die Spalten werden über ihre Namen in der Kopfzeile gefunden, nicht über ihre Position. Die Reihenfolge der Spalten ist damit frei, die Schreibweise der Namen dagegen nicht. Mehr als zehn Spalten wertet der Shop nicht aus.Das Modul für Formulare und Anfragen bricht mit einer Warnung ab, wenn eine der fünf Spalten in der Kopfzeile fehlt.

Title und Text sind nicht dasselbe

Das ist der Punkt, an dem diese Datei am häufigsten missverstanden wird. Title ist die geschriebene Form für die Auswahlliste und für die Adressdaten. Text ist die gesprochene Form für die Anredezeile. Der Platzhalter $W-Title in der salutation.dat wird durch den Inhalt der Spalte Text ersetzt, nicht durch Title. Damit lassen sich lange akademische Titel sauber trennen:

Der erste Eintrag

Die zweite Zeile der Datei, also der erste Dateneintrag, ist für Käufer gedacht, die keinen Titel haben oder keinen angeben möchten. Ihre Spalte Title bleibt leer, damit die Auswahlliste mit einem leeren Eintrag beginnt. Für diesen leeren Eintrag stellt der Shop dem Titelcode im Formularwert empty_ voran, also beispielsweise empty_00. Beim Auswerten entfernt er das Präfix wieder.

Der Titelcode

Der Titelcode muss über alle Ländercodes hinweg gleich bleiben. Trägt “Rechtsanwalt” im deutschen Shop den Code $1, dann muss “Advocate” im englischen Shop denselben Code $1 tragen. Der Grund liegt in der Weiterverarbeitung: Gespeichert wird der Code, nicht der Text. Nur wenn der Code über alle Sprachen hinweg dieselbe Bedeutung hat, lassen sich Vorname und Titel später korrekt prüfen und eine passende Anrede erzeugen. Der Code ist freier Text. Das Dollarzeichen ist Konvention, keine Vorschrift, und der Shop vergleicht den Code unabhängig von Groß- und Kleinschreibung.

Beispiel

Eine title.dat für Deutsch und Englisch, hier der deutsche Block. Die erste Datenzeile ist der Eintrag ohne Titel.
In diesem Beispiel steht an mehreren Stellen eine 0, wo die Spaltenbeschreibung von einer leeren Zelle spricht.Wenn Sie eine neue title.dat anlegen, lassen Sie diese Zellen im Zweifel leer. Eine bestehende Datei mit 0 lassen Sie unverändert, solange die Anredezeilen im Shop korrekt aussehen.

Die Anredezeile

Wie der Titel in der Anredezeile landet, legen Sie in der salutation.dat über die Spalte CompleteSalutation fest. Diese Datei steuert dazu zwei Dinge bei: Die Spalte Text liefert den Inhalt für den Platzhalter $W-Title. Die Spalte LastNameInSalutation entscheidet, ob der Platzhalter $W-LastName mit dem Nachnamen gefüllt oder leer gelassen wird. Das greift auch dann, wenn die salutation.dat den Platzhalter vorsieht. Ein Titel kann den Nachnamen in der Anrede also unterdrücken. Nach dem Einsetzen der Platzhalter zieht der Shop doppelte Leerzeichen zusammen und entfernt ein nachlaufendes Leerzeichen. Ein unterdrückter Titel oder Nachname hinterlässt also keine Lücke in der Anredezeile. Referenz: Konfiguration salutation.dat Welche Sprache Ihr Shop verwendet, stellen Sie im Abschnitt Basic der shop.config ein. Referenz: shop.config, Grundlagen und Technik

Änderungen an der Titelliste

Der Shop liest die Datei einmal je Aufruf. Änderungen wirken also mit dem nächsten Seitenaufruf. Eine Zeile, die Sie entfernen, verschwindet aus der Auswahlliste. Für Adressen, die den zugehörigen Titelcode bereits gespeichert haben, findet der Shop danach keinen passenden Eintrag mehr und gibt weder Titel noch Titeltext aus. Ändern Sie deshalb besser nur den Text und löschen Sie nur Zeilen, deren Code nie im Einsatz war.