[[Kategorie:Extensions]]

= Allgemeines =
Eine Erweiterung das Contao Kalenders. Diese Erweiterung ist entstanden, weil der Contao Kalender nicht genug Funktionalität hat.

Diese Erweiterung setzt sich aus den bereits vorhandene Erweiterungen '''calendar_timetable''' und '''event_recurrences''' zusammen. Hinzu kommt die Möglichkeit mit Feiertagen und Ferien zu arbeiten.

'''calendar_ext''' ist nicht 100% zu '''event_recurrences''' kompatibel. Vor der Installation der Erweiterung '''calendar_ext''' müssen alle Events angepasst werden, die die "Ausnahmen-Funktionalität" der Erweiterung '''event_recurrences''' verwenden. Es müssen alle Ausnahmen aus den Events gelöscht werden.

Zusätzlich sollten alle Events (''Mehrere bearbeite''n mit allen Feldern) mal neu gespeichert werden. Alternativ können natürlich alle Events neu angelegt werden.

'''Diese Erweiterung benötigt PHP 5.3.'''

= Gültig für beide Versionen =
Im folgenden Abschnitt sind die Funktionen beschrieben, die für beide Versionen der Erweiterung gültig sind.

== Der Kalender ==
Der Kalender hat folgende neue Funktionen bekommen:

'''Hintergrundfarbe''' 
Die gewählte Hintergrundfarbe wird für die Darstellung der Events in der Ausgabe benutzt.

'''Vordergrundfarbe''' 
Die gewählte Vordergrundfarbe wird für die Darstellung der Events in der Ausgabe benutzt.

'''Ferienkalender''' 
Ist diese Option aktiviert, so kann dieser Kalender in den Frontend-Modulen als Ferienkalender benutzt werden. Dies hat zur Folge, dass im Frontend keine Events mehr angezeigt werden, die sich mit den Events aus dem Ferienkalender überschneiden.

'''Events anzeigen''' 
Ist diese Option aktiviert, so werden nur bestimmte Events angezeigt, auch wenn diese sich mit den Events aus dem Ferienkalender überschneiden. Hierzu muss dann eine Option im Event selber aktiviert werden.

[[Datei:Auswahl_101.png|Kalender-Auswahl|frame|center]]

Die Variabeln für die Farben müssen dann nach Wunsch in die Templates eingebaut werden.
<source lang="php">
$event['bgstyle'] = Hintergrundfarbe
$event['fgstyle'] = Vordergrundfarbe
</source>

== Die Events ==
Die Events haben folgende neue Funktionen bekommen:

'''Event immer anzeigen''' 
Diese Option muss aktiviert werden, wenn das Event auch an einem Feiertag/Ferien angezeigt werden soll. Hierzu muss im Kalender die Option '''Events anzeigen''' aktiviert sein.

[[Datei:cal_ext_auswahl_005.png|Events anzeigen|frame|center]]

{{ExtInfo
| Dev=Kester Mielke ([[User:kmielke|kmielke]])
| ExtVersion=3.0.0
| Version=3.1.1
| ERLink=http://www.contao.org/erweiterungsliste/view/calendar_extended.de.html
}}
= Version 3.0.0 für Contao 3.x =
In diesem Abschnitt sind dir Funktionen beschrieben, die sich auf die Version für Contao 3.x beziehen.

=== Die Wiederholungen der Events ===
Anhand des Intervall und der Anzahl der Wiederholungen wird das Enddatum der Wiederholungen berechnet (war schon immer so), und zur Orientierung angezeigt. Ändern man die Anzahl der Wiederholungen, wird das Datum angepasst. Es kann aber nicht manuell geändert werden. Eine Liste der Wiederholungen wird in der Auswahl für die Ausnahmen gespeichert.

[[Datei:Event_wiederholen.png|Event Wiederholung|frame|center]]

Die Option "Nur an Werktage" sogt dafür, dass das Event nicht an Wochenenden angezeigt wird.

=== Die Wiederholungen (erweitert) ===
In den erweiterten Wiederholungen ist es möglich Wiederholungen in einem anderen Intervall anzugeben, als es der Standard erlaubt.

Hier ist es nun möglich, zu sagen: "Ich möchte z.B. jeden dritten Mittwoch im Monat ein Event haben." Auch hier kann die Anzahl der Wiederholungen und Ausnahmen definiert werden. Die Handhabung ist hier identisch zu den normalen Wiederholungen.

[[Datei:cal_ext_auswahl_008.png|Wiederholungsintervall|frame|center]]

{{ExtInfo
| Dev=Kester Mielke ([[User:kmielke|kmielke]])
| ExtVersion=1.0.10
| Version=2.10.1 - 2.11.11
| ERLink=http://www.contao.org/erweiterungsliste/view/calendar_extended.de.html
}}
= Version 1.0.10 für Contao 2.11.x =
In diesem Abschnitt sind dir Funktionen beschrieben, die sich auf die Version für Contao 2.11.x beziehen.

=== Die Wiederholungen der Events ===
Hier ist mit Abstand am meisten passiert.

Anhand des Intervall und der Anzahl der Wiederholungen wird das Enddatum der Wiederholungen berechnet (war schon immer so), und zur Orientierung angezeigt. Ändern man die Anzahl der Wiederholungen, wird das Datum angepasst. Eine Liste der Wiederholungen wird in der Auswahl für die Ausnahmen gespeichert.

[[Datei:Cal ext auswahl 007a.png|Event Wiederholung|frame|center]]

Die Option "Nur an Werktage" sogt dafür, dass das Event nicht an Wochenenden angezeigt wird.

=== Die Wiederholungen (erweitert) ===
In den erweiterten Wiederholungen ist es möglich Wiederholungen in einem anderen Intervall anzugeben, als es der Standard erlaubt.

Hier ist es nun möglich, zu sagen: "Ich möchte z.B. jeden dritten Mittwoch im Monat ein Event haben." Auch hier kann die Anzahl der Wiederholungen und Ausnahmen definiert werden. Die Handhabung ist hier identisch zu den normalen Wiederholungen.

[[Datei:cal_ext_auswahl_008.png|Wiederholungsintervall|frame|center]]

=== Die Ausnahmen ===
Die Anzahl der Wiederholungen, die im DropDown gespeichert werden kann in der Datei localconfig.php eingestellt werden.
<source lang="php">
$GLOBALS['TL_CONFIG']['tl_calendar_events']['maxRepeatExecptions'] = 365;
</source>

Für die Wiederholungen können nun Ausnahmen definiert werden. Für die Erstellung einer Ausnahme können folgende Werten gesetzt werden können.

*'''Datum''' - Ist das Datum der Ausnahme. Hier kann ein vorhandenes Datum gewählt werden.
*'''Aktion''' - Hier stehen drei Möglichkeiten zur Auswahl
**'''nicht anzeigen''' - Das Event wird am Ausnahmetag noch angezeigt
**'''verschieben''' - Das Event wird verschoben.
**'''CSS Class hinzufügen''' - Das Event bekommt eine CSS Class ''exception''
*'''verschieben um''' - Wurde die Aktion ''verschieben'' gewählt, so kann hier das Event um diverse Tage verschoben werden
*'''Startzeit''' - neue Startzeit für die Ausnahme
*'''Endzeit''' - neue Endzeit für die Ausnahme

Der Bereich, um den ein Event verschoben werden kann ist ebenfalls konfigurierbar.
<source lang="php">
$GLOBALS['TL_CONFIG']['tl_calendar_events']['moveDays'] = 7;
</source>

Das gilt auch für die Uhrzeiten. In diesem Beispiel von 10:00 Uhr bis 22:00 im 30 Minuten Rhythmus.
<source lang="php">
$GLOBALS['TL_CONFIG']['tl_calendar_events']['moveTimes'] = '10:00|22:00|30';
</source>

Soll eine Ausnahme erstellt werden, bei der sich nur die Zeit des Events ändert, so wählt man die Aktion verschieben, verschieben um 0 Tage, und setzt die neuen Zeiten.

== Frontend Module ==
Um alle Events im Frontend ausgeben zu können, wurde eine Class ''EventsExt'' erstellt, die von ''Events'' erbt, und diese entsprechend erweitert. Die neuen Module setzen darauf auf.

[[Datei:cal_ext_auswahl_009.png|Frontend-Module|frame|center]]

Die Frontend Module funktionieren nur mit den entsprechenden calext_* Templates.
* KM Kalender -> calext_default, calext_mini
* KM Stundenplan -> calext_timetable
* KM Jahresübersicht -> calext_yearview

* KM Eventliste ist hier eine Ausnahme, da es die Standard Contao Templates verwendet.
* KM Eventlist-Menü ist hier eine Ausnahme, da es die Standard Contao Templates verwendet.

=== KM Kalender ===
Hier gibt es die zusätzliche Auswahl der Ferienkalender.

=== KM Eventlist ===
Hier gibt es die zusätzliche Auswahl der Ferienkalender, und die Möglichkeit, Event Wiederholungen auszublenden.

=== KM Eventlist-Menü ===
Hier gibt es die zusätzliche Auswahl der Ferienkalender, und die Möglichkeit, Event Wiederholungen auszublenden.

=== KM Stundenplan ===
Hier gibt es die zusätzliche Auswahl der Ferienkalender, und einige neue Template Einstellungen.
*Datum anzeigen - Zeigt das Datum des Tages im Stundenplan an
*Leere Tage nicht anzeigen - Tage ohne Events werden nicht dargestellt
*Navigation anzeigen - Zeigt die Links für die Navigation der Kalenderwochen, wenn aktiviert
*Link "Aktuelle Woche" anzeigen - Zeigt einen zusätzlichen Link, der zur aktuellen Woche navigiert.

[[Datei:cal_ext_auswahl_010.png|Stundenplan|frame|center]]

=== KM Jahresübersicht ===
Die Jahresübersicht zeigt alle Events eines Jahres in einer Übersicht an. Die Handhabung ist wie bei den anderen Modulen auch.

[[Datei:Auswahl_102.png|Jahresübsersicht|frame|center]]

== Offene Punkte ==

Aus meine Sicht aktuell keine...

Datei:Event wiederholen ext.png

2013-08-18T13:45:18Z

Kmielke:

2011-09-07T09:31:03Z

Kmielke:

2011-05-12T16:25:00Z

Kmielke: hat „Calendar ext“ nach „Calendar extended“ verschoben: falscher name... ;-)

[[Kategorie:Extensions]]

Eine Erweiterung das Contao Kalenders. Diese Erweiterung ist entstanden, weil der Contao Kalender nicht genug Funktionalität hat.

{{ExtInfo
| Dev=Kester Mielke ([[User:kmielke|kmielke]])
| DevSite=http://www.kester-mielke.de
| ExtVersion=1.0.0
| Version=2.9.4 - 2.9.4
| ERLink=http://www.contao.org/erweiterungsliste/view/calendar_ical.de.html
}}

== Allgemeines ==
Diese Erweiterung setzt sich aus den bereits vorhandene Erweiterungen '''calendar_timetable''' und '''event_recurrences''' zusammen. Hinzu kommt die Möglichkeit mit Feiertagen und Ferien zu arbeiten.

'''calendar_ext''' ist nicht 100% zu '''event_recurrences''' kompatible. Vor der Installation der Erweiterung '''calendar_ext''' müssen alle Events angepasst werden, die die "Ausnahmen-Funktionalität" der Erweiterung '''event_recurrences''' verwenden. Es müssen alle Ausnahmen aus den Events gelöscht werden.

Zusätzlich sollten alle Events (Mehrere bearbeiten mit allen Feldern) mal neu gespeichert werden. Alternativ können natürlich alle Events neu angelegt werden.

== Der Kalender ==
Der Kalender hat folgende neue Funktionen bekommen.

'''Hintergrundfarbe''' 
Die gewählte Hintergrundfarbe wird für die Darstellung der Events in der Ausgabe benutzt. Aktuell ist es nur für Stundenplan/Timetable nutzbar.

'''Ferienkalender''' 
Ist diese Option aktiviert, so kann dieser Kalender in den Frontend-Modulen als Ferienkalender benutzt werden. Dies hat zur Folge, dass im Frontend keine Events mehr angezeigt werden, die sich mit den Events aus dem Ferienkalender überschneiden.

'''Events anzeigen''' 
Ist diese Option aktiviert, so werden nur bestimmte Events angezeigt, auch wenn diese sich mit den Events aus dem Ferienkalender überschneiden. Hierzu muss dann eine Option im Event selber aktiviert werden.

[[Datei:cal_ext_auswahl_002.png]]

== Die Events ==
Die Events haben folgende neue Funktionen bekommen.

'''Event immer anzeigen''' 
Diese Option muss aktiviert werden, wenn das Event auch an einem Feiertag/Ferien angezeigt werden soll. Hierzu muss im Kalender die Option '''Events anzeigen''' aktiviert sein.

[[Datei:cal_ext_auswahl_005.png]]

=== Die Wiederholungen der Events ===
Hier ist mit Abstand am meisten passiert.

Anhand des Intervall und der Anzahl der Wiederholungen wird das Enddatum der Wiederholungen berechnet (war schon immer so), und zur Orientierung angezeigt. Ändern man die Anzahl der Wiederholungen, wird das Datum angepasst. Eine Liste der Wiederholungen wird in der Auswahl für die Ausnahmen gespeichert.

[[Datei:cal_ext_auswahl_007.png]]

=== Die Wiederholungen (erweitert) ===
In den erweiterten Wiederholungen ist es möglich Wiederholungen in einem anderen Intervall anzugeben, als es der Standard erlaubt.

Hier ist es nun möglich, zu sagen, ich möchte z.B. jeden dritten Mittwoch im Monat ein Event haben. Auch hier kann die Anzahl der Wiederholungen und Ausnahmen definiert werden. Die Handhabung ist hier identisch zu den normalen Wiederholungen.

[[Datei:cal_ext_auswahl_008.png]]

=== Die Ausnahmen ===
Die Anzahl der Wiederholungen, die im DropDown gespeichert werden kann in der Datei config.php eingestellt werden.
<source lang="php">
$GLOBALS['TL_CONFIG']['tl_calendar_events']['maxRepeatExecptions'] = 365;
</source>

Für die Wiederholungen können nun Ausnahmen definiert werden. Für die Erstellung einer Ausnahme können folgende Werten gesetzt werden können.

*'''Datum''' - Ist das Datum der Ausnahme. Hier kann ein vorhandenes Datum gewählt werden.
*'''Aktion''' - Hier stehen drei Möglichkeiten zur Auswahl
**'''nicht anzeigen''' - Das Event wird am Ausnahmetag noch angezeigt
**'''verschieben''' - Das Event wird verschoben.
**'''CSS Class hinzufügen''' - Das Event bekommt eine CSS Class ''exception''
*'''verschieben um''' - Wurde die Aktion ''verschieben'' gewählt, so kann hier das Event um diverse Tage verschoben werden
*'''Startzeit''' - neue Startzeit für die Ausnahme
*'''Endzeit''' - neue Endzeit für die Ausnahme

Der Bereich, um den ein Event verschoben werden kann ist ebenfalls konfigurierbar.
<source lang="php">
$GLOBALS['TL_CONFIG']['tl_calendar_events']['moveDays'] = 7;
</source>

Das gilt auch für die Uhrzeiten. In diesem Beispiel von 10:00 Uhr bis 22:00 im 30 Minuten Rhythmus.
<source lang="php">
$GLOBALS['TL_CONFIG']['tl_calendar_events']['moveTimes'] = '10:00|22:00|30';
</source>

Soll eine Ausnahme erstellt werden, bei der sich nur die Zeit des Events ändert, so wählt man die Aktion verschieben, verschieben um 0 Tage, und setzt die neuen Zeiten.

== Frontend Module ==
Um alle Events im Frontend ausgeben zu können, habe ich eine Class ''EventsExt'' erstellt, die von ''Events'' erbt, und diese entsprechend erweitert. Die neuen Module setzen darauf auf.

[[Datei:cal_ext_auswahl_009.png]]

=== KM Kalender ===
Hier gibt es die zusätzliche Auswahl der Ferienkalender.

=== KM Eventlist ===
Hier gibt es die zusätzliche Auswahl der Ferienkalender, und die Möglichkeit, Event Wiederholungen auszublenden.

=== KM Stundenplan ===
Hier gibt es die zusätzliche Auswahl der Ferienkalender, und einige neue Template Einstellungen.
*Datum anzeigen - Zeigt das Datum des Tages im Stundenplan an
*Leere Tage nicht anzeigen - Tage ohne Events werden nicht dargestellt
*Navigation anzeigen - Zeigt die Links für die Navigation der Kalenderwochen, wenn aktiviert
*Link "Aktuelle Woche" anzeigen - Zeigt einen zusätzlichen Link, der zur aktuellen Woche navigiert.

[[Datei:cal_ext_auswahl_010.png]]

Calendar extended

2011-05-12T16:23:38Z

Kmielke:

[[Kategorie:Extensions]]

Eine Erweiterung das Contao Kalenders. Diese Erweiterung ist entstanden, weil der Contao Kalender nicht genug Funktionalität hat.

{{ExtInfo
| Dev=Kester Mielke ([[User:kmielke|kmielke]])
| DevSite=http://www.kester-mielke.de
| ExtVersion=1.0.0
| Version=2.9.4 - 2.9.4
| ERLink=http://www.contao.org/erweiterungsliste/view/calendar_ical.de.html
}}

== Allgemeines ==
Diese Erweiterung setzt sich aus den bereits vorhandene Erweiterungen '''calendar_timetable''' und '''event_recurrences''' zusammen. Hinzu kommt die Möglichkeit mit Feiertagen und Ferien zu arbeiten.

'''calendar_ext''' ist nicht 100% zu '''event_recurrences''' kompatible. Vor der Installation der Erweiterung '''calendar_ext''' müssen alle Events angepasst werden, die die "Ausnahmen-Funktionalität" der Erweiterung '''event_recurrences''' verwenden. Es müssen alle Ausnahmen aus den Events gelöscht werden.

Zusätzlich sollten alle Events (Mehrere bearbeiten mit allen Feldern) mal neu gespeichert werden. Alternativ können natürlich alle Events neu angelegt werden.

== Der Kalender ==
Der Kalender hat folgende neue Funktionen bekommen.

'''Hintergrundfarbe''' 
Die gewählte Hintergrundfarbe wird für die Darstellung der Events in der Ausgabe benutzt. Aktuell ist es nur für Stundenplan/Timetable nutzbar.

'''Ferienkalender''' 
Ist diese Option aktiviert, so kann dieser Kalender in den Frontend-Modulen als Ferienkalender benutzt werden. Dies hat zur Folge, dass im Frontend keine Events mehr angezeigt werden, die sich mit den Events aus dem Ferienkalender überschneiden.

'''Events anzeigen''' 
Ist diese Option aktiviert, so werden nur bestimmte Events angezeigt, auch wenn diese sich mit den Events aus dem Ferienkalender überschneiden. Hierzu muss dann eine Option im Event selber aktiviert werden.

[[Datei:cal_ext_auswahl_002.png]]

== Die Events ==
Die Events haben folgende neue Funktionen bekommen.

'''Event immer anzeigen''' 
Diese Option muss aktiviert werden, wenn das Event auch an einem Feiertag/Ferien angezeigt werden soll. Hierzu muss im Kalender die Option '''Events anzeigen''' aktiviert sein.

[[Datei:cal_ext_auswahl_005.png]]

=== Die Wiederholungen der Events ===
Hier ist mit Abstand am meisten passiert.

Anhand des Intervall und der Anzahl der Wiederholungen wird das Enddatum der Wiederholungen berechnet (war schon immer so), und zur Orientierung angezeigt. Ändern man die Anzahl der Wiederholungen, wird das Datum angepasst. Eine Liste der Wiederholungen wird in der Auswahl für die Ausnahmen gespeichert.

[[Datei:cal_ext_auswahl_007.png]]

=== Die Wiederholungen (erweitert) ===
In den erweiterten Wiederholungen ist es möglich Wiederholungen in einem anderen Intervall anzugeben, als es der Standard erlaubt.

Hier ist es nun möglich, zu sagen, ich möchte z.B. jeden dritten Mittwoch im Monat ein Event haben. Auch hier kann die Anzahl der Wiederholungen und Ausnahmen definiert werden. Die Handhabung ist hier identisch zu den normalen Wiederholungen.

[[Datei:cal_ext_auswahl_008.png]]

=== Die Ausnahmen ===
Die Anzahl der Wiederholungen, die im DropDown gespeichert werden kann in der Datei config.php eingestellt werden.
<source lang="php">
$GLOBALS['TL_CONFIG']['tl_calendar_events']['maxRepeatExecptions'] = 365;
</source>

Für die Wiederholungen können nun Ausnahmen definiert werden. Für die Erstellung einer Ausnahme können folgende Werten gesetzt werden können.

*'''Datum''' - Ist das Datum der Ausnahme. Hier kann ein vorhandenes Datum gewählt werden.
*'''Aktion''' - Hier stehen drei Möglichkeiten zur Auswahl
**'''nicht anzeigen''' - Das Event wird am Ausnahmetag noch angezeigt
**'''verschieben''' - Das Event wird verschoben.
**'''CSS Class hinzufügen''' - Das Event bekommt eine CSS Class ''exception''
*'''verschieben um''' - Wurde die Aktion ''verschieben'' gewählt, so kann hier das Event um diverse Tage verschoben werden
*'''Startzeit''' - neue Startzeit für die Ausnahme
*'''Endzeit''' - neue Endzeit für die Ausnahme

Der Bereich, um den ein Event verschoben werden kann ist ebenfalls konfigurierbar.
<source lang="php">
$GLOBALS['TL_CONFIG']['tl_calendar_events']['moveDays'] = 7;
</source>

Das gilt auch für die Uhrzeiten. In diesem Beispiel von 10:00 Uhr bis 22:00 im 30 Minuten Rhythmus.
<source lang="php">
$GLOBALS['TL_CONFIG']['tl_calendar_events']['moveTimes'] = '10:00|22:00|30';
</source>

Soll eine Ausnahme erstellt werden, bei der sich nur die Zeit des Events ändert, so wählt man die Aktion verschieben, verschieben um 0 Tage, und setzt die neuen Zeiten.

== Frontend Module ==
Um alle Events im Frontend ausgeben zu können, habe ich eine Class ''EventsExt'' erstellt, die von ''Events'' erbt, und diese entsprechend erweitert. Die neuen Module setzen darauf auf.

[[Datei:cal_ext_auswahl_009.png]]

=== KM Kalender ===
Hier gibt es die zusätzliche Auswahl der Ferienkalender.

=== KM Eventlist ===
Hier gibt es die zusätzliche Auswahl der Ferienkalender, und die Möglichkeit, Event Wiederholungen auszublenden.

=== KM Stundenplan ===
Hier gibt es die zusätzliche Auswahl der Ferienkalender, und einige neue Template Einstellungen.
*Datum anzeigen - Zeigt das Datum des Tages im Stundenplan an
*Leere Tage nicht anzeigen - Tage ohne Events werden nicht dargestellt
*Navigation anzeigen - Zeigt die Links für die Navigation der Kalenderwochen, wenn aktiviert
*Link "Aktuelle Woche" anzeigen - Zeigt einen zusätzlichen Link, der zur aktuellen Woche navigiert.

[[Datei:cal_ext_auswahl_010.png]]