WordPress Plugin – ChurchTools Anmeldungen

Die Idee für dieses WordPress Plugin wurde bereits schon früher in diesem Blog-Post formuliert. Mit der Neugestaltung unserer Gemeinde-Homepage wollten wir das Plugin nun endlich umsetzen.

Was kann das „ChurchTools Anmeldung“ Plugin?

Du kannst mit ChurchTools Gruppen anlegen, zu denen sich Teilnehmer öffentlich anmelden können, egal ob sie einen ChurchTools-Account besitzen oder nicht. Diese Gruppen werden für Freizeiten, Seminare oder andere Gemeindeangebote genutzt.

Die sogenannte „Gruppen-Homepage“ kann mehrere dieser öffentlichen Gruppen anzeigen. Diese Gruppen-Homepage kannst du dann auf deiner Webseite einbinden:

Das Problem: IFrames können im Design nicht angepasst werden. Du holst dir damit nicht nur die neusten Events auf deine Seite, sondern auch das ChurchTools Design.

Mit dem „ChurchTools-Anmeldungen“ Plugin kannst du öffentliche Gruppen mit deinem eigenen Design auf deiner Homepage einbinden.

Das Plugin (in ZIP-Format) kannst aus dem GitHub-Repo herunterladen:

ChurchTools Anmeldungen Plugin

Die ZIP-Datei kannst du im WordPress Admin-Bereich unter Plugins, Installieren und den Button „Plugins hochladen“ installieren. Sobald das Plugin hochgeladen ist, kannst du es aktivieren.

Gruppen-Homepage in ChurchTools einrichten

Zunächst muss eine Gruppen-Homepage in ChurchTools eingerichtet werden. Alle Gruppen zu denen sich die Benutzer anmelden können, müssen als Untergruppen hinzugefügt werden. Mehr Informationen zu Gruppen-Homepages gibt es im ChurchTools Wiki.

In der Verwaltung lässt sich dann das IFrame für die Einbettung auf eine Homepage kopieren.

Hier ein Beispiel für den IFrame-Code:

<iframe
        style="border-width:0" 
        data-src="https://kl4.church.tools/grouphomepage/5oIid23Slge5hii5dsycP87MmEqzVU5y?embedded=true" 
        class=" lazyloaded"
        src="data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==" 
        width="100%" height="900px">
</iframe>

Aus dem Attribut „data-src“ ergibt sich die ChurchTools-API Url und den Public-Group Hash:

  • API-Url: https://kl4.church.tools/ (Domain ohne Pfade)
  • Group Hash: 5oIid23Slge5hii5dsycP87MmEqzVU5y (Gruppen-Hash in Public-URL)

Plugin konfigurieren

Die ermittelte API-Url und der Group Hash muss in der Plugin-Konfiguration eingetragen werden:

Außerdem wird der Parent- und Child-Template Code gepflegt. Hier schreibst du HTML-Code um die Darstellung der Gruppe zu definieren. Die vorausgefüllten Beispiel-Templates geben dir eine Richtung, wie ein Template aufgebaut sein kann. Das Attribut „Nr of Children“ gibt an, wieviele Anmeldungs-Elemente angezeigt werden.

Die Daten der öffentlichen Gruppen werden jeweils in das Child-Template „gegossen“ und in HTML-Code verwandelt. Der gesamte Code für alle öffentlichen Gruppen wird für das Parent-Template in der Variable „children“ bereitgestellt:

Variablen werden in Twig mit zweifacher geschweiften Klammer eingebunden. Welche Variablen zur Verfügung stehen, siehst du jeweils unter den Template-Feldern:

<h3>{{ name }}</h3>
<i>{{ information.meetingTime }}</i>

If-Anweisungen werden mit einer geschweiften Klammer und Prozentzeichen genutzt:

{% if (currentMemberCount != null and maxMemberCount != null) %}
   {{ currentMemberCount }} von {{ maxMemberCount }} Plätze belegt.
{% endif %}

Du kannst die Anmeldungen ganz einfach auf einer Seite über den ShortCode einbinden:

Wenn du Fragen oder Hinweise hast oder wenn du das Plugin mit- und weiterentwickeln möchtest, melde dich. Wir freuen uns über dein Feedback!

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert