AddOn


Terminkalender (kal_termine)

Beschreibung

Dieses AddOn bietet ein System zur Verwaltung und Darstellung von Veranstaltungsterminen. Die Termine lassen sich in getrennt verwaltete Kategorien gliedern.

Ein Termin ist normalerweise ein Zeitabschnitt an einem einzelnen Tag. Er kann aber auch als Zeitbereich vereinbart werden, der sich über mehrere Tage erstreckt, oder als Zeitabschnitt eines Tages, der sich wöchentlich wiederholt.

Das AddOn umfasst
- eine zusätzliche Redaxo-Datenbanktabelle für die Termine
- eine Stylesheet-Datei für Farben und Formen der Kalendermenüs
- Funktionen zu Kalenderberechnungen
- Funktionen zur Darstellung von Terminlisten und Kalenderansichten
- einen Modul zur Verwaltung der Termine (im Backend)
- einen Modul zum Anlegen eines Start-Kalendermenüs (im Frontend)
- einen Modul zur Ausgabe einer Standard-Terminliste (im Frontend)

Die Terminverwaltung beinhaltet diese Funktionen:
- Eintragung eines Termins samt zugehörigen Daten in die Datenbanktabelle
- Löschung eines Termins
- Aktualisierung der Daten eines Termins
- Suche eines Termins mittels Kalendermenüs

Als Kalendermenüs stehen die folgenden Darstellungen zur Wahl:
- Monatsmenü, Tage mit eingetragenen Terminen sind schraffiert
- Monats-, Wochen-, Tagesblatt mit halbgrafischer Darstellung aller Termine
- Liste der Termine eines Zeitabschnitts (Monat/Woche/Tag) mit Filterfunktionen
- tabellarische Darstellung der Daten eines Termins

Alle Menüs sind untereinander verlinkt, sodass man von einem zum anderen wechseln kann. Das Monatsmenü gestattet das Blättern zum Vor- oder Folgemonat sowie zum gleichen Monat im Vor- oder Folgejahr. Gesetzliche und christliche Feiertage sind entsprechend markiert.


busch-dettum.de/public/it/dokumentation/kal_termine.html

Umsetzung

Wolfgang Busch

An der Windmühle 3
38173 Dettum

busch-dettum.de


Versionen

3.1

Für REDAXO
^5.3.0
Veröffentlicht am
02.10.2020

Es wird ein zusätzliches Such- und Filtermenü für Termine in einem beliebigen Zeitraum angeboten. Es ist mit allen bisherigen Menüs verlinkt.

Die Ausgabe einer Standard-Terminliste lässt sich organisatorisch wie die Ausgabe eines Kalendermenüs behandeln. Die entsprechenden Funktionen sind jetzt zusammen in einem neuen Modul integriert, sodass die bisherigen Module für das Frontend obsolet sind. Sobald Letztere durch den neuen Modul ersetzt sind, können sie gelöscht werden.

Die per Modul ausgebbaren Kalendermenüs sind jetzt eingeschränkt auf Monatsmenü, Monats-, Wochen-, Tagesblatt sowie auf das neue Zeitraumfiltermenü und zusätzlich auf die einfache Terminliste.

Der Modul zur Terminverwaltung gestattet in der installierten Form den Zugriff auf die Termine aller Kategorien ($katid=0 im Input-Teil). Er lässt sich aber leicht kopieren und die Kopie mit der Einschränkung auf eine spezifische Terminkategorie versehen ($katid=1 oder $katid=2 oder …). Auf diese Weise können Termine einzelner Kategorien von unterschiedlichen Redakteuren verwaltet werden.

3.0

Für REDAXO
^5.3.0
Veröffentlicht am
22.08.2020

Ein Termin wird nicht mehr ausschließlich als eintägig aufgefasst. Er kann sich jetzt auch über mehrere aufeinander folgende Tage erstrecken oder eine Folge von sich wöchentlich wiederholenden eintägigen Veranstaltungen darstellen.
Dementsprechend hat die Termintabelle ‘rex_kal_termine’ nun die zusätzlichen Spalten ‘tage’ und ‘wochen’. Erstere enthält die Anzahl der aufeinander folgenden Tage der Veranstaltung, Letztere die Anzahl der wöchentlichen Wiederholungen.

Mit dem Upgrade auf Version 3 erhalten alle vorhandenen Termine die Spaltenwerte tage=1 (eintägiger Termin) und wochen=0 (keine wöchentliche Wiederholung).

Die Termintabelle enthält jetzt anstelle der Spalte ‘kategorie’ mit der Bezeichnung der Terminkategorie eine Spalte ‘kat_id’ mit der Id der Terminkategorie. Die zugehörige Kategoriebezeichnung wird nur noch als Konfigurationsparameter abgelegt.

Mit dem Upgrade auf Version 3 wird die Tabelle entsprechend angepasst. Die Reihenfolge, in der die vorhandenen Kategorien in der Termintabelle auftreten, liefert die Werte der Kategorie-Ids (1, 2, …).

Die meisten Konfigurationsparameter müssen mit Version 3 neu definiert werden.

Die Farbtöne zur Darstellung der Termin- und Kalendermenüs werden jetzt auf Basis einer einzigen Grundfarbe generiert. Nur noch diese Grundfarbe ist zu konfigurieren; sie entspricht der bisherigen ersten Farbe (‘dunkle Schrift-/Rahmenfarbe’).
Die Parameter zur halbgrafischen Darstellung des Uhrzeit-Bereichs bei Tagesterminen enthalten zunächst Default-Werte und müssen angepasst werden.
Standardmäßig wird mit einer Neuinstallation jetzt nur genau eine Kategorie mit der Bezeichnung ‘Allgemein’ angelegt. Die vorhandenen Kategoriebezeichnungen werden in der neuen Konfiguration ergänzt.

Als erster Schritt eines Upgrades von einer älteren Version (<=2.2.1) sollte diese de-installiert werden. Ein re-install reicht nicht, um eine korrekte neue Konfiguration zu bekommen.

2.2.1

Für REDAXO
^5.3.0
Veröffentlicht am
14.03.2020

Kleinere Korrekturen am Programmcode zur Vermeidung von PHP-Warnungen.

2.2.0

Für REDAXO
^5.3.0
Veröffentlicht am
19.12.2019

Leider war die Version 2.1.0 fehlerhaft und i.w. unbrauchbar.
Die Konfiguration war nur in der Default-Version nutzbar. Eine Änderung führte in einigen Fällen auf eine fehlerhafte Verschiebung der Parameter. Der Fehler ist behoben.
Die Suchfunktion im Modul der Terminverwaltung führte nicht zum Ziel. Der Fehler ist behoben.
Die halbgrafische Darstellung der Stundenleiste war evtl. fehlerhaft. Der Fehler ist behoben.

2.1.0

Für REDAXO
^5.3.0
Veröffentlicht am
20.04.2019

Der Code ist mit ‘error_reporting(E_ALL);’ überprüft.
Die Verwaltung der Termine ist vollständig überarbeitet. Ein Termin, der zu löschen, zu korrigieren oder zu kopieren ist, wird nun mittels Durchklicken durch die (ja schon vorhandenen) Kalendermenüs gesucht.

2.0.0

Für REDAXO
^5.3.0
Veröffentlicht am
15.02.2019

Diese Version ist komplett überarbeitet und auf Redaxo 5 angepasst.

1.3 (November 2016)

Für REDAXO
4.7.x, 4.6.x, 4.4.x
Veröffentlicht am
24.08.2016

Überarbeitung der Installations-Prozedur:

Die PHP-Codes der beiden Module werden jetzt aus dem neuen Ordner “module” übernommen.

Die beiden folgenden Dateien werden bei der Erstinstallation neu erzeugt, aber nun im neuen Ordner “generated”:
- generated/settings.php ersetzt functions/function.settings.inc.php.
- generated/kal_termine.css ersetzt files/kal_termine.css.
- Der Ordner “files” entfällt.

Um ggf. vorgenommene Konfigurationen zu erhalten, sollte bei einer neuen Installation folgendermaßen vorgegangen werden:
- Re-Installation des AddOn
- Umbenennen der alten Datei functions/function.settings.inc.php in settings.php.
- Verschieben in den Ordner generated. Dabei wird die dort gerade erzeugte Datei überschrieben.
- Verschieben der alten Datei files/kal_termine.css in den Ordner generated. Dabei wird die dort gerade erzeugte Datei überschrieben.

Bei einer De-Installation des AddOns werden die beiden Dateien im Ordner “generated” gelöscht.