Support Bereich Hier finden Sie Antworten auf alle Fragen zu Ihrem Xobor Forum.
Wählen Sie zunächst einen Hilfe-Bereich.

Ich habe mal das Lies mich hier angehangen.
Und zu gegeben ich verstehe nicht mal die Hälfte.
Was muss ich also tun damit ich diesen Kalender nutzen kann?
Ich habe webspace bei funpic.de

---

Kalender-Script - Anleitung


Das Kalender-Script ist eine Applikation zum Führen eines Veranstaltungskalender auf einem Webserver. Die Anwendung arbeitet mit PHP-Seiten und verlangt PHP ab Version 4.3.x auf dem Server. Eine serverseitige Datenbankunterstützung ist nicht erforderlich.

Das Kalender-Script unterstützt zusätzlich zu sonst üblichen Texteintragungen auch Bilder/Fotos sowie Dateianlagen innerhalb der Termineinträge. Das Eingeben und Ändern neuer Termin kann wahlweise entweder nur durch den Administrator oder alternativ auch durch die Besucher erfolgen. Bei Besuchereingaben wird zwischen Direkteingabe mit sofortiger Veröffentlichung oder Terminvormerkung zur späteren Freigabe durch den Administrator unterschieden.

Die Kalender-Script-Applikation ist nach Installation und Konfiguration sofort betriebsbereit. Funktion und Aussehen sind über die Konfiguration in weiten Grenzen frei einstellbar. Für ein individuelles Layout des Kalender-Scripts ist eine Anpassung mittels üblicher HTML-Werkzeuge möglich. Programmierkenntnisse in der Sprache PHP sind an keiner Stelle erforderlich.

Lesen Sie nachfolgend:

Installation und Rechtevergabe
Konfiguration
Kalenderstruktur/Terminstruktur
Kalenderfunktion
Kalenderfarben, MiniKalenderfarben
aktuelles Ereignis
individuelle Anpassung
Hauptschablone kalender.htm
Detailschablone detail.htm
CSS-Datei kalender.css
Das Zusatzprogramm Minikalender
Das Zusatzprogramm aktuelles Ereignis
Aufruf des Kalender- Scripts
Termineingabe in den Kalender
Vollversion


1) Installation
Das Programm Kalender-Script ist im Ordner kalender des Downloadarchivs enthalten. Kopieren Sie den gesamten Ordner kalender einschließlich aller enthaltenen Unterordner und Dateien auf den Webserver. Nach der Installation muss nebenstehende Ordnerstruktur auf Ihrem Server vorhanden sein:

Im Ordner kalender liegen die für die Besucher sichtbaren Seiten und Programmdateien sowie die Termindatenbank. Das ist auch das Aufruf- und Arbeitsverzeichnis für Besucher Ihres Kalender-Scripts.

Der Ordner admin enthält die für den Administrator bestimmten Programme, um das Kalender-Script während des Betriebes zu verwalten. Dieser Ordner ist nicht für Besucher gedacht und sollte mittels .htaccess-Datei vor unberechtigten Zugriffen geschützt werden. Ist ein solcher Zugriffsschutz auf Ihrem Server nicht möglich, so sollten Sie den Ordner admin so umbenennen, dass zufällige Besucherzugriffe ausgeschlossen werden.

Im Ordner bilder sind die grafischen Standardelemente des Kalender-Scripts gespeichert. Sofern Ihr Kalender mit Bildern/Fotos innerhalb der Termineinträge arbeiten soll, sind die Unterordner gross und klein für die Detailbilder und Vorschaubilder zu den Terminen notwendig. Anderenfalls können Sie diese Unterordner gross und klein löschen.

Der Ordner objekte nimmt die Dateianhänge zu den Kalenderterminen (Prospekte, Flyer etc.) zwecks Download durch die Besucher entgegen. Soll Ihr Kalender nicht mit Dateianhängen als Downloadobjekte arbeiten, können Sie diesen Ordner entfernen.

Ein eventuell vorhandener Ordner namens setup früherer Kalender-Script-Versionen entfällt ab Version 2.11.

Rechtevergabe während der Installation

PHP muss während der Konfiguration und im späteren Betrieb des Kalender-Scripts Daten in den Ordnern des Kalender-Scripts speichern können. Eine Vielzahl von Webservern ist so konfiguriert, dass PHP beliebige Schreiboperationen in Ihrem Web ausführen darf. In diesem Fall ist der folgende Abschnitt Rechtevergabe gegenstandslos. Etliche Server unterliegen aber auch Restriktionen beim Schreiben in den Webspeicher. In einem solchen Fall sind die folgenden Einzelheiten durch Rechtevergabe mittels Kommando chmod() zu gewährleisten.

Die folgende Tabelle zeigt die Ordner oder Dateien, die mit besonderen Rechten zu versehen sind, falls Ihr Server nicht automatisch Schreiberlaubnis für PHP besitzt. Die Übersicht stellt jeweils das Maximum an Rechten her, verringert aber die Sicherheit. Eventuell sind geringere Rechte auf Ihrem Server ausreichend.

Ordner /kalender 777 (drwxrwxrwx)
/kalender/objekte 777
/kalender/bilder/gross 777
/kalender/bilder/klein 777
/kalender/admin/temp 777
Dateien /kalender/termine.txt 666 (rw-rw-rw-)
/kalender/termine1.txt, termine2.txt, termine3.txt usw. 666
/kalender/vormerk.txt 666
/kalender/eingabe.txt 666
/kalender/kalender.css 666
/kalender/miniKal.css 666
/kalender/captcha.csv 666
/kalender/aktuell.php 766 (oder 666 ?)
/kalender/werte.php 766 (oder 666 ?)

Während der Konfiguration muss PHP die Dateien termine.txt, vormerk.txt sowie werte.php, eingabe.txt und kalender.css im Hauptverzeichnis kalender schreiben dürfen. Je nach Notwendigkeit werden wärend der Konfiguration Dateien mit den Namen termine1.txt, termine2.txt, termine3.txt usw. angelegt. Es muss PHP erlaubt sein, solche neuen Dateien zu schreiben.

Während des Betriebes muss PHP die Dateien termine.txt, termine1.txt, termine2.txt usw. sowie die Datei vormerk.txt im Hauptverzeichnis kalender beschreiben dürfen. Wollen Sie auch während des Betriebes Änderungen an der Funktion und am Aussehen des Kalenders über die Administratorseiten vornehmen, müssen auch die Dateien werte.php, eingabe.txt und kalender.css änderbar bleiben.

Sollen Besuchereingaben durch die Captcha-Funktion abgesichert werden, so muss PHP uneingeschränkt Dateien im Hauptverzeichnis kalender anlegen und löschen dürfen.

Soll Ihr Kalender mit Bildern/Fotos innerhalb der Termineinträge arbeiten, muss PHP während des Betriebes neue Dateien in die Unterordner gross und klein speichern dürfen. Soll Ihr Kalender mit Dateianhängen als Downloadobjekte innerhalb der Termineinträge arbeiten, muss PHP während des Betriebes neue Dateien in die Unterordner objekte speichern dürfen.

Für den eventuell gewünschten Export von Kalenderterminen als CSV-Datei (z.B. mit Microsoft-Excel® zu öffnen) muss PHP während des Betriebes in den Unterordner admin/temp speichern dürfen.

2) Konfiguration
Über die Konfiguration richten Sie in 3 Schritten das Kalender-Script ein. Sie rufen die Konfiguration über http://www.ihr-server.de/kalender/admin auf. Die 3 Schritte sind Kalenderstruktur, Kalenderfunktion und Kalenderfarben links oben im Menü des Admin-Bereiches.

2.1) Konfigurations-Schritt 1: Kalenderstruktur/Terminstruktur

Die Datenfelder des Kalenders können entsprechend den eigenen Bedürfnissen definiert werden. Die mitgelieferte Mustervorgabe ist lediglich ein Vorschlag. Entscheiden Sie sich bitte für die endgültige Terminstruktur, bevor Sie viele Termine eingetragen haben. Umbauten der Terminstruktur bei gefülltem Kalender sind nur eingeschränkt möglich.

Die Feldbezeichnungen werden im Besucherbereich zusammen mit den Feldinhalten angezeigt und sollten deshalb sinngebend gewählt werden. Die Feldnamen sind aus Buchstaben, Ziffern und aus den Sonderzeichen Bindestrich bzw. Unterstrich zu bilden. Andere Sonderzeichen, beispielsweise auch Leerzeichen sind nicht zulässig. Die Verwendung von deutschen Umlauten sollte keine Probleme bereiten, ist aber je nach Server auszutesten. Aus Platzgründen sollten Feldnamen keinesfalls länger als ca. 10..15 Zeichen sein.

Die im Demo vorgeschlagen Musterfelder können Sie vom Ende der Kalenderstruktur her löschen, indem Sie den Feldnamen entfernen und den Feldtyp auf den Standardtyp Text zurücksetzen.

Die Erklärung zu den Feldern ist eine Zusatzinformation und wird nur in den Eingabeformularen für Gäste im Besucherbereich verwendet. Hierüber können Sie Ihren Kalenderbesuchern Hilfestellungen zum Ausfüllen der einzelnen Datenfelder der Eingabemaske mitgeben.

Der Feldtyp bestimmt über die Behandlung der eingetragenen Daten durch das Kalenderprogramm. Falsche Angaben zum Feldtyp bedingen also eine falsche Darstellung und Verarbeitung der Feldinhalte. Das erste Kalenderfeld ist immer vom Typ Datum. Im Weiteren sind folgende Feldtypen möglich:

Text Textfelder sind einzeilige Datenfelder. Die Textlänge ist zwar nicht begrenzt, sollte aber im Interesse einer übersichtlichen Darstellung knapp gehalten werden.
Memo Memofelder sind mehrzeilige Textfelder für längeren Text. Zeilenumbrüche und Leerzeilen werden bei der Termindarstellung wie eingegeben dargestellt. In diesen Feldern sind Formatierungen möglich.
Preis Preisfelder nehmen Zahlenangaben entgegen und hängen automatisch das in den Kalenderfunktionen eingestellte Währungszeichen an. Die eingegeben Zahlen werden automatisch auf 2 Kommastellen gebracht.
Zahl Zahlenfelder nehmen Zahlen mit oder ohne Kommastellen entgegen. Für ein einheitliches Aussehen der Zahlen in Bezug auf die Zahl der Kommastellen ist bei der Eingabe selbst zu achten.
Datum Ein Datumsfeld speichert ein Datum im Format TT.MM.JJ. Die Ausgabe der Termine kann aber auch mit vierstelliger Jahreszahl sowie mit vorangestelltem oder nachfolgendem Kürzel für den Wochentag erfolgen.
Zeit Ein Zeitfeld nimmt eine Uhrzeit entgegen und formatiert sie in der Form hh:mm. Zusatzangaben wie das Wort Uhr werden nicht erwartet.
Ja/Nein Ein Ja/Nein-Feld läßt sich durch Ankreuzen des Kontrollkästchens auf den Wert Ja setzen. Unausgefüllt nimmt es automatisch den Wert Nein ein.
Auswahl Ein Auswahlfeld wird in den Eingabeformularen als aufklappbare Listbox mit vorbelegten Werten dargestellt. Es können ausschließlich die durch den Administrator vorgegebenen Werte für den Feldinhalt verwendet werden. Die Vorgabewerte können nach Anlegen und Speichern des Feldtypes Auswahl in einer Zusatzmaske im Admin-Bereich frei definiert werden.
Bild Bildfelder nehmen Grafiken der Typen JPG, GIF oder PNG entgegen und stellen bei der Terminanzeige die Bilder dar. Für Bilder existieren einstellbare Größenbegrenzungen.
Link Hyperlinks werden als ausführbare Verweise dargestellt. Das Kalenderprogramm unterscheidet selbständig e-Mail-Adressen von Webadressen und formatiert die Hyperlinks passend.
Objekt Downloadobjekte sind Dateien mit Zusatzinformationen zu einem Termin. Die Objekte werden vom Kalender als Link angeboten. In Frage kommen insbesondere PDF-Dateien bzw. Microsoft-Word®-Dateien oder Microsoft-Excel®-Dateien sowie eventuell ZIP-Archive sowie diverse weitere Dateitypen. Beachten Sie bitte, dass die Browser Ihrer Besucher mit solchen Dateiobjekten unterschiedlich umgehen und nicht jeder Besucher beispielsweise Microsoft-Excel-Dateien öffnen kann.
Paßwort Ein Feld vom Typ Paßwort ist nur notwendig, wenn Besucher deren zuvor eingetragenen Termine selbst ändern oder löschen können sollen. Wenn Sie eine solche Änderungsmöglichkeit planen, sollte das Paßwortfeld als letztes Datenfeld am Ende der Kalenderstruktur eingetragen werden.


Für die Arbeit mit von...bis-Terminen im Kalender gibt es zwei unterschiedliche Möglichkeiten.

In der Terminstruktur können Sie zwei Felder vom Typ Datum vereinbaren. Wenn Sie das zweite Datumsfeld an zweiter oder dritter Stelle innerhalb der Terminstruktur anlegen, wird das Kalender-Script dieses als Enddatum auffassen und beim Ausblenden/Löschen abgelaufener Termine nicht nur das Startdatum sondern auch ein eingetragenes Enddatum korrekt berücksichtigen. Der von...bis-Termin steht in diesem Fall aber nur einmalig in der Terminliste. Der Name für dieses zweite Datumsfeld steht Ihnen frei, es muss nicht zwingend Enddatum heißen.

Falls Sie kein zweites Datumsfeld in Ihrer Terminstruktur vereinbaren wollen (z.B. aus Platzgründen), so lassen sich von...bis-Termine auch wie folgt realisieren: Sie können dann im Administrationsbereich bei den Kalenderfunktionen die Funktion namens mehrtägige Termine zulassen und automatisch kopieren einschalten, indem Sie eine maximale Anzahl von zugelassenen automatisch erzeugten Terminkopien eintragen. Ist dieser Wert gesetzt, wird im Termineingabeformular automatisch ein zweites Datumsfeld angeboten, das Sie nicht extra definiert haben. Ein darin eingetragenes Datum wird als Endedatum aufgefasst und der Termin automatisch so oft als Kopie in den Kalender eingetragen bis das Endedatum erreicht ist, höchstens jedoch mit so vielen Kopien, wie Sie es in den Kalenderfunktionen als Maximalzahl erlaubt haben.

Die Darstellung der Kalendertermine erfolgt als Terminliste in tabellarischer Form oder in der Detailanzeige für einen ausgewählten Termin.

Mehrere Felder des Kalenders können zu Listenfeldern der Terminliste erklärt werden. Die Listenfelder werden in der tabellarischen Terminliste als Datenzeile zur Kurzdarstellung eines Termins herangezogen. Die Terminliste kann den gesamten Terminbestand des Kalenders auslisten oder nur die Ergebnisse einer Suchanfrage umfassen.

Erklären Sie nur die Felder als Listenfelder, die für eine Kurzcharakterisierung der Termine notwendig sind. Die zur Verfügung stehende Breite einer Tabellenzeile in der Terminliste ist leider schnell aufgebraucht. Memofelder und Paßwortfelder werden als Listenfeld nicht akzeptiert. Das erste Kalenderfeld mit dem Datum ist zwangsweise ein Listenfeld.

Werden Bildfelder als Listenfeld verwendet, wird in der Terminliste ein Vorschaubild geringer Größe verwendet. Die Maximalmaße dieser Vorschaubilder können im Schritt 2 der Konfiguration gesondert eingestellt werden.

Mehrere Felder des Kalenders können zu Sortierfeldern der Terminliste erklärt werden. Nach diesen Sortierfeldern kann die tabellarische Terminliste im Besucherbereich geordnet werden. Ein Sortierfeld wird im Tabellenkopf der Terminliste als Link dargestellt und erhält rechts neben seiner Feldbezeichnung ein Dreiecksymbol als Schalter. Über beide Bedienelemente kann ein Besucher die Terminliste in die gewünschte Sortierfolge versetzen. Pro Sortierfeld wird vom Kalenderprogramm eine separate Termindatei termine1.txt, termine2.txt, termine3.txt usw. geführt.

Nur Listenfelder können auch Sortierfelder sein. Die Feldtypen Memo, Zeit, Ja/Nein, Bild, Objekt und Paßwort sind als Sortierfelder nicht vorgesehen.

2.2) Konfigurations-Schritt 2: Kalenderfunktion

Der Schritt 2 der Konfiguration umfasst die Festlegung der Arbeitsweise einiger Kalenderdetails und ist ein weiten Teilen selbsterklärend. Beachten Sie, dass nur die Angaben leer bleiben sollten, bei denen diese Möglichkeit ausdrücklich genannt wird.

Bei der Angabe von Anzeigebreiten und Fenstergrößen sollten Sie bedenken, dass einige Surfer noch mit einer Bildschirmauflösung von 800x600 Punkten arbeiten. Stellen Sie möglichst keine größeren Werte für Breite oder Höhe ein. Falls Ihr Kalender-Script innerhalb von Frames läuft, sind die Werte dementsprechend anzugeben.

Für die Anzeige der Termindetails wird die Möglichkeit einer eigenen Layout-Schablone namens detail.htm angeboten, falls Ihnen das Standardlayout für die Termindetailanzeige nicht zusagt. Diese Schablonenseite detail.htm müssen Sie gemäß den Regeln des Abschnitts eigene Detailschablone selbst erstellen.

2.3) Konfigurations-Schritt 3: Kalenderfarben

Der Schritt 3 der Konfiguration umfasst die Definition der Farben der wesentlichen Kalender-Scriptelemente und ist weitgehend selbsterklärend. Die Farben werden unmittelbar in die Style-Datei kalender.css im Hauptverzeichnis des Kalenders eingetragen.

Es kann vorkommen, dass Sie die Farbänderungen nicht sofort im Besucherbereich des Kalender-Scripts sehen. Das liegt daran, dass die Style-Datei kalender.css von einigen Browsern im Cache gehalten wird. Betätigen Sie in diesem Fall im Besucherbereich den Befehl Aktualisieren oder Neu laden Ihres Browsers, um einen komplett neuen Seitenaufbau zu erzwingen.

2.4) Konfigurations-Schritt 4: Mini-Kalederfarben

Als Zusatzprogramm stellt das Script miniKal.php ein Monatsdatenblatt zur Verfügung. Für dieses Programm können die Farben unabhängig von den Farben des sonstigen Kaledner-Scripts eingestellt werden.

2.5) Konfigurations-Schritt 5: aktuelles Ereignis

Der demnächst eintretende Termin bzw. die nächsten stattfindenden Termine können durch das Zusatzscript aktuell.php als aktuelles Ereignis angeboten werden. Für dieses Zusatzprogramm sind vor Verwendung eine Reihe von Parametern und eventuelle Formate einzustellen.

3) individuelle Anpassung
Über die Möglichkeiten der Konfiguration und der Administration hinausgehend können Sie das Aussehen Ihres Kalender-Scripts einfach individualisieren. Dazu müssen Sie im Bedarfsfalle die Schablonenseiten kalender.htm und/oder die Schablone detail.htm verändern.

3.1) Die Hauptschablone kalender.htm

Aus der Hauptschablone kalender.htm erzeugt das Kalenderprogramm alle Seiten im Besucherbereich des Kalender-Scripts. Die Seite können Sie unter Beachtung folgender einfacher Regeln selbst gestalten.

Die Seite kalender.htm muss an zentraler Stelle den Platzhalter {Inhalt} enthalten. An dieser Stelle fügt das Kalenderprogramm bei jedem Seitenaufruf die Termindaten in das Schablonengerippe ein. Der Platzhalter {Inhalt} sollte möglichst zentriert auf die Seite gesetzt werden.

Der Platzhalter {Titel} kann ein oder mehrmals verwendet werden. An dieser Stelle wird eine Seitenbezeichnung eingesetzt.

Die Hauptschablone kalender.htm sollte unbedingt Hyperlinks auf die einzelnen Kalenderseiten Suchformular, Terminliste und Druckansicht enthalten. Die Verweisziele für diese Links lauten suche.php, index.php und druck.php.

Sofern Sie Besuchern des Kalender-Scripts das Eintragen oder Vormerken neuer Termine erlauben wollen, müssen Sie auch einen Link wie Termin eintragen mit dem Verweisziel eingabe.php auf die Hauptschablone setzen. Anderenfalls entfernen Sie diesen Verweis aus der mitgelieferten Musterschablone kalender.htm. Sollen Besucher deren selbst eingetragenen Termins später auch ändern/löschen können, so kann ein weiterer Link Termine ändern mit dem Verweiseziel aendern.php realisiert werden. Anderenfalls ist das Ändern zumindest über das Eingabe-Formular erreichbar. Ausserdem können Sie in der Hauptschablone noch einen Verweis auf die Liste der abgelaufenen Termine mit dem Ziel altes.php anbringen.

Die originale Schablone verwendet die CSS-Style-Datei kalender.css. Bitte beachten Sie, dass sich alle in der Konfiguration oder in der Administration eingestellten Farbwerte nur auf diese Style-Datei beziehen. Behalten Sie in der Hauptschablone kalender.htm unbedingt den Bezug zu dieser Style-Datei bei und nehmen Sie Farbeinstellungen für Ihre individuelle Seitengestaltung möglichst ebenfalls in dieser CSS-Datei und nicht direkt im HTML-Code der Seite kalender.htm vor.

3.2) Die Detailschablone detail.htm

Falls Ihnen das Standardlayout der Detailanzeige nicht zusagt, können Sie über die Schablonenseite detail.htm und die korrespondierende Einstellung in den Funktionseinstellungen des Kalender-Scripts ein eigenes Aussehen der Termindetails erreichen.

Die eigene Detailschablone detail.htm für das Hauptverzeichnis kalender ist eine übliche HTML-Seite mit Platzhaltern für die Termindaten. Sie haben bei der Erstellung dieser Seite jegliche gestalterische Freiheit. Überall dort, wo Termineintragsdaten dargestellt werden sollen, notieren Sie den Feldnamen des betreffenden Datenfeldes eingeschlossen in geschweifte Klammern {}.

3.3) Die CSS-Datei kalender.css

Über die Style-Datei kalender.css im Hauptverzeichnis kalender werden wesentliche Elemente der Hauptschablone kalender.htm sowie der dynamisch erzeugten Termindarstellungen im Besucherbereich formatiert. Der Bezug der Hauptschablone kalender.htm zu dieser Style-Vorlage muss stets erhalten bleiben. Einzelheiten in der CSS-Datei können Sie jedoch ändern.

Als Elemente mit besonderer Funktion in der CSS-Datei sollten erhalten bleiben:

table.dat Datentabelle In dieser Tabellenklasse werden alle innerhalb des {Inhalt}-Platzhalters generierten Tabellen angezeigt. Die Datentabellen werden ohne den border-Rahmen aber mit dem Attribut cellspacing="1" generiert, so dass die Hintergrundfarbe dieser Tabellenklasse wie ein Rahmen und Gitternetz um die Tabelle erscheint.
td.dat Zelle innerhalb der Datentabelle In dieser Klasse werden die Datenzellen innerhalb der als table class="dat" ausgegebenen Termintabellen angezeigt. Die Terminausgaben erfolgen also letztendlich auf der Hintergrundfarbe dieser Tabellenzellenklasse.
li.dat Aufzählung in der Datenzelle der Termine In diesem Format werden etwaige Aufzählungslisten innerhalb der Termindetails in Zellen mit dem Format td class="dat" ausgegeben.
td.dae Zellen innerhalb der Datentabelle für die Zeile mit dem aktuellen Ereignis In dieser Klasse wird die spezielle Datenzeile mit dem nächsten anstehenden Ereignis innerhalb der als table class="dat" ausgegebenen Termintabellen angezeigt.
a.dat Hyperlink in der Datenzelle der Termine In diesem Format werden die Hyperlinks innerhalb der Termindaten ausgegeben.
td.tit Kopfzeile über der Terminliste In dieser Klasse wird die Kopfzeile mit den Feldnamen über der Terminliste ausgegeben.
a.tit Hyperlink in der Kopfzeile der Terminliste In diesem Format werden die Hyperlinks zum Einstellen einer bestimmten Sortierfolge in der Kopfzeile der Terminliste ausgegeben.
td.dru Tabellenzelle in der Druckliste Mit diesem Format werden die Tabellenzellen der Terminliste in der Druckansicht dargestellt.
.err Fehlermeldung Mit dieser Subklasse werden Fehlermeldungen auf etwaige nicht korrekte Benutzereingaben formatiert. Die Standardeinstellung für diese Klasse ist rot und fett.
.ok Bestätigungsmeldung Mit dieser Subklasse werden Bestätigungsmeldungen auf Benutzereingaben formatiert. Die Standardeinstellung für diese Klasse ist grün und fett.
.mel Meldung/Aufforderung Mit dieser Subklasse werden Aufforderungen an den Benutzer formatiert. Die Standardeinstellung für diese Klasse ist fett in der Standardfarbe.


3.4) Das Zusatzprogramm Minikalender

Das Zusatzprogramm Minikalender ist ein kleines Monatskalenderblatt, das die Terminsuche im Kalender-Script unterstützen kann. Die Kalendertage eines Monats werden als Hyperlink dargestellt, sofern für den betreffenden Tag ein Termineintrag im Kalender-Script vorhanden ist. Außerdem produziert ein Klick auf den sichtbaren Monatsnamen im Minikalender einen Monatsauszug im Kalender-Script.

Der Mini-Kalender kann in zwei Varianten in das Kalender-Script integriert werden. Entweder in einem separaten Frame innerhalb eines Framesets oder als frei positionierbarer Bereich auf der Hauptseite des Kalender-Scripts. Eine Einbindung per Include in andere Seiten Ihres Webs ausserhalb des Kalenders ist (noch) nicht möglich.

Für den Fall der Verwendung von Frames wird der Minikalender in einem Frame mit dem Verweis miniKal.php aufgerufen. Für das Layout rund um den Minikalender in diesem Frame ist die HTML-Schablonenvorlage miniKal.htm im Besucherverzeichnis passend zu gestalten. Diese HTML-Seite kann völlig frei erarbeitet werden. Sie muss lediglich an geeigneter Stelle einen Platzhalter der Form {miniKal} enthalten. Damit die Verlinkung zum großen Kalender-Script funktioniert, muss das Kalender-Script selbst im Frame namens kalender laufen. Diese Art der Einbindung ist in der dem Download-Archiv beiliegenden Datei index.html demonstriert.

Im alternativen Fall der framelosen Positionierung des Minikalenders innerhalb der Hauptseite des Kalender-Scripts muss lediglich der Platzhalter {miniKal} in die Masterschablone kalender.htm an gewünschter Stelle einfügen werden. Dann sollte das beiliegende Muster-Frameset index.html nicht verwendert werden.

3.5) Das Zusatzprogramm aktuelles Ereignis

Das Zusatzprogramm aktuelles Ereignis kann das nächste oder die nächsten eintretenden Ereignisse in einem gesonderten Block ausserhalb und zusätzlich zur normalen Terminanzeige darstellen. Die Anzeige des nächsten Ereignisses kann sowohl innerhalb der Seiten des Kalender-Scripts als auch außerhalb dieser in beliebigen anderen Seiten Ihres Webs erfolgen.

Das aktuelle Ereignis kann auf drei unterschiedlichen Wegen aufgerufen werden. Eingebettet in die Seiten des Kalender-Scripts, als eigenständige PHP-Seite oder per include-Einfügung als eigener Bereich in beliebigen sonstigen PHP-Seiten Ihres Webs. Das Aussehen des aktuellen Ereignisses müssen Sie für alle 3 Fälle zuvor über die Administrator-Seiten einstellen.

Wenn Sie das aktuelle Ereignis zusätzlich innnerhalb Ihrer anderen Kalenderseiten präsentieren wollen, so bauen Sie lediglich in die Masterschablone an geeigneter Stelle den Platzhalter {aktuell} ein. Alles weitere erledigt das Kalender-Script dann von selbst.

Falls Sie das aktuelle Ereignis / die aktuellen Ereignisse auf einer sepataten Seite präsentieren wollen, so verlinken Sie auf das Script aktuelles.php. (Beachten Sie den Unterschied zwischen aktuelles.php und aktuell.php der dritten Aufrufvariante!) Eventuell eignet sich diese Seite aktuelles.php mit den wenigen Terminen sogar besser zum Einstieg in den Kalender als die Standardseite index.php.

Wenn Sie das aktuelle Ereignis in eine Ihrer anderen Seiten außerhalb des Kalender-Scripts einfügen wollen, so formulieren Sie in einer solchen sonstigen PHP-Seite an der Stelle, an der das aktuelle Ereignis erscheinen soll die Anweisung:

include('kalender/aktuell.php');

Dabei müssen Sie gegebenenfalls die Pfadangabe kalender/ durch gemäß Ihren Bedingungen präzisieren. Es wird durch diese Include-Anweisung nur ein HTML-Codeblock (Schnipsel) mit dem aktuellen Ereignis in Ihre Seite eingefügt.

4) Aufruf des Kalender-Scripts
Als üblichen Einstieg für Besucher in Ihren Kalender sollten Sie (sofern Ihr Kalender im Ordner /kalender installiert ist) die Adresse http://www.ihre-domain.de/kalender/index.php verlinken. Eventuell eignet sich aber auch die verkürzte Form nur mit den aktuellen Ereignissen http://www.ihre-domain.de/kalender/aktuelles.php besser. Falls Sie den zusätzlichen Minikalender eingebunden in ein Frameset verwenden wollen, so nutzen Sie als Einstieg die Datei index.html mit dem Frame-Set als http://www.ihre-domain.de/kalender/index.html.

In besonderen Fällen ist auch ein direkter Einstieg in eine gefilterte Kalenderliste möglich, wenn Sie über separtate Links jeweils nur bestimmte Termine anzeigen wollen. Falls Sie z.B. nur Termine mit dem Wert Dresden bzw. Berlin im Feld namens Ort auflisten wollen, so führt je ein Link http://www.ihre-domain.de/kalender/index.php?Ort1=Dresden bzw. http://www.ihre-domain.de/kalender/index.php?Ort1=Berlin zum Ziel. Falls Sie über einen Link nur die Termine eines bestimmten Monats wie Dez. 2007 anzeigen wollen, so ist ein Aufruf wie http://www.ihre-domain.de/kalender/index...Datum2=31.12.07 passend. Für die Termine des aktuellen Monats verlinken Sie auf den Aufruf http://www.ihre-domain.de/kalender/monat.php. Für eine Terminliste der abgelaufenen Termine verlinken Sie auf http://www.ihre-domain.de/kalender/altes.php.

5) Termineingabe in den Kalender
Für die Termineingabe in den Kalender gibt es unterschiedliche Szenarien. Dabei hat der Administrator in jedem Falle volle Kontrolle über alle Termine, egal auf welchem der folgenden Wege die Eintragungen ursprünglich in den Kalender gelangt sind.

5.1) Termineingabe und Änderung ausschließlich durch den Administrator

Im Admin-Bereich kann der Webmaster über die Menüpunkte neuer Termin weitere Termine eintragen. Über die Terminliste oder die Funktion Termine suchen kann der Administrator alle aufgelisteten Termine ändern, kopieren oder löschen.

Soll das die ausschließliche Möglichkeit der Terminpflege darstellen, so entfernen Sie im Besucherbereich den Link Termin eintragen aus der Masterschablone kalender.htm und löschen die Scripte eingabe.php und aendern.php aus dem Besucherbereich Ihres Kalenders.

Die Einstellung der Kalenderfunktion Direkteintrag durch Besucher ist in diesem Falle bedeutungslos.

5.2) zusätzliche Terminvormerkung durch Besucher

Sollen Besucher Ihres Webs Termine für den Kalender anmelden können, die aber erst nach Freigabe durch den Webmaster veröffentlicht werden, so ist in den Kalenderfunktionen das Feld Direkteintrag durch Besucher zu deaktivieren. Vom Besucher eingetragene Termine werden in einer nicht öffentlich sichtbaren Vormerkdatei gesammelt und der Webmaster wird per e-Mail über eine solche Terminvormerkung informiert.

Mittels des Menüpunktes Terminvormerkungen im Admin-Bereich kann der Webmaster eine solche Vormerkung im Originaltext freischalten, abändern und freischalten oder unveröffentlicht löschen. Beim Freischalten eines vorgemerkten Termins wird der Verfasser per e-Mail über die Freigabe seines Termins informiert.

Ob ein Besucher seinen freigeschalteten eigenen Termin nachträglich abändern kann oder nicht, entscheidet sich automatisch über das Vorhandensein eines Feldes Paßwort vom Typ Paßwort am Ende der Kalenderstruktur. Gibt es in der Kalenderstruktur ein Paßwortfeld, so wird im Formular Termin eintragen automatisch ein Link vorhandenen Termin ändern eingeblendet. Zusätzlich können Sie in der Masterschablone kalender.htm im Besucherbereich einen Link wie Termine ändern mit dem Verweisziel aendern.php anbieten.

Bei der Änderung eines sichtbaren Termins durch einen über das individuelle Paßwort autorisierten Besucher wird der geänderte Termin aus dem Kalender ausgeblendet und wiederum in die Vormerkdatei übernommen bis der Webmaster die Änderung erneut freischaltet.

5.3) zusätzlicher direkter Termineintrag durch Besucher

Sollen Besucher Ihres Webs Termine für den Kalender unmittelbar eintragen können, so ist in den Kalenderfunktionen das Feld Direkteintrag durch Besucher zu aktivieren. Damit werden Termine ohne Prüfung durch den Webmaster direkt nach dem Eintragen angezeigt. Der Webmaster wird lediglich zu Informationszwecken durch eine e-Mail über den neuen Termineintrag benachrichtigt. In diesem Falle empfehle ich allerdings, in den Kalenderfunktionen im Administrator-Bereich das Captcha als Schutz gegen Spam-Roboter einzuschalten.

Soll ein Besucher seinen eigenen Termin nachträglich abändern können, muß ein Paßwort-Feld vom Typ Paßwort am Ende der Kalenderstruktur angelegt sein. Gibt es dieses Paßwortfeld, so wird im Formular Termin eintragen automatisch ein Link vorhandenen Termin ändern eingeblendet. Zusätzlich können Sie in der Masterschablone kalender.htm im Besucherbereich einen Link wie Termine ändern mit dem Verweisziel aendern.php anbieten.

Vorgenommene Änderungen eines sichtbaren Termins durch einen über das individuelle Paßwort autorisierten Besucher werden unmittelbar im Kalender angezeigt. Der Webmaster wird über die vorgenommene Änderung per e-Mail informiert.

5.4) Termineingabe durch berechtigte Autoren

Anstatt der Termineintragung durch jedermann im Besucherbereich ist auch eine Eingabe durch berechtigte Autoren denkbar. Diese erhalten Zugang zu einem speziellen, durch Benutzernamen und Passwort geschützten Bereich und können dann ähnlich der Arbeitsweise des Administrators in diesem Autoren-Bereich Termine bearbeiten.

Dieses Feature als Unterordner /autoren ist im Downloadarchiv standardmäßig nicht enthalten. Bei Interesse kann diese Zusatzfunktion separat angefordert werden.

5.5) Terminimport aus einer Datei

Termine lassen sich auch aus einer externen Datei importieren. Der Import setzt ein Dateiquelle mit der Endung ".csv" oder ".txt" voraus, die in der ersten Zeile die Feldnamen in exakt der gleichen Reihenfolge und Schreibweise wie in der Kalenderstruktur beinhaltet. Ab der zweiten Zeile folgen dann die zu importierenden Daten. Alle Felder müssen durch Semikolon getrennt sein.

Am effektivsten erstellen Sie eine solche Importdatei aus einer Excel®-Datei, die in der ersten Zeile die Feldnamen und darunter die Daten enthält. Diese speichern Sie in Excel® mit dem Befehl "Speichern unter" als CSV-Datei.

Bilder und Objekte lassen sich auf diese Art und Weise nicht importieren. Es sei denn, das Bild/Objekt ist schon in einem anderen Termindatensatz online. Dann kann der Dateiname in einem Bildfeld oder Objektfeld des Importdatensatzes wiederholt eingetragen sein.

6) Vollversion
Die Demoversion unterliegt der Einschränkung, dass im Admin-Bereich sowie im Besucherbereich Termine zwar eingetragen aber nicht abgeändert werden können. Die Vollversion bestellen Sie online zu den aktuell gültigen Bedingungen.

---