> 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/installation.md).

# Installation

## Plugin installieren

Das Plugin findest du im Shopware Store. Installiere es wie jede andere Erweiterung:

1. **Erweiterungen → Meine Erweiterungen → Blog → Installieren**
2. Wähle die Verkaufs­kanäle aus, in denen der Blog verfügbar sein soll (Standard: alle)

Während der Installation legt das Plugin im Hintergrund die nötigen Datenbank­tabellen, die mitgelieferten Standard-Layouts (Listenseite, Beitrags­detail, Autoren-Übersicht, Autoren-Detail) und einen Medien-Ordner **Blog** an. Du musst dazu nichts tun.

## Plugin-Konfiguration

Die Grund­einstellungen findest du unter **Meine Erweiterungen → Blog → Konfiguration**. Sie ist in vier Bereiche unterteilt.

### Allgemein

| Einstellung              | Was sie bewirkt                                                                           |
| ------------------------ | ----------------------------------------------------------------------------------------- |
| Plugin aktivieren        | Schaltet den Blog für den gewählten Verkaufs­kanal ein oder aus.                          |
| Bewertungen aktivieren   | Schaltet die Bewertungs-Funktionen in der Storefront ein. Voraussetzung: Premium-Version. |
| Autoren-Details anzeigen | Zeigt Autorenbild und Beschreibung auf Beitragsdetail­seiten.                             |

### Kategoriezuweisungen

Damit dein Blog unter dem Pfad einer beliebigen Kategorie erreichbar ist, weist du dem Plugin hier zu, **welche** Kategorie deine Magazin-Übersicht ist. Die URL deiner Beiträge spiegelt dann automatisch den Kategoriepfad — heißt deine Kategorie `Magazin`, sind die Beiträge unter `/magazin/...` erreichbar.

| Einstellung                         | Was sie bewirkt                                                                                                                                                                       |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Kategorie mit der Blog-Listenseite  | Die Kategorie, der du das Layout **Blog Listenseite (PremSoft)** zugewiesen hast. Pflichtfeld, sobald du Beiträge anlegst — ohne diese Zuweisung gibt es keine Blog-Übersichts­seite. |
| Kategorie mit der Autoren-Übersicht | Analog für die Autoren-Übersicht. Optional — wenn du keine Autoren-Übersicht anbietest, nutze hier die Blog-Listenseite.                                                              |

> Wenn du nachträglich eine andere Kategorie auswählst, müssen die SEO-URLs neu generiert werden. Bitte deinen Hoster bzw. Administrator, die Indexierung neu zu starten — sonst zeigen die alten Links weiterhin den alten Pfad.

Wie du die passenden Kategorien anlegst, steht im [Schnellstart](/plugins/blog/schnellstart.md) in Schritt 2 und 3.

### Standard-Layouts

Du kannst die Beitragsdetail- und Autoren­seiten mit eigenen Erlebnis­welten gestalten und sie hier als Standard hinterlegen. Wählst du nichts aus, werden die mitgelieferten Layouts verwendet.

| Einstellung                    | Was sie bewirkt                                   |
| ------------------------------ | ------------------------------------------------- |
| Blog-Beitrag Layout            | Standard-Layout für Beitragsdetail­seiten.        |
| Layout der Autoren-Übersicht   | Standard-Layout für die Autoren-Übersichts­seite. |
| Layout der Autoren-Detailseite | Standard-Layout für eine einzelne Autor:in.       |

### RSS Feed

| Einstellung              | Was sie bewirkt                                     |
| ------------------------ | --------------------------------------------------- |
| Anzahl der Feed-Einträge | Maximale Anzahl Beiträge im RSS-Feed (Standard 20). |
| Feed Beschreibung        | Beschreibungs­text, der im RSS-Feed sichtbar ist.   |

## Nächste Schritte

Sieh dir den [Schnellstart](/plugins/blog/schnellstart.md) an, um den Blog in unter zehn Minuten betriebsbereit zu machen, oder spring direkt ins [Verwaltungs-Dashboard](/plugins/blog/blog-beitrage-erstellen-und-bearbeiten.md), um Beiträge, Autor:innen und Kategorien anzulegen.


---

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