Skip to main content

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 werden die grundlegenden Konzepte und die Architektur von strapi erklärt. Ziel ist es, ein Verständnis dafür zu schaffen, wie strapi als Headless-CMS aufgebaut ist, welche Rolle der API-First-Ansatz spielt und wie Inhalte aus Strapi in den WEBSALE Shop ausgeliefert werden. Damit dient die Seite als Basis, um die weiteren Bereiche der Dokumentation – insbesondere Content-Typen, Komponenten und die Pflege von Inhalten – besser einordnen und sicher anwenden zu können.

​
Grundlagen von strapi

​
Verständnis der Strapi Architektur

In strapi gibt es zwei Hauptbereiche, die für die Verwaltung und Strukturierung von Inhalten zuständig sind: der Content-Manager und der Content-Type Builder. Diese Bereiche ergänzen sich und bieten zusammen ein leistungsstarkes Werkzeugset für Content-Management und -Design.

​
Content-Type Builder & Content-Manager

​
Content-Type Builder: Definition von Strukturen und Komponenten

Dieser Bereich wird verwendet, um die Strukturen zu definieren, in denen die Inhalte später eingeben werden. Hier wird festgelegt, welche Felder und Datentypen die Inhalte haben sollen und die Komponenten erstellt, die dann im Content-Manager gefüllt werden.
  • Strukturen definieren: Der Content-Type Builder wird genutzt, um die Schemata für Sammlungen und Einzel-Einträge zu erstellen und zu bearbeiten. Diese Schemata bestimmen, welche Datenfelder und Datentypen verfügbar sind und wie die Eingabemasken im Content-Manager aussehen.
  • Komponenten gestalten: Eine weitere wichtige Funktion des Content-Type-Builders ist das Erstellen von wiederverwendbaren Komponenten. Diese Komponenten können in verschiedenen Teilen des Projekts genutzt werden und fördern dadurch die Konsistenz und Wiederverwendbarkeit in der Entwicklung.

​
Content-Manager: Verwaltung von Inhalten

Hier werden die Inhalte, die in einem Strapi-Projekt erstellt und gepflegt werden, direkt verwaltet. Dies ist der Ort, an dem Benutzer tatsächlich Inhalte wie Texte, Bilder und andere Medien hinzufügen, die auf der Storefront angezeigt werden.
  • Inhalte verwalten: Im Content-Manager werden alle Inhalte wie Texte, Bilder, Videos und andere Medien, die direkt auf der Storefront sichtbar sind, verwaltet. Benutzer können hier neue Inhalte erstellen, bestehende bearbeiten oder nicht mehr benötigte Inhalte löschen.
  • Daten organisieren: Der Content-Manager ermöglicht das systematische Organisieren von Inhalten in Sammlungen und Einzel-Einträgen. Diese Struktur hilft, Inhalte leichter auffindbar und verwaltbar zu machen und unterstützt eine klare Hierarchie und Ordnung innerhalb des Systems.

​
Zusammenspiel von Content-Manager und Content-Type Builder

Der Content-Manager und der Content-Type-Builder arbeiten Hand in Hand:
  • Vom Builder zum Manager: Im Content-Type-Builder erstellte Strukturen und Komponenten dienen als Grundlage für die Inhaltsverwaltung im Content-Manager. Dies sichert eine kohärente Datenhandhabung und effiziente Content-Verwaltung.
  • Anpassungsfähigkeit und Dynamik: Durch die flexible Struktur des Content-Type Builders können Anpassungen vorgenommen werden, die dann im Content-Manager reflektiert werden, ohne dass Inhalte verloren gehen oder umständlich neu erstellt werden müssen.

​
Sammlungen, Einzel-Einträge und Komponenten

​
Sammlungen

Sammlungen in Strapi sind Strukturen, die dazu dienen, mehrere ähnliche Daten unter einem Dach zu verwalten. Sie eignen sich hervorragend, um Inhaltsseiten, mehrere Stellenanzeigen oder auch Blogartikel zu organisieren. Eine Sammlung fungiert somit als zentraler Punkt, dem sie ähnliche Inhalte oder Elemente unterordnen können. Sammlungen stehen sowohl unter dem Content-Manager, wie auch dem Content-Type-Builder zur Verfügung. Mehr Informationen zu Sammlungen gibt es hier.

​
Einzel-Einträge

Einzel-Einträge sind spezifische Inhalts-Elemente, die nicht unbedingt Teil einer wiederholbaren Sammlung sind. Sie können für spezielle Seiten oder spezifische Inhaltsblöcke verwendet werden, wie zum Beispiel ein Banner oder ein Produktslider auf der Startseite. Einzel-Einträge stehen sowohl unter dem Content-Manager, wie auch dem Content-Type-Builder zur Verfügung. Mehr Informationen zu Einzel-Einträgen gibt es hier.

​
Content-Typen zum Erstellen neuer Sammlungen & Einzel-Einträge

Content-Typen sind die Bausteine für die Strukturierung von Inhalten innerhalb von Strapi. Sie definieren, wie Daten in Sammlungen und Einzel-Einträgen organisiert sind. Neue Content-Typen und somit neue Inhalte unterhalb von Sammlungen und Einzel-Einträgen werden im Content-Type Builder erstellt.
Zum Anlegen neuer Content-Typen wird die Unterstützung eines WEBSALE-Mitarbeiters aus der Systemadministration benötigt. Dieser muss die neuen Content-Typen in der Konfiguration des Strapi-Connectors hinterlegen.

​
Komponenten

Komponenten in Strapi sind wiederverwendbare Bausteine, die in verschiedenen Teilen des Projekts genutzt werden können, um Inhalte konsistent und effizient zu gestalten. Mehr Informationen zu Komponenten gibt es hier.

​
Medienbibliothek

Strapi verfügt über eine integrierte Medienbibliothek, die eine zentrale Verwaltung von Medien wie Bildern, PDFs und anderen Dateien ermöglicht. Alle hochgeladenen Bilder und Dateien werden in der Medienbibliothek gespeichert und können von dort aus verwaltet werden. Dies umfasst das Löschen, Ersetzen oder erneute Verwenden von Medien in verschiedenen Teilen des Strapi-Projekts.

​
Hochladen von Medien

Medien können entweder direkt in die Medienbibliothek hochgeladen oder während der Pflege von Inhalten hinzugefügt werden. Wenn beim bearbeiten von Inhalten Medien benötigt werden, kann auf die Medienbibliothek zurückgegriffen werden. Hier besteht die Möglichkeit, bereits hochgeladene Dateien auszuwählen oder neue Dateien hinzuzufügen.

​
Automatische Bildkonvertierung

Strapi verfügt über einen eingebauten Konverter, der die hochgeladenen Bilder automatisch komprimiert, um die Ladezeiten zu verbessern und den Speicherbedarf zu optimieren. Zusätzlich kommt der WEBSALE Bildkonverter zum Einsatz, der Bilder in das SourceFormat und das WebP-Format umwandelt. Diese Formate bieten verbesserte Kompressionsraten und sind für die Web-Nutzung optimiert.

​
Template-Integration

Der Template-Manager definiert innerhalb des Templates, welches Bild in welchem Format verwendet wird. Neue Bilder und Medienelemente, die zur Medienbibliothek hinzugefügt werden, müssen daher entsprechend den Vorgaben vom Template-Manager im Template platziert und konfiguriert werden. Weitere Informationen für Template-Manager befinden sich hier.

​
Strapi für Subshops erweitern

​
Neue Sprache anlegen

  • Einstellungen → Internationalisierung
  • “Neue Sprache hinzufügen”
  • Sprache auswählen.
  • Anzeigenamen nicht ändern.
  • Locale-ID notieren / kopieren. Bspw. “Französisch (fr) - fr wäre hier die Locale-ID.
  • Speichern.

​
Sprache einem Subshop zweisen

  • Content-Manager → Konfiguration
  • “+ Eintrag hinzufügen” wählen oder einen bestehenden bearbeiten.
  • Unter “WEBSALE Subshop ID” kann nun eine kommaseparierte Liste an Subshop-IDs eingetragen werden.
  • Unter “Strapi Locale ID” muss die im vorherigen Schritt kopierte “Locale-ID” eingefügt werden.
  • Im Anschluss speichern.
Der WEBSALE Strapi Connector beachtet nun automatisch die neue Sprache.
Content, der im Content-Manager für diese Sprache gepflegt wird, wird auf dem Shopserver in die Verzeichnisse für Subshops abgelegt. Jeder Wert (kommasepariert) stellt einen Subshop-Ordner dar.