HandbuchReferenzAngebote
Einbinden
Unter Einbinden entsteht der Code, mit dem eine andere Website die Angebote einer Saison oder ein einzelnes Angebot zeigt.
Bausteine
Ein Baustein ist ein Stück Code für eine andere Website. Er lädt die Angaben bei jedem Aufruf aus fepli und zeigt deshalb immer den aktuellen Stand.
| Baustein | Ort | Zeigt |
|---|---|---|
| Angebotsliste | Reiter Einbinden der Saison | Die Angebote einer oder mehrerer Saisons als Liste oder Kacheln. Ein Angebot öffnet sich auf der anderen Website in einem Dialog. |
| Anmeldekarte | Reiter Einbinden des Angebots | Bild, Name, Termin, Beitrag und den Knopf Anmelden |
| Angebot mit allen Angaben | Reiter Einbinden des Angebots | Bild, Termine, Alter, Beitrag, Plätze, Treffpunkt und Beschreibung |
| Link zur Anmeldung | Reiter Einbinden des Angebots | Kein Baustein: die Adresse der Angebotsseite mit dem Anmeldeformular |
Ein Baustein zeigt dieselben Angebote wie die Angebotsseiten: veröffentlicht, öffentlich und in einer Saison, die online ist (Links und Sichtbarkeit). Familien melden sich nicht im Baustein an. Anmelden führt auf die Angebotsseite von fepli.
| Voraussetzung | Einstellung |
|---|---|
| Bausteine sind eingeschaltet. | Bausteine für andere Websites ist an (Einstellungen). Solange der Schalter aus ist, fehlt der Reiter Einbinden an Saisons und Angeboten, und Bausteine auf anderen Websites zeigen nichts. |
| Es gibt einen öffentlichen Schlüssel. | Öffentliche Schlüssel (Einstellungen) |
| Familien erreichen die Angebotsseiten. | In Installationen mit Mandanten hat eine Domain den Zweck Öffentliche Website (Einstellungen). Dorthin führt Anmelden, auch wenn der Mandant keine eigene Website pflegt. |
Einbinden an der Saison
Ort: Reiter Einbinden der Saison. Der Reiter ist für Admins sichtbar, solange Bausteine eingeschaltet sind.
beispiel.fepli.eu/admin/saisons/sommerferien-2027/einbinden
F
☀️
Saisons/Sommerferien 2027/EinbindenNeu⌘ ↵
☀️Sommerferien 2027
Angebote
42
ÜbersichtBearbeiten EExportStatistikenEinbinden
Auf anderen Websites zeigen
SaisonsSommerferien 2027Saison hinzufügen
DarstellungListeKacheln
FilterleisteFamilien filtern selbst nach Kategorie und Alter.
Aussehen
Akzentfarbefepli-Rot
EckenEckigWeichRund
SchriftWie die SeiteSystem
Öffentlicher SchlüsselVerwalten →Website ElmsbrückGilt auf elmsbrueck.de
1 · Einmal pro Seite, im <head>
<script type="module" src="https://beispiel.fepli.eu/embed.js" data-key="pk_9f3a2c71e4b05d18a6c2e7f0"></script>
2 · Dort, wo die Liste erscheinen soll
<fepli-offers edition="sommerferien-2027"></fepli-offers>
VorschauBreitSchmal
AlleJedes Alter
Mi., 14. Juli · 09:00KanutourSportverein Elmsbrück · 9–14 Jahre12 Plätze frei12 €
Der Reiter Einbinden der Saison Sommerferien 2027.
| Element | Inhalt | Standard |
|---|---|---|
| Saisons | Die Saison des Reiters. Saison hinzufügen nimmt weitere Saisons in dieselbe Liste auf; archivierte Saisons stehen nicht zur Auswahl. Eine Saison, deren Angebote nicht veröffentlicht sind, trägt „nicht veröffentlicht“. | nur diese Saison |
| Darstellung | Liste oder Kacheln | Liste |
| Filterleiste | „Familien filtern selbst nach Kategorie und Alter.“ | an |
| Aussehen | Akzentfarbe als Farbfeld oder Hex-Wert, mit Zurück zu fepli-Rot; Ecken: Eckig, Weich, Rund; Schrift: Wie die Seite oder System. „Steht als CSS-Variable im Code. Alles andere übernimmt der Baustein von der Seite.“ | fepli-Rot, Rund, Wie die Seite |
| Öffentlicher Schlüssel | Der Schlüssel, der im Code steht. Darunter „Gilt auf {Websites}“. Verwalten führt zu den Einstellungen und ist für Super-Admins sichtbar. | der älteste Schlüssel |
| „1 · Einmal pro Seite, im <head>“ | Der Code, der die Bausteine lädt, mit dem Schlüssel. Code kopieren kopiert ihn. | – |
| „2 · Dort, wo die Liste erscheinen soll“ | Der Code der Angebotsliste mit den gewählten Einstellungen. Code kopieren kopiert ihn. | – |
| Vorschau | Die Angebotsliste mit den Angeboten der Saison und den gewählten Einstellungen; Breit oder Schmal | Breit |
Die Seite speichert nichts. Jede Einstellung steht im Code, und wer die Seite neu lädt, sieht wieder die Standardwerte.
| Zustand | Anzeige |
|---|---|
| Die Angebote der Saison sind nicht veröffentlicht | „Die Angebote dieser Saison sind zurzeit nicht veröffentlicht – der Baustein zeigt nichts.“ |
| Kein öffentlicher Schlüssel | „Noch kein öffentlicher Schlüssel.“ mit „Ein Baustein braucht einen öffentlichen Schlüssel. Er legt fest, auf welchen Websites der Baustein laufen darf.“ |
Zu den Einstellungen der API unter dem Hinweis ist für Super-Admins sichtbar.
Einbinden am Angebot
Ort: Reiter Einbinden des Angebots. Solange Bausteine eingeschaltet sind, ist der Reiter für jedes Konto sichtbar, das das Angebot öffnen darf.
beispiel.fepli.eu/admin/angebote/…/einbinden
F
☀️
Angebote/Sommerferien 2027/Kanutour/EinbindenNeu⌘ ↵
KanutourAngebotsseite ansehen ↗Link kopieren
Status
Veröffentlichtändern
Termin
Mi., 14.07.2027, 09:00
Plätze
12 / 12
Anmeldeschluss
30.06.2027
DetailansichtBearbeiten ETeilnahmelisteZuteilenKorrekturabzugZugriffEinbinden
Link zur Anmeldung
https://beispiel.fepli.eu/o/sommerferien-2027/…Link kopierenÖffnen ↗
Anmeldekarte<fepli-offer-card>
TermineNächsterAlle
Freie Plätze
<fepli-offer-card offer="0192a4f1-6e3b-7c85-b1d2-8f4e6a9c3b03"></fepli-offer-card>
Angebot mit allen Angaben<fepli-offer>
Anmelde-Knopf
<fepli-offer offer="0192a4f1-6e3b-7c85-b1d2-8f4e6a9c3b03"></fepli-offer>
Aussehen
Akzentfarbefepli-Rot
EckenEckigWeichRund
Öffentlicher SchlüsselVerwalten →Website ElmsbrückGilt auf elmsbrueck.deDazu einmal pro Seite das Script mit dem Schlüssel im <head>:
<script type="module" src="https://beispiel.fepli.eu/embed.js" data-key="pk_9f3a2c71e4b05d18a6c2e7f0"></script>
VorschauAnmeldekarteAngebot mit allen Angaben
Sommerferien 2027 · 9–14 JahreKanutourMi., 14. Juli · 09:0012 €12 Plätze freiAnmelden →
Der Reiter Einbinden der Kanutour.
| Element | Inhalt | Standard |
|---|---|---|
| Link zur Anmeldung | Adresse der Angebotsseite an der Stelle des Anmeldeformulars, mit Link kopieren und Öffnen. „Funktioniert überall: Website, E-Mail, Social Media, Aushang. Braucht keinen Schlüssel.“ Nur bei der Sichtbarkeit Öffentlich auf der Website. | – |
| Anmeldekarte | Termine: Nächster oder Alle; Freie Plätze; der Code mit Code kopieren | Nächster, an |
| Angebot mit allen Angaben | Anmelde-Knopf; der Code mit Code kopieren | an |
| Aussehen | Akzentfarbe und Ecken. Gelten für die Anmeldekarte und das Angebot mit allen Angaben. | fepli-Rot, Rund |
| Öffentlicher Schlüssel | Der Schlüssel, der im Code steht. Darunter „Dazu einmal pro Seite das Script mit dem Schlüssel im <head>:“ mit dem Code, der die Bausteine lädt. Eine Seite braucht ihn einmal, auch für mehrere Bausteine. | der älteste Schlüssel |
| Vorschau | Die Anmeldekarte oder das Angebot mit allen Angaben mit den gewählten Einstellungen | Anmeldekarte |
| Zustand | Anzeige |
|---|---|
| Das Angebot ist nicht veröffentlicht, nicht öffentlich oder seine Saison nicht online | „Noch nicht öffentlich sichtbar. Link und Code können Sie schon weitergeben – sie zeigen etwas, sobald das Angebot veröffentlicht ist.“ Statt der Vorschauen steht „Vorschau, sobald das Angebot veröffentlicht ist.“ |
| Kein öffentlicher Schlüssel | Derselbe Hinweis wie an der Saison |
Der Knopf Anmelden eines Bausteins erscheint nur bei Angeboten mit Anmeldung über die Website, die nicht abgesagt sind.
Was eine Website ohne gültigen Schlüssel zeigt
| Fall | Baustein auf der Website |
|---|---|
| Bausteine für andere Websites ist aus | Nichts: Die Website lädt die Bausteine nicht. |
| Der Code enthält keinen Schlüssel | „Die Angebote konnten nicht geladen werden.“ |
| Der Schlüssel ist widerrufen | „Die Angebote konnten nicht geladen werden.“ |
| Die Website steht nicht unter Erlaubte Websites des Schlüssels | „Die Angebote konnten nicht geladen werden.“ |
| Die Saison ist nicht online | „Keine Angebote gefunden.“ |
Die Bausteine beschreiben die fepli developers auf Englisch.