Zum Hauptinhalt springen
Mit den freien Vorgabetexten hinterlegen Sie eigene Texte an einer einzigen Stelle und setzen sie in beliebig vielen Templates ein. Das lohnt sich immer dann, wenn derselbe Text an mehreren Stellen steht und zentral änderbar bleiben soll, beispielsweise eine Copyright-Zeile, ein Hinweis zur Lieferzeit oder ein Banner für eine Aktion. In mehrsprachigen Shops ist es der Weg, um Texte überhaupt aus den Templates herauszuhalten. Anders als die übrigen Textabschnitte der Shopkonfiguration sind die freien Vorgabetexte nicht an eine Funktion des Shopsystems gebunden. Namen und Inhalte bestimmen Sie selbst. Wegweiser: Standardtexte · Referenz: Abschnitt FreeMessages-Txt

Einen Text anlegen und ausgeben

Ein freier Vorgabetext besteht immer aus zwei Teilen: einem Eintrag im Abschnitt <FreeMessages-Txt> der Shopkonfiguration shop.config und einem Tag im Template, das aus dem Präfix FMSG- und dem Parameternamen besteht. In der Shopkonfiguration:
Im Template:
Ausgabe:
Das Präfix FMSG- vergibt das Shopsystem selbst. In der Shopkonfiguration steht nur der Name, im Template steht das Präfix davor. Groß- und Kleinschreibung des Namens spielt keine Rolle. Ein als Lieferhinweis angelegter Text ist auch über ~FMSG-lieferhinweis~ erreichbar. Einheitlich zu schreiben hilft trotzdem, weil sich die Templates dann durchsuchen lassen.

Einen Text als Schalter verwenden

FMSG- ist nicht auf die Ausgabe beschränkt. Dasselbe Tag arbeitet auch als Bereichs-Tag und als negatives Bereichs-Tag. Maßgeblich ist dabei, ob zu dem Namen ein nicht leerer Text hinterlegt ist.
Damit schalten Sie Bereiche des Templates über die Shopkonfiguration, ohne das Template anzufassen. Solange Aktionsbanner einen Text enthält, erscheint das Banner. Wird der Text geleert, verschwindet der ganze Block samt Umgebung, und der Alternativblock greift.
Löschen Sie für diesen Zweck nur den Text, nicht die Zeile. Ein Name ohne Wert ist dem Shopsystem bekannt und schaltet die Klammerung sauber ab. Ein Name, der gar nicht in der Shopkonfiguration steht, ist für den Parser dagegen kein gültiges Tag, und das Verhalten ist ein anderes. Ein Tippfehler im Namen ist deshalb nicht dasselbe wie ein leerer Text.
Als Schleifen-Tag lässt sich FMSG- nicht verwenden. Ein freier Vorgabetext ist genau ein Wert, es gibt nichts zu durchlaufen.

Texte dürfen Tags enthalten

Der hinterlegte Text wird vom Parser ein zweites Mal als Template verarbeitet. Das bedeutet: HTML im Text bleibt HTML, und WEBSALE-Tags im Text werden aufgelöst.
So lassen sich Textbausteine bauen, die sich selbst an den Kontext anpassen, statt für jede Variante einen eigenen Eintrag zu pflegen.
Aus demselben Grund können Sie eine Tilde oder eine geschweifte Klammer nicht ohne Weiteres als Zeichen in einem freien Vorgabetext unterbringen. Der Parser versucht, die betreffende Stelle als Tag zu lesen. In HTML-Ausgaben schreiben Sie solche Zeichen deshalb als Entität, &#126; für die Tilde und &#123; für die geschweifte Klammer.

Grenzen

Der Abschnitt <FreeMessages-Txt> fasst 100 Einträge. Alles ab dem 101. Eintrag liest das Shopsystem nicht mehr ein, ohne dass es dafür eine Meldung gibt. Die Tags dieser Einträge bleiben im Template unaufgelöst. Wenn Sie an die Grenze stoßen, prüfen Sie zuerst, ob sich verwandte Texte über nachgeladene Tags zusammenfassen lassen.
Die Reihenfolge der Einträge im Abschnitt ist ansonsten ohne Bedeutung. Sie können die Texte also nach Themen gruppieren, damit der Abschnitt lesbar bleibt.

Das Tag im Überblick

<Name> ist der Parametername aus dem Abschnitt <FreeMessages-Txt> der Shopkonfiguration shop.config. Das Tag ist in allen Templates zulässig.

Verwandte Themen