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

# Schnellstart

Diese Seite führt dich in acht Schritten von der Installation bis zum ersten veröffentlichten Beitrag. Für tiefergehende Erklärungen findest du am Ende jedes Schritts den Link zur passenden Detailseite.

{% stepper %}
{% step %}

### Plugin installieren und aktivieren

1. **Erweiterungen → Meine Erweiterungen → Blog → Installieren**
2. Wähle die Verkaufskanäle aus, in denen der Blog erscheinen soll (Standard: alle)
3. Öffne die Plugin-Konfiguration und aktiviere **Plugin aktivieren** für den Ziel-Verkaufskanal

→ Details: [Installation](/plugins/blog/installation.md) und [Voraussetzungen](/plugins/blog/voraussetzungen.md)
{% endstep %}

{% step %}

### Magazin-Kategorie anlegen

Im Gegensatz zu einer Produktkategorie ist die Blog-Übersichtsseite **keine fest verdrahtete Seite** unter `/blog`. Stattdessen entscheidest du selbst, wo und wie der Blog auf deiner Storefront erscheint — über das ganz normale Shopware-Kategoriesystem.

1. **Katalog → Kategorien → Neue Kategorie**
2. Name vergeben, z. B. `Magazin`, `Blog` oder `Ratgeber` — daraus entsteht später die URL (z. B. `/magazin`)
3. Im Reiter **Layout** das Layout **Blog Listenseite (PremSoft)** auswählen
4. Speichern

Die Kategorie kann irgendwo in deinem Navigationsbaum hängen — direkt im Hauptmenü, im Footer-Menü oder als Service-Punkt.

→ Details: [Storefront-Integration](/plugins/blog/storefront-integration.md)
{% endstep %}

{% step %}

### Autoren-Übersicht (optional, aber empfohlen)

Wenn du mehrere Autor:innen führst, lohnt sich eine eigene Übersichtsseite.

1. **Katalog → Kategorien → Neue Kategorie** anlegen, z. B. `Autorinnen` als Unterkategorie von `Magazin`
2. Im Reiter **Layout** das Layout **Blog Autoren (PremSoft)** auswählen
3. Speichern

Die Autorenseite ist dann z. B. unter `/magazin/autorinnen` erreichbar.
{% endstep %}

{% step %}

### Erste:n Autor:in anlegen

1. **Blog → Autor:innen → Autor erstellen**
2. Vorname, Nachname, Profilbild und Beschreibung pflegen
3. Speichern

> In der Basis-Version ist genau **1 Autor:in** enthalten. Mehr Profile gibt es in der Advanced- oder Premium-Version.

→ Details: [Autor:innen](/plugins/blog/blog-beitrage-erstellen-und-bearbeiten/autor-innen.md)
{% endstep %}

{% step %}

### Kategorie und Tag für deine Beiträge (optional)

Das sind die thematischen Gruppen, die du deinen Beiträgen zuordnen kannst — **nicht zu verwechseln mit der Shopware-Kategorie aus Schritt 2**, in der dein Magazin gehostet wird.

1. **Blog → Kategorien → Kategorie erstellen** — z. B. `Reisen`, `Rezepte`, `Tipps`
2. **Blog → Tags → Tag erstellen** — feiner granular als Kategorien
   {% endstep %}

{% step %}

### Ersten Blogbeitrag erstellen

1. **Blog → Beiträge → Beitrag erstellen**
2. **Grunddaten**: interner Name, Status auf `Aktiv`, Anzeigedatum setzen, Autor:in wählen
3. **Inhalt**: Titel, Kurzbeschreibung, Hauptinhalt und ein Vorschaubild — optional weitere Bilder für die Galerie
4. **Sichtbarkeit**: Blog-Kategorie und Tag aus Schritt 5 zuweisen, Verkaufskanäle wählen
5. **SEO**: Meta-Titel, Meta-Description und SEO-URL (optional — sinnvolle Standardwerte werden automatisch erzeugt)
6. **Speichern**

→ Details: [Beiträge](/plugins/blog/blog-beitrage-erstellen-und-bearbeiten/beitrage.md)
{% endstep %}

{% step %}

### Zuordnungen in der Plugin-Konfiguration

Damit die Beiträge unter dem Pfad deiner Magazin-Kategorie erscheinen, musst du dem Plugin noch sagen, welche Kategorie deine Magazin-Übersicht ist:

1. **Erweiterungen → Meine Erweiterungen → Blog → Konfiguration**
2. Im Bereich **Kategoriezuweisungen** die in Schritt 2 angelegte Kategorie unter **Kategorie mit der Blog-Listenseite** auswählen
3. Wenn du Schritt 3 gemacht hast, auch **Kategorie mit der Autoren-Übersicht** entsprechend setzen. Ansonsten hier die **Blog-Listenseite** zuordnen
4. Speichern

→ Details: [Installation → Kategoriezuweisungen](/plugins/blog/installation.md#kategoriezuweisungen)
{% endstep %}

{% step %}

### Storefront prüfen

Rufe deine Magazin-Kategorie in der Storefront auf:

* Die Beiträge erscheinen als Kartenliste mit Filter und Pagination
* Klick auf einen Beitrag öffnet die Detailseite — die URL nutzt automatisch den Kategoriepfad (z. B. `/magazin/mein-beitrag`)
* Die Autoren-Übersicht (falls angelegt) zeigt eine Kartenliste mit allen Profilen und einem A–Z-Filter

{% hint style="warning" %}
**Wichtig:** Wenn du in der Plugin-Konfiguration nachträglich eine andere Kategorie auswählst, lass deinen Hoster einmalig die SEO-URLs neu generieren — sonst bleiben die alten URLs aktiv.
{% endhint %}
{% endstep %}
{% endstepper %}

## Nächste Schritte

* **Blog auf der Startseite zeigen?** [Erlebniswelten-Elemente](/plugins/blog/cms-elemente.md) — drei kuratierte Beitrags-Rails (Neueste, aus einer Kategorie, Hand-ausgewählt)
* **Mehr Beiträge anlegen?** Limits und Upgrade-Pfad: [Advanced- und Premium-Version](/plugins/blog/advanced-und-premium-version.md)
* **Bewertungen aktivieren?** Premium-Feature, Details auf [Bewertungen](/plugins/blog/bewertungen.md)
* **Externe Integration oder Headless-Frontend?** [Store API](/plugins/blog/store-api.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.premsoft.de/plugins/blog/schnellstart.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.