> 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/storefront-integration.md). # Storefront-Integration Blog-Inhalte erscheinen an vier Stellen im Shop: 1. **Auf einer Kategorie deiner Wahl** — du legst eine Kategorie an und weist ihr das Blog-Layout zu. Diese Kategorie wird automatisch zu deiner Magazin-Übersicht. 2. **Auf den Beitragsdetailseiten**, deren URL sich aus dem Pfad dieser Kategorie ableitet. 3. **In bestehenden Erlebniswelten** — über kuratierte Bausteine für Startseite, Landingpages und andere Kategorien. 4. **In SEO-Schnipseln und einem RSS-Feed** — automatisch, ohne weitere Konfiguration (Details: [SEO, RSS-Feed und Rich Snippets](/plugins/blog/seo-rss-und-rich-snippets.md)). ## Wo der Blog in deinem Shop wohnt Anders als bei vielen Blog-Plugins gibt es **keine feste URL** wie `/blog` — der Pfad richtet sich danach, wie du deine Magazin-Kategorie nennst: * Heißt die Kategorie `Magazin` → URLs sehen aus wie `/magazin/mein-erster-beitrag` * Heißt sie `Ratgeber` → `/ratgeber/mein-erster-beitrag` * Hängt sie unter `Service/Wissen` → `/service/wissen/mein-erster-beitrag` Das gilt für die Beitragsübersicht, jede Beitragsdetailseite, die Autoren-Übersicht und die Autoren-Detailseiten. Wie du die Kategorien anlegst, steht im [Schnellstart](/plugins/blog/schnellstart.md). ## Magazin-Übersicht (Listenseite) Die zentrale Beitragsliste rendert sich auf der Kategorie, der du das Layout **Blog Listenseite (PremSoft)** zugewiesen hast. Sie zeigt: * Eine Kartenliste aller aktiven Beiträge * Ein Filterformular für Kategorie, Tag und Autor:in * Sortieroptionen: Neueste, Älteste, Titel A–Z, Titel Z–A * Pagination * Automatische SEO-Schnipsel im Quelltext Aktive Filter erscheinen als Chips unter dem Formular und können einzeln entfernt werden. Filteränderungen aktualisieren die Liste ohne kompletten Seiten-Reload. ## Beitragsdetailseite Das Standard-Layout besteht aus zwei Sektionen: * **Oben:** Titel, Vorschaubild, Kurzbeschreibung und Hauptinhalt — auf der rechten Seite eine Seitenleiste mit Autor:in, Kategorien und Tags * **Darunter (volle Breite):** Verwandte Produkte, Bewertungssterne, Bewertungsliste und Bewertungsformular Du kannst dieses Layout 1:1 nutzen, eine Kopie als Basis nehmen und anpassen, oder pro Beitrag im Reiter "Sichtbarkeit" ein eigenes Layout hinterlegen. ## Autoren-Übersicht Die Übersicht aller Autor:innen rendert sich auf der Kategorie, der du das Layout **Blog Autoren (PremSoft)** zugewiesen hast. Sie zeigt eine Kartenliste aller Profile, sortiert nach Nachname. Optional kannst du den **A–Z-Filter** als zusätzlichen Baustein einbauen — Buchstaben mit mindestens einem Treffer sind aktiv, leere sind ausgegraut. ## Autoren-Detailseite Pro Autor:in gibt es eine eigene Detailseite mit Profil, Beschreibung und einer Liste aller Beiträge der Person. Die URL nutzt automatisch den Pfad der Autoren-Übersichtskategorie (z. B. `/magazin/autorinnen/anna-mueller`). ## Bewertungen In das Beitrags-Standard-Layout ist ein Bewertungsbereich integriert. Beim ersten Laden ist das Eingabeformular eingeklappt — Besucher:innen sehen den Sterne-Durchschnitt und einen Button **"Bewertung schreiben"**. Klick öffnet das Formular per Animation und scrollt es in den sichtbaren Bereich. Details auf [Bewertungen](/plugins/blog/bewertungen.md). ## Brotkrumen Navigation Auf allen Blog-Seiten zeigt das Plugin eine Brotkrume an, die den Kategoriepfad spiegelt. Beispiel: auf der Detailseite eines Beitrags in der Kategorie `Magazin` sieht sie aus wie: ``` Startseite → Magazin → Beitragstitel ``` Hängt deine Magazin-Kategorie tiefer im Navigationsbaum (z. B. `Service/Magazin`), zeigt die Brotkrume den vollständigen Pfad. ## Mehrsprachigkeit Alle Texte (Titel, Untertitel, Kurzbeschreibung, Inhalt, Meta-Tags, SEO-URL, Autorenbeschreibung, Kategorie- und Tag-Namen) sind übersetzbar. Die Sprachauswahl funktioniert pro Verkaufskanal — sprich, in einem deutsch- und einem englischsprachigen Verkaufskanal können dieselben Beiträge mit unterschiedlichen Inhalten erscheinen. ## Headless / Externe Integration Wenn du den Blog nicht in der Shopware-Storefront, sondern z. B. in einem Headless-Frontend (Vue, React, Mobile-App) anzeigen möchtest, kannst du sämtliche Daten über die Store API abrufen. Details auf [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/storefront-integration.md?ask=&goal= ``` `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.