Textbausteine: Konfiguration

Textbausteine im Shopware Admin anlegen und pflegen - Felder, Identifier-Regeln, Mehrsprachigkeit, Platzhalter-Syntax und Praxis-Beispiele für Produktbeschreibungen

English Version

Zurück zur Übersicht

Textbausteine: Konfiguration

Live Demo: Teste dieses und weitere Plugins live — ohne Installation, ohne Risiko: demo.markus-michalski.net

Das Plugin hat keine Einstellungen unter Erweiterungen > Meine Erweiterungen. Alles wird über das Admin-Modul Inhalte > Textbausteine gepflegt.

Die Liste

Die Liste zeigt die Spalten Identifier, Name und Aktiv und ist standardmäßig nach Identifier sortiert. Du kannst Textbausteine durchsuchen, bearbeiten und löschen. Mit Textbaustein erstellen legst du einen neuen an.

Textbaustein anlegen

Klicke auf Textbaustein erstellen
Gib einen Identifier ein (zum Beispiel garantie-info)
Trage optional einen Anzeigenamen ein
Schreibe den Inhalt im Texteditor
Lass Aktiv eingeschaltet
Klicke auf Speichern

Nach dem Speichern kehrst du zur Liste zurück.

Felder

Feld	Pflicht	Beschreibung
Identifier	ja	Technischer Name, der im Platzhalter verwendet wird. Der Speichern-Button bleibt deaktiviert, solange das Feld leer ist. Nach dem Anlegen sperrt die Admin-Oberfläche das Feld, du kannst den Identifier dort also nicht mehr ändern.
Anzeigename	nein	Nur zur Orientierung in der Liste und in der Admin-Suche. Er erscheint nicht im Shop.
Aktiv	nein	Nur aktive Textbausteine werden ersetzt. Beim Anlegen ist der Schalter vorbelegt.
Inhalt	nein	Der eigentliche Text, den der Platzhalter ersetzt. Wird im Texteditor als HTML bearbeitet.

Anzeigename und Inhalt sind sprachabhängig, Identifier und Aktiv gelten für alle Sprachen.

Regeln für den Identifier

Das Admin-Feld prüft den Identifier nicht. Beim Ersetzen erkennt das Plugin aber nur Platzhalter, deren Identifier aus Buchstaben (a-z, A-Z), Ziffern, Bindestrich und Unterstrich besteht. Ein Identifier mit Punkt, Leerzeichen oder Umlaut lässt sich zwar speichern, wird aber von keinem Platzhalter gefunden.

Verwende ausschließlich Buchstaben, Ziffern, Bindestriche und Unterstriche, zum Beispiel garantie-info oder versand_info.
Groß- und Kleinschreibung spielt beim Abgleich keine Rolle: Die Datenbankspalte ist case-insensitiv, Garantie-Info und garantie-info meinen denselben Baustein und können nicht nebeneinander existieren.
Der Identifier ist über alle Sprachen und Verkaufskanäle hinweg eindeutig.

Mehrsprachige Inhalte

Anzeigename und Inhalt pflegst du pro Sprache:

Lege den Textbaustein an und speichere ihn. Beim Anlegen ist der Sprachumschalter deaktiviert.
Öffne den Textbaustein erneut und wähle im Sprachumschalter die gewünschte Sprache.
Trage den übersetzten Inhalt ein und speichere.

In der Storefront wird der Inhalt in der Sprache des aktuellen Kontexts ausgegeben. Hinterlege den Inhalt deshalb für jede Sprache, in der der Baustein erscheinen soll.

Platzhalter verwenden

Füge einen Platzhalter in die Beschreibung eines Produkts ein:

Syntax	Beschreibung
`{{snippet:identifier}}`	Standard-Syntax
`{{textbaustein:identifier}}`	Deutsche Alternative
`{{ snippet:identifier }}`	Leerzeichen innerhalb der Klammern sind erlaubt

Der Präfix snippet bzw. textbaustein wird ohne Beachtung der Groß-/Kleinschreibung erkannt. Wo die Ersetzung stattfindet, steht auf der Seite Storefront-Integration.

Praxis-Beispiele

Garantie-Hinweis

Identifier: garantie-info
Anzeigename: Garantie-Information
Inhalt:

<p><strong>2 Jahre Garantie</strong></p>
<p>Dieses Produkt enthält eine 2-jährige Herstellergarantie für Material- und Verarbeitungsfehler.</p>

Beschreibung des Produkts:

<h2>Premium Widget</h2>
<p>Hochwertiges Widget für professionellen Einsatz.</p>

{{snippet:garantie-info}}

{{snippet:versand-info}}

In der Produktbeschreibung des Produktlayouts werden beide Platzhalter durch die gespeicherten Inhalte ersetzt. Ist versand-info nicht angelegt oder inaktiv, bleibt {{snippet:versand-info}} unverändert im Text stehen.

Typische Einsatzgebiete

Digitale Produkte:     {{snippet:format-hinweis}}  {{snippet:download-info}}  {{snippet:lizenzbedingungen}}
Physische Produkte:    {{snippet:versand-info}}  {{snippet:rueckgabe-info}}  {{snippet:garantie-info}}
Saisonale Aktionen:    {{snippet:weihnachts-versand}}  {{snippet:sale-hinweis}}

Hinweise zu HTML im Inhalt

Der Inhalt wird beim Ausgeben von Shopwares HTML-Sanitizer bereinigt. Unsichere Bestandteile wie Skripte werden entfernt, normale Formatierung wie Absätze, Fett, Listen oder Links bleibt erhalten. Auf Produktkarten in Listen wird sogar jedes HTML entfernt, siehe Storefront-Integration.