Widget konfigurieren

Alle fachlichen Einstellungen liegen im Dashboard. Das HTML-Element hat keine Attribute für Kurse, Filialen, Design oder Analytics. Besuchende sehen im Widget keine Filterleiste.

Erlaubte Domains

Erlaubte Domains erwartet vollständige HTTPS-Origins ohne Pfad, Query oder Platzhalter, zum Beispiel https://www.beispiel.de. Höchstens 20 Einträge. HTTP ist nur für lokale Entwicklung (localhost, 127.0.0.1, [::1]) zulässig.

Dashboard	Wirkung
Liste leer	Das Widget darf auf jeder Website laden.
Origin eingetragen	Die Browser-`Origin` muss exakt übereinstimmen, sonst antwortet die API mit `ORIGIN_NOT_ALLOWED`.

Die Allowlist ist eine zusätzliche Browser-Absicherung. Die Autorisierung kommt weiterhin aus dem serverseitigen Widget- und Kursumfang.

Kurse

Kursauswahl steuert den sichtbaren Umfang:

Wert	Bedeutung
Bestimmte Kurse	nur die ausgewählten, veröffentlichten Kurse. Mindestens ein Kurs. Neue veröffentlichte Kurse kommen nicht automatisch dazu.
Alle veröffentlichten Kurse	neue veröffentlichte Kurse erscheinen automatisch.

Nur Kurse mit dem Status Veröffentlicht und mindestens einem geplanten Termin erscheinen in der Liste. Das Widget zeigt höchstens die nächsten 50 passenden Kurse. Ein Kurs listet verfügbare Termine, höchstens 100 je Kurs; Buchen öffnet die Buchungsseite mit vorausgewähltem Termin. Dort können weitere Termine gewählt werden. Leere Filter zeigen im Widget: „Aktuell sind keine buchbaren Kurse freigegeben.“

Das Widget zeigt je Kurs nur Plätze frei oder Ausgebucht. Kapazität, Buchungszahlen und die genaue Zahl freier Plätze verlassen den Workspace nicht, weder in der Kursliste noch in der Terminliste. Auch die Vorschau im Dashboard zeigt genau diese öffentliche Sicht.

Termine erscheinen nur, solange sie in der Zukunft liegen und den Status Geplant haben. Vergangene Termine eines laufenden Kurses liefert die Widget-API nicht mehr.

Die Adresse einer Filiale erscheint nur, wenn Adresse öffentlich anzeigen für diese Filiale aktiv ist. Sonst steht dort Vor Ort ohne Straße, Postleitzahl, Ort, Filialname und Ortszusatz. Freie Einzeladressen an einem Termin gelten als bewusst veröffentlicht und erscheinen unverändert.

Hat mindestens ein freigegebener Kurs öffentliche Bilder, lädt das Widget die Bilder zusammen mit der Kursliste und zeigt pro Kurs höchstens die ersten 20 in der gespeicherten Reihenfolge. Private Bilder und PDFs werden nie ausgeliefert. Sichtbarkeit, Bildbeschreibung und Reihenfolge pflegst du unter Kurse verwalten.

Durchführungsart und Filialen

Diese Filter gelten immer serverseitig, zusätzlich zur Kursauswahl. Sie sind kein Filter für Besuchende.

Feld	Werte
Durchführungsart	Vor Ort und online, Nur vor Ort, Nur online
Filialen	ohne Auswahl: alle Filialen und freie Einzeladressen. Mit Auswahl: nur die gewählten Filialen.

Ein Widget kann so zum Beispiel nur Studio-A-Kurse oder nur Online-Termine ausspielen, ohne den Embed-Code zu ändern.

Datenschutzarme Nutzung

Datenschutzarme Nutzung zählt anonyme Ereignisse pro Widget, etwa geladen und Buchung gestartet (Klick auf Buchen). Es gibt keine Cookies, Personenprofile, E-Mail-Adressen, IP-Adressen oder Referrer.

Die Host-Seite muss dafür nichts konfigurieren.
Die Dashboard-Vorschau erzwingt Messung aus.
Das Limit der Widget-API (120 Anfragen / 60 Sekunden) bleibt davon getrennt.

Rate-Limit

Die lesende Widget-API ist auf 120 Anfragen pro 60 Sekunden je Widget begrenzt. Ein normaler Ladevorgang ruft Kursliste, Serientermine und Bildangaben gemeinsam in einem Manifest ab. Überschreitung liefert RATE_LIMITED und die Meldung „Das Widget wurde zu häufig aufgerufen. Bitte versuche es später erneut.“

Was nicht ins HTML gehört

Nicht als Attribute, Query oder JavaScript-Option setzen:

Workspace-ID oder Organisations-Slug
Kurs-IDs, Filial-IDs, deliveryMode
Design-Token, Farben, Schriften
Analytics-Schalter
Teilnehmerdaten

Diese Werte kommen aus dem Dashboard. Die Buchung selbst liegt auf der öffentlichen Buchungsseite.