Das WordPress-Plugin ct-cal kann durch den Shortcode [ct-cal attributes]
oder [ct-cal attributes]content[/ct-cal]
auf jeder Seite eingebettet werden. Wird die zweite Form verwendet, wird der Text zwischen den beiden Elementen nur dann angezeigt, wenn mindestens ein Termin geliefert wurde. Auf diese Art und Weise kann verhindert werden, dass Hinweise auf nicht existente Termine erscheinen. Z.B.:
[ct-cal id=1]Der nächste Termin im Rhein-Main-Kreis:[/ct-cal]
Die Angabe des Attributes id
ist zwingend notwendig, da hiermit die ChurchTools-Anbindung identifiziert wird. Es sind die Werte 1, 2 und 3 zulässig.
[ct-cal id=1]
[ct-cal id=2]
[ct-cal id=3]
Die Anzahl der maximal angezeigten Termine wird durch das Attribut count
und die Angabe einer positiven Zahl beschränkt. Z.B.:
[ct-cal id=1 count=3]
Die inhaltliche Auswahl der Termine erfolgt mit dem Attribut filter
und der Angabe der gewünschten Filterkategorien (= Arbeitsbereiche im Rhein-Main-Kreis).
[ct-cal id=1 filter=Seelsorge]
Mehrere Filterkategorien können durch ein Komma getrennt angegeben werden. Z.B.
[ct-cal id=1 filter=Kinder,Pfadfinder,Jugend]
Die “Terminarten” Alle, Kreis, Kinder, Pfadfinder, Jugend, Single, Frauen, Senioren
und Seelsorge
sind zur Zeit zulässig (sofern der Kalender des Rhein-Main-Kreises eingebunden werden soll; bei anderer Verwendung können andere/weitere Filterkategorien verwendet werden).
Alle
ist der Standard wenn das Attribut nicht angegeben wird.
Wird vor der ersten Filterkategorie ein Trennstrich (Minuszeichen) angegeben, dreht sich die Logik des Filters um: Es werden alle Termine angezeigt, bis auf diejenigen die den Filterkategorien entsprechen.
Die nächsten Attribute regeln das Erscheinungsbild der angezeigten Termine:
Ein Termin zeigt seine Daten üblicherweise in der folgenden Reihenfolge an (sofern diese Daten zu dem Termin hinterlegt wurden).
- Titel
- Bemerkung
- Termin
- Veranstaltungsort
- Kontaktdaten
- Telefonnummer
- E-Mail-Adresse
- Textuell ausgegebener Link
- Beschreibung des Termins
- “Mehr…”-Link zur Veranstaltungsseite
- Die gesetzten Filterkategorien
Durch die Attribute title, comment, date, place, contact, phone, mail, link, note
und more
kann die Anzeige durch Angabe yes
oder no
ein- oder ausgeschaltet werden. yes
ist meistens der Standardwert, wenn das Attribut nicht angegeben wird. Z.B. würde im folgenden nur der Titel und die Terminbeschreibung angezeigt werden:
[ct-cal id=1 comment=no date=no place=no contact=no phone=no mail=no link=no note=yes more=no]
Bei nicht mehrtägigen Veranstaltungen kann die Anzeige des Termins modifiziert werden:
Durch Angabe des Attributes time
mit dem Wert no
kann die Anzeige der Uhrzeit ausgeschaltet werden. Es wird nur noch das Datum angezeigt.
Z.B.:
[ct-cal id=1 time=no place=no contact=no phone=no mail=no note=no more=no]
Bei nicht mehrtägigen Veranstaltungen kann die Anzeige des Termins modifiziert werden:
Durch Angabe des Attributes end
mit dem Wert yes
kann die Anzeige der Uhrzeit des Veranstaltungsendes (sofern eingegeben und gültig) eingeschaltet werden.
Z.B.:
[ct-cal id=1 end=yes place=no contact=no phone=no mail=no note=no more=no]
Wenn der gewählte Filter angezeigt werden soll, kann dies mit dem Attribute category
bewerkstelligt werden. Hier ist no
der Standardwert, wenn das Attribut nicht angegeben wird.
Z.B.:
[ct-cal id=1 category=yes]
Für den Fall, dass man den Link (“more”) nicht anzeigen möchte, aber trotzdem auf eine Veranstaltungsseite verweisen möchte, kann man mit Hilfe des Attributes titlelink
und der Angabe von yes
oder no
den Titel des Termins zum Link machen (sofern in ChurchTool ein Link hinterlegt wurde!). In diesem Fall ist no
der Standardwert, wenn das Attribut nicht angegeben wird.
[ct-cal id=1 titlelink=yes link=no more=no]
Durch Angabe des Attributes calender
mit dem Wert yes
kann die Darstellung eines Kalenderblattes links neben dem Termin eingeschaltet werden. no
ist der Standardwert, wenn das Attribut nicht angegeben wird.
[ct-cal id=1 calendar=yes]
Durch Angabe des Attributes symbols
mit dem Wert no
kann die Anzeige der kleinen Symbole vor den Daten unterdrückt werden.
Z.B.:
[ct-cal id=1 symbols=no note=no more=no]