Inhaltstypen
Die Inhaltstypen ermöglichen es Dir, Backendmodule zu erstellen, über die Du eigene Inhalte
pflegen und z.B. im Frontend ausspielen kannst. Denkbar ist es z.B., eine Liste mit verschiedenen Rezepten zu erstellen. In
diesem Artikel zeigen wir Dir, welche Schritte dazu notwendig sind.
Um das Ganze noch besser zu verdeutlichen, findest Du am Ende ein konkretes Beispiel mit
entsprechenden Screenshots.
Anlegen eines neuen Inhaltstyps
Bevor Du einzelne Seiten erstellen und mit Inhalt füllen kannst, ist es zunächst erforderlich das Grundgerüst
für die Seiten zu definieren.
Wie Du dies manuell über das Backend vornimmst, beschreiben wir Dir hier.
Darüber hinaus besteht die Möglichkeit einen Inhaltstyp über ein eigenes Plugin bereitzustellen - wie dies möglich
ist, erfährst Du in unserer Entwicklerdokumentation
unter https://developers.shopware.com/developers-guide/content-types.
Um einen Inhaltstyp anzulegen, rufe zunächst das Modul unter Einstellungen > Inhaltstypen auf und
klicke auf Hinzufügen (1).
Allgemeine Konfiguration
Im Bereich Allgemein kannst Du zunächst einen Namen (1) für den Inhaltstyp vergeben. Dieser wird im
Backend unter Inhalte als Menüeintrag für den Inhaltstyp verwendet. Über diesen Menüeintrag kannst Du
später die einzelnen Inhalte verwalten. Dies beschreiben wir näher im Abschnitt
Inhalte
pflegen.
Außerdem wird der Name für den Seitentitel im Frontend verwendet, wenn Du die Funktion Im Frontend ein
Listing/Details-Seite erzeugen (3) aktiviert hast.
Der Icon-Name (2) definiert das Symbol, das im Menü im Backend neben dem Namen angezeigt wird.
Hierzu steht Dir eine große Auswahl an vordefinierten Icons zur Verfügung. Die Übersicht mit dem hier
einzutragenden Namen findest Du unter https://developers.shopware.com/designers-guide/backend-icons/.
Für die Darstellung kannst Du folgende Punkte konfigurieren:
Zunächst legst Du fest, ob dieser Inhaltstyp im Frontend ein Listing/eine Detail-Seite erzeugen soll (3). Wenn
Du dies aktivierst, wird Dir unterhalb des Namens eine Infozeile eingeblendet, in der Du entnehmen kannst, wie die
Inhaltsübersicht aufgerufen werden kann. Diesen Eintrag kannst Du dann z.B. in einer Kategorie verlinken, um Deinen
Kunden den Aufruf per Klick auf diese Kategorie zu ermöglichen.
Bitte beachte, dass für die Generierung dieses Links der Initial vergebene Name verwendet
wird.
Du kannst den Namen zwar nachträglich ändern, die technische URL (Aufruf über die shopware.php) behält jedoch den
ursprünglichen Aufbau.
Die SEO-URLs werden jedoch bei einem Neuaufbau des SEO-Index umbenannt, wenn die entsprechende URL noch verfügbar ist.
In der Tabelle Seo-URLs (7) werden Dir die generierten Seo-URLs angezeigt, hierüber kannst Du die Seiten
dann im Frontend aufrufen. Den Aufbau der Seo-URLs definierst Du über das Seo-URL-Template (10).
Wenn Du die Anzeige im Frontend aktivierst, sind die Angaben Titel (4), Beschreibung
(5), Bild (6), Meta Title (8) und Meta
Description (9) verpflichtend. Beachte hierbei bitte, dass es notwendig ist, zunächst entsprechende
Felder im Bereich Felder (12) anzulegen, um eine Auswahl treffen zu können. Dazu erfährst Du mehr
im Abschnitt Felder konfigurieren. Die DropDown-Liste Suchmaschinen
Robots Tag (11) ermöglicht Dir festzulegen, ob Seiten indexiert oder nicht indexiert werden sollen und
ob Links auf der Seite gefolgt oder nicht gefolgt werden sollen.
Felder konfigurieren
Um ein Feld anzulegen, klicke auf Hinzufügen (1), dadurch öffnet sich folgende Maske:
Das Label (1) dient der Bezeichnung des Felds. Es wird im Backend-Modul als Spaltenüberschrift
genutzt (vorausgesetzt Feld als Spalte anzeigen im Backend (6) ist aktiv) und im Frontend als
Überschrift für den jeweiligen Block verwendet.
Außerdem kannst Du definieren, ob für dieses Feld die Angabe verpflichtend (2) ist.
Über den Typ (3) legst Du fest, welches Datenformat für das Feld verwendet wird bzw. welchen
Inhalt es enthalten kann.
Der (optionale) Hilfetext (4) wird im Backend-Modul per Mouseover über ein blaues
Fragezeichen-Symbol neben dem Feld angezeigt. Außerdem kann unter dem jeweiligen Feld zusätzlich ein Support-Text
(5) angezeigt werden, der z.B. eine kurze Erklärung zu dem Feld bietet.
Gerade bei umfangreicheren Inhalten kann die Übersicht im jeweiligen Modul aufgrund der großen Spaltenzahl
unübersichtlich werden, daher besteht die Möglichkeit, ein Feld nicht als Spalte im Backend anzuzeigen
(6). Der Inhalt des Feldes kann dann weiterhin normal gepflegt werden, wird jedoch nicht in der
Backend-Übersicht angezeigt.
Außerdem ist es möglich, den Inhalt eines Feldes von der Suche im jeweiligen Inhaltsmodul auszuschließen
(7). Für jedes Feld kann konfiguriert werden, ob dieses Übersetzbar (8) ist. Hierbei
geht es nur um den Inhalt des Feldes. Die weiteren Übersetzungsmöglichkeiten beschreiben wir im
Abschnitt Übersetzung.
Nachdem Du Deine benötigten Felder angelegt und die im Reiter Allgemein notwendigen Angaben gemacht hast, kannst Du den
Inhaltstyp speichern. Hierdurch wird nun ein neuer Eintrag im Menü Inhalte erzeugt (ggfs. ist der Eintrag erst korrekt
sichtbar, wenn Du das Backend einmal neu geladen hast).
Inhalte pflegen
Jeder angelegte Inhaltstyp stellt im Menü Inhalte einen eigenen Menüeintrag bereit, über den die
einzelnen Inhalte gepflegt werden können.
Um einen Inhalt anzulegen, klicke auf den Button Hinzufügen (1), es öffnet sich dann die Maske mit den
einzelnen Feldern, die Du vorher bei der Anlage des Inhaltstyps definiert hast.
Nachdem Du die einzelnen Felder gefüllt und das Fenster gespeichert hast, wird eine entsprechende Inhaltsseite
angelegt.
Im Frontend erreichst Du die Inhalts-Übersicht über die Url dein-shop.de/name-des-inhaltstyps, eine einzelne
Inhaltsseite über dein-shop.de/name-des-inhaltstyps/titel-des-inhalts.
Wie dies im Detail aussieht, zeigen wir Dir im unten aufgeführten Beispiel.
Bitte beachte, dass für die Anzeige der Bilder auf der Detailseite des einzelnen Inhalts
Thumbnails verwendet werden. Sollten die Bilder, die Du verwenden möchtest, in einem Album der Medienverwaltung abgelegt
sein, für die noch keine Thumbnailgrößen definiert sind, ist es erforderlich, diese anzulegen.
Wie dies möglich ist, beschreiben wir in Dokumentation für den
Medien-Manager.
Übersetzung
Backend
Wenn Du einen Inhaltstyp anlegst und somit ein Backendmodul erstellt wird, ist dies im Backend zunächst nur in
einer Sprache verfügbar. Um die Bezeichnungen der Felder auch für andere Sprachen verfügbar zu machen, werden beim
Anlegen eines Feldes automatisch Textbausteine erstellt, über die Du dann die Übersetzung vornehmen kannst. Die
Textbausteine sind je Inhaltstyp in einem eigenen Unterverzeichnis hinterlegt und Du findest sie in der
Textbaustein Verwaltung unter Namespaces/backend/custom"namedesmoduls".
Zusätzlich zur Bezeichnung des Feldes kannst du hier auch den Hilfe- und Support-Text anpassen. Um den Eintrag im
Menü Inhalte zu übersetzen, steht unter backend/index/view/main der Eintrag CustomNamedesModuls/index zur Verfügung.
Frontend
Feldinhalte
Wenn Du ein Feld für einen Inhaltstypen anlegst, kannst Du definieren, ob dieses Feld übersetzt werden kann. Aktivierst
Du die Option, wird in dem entsprechenden Feld dann das (auch aus anderen Bereichen in Shopware bekannte) Globus-Symbol
eingeblendet, worüber Du das Übersetzungsmodul für das Feld öffnen kannst. Hierüber ist es dann möglich für jeden
Sprach- bzw. Subshop einen eigenen Inhalt anzulegen.
Textbausteine
In der Textbaustein-Verwaltung wird ebenso - wie für die Backendübersetzung - ein Bereich für Textbausteine des
Inhaltstyps im Frontend angelegt. Auch dieser trägt den Namen custom"namedesinhaltstyps" und ist
unter Namespace/frontend zu finden.
In diesen Textbausteinen kannst Du u.A. Meta-Title und Meta-Description setzen.
Außerdem nimmst Du hier die Übersetzung des Namens vor, der im Frontend auf der Übersichtsseite des Inhtalstyps
angezeigt wird. Hierzu ist es erforderlich, einen weiteren Textbaustein mit dem Namen name anzulegen und mit
entsprechendem Inhalt zu pflegen.
Weitere Informationen zu den Textbausteinen findest Du unter https://docs.shopware.com/de/shopware-5-de/einstellungen/textbausteine
Beispiel
Da bei der Verwendung der Inhaltstypen Einstellungen an mehreren Stellen vorgenommen werden, möchten wir dies mit einem
Beispiel verdeutlichen.
Es soll eine Seite mit Rezepten erstellt werden.
Das Grundmodul, über das die Rezepte angelegt werden, wird über Einstellungen > Inhaltstypen
erstellt und konfiguriert. Hier kannst Du auch festlegen, welche Daten Du für die Rezepte pflegen möchtest und die
entsprechenden Felder anlegen. Im Beispiel verwenden wir Titel, Beschreibung, Bild, Zutaten und Zubereitung.
Nachdem Du dies wie im Abschnitt Anlegen eines neuen
Inhaltstyps beschrieben durchgeführt hast, kannst Du nun die einzelnen Rezepte anlegen. Dies ist im Menü Inhalte
möglich. Hier ist nun ein neuer Eintrag mit dem Namen des Inhaltstyps (beispielhaft "Rezepte") vorhanden. Hierüber
öffnest Du die Übersicht der angelegten Rezepte und kannst neue Rezepte hinzufügen.
In dem Fenster für das Anlegen eines Rezepts siehst Du nun die einzelnen Felder, die Du vorab bei der Erstellung des
Inhaltstyps definiert hast.
Für die Übersetzungen stehen hier folgende Textbausteineinträge zur Verfügung:
backend/index/view/main - CustomRezepte/index für den Eintrag im Menü Inhalte
backend/customrezepte/main enthält die Textbausteine für die einzelnen Einträge innerhalb des Backendmoduls
frontend/customrezepte/main stellt Textbausteine bereit, um im Frontend Metainformationen anpassen zu können.
Ansichten
Backend
Einstellungen > Inhaltstypen:
Inhaltstypen > Allgemein:
Inhaltstypen > Felder:
Menü Inhalte:
Inhalte > Rezepte:
Rezepte > Details
Frontend
Übersicht:
Detailansicht:
