Marketplace: Bausteine teilen und installieren
Themes, Blöcke und Layouts anderer Organisationen und von Scorebase finden und installieren, eigene Bausteine veröffentlichen und Code-Bausteine sicher ins Projekt holen.
Worum es geht
Im Marketplace teilen Organisationen Bausteine: Themes, Blöcke und Layouts. Scorebase stellt dort ausserdem eigene, als Von Scorebase gekennzeichnete Bausteine bereit. Sie installieren einen Baustein mit einem Klick in eine Ihrer Umgebungen oder holen ihn samt Code in Ihr Website-Projekt.
Diese Funktion ist nicht in jeder Organisation freigeschaltet. Fehlt der Menüpunkt Marketplace bei Ihnen, wenden Sie sich an Ihre Administratorin oder an den Support.
Voraussetzungen
| Recht | Wofür |
|---|---|
| Zugang zu Sites | Marketplace durchsuchen |
| Bausteine aus dem Marketplace installieren | Bausteine in eine Umgebung installieren |
| Bausteine im Marketplace veröffentlichen | Eigene Themes, Blöcke und Layouts veröffentlichen |
Bausteine finden
Öffnen Sie Marketplace. Oben grenzen Sie ein mit Suchen, Typ (Alle, Themes, Blöcke, Layouts), Nur mit Code und Kategorie. Jede Karte zeigt den Anbieter („von …“ bzw. von Scorebase), die Zahl der Installationen und Kennzeichen:
| Kennzeichen | Bedeutung |
|---|---|
| Von Scorebase | Offizieller Baustein von Scorebase |
| Empfohlen | Von Scorebase hervorgehoben |
| Code | Bringt die Darstellung für die Website mit (per Kommandozeile installierbar) |
| Nur CMS | Enthält nur die Definition für Sites, keinen Code |
Mit Öffnen sehen Sie Details: Beschreibung, Versionen und Änderungen.
Einen Baustein installieren
- Öffnen Sie den Baustein und klicken Sie auf Installieren.
- Wählen Sie die Ziel-Umgebung.
- Bestätigen Sie. Scorebase legt eine eigenständige Kopie in Ihrer Organisation an und meldet „Installiert als …“.
Die Installation überschreibt nichts und löscht nichts. Was danach mit dem Baustein passiert, hängt vom Typ ab:
- Theme: sofort nutzbar. Setzen Sie es unter Theme als Standard, wenn Ihre Website es verwenden soll.
- Block oder Layout: Die Definition ist in Sites, die Redaktion kann den Block einsetzen. Damit die Website ihn darstellt, braucht sie eine Komponente dafür. Bei Bausteinen mit Kennzeichen Code zeigt die Detailseite unter Code per CLI installierbar den passenden Befehl (Befehl kopieren). Ohne Code baut Ihr Entwickler die Komponente selbst, siehe Eigene Blöcke bauen.
Ein installierter Block ohne Komponente bricht Ihre Website nicht; er wird dort nur nicht angezeigt.
Einen Baustein melden
Verstösst ein Baustein gegen Regeln, klicken Sie auf Melden, wählen einen Grund (Spam, Markenrechtsverstoss, Schädlich, Sonstiges), ergänzen optional Details (optional) und klicken auf Absenden.
Eigene Bausteine veröffentlichen
| Was | Wo |
|---|---|
| Theme | Theme → Im Marketplace veröffentlichen, dann das Theme auswählen |
| Block | Blöcke → Laden-Symbol (Veröffentlichen) in der Zeile des Blocks |
| Layout | Layouts → Laden-Symbol (Veröffentlichen) beim Layout |
Füllen Sie das Formular aus:
| Feld | Hinweis |
|---|---|
| Slug | Kleinbuchstaben, Ziffern und Bindestriche; je Typ weltweit eindeutig |
| Name, Kurzbeschreibung | Erscheinen auf der Karte |
| Ausführliche Beschreibung | Wird als reiner Text angezeigt |
| Kategorie, Tags (kommagetrennt) | Helfen beim Finden |
| Sichtbarkeit | Öffentlich (in Suche) oder Nicht gelistet (nur per Link) |
| Version (X.Y.Z), Änderungshinweise | Z.B. 1.0.0; jede weitere Veröffentlichung braucht eine höhere Version als die letzte |
Klicken Sie auf Veröffentlichen. Bei Layouts werden verwendete eigene Blöcke automatisch mitveröffentlicht; Verweise auf Medien werden entfernt, damit keine eigenen Bilder weitergegeben werden.
Wichtig: Veröffentlichen Sie nur Bausteine, an denen Sie die Rechte haben, und keine Inhalte mit Personendaten.
Für Entwickler: Marketplace per Kommandozeile
Alle Befehle brauchen ein Token mit der Berechtigung Verwaltung.
Installieren in eine Umgebung (wie der Knopf Installieren):
hcms marketplace install --type theme --slug mein-theme --env dev
hcms marketplace install --type bundle --slug restaurant-starter --env dev--type ist bundle (Standard), block, layout oder theme. Ein Bundle ist eine ganze Umgebung als Paket: Theme, Collections, Blöcke, Layouts, Seiten, Menüs, Formulare und Einträge.
Code ins Projekt holen:
hcms marketplace add --list # Bausteine mit Code auflisten
hcms marketplace add --category hero --code-only # gefiltert
hcms marketplace add cool-card # offiziellen Baustein holen
hcms marketplace add partner-hero --trust --push # Baustein eines anderen AnbietersKopiert werden die Komponente (.tsx), die Block-Definition und der Eintrag in registry.tsx; mit --push wird die Definition gleich in Sites übernommen.
Wichtig: Code von anderen Anbietern (nicht Von Scorebase) übernimmt
hcmsnur nach ausdrücklicher Bestätigung oder mit--trust. Ohne Bestätigungsmöglichkeit und ohne--trustbricht der Befehl ab. Zusätzliche npm-Pakete fremder Bausteine werden nur gemeldet, nie automatisch installiert. Prüfen Sie fremden Code, bevor Sie ihn ausliefern.
Bausteine ohne Code brechen bei add mit einem Hinweis auf hcms marketplace install ab.
Veröffentlichen:
hcms marketplace publish --type block --slug preis-tabelle --name "Preis-Tabelle" \
--version 1.0.0 --visibility public
hcms marketplace publish --all --version 1.0.0 # alle Dateien aus cms/blocks
hcms marketplace publish --type bundle --slug mein-starter --name "Mein Starter" --version 1.0.0Mit --code (nur bei Blöcken) wird die Darstellung aus der registry.json Ihres Projekts mitgesendet. --visibility ist unlisted (Standard) oder public. Sie können nur Bausteine Ihrer eigenen Organisation veröffentlichen.
Wenn etwas nicht klappt
| Symptom | Ursache | Lösung |
|---|---|---|
| „Der Marketplace ist für diese Organisation nicht aktiviert.“ | Nicht freigeschaltet | Administratorin oder Support fragen |
| Installieren fehlt | Recht Bausteine aus dem Marketplace installieren fehlt | Recht vergeben lassen |
| Installierter Block erscheint nicht auf der Website | Keine Komponente in der Website | Code per hcms marketplace add holen oder selbst bauen |
| „Dieser Slug ist bereits vergeben“ | Eine andere Organisation nutzt den Slug | Anderen Slug wählen |
| „Version muss grösser als … sein“ | Die Version ist nicht höher als die zuletzt veröffentlichte | Höhere Version eintragen, z.B. 1.0.1 |