fepli
Einrichten und einbindenAdmins

Das Ferienprogramm in die Website der Kommune einbinden

Musterstadt hat eine eigene Website, auf der Familien das Ferienprogramm finden sollen, und die IT will die Angebote in den Veranstaltungskalender der Kommune übernehmen. Angebote und Anmeldung bleiben auf der fepli-Website, der öffentlichen Website Ihrer Instanz. Sie richten dort die Saisonseite ein, lassen die Website der Kommune darauf verlinken und bereiten die Schnittstelle von fepli, die API, für die IT vor. Sie brauchen etwa 30 Minuten.

Was Sie brauchen

  • Ein Konto mit der Kontoart Admin. Für Schritt 6 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 Frontend 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, die von dort kommen. Die Seite Webseite der Saison bezieht sich auf die fepli-Website; die Website der Kommune ändert sich dadurch nicht.

  1. Wählen Sie in der Seitenleiste unter Saisons die Saison Sommerferien 2027.
  2. Wechseln Sie zum Reiter Bearbeiten.
  3. Öffnen Sie links die Seite Webseite.
  4. Geben Sie unter Begrüßungstext 2 bis 3 Sätze ein, z. B. Willkommen beim Ferienprogramm von Musterstadt. Fragen beantwortet das Team unter ferienpass@example.org. Der Text darf Markdown enthalten.

Rechts zeigt die Vorschau „So erscheint die Saison auf der Webseite“ den Namen der Saison und darunter Ihren Text.

Schritt 2 – Die Saison ins Menü der fepli-Website aufnehmen

Familien, die die fepli-Website direkt aufrufen, finden die Saisonseite über einen eigenen Menüpunkt im Hauptmenü. Er erscheint nur, solange die Phase Angebote veröffentlichen läuft, und verschwindet danach von selbst. Über denselben Menüpunkt öffnen Sie die Seite in Schritt 3 selbst und kopieren ihre Adresse.

  1. Aktivieren Sie Zur Seitennavigation hinzufügen.
  2. Wählen Sie unter Einsortieren nach die Seite, hinter der der Menüpunkt stehen soll.
  3. Wählen Sie Speichern.

Die Vorschau zeigt den Namen der Saison jetzt in der Menüleiste hinter der gewählten Seite.

Schritt 3 – Die Saisonseite öffnen und ihre Adresse kopieren

Die Adresse der Saisonseite ist das Ziel, auf das die Website der Kommune verlinkt. Die Saisonseite gibt es nur, solange die Phase Angebote veröffentlichen läuft. Vorher und danach zeigt dieselbe Adresse eine Fehlerseite.

  1. Wählen Sie in der Seitenleiste Frontend.
  2. Wählen Sie im Hauptmenü der fepli-Website Sommerferien 2027.
  3. Kopieren Sie die Adresse aus der Adresszeile des Browsers.

Sie sehen die Saisonseite mit Ihrem Begrüßungstext über der Angebotsliste. Die Adresse der Seite endet mit /o/sommerferien-2027.

Für eine Meldung auf der Website der Kommune, z. B. über die Kanutour, verlinken Sie das Angebot direkt. Der Link bleibt gültig, auch wenn sich der Titel des Angebots ändert. Ist das Angebot nicht öffentlich, kopiert Link kopieren den privaten Link; deshalb setzt dieser Schritt die Sichtbarkeit Öffentlich auf der Website voraus.

  1. Wählen Sie Angebote und öffnen Sie die Kanutour.
  2. 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.

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 braucht dafür nichts nachzupflegen.

  1. Schicken Sie der Redaktion der Kommunen-Website die Adresse der Saisonseite und den Link zur Kanutour.
  2. Bitten Sie die Redaktion, auf der Seite zum Ferienprogramm auf die Saisonseite zu verlinken, z. B. mit dem Linktext Angebote der Sommerferien 2027 ansehen.
  3. 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 6 – Den öffentlichen Zugriff auf die API prüfen

Die API lohnt sich, wenn die Kommune die Angebote selbst darstellen will, etwa in ihrem Veranstaltungskalender oder in der Suche ihrer Website. Ohne Token liefert die API dieselben Angebote wie die fepli-Website und nichts darüber hinaus. Der öffentliche Zugriff ist ab Werk eingeschaltet, ein Super-Admin kann ihn aber abgeschaltet haben.

  1. Wählen Sie Einstellungen.
  2. Wechseln Sie zu Integrationen > API.
  3. Wenn Schnittstelle aktiv ausgeschaltet ist, aktivieren Sie den Schalter und wählen Sie Speichern. Aktivieren Sie im Dialog API-Einstellungen ändern die Bestätigung und wählen Sie Änderung übernehmen.
  4. Wenn Öffentlicher Zugriff ausgeschaltet ist, aktivieren Sie ihn auf dieselbe Weise.
  5. Kopieren Sie die Adresse unter Endpunkt.

Schnittstelle aktiv und Öffentlicher Zugriff sind eingeschaltet. Aufrufe ohne Token liefern jetzt dieselben Daten, die auch auf der fepli-Website stehen.

Schritt 7 – Die IT der Kommune anleiten

Die technische Anleitung steht auf Englisch bei den fepli developers. Sie erklärt auch, warum die IT die Angebote auf ihrem Server zwischenspeichert: Ohne Token beantwortet fepli höchstens 5 Aufrufe je Stunde und IP-Adresse. Die Anmeldung bleibt auf der fepli-Website, und jedes Angebot im Kalender verlinkt auf seine Angebotsseite dort.

  1. Schicken Sie der IT die Adresse unter Endpunkt und die Anleitung Offers on your website.
  2. 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

Wie es weitergeht

Zurück← fepli für Musterstadt einrichtenWeiterTeilnahmebeiträge online mit pmPayment kassieren →