Textbausteine

Um die Übersetzung und die Anpassung von Texten in Templates zu vereinfachen, benutzt Shopware Textbausteine, die im Template durch Smarty-Variablen abgerufen werden. Somit müssen für Änderungen des Textes keine Anpassungen am Template vorgenommen werden.

Modifizieren von Textbausteinen

Normaler Modus

Das Modul zur Pflege der Textbausteine des Shops befindet sich unter Einstellungen > Textbausteine. Nach Aufruf des Fensters erscheint die gesamte Übersicht aller vorhandenen Textbausteine aller Shops. Um den gewünschten Textbaustein zu lokalisieren, bestehen neben der Filterung der Textbausteine in der linken Navigation des Fensters, auch die Möglichkeit nach Haupt- oder Subshop, leeren Textbausteinen sowie direkt nach dem Inhalt des Bausteins in der Suche zu suchen.

Wenn der passende Textbaustein gefunden ist, kann man diesen über den Editier-Stift bearbeiten. Der entsprechende Textbaustein wird nun hervorgehoben. Du kannst diesen nun in dem Feld Wert anpassen. Nachdem Du den Textbaustein geändert hast, steht Dir nun der Update-Button zum Speichern zur Verfügung.

Damit die Änderungen an den Textbausteinen sichtbar sind, leerst Du nachfolgend den "Konfiguration + Template-Cache".

Experten-Modus

Mit dem Experten-Modus hast Du die Möglichkeit, einzelne Textbausteine zu löschen. Ebenfalls ist es möglich den Namespace zu ändern (der Wert in der Smarty Variable). Dies sollte jedoch wohl bedacht sein, da hierdurch Texte im Frontend des Shops nicht mehr angezeigt werden können.

Hinweis: Ändere niemals Namen oder Namespaces bei den Standard-Textbausteinen. Hierdurch wird die Verknüpfung zum Template verloren gehen und das Template u.U. Fehler ausgeben. Ein anderer möglicher Fehler wären u.a. auch Crawling-Fehler der Bots.

Anlegen neuer Textbausteine


Um einen neuen Textbaustein anzulegen, klicke auf den Button Textbaustein hinzufügen (1).  Es erscheint ein neues Fenster, in dem Du die Daten für den Textbaustein eingeben kannst.


Folgende Daten sind für die Anlage des Textbausteins erforderlich.

  • Locale: Wähle hier aus, für welche Sprache der Textbaustein initial gepflegt werden soll. Weitere ggf. vorhandene Sprachen können nach der Anlage des Textbausteins ergänzt werden.
  • Shop: Wähle hier aus, für welchen Shop der Textbaustein initial gepflegt werden soll. Weitere ggf. vorhandene Shops können nach der Anlage des Textbausteins ergänzt werden.
  • Namespace: Der Namespace ist der Bereich, in dem der Textbaustein einsortiert werden soll. Es ist sinnvoll, den Textbaustein im passenden Modul abzulegen, da er so einfacher gefunden/identifiziert werden kann.
  • Name: Wird z.B. als Variable verwendet, um den Textbaustein im Template einzubauen
  • Wert: Inhalt des Textbausteins. Wird an dieser Stelle zunächst für die unter Locale und Shop ausgewählte Sprache und Shop gepflegt. Nachdem der Textbaustein erstellt wurde, können die Inhalte für weitere Sprachen und Shops im Textbaustein ergänzt werden.

Import / Export von Textbausteinen

Importieren & Aktualisieren von Textbausteinen

Du hast die Möglichkeiten neue Textbausteine zu importieren oder bereits bestehende Textbausteine mit einem Import zu verändern. Dies kannst Du ganz leicht mit einer CSV-Datei durchführen. Folgende Felder werden benötigt:

FeldbezeichnungErklärung
namespaceName des Controllers
nameName der Variable
value-de_DE-1Deutscher Text/Inhalt
value-en_GB-1Englischer Text/Inhalt

Nicht vorhandene Textbausteinen werden angelegt, bereits vorhandene erhalten ein Update.

Bitte lege vor jeder Anpassung der Textbausteine ein Backup der Datenbank an! Im Standard solltest Du in jedem Fall die Datenbank Tabelle s_core_snippets sichern. Drittanbieter Plugins können unter Umständen weitere Tabellen nutzen. 

Exportieren von Textbausteinen

Natürlich kannst Du auch deine vorhandenen Textbausteine in verschiedene Formate exportieren. Hier stehen Dir CSV (MS), CSV (Trennzeichen) und SQL (Backup) zur Verfügung. Letzteres kann für das Zurücksetzen der Textbausteine via SQL-Statement genutzt werden.

Rückspielung der SQL-Datei

Falls die Textbausteine nicht mehr korrekt angezeigt werden, ist die Möglichkeit gegeben, den Stand wie vor dem Import der Textbausteine zurück zuspielen. Hierzu öffnet man sich die vor dem Import exportierte SQL-Datei und kopiert die SQL-Befehle aus dem Dokument. Im Anschluss muss die Datenbank geöffnet werden und der Dump über das SQL-Feld eingespielt werden. Nach der Änderung sollte der alte Stand der Textbausteine gegeben sein.

War dieser Artikel hilfreich?