WP Manifestindependent plugin directory
manifest / events / connect-churchtools

ChurchTools Events self-updates

WordPress-Plugin: synchronisiert ChurchTools-Kalender-Events und zeigt sie per Shortcode/Gutenberg-Block/WPBakery an

by wirsindcgks · github.com/wirsindcgks/connect-churchtools · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/wirsindcgks/connect-churchtools/archive/refs/heads/main.zip

Ships its own WordPress updater (Plugin Update Checker), so new versions show up under Dashboard → Updates.

Readme github.com/wirsindcgks/connect-churchtools ↗

Termine und Gruppen aus ChurchTools auf der eigenen WordPress-Website – einmal in ChurchTools gepflegt, auf der Website von selbst aktuell.

Das Plugin gleicht ausgewählte ChurchTools-Kalender und Gruppen-Homepages regelmäßig ab und zeigt sie in fertig gestalteten Ansichten an. Farben, Ecken und Aufbau stellt man im Backend mit Live-Vorschau ein, ganz ohne CSS.

Was es kann

  • Termine automatisch übernehmen: Serien kommen als einzelne Termine an, abgesagte verschwinden wieder.
  • Drei Ansichten: Liste, Raster und „Nächster Termin“. Einbinden per Gutenberg-Block, WPBakery-Element oder Shortcode.
  • Schnell finden: Eventfinder mit Themen- und Zeitraum-Knöpfen, Suche und Monatsüberschriften.
  • Termindetails als Popup oder als eigene Seite, auf Wunsch zum Teilen, als Kalenderdatei oder als Kalender-Abo.
  • „Jetzt“ an laufenden Terminen: Ein Termin, der gerade stattfindet, trägt ein Kennzeichen neben seinem Namen. Das Wort ist frei wählbar und lässt sich abschalten.
  • Gruppen statt iframe: die Gruppen einer Gruppen-Homepage in derselben Optik, mit freien Plätzen und Gruppenfinder.
  • Gut für Suchmaschinen: eigene Adresse je Termin, strukturierte Daten und Sitemap, verträglich mit Yoast SEO und Rank Math.
  • Datensparsam: Bilder werden importiert, Besucher laden nichts von der ChurchTools-Domain. Die Teilen-Knöpfe kommen ohne Skript von Drittanbietern und ohne Zählpixel aus.
  • Updates wie bei jedem anderen Plugin über die WordPress-Plugin-Übersicht.

So sieht das aus

Kachelraster: Bild, Datum und kurzer Auszug
Kachelraster mit drei Spalten 		Gruppen: die Gruppen einer Homepage als Kacheln
Drei Gruppenkacheln mit Treffzeit und freien Plätzen
Nächster Termin: groß, die folgenden darunter
Große Kachel für den nächsten Termin, darunter die folgenden 		Eventfinder: nach Thema und Zeitraum filtern
Eventfinder mit Themen- und Zeitraum-Knöpfen über einer Terminliste
Liste: kompakt, nach Monaten gruppiert
Terminliste mit Monatsüberschriften 		Termindetails: als Popup oder eigene Seite
Popup mit Bild, Datum, Titel, Zeit, Ort und Beschreibung

Alle Bilder zeigen erfundene Beispieltermine mit Platzhalterbildern.

Installation

Voraussetzungen: WordPress ab 6.4, PHP ab 8.1, eine ChurchTools-Instanz und ein API-Key dafür.

  1. Unter Releases die Datei churchtools-plugin-vX.Y.Z.zip herunterladen. Nicht „Source code (zip)“ – darin fehlen die gebauten Bestandteile, das Plugin läuft damit nicht.
  2. In WordPress unter Plugins → Installieren → Plugin hochladen die ZIP-Datei installieren und aktivieren.
  3. Im linken Menü erscheint ChurchTools. Neue Versionen meldet das Plugin danach selbst.

Umgezogen: Bis Version 1.36.1 lag das Plugin unter churchtools-plugin. Installationen mit diesen Versionen fragen weiter die alte Adresse ab und bekommen keine Updates mehr angeboten. Einmal die aktuelle ZIP-Datei wie oben hochladen und Aktuelle Version ersetzen wählen – Einstellungen und Termine bleiben erhalten, danach laufen die Updates wieder von selbst. Ältere Versionen zum Zurückgehen liegen weiter unter den bisherigen Releases.

Erste Schritte

  1. Verbinden: ChurchTools → Einstellungen → Verbindung – Instanz-Name und API-Key eintragen.

  2. Kalender wählen: ChurchTools → Events → Kalender – Kalender laden und anhaken.

  3. Abgleichen: ChurchTools → Übersicht – Jetzt synchronisieren.

  4. Einbauen: auf einer Seite den Block „ChurchTools Events“ einfügen, oder als Shortcode:

    [ctp_events layout="list" finder="1" search="1" month_dividers="1"]

Die ausführliche Anleitung mit Design, eigenen Terminseiten und Gruppen steht unter Einrichtung.

Dokumentation
Einrichtung Verbindung, Kalender, Design, Terminseiten, API-Key
Termine anzeigen Ansichten, Beispiele, Optionen, Teilen, Importieren und Abonnieren
Gruppen anzeigen Gruppen-Homepages, Gruppenfinder, einzelne Gruppen hervorheben
Gut zu wissen Caching-Plugins, Spaltenzahl, Grenzen, häufige Fragen
readme.txt Vollständige Referenz aller Optionen und FAQ, im Backend unter Plugins → ChurchTools Events → Details
Changelog Was sich mit jeder Version geändert hat

Version 2.0 kommt

Mit 2.0 heißt das Plugin Connect ChurchTools und braucht PHP 8.3 und WordPress 6.6. Einstellungen, Shortcodes, Blöcke und Adressen bleiben erhalten. Was vorher noch zu tun ist, zeigt die Übersicht im Backend; alles Weitere steht in der Kompatibilitätszusage.

Connect ChurchTools ist ein unabhängiges Projekt und steht in keiner Verbindung zur ChurchTools Innovations GmbH, der Herstellerin von ChurchTools.

Hilfe und Mitmachen

Ein Problem gefunden oder etwas vermisst? Gern als Issue melden.

Für Entwickler: Aufbau, lokale Entwicklung und Release-Ablauf stehen in docs/ARCHITECTURE.md.

Lizenz

GPL-2.0-or-later, siehe LICENSE.