Textbausteine

Ein Textbaustein besteht aus einer Bezeichnung und einem Text. Im Template wird nur die Bezeichnung eingebunden, nicht der Text selbst. Dadurch wird er an einer Stelle geändert und die Änderung wirkt sich überall dort aus, wo der Baustein vorkommt. Typische Beispiele hierfür Welcher Text im Shop erscheint, hängt davon ab, in welcher Sprache der aufgerufene Shop-Bereich (Subshop) läuft. Gepflegt werden die Texte im Admin Interface unter dem Dienst.

​

Die Übersicht

Der Dienst zeigt eine Tabelle, in der jede Zeile einem Textbaustein und jede weitere Spalte einer Sprache entspricht. Bis zu drei Sprachen lassen sich gleichzeitig nebeneinander vergleichen und direkt in der Tabelle bearbeiten. Der Verfügbarkeits-Status gibt Auskunft über den Status eines Textbausteins in einer bestimmten Sprache. Es gibt drei Ausprägungen, die in den Zellen farblich hinterlegt sind:

• grün = gepflegt – es liegt ein Text vor.
• gelb = leer – es gibt zwar einen Eintrag für diese Sprache, aber ohne Inhalt.
• rot = nicht vorhanden – für diese Sprache existiert noch gar kein Eintrag.

So lässt sich auf einen Blick erkennen, wo in einer Sprache noch Lücken bestehen. Da mit der Zeit viele Textbausteine über mehrere Sprachen hinweg entstehen, lässt sich die Übersicht außerdem:

• durchsuchen (nach Name und Text),
• filtern, z.B. danach, ob ein Textbaustein tatsächlich irgendwo im Shop verwendet wird oder nicht, ob es sich um einen System- oder eigenen Textbaustein handelt, und nach dem Verfügbarkeitsstatus in einer bestimmten Sprache,
• nach Bereich eingrenzen (z. B. alle Textbausteine, die zum Checkout gehören).

​

System- und eigene Textbausteine

Ein Teil der Textbausteine wird vom System selbst benötigt, beispielsweise für Standardmeldungen, die der Shop automatisch ausgibt. Diese System-Textbausteine lassen sich in jeder Sprache übersetzen bzw. anpassen, aber nicht löschen, da der Shop sonst an dieser Stelle keinen Text mehr hätte. Ihre Bezeichnung beginnt mit ws. Daneben können beliebig viele eigene Textbausteine angelegt werden, etwa für individuelle Hinweise oder Inhalte, die nur in diesem Shop benötigt werden. Diese können vollständig angelegt, bearbeitet und auch wieder gelöscht werden.

​

Sprachen und Vererbung

Ein Beispiel: Eine Sprache „Englisch” kann als Ersatzsprache „Deutsch” hinterlegt haben. Ist ein Textbaustein auf Englisch nicht gepflegt, wird automatisch der deutsche Text angezeigt, anstatt eine Leerstelle zu zeigen. Solche Ketten können auch mehrstufig sein, beispielsweise kann zunächst eine sehr spezielle Sprachvariante auftreten, die dann auf eine allgemeinere Variante und erst danach auf die Hauptsprache zurückfällt. Wichtig dabei ist, dass die Kette nicht weitervererbt wird. Jede Sprache trägt ihre vollständige Reihe von Ersatzsprachen selbst.

Damit eine spezielle Variante über eine allgemeinere bis zur Hauptsprache durchfallen kann, müssen beide bei ihr hinterlegt sein. Es genügt nicht, dass die allgemeinere Variante ihrerseits auf die Hauptsprache verweist. Der Effekt für die Redaktion: Es ist nicht nötig, jeden Text in jeder Sprachvariante zu pflegen. Es reicht, die Basissprache vollständig zu pflegen. Speziellere Varianten übernehmen automatisch deren Inhalte, solange sie selbst keinen eigenen Text hinterlegt haben. Erst wenn für eine spezielle Variante ein eigener, abweichender Text benötigt wird, trägt man ihn dort gezielt ein. Er überschreibt dann nur für diese Sprache die geerbte Fassung.

​

Wirkung im Shop

Zwei Punkte sind für das Verständnis zentral, weil sie leicht zu Verwirrung führen:

​

Import und Export

Größere Mengen an Textbausteinen lassen sich exportieren und wieder importieren, beispielsweise um sie extern übersetzen zu lassen oder um Änderungen gesammelt einzuspielen. Dies kann auf eine einzelne Sprache eingeschränkt werden, sodass beispielsweise nur die französischen Texte exportiert, extern übersetzt und anschließend wieder importiert werden. Der Export berücksichtigt die aktuell gesetzte Suche sowie die gesetzten Filter. Beide Vorgänge laufen im Hintergrund und werden durch eine Fortschrittsanzeige begleitet. Importierte Texte werden ebenfalls erst nach der Veröffentlichung im Shop sichtbar.

​

Sprachen einrichten

Es gibt keine shopweite Mastersprache, von der die Subshops abgeleitet werden. Stattdessen hat jeder Subshop seine eigene Hauptsprache und die Vererbung hängt von dieser Sprache ab. Daraus folgt die Richtung der Kette: Sie zeigt von der speziellen Variante zur allgemeinen Variante, nicht umgekehrt. Ein österreichischer Subshop erhält also die Sprache „Deutsch (AT)” als Hauptsprache, und „Deutsch” als Ersatzsprache. Damit ein Subshop die Texte seiner Sprache verwendet, sind drei Einstellungen nötig. Zwei davon betreffen dieselbe Zuordnung und müssen übereinstimmen:

​

Wegweiser

• actions – Fehlertexte & E-Mails – wie die System-Fehlertexte (ws.error.*) aufgebaut sind.
• Übersicht – Konfiguration – wie Konfigurationen auf Textbausteine verweisen, statt feste Texte zu enthalten.
• general – Allgemeine Shopeinstellungen – Referenz zu general.language, general.subshop und general.subshopView.
• Konfigurations-Deeplinks – direkte Links zu den Konfigurationsknoten.
• API-Referenz Textbausteine – Endpunkte, Filter und Import-/Export-Schnittstelle.