# Lexikon / Glossar Professionell

## Installation <a href="#installation" id="installation"></a>

Sie können das Plugin über den Shopware Community Store erwerben. Das Plugin wird wie ein ganz gewöhnliches Plugin installiert.

{% embed url="<http://store.shopware.com/cbax328895896218/lexikon-/-glossar-professionell-shopware-5.html>" %}

Nach der Installation des Plugins öffnet sich die Konfigurationsmaske des Plugins.

## Die Einstellungen des Plugins <a href="#plugin_einstellungen" id="plugin_einstellungen"></a>

Nach der erfolgreichen Installation des Plugins können Sie in der Konfigurationsmaske die Einstellungen vornehmen und weitere Parameter ergänzen

<div><figure><img src="/files/RUiPcnNxfTx3GvO4D7DI" alt=""><figcaption></figcaption></figure> <figure><img src="/files/rBtgEQtdgeAY70ukW8Y0" alt=""><figcaption></figcaption></figure></div>

| Allgemeine Einstellungen            |                                                                                                                                                                 |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Aktiv                               | Das Plugin für den jeweiligen Shop aktivieren oder deaktivieren.                                                                                                |
| Pfad zum Lexikon                    | SEO Pfad zum Lexikon. Z.B.: lexikon - ohne Domain - <http://www.mein-shop.de/lexikon> - Nach Änderung die SEO URLs im Plugin neu erzeugen und den Cache löschen |
| Lexikon in Shopseiten               | Begriffe in Shopseiten ersetzen                                                                                                                                 |
| Lexikon in Herstellerbeschreibungen | Begriffe in Herstellerbeschreibungen ersetzen                                                                                                                   |
| Lexikon in Kategoriebeschreibungen  | Begriffe in Kategorie Beschreibungen ersetzen                                                                                                                   |
| Lexikon in Artikelbeschreibungen    | Begriffe in Artikelbeschreibungen ersetzen                                                                                                                      |
| Lexikon in Eigenschaften            | Begriffe in Eigenschaften ersetzen. Bitte die Felder auswählen. Mehrfachauswahl möglich                                                                         |
| Lexikon in Artikel Freitextfelder   | Begriffe in Artikel Freitextfelder ersetzen. Bitte die Felder auswählen. Mehrfachauswahl möglich                                                                |
| Lexikon in Blogbeschreibungen       | Begriffe in Blogbeschreibungen ersetzen                                                                                                                         |
| Lexikon in Einkaufswelten           | Begriffe in Einkaufswelten ersetzen                                                                                                                             |
| Lexikon in Lexikonbeschreibungen    | Begriffe in Lexikonbeschreibungen ersetzen                                                                                                                      |
| Text überall mehrmals ersetzen      | Begriffe in Beschreibungen bei mehrmaligen Vorkommen mehrmals oder nur einmal ersetzen                                                                          |
| Nur ganze Wörter ersetzen           | Nur komplette oder auch Teile von Wörtern ersetzen                                                                                                              |
| Linke Navigation anzeigen           | Zum Navigieren auf der Detailseite des Keywords                                                                                                                 |
| Paginierung anzeigen                | Zum Navigieren auf der Detailseite des Keywords                                                                                                                 |
| Slash am Ende der URL               | Es wird ein Slash am Ende jeder SEO URL mit angehängt (Trailing Slash)                                                                                          |

| Lexikon Startseite               |                                                                                                                           |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Banner                           | Pfad zum Bild eintragen                                                                                                   |
| Banner Position                  | Das Banner kann über dem gesamten Content oder wie ein normales Banner angezeigt werden                                   |
| Der Text auf der Startseite      | Der Text auf der Startseite des Lexikon.                                                                                  |
| Template                         | In welchem Template sollen die Einträge auf der Startseite angezeigt werden? Liste, Zweispaltig, Dreispaltig, Vierspaltig |
| Neuste Einträge anzeigen         | Neuste Einträge auf der Startseite anzeigen.                                                                              |
| Headline                         | Die Headline der neuste Einträge.                                                                                         |
| Anzahl                           | Die Anzahl der neuste Einträge die angezeigt werden.                                                                      |
| Meist gelesene Einträge anzeigen | Meist gelesene Einträge auf der Startseite anzeigen.                                                                      |
| Headline                         | Die Headline der meist gelesene Einträge.                                                                                 |
| Anzahl                           | Die Anzahl der meist gelesene Einträge die angezeigt werden.                                                              |

| Lexikon Kategorieseite |                                                                                                                                |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Template               | In welchem Template sollen die Einträge auf der Kategorie Seite angezeigt werden? Liste, Zweispaltig, Dreispaltig, Vierspaltig |

| Modales Fenster                  |                                                                  |
| -------------------------------- | ---------------------------------------------------------------- |
| Die Headline des modalen Fenster | Die Headline des modalen Fenster.                                |
| Footer anzeigen                  | Zeigt den Footer im modalen Fenster mit dem Link zum Lexikon an. |

| Caching            |                                                                                       |
| ------------------ | ------------------------------------------------------------------------------------- |
| Caching aktivieren | Bei Aktivierung werden die Beschreibungen gecached. Empfohlen für höchste Performance |
| Cachezeit          | Die Zeit bis der Cache neu aufgebaut wird.                                            |

| Migration                       |                                                                                                                                              |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| API-Schlüssel für die Migration | Der API-Schlüssel wird benötigt, um den Zugriff auf Ihre Daten zu schützen. Tragen Sie diesen in Shopware 6 in die Plugin Konfiguration ein. |

## Lexikon Übersicht <a href="#backend" id="backend"></a>

Um das Lexikon im Backend auf zurufen, klicken Sie oben im Menü auf "Inhalte -> Lexikon." In der drauf erscheinenden Übersicht sehen Sie alle bisher angelegten Einträge. Sie können neue Einträge anlegen, vorhandene bearbeiten, duplizieren oder löschen.

<div><figure><img src="/files/VKCpM5B5tHmbMjnDprmB" alt=""><figcaption></figcaption></figure> <figure><img src="/files/f2atx10uZaYgEDuuAfxg" alt=""><figcaption></figcaption></figure></div>

Sie haben in der Lexikon Übersicht die Möglichkeit den Titel und die Keywords zu ändern. Klicken sie Hierfür einfach doppelt auf deinen Eintrag. Auf der rechten Seite können Sie sich Details zum Eintrag ansehen. Klicken Sie dafür auf "Details" in der rechten oberen Ecke.

### SEO URLs erzeugen <a href="#seo_urls" id="seo_urls"></a>

Mit jedem neuen Eintrag oder jeder Änderung im Titel sollte der Button "SEO URLs erzeugen" betätigt werden, um die lesbaren URLs zeitnahe zu generieren. Ändern Sie den Titel eines vorhandenen Eintrags und erzeugen danach die SEO URLs neu, wird die alte URL aus der Datenbank gelöscht und ist nicht mehr aufrufbar.

Mit der Installation des Plugins wird ein Cronjob eingerichtet, welcher automatisch nach einer bestimmten Zeitvorgabe die SEO URL´s erzeugt. Sie finden diesen unter: Einstellungen > Grundeinstellungen > System > Cronjob > Lexikon SEO URLs erzeigen

{% hint style="warning" %}
Bitte beachten Sie, dass mit jedem Klick auf den Button "SEO URLs erzeugen" IMMER ALLE URLs neu generiert werden!
{% endhint %}

## Einen neuen Eintrag anlegen <a href="#eintrag_anlegen" id="eintrag_anlegen"></a>

Um einen neuen Eintrag anzulegen, klicken Sie in der Übersicht auf den Button "Hinzufügen".

<div><figure><img src="/files/PNf5TyDIy2m2ibTdrHcC" alt=""><figcaption></figcaption></figure> <figure><img src="/files/RT9lg3yRoXlr4ePb786p" alt=""><figcaption></figcaption></figure></div>

### Stammdaten <a href="#eintrag_anlegen_stammdaten" id="eintrag_anlegen_stammdaten"></a>

* **Titel** - Der Titel des Eintrages. Nach dem Titel werden die Einträge auch gruppiert
* **Keyword** - Der Name des Keyword, welches in den Beschreibungen verlinkt wird. Mehrere Keywords werden mit einem Pluszeichen getrennt.
* **Einstelldatum** - An Hand des Einstelldatum werden die "Neusten Einträge" auf der Startseite des Lexikon ermittelt. Es kann auch weggelassen werden, dann wird das aktuelle Datum gespeichert.
* **Kurzbeschreibung** - Die Kurzbeschreibung wird bei den Verlinkungen im modalen Fenster in den z.B. Artikelbeschreibungen verwendet. Gleichzeitig wird die Kurzbeschreibung im Lexikon verwendet, wenn keine Langbeschreibung hinterlegt wurde.
* **Langbeschreibung** - Die Langbeschreibung wird nur im Lexikon verwendet.

### Zusätzliche Freitextfelder + Einbindung <a href="#eintrag_anlegen_freitextfelder" id="eintrag_anlegen_freitextfelder"></a>

Um die Einträge im Lexikon noch weiter zu individualisieren, stehen Ihnen 6 Freitextfelder zur Verfügung, die Sie an einer beliebigen Stelle im Template ausgeben können. Geben Sie einfach an der gewünschten Stelle im Template "detail.tpl" die Smarty Variable aus:

```
{$CbaxLexicon.entry.attribute1}
```

* HTML Editor
* Bildauswahl
* Bildauswahl
* Eingabefeld
* Eingabefeld
* Eingabefeld

### Shops <a href="#eintrag_anlegen_shops" id="eintrag_anlegen_shops"></a>

Hier können Sie den Lexikoneintrag mit Ihren Shops verknüpfen. Der Lexikoneintrag wird nur in verknüpften Shops angezeigt. Wählen Sie im Dropdown Menü den Shops aus, wo der Eintrag angezeigt und das Wort übersetzt werden soll. Eine Mehrfachauswahl ist möglich.

<figure><img src="/files/sL2pc3Hp1gU2nERPKrer" alt="" width="375"><figcaption></figcaption></figure>

### Zugeordnete Artikel <a href="#eintrag_anlegen_artikel" id="eintrag_anlegen_artikel"></a>

Hier können Sie den Lexikoneintrag mit Artikeln verknüpfen. Die verknüpften Artikel werden automatisch auf der Detailseite des Lexikoneintrag angezeigt.

<div><figure><img src="/files/ldr7bzL7gmbdOtAI2Gwp" alt=""><figcaption></figcaption></figure> <figure><img src="/files/NaiV9VZZynu9lkQ7w1na" alt=""><figcaption></figcaption></figure></div>

* **Listentyp** - Wählen Sie zwischen "Ausgewählte Artikel" oder "Product-Stream"
* **Product-Stream** - Wählen Sie ein Product-Stream aus dem Dropdown Menü aus
* **Überschrift** - Überschrift über den Artikel
* **Template** - Das Template in welchem die Artikel Gruppe angezeigt wird. Es stehen folgende Templates zur Verfügung:
  * Detaillierte Informationen
  * Nur wichtige Informationen
  * Großes Bild
  * Produktliste
  * Slider

Wählen Sie als Listentyp "Ausgewählte Artikel" aus, erscheint die Artikelverwaltung. Hier können Sie die entsprechenden Artikel mittels Artikelname oder Artikelnummer heraussuchen und hinzufügen.

### Suchmaschinen Optimierung <a href="#eintrag_anlegen_seo" id="eintrag_anlegen_seo"></a>

Hier können Sie eine On-Page Optimierung Ihres Lexikon-Eintrags durchführen, was Ihnen hilft die Relevanz des Eintrags für Suchmaschinen zu steigern. Alle hier getätigten Angaben werden im HTML-Quellcode ausgegeben.

<figure><img src="/files/v3PxMzeolIsDCrXTwJTu" alt="" width="375"><figcaption></figcaption></figure>

* **Titel** - Der Meta-Title für die Suchmaschinen.
* **Keywords** - Die Meta-Keywords für die Suchmaschinen.
* **Description** - Die Meta-Description für die Suchmaschinen.

Haben Sie die Felder: Title, Keywords und Description ausgefüllt, können Sie unter Vorschau auf den Button "Vorschau erstellen" klicken. Sie sehen nun, wie die Suchmaschinen die Seite darstellt. Die angezeigte Vorschau muss nicht mit der Abbildung in der Suchmaschine übereinstimmen.

### Modal Box <a href="#eintrag_anlegen_modalbox" id="eintrag_anlegen_modalbox"></a>

Hier können Sie auf eine individuelle Seite z.B. eine Einkaufswelt oder Landingpage verweisen. Wenn die Felder leer bleiben, dann wird auf die Langbeschreibung im Lexikon verwiesen.

<div><figure><img src="/files/HaQ4uGk09H3HB19ABBqf" alt=""><figcaption></figcaption></figure> <figure><img src="/files/5L6RQMSEUFSuhXDHu39A" alt=""><figcaption></figcaption></figure></div>

* **Link Bezeichnung** - Name des Links.
* **Link** - Link der beim Anklicken aufgerufen wird. z.B. zu einer Einkaufswelt oder Landingpage. Ist dieser nicht hinterlegt wird automatisch zum Lexikon für die ausführliche Beschreibung verlinkt.
* **Link Target** - Soll der Link auf den Shop oder eine externe Seite verweisen.

### Übersetzung hinterlege <a href="#uebersetzung" id="uebersetzung"></a>

Einige Felder können auch für einen Subshop übersetzt werden. Klicken Sie hierfür auf die Erdkugel, welche sich auf der rechten Seite der Felder befindet. In dem sich öffnenden Fenster sehen Sie alle Felder, welche in eine andere Sprache übersetzt werden können. Die grau hinterlegten Wörter zeigen an, welche Werte im Hauptshop hinterlegt sind und bei nicht Änderung genommen werden.

<div><figure><img src="/files/ESuYGrXi6gSfq3ALQT3F" alt=""><figcaption></figcaption></figure> <figure><img src="/files/4ovXGOdOicpCzEgz4m2J" alt=""><figcaption></figcaption></figure></div>

Als kleine Hilfe kann der Google Übersetzer genommen werden. Klicken Sie hierfür links oben auf den Button "Google Übersetzer".

## Einbindung im Shop <a href="#einbindung_shop" id="einbindung_shop"></a>

Sie können nun das Lexikon im Frontend aufrufen. Geben Sie hierzu hinter der Shop URL den Wert ein, welchen Sie im Plugin unter "Pfad zum Lexikon" eingetragen haben (z.B. <http://www.mein-shop.de/lexikon>).

{% hint style="warning" %}
Sollte sich der Link nicht aufrufen lassen, gehen Sie im Backend auf "Inhalte > Lexikon > SEO URLs erzeugen (Button)"
{% endhint %}

### Shopseiten <a href="#einbindung_shopseiten" id="einbindung_shopseiten"></a>

Um eine Shopseite auf das Lexikon zu verlinken gehen Sie auf "Inhalte > Shopseiten". Erzeugen dort eine neue Shopseite und geben als Titel z.B. Lexikon an. Weisen Sie eine oder mehrere Gruppen zu und scrollen Sie weiter zu "Links". Tragen Sie im Feld "Link-Adresse" den Wert ein, welchen Sie im Plugin im Feld "Pfad zum Lexikon" eingetragen haben.

<figure><img src="/files/gkdtL44iQcuRWkIOgpaJ" alt="" width="563"><figcaption></figcaption></figure>

### Kategorien <a href="#einbindung_kategorien" id="einbindung_kategorien"></a>

Um eine Kategorie auf das Lexikon zu verlinken gehen Sie auf "Artikel > Kategorien". Erzeugen dort eine neue Kategorie z.B. Lexikon. In den "Allgemeinen Einstellungen" finden Sie ein Feld "Auf externe Seite verlinken". Dort Tragen Sie den Wert ein, welchen Sie im Plugin im Feld "Pfad zum Lexikon" eingetragen haben.

<figure><img src="/files/KT6gcizZWIz0jD1bAtn6" alt=""><figcaption></figcaption></figure>

## Meta Keywords und Description für Lexikon Übersicht und Listing <a href="#meta-seo" id="meta-seo"></a>

Sie haben nicht nur die Möglichkeit Meta Keywords und Description für die einzelnen Einträge zu hinterlegen ([Klicken Sie hier, wenn Sie dazu mehr erfahren möchten](#eintrag_anlegen_seo)), sondern können auch für die Lexikon Übersicht und das Lexikon Listing Einträge vornehmen. Gehen Sie hierfür in die Textbausteinverwaltung: Einstellungen > Textbausteine und suchen nach folgenden Namen:

**Lexikon Übersicht**

* Keywords: LexiconMetaKeywordsStandard
* Description: LexiconMetaDescriptionStandard

**Lexikon Listing**

* Keywords: LexiconMetaKeywordsListing... ("..." müssen durch Buchstaben ersetzt werden)
* Description: LexiconMetaDescriptionListing... ("..." müssen durch Buchstaben ersetzt werden)

{% hint style="warning" %}
**HINWEIS:** Die Textbausteine für das Listing werden angelegt, sobald die Seite das erste mal aufgerufen wurde. Fehlt Ihnen ein Eintrag, so gehen Sie in Ihren Shop, in das Lexikon und klicken auf den entsprechenden Buchstaben.
{% endhint %}

## Darstellung im Frontend <a href="#darstellung" id="darstellung"></a>

Die Startseite des Lexikon mit der Anzeige eines hinterlegten Banner, eines Einleitungstext, der neusten und der meist gelesenen Einträge. Als Darstellung wurde ein zweispaltiges Template gewählt.

<figure><img src="/files/2XEbdGpDc02iYf0ASSVE" alt="" width="350"><figcaption></figcaption></figure>

Die Kategorie Seite des Lexikon für den Buchstaben K. Als Darstellung wurde ein zweispaltiges Template gewählt.

<figure><img src="/files/UAJB435TCZQ8TRnlgRNG" alt="" width="350"><figcaption></figcaption></figure>

Ein Beispiel Eintrag für den Begriff "Baumwolle". Als Darstellung für die Artikel wurde ein vierspaltiges Template gewählt.

<figure><img src="/files/EZWFKoPL8sT3wdH5VkW3" alt="" width="350"><figcaption></figcaption></figure>

Begriff Verlinkung in der Artikelbeschreibung am Beispiel "Baumwolle".

<figure><img src="/files/unE46H8dSRpuCXyiBZmP" alt="" width="350"><figcaption></figcaption></figure>

Erklärung des Begriff in einem modalen Fenster mit optional eingeblendeten Footer für die ausführliche Beschreibung.

<figure><img src="/files/4OxJdmZBmTSO8Dj3FHVw" alt="" width="350"><figcaption></figcaption></figure>

## Anpassungen im Frontend <a href="#anpassungen_frontend" id="anpassungen_frontend"></a>

Ab der Plugin Version 2.6.7 wurde die Struktur mit einer Vielzahl an Smarty Blöcke verbessert. Somit haben Sie die Möglichkeit schnell und einfach Änderungen an bestimmten Stellen vorzunehmen. Sie müssen nicht mehr das komplette Template überschreiben, sondern ändern nur noch die entsprechenden Smarty Blöcke im eigenen Template. Diese Methode ist zudem updatesicherer und erspart Ihnen eine Menge Zeit.

**Im folgenden Beispiel finden Sie die Einbindung eines Zusatzfeldes:**

```
{extends file="parent:frontend/plugins/lexicon/box_keyword.tpl"}

{block name='frontend_plugins_lexicon_box_keyword_description'}

     {$smarty.block.parent}

     {if $entry.attribute2}
          <img src="{$entry.attribute2}" alt="Mein Bild">
     {/if}

{/block}
```

## Sitemap für Google <a href="#sitemap" id="sitemap"></a>

Alle Seiten des Lexikons (inklusive der erstellten Einträge) werden in die Sitemap Ihrer Seite aufgenommen. Zur Überprüfung geben Sie folgende URL ein "<http://meinShop.de/sitemap.xml>" und suchen nach einem Eintrag.

{% hint style="warning" %}
HINWEIS: Sollten Sie keine Einträge sehen oder sollten Einträge fehlen, gehen Sie bitte auf: Inhalt > Lexikon und betätigen bitte den Button "SEO URLs erzeugen". [Alle Informationen zu SEO URLs finden Sie hier](#seo_urls)
{% endhint %}

## Responsive - Tablet, Smartphone <a href="#responsive" id="responsive"></a>

Die Anzeige des Lexikon / Glossar Professionell. Dargestellt auf den verschiedenen Endgeräten.&#x20;

<div><figure><img src="/files/iLQ6PAvyQ9RGayP8lsDw" alt=""><figcaption></figcaption></figure> <figure><img src="/files/fotTQVnB3ei2Tm2pgYzs" alt=""><figcaption></figcaption></figure> <figure><img src="/files/g4E055Mufk5Nh8OB8uwg" alt=""><figcaption></figcaption></figure></div>

<div><figure><img src="/files/OIEQJ4OpYxZB1gmcA6b9" alt=""><figcaption></figcaption></figure> <figure><img src="/files/kpTRUe55wVq7ORzduKJh" alt=""><figcaption></figcaption></figure> <figure><img src="/files/DKJSw37ZfXnGgKwVpv03" alt=""><figcaption></figcaption></figure></div>

## Kein Menüpunkt im Backend sichtbar? <a href="#menuepunkt" id="menuepunkt"></a>

In der Regel finden Sie das Lexikon als letzten Menüpunkt unter dem Tab "Inhalte". In seltenen Fällen ist das Lexikon nicht sichtbar, weil die entsprechenden Berechtigungen nicht vergeben sind. Um das Lexikon sichtbar zu machen, gehen Sie bitte wie folgt vor:

Einstellungen -> Benutzerverwaltung -> Regeln & Berechtigungen editieren -> Rolle: local\_admins (oder andere) auswählen -> Häkchen bei "lexicon" setzen.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://coolbax.gitbook.io/coolbax-docs/shopware-5-plugins/storefront/lexikon-glossar-professionell.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.