Textbausteine

Shopware verwendet für die Übersetzung und die Anpassung von Texten Textbausteine, welche zentral angepasst und verwaltet werden können. Diese Textbausteine können dann beispielsweise im Frontend ausgegeben werden. Das Modul zur Verwaltung findest Du unter Einstellungen > Shop > Textbausteine.

Die Textbausteine werden in Textbaustein-Sets unterteilt. Im Standard sind dies die Sets BASE de_DE (1) und BASE en_GB (2) welche die Übersetzungen für Deutsch und Englisch widerspiegeln. Sie greifen auf die jeweiligen Basisdateien messages.de_DE und messages.en_GB zurück. Diese Basisdateien beinhalten die Standard-Werte der Textbaustein-Sets, um anhand dessen die Textbausteine später beispielsweise wieder zurücksetzen zu können.

Diese Dateien sollten nicht manuell angepasst werden, da diese benötigt werden, um Textbausteine wieder auf Ihren Standardwert zurückzusetzen.

Über den Button Textbausteine bearbeiten (3) kannst Du das zuvor ausgewählte Textbaustein-Set und die darin enthaltenen Textbausteine bearbeiten.
Mit dem Button Textbaustein-Set hinzufügen (4) erstellst Du ein neues Textbaustein-Set. Dies kannst Du entweder auf Basis einer Basisdatei oder über den Pfeil neben dem Button als Duplikat eines bereits bestehenden Sets erstellen.
Das Kontextmenü (5) erlaubt es Dir, ein Textbaustein-Set zu bearbeiten, es zu duplizieren oder zu löschen.

Einen Textbaustein bearbeiten

Um einen Textbaustein zu bearbeiten, klickst Du zunächst auf das jeweilige Set, in welchem der zu bearbeitende Textbaustein liegt. Möchtest Du einen Textbaustein in mehreren Sets bearbeiten kannst Du auch mehrere Sets per Checkbox selektieren und auf den Button Textbausteine bearbeiten klicken.

Daraufhin wird Dir eine Tabelle mit allen Textbausteinen angezeigt, welche in der Datenbank-Tabelle snippets hinterlegt sind. In der Spalte Name (1) findest Du die Bezeichnung des Textbausteins. Jeder Textbaustein hat eine Übersetzung in jedem Textbaustein-Set (2)
Über das Kontextmenü (3) kannst Du die Textbausteine bearbeiten oder auf den Standardwert aus der Basisdatei zurücksetzen.
Auf der rechten Seite findest Du den Refresh-Button (4). Diese Schaltfläche aktualisiert die Daten mit der Datenbanktabelle.
Mit der Schaltfläche Filter (5) kannst Du einige Filteroptionen für die angezeigten Textbausteine einblenden.

Bearbeiten

Wenn Du im Kontextmenü auf Bearbeiten klickst, öffnen Sie die Bearbeitungsoption.
Hier siehst Du den Namen des Textbausteins. Unter dem Punkt Übersetzungen kannst Du den Inhalt aller Übersetzungen dieses Textbausteins bearbeiten.

Leere Textbausteine anzeigen (1): Dieser Filter zeigt nur Textbausteine an, welche in mindestens einem Textbaustein-Set noch keinen Inhalt haben.
Eigene Textbausteine anzeigen (2): Dieser Filter zeigt nur Textbausteine an, welche in der Basisdatei noch nicht vorhanden sind und somit selbst angelegt wurden.
Autor (3): Mit diesem Filter lassen sich alle Textbausteine eines bestimmten Autors finden. Die Standard-Textbausteine aus der Basisdatei haben hier den Autor Shopware.
Weitere Filter (4): Dieser Filter hilft Dir dabei, die Ansicht nach gewissen Bereichen zu Filtern, in denen der gesuchte Textbaustein sich befindet. Textbausteine aus dem Bereich Checkout kannst Du beispielsweise mit dem Filter checkout filtern.

Einen neuen Textbaustein anlegen

Solltest Du einen zusätzlichen Textbaustein benötigen, kannst Du innerhalb eines Textbaustein-Sets neue Textbausteine anlegen. Neue Textbausteine werden global erstellt. Es ist also nicht erforderlich, in jedem Set den Textbaustein einzeln anzulegen. Der Inhalt des Textbausteins kann dann für alle Textbaustein-Sets gepflegt werden.

Beim Erstellen eines eigenen Textbausteins im twig Template sollte der Textbaustein mit raw enden.

Um einen neuen Textbaustein anzulegen, wechsele zunächst in ein Textbaustein-Set. Dies ist möglich, indem Du entweder direkt auf den Namen (1) des Sets klickst oder das Kontextmenü über den "..."-Button (2) öffnest.

In dem Textbaustein-Set kannst Du dann über den Button Neuer Textbaustein (1) die Maske für die Anlage eines neuen Textbausteins öffnen.

Zunächst vergib einen Namen (1) für den neuen Textbaustein. Da der Name auch für die Einbindung z.B. ins Frontend genutzt wird, empfehlen wir, keine Leerzeichen bzw. Sonderzeichen zu verwenden. Außerdem solltest Du einen aussagekräftigen Namen wählen.
Nun kannst Du den Inhalt des Textbausteins pflegen. Im Bereich Übersetzungen (2) wird Dir hierzu für jedes vorhandene Textbautein-Set ein eigenes Feld angezeigt.
Der neue Textbaustein kann erst gespeichert (3) werden, wenn Du einen validen Namen vergeben hast.

Wie Du den Textbaustein im Frontend ausgeben kannst, erfährst Du in diesem Tutorial

Ein neues Textbaustein-Set anlegen

Solltest Du in einem Verkaufskanal Textbausteine verwenden wollen, die vom Standard abweichen, kannst Du dies über ein eigenes Textbaustein-Set lösen. Dies ist besonders dann sinnvoll, wenn Du weiterhin das Standard-Set unverändert verwenden möchtest, z.B. wenn Du in einem Verkaufskanal über unterschiedliche URLs für Deutschland und Österreich verschiedene Textbaustein-Sets einbinden möchtest.

Du hast zwei Möglichkeiten, ein neues Textbaustein-Set zu erstellen. Auf Grundlage einer der Basis-Dateien (im Standard sind Deutsch und Englisch enthalten) kannst Du über den Button Textbaustein-Set hinzufügen (1) ein Neues Set erstellen. Alternativ kannst Du auch ein bereits bestehendes Set duplizieren, dies ist auch für selbst erstellte Sets möglich. Hierzu öffnest Du entweder das Dropdown-Menü (2) neben der Hinzufügen-Schaltfläche oder das Kontext-Menü eines Textbaustein-Sets über den "..."-Button (3).

Hinzufügen

Nachdem Du auf den Button Textbaustein-Set hinzufügen geklickt hast, erscheint eine Maske direkt in der Übersicht, in der Du die relevanten Informationen hinterlegen kannst.

Vergib nun einen Namen für das Set und wähle aus, welche der Basisdateien als Grundlage dienen soll. Durch die Zuordnung der Basisdatei werden deren Textbausteine als Fallback für das neue Set verwendet. Solange Du also im neuen Set den Textbausteinen keinen eigenen Inhalt einfügst, werden die Werte aus der Basisdatei ausgegeben.

Duplizieren

Beim Duplizieren kannst Du aus allen bereits vorhandenen Sets wählen. Das Duplikat wird direkt mit dem gleichen Namen und dem Zusatz Kopie erstellt. Die Anpassung des Namens ist hinterher in der Übersicht möglich. Hierzu klickst Du doppelt in die Zeile des Textbaustein-Sets, dessen Namen Du ändern möchtest. Beachte bitte, dass Du mit einem Klick auf den Namen des Sets die Übersicht der enthaltenen Textbausteine aufrufst und dort der Name nicht geändert werden kann.

Tipps und Tricks

Links einbinden

Solltest Du einen Link in einem Textbaustein verwenden wollen, kannst Du dies über das HTML-Attribut a href umsetzen.

<a href="URL">Angezeigter Text</a>

Dies sieht dann beispielhaft wie folgt aus.

<a href="https://www.shopware.com">Aufruf der Shopware-Homepage</a>

Service-Hotline bearbeiten

Du kannst bei Bedarf den Inhalt der Servive-Hotline per Anpassung des Textbausteines footer.serviceHotline ändern. Die Service-Hotline wird standardmäßig im Footer auf der Storefront angezeigt. Wenn Du weitere Bereiche des Footers bearbeiten möchten, z. B. neue Links oder Navigationspunkte, schaue in das Tutorial Einrichtung des Footers und Servicemenüs.

Um den Inhalt der Service-Hotline anzupassen, gehe in die Einstellungen > Textbausteine, wähle das passende Textbaustein-Set aus und suche nach footer.serviceHotline. Wenn Du den Textbaustein öffnest, kannst Du unter Übersetzungen den Text in der gewünschten Sprache ändern. Klicke anschließend auf Speichern.

Zeilenumbrüche einfügen

Wenn Du einen Zeilenumbruch innerhalb eines Textbausteins einfügen möchtest, kannst Du dies über das HTML-Attribut br umsetzen.

Nach dem Komma,<br> kommt ein Zeilenumbruch.