Installierung

Vorbemerkung

Zum Anlegen der Benutzerzugänge verlässt sich zweiCal auf die Fähigkeiten Ihres Webservers: ein per .htaccess zugangsgeschütztes Verzeichnis mit einem oder mehreren Benutzern. Dieses Verzeichnis können Sie meist auf der Konfigurationssite Ihres Webhosters einrichten; oder per Kommandozeile, wenn Sie direkt Zugang zum Webserver haben. Oder verwenden Sie das Script edituseraccess.php (Download), das Ihnen die Benutzer komfortabel einrichtet.

zweiCal ist so sicher wie die Passwörter, die Sie für die Zugänge verwenden und den Benutzern mitteilen. Unbedingt sollten Sie für jeden Benutzer einen eigenen Zugang mit einem eigenen Passwort einrichten.

(A) Installierung lokal mit einem Benutzer

Zum Ausprobieren kann zweiCal lokal auf dem Arbeitsrechner (MAMP-, XAMP-, LAMP-, WAMP-, wasweißichAMP-Umgebung, integrierter Webserver von Mac OS X oder Linux etc.) installiert werden. zweiCal benötigt lediglich einen php-Interpreter. MySQL wird nicht benutzt. Der Kalender kennt nun einen einzigen Benutzer mit Schreiblesezugang, der sich nicht anmelden muss.

Installationsdateien

(B) Installierung auf einem Webserver mit mehreren angemeldeten Benutzern

Für einen Kalender, der von mehreren Benutzern nach Anmeldung gelesen und beschrieben werden kann, wird der komplette Inhalt des Verzeichnisses zweical auf einem Webserver in ein zugangsgeschütztes Verzeichnis hochgeladen. Alle Benutzer, die für dieses Verzeichnis eingetragen sind - etwa mit dem Script edituseraccess.php (Download) - haben Schreib- und Lesezugriff, mit Ausnahme des Benutzers "gast" der nur Lesezugriff hat.

(C) Installierung auf einem Webserver mit mehreren angemeldeten Benutzern und beliebig vielen Lesern

Für einen Kalender, der von mehreren Benutzern nach Anmeldung gelesen und beschrieben werden und zusäzlich auch von beliebig vielen Lesern aufgerufen werden kann, geht man folgendermaßen vor:

  1. Zunächst lädt man den kompletten Inhalt des Verzeichnisses zweical in ein nicht zugangsgeschütztes Verzeichnis calendar hoch (Name beliebig).
  2. Innerhalb dieses Verzeichnisses legt man ein weiteres, später zugangsgeschütztes Verzeichnis protected an. In dieses lädt man wiederum den kompletten Inhalt des Verzeichnisses zweical hoch, mit Ausnahme des Datenverzeichnisses data.
  3. In calendar/protected/config.inc wird die Zeile
    $datapath = "data";
    geändert in
    $datapath = "../data";
  4. Nun legt man für calendar/protected einen oder mehrere Benutzer mit Passwortzugang an, etwas mit dem Script edituseraccess.php (Download). Der Kalender kann jetzt über calendar/protected/ für Benutzer mit Passwortzugang erreicht werden und über calendar/ öffentlich für alle anderen nurlesend aufgerufen werden.

(D) Einbau in eine vorhandene Webseite

Eine bereits vorhandene zweiCal-Installierung für beliebig viele Leser kann leicht in eine Webseite eingeblendet werden, am einfachsten per iframe. Folgendes Codebeispiel erzeugt eine Kalendereinbindung:
<iframe src="dateipfad/zweical.php" name="zweiCal" width="800" height="600" marginheight="0" marginwidth="0" align="right" frameborder="0" scrolling="auto"></iframe>
Für eine solche Kalendereinbindung sollten Sie in config.inc ein kleines Thema oder eine Skalierung kleiner 1.0 einstellen.

(E) Update von älteren Versionen

zweiCal arbeitet seit Version 1.0 mit XML-Dateien als Datenbasis. Wenn Sie bisher eine ältere Version eingesetzt haben, müssen Sie Ihre Daten (für Termine, Einstellungen, Sondertage etc.) konvertieren. Das geht ganz einfach mit dem beiliegenden Script convert_data_to_xml.php im Verzeichnis convert. Kopieren Sie dazu das Script in das Verzeichnis von zweiCal oder in das Datenverzeichnis data und rufen Sie es auf. Nach dem Ausführen sollten Sie das Script wieder entfernen. Weiterhin können Sie nun alle alten .data-Dateien löschen.