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]