Dies ist eine alte Version des Dokuments!
Minasa HTML-Widget
Einleitung
Kunden ohne eigenes Minasa-System haben mit einem HTML-Widget eine einfache Möglichkeit, Events von einem Minasa-System ohne grosse technische Massnahmen oder Infrastruktur auf der eigenen Webseite darstellen zu können.
Das Widget wird mittels JavaScript-Bibliothek auf der eigenen Webseite eingebunden und baut sich in der Host-Webseite selber ein.
Einbau in Webseite
Der Einbau in die eigene Webseite erfolgt durch Einbinden einer JavaScript-Bibliothek. Diese stellt die Widget-Component als HTML-Tag <minasa-widget></minasa-widget> zur Verfügung.
<!DOCTYPE html> <html> <head> <title>Eigene Webseite</title> </head> <body> <h1>Eigene Seite</h1> <p>........</p> <!-- hier steht nun eine WebComponent zur Verfügung, welche die Widget-Inhalte darstellt: --> <minasa-widget minasa-url="https://www.minasa-system.ch" api-key="aswcsadf" query-mode="next" ></minasa-widget> <!-- Laden der Widget-JavaScript-Library, am Ende des Body-Tags: --> <script src="https://minasa-system.ch/widget/minasa-widget.js" type="module"></script> </body> </html>
Sie benötigen folgende Daten, damit Sie das Widget-System nutzen können:
- die URL zum Minasa-System, ab dem Sie die Event-Daten beziehen möchten (z.B. https://thurgaukultur.ch)
- Einen API-Key für das Widget für dieses Minasa-System. Diesen API-Key erhalten Sie beim technischen Support der jeweiligen Minasa-Instanz.
HTML-Konfigurationsattribute
Die Web-Komponenten <minasa-widget> unterstützt folgende HTML-Attribute für die Konfiguration:
| Attribut | Pflicht | Beispiel | Beschreibung |
|---|---|---|---|
minasa-url | Ja |