cal - Event-Kalender für die eigene Homepage

Installation und Konfiguration von cal

• 1. Allgemeines
  • 1.1. Produktbeschreibung in Kürze
  • 1.2. Was kann cal?
  • 1.3. Voraussetzungen
  • 1.4. Lizenzbestimmungen
• 2. Installation
  • 2.1. Dateien kopieren und Berechtigungen setzen
  • 2.2. Script ausführen
• 3. Konfiguration
  • 3.1. Online Versions-Check
  • 3.2. Kategorien
  • 3.3. Datenbank-Sperre
• 4. Einbinden in die Homepage
  • 4.1. IFRAME
    • 4.1.1. Transparentes IFRAME
  • 4.2. Pop-Up

1. Allgemeines

1.1. Produktbeschreibung in Kürze

cal ist ein kleiner Event-Kalender für die eigene Homepage. Termine können auf einer Adminoberfläche oder wahlweise auch durch Besucher erfasst werden. Wiederkehrende Termine sind möglich. Einfache Installation. E-Mail Benachrichtigungen bei neuen, durch Benutzer eingetragenen, Terminen möglich. Unix/(Windows), deutsch, kostenlos.

Die Informationsseite zum Script inkl. Downloadmöglichkeit und Online-Demo finden Sie hier!

1.2. Was kann cal?

cal ist ein Event-Kalender für die eigene Homepage und bietet folgende Funktionen

• cal kommt ohne Datenbank aus. Die Events werden in einer Textdatei gespeichert.
• cal ist innert wenigen Minuten einsatzbereit
• Mittels Pop-Up oder IFRAME relativ einfach in bestehende Seite integrierbar
• Farben durch CSS-Stylesheet anpassbar
• Die gesamte Event-Verwaltung kann webbasiert erfolgen
• Wahlweise können auch Benutzer Termine erfassen und mittels ihrem individuellen Passwort ändern/löschen. Die Termine können entweder sofort oder erst nach Freigabe des Administrators für andere Besucher sichtbar sein)
• E-Mail Benachrichtigung bei neuen oder geänderten Terminen durch Besucher möglich.
• Es sind sowohl Termine innerhalb eines Tages, Termine über mehrere Tage als auch wiederholende Termine (jeden Mittwoch, jeden 3. des Monats, jeden Freitag, der 13., jeden zweiten Dienstag im Monat, jeden Donnerstag in einer geraden Kalenderwoche etc.) möglich.
• Eine automatische Berechnung des Ostersonntages erlaubt es auch, die christlichen Feiertage (von Fasnachtsmontag über Karfreitag bis Pfingsten) als wiederkehrende Termine zu erfassen.
• Dank effizientem Caching von Terminen auch für grössere Anzahl von Terminen geeignet (da das Script aber ohne Datenbank auskommt ist die Anzahl nach oben aber trotzdem eingeschränkt)
• HTML-Tags bei Events gestattet
• Frei definierbare Anzahl von Terminen, welche gleich auf der Hauptseite angezeigt werden.
• Termine können in Kategorien eingeteilt werden, welche zu einer anderen Darstellung in der Detailansicht führen (via Stylesheet konfigurierbar)

1.3. Voraussetzungen

Nebst Perl/CGI Unterstützung ist noch sendmail erforderlich. Ohne sendmail funktioniert der Kalender einwandfrei, nur die Benachrichtigung bei neuen Terminen ist nicht möglich. Zudem wird noch das Modul Time::Local benötigt, welches aber zum Standard-Umfang jeder Perl Distribution gehört.

1.4. Lizenzbestimmungen

Dieses Skript basiert auf den STANDARD-Lizenzbedinungen, die Sie unter http://www.cgicorner.ch/download/info.shtml oder in der Datei cgicorner.txt im ZIP-Archiv finden.

2. Installation

2.1. Dateien kopieren und Berechtigungen setzen

Folgende Dateien müssen kopiert und mit den entsprechenden Berechtigungen versehen werden:

Anmerkung: Die mit (*) gekennzeichneten Dateien befinden sich nicht im ZIP-Archiv und werden erst im Betrieb erstellt.

2.2. Script ausführen

Um das Script aufzurufen, stehen folgende URLs zur Verfügung:

3. Konfiguration

Die Konfiguration der wichtigsten Einstellungen wird direkt im Script (cal.cgi) vorgenommen:

Die Anpassung der Farben erfolgt im CSS-Stylesheet (style.css). Der Einsatzzweck der einzelnen CSS-Klassen ist direkt in dieser Datei dokumentiert.

3.1. Online Versions-Check

Der Online Versions-Check ist eine einfache Möglichkeit, zu überprüfen, ob die eingesetzte Version noch aktuell ist.

Um den Versions-Check zu starten, muss man auf den Link bei der Versions-Nummer unten rechts klicken. Danach wird eine Verbindung mit dem Server von cgicorner.ch hergestellt. Dazu ist eine Internet-Verbindung notwendig.

Es wird nur die Versionsnummer sowie das letzte Änderungsdatum an den Server von cgicorner.ch übermittelt. cgicorner.ch garantiert, dass keine weiteren Konfigurationseinstellungen oder Benutzerdaten gesendet werden. Der Browser übermittelt möglicherweise noch den Referer, der mögliche Informationen über den Einsatzort liefert. Wenn Sie dies nicht möchten, installieren Sie eine Personal-Firewall, welcher die Referer-Informationen blockiert oder kopieren Sie den Link in die Zwischenablage und fügen Sie ihn manuell in die Browser-Adressleiste ein.

3.2. Kategorien

In cal können mehrere Terminkategorien definiert werden, welche dann der Besucher und/oder Administrator einem Termin zuweisen kann. Diese Terminkategorien müssen im CSS-Stylesheet konfiguriert sein und können so in einer anderen Farbe, einer anderen Schrift etc. dargestellt werden. Um eine eigene Kategorie zu definieren sind zwei Schritte notwendig:

• push(@cat, "Wichtig"); muss um den Kategorienamen ergänzt werden. Der Name sollte keine Sonderzeichen enthalten
• im Stylesheet muss zum Kategorienname eine eigene Klasse definiert werden, analog zu "td.sbdetWichtig". Leerzeichen im Kategorienamen werden dabei entfernt.

Um nebst "Wichtig" noch eine Klasse "gruen" und "dies ist blau" hinzuzufügen, muss also folgendes in die cal.cgi eingetragen werden: push(@cat, "Wichtig","gruen","dies ist blau");

Ebenfalls muss die style.css noch um zwei Klassen ergänzt werden:

td.sbdetgruen {
  border-right: 1px solid #000000;
  border-bottom: 1px solid #000000;
  background: #aaffaa;
}
td.sbdetdiesistblau {
  border-right: 1px solid #000000;
  border-bottom: 1px solid #000000;
  background: #aaaaff;
}

3.3. Datenbank-Sperre

Ein Schreibzugriff auf die Datenbank führt eine Sperrung der Datenbank für weitere Zugriffe aus. Dadurch kann ein allfälliger Datenverlust durch zwei gleichzeitige Schreibzugriffe auf die Datenbank ausgeschlossen werden. Der Benutzer erhält eine Fehlermeldung, dass die Datenbank zur Zeit gerade durch einen anderen Benutzer gesperrt sei.

Falls die Datenbank nach einem Script-Absturz einmal dauerhaft gesperrt sein sollte, muss die .lock-Datei von Hand gelöscht werden (Lockdatei für data/cal.dat ist data/cal.dat.lock). Vor der manuellen Freigabe sollte geprüft werden, ob eine .tmp-Datei vorhanden ist und diese ggf. aktuellere Daten enthält. Falls ja, sollte diese Datei in den Namen der Datendatei umbenannt werden (z.B. data/cal.dat.tmp nach data/cal.dat umbenennen).

4. Einbinden in die Homepage

Es gibt zwei Möglichkeiten, den Kalender in die eigene Homepage einzubinden.

4.1. IFRAME

Der Kalender lässt sich mittels eines IFRAMES in eine bestehende Seite einbinden. Breite und Höhe sind Richtwerte und müssen evtl. je nach Anzahl Termine auf der Hauptseite und Schriftgrösse angepasst werden.

<iframe src="/cgi-bin/cal/cal.cgi" width="250" height="500" name="calendar" frameborder="0" scrolling="no">
Ihr Browser unterstützt keine IFRAMES.
<a href="/cgi-bin/cal/cal.cgi" target="_blank">Klicken Sie hier, um den Kalender in einem eigenen Fenster darzustellen</a>
</iframe>

4.1.1. Transparentes IFRAME

Gerade bei der Verwendung der ToolTip-Funktion ist es von Vorteil, das IFRAME etwas bereiter zu machen und so zu verhindern, dass dei Tips abgeschnitten werden. Dazu kann das IFRAME transparent gestaltet und über eine grössere Fläche gelegt werden.

style.css

body {
  background: #transparent;
}

Der Internet-Explorer benötigt im IFRAME-Tag noch ein Attribut allowTransparency="true".

Etwas komplizierter wird es, wenn nicht ausreichend Platz zur Verfügung steht und der Kalender rechtsbündig über bestehenden Text gelegt werden soll (Beispiel siehe Download-Seite von cal, http://www.cgicorner.ch/download/cal.shtml).

Auch hier ist die Anpassung des Stylesheets mit dem transparenten Body wieder erforderlich. Der Code für das IFRAME ist aber etwas komplizierter:

<div style="float: right; width:260px; height:500px;">&nbsp;</div>
<div style="position: absolute; right: 0px; width: 680px; margin: 0px; z-index: 1;">
<iframe src="/cgi-bin/cal/cal.cgi" width="680" height="500" name="calendar" frameborder="0" title="cal"
  longdesc="Webkalender" allowTransparency="true" scrolling="no">
  Ihr Browser unterstützt keine IFRAMES.
  <a href="/cgi-bin/cal/cal.cgi" target="_blank">
  Klicken Sie hier, um den Kalender in einem eigenen Fenster darzustellen</a></iframe>
</div>

Hierbei werden zwei DIV-Tags erstellt: der erste hat die Breite des Kalenders und verdrängt den Text. Breite und Höhe müssen ggf. angepasst werden.

Der zweite DIV-Tag ist deutlich grösser (700px) und liegt transparent über dem Text. Zusammen mit einem $alignFromRight=250 führt dies dazu, dass der Kalender mit einer Breite von 250 Pixel am rechten Rand dargestellt wird (also dort, wo der erste DIV-Tag den Platz dafür freigemacht hat), jedoch das IFRAME deutlich breiter ist und Tool-Tips problemlos Platz haben.

WICHTIG: Der DIV-Tag ist zwar transparent, liegt aber über dem bestehenden Text. An der Stelle, an der der DIV-Tag über dem Text liegt können keine Links angeklickt werden!

4.2. Pop-Up

<script language="JavaScript" type="text/javascript">
function PopUpFenster(url,framename,width,height,xpos,ypos) {
  if ( navigator.appName == "Netscape" ) {
    width = width + 14;
    height = height + 14;
    var attributes =  "menubar=0,toolbar=0,status=0,scrollbars=1,resizable=1,WIDTH=" + width + ",HEIGHT=" + height + ",screenX=" + xpos + ",screenY=" + ypos;
    var showpic = window.open(url,framename, attributes);
  } else {
    width = width + 14;
    height = height + 14
    var attributes = "menubar=no,toolbar=no,status=no,scrollbars=yes,resizable=yes,WIDTH=" + width + ",HEIGHT=" + height + ",screenX=" + xpos + ",screenY=" + ypos;
    var showpic = window.open(url,framename, attributes);
  }
}
</script>

Danach kann der Kalender mit folgendem Link aufgerufen werden:

Breite und Höhe sind Richtwerte und müssen evtl. je nach Anzahl Termine auf der Hauptseite und Schriftgrösse angepasst werden.