> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# FMSG- (Freie Vorgabetexte)

> Eigene Texte zentral in der Shopkonfiguration hinterlegen und mit einem FMSG-Tag in beliebige Templates einsetzen, als Ausgabe oder als Schalter.

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](https://dokumentation.websale.de/v8s/einstellungen/standardtexte.md) · Referenz: [Abschnitt FreeMessages-Txt](https://dokumentation.websale.de/v8s/websale-produktbewertung/produktbewertungs-modul-konfigurieren.md#was-in-der-prodrating-config-steht)

## 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:

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<FreeMessages-Txt>

   Copyright = © 2026 Muster GmbH
   Lieferhinweis = Versand innerhalb von 24 Stunden

</FreeMessages-Txt>
```

Im Template:

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<footer>
   <p>~FMSG-Copyright~</p>
</footer>
```

Ausgabe:

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<footer>
   <p>© 2026 Muster GmbH</p>
</footer>
```

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.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{FMSG-Aktionsbanner}
   <div class="aktion">~FMSG-Aktionsbanner~</div>
{/FMSG-Aktionsbanner}

{!FMSG-Aktionsbanner}
   <div class="standard">Unser Sortiment</div>
{/!FMSG-Aktionsbanner}
```

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.

> [!WARNING]
>
> 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.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<FreeMessages-Txt>

   Grussformel = Guten Tag ~ADR-FirstName~ ~ADR-Name~,

</FreeMessages-Txt>
```

So lassen sich Textbausteine bauen, die sich selbst an den Kontext anpassen, statt für jede Variante einen eigenen Eintrag zu pflegen.

> [!WARNING]
>
> 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

> [!WARNING]
>
> 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

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `FMSG-<Name>` | ja | ja | ja | – |

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

## Verwandte Themen

* Wegweiser: [Standardtexte](https://dokumentation.websale.de/v8s/einstellungen/standardtexte.md)
* Referenz: [Abschnitt FreeMessages-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md#freemessages-txt)
* Referenz: [Abschnitt NotifyMessages-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md#notifymessages-txt)
* Referenz: [MSG- (Meldungen)](https://dokumentation.websale.de/v8s/referenz/tags/msg-meldungen.md)


## Related topics

- [Texte und Meldungen](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md)
- [Standardtexte](https://dokumentation.websale.de/v8s/einstellungen/standardtexte.md)
- [Daten mit externen Systemen austauschen](https://dokumentation.websale.de/v8s/externe-dienste/daten-mit-externen-systemen-austauschen.md)
- [Materialien WEBSALE Partnerprogramm](https://dokumentation.websale.de/v8s/materialien/materialien-partnerprogramm.md)
- [Materialien SEPA-Integration](https://dokumentation.websale.de/v8s/materialien/materialien-sepa-integration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.