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

# CMS Elemente

Das Plugin liefert eine Reihe von Bausteinen mit, die du in Erlebniswelten zusammenstellen kannst. Alle erscheinen im **"Block hinzufügen"-Dialog** unter dem Tab **Blog (PremSoft)**.

## Universelle Showcase-Blöcke

Diese drei Bausteine kannst du **überall** einsetzen — auf der Startseite, in Landingpages, auf Kategorieseiten oder in deinem Magazin. Damit zeigst du Beiträge dort, wo deine Kund:innen sie brauchen.

| Baustein                      | Zeigt                                                                | Konfiguration                        |
| ----------------------------- | -------------------------------------------------------------------- | ------------------------------------ |
| Blog – Neueste Beiträge       | Die N neuesten aktiven Beiträge.                                     | Anzahl der Beiträge (1–50).          |
| Blog – Beiträge aus Kategorie | Beiträge einer bestimmten Blog-Kategorie.                            | Kategorie + Anzahl.                  |
| Blog – Ausgewählte Beiträge   | Beiträge, die du manuell auswählst — in der Reihenfolge deiner Wahl. | Beitragsauswahl per Mehrfachauswahl. |

Alle drei Blöcke rendern dieselbe Karten-Optik wie die Magazin-Übersicht, sodass sich Empfehlungsbereiche grafisch nahtlos in den restlichen Shop einfügen.

## Bausteine für die Magazin-Übersicht

Diese Bausteine sind dafür gemacht, in der Magazin-Übersichtskategorie (siehe [Schnellstart](/plugins/blog/schnellstart.md), Schritt 2) eingesetzt zu werden.

| Baustein          | Zeigt                                                               |
| ----------------- | ------------------------------------------------------------------- |
| Blog – Auflistung | Die zentrale Beitragsliste mit Pagination und Sortierung.           |
| Blog – Filter     | Filterformular mit Mehrfachauswahl für Kategorie, Tag und Autor:in. |

## Bausteine für die Beitrags-Detailseite

Diese Einzel-Element-Blöcke setzt du im Standard-Layout der Beitragsdetailseite ein und kannst sie nach Belieben neu anordnen.

| Baustein                  | Zeigt                                                                             |
| ------------------------- | --------------------------------------------------------------------------------- |
| Blog – Titel              | Beitragstitel mit Kategorie-Badge, Untertitel und Meta-Zeile (Autor + Datum).     |
| Blog – Untertitel         | Den Untertitel separat.                                                           |
| Blog – Kurzbeschreibung   | Den Lead-Text in größerer Schrift — ideal als Einleitung.                         |
| Blog – Inhalt             | Den Haupt-Inhalt mit gestalteten Überschriften, Listen, Zitaten und Code-Blöcken. |
| Blog – Vorschaubild       | Das Hero-Bild oben auf der Seite.                                                 |
| Blog – Bildergalerie      | Die zusätzlichen Bilder als Galerie mit Lightbox-Anzeige.                         |
| Blog – Autor              | Autoren-Karte mit Avatar, Name und Verlinkung zum Autorenprofil.                  |
| Blog – Kategorien         | Kategorie-Badges mit Klick-Verlinkung.                                            |
| Blog – Tags               | Tag-Badges.                                                                       |
| Blog – Verwandte Produkte | Produkt-Slider mit den verknüpften Produkten.                                     |
| Blog – Bewertungen Sterne | Aggregierter Sterne-Durchschnitt plus Anzahl der Bewertungen.                     |
| Blog – Bewertungsliste    | Liste der freigegebenen Bewertungen.                                              |
| Blog – Bewertungsformular | Eingabeformular für neue Bewertungen.                                             |

Die drei Bewertungsbausteine erscheinen nur, wenn Bewertungen in der Plugin-Konfiguration aktiviert sind **und** du die Premium-Version nutzt.

## Bausteine für die Autoren-Seiten

Diese Bausteine setzt du auf den Layouts für die Autoren-Übersicht und für einzelne Autor:innen ein.

| Baustein                  | Zeigt                                                                                  |
| ------------------------- | -------------------------------------------------------------------------------------- |
| Blog – Autorenliste       | Kartenübersicht aller Autor:innen, sortiert nach Nachname.                             |
| Blog – A-Z Autorenfilter  | Alphabet-Leiste, mit der Besucher:innen die Autorenliste nach Nachname filtern können. |
| Blog – Autor Details      | Kombiniertes Element mit Name + Bild + Beschreibung.                                   |
| Blog – Autor Name         | Einzeln.                                                                               |
| Blog – Autor Bild         | Einzeln.                                                                               |
| Blog – Autor Beschreibung | Einzeln (übersetzbar).                                                                 |

## Eigene Layouts anlegen

Du kannst eigene Erlebniswelten für deine Blog-Inhalte gestalten:

{% stepper %}
{% step %}
**Inhalte → Erlebniswelten → Neu**
{% endstep %}

{% step %}
Den passenden Page-Typ wählen — für Beitragsdetailseiten ist das die **Blog-Seite (PremSoft)**, für Magazin-Übersicht und Autoren-Übersicht eine ganz normale Kategorieseite
{% endstep %}

{% step %}
Bausteine aus dem Tab **Blog (PremSoft)** zusammenbauen
{% endstep %}

{% step %}
In der Plugin-Konfiguration als Standard hinterlegen, oder am einzelnen Beitrag im Reiter "Sichtbarkeit" als Layout auswählen
{% endstep %}
{% endstepper %}

Solange du an einem Beitrag kein eigenes Layout hinterlegst, nutzt das Plugin das konfigurierte Standard-Layout — du kannst also komplett bei den mitgelieferten Layouts bleiben.


---

# 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/cms-elemente.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.
