Dokumentation

Websites

Website-Komponenten, Seiten, Kontexte, Aktivierung und Standard-Presets.

Allgemein

Website-Plugins erweitern den Website-Builder und die Website-Runtime. Sie können Komponenten, Seiten, Kontexte, Styles und Website-Konfigurationen bereitstellen. Im Plugin-Editor erscheint der Bereich Websites, wenn das Plugin passende Website-/WebEmbed-Scopes oder websitefähige MCP/API-Scopes besitzt.

Komponenten

Plugin-Komponenten sind Bausteine für simplebis-Websites. Sie besitzen einen Namen, Code und Properties. Unterstützte Property-Typen sind unter anderem String, Integer, Float, Ja / Nein, Objekt, Array, Datei, Formular und Komponenten.

Komponenten können serverseitig oder clientseitig laufen. Serverseitige Komponenten erhalten Runtime-Hilfen wie api, Übersetzungen, Menüs, Route-Parameter, MCP/API-Zugriff, pluginConfig und den Zugriff auf aktivierte Plugin-Kontexte. Client-Komponenten erhalten serialisierbare Props und können über api.navigate, api.replace, api.refresh und api.pluginConfig mit der Website interagieren.

Seiten

Plugin-Seiten definieren komplette Website-Seiten. Sie besitzen Titel, URL-Pfad, Code, optionale Meta-Daten, Tags und Body-CSS-Klassen. URL-Parameter können im Pfad mit :slug oder [slug] angegeben werden.

Bei neuen Plugins werden für Seiten MCP/API-Scopes und Plugin-Kontexte ausgewählt. Die ausgewählten Kontexte stellen ihre Ergebnisse unter einem Daten-Key bereit, sodass der Seiten-Code mit geladenen Daten arbeiten kann. Plugin-Seiten müssen einen eindeutigen URL-Pfad und einen eindeutigen Titel innerhalb des Plugins besitzen.

Kontexte

Plugin-Kontexte sind serverseitige Datenfunktionen für Seiten und Komponenten. Ein Kontext besitzt einen technischen Key, einen Namen, eine Beschreibung, Parameter, Code und eigene MCP/API-Scopes. Der Code exportiert eine Funktion und liefert Daten zurück.

Beim Aktivieren eines Kontextes auf einer Seite oder Komponente wird ein Ziel-Daten-Key gewählt. Das Ergebnis steht dann unter diesem Key zur Verfügung. simplebis prüft, dass aktive Kontexte nicht denselben Ziel-Key verwenden. Kontext-Ergebnisse werden pro Request gecacht, damit mehrfach verwendete Kontexte nicht unnötig erneut ausgeführt werden.

Aktivierung pro Website

Ein installiertes Website-Plugin wird pro Website unter Webseiten > Website öffnen > Plugins aktiviert. Normale Plugins werden einfach in die aktive Plugin-Liste der Website aufgenommen. Danach stehen Komponenten, Kontexte und Website-Konfigurationen auf dieser Website zur Verfügung.

Website-Preset-Module öffnen beim Aktivieren ein Detailmodal. Dort sieht man Seiten, Komponenten, Styling-Dateien und Kontexte. Seiten werden als Kopien in die Website übernommen und behalten ihre Herkunftsinformation. Bei URL-Konflikten kann die vorhandene Seite verschoben, überschrieben oder die Preset-Seite übersprungen werden. Einzelne Preset-Seiten können später installiert, zurückgesetzt oder entfernt werden.

Styles und Design

Preset- und Plugin-Komponenten können SCSS-Dateien mitbringen. Globale Styles werden automatisch für aktive Presets geladen. Manuelle Styles können an Seiten oder Komponenten ausgewählt werden.

Design-Komponenten können als Basis-Design einer Seite verwendet werden. Wenn ein Preset mehrere Design-Komponenten enthält, wählt der Benutzer beim Aktivieren das gewünschte Basis-Design. Dieses kann auf die kopierten Plugin-Seiten und optional auf bestehende Website-Seiten angewendet werden.

Standard-Presets

Die folgenden eingebauten Website-Preset-Module werden im Plugin-Installer angeboten, sofern sie in der Umgebung noch nicht installiert sind. Aufgelistet sind nur Presets, die Website-Funktionen hinzufügen:

  • Business Basic (website_business_basic): Basis-Design für Dienstleister, Agenturen und lokale Unternehmen. Liefert Layout-, Hero-, Feature- und Kontakt-Komponenten sowie globale und manuelle Styles.
  • Restaurant (website_restaurant_basic): Basis-Design für Restaurants, Cafés und Bars. Liefert Layout-, Hero- und Speisekarten-Komponenten sowie globale und manuelle Styles.
  • Events & Shop (website_events_shop_basic): Design- und Inhaltsbausteine für Ticketseiten, Produktlisten und aktionsorientierte Landingpages. Liefert Layout-, Hero- und Listen-Komponenten sowie Styles.
  • Website Articles Basic (website_articles_basic): liefert Website-Kontexte für Artikelkategorien und Artikellisten. Damit können eigene Seiten oder Komponenten Artikeldaten laden.
  • Website Events Basic (website_events_basic): liefert einen Website-Kontext für Veranstaltungslisten.
  • Website Posts Basic (website_posts_basic): liefert Beitrags- und Beitragskategorie-Kontexte sowie Standardseiten für Beitragsübersicht und Beitragsdetail.
  • Website Shop Improvements (website_shop_improvements): liefert Shop-Standardseiten für Shop-Übersicht, Kategorie, Artikeldetail und Warenkorb, dazu Komponenten für Artikellisten, Filter, Kategorieübersicht, Artikelkarten und Warenkorb-Zusammenfassung sowie Shop-Basisstyles und einen Warenkorb-Kontext.
  • Website Customers Basic (website_customers_basic): liefert Kundenlogin, Registrierung, Account-Aktivierung, Passwort-Reset und Account-Verwaltung als Komponenten und Standardseiten sowie Customer-Basisstyles.

Beispiele

Mit Website-Plugins lassen sich wiederverwendbare Branchen-Templates, Shop-Erweiterungen, Kundenbereiche, dynamische Landingpages, Datenlisten, Custom-Detailseiten oder komplette Funktionspakete für Websites bauen. Presets eignen sich für standardisierte Startpunkte; eigene Plugins eignen sich für kundenspezifische Funktionen, die kontrolliert installiert und pro Website aktiviert werden sollen.