> ## Documentation Index > Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt > Use this file to discover all available pages before exploring further. # Konfiguration title.dat > Aufbau der Titelliste title.dat: Spalten, Titelcodes und der Unterschied zwischen dem Titel in der Auswahlliste und dem Titel in der Anredezeile. 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](https://mintcdn.com/websaleag-44ee7ea6/qpKXKLTjn0wDjacH/images/konfig_titel.png?fit=max\&auto=format\&n=qpKXKLTjn0wDjacH\&q=85\&s=b80ebc9cb5eef096c6c027d635f29450) 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](https://dokumentation.websale.de/v8s/referenz/konfigurationen/konfiguration-salutation-dat.md) · Wegweiser: [Bildung von Anreden und Titeln festlegen](https://dokumentation.websale.de/v8s/adressdaten/bildung-von-anreden-und-titeln-festlegen.md), [Auswahllisten der Adressdaten](https://dokumentation.websale.de/v8s/adressdaten/auswahllisten-der-adressdaten.md) · Grundlagen: [Grundlagen zu Konfigurationen](https://dokumentation.websale.de/v8s/grundlagen-konfiguration/konfiguration-grundlagen.md) ## Wo die Datei liegt Der Shop sucht die Datei an zwei Stellen, in dieser Reihenfolge: ```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} konfiguration//title.dat konfiguration/title.dat ``` Zuerst gilt die Datei des Subshops. Fehlt sie, greift der Shop auf die gemeinsame Datei eine Ebene höher zurück. > [!WARNING] > > 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. | Spalte | Bedeutung | | - | - | | `Title` | der Eintrag, wie er in der Titel-Auswahlliste erscheint | | `Country` | Ländercode zur Bildung verschiedener Titel-Auswahllisten je nach Shopsprache | | `Code` | der Titelcode, beispielsweise `$1` für "Rechtsanwalt" | | `Text` | der Titel in der Form, in der er in der **Anredezeile** erscheint | | `LastNameInSalutation` | ob der Nachname in der Anredezeile angezeigt wird. `X` zeigt ihn an, leer unterdrückt ihn | > [!NOTE] > > 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: | `Title` | `Text` | Ergebnis in der Anredezeile | | - | - | - | | `Prof.Dr. rer.nat. Dr.` | `Professor` | "Sehr geehrter Herr Professor Müller" | | `Dr. habil` | `Dr.` | "Sehr geehrter Herr Dr. Müller" | ### 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. | Title | Country | Code | Text | LastNameInSalutation | | - | - | - | - | - | | | `DEU` | `00` | `0` | `0` | | Rechtsanwalt | `DEU` | `$1` | `0` | `X` | | Ing. | `DEU` | `$2` | `0` | `X` | | Prof.Dr. rer.nat. Dr. | `DEU` | `$3` | Professor | `0` | | Dr. habil | `DEU` | `$4` | Dr. | `X` | | Dipl.-Ing. | `DEU` | `1` | `0` | `X` | > [!WARNING] > > 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](https://dokumentation.websale.de/v8s/referenz/konfigurationen/konfiguration-salutation-dat.md) Welche Sprache Ihr Shop verwendet, stellen Sie im Abschnitt `Basic` der `shop.config` ein. Referenz: [shop.config, Grundlagen und Technik](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/grundlagen-und-technik.md) ## Ä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. ## Related topics - [Konfiguration salutation.dat](https://dokumentation.websale.de/v8s/referenz/konfigurationen/konfiguration-salutation-dat.md) - [Bildung von Anreden und Titeln festlegen](https://dokumentation.websale.de/v8s/adressdaten/bildung-von-anreden-und-titeln-festlegen.md) - [Konfigurations-Typen](https://dokumentation.websale.de/v8s/grundlagen-konfiguration/konfigurations-typen.md) - [Konfiguration: Grundlagen](https://dokumentation.websale.de/v8s/grundlagen-konfiguration/konfiguration-grundlagen.md) - [Materialien INQUIRY](https://dokumentation.websale.de/v8s/materialien/materialien-inquiry.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.