Das Ferienprogramm in die Website der Kommune einbinden
Elmsbrück hat eine eigene Website, und dort sollen Familien das Ferienprogramm finden. Die IT der Kommune will die Angebote außerdem in ihren Veranstaltungskalender übernehmen. Angebote und Anmeldung bleiben dabei auf der fepli-Website, der öffentlichen Website Ihrer Instanz. Sie richten dort die Saisonseite ein und lassen die Website der Kommune darauf verlinken. Für die IT bereiten Sie die API vor, die Schnittstelle, über die Programme Daten von fepli abrufen. Sie brauchen etwa 30 Minuten.
Was Sie brauchen
- Ein Konto mit der Kontoart Admin. Für Schritt 5 brauchen Sie zusätzlich die Rolle Super-Admin.
- Die Saison
Sommerferien 2027, deren Phase Angebote veröffentlichen gerade läuft. - Ein veröffentlichtes Angebot mit der Sichtbarkeit Öffentlich auf der Website, z. B. die
Kanutour. - Eine fepli-Website. Ihre Instanz hat eine, wenn in der Seitenleiste des Admin-Panels Website steht.
- Die Person, die die Website der Kommune pflegt, und die IT der Kommune.
Schritt 1 – Einen Begrüßungstext für die Saisonseite schreiben
Jede Saison hat auf der fepli-Website eine eigene Seite mit ihren Angeboten, die Saisonseite. Auf sie verlinkt später die Website der Kommune, und ein Begrüßungstext über der Angebotsliste empfängt die Familien von dort. Die Seite Website der Saison ändert nur die fepli-Website, nicht die Website der Kommune.
- Öffnen Sie in der Seitenleiste unter Saisons die Saison
Sommerferien 2027und wechseln Sie zum Reiter Bearbeiten. - Öffnen Sie links die Seite Website.
- Geben Sie unter Begrüßungstext 2 bis 3 Sätze ein, z. B.
Willkommen beim Ferienprogramm von Elmsbrück. Fragen beantwortet das Team unter ferienpass@example.org.Überschriften, Fett und Listen setzen Sie mit den Knöpfen über dem Feld. - Bestätigen Sie mit Speichern.
Die Meldung „Änderungen gespeichert“ erscheint. Auf der fepli-Website steht Ihr Text über der Angebotsliste.
Schritt 2 – Die Saisonseite öffnen und ihre Adresse kopieren
Auf die Adresse der Saisonseite verlinkt die Website der Kommune. Wer die fepli-Website direkt aufruft, findet die Saison im Menü unter Angebote, solange ihre Phase Angebote veröffentlichen läuft. Vorher zeigt die Adresse, wann die Angebote erscheinen, danach eine Fehlerseite.
- Öffnen Sie in der Seitenleiste Website.
- Wählen Sie auf der fepli-Website Menü und unter Angebote
Sommerferien 2027. - Kopieren Sie die Adresse aus der Adresszeile des Browsers.
Sie sehen die Saisonseite mit Ihrem Begrüßungstext über der Angebotsliste. Die Adresse endet mit /sommerferien-2027, dem Alias der Saison.
Schritt 3 – Den Link zu einem Angebot kopieren
Für eine Meldung auf der Website der Kommune, z. B. über die Kanutour, verlinken Sie das Angebot direkt. Der Link gilt weiter, auch wenn sich der Titel ändert. Bei einem Angebot, das nicht öffentlich ist, kopiert Link kopieren den privaten Link, deshalb braucht dieser Schritt die Sichtbarkeit Öffentlich auf der Website.
- Öffnen Sie Angebote und dort die
Kanutour. - Wählen Sie im Kopf des Angebots Link kopieren.
Die Meldung „Link kopiert“ erscheint. Der Link beginnt wie die Adresse der Saisonseite und endet mit einer Kennung und dem Titel des Angebots.
Schritt 4 – Die Links auf der Website der Kommune einsetzen
Für die meisten Kommunen genügt ein Link. Familien melden sich ohnehin auf der fepli-Website an, und dort stehen immer die aktuellen freien Plätze, Termine und Absagen. Die Redaktion der Kommune muss nichts nachpflegen.
- Schicken Sie der Redaktion der Kommunen-Website die Adresse der Saisonseite und den Link zur Kanutour.
- Bitten Sie die Redaktion, auf der Seite zum Ferienprogramm auf die Saisonseite zu verlinken, z. B. mit dem Linktext
Angebote der Sommerferien 2027 ansehen. - Vereinbaren Sie mit der Redaktion, dass sie den Link zum Ende der Phase Angebote veröffentlichen entfernt.
Auf der Website der Kommune führt der Link jetzt auf die Saisonseite, und Familien melden sich von dort aus auf der fepli-Website an.
Schritt 5 – Den öffentlichen Zugriff auf die API prüfen
Die API lohnt sich, wenn die Kommune die Angebote selbst zeigen will, etwa in ihrem Veranstaltungskalender oder in der Suche ihrer Website. Wer die API ohne Anmeldung abfragt, bekommt genau die Angebote, die auch auf der fepli-Website stehen. Dieser öffentliche Zugriff ist ab Werk eingeschaltet, doch ein Super-Admin kann ihn abgeschaltet haben.
- Öffnen Sie Einstellungen, wechseln Sie zu App-Store und öffnen Sie die Karte API.
- Wenn die App „Ausgeschaltet.“ zeigt, wählen Sie Einschalten und öffnen Sie die Karte API erneut.
- Kopieren Sie die Adresse unter Endpunkt.
- Wenn Öffentlicher Zugriff ausgeschaltet ist, aktivieren Sie den Schalter und bestätigen Sie mit Speichern. Sonst schließen Sie die App mit Abbrechen.
Die Karte API zeigt Eingeschaltet, und Öffentlicher Zugriff ist an. Abfragen ohne Anmeldung liefern jetzt dieselben Daten, die auf der fepli-Website stehen.
Schritt 6 – Die IT der Kommune anleiten
Die technische Anleitung für die IT steht bei den fepli developers. Dort steht auch, warum die IT die Angebote auf ihrem Server zwischenspeichert: Ohne Anmeldung beantwortet fepli höchstens 5 Abfragen je Stunde und IP-Adresse. Die Anmeldung zu einem Angebot bleibt auf der fepli-Website, und jedes Angebot im Kalender verlinkt auf seine Seite dort.
- Schicken Sie der IT die Adresse unter Endpunkt und die Anleitung Angebote auf Ihrer Website.
- Nennen Sie der IT den letzten Teil der Adresse der Saisonseite,
sommerferien-2027. Damit grenzt sie die Angebote auf die Saison ein.
Die IT hat jetzt alles, um die Angebote der Saison Sommerferien 2027 im Veranstaltungskalender der Kommune zu zeigen.
Was Sie erreicht haben
Die Saisonseite auf der fepli-Website begrüßt Familien und steht im Hauptmenü, solange die Phase Angebote veröffentlichen läuft. Die Website der Kommune verlinkt auf die Saisonseite und auf die Kanutour, und die IT holt die Angebote über die API in den Veranstaltungskalender. Familien melden sich weiterhin auf der fepli-Website an.
Wenn Ihr Fall anders aussieht
- Wenn ein Angebot mehrere Terminvarianten hat, verlinken Sie alle Varianten auf einmal mit Gruppen-Link kopieren: Links und Sichtbarkeit.
- Wenn ein Angebot nur für eine bestimmte Gruppe gedacht ist, verlinken Sie es nicht auf der Website der Kommune: Angebot nur über einen privaten Link anbieten.
- Wenn die Angebote auf der Website der Kommune selbst stehen sollen, ohne dass die IT etwas entwickelt, setzt die Redaktion einen Baustein ein: Die Angebote der Saison auf der Website der Kommune zeigen.
- Wenn die Kommune mehr als die öffentlichen Angebote abfragen will, braucht ihr Programm einen API-Token, also einen eigenen Schlüssel, mit dem es sich ausweist: Ein Helpdesk-Tool über die API anbinden.