> For the complete documentation index, see [llms.txt](https://docs.hubyte.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hubyte.de/seo-ultimate/installation.md).

# Installation & Konfiguration

## Installation

1. Plugin über den Shopware Store oder als ZIP hochladen (**Erweiterungen → Meine Erweiterungen → Hochladen**).
2. Plugin **installieren** und **aktivieren**.
3. Storefront-Theme bei Bedarf neu kompilieren (nur nötig, wenn Farb-/Footer-Optionen genutzt werden).

## Grundkonfiguration

Die Grundeinstellungen findest du unter **Einstellungen → Plugins → SEO Ultimate → Konfiguration**.

### Zeichenzähler

Legt die Google-konformen Obergrenzen fest, die im Bulk-Generator als Zeichenzähler angezeigt werden.

| Einstellung                  | Standard | Beschreibung                                    |
| ---------------------------- | -------- | ----------------------------------------------- |
| **Meta Title Zeichen**       | 60       | Empfohlene Maximallänge für Meta-Titel          |
| **Meta Description Zeichen** | 160      | Empfohlene Maximallänge für Meta-Beschreibungen |

> Der Zähler im Generator färbt sich rot, sobald die eingestellte Länge überschritten wird.

### Footer: Shopware Logo

* **Shopware Logo im Footer entfernen** – blendet das „powered by Shopware"-Logo im Footer aus.

### Fontawesome

* **Fontawesome Kit-Code** – hier den kompletten Script-Tag deines Fontawesome-Kits einfügen:

```html
<script src="https://kit.fontawesome.com/{kit-ID}.js" crossorigin="anonymous"></script>
```

Der Kit-Code wird für die Icons im **Social-Media-Footer** und im **Header-Banner** (Conversion & Usability) benötigt.

### Generator Einstellungen

* **Generator Block Size** (Standard: `100`) – Blockgröße für die Speicheranfragen der Bulk-Generatoren. Höhere Werte können die Massengenerierung beschleunigen, benötigen aber mehr Serverleistung. **Im Zweifel auf 100 lassen.**

## Automatisierung (Cronjob)

Für die tägliche automatische Ausführung von Vorlagen wird Shopwares **Scheduled-Task-System** genutzt. Voraussetzung ist, dass der Scheduler bzw. der Message-Consumer auf dem Server läuft (Standard bei Produktivsystemen). Details unter [Cronjob / Automatisierung](/seo-ultimate/cronjob.md).
