Komponenten & Sammlungen in strapi

Documentation Index

Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt

Use this file to discover all available pages before exploring further.

Auf dieser Seite wird erklärt, wie Inhalte in Strapi strukturiert werden und welche Rolle Komponenten, Sammlungen und Einzel-Einträge dabei spielen. Sie erfahren, wofür die jeweiligen Content-Typen verwendet werden, wie sie sich unterschieden und wie sie im Content-Manager zur Pflege von Inhalten zusammenspielen. Ziel ist es, die in WEBSALE standardmäßig bereitgestellten Strukturen besser zu verstehen, Inhalte korrekt anzulegen und bestehende Inhaltsbereiche sicher zu erweitern - ohne, dass Strapi als Page-Builder verstanden wird.

---

​

Komponenten

Wie in vielen anderen Content-Management-Systemen dienen Komponenten als wiederverwendbare Elemente, die zur Gestaltung und Strukturierung des Onlineshops genutzt werden können. Diese Komponenten sind im Grunde vordefinierte Bausteine, die spezifische Funktionen oder Layouts implementieren und die in verschiedenen Teilen des Shops eingesetzt werden können.

​

Übersicht der Standard-Komponenten

Eine Übersicht aller im Standardumfang zur Verfügung stehenden Komponenten ist über das linke Seitenmenü unter dem Navigationspunkt “Content-Type Builder” einsehbar. Sofern der Navigationspunkt “Content-Type Builder” nicht sichtbar ist, besteht die Möglichkeit, dass die entsprechenden Berechtigungen in deinem Nutzerkonto fehlen. In diesem Fall muss sich an den entsprechenden Mitarbeiter im Unternehmen gewendet werden, der die entsprechenden Rollen zuweisen kann.

​

Content

Die “Content”-Komponente beinhaltet einen Editor, der in seiner Funktionalität einem Texteditor, wie er beispielsweise von Microsoft Word bekannt ist, ähnelt. In diesem können Texte, Medien, Tabellen sowie weitere Elemente eingefügt, bearbeitet oder formatiert werden. Zusätzlich besteht die Option, CSS-Klassen zuzuweisen, um das Aussehen weiter zu spezifizieren und zu bestimmen. Außerdem kann eingestellt werden, ob der Inhalt über die gesamte Bildschirmbreite angezeigt werden oder sich an bestehende Komponenten anpassen soll.

​

WS Inquiry

DIe “WS Inquiry”-Komponente dient der Anzeige eines Websale-Formulars auf der Seite. In der VX-Version von WEBSALE erfolgt die Einbindung der Formulare allerdings ausschließlich über das Admin-Interface. Eine Anleitung hierzu kann hier eingesehen werden.

​

Slider

Ein Slider ist eine interaktive Komponente in unserem Shop-System, die darauf ausgelegt ist, Inhalte dynamisch in einer horizontal scrollbaren Anzeige zu präsentieren. Diese Form der Darstellung ermöglicht es, mehrere Elemente wie Bilder, Produkte oder Werbebanner auf begrenztem Raum attraktiv und benutzerfreundlich zu zeigen. Nutzer können durch die Inhalte blättern, was eine aktive und engagierte Interaktion mit dem angebotenen Content fördert. Die verschiedenen Slider-Typen in unserem System - der allgemeine Bild-Slider, der Product-Slider und der Product-Slider für Produkte einer Kategorie - nutzen diese dynamische Präsentationsform, um jeweils spezifische Anwendungsfälle zu unterstützen, sei es durch das Anzeigen großer Banner für Marketingzwecke oder das detaillierte Highlighten ausgewählter Produkte.

​

Slider

Dies ist eine grundlegende Slider-Komponente, die hauptsächlich für große Banner und Bilder genutzt wird. Sie unterstützt das Konzept des „responsive Designs“, indem für verschiedene Viewports (Anzeigegrößen und -geräte) unterschiedliche Bilddateien hinterlegt werden können. Jeder Slide innerhalb dieses Sliders kann mit einer individuellen Verlinkung versehen werden, um Nutzer gezielt zu weiterführenden Informationen oder anderen Bereichen deines Shops zu führen. Wenn Texte auf den Slides gewünscht sind, müssen diese bereits auf den Bannern und Bildern enthalten sein. Text kann innerhalb der Standard-Komponente nicht über die Strapi-Eingabemaske hinzugefügt werden, was die Gestaltung der visuellen Inhalte vor dem Upload erfordert.

​

Product-Slider (manual)

Mit dieser Komponente kann ein Slider an Produktboxen im Shop angezeigt werden. Die Eigenschaften und Funktionen des Sliders werden direkt im Shop konfiguriert. Dies beinhaltet Einstellungen wie Breakpoints, die Schnelligkeit beim Wechsel der Slides, die Anzeige von Navigationspfeilen und weitere Verhaltensweisen des Sliders. Diese Angaben können nicht über das CMS angepasst werden. Änderungen an der Konfiguration des Sliders müssen immer über den Template-Manager vorgenommen werden. Der Zusatz „Manual“ bedeutet, dass die angezeigten Produkte selbst ausgewählt werden können. Dazu müssen die Produktnummern der gewünschten Produkte als komma-separierte Liste in das Feld „Produktliste“ eingetragen werden. Wenn gewünscht, kann dem Slider eine Überschrift hinzugefügt werden.. Dies hilft den Kunden zu verstehen, welche Produkte sie unter diesem Slider finden können. Außerdem besteht die Möglichkeit zu bestimmen, ob der Slider über die gesamte Bildschirmbreite angezeigt werden soll oder nicht. Zu beachten ist, dass die eingegebenen Produktnummern nicht automatisch auf Richtigkeit überprüft werden. Wenn also in der Storefront keine Anzeige des gewünschten Produktes erfolgt, dann überprüfe bitte die entsprechenden Eingaben.

​

Product-Slider für Produkte einer Kategorie

Diese Komponente funktioniert ähnlich wie die „Product Slider (manual)“-Komponente. Der Unterschied besteht darin, dass hier keine komma-separierte Liste von Produktnummern verwendet wird. Stattdessen wird hier ein Kategorie-Index eingetragen, aus dem die Produkte automatisch geladen und im Slider angezeigt werden. Es ist nicht möglich, einzelne Produkte der Kategorie von der Anzeige im Slider auszuschließen. Die Produkte werden in der Reihenfolge dargestellt, wie sie in der Shop-Datenbank hinterlegt sind. Eine spezielle Sortierangabe oder Sortierreihenfolge ist nicht möglich. Änderungen an Produkten innerhalb dieser Kategorie spiegeln sich automatisch im Slider wider, sodass bei Produktaktualisierungen keine manuellen Anpassungen am Slider notwendig sind. Dies sorgt für eine stets aktuelle und wartungsarme Präsentation der Produkte. Es ist zu beachten, dass der eingegebene Kategorie-Index nicht auf Richtigkeit überprüft wird. Wenn also in der Storefront keine Anzeige der gewünschten Kategorie erfolgt, dann muss die Eingabe des Kategorie-Indexes nochmals überprüft werden.

​

Product-Teaser

Ein Product-Teaser ist eine visuell ansprechende Komponente in unserem Shop-System, die dazu dient, einzelne Produkte oder eine kleine, ausgewählte Gruppe von Produkten prominent und auffällig darzustellen. Im Gegensatz zu einem Product-Slider, der viele Produkte in einer dynamischen, scrollbaren Anzeige präsentiert, konzentriert sich der Product-Teaser auf die Hervorhebung bestimmter Produkte. Bei der Anlage mehrerer Teaser werden diese nicht gescrollt, sondern je nach Definition der Storefront nebeneinander oder untereinander angezeigt, was eine flexible und anpassbare Darstellung ermöglicht. Die Produkte für den Product-Teaser können selbst gewählt werden, in dem die gewünschten Produktnummern in das Feld „Produktliste“ als komma-separierte Liste eingetragen werden. Bitte beachte, dass die eingegebenen Produktnummern nicht automatisch auf Richtigkeit überprüft werden. Wenn also in der Storefront keine Anzeige des gewünschten Produktes erfolgt, dann muss die Eingabe der Produktnummern nochmals überprüft werden. Zusätzlich kann, wenn gewünscht, eine Überschrift für den Teaser hinzugefügt werden, um dem Kunden zu verdeutlichen, welche Produkte er unter dem Teaser-Bereich findet.

​

Link Helper

Eine der Standard-Komponenten in Strapi ist darauf ausgelegt, das Hinzufügen von Verlinkungen zu erleichtern. Hierfür stehen vier Linktypen zur Verfügung, die flexibel genutzt werden können, um unterschiedliche Arten von Links zu erstellen:

• Product:
  • Im Feld “Link” muss die Produktnummer angegeben werden - Strapi generiert daraufhin automatisch einen Link, der direkt zur Detailseite dieses Produkts führt.
• Category:
  • Im Feld “Link” muss ein Kategorie-Index eingetragen werden.. Der Link führt den Nutzer dann direkt zur entsprechenden Kategorieseite, wo alle Produkte dieser Kategorie aufgelistet sind.
• Internal:
  • Für interne Verlinkungen innerhalb des Onlineshops können spezifische Pfade oder Routen angeben werden, die zu anderen Seiten oder Ressourcen innerhalb des Online-Shops führen.
• External:
  • Dieser Linktyp ermöglicht es, eine externe URL einzugeben. Diese Option wird genutzt, um Besucher auf andere Websites zu leiten, die nicht zum eigenen Shop gehören.

​

Meta-Information

Meta-Informationen sind entscheidend für die Suchmaschinenoptimierung (SEO) des Online-Shops. In Strapi können diese Informationen gezielt für jede Seite festgelegt werden, um die Sichtbarkeit und Auffindbarkeit in Suchmaschinen zu verbessern.

• Meta Titel
  • Der Meta-Titel ist ein kritischer SEO-Faktor und erscheint im Browser als Tab-Name sowie in den Suchergebnissen als Überschrift des Eintrags.
  • Gib den Titel der Seite ein, der präzise das Thema oder den Inhalt der Seite widerspiegelt.
• Meta Beschreibung
  • Die Meta-Beschreibung bietet eine kurze und prägnante Zusammenfassung des Seiteninhalts. Diese Beschreibung erscheint unter dem Titel in den Suchergebnislisten, z.B. von Google und kann die Klickrate beeinflussen.
  • Formuliere eine ansprechende Beschreibung, die den Inhalt der Seite effektiv zusammenfasst und zum Klicken einlädt.
• SEO-URL
  • Die SEO-URL ist die Adresse, unter der die Seite aufrufbar sein wird. Sie sollte sprechend und SEO-freundlich sein.
  • Standardmäßig wird die URL mit cms/ beginnen. Für spezielle Anforderungen oder zusätzliche Verzeichnisse steht Ihr WEBSALE Ansprechpartner zur Verfügung. Die Systemadministration wird notwendige Anpassungen vornehmen und die Verzeichnisse entsprechend einrichten.
• Meta Robots
  • Das Meta Robots Tag steuert das Crawling- und Indexierungsverhalten der Suchmaschinen für die Seite.
  • Es kann zwischen verschiedenen Anweisungen wie index, follow, noindex, follow, index, nofollow und noindex, nofollow gewählt werden, um zu steuern, ob und wie Suchmaschinen die Seite indexieren und verlinken.
  • Für eine detaillierte Erklärung der verschiedenen Meta Robots Tags empfehlen wir, den Google-Leitfaden zur Steuerung des Crawlings und der Indexierung zu konsultieren: https://developers.google.com/search/docs/crawling-indexing/robots-meta-tag?hl=de

​

Responsive Image

Die “Responsive Image”-Komponente ermöglicht es, Bilder so anzulegen, dass sie optimal auf verschiedenen Bildschirmgrößen dargestellt werden. Diese Komponente unterstützt die Definition von Bildern für verschiedene responsive Breakpoints, wodurch sichergestellt wird, dass der Shop auf allen Geräten gut aussieht. Responsive Breakpoints sind spezifische Bildschirmbreiten, bei denen das Layout der Website sich ändert, um eine bessere Benutzererfahrung zu bieten. Diese sind in vielen CSS-Frameworks wie Bootstrap definiert. Für eine detaillierte Erklärung der Breakpoints im Framework “Bootstrap” besuche Bootstrap Breakpoints. Weise jedem Breakpoint eine passende Bilddatei zu. Typische Breakpoints umfassen Größen für XS (extra small), SM (small), MD (medium), LG (large) und XL (extra large). Das Bild, das im Feld XS eingetragen wird, dient als “Fallback”. Sollte für einen größeren Breakpoint keine spezifische Bilddatei hinterlegt sein, wird automatisch das Bild aus dem XS-Feld angezeigt.

​

WS Subshop Locale

Der Baustein „WS Subshop Locale“ ist speziell dafür entwickelt, um eine Verbindung zwischen den in Strapi hinterlegten Sprachlokalisationen (Locales) und den damit korrespondierenden WEBSALE Subshops herzustellen. Dies ermöglicht eine gezielte Steuerung von sprachspezifischen Inhalten für verschiedene Subshops.

• wsSubshopId:
  • In diesem Feld wird die ID der Subshops eingetragen, die der jeweiligen Sprachvariante zugeordnet sind. Dies dient der Zuordnung von sprachspezifischen Inhalten zu den entsprechenden Subshops.
• strapiLocaleId:
  • Hier wird die spezifische Locale-ID eingetragen, die in Strapi verwendet wird, um die Sprache zu definieren. Dies ist besonders wichtig, um sicherzustellen, dass der richtige sprachliche Inhalt den entsprechenden Subshops zugeordnet wird.

So kann beispielsweise der Eintrag für die Sprachevariante / Locale “Deutsch (de)” folgendermaßen aussehen:

---

​

Erstellen neuer Komponenten

Das Beispiel beschreibt das Erstellen einer Komponente namens “Stellenanzeige”. Diese Komponente soll später folgende Inhalte in der Storefront anzeigen:

• Titel (Datenfeld des Datentyps: Text)
• Anforderungen (Datenfeld des Datentyps: Text)
• Taetigkeitsbeschreibung (Datenfeld des Datentyps: Text)
• Wir_Bieten (Datenfeld des Datentyps: Text)
• Schlussformel (Datenfeld des Datentyps: Text)
• Gehalt (Datenfeld des Datentyps: Zahl)
• Datum (Datenfeld des Datentypes: Datum)
• Adresse (Datenfeld des Datentyps: Text)
• Mail_Ansprechpartner (Datenfeld des Datentyps: E-Mail)\

​

Komponente im Content-Type Builder erstellen

• Öffne im Strapi Admin Dashboard den Content-Type Builder im linken Seitenmenü
• Wähle im Untermenüpunkt Komponenten die Option + Neue Komponente erstellen
• Vergib einen Anzeigenamen, wähle oder erstelle eine Kategorie und vergib ein Symbol für die Komponente, falls gewünscht
• Klicke auf Weiter

​

Aufbau der Komponente definieren und Felder erstellen

• Für jedes Detail (Titel, Anforderungen, Datum, Gehalt) kannst entschieden werden, ob ein separates Datenfeld (z. B. Text, Datum, Zahl) oder eine Textarea benötigt wird, in der alle Informationen gleichzeitig eingegeben werden können
• Erstelle das erste Feld für die Komponente und wähle bei der Erstellung einen Datentyp, z.B. Datentyp “Text” für das Feld “Titel”
• Ein Datentyp in Strapi definiert die Art der Daten, die ein Feld aufnehmen kann. Beispiele sind “Text” für Textzeilen, “Datum” für Datumsangaben und “Zahl” für numerische Werte. Jeder Datentyp bestimmt, wie die Daten im System verarbeitet und angezeigt werden.
• Mehr Informationen zu den “Datentypen” befinden sich in der strapi Dokumentation.
• Vergib dann einen Namen für dieses Feld und konfiguriere zusätzliche Optionen, die je nach Datentyp verfügbar sind.
• Speichere das Feld mit “Fertig” oder erstelle direkt im Dialogfenster weitere Felder. Fahre so fort, bis alle benötigten Felder für die “Stellenanzeige” angelegt sind.

​

Komponente in Inhaltsseiten integrieren

• Wähle im Menüunterpunkt “Sammlungen” die “Inhaltsseiten”
• Wähle eine Inhaltsseite aus, die zukünftig die Komponente “Stellenanzeige” beinhalten soll
• Drücke innerhalb des Feldes “Content” auf “Komponente hinzufügen” und wähle “Bereits existierende Komponente nutzen”
• Wähle im Dropdown-Menü die neue Komponente “Stellenanzeige”.
• Drücke auf “Fertig” und speichere die Änderungen.
• Wiederhole den Vorgang für jede Seite, auf der die Komponente “Stellenanzeige” verwendet werden soll.

Unter “Content” → “Komponente hinzufügen” öffnet sich das Auswahlfenster für das hinzufügen der neuen Komponente. In der Auswahlliste muss die neue Komponente ausgewählt werden.

​

Shop-Template und Design Anpassungen

• Informiere den Template-Manager deines Onlineshops über die neu erstellte Komponente “Stellenanzeige”.
• Besprecht gemeinsam, wie die neue Komponente aufgebaut sein soll und wie sie visuell gestaltet werden soll, damit sie in das bestehende Design des Onlineshops passt.
• Der Designer passt die Templates entsprechend an, um die Daten aus der neuen Komponente richtig darzustellen.

​

1.2.5. Überprüfung und Freigabe

• Nachdem die Komponente erstellt, zugewiesen und die Templates angepasst wurden, kann die Änderungen auf der bearbeiteten Seite angesehen werden. Stelle sicher, dass alles wie erwartet funktioniert und visuell ansprechend ist.

​

1.2.6. Wichtiger Hinweis beim Erstellen von Komponenten

• Komponenten sollten gründlich geplant und ausgeklügelt sein, bevor sie produktiv genutzt werden. Abstimmungen, mit dem Template-Manager oder Designer und ausführliche Überlegungen zum Aufbau sind entscheidend, um eine Komponente richtig zu gestalten und zukünftige Anpassungen zu minimieren. Weitere Informationen für Template-Manager befinden sich hier.
• Sei dir bewusst, dass das Bearbeiten oder Löschen von Komponenten in laufenden Projekten zu unerwarteten Verhaltensweisen oder Fehlern führen kann.

---

​

Komponenten bearbeiten

​

Bestehende Komponente bearbeiten

• Wähle im linken Menü „Content-Type Builder“. Dieser Bereich ermöglicht es, die Strukturen der Daten in Strapi zu definieren und anzupassen.
• Unter dem Menüpunkt „Komponenten“ ist eine Liste aller angelegten Komponenten dargestellt. Wähle die Komponente aus, die bearbeitet werden soll.
• Um sie im Admin-Panel leichter identifizierbar zu machen, können der Anzeigename und das Icon der Komponente bearbeitet werden.
• Es ist möglich, Felder zu einer bestehenden Komponente hinzuzufügen, zu bearbeiten oder zu entfernen. Diese Flexibilität erlaubt es, Komponenten entsprechend neuen Anforderungen anzupassen.
• Damit die Änderungen an den Komponenten später im Shop dargestellt werden, sollte ein Template-Manager bzw. Designer immer die Shop-Templates überprüfen. Gegebenenfalls sind Änderungen erforderlich. Weitere Informationen für Template-Manager befinden sich hier.

​

Hinweise & Tipps beim Bearbeiten von Komponenten

• Obwohl Strapi im “Develop” Modus ausgeliefert wird, der das Anlegen und Bearbeiten von Komponenten zulässt, sollte das ständige Anpassen bestehender Komponenten, die bereits in der Produktion genutzt werden, vermieden werden. Strapi ist prinzipiell nicht dafür ausgelegt, dass Komponenten, die schon mit Daten befüllt und in Gebrauch sind, fortlaufend geändert werden.
• Wichtig zu erwähnen ist, dass das Bearbeiten oder Löschen von Komponenten in laufenden Projekten zu unerwarteten Verhaltensweisen oder Fehlern führen kann. Insbesondere das Löschen von Komponenten kann schwerwiegende Auswirkungen haben, wenn diese bereits häufig genutzt werden.

---

​

Arbeiten mit Komponenten

​

Beschreibung für Komponenten

Zur Optimierung der Übersichtlichkeit über die Komponenten der Seite besteht an dieser Stelle die Möglichkeit, eine Beschreibung in das Feld “Beschreibung” einzugeben.

​

Design der Komponenten

​

Ergänzende CSS-Klassen für Komponenten

Jede Komponente in Strapi bietet die Möglichkeit, spezifische CSS-Klassen zuzuweisen. Diese Klassen ermöglichen es, das Aussehen der Komponenten anzupassen und visuell in das Gesamtdesign des Shops zu integrieren. Die zugewiesenen CSS-Klassen müssen in den CSS-Dateien deines Shops hinterlegt sein. Detaillierte Anleitungen zum Erstellen und Verwalten dieser CSS-Dateien befinden sich in der WEBSALE Dokumentation. Dort wird beschrieben, wie und wo CSS-Dateien für den Shop hinterlegt werden können, um eine nahtlose Integration und ein kohärentes Design zu gewährleisten.

​

Grundlegendes Design der Komponenten

Während innerhalb von Strapi-Komponenten stilistische Anpassungen mittels CSS-Klassen vorgenommen werden können, wird das grundlegende Design der Inhalte hauptsächlich über die Shop-Templates definiert. Wenn grundsätzliche Änderungen am Design der durch Strapi bereitgestellten Inhalte gewünscht sind, sollten diese Änderungen direkt an den Shop-Templates vorgenommen werden, auf denen die Strapi-Inhalte platziert werden. Dies umfasst Änderungen an Layouts, Farbschemata, Schriftarten und anderen Designelementen, die das Erscheinungsbild des Online-Shops prägen. Für detaillierte Informationen darüber, wie und wo diese Shop-Templates bearbeitet werden können, verweisen wir erneut auf die WEBSALE Dokumentation. Dort finden sich ausführliche Anleitungen und Hilfestellungen, die durch den Prozess der Template-Anpassung führen und sicherstellen, dass Designänderungen effektiv und konsistent umgesetzt werden.

​

Effektive Kombination von Komponenten und Sammlungen

Die Verwaltung von Inhalten in Strapi kann effizienter gestaltet werden, indem Komponenten und Sammlungen kombiniert werden. Dieses Vorgehen minimiert den Pflegeaufwand und sorgt für Konsistenz über verschiedene Seiten hinweg.

​

Komponenten und ihre direkte Nutzung

Zunächst wird eine Komponente “Stellenanzeige” im Content-Type Builder erstellt. Diese Komponente enthält Felder wie Bezeichnung, Beginn und Gehalt. Die Komponente kann direkt auf einer spezifischen Inhaltsseite, wie z.B. einer Karriere-Seite, verwendet werden. Dort werden die spezifischen Daten der Stellenanzeigen manuell eingetragen. Wenn dieselbe Komponente “Stellenanzeige” auch auf einer anderen Seite, wie “Über uns”, genutzt werden soll, müssen die gleichen Daten erneut manuell eingefügt werden. Dies führt zu einem doppelten Pflegeaufwand und erhöht das Risiko von Inkonsistenzen.

​

Komponenten in Sammlungen nutzen

Um das Problem des doppelten Pflegeaufwands von Komponenten mit gleichem Inhalt, z.B. Stellenanzeigen, zu lösen, wird zusätzlich eine Sammlung “Stellenanzeigen” erstellt, in der alle aktuellen Stellenanzeigen zentral verwaltet werden. Jede Stellenanzeige wird als ein Eintrag in dieser Sammlung angelegt. Die Sammlung “Stellenanzeigen” kann dann als Ganzes auf verschiedenen Seiten wie “Karriere” und “Über uns” eingebunden werden. Änderungen an einer Stellenanzeige innerhalb der Sammlung wirken sich automatisch auf alle Seiten aus, auf denen die Sammlung eingebunden ist. Dies gewährleistet, dass die Informationen auf allen Seiten konsistent und aktuell sind, ohne dass jede Seite einzeln angepasst werden muss. Es reduziert den Pflegeaufwand und minimiert Fehlerquellen.

​

Transfer von Komponenten zwischen WEBSALE Strapi Instanzen

Strapi ermöglicht es, fertige Komponenten zwischen verschiedenen Instanzen, die von WEBSALE installiert worden sind, zu transferieren. Dieser Prozess erleichtert die Wiederverwendung von entwickelten Komponenten und sorgt für Effizienz und Konsistenz über verschiedene Projekte hinweg.  

• Zugriff auf die empfangende Instanz: Öffne auf der empfangenden Instanz den Pfad <RECEIVING_CMS_URL>/api/component-creator. Diese URL führt direkt zum API-Endpunkt, der für den Transfer von Komponenten zuständig ist. Folge den Anweisungen im Feld “Authenticate”. Gebe hierfür die Common-ID ein, mit welcher die URL der WEBSALE Strapi Instanz gebildet wird.
• Authentifizierung: Authentifiziere dich mit den API-Zugangsdaten. Dies bestätigt deine Berechtigung, Änderungen vorzunehmen und auf die Liste der Komponenten zuzugreifen. Die API-Zugangsdaten, die für den Transfer benötigt werden, entsprechen den initialen Zugangsdaten der Strapi Instanz.
• Auswahl der Komponente: Die empfangende Instanz zeigt eine Liste der verfügbaren Komponenten. Wähle die Komponente aus, die transferiert werden sollen. Eine Vorschau des Schemas dieser Komponente wird zur Überprüfung angezeigt.
• Transfer der Komponente: Wähle unter „Transfer“ die zugehörige Komponentengruppe aus, in der die Komponente gespeichert werden soll, oder erstelle eine neue Gruppe für bessere Organisation im Dashboard. Drücke auf „Transfer“, um die Komponente zur empfangenden Instanz zu senden.
• Automatische Erstellung und Speicherung: Das Schema der ausgewählten Komponente wird automatisch an einen neuen API-Endpunkt der empfangenden Instanz gesendet. Dort wird eine identische Komponente mit demselben Schema automatisch angelegt und gespeichert.
• Neustart der Anwendung: Aufgrund der Änderungen in den src/ Dateien wird die Strapi Instanz automatisch im Hintergrund neu gestartet. Die Instanz ist nach dem Neustart innerhalb weniger Sekunden wieder erreichbar.
• Überprüfung: Nach dem Neustart steht die neue Komponente im Dashboard der empfangenden Instanz zur Verfügung. Überprüfe, ob die Komponente korrekt angelegt wurde und funktionsfähig ist.

 

---

​

Sammlungen & Einzel-Einträge

​

Neue Sammlung oder neuen Einzel-Eintrag erstellen

Um unterhalb der Bereiche Sammlungen oder Einzel-Einträge neue Punkte zu erstellen, muss ein neuer Content-Typ erstellt werden.

​

Neue Sammlung oder neuen Einzel-Eintrag erstellen

• Im Content-Type Builder kann man Content-Typen anlegen, ihre Felder definieren und Schemata festlegen, die bestimmen, welche Art von Daten gehalten und wie diese strukturiert werden.
• Es kann gewählt werden, ob man einen Content-Typ unter Sammlungen (Collection Types) oder Einzel-Einträgen (Single Types) erstellen möchtest. Dafür stehen die Buttons “+ Neue Sammlung erstellen” oder “+ Neuen Einzel-Eintrag erstellen” zur Verfügung.
• Gib dem Content-Typ einen aussagekräftigen Namen und definiere englische API-Endpunkte. Zum Beispiel könnte für den Content-Typ “Stellenanzeigen” der singulare API-Endpunkt “job-ad” und der plurale API-Endpunkt “job-ads” gewählt werden.

• Nachdem alle Einstellungen vorgenommen wurden, speichere diese.
• Neue Content-Typen werden automatisch übertragen. Damit das json-File erzeugt wird, müssen für diese neuen Content-Typen vor der ersten Übertragung entsprechende Berechtigungen gesetzt werden.
  Dies funktioniert wie folgt:
  • Navigiere zu Einstellungen > NUTZER- & BERECHTIGUNGEN-PLUGIN > Rollen > Authenticated
  • Nun erscheint eine Liste der erstellten Content-Typen. Klappe per Klick deinen neu erstellten
    Content-Typ auf.
  • Hier klickt man nun auf die Checkbox “Alles auswählen“ damit dem Content-Typ alle nötigen Rechte gewährt werden.
  • Bestätige deine Änderungen über “Speichern”.

• Die Namensgebung für die JSON-Dateien erfolgt hier über zwei Wege.
  • Ist im Content-Typ ein Feld mit dem Namen “TemplateName” enthalten, so lautet der Name der JSON-Datei so wie der Wert der in diesem Feld gespeichert wird.
  • Ist kein Feld mit diesem Namen enthalten, so lautet der Name der JSON-Datei bei
    Sammlungen: <technischer Plural-API-Name des Content-Typs>_<id des eintrags>.json
    Einzel-Einträgen: <technischer Single-API-Name des Content-Typs>.json

​

Nutzung im Content-Manager am Beispiel “Sammlungen”

Im Content-Manager erfolgt die Verwaltung und Bearbeitung der Inhalte der neu angelegten Sammlung und/oder Einzel-Einträge basierend auf den vordefinierten Content-Typen. Es besteht die Möglichkeit, Inhalte entsprechend der festgelegten Regeln hinzuzufügen, zu bearbeiten oder zu löschen.

• Wähle im Content-Manager die neu hinzugefügte Sammlung aus.
• Wähle „Komponente“ und dann „Bereits existierende Komponente nutzen“.
• Im Dropdown-Menü „Komponente auswählen“, wähle die gewünschte Komponente aus, z.B. „Kontakt“.
• Bestimme, ob die Komponente wiederholbar sein soll, um dynamische Inhalte wie mehrere Ansprechpartner zu ermöglichen.
• Im Content-Manager können über „+ Neuer Eintrag“ weitere hinzugefügt werden.
• Fülle die Felder aus und speichere den neuen Eintrag.
• Informiere den Template-Manager, um festzulegen, wie und wo die neuen Sammlungsdaten auf der Website angezeigt werden sollen.