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

# Glossary- (Glossar)

> Das Glossar im Template ausgeben: das Beschreibungsfenster zu einem Begriff und der alphabetische Glossarindex mit Links auf die einzelnen Einträge.

Das Glossar erklärt Fachbegriffe, die in Produktbeschreibungen vorkommen. WEBSALE V8s sucht die hinterlegten Begriffe automatisch in den Produktbeschreibungen und verlinkt sie. Ein Klick öffnet ein Fenster mit der Erklärung.

Für das Template bedeutet das zwei Seiten, die Sie bauen. Das Beschreibungstemplate zeigt einen einzelnen Begriff samt Erklärung, aufgerufen über einen Glossarlink. Das Indextemplate zeigt das Alphabet und die Begriffe zum gewählten Buchstaben. Beide Seiten arbeiten mit denselben Tags, aber in unterschiedlicher Rolle.

Die Begriffe selbst werden nicht im Template gepflegt, sondern im Online-Servicebereich eingegeben und dort auch generiert.

Wegweiser: [Glossar einbinden](https://dokumentation.websale.de/v8s/interaktive-funktionen/glossar.md) · Referenz: WS-Config

## Das Beschreibungstemplate

Auf dieser Seite steht genau ein Begriff. Welcher, bestimmt der Glossarlink, den der Besucher angeklickt hat.

| Tag | Liefert |
| - | - |
| `Glossary-Data` | die Suche nach dem angeforderten Begriff und die Prüfung, ob er gefunden wurde |
| `Glossary-Name` | den Begriff |
| `Glossary-Descr` | die Erklärung |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{Glossary-Data}
   <h1>~Glossary-Name~</h1>
   <div class="erklaerung">~Glossary-Descr~</div>
{/Glossary-Data}

{!Glossary-Data}
   <p>Zu diesem Begriff liegt keine Erklärung vor.</p>
{/!Glossary-Data}
```

> [!WARNING]
>
> `{Glossary-Data}` prüft nicht nur, es holt die Daten. Erst mit dieser Klammerung liest das Shopsystem die angeforderte Begriffs-ID aus der Adresse und schlägt Begriff und Erklärung nach. `Glossary-Name` und `Glossary-Descr` außerhalb dieser Klammerung bleiben leer.

Die Klammerung greift nur, wenn sowohl der Begriff als auch die Erklärung gefunden wurden und beide nicht leer sind. Ein Eintrag mit leerer Erklärung gilt damit als nicht vorhanden. Der negative Bereich ist deshalb kein Luxus, sondern fängt einen realen Fall ab.

## Das Indextemplate

Auf dieser Seite steht das Alphabet und darunter die Begriffe zum gewählten Buchstaben.

| Tag | Liefert |
| - | - |
| `Glossary-Index` | die fertige Tabelle mit dem Alphabet |
| `Glossary-Data` | als Schleife die Begriffe zum gewählten Buchstaben |
| `Glossary-Name` | innerhalb der Schleife den Begriff des aktuellen Durchlaufs |
| `Glossary-DescrLink` | den Link auf das Beschreibungsfenster dieses Begriffs |
| `Glossary-ListLink` | denselben Link, zusätzlich mit dem gewählten Buchstaben |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{CAT-AdvData($Glossary,99)}
   ~Glossary-Index~

   <ul class="glossarliste">
      {@Glossary-Data}
         <li><a href="~Glossary-DescrLink~">~Glossary-Name~</a></li>
      {/@Glossary-Data}
   </ul>
{/CAT-AdvData($Glossary,99)}
```

`Glossary-Index` erzeugt die Alphabet-Tabelle vollständig selbst, einschließlich der Links auf die einzelnen Buchstaben. Welche Buchstaben und Buchstabenkombinationen dort stehen, wird im Online-Servicebereich festgelegt. Über die Styles `glossary_index_table`, `glossary_index`, `glossary_index_selected` und `glossary_index_invalid` gestalten Sie das Ergebnis.

`Glossary-Index` arbeitet auch als Klammerung und greift, wenn überhaupt Buchstaben hinterlegt sind. Damit blenden Sie die Umgebung der Tabelle aus, solange das Glossar noch leer ist.

### Welcher Link wofür

`Glossary-DescrLink` und `Glossary-ListLink` führen beide auf die Beschreibung des aktuellen Begriffs. Der Unterschied liegt darin, was sie mitnehmen.

| Tag | Nimmt mit |
| - | - |
| `Glossary-DescrLink` | nur die Begriffs-ID |
| `Glossary-ListLink` | die Begriffs-ID und den gerade gewählten Buchstaben |

`Glossary-ListLink` ist der passende Link, wenn der Besucher nach dem Lesen wieder zum selben Buchstaben zurückkehren soll. `Glossary-DescrLink` genügt für ein Fenster, das sich über der Seite öffnet und die Liste unberührt lässt.

`Glossary-DescrLink` taucht nur im Beispiel des Wegweisers auf, `Glossary-ListLink` an keiner Stelle.

## Was im Index erscheint

Nicht jeder Begriff steht im Index. Die Schleife liefert nur Begriffe, die drei Bedingungen erfüllen.

* Der Begriff ist für den Index freigegeben. Zu einer Erklärung lassen sich mehrere Schreibweisen hinterlegen, beispielsweise Einzahl und Mehrzahl, und Sie bestimmen, welche davon in den Index kommt.
* Der Begriff gehört zur Sprache des aufgerufenen Shops.
* Der Begriff beginnt mit einem der Zeichen, die dem gewählten Buchstaben zugeordnet sind.

Die Zuordnung mehrerer Zeichen zu einem Buchstaben ist der Grund, warum in einem deutschsprachigen Shop unter "A" auch die Begriffe mit "Ä" erscheinen. Für andere Sprachen lassen sich andere Regeln hinterlegen.

## Die automatische Verlinkung

In den Produktbeschreibungen setzt das Shopsystem die Glossarlinks selbst. Dabei gelten zwei Grenzen, die im Template nicht sichtbar sind, aber erklären, warum ein Begriff manchmal unverlinkt bleibt.

> [!WARNING]
>
> Je Produktbeschreibung wird jeder Begriff nur einmal verlinkt, und zwar beim ersten Vorkommen. Weitere Nennungen desselben Begriffs bleiben Text. Insgesamt setzt das Shopsystem höchstens 100 Glossarlinks pro Beschreibung. Bei langen Beschreibungen mit vielen Fachbegriffen bleibt der Rest unverlinkt.

Die Suche in den Produktbeschreibungen beachtet die Groß- und Kleinschreibung. Ein Begriff, der im Fließtext sowohl groß als auch klein vorkommt, muss in beiden Schreibweisen hinterlegt sein. Dasselbe gilt für Einzahl und Mehrzahl.

## Die Tags im Überblick

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `Glossary-Data` | – | ja | ja | ja |
| `Glossary-Name` | ja | ja | ja | – |
| `Glossary-Descr` | ja | ja | ja | – |
| `Glossary-Index` | ja | ja | ja | – |
| `Glossary-DescrLink` | ja | – | – | – |
| `Glossary-ListLink` | ja | – | – | – |

`Glossary-Descr` gilt nur im Beschreibungstemplate. `Glossary-Index`, `Glossary-DescrLink` und `Glossary-ListLink` gelten nur im Indextemplate, die beiden Linktags nur innerhalb der `@Glossary-Data`-Schleife. `Glossary-Name` gilt auf beiden Templates.

> [!WARNING]
>
> Ein Tag `PhraseID` gibt es nicht. In der Tag-Tabelle des Shopsystems kommt kein Eintrag dieses Namens vor, weder für das Glossar noch für ein anderes Präfix. Die Begriffs-ID wird ausschließlich über `Glossary-DescrLink` und `Glossary-ListLink` in die Links eingesetzt und steht im Template nicht einzeln zur Verfügung.

## Verwandte Themen

* Wegweiser: Glossar einbinden
* Referenz: [WS-Config](https://dokumentation.websale.de/v8s/referenz/tags/ws/shop-seite-und-technik.md#die-tags-im-uberblick)
* Referenz: [WS-Link()](https://dokumentation.websale.de/v8s/referenz/tags/ws/shop-seite-und-technik.md#die-tags-im-uberblick)


## Related topics

- [Glossar](https://dokumentation.websale.de/v8s/interaktive-funktionen/glossar.md)
- [Styles für Module und Schnittstellen](https://dokumentation.websale.de/v8s/referenz/styles/module-und-schnittstellen.md)
- [Grundlagen und Technik](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/grundlagen-und-technik.md)
- [Shop, Seite und Technik](https://dokumentation.websale.de/v8s/referenz/tags/ws/shop-seite-und-technik.md)
- [Glossar: Fachbegriffe der WEBSALE-Dokumentation](https://dokumentation.websale.de/glossar.md)


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