iCalendar und Abonnements

TimelyChurch kann Ihren Gemeindekalender sowohl veröffentlichen (sodass Ihre Website-Besucher und Mitglieder ihn in ihrer persönlichen Kalender-App abonnieren können) als auch andere Kalender importieren (sodass Veranstaltungen aus einem Konfessions-, Partner- oder Gemeinschaftskalender in TimelyChurch erscheinen).

Dieser Artikel behandelt drei eng verwandte, aber unterschiedliche Funktionen:

1. Öffentliche Kalendereinbettung -- Ein iframe-Widget, das Sie auf der Website Ihrer Gemeinde einfügen.
2. Ausgehende iCal-Feeds -- Live-.ics-URLs, die Apple Calendar, Google Calendar und Outlook abonnieren können.
3. Eingehende Kalenderabonnements -- Veranstaltungen aus externen .ics-URLs nach einem Zeitplan in TimelyChurch laden.

Tipp: Für einmalige .ics-Exporte einer einzelnen Veranstaltung, einer einzelnen Serie oder eines Datumsbereichs lesen Sie den Abschnitt iCalendar-Export und -Import. Der Export dort ist ein statischer Schnappschuss. Die Abonnement-Feeds in diesem Artikel bleiben live und aktualisieren sich, wenn sich Veranstaltungen ändern.

1. Öffentliche Kalendereinbettung

Der öffentliche Kalender ist ein eigenständiges Widget, das Sie mit einem iframe auf der Website Ihrer Gemeinde einbetten können. Besucher können alle Ihre öffentlichen Veranstaltungen ohne Konto durchsuchen.

Einbettungs-URL

https://your-app-domain.com/c/{churchSlug}/calendar

Abfrageparameter

Die Einbettung akzeptiert diese optionalen Abfrageparameter, um anzupassen, was Besucher sehen:

Beispiel-Einbettungscode

<iframe
  src="https://your-app-domain.com/c/grace-community/calendar?types=worship,event&view=month"
  width="100%"
  height="700"
  frameborder="0"
  title="Grace Community Calendar">
</iframe>

Was Besucher sehen

Die Einbettung zeigt nur Veranstaltungen an, die sowohl als Öffentlich als auch als Aktiv markiert sind, gefiltert nach dem types-Parameter und dem aktuell angezeigten Datumsbereich. Ein Klick auf eine Veranstaltung öffnet deren öffentliche Detailseite.

2. Ausgehende iCal-Feeds (Von außen abonnieren)

Ihr Gemeindekalender ist als Live-iCalendar-Feed unter zwei URLs verfügbar:

Beide Feeds enthalten Veranstaltungen von einem Monat zurück bis ein Jahr im Voraus, begrenzt auf ausschließlich öffentliche, aktive Veranstaltungen.

In Apple Calendar (macOS / iOS) abonnieren

1. Kopieren Sie die Abonnement-URL Ihrer Gemeinde: https://your-app-domain.com/c/grace-community/calendar.ics
2. Mac: Öffnen Sie Calendar, dann wählen Sie Ablage > Neues Kalenderabonnement.... Fügen Sie die URL ein und klicken Sie auf Abonnieren.
3. iOS: Öffnen Sie Einstellungen > Kalender > Accounts > Account hinzufügen > Sonstige > Abonnierten Kalender hinzufügen. Fügen Sie die URL ein und tippen Sie auf Weiter.
4. Legen Sie das Auto-Aktualisierungsintervall fest (Apple empfiehlt stündlich oder täglich).

In Google Calendar abonnieren

1. Öffnen Sie Google Calendar in einem Browser.
2. Klicken Sie in der linken Seitenleiste unter Andere Kalender auf das +-Symbol und wählen Sie Per URL.
3. Fügen Sie die Abonnement-URL ein: https://your-app-domain.com/c/grace-community/calendar.ics
4. Klicken Sie auf Kalender hinzufügen.

Hinweis: Google Calendar aktualisiert externe .ics-Abonnements nur alle paar Stunden. Erwarten Sie nicht, dass Änderungen in TimelyChurch sofort in Google erscheinen.

Nutzen Sie hierfür einen Computer. Die Google Calendar App auf Android und iPhone kann überhaupt keinen Kalender per URL hinzufügen -- diese Option gibt es nur im Browser. Fügen Sie das Abonnement einmal auf einem Computer hinzu, und es erscheint dann automatisch in der Telefon-App, auf demselben Google-Konto. Das ist der häufigste Grund, warum jemand denkt, das Abonnieren funktioniere nicht: Man tippt auf den Link auf dem Telefon, Google tut nichts, und man lädt stattdessen eine einmalige Datei herunter.

In Microsoft Outlook (Desktop oder Web) abonnieren

1. Outlook im Web: Klicken Sie auf Kalender hinzufügen > Aus dem Web abonnieren. Fügen Sie die Abonnement-URL ein und klicken Sie auf Importieren.
2. Outlook Desktop: Wählen Sie Kalender hinzufügen > Aus dem Internet, fügen Sie die URL ein und klicken Sie auf OK.

Filtern nach Veranstaltungstyp -- nur beim Einbetten

Der in Abschnitt 1 dokumentierte Parameter types gilt für die Einbettungsseite. Er filtert die .ics-Feeds nicht: Ein Abonnement enthält immer jede öffentliche, aktive Veranstaltung im Zeitfenster. Wenn Sie einen gefilterten Feed benötigen, sagen Sie dies in einer Support-Anfrage, statt ?types= an eine Abonnement-URL anzuhängen -- das wird stillschweigend ignoriert.

Jemandem beim Abonnieren helfen

Jeder kann abonnieren. Es ist kein TimelyChurch-Konto und keine Anmeldung erforderlich -- der Feed ist öffentlich, und die Person, an die Sie ihn senden, muss kein Mitglied sein, sich nicht anmelden oder irgendetwas erstellen.

Wenn jemand sagt „es hat nur die Veranstaltungen heruntergeladen, es aktualisiert sich nicht", liegt fast immer einer dieser Gründe vor:

Der Weg, der auf jedem Gerät und in jeder App immer funktioniert: Kopieren Sie die Abonnement-URL am unteren Rand des Abonnement-Kastens und fügen Sie sie in das Feld Kalender hinzufügen / Per URL / Abonnieren der Kalender-App ein.

Änderungen, die Sie in TimelyChurch vornehmen, erreichen Abonnenten nach dem Aktualisierungsplan ihrer App, nicht sofort. Insbesondere Google kann mehrere Stunden brauchen. Das ist ein Verhalten von Google, keine Verzögerung auf unserer Seite.

3. Eingehende Kalenderabonnements (In TimelyChurch laden)

Sie können TimelyChurch auch für einen externen Kalender-Feed abonnieren. Dies ist nützlich, wenn:

• Ein Konfessionsverband einen gemeinsamen Veranstaltungskalender veröffentlicht.
• Eine Partnergemeinde ihren Kalender mit Ihnen teilen möchte.
• Sie möchten, dass ein Gemeinschafts-/Stadtkalender neben Ihrem eigenen erscheint.

Externe Veranstaltungen werden in TimelyChurch importiert und in Ihrem Admin-Kalender angezeigt. Sie können optional auch automatisch in Ihrem öffentlichen Kalender veröffentlicht werden.

Abonnements verwalten

Navigieren Sie im Admin-Bereich zu Einstellungen > Kalenderabonnements.

Ein Abonnement hinzufügen

Klicken Sie auf Abonnement hinzufügen und füllen Sie Folgendes aus:

Wenn Sie speichern, überprüft TimelyChurch, ob die URL erreichbar ist und gültige iCalendar-Daten enthält, und führt dann eine sofortige erste Synchronisierung durch.

Wie die Synchronisierung funktioniert

• Jedes Abonnement hat ein Synchronisierungsintervall, das bestimmt, wie oft TimelyChurch den Feed erneut abruft.
• Während einer Synchronisierung werden Veranstaltungen aus dem externen Feed nach UID abgeglichen. Neue Veranstaltungen werden erstellt, bestehende Veranstaltungen werden aktualisiert, und Veranstaltungen, die aus der Quelle verschwinden, werden gelöscht.
• Importierte Veranstaltungen werden mit dem Abonnement markiert, sodass Sie immer erkennen können, welche lokal und welche extern sind.
• Klicken Sie bei jedem Abonnement auf Jetzt synchronisieren, um eine sofortige Aktualisierung zu erzwingen.

Ein Abonnement entfernen

Wenn Sie ein Abonnement löschen, wählen Sie, was mit den importierten Veranstaltungen passiert:

• Importierte Veranstaltungen behalten -- Trennen Sie die Veranstaltungen vom Abonnement, sodass sie zu regulären lokalen Veranstaltungen werden.
• Importierte Veranstaltungen löschen -- Entfernen Sie alle Veranstaltungen, die aus diesem Abonnement stammen.

Sicherheitshinweise

• Kalenderabonnements können nur von Benutzern verwaltet werden, die eine Berechtigung für die Kalender-Funktion haben.
• Externe Feed-URLs werden vor dem Hinzufügen validiert, sodass diese Funktion nicht missbraucht werden kann, um beliebige URLs abzurufen.

Das richtige Werkzeug wählen