Textbausteine
Shopware verwendet Textbausteine zur Übersetzung und Anpassung von Texten, die hier verwaltet werden können. Diese Textbausteine können in der Storefront oder in Dokumenten verwendet werden. Das Modul zur Verwaltung der Textbausteine findest du unter Einstellungen > Shop > Textbausteine.
Die Textbausteine sind in Textbaustein-Sets gruppiert. Standardmäßig gibt es zwei Basis-Sets: BASE de-DE (1) und BASE en-GB (2). Diese stellen die Standardübersetzungen für das Storefront bereit. Die Core-Basisdatei für Deutsch ist messages.de.base.json, storefront-spezifische Übersetzungen werden über storefront.de.json ergänzt (analog für Englisch mit en). Diese Basis-JSON-Dateien enthalten die Standardwerte, sodass Textbausteine bei Bedarf auf ihren ursprünglichen Zustand zurückgesetzt werden können.
Diese Dateien sollten nicht manuell angepasst werden, da diese benötigt werden, um Textbausteine wieder auf Ihren Standardwert zurückzusetzen.
Mit Mehrfachänderung (3) kannst du die ausgewählten Textbaustein-Sets bearbeiten und die Textbausteine an deine Anforderungen anpassen. Über Textbaustein-Set hinzufügen (4) erstellst du ein neues Textbaustein-Set auf Basis einer Basisdatei. Das Kontextmenü (5) neben einem Textbaustein-Set ermöglicht dir, diesen zu bearbeiten, zu duplizieren oder zu löschen. Durch einen Doppelklick auf eine Zeile wird die Inline-Bearbeitung aktiviert.
Einen Textbaustein bearbeiten
Um einen Textbaustein zu bearbeiten, klickst du zunächst auf das jeweilige Set, in dem der zu bearbeitende Textbaustein liegt. Wenn du Textbausteine in mehreren Sets bearbeiten möchtest, wähle die Sets über die Checkboxen aus und klicke auf Mehrfachänderung.
Du siehst nun eine Liste aller Textbausteine, die in der Textbaustein-Datenbanktabelle gespeichert sind. In der Spalte Name (1) findest du den jeweiligen Schlüssel des Textbausteins. Jeder Textbaustein enthält eine Übersetzung in jedem Textbaustein-Set (2). Über das Kontextmenü (3) gelangst du zur Detailseite des Textbausteins für diesen Schlüssel oder öffnest den Dialog zum Zurücksetzen. Auf der rechten Seite aktualisiert die Schaltfläche Aktualisieren (4) die Ansicht anhand der Textbaustein-Tabelle. Mit Filter (5) kannst du Filteroptionen für die angezeigten Textbausteine einblenden.
Im Zurücksetzen-Dialog kannst du über die Checkboxen auswählen, aus welchen Textbaustein-Sets (1) der ausgewählte Textbaustein zurückgesetzt werden soll, basierend auf der aktuell ausgewählten Liste. Du siehst dabei immer die aktuelle Übersetzung (2) sowie die ursprüngliche Übersetzung (3), zu der du zurückkehren kannst. Zusätzlich kannst du Für alle Textbaustein-Sets zurücksetzen (4) auswählen, um alle Übersetzungen für diesen Schlüssel zurückzusetzen – einschließlich der Sets, die aktuell nicht sichtbar sind.
Bearbeiten
Wenn du auf den Textbaustein-Schlüssel oder auf Bearbeiten im Kontextmenü klickst, öffnet sich die Detailseite. Dort siehst du den Textbaustein-Schlüssel sowie darunter dessen Übersetzungen in allen Textbaustein-Sets. Du kannst die Übersetzungen dieses Textbausteins setübergreifend bearbeiten.
Filter
Im Filtermenü kannst du verschiedene Filter anwenden, um die Textbausteine übersichtlicher darzustellen.
Nur leere Textbausteine anzeigen (1): Zeigt ausschließlich Textbausteine ohne Inhalt an.
- Nur angepasste Textbausteine anzeigen (2): Zeigt nur Textbausteine an, die in diesem Modul bearbeitet wurden.
- Nur hinzugefügte Textbausteine anzeigen (3): Zeigt nur Textbausteine an, die von einem Admin erstellt wurden; diese sind nicht Teil der Basisdatei.
- Autor (4): Filtert Textbausteine nach Autor. Standard-Textbausteine aus der Basisdatei stammen vom Autor Shopware.
- Weitere Filter (5): Filtert Textbausteine nach Bereich oder Funktion, zum Beispiel
checkout.
Einen neuen Textbaustein anlegen
Wenn du einen zusätzlichen Textbaustein benötigst, kannst du ihn direkt in der Textbaustein-Liste erstellen. Neue Textbausteine werden global angelegt, sodass du sie nicht in jedem Set einzeln erstellen musst. Anschließend kannst du den Inhalt des Textbausteins über alle Textbaustein-Sets hinweg pflegen.
Um einen neuen Textbaustein zu erstellen, wechsle zunächst in die Textbaustein-Liste. Dies kannst du tun, indem du direkt auf den Namen (1) des Sets klickst, ein oder mehrere Textbaustein-Sets (2) über die Checkboxen auswählst und auf Mehrfachänderung (3) klickst oder das Kontextmenü (4) öffnest.
Innerhalb des Textbaustein-Sets kannst du über Neuer Textbaustein (1) das Formular zur Erstellung eines neuen Textbausteins öffnen.
Vergib zunächst einen Namen (1), auch als Textbaustein-Schlüssel bekannt, für den neuen Textbaustein. Da dieser Name auch für Integrationszwecke verwendet wird – zum Beispiel in der Storefront – darfst keine du Leerzeichen oder Sonderzeichen verwenden.
Wähle außerdem einen Namen, der den Zweck des Textbausteins eindeutig beschreibt. Beispiel: checkout.headline ist ein guter Name für einen Textbaustein, der die Überschrift der Checkout-Seite enthält.
Anschließend kannst du den Inhalt des Textbausteins festlegen. Im Übersetzungsbereich werden separate Eingabefelder (2) für jedes verfügbare Textbaustein-Set angezeigt.
Der neue Textbaustein kann erst gespeichert (3) werden, sobald ein gültiger Name eingegeben wurde. In diesem Tutorial erfährst du, wie du den Textbaustein in der Storefront anzeigen kannst.
Ein neues Textbaustein-Set anlegen
Wenn du Textbausteine in einem Verkaufskanal verwenden möchtest, der von der Standardkonfiguration abweicht, kannst du dafür ein eigenes Textbaustein-Set erstellen. Dies ist besonders hilfreich, wenn du das Standard-Set unverändert lassen möchtest – zum Beispiel, wenn du unterschiedliche Textbaustein-Sets für formelle und informelle Ansprache verwendest.
Du hast zwei Möglichkeiten, ein neues Textbaustein-Set zu erstellen. Du kannst ein neues Set auf Basis einer der Basisdateien erstellen (Deutsch und Englisch sind standardmäßig enthalten), indem du auf Textbaustein-Set hinzufügen (1) klickst. Alternativ kannst du ein bestehendes Textbaustein-Set duplizieren. Öffne dazu das Kontextmenü (2) des entsprechenden Textbaustein-Sets.
Hinzufügen
Nachdem du auf den Button Textbaustein-Set hinzufügen geklickt hast, erscheint direkt in der Übersicht eine neue Zeile mit aktivierter Inline-Bearbeitung, in der du die relevanten Informationen eingeben kannst.
Vergib nun einen Namen (1) und eine Locale (2) für das Textbaustein-Set sowie wähle die Basisdatei (3) aus, die als Grundlage verwendet werden soll. Durch die Zuweisung einer Basisdatei werden deren Textbausteine als Fallbacks für das neue Set genutzt. Solange du keinen eigenen Inhalt für einen Textbaustein im neuen Set hinterlegst, werden die Werte aus der Basisdatei verwendet.
Die Locale muss entweder im Format en-GB oder de-DE angegeben werden oder als zweistelliger Sprachcode wie en oder de. Das Format folgt dem Standard für BCP-47-Sprachkennzeichen und ist auf ISO-639-1-Sprachcodes (Übersicht auf Deutsch / English) beschränkt.
Vergiss anschließend nicht, das neue Textbaustein-Set zu speichern (4).
Duplizieren
Beim Duplizieren eines Textbaustein-Sets kannst du aus allen bestehenden Sets auswählen. Die Kopie wird mit demselben Namen und dem Suffix Kopie erstellt. Den Namen kannst du anschließend in der Übersicht ändern. Doppelklicke dazu auf die Zeile des Textbaustein-Sets, dessen Namen du bearbeiten möchtest. Bitte beachte, dass ein Klick auf den Namen eines Textbaustein-Sets die Detailseite der darin enthaltenen Textbausteine öffnet. Dort kann der Name nicht geändert werden.
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 der Storefront angezeigt. Wenn du weitere Bereiche des Footers bearbeiten möchtest, 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 > Shop >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.