Google Kalender (Täglicher Digest)

Beschreibung

Benutzerhandbuch

Verbinden Sie einen oder mehrere Google Kalender mit Ihrem Server: Der Bot veröffentlicht jeden Tag eine Zusammenfassung der anstehenden Termine und kann ein interaktives Panel anzeigen, über das jedes Mitglied eine Erinnerung einen Tag vorher per Direktnachricht abonniert.

Was es tut

• Veröffentlicht einen täglichen Digest der Termine der nächsten 30 Tage, im Kanal und zur Uhrzeit Ihrer Wahl.
• Zeigt ein interaktives Termin-Panel: Seitennummerierung, automatische Aktualisierung und Countdown bis zur nächsten Aktualisierung.
• Sendet eine Erinnerung einen Tag vorher per Direktnachricht an die Mitglieder, die einen Termin über das Panel abonnieren.
• Verfolgt mehrere Kalender gleichzeitig: öffentliche (ohne Anmeldung gelesen) oder private (über ein verbundenes Google-Konto gelesen).
• Berücksichtigt die Zeitzone, die Sie für den Server festlegen.

Was Sie auf der Google-Seite bereitstellen müssen

Sie müssen bei Google nichts erstellen: kein Google-Cloud-Projekt, keinen API-Schlüssel, keine OAuth-Kennung. TennoCore stellt all das bereit. Je nach Kalendertyp benötigen Sie lediglich:

Öffentlicher Kalender

1. Die Kalender-ID. Öffnen Sie auf einem Computer calendar.google.com → fahren Sie unter „Meine Kalender" über den Kalender → Menü ⋮ → Einstellungen und Freigabe → Abschnitt Kalender integrieren → kopieren Sie die Kalender-ID.
2. Der Kalender muss öffentlich gemacht werden: dieselbe Seite → Zugriffsberechtigungen → Öffentlich verfügbar machen. Andernfalls kann der Bot ihn nicht lesen.

Ein Google-Link mit cid= wird ebenfalls anstelle der ID akzeptiert.

Privater Kalender

1. Ein Mitglied (meist Sie) muss sein Google-Konto verbinden: Schaltfläche Mein Google-Konto verbinden im Dashboard oder /agenda connect auf Discord. Google zeigt einen Code an, den Sie auf einer eigenen Seite eingeben. Die angeforderte Berechtigung ist ein Lesezugriff auf die Kalender.
2. Sobald das Konto verbunden ist, wählen Sie es als Eigentümer aus und wählen den Kalender aus der angebotenen Liste. Der Kalender muss dann nicht öffentlich sein.

hinweis

Ein privater Kalender wird mit dem Token des Kontos gelesen, das ihn autorisiert hat. Wenn dieses Mitglied sein Konto trennt, sind die daran gebundenen privaten Kalender nicht mehr lesbar.

Schnellstart (Admin)

1. Zeitzone einstellen: /agenda timezone tz:Europe/Berlin.
2. Kalender hinzufügen: /agenda calendrier ajouter_public calendar_id:<ID> (oder über das Dashboard).
3. Kanal und Uhrzeit wählen: /agenda digest config_responses channel:#kalender hour:9.
4. Ergebnis prüfen: /agenda digest tester.
5. Täglichen Versand aktivieren: /agenda digest enable_module.

Befehle

Google-Konto (für alle)

Befehl	Beschreibung
/agenda connect	Ihr Google-Konto verbinden (Code auf einer Google-Seite eingeben).
/agenda me	Status Ihrer Google-Verbindung ansehen.
/agenda disconnect	Verbindung trennen und Ihre Google-Tokens löschen.
/agenda my_events	Ihre nächsten 5 Termine, als private Antwort.
/agenda publish	Ein interaktives Termin-Panel veröffentlichen.
/agenda digest tester	Sofort einen Test-Digest veröffentlichen.

Parameter von /agenda publish: channel (sonst der aktuelle Kanal), days (Zeitfenster von 1 bis 60 Tagen, standardmäßig 30), refresh_every (automatische Aktualisierung von 30 bis 3600 Sekunden, standardmäßig 300).

Verfolgte Kalender

Befehl	Beschreibung
/agenda calendrier lister	Die von diesem Server verfolgten Kalender auflisten.
/agenda calendrier ajouter_public	Einen öffentlichen Kalender hinzufügen (ID oder Link mit cid=), mit optionaler Bezeichnung. (Administrator)
/agenda calendrier ajouter_prive	Einen privaten Kalender über das Google-Konto eines verbundenen Mitglieds hinzufügen. (Administrator)
/agenda calendrier retirer	Einen verfolgten Kalender entfernen (die ID wird automatisch vervollständigt). (Administrator)

Täglicher Digest

Befehl	Beschreibung
/agenda digest config_responses	Kanal und lokale Versandzeit wählen (0–23). (Administrator)
/agenda digest enable_module	Täglichen Versand aktivieren. (Administrator)
/agenda digest desactiver	Täglichen Versand deaktivieren. (Administrator)
/agenda timezone	Zeitzone des Servers im IANA-Format festlegen. (Administrator)

Einstellungen im Dashboard

Dashboard → Kategorie Tools & Staff → Planung Google Calendar.

• Digest-Konfiguration: Veröffentlichungskanal, Versandzeit (0–23), Zeitzone (Europe/Paris, UTC, America/New_York) und Aktivierungsschalter.
• Private Kalender: Liste der verbundenen Google-Konten (mit ihrer E-Mail-Adresse), Schaltfläche zum Verbinden eines weiteren Kontos, Schaltfläche zum Trennen eines Kontos.
• Kalender: Liste der verfolgten Kalender mit einem Symbol für öffentlich oder privat, der ID und dem Eigentümerkonto. Hinzufügen über ein Fenster, in dem Sie zuerst den Typ wählen:
  • Öffentlich: Sie fügen die ID ein (eine ausklappbare Hilfe erklärt, wo Sie sie finden).
  • Privat: Sie wählen das verbundene Konto und dann den Kalender aus der Liste dieses Kontos.
  • In beiden Fällen können Sie einen Anzeigenamen vergeben.
• Terminvorschau (30 Tage): die nächsten 10 Termine, nach Tag gruppiert, mit einem Link zu Google Calendar.
• Digest testen: veröffentlicht sofort einen Digest im konfigurierten Kanal.

Die Anzahl der verfolgten Kalender ist für einen Server ohne Premium auf 3 begrenzt (Standardwert, vom TennoCore-Team anpassbar).

Gut zu wissen

• Der Digest wird alle 5 Minuten geprüft und nur einmal pro Tag veröffentlicht, und zwar während der von Ihnen gewählten Stunde. Ist der Bot während dieser ganzen Stunde nicht verfügbar, wird der Digest des Tages einfach übersprungen — er wird nicht später nachgeholt.
• Der Digest umfasst immer 30 Tage und zeigt 25 Termine pro Seite.
• Ohne konfigurierten Kalender verweigert /agenda publish die Veröffentlichung und bittet Sie, einen hinzuzufügen.
• Das Termin-Panel ist temporär: Seine Schaltflächen reagieren nach einer Viertelstunde ohne Interaktion nicht mehr, und die automatische Aktualisierung endet damit ebenfalls. Für eine dauerhafte Anzeige verwenden Sie den täglichen Digest anstelle des Panels.
• Die Schaltflächen Jetzt aktualisieren, Einen Tag vorher benachrichtigen und Nicht mehr benachrichtigen sind dem Mitglied vorbehalten, das den Befehl ausgeführt hat: alle anderen erhalten eine Ablehnung. Jedes Mitglied muss also sein eigenes Panel veröffentlichen, um zu abonnieren, oder das Panel des Digests nutzen.
• Die Erinnerungen einen Tag vorher kommen per Direktnachricht: Ein Mitglied, das seine DMs geschlossen hat, erhält sie nicht. Sie werden jede Minute geprüft.
• Die Zeitzone steuert die Versandzeit und die Anzeige der Datumsangaben. Das Dashboard bietet nur drei Zeitzonen an; /agenda timezone akzeptiert jeden IANA-Namen (Europe/Brussels, America/Sao_Paulo, …).
• Der Bot benötigt im Digest-Kanal die Berechtigungen Nachrichten senden und Links einbetten.
• /agenda disconnect löscht Ihre Google-Tokens auf der TennoCore-Seite. Die öffentlichen Kalender des Servers funktionieren weiter, die privaten Kalender, die von Ihrem Konto abhingen, nicht.