Deutsch
English
dotplexDokumentation
Inhalt
Anzeige
Integration von GuestCal in eine Website
Es gibt grundsätzlich zwei Arten, GuestCal in eine Website zu integrieren:
Entweder passen Sie das Aussehen der GuestCal-Ausgabe über ein Template an das Layout der Website an, oder Sie binden GuestCal per <iframe> ein:
<iframe src="http://www.guestcal.de/demo/index.php" name="GuestCal" width="700" height="450" frameborder="0" scrolling="no"></iframe>
In beiden Fällen möchten Sie vielleicht die angezeigte Sprache, das Objekt oder das Jahr an GuestCal übergeben, weil Sie z.B. die Sprachauswahl schon auf Ihrer Website realisiert haben. Dazu können Sie folgende GET-Parameter verwenden:
| Variable | Beschreibung |
|---|---|
| lang | Sprachkürzel; de für Deutsch, en für Englisch |
| object | ID des anzuzeigenden Objekts. Diese können Sie im Admin-Bereich unter "Objekte" ablesen. Wenn Sie 0 übergeben, werden alle Objekte als Liste angezeigt. |
| year | Anzuzeigendes Jahr |
Folgendes Beispiel ruft das Objekt 1 für das Jahr 2010 in Englisch auf:
http://www.guestcal.de/demo/?lang=en&object=1&year=2010
Templates
Im Hauptverzeichnis von GuestCal sowie im Verzeichnis admin/ finden Sie den Ordner templates/. Dort können beliebig viele Ordner mit Templates erstellt werden, wobei z.Zt. das Template im Verzeichnis default/ automatisch verwendet wird.
Jedes Template besteht aus den HTML-Dateien head.php, foot.php sowie der CSS-Datei main.css. Diese können Sie beliebig anpassen, um das Aussehen von GuestCal zu verändern.
Installation
Paßwortschutz für den Admin-Bereich
GuestCal verfügt in dieser Version noch über keine Benutzerverwaltung. Sie sind selbst dafür verantwortlich, den Admin-Bereich entsprechend abzusichern. Wenn Sie GuestCal auf einem Apache-Server installieren, geht das am einfachsten über eine .htaccess-Datei. Es genügt, das Verzeichnis "admin/" mit einem Paßwort zu schützen. Eine Anleitung dazu finden Sie z.B. unter: http://de.selfhtml.org/servercgi/server/htaccess.htm#verzeichnisschutz
In den meisten Fällen bietet auch Ihr Webhosting-Provider eine einfache Möglichkeit, bestimmte Verzeichnisse zu schützen.
Problembehebung
Die Kalenderfarben werden nicht richtig dargestellt
Ursache:
Wenn die Kalenderfarben nicht richtig dargestellt werden, wird die automatisch generierte CSS-Datei vermutlich nicht mit dem MIME-Typ text/css gesendet. Dies passiert, wenn vor dem HTTP-Header schon Daten ausgegeben wurden. Unbeabsichtigt werden ein paar Zeichen gesendet, wenn eine Datei in UTF-8 mit BOM gespeichert sind.
Lösung:
Achten Sie beim Speichern der Datei config.inc.php darauf, daß Sie diese als UTF-8 ohne BOM speichern. Falls Ihr Editor den Zeichensatz nicht unterstützt, können Sie hilfsweise auch ISO 8859-1 (= Latin-1) verwenden.
Mein Provider Unterstützt PHP5 nur, wenn die Dateien auf .php5 enden
Benennen Sie in diesem Fall die Dateien index.php, css.php, admin/index.php sowie admin/setup/index.php in *.php5 um. Ändern Sie anschließend die Zeilen
<link rel="stylesheet" href="css.php" charset="utf-8"> bzw.
<link rel="stylesheet" href="' . BASEDIR . 'css.php" charset="utf-8">
in templates/default/head.php bzw. admin/templates/default/head.php wiefolgt um:
<link rel="stylesheet" href="css.php5" charset="utf-8"> bzw.
<link rel="stylesheet" href="' . BASEDIR . 'css.php5" charset="utf-8">