Inhalts-Übersicht

• Aufruf und Einbindung des Kalenders
• Allgemeine Konfiguration
• Administration konfigurieren
• Terminliste konfigurieren
• Detailanzeige konfigurieren
• Benutzerverwaltung konfigurieren
• Eingabeformular konfigurieren
• Suchformular konfigurieren
• Informationsformular konfigurieren
• Kontaktformular konfigurieren
• Gesamt-Layout
• Einstellungen - Aktuelle Termine
• Einstellungen - Laufende Termine
• Einstellungen - Minikalender
• Terminstruktur einstellen
• RSS-Feed konfigurieren
• Datenbasis einstellen
• Individuelle Layout-Gestaltung
• Benutzer-Berechtigungen

1. Aufruf und Einbindung des Kalenders

In diesem Bereich erfolgt im ersten Teil die Anzeige aller Programme und deren Web-Adressen (URL). Diese Informationen benötigen Sie, um Ihren Kalender in eine vorhandene Website einzubinden.

Im zweiten Teil werden unterschiedliche Möglichkeiten einer Einbindung dargestellt, die sich grundsätzlich in zwei Arten der webseitigen Ausgabe (Frontend) dieser Software unterscheidet:

• Der Einsatz als eigenständige Seite (z.B. als IFrame).
• Oder integriert in eine andere PHP-Seite.

Alle Möglichkeiten sind mit Beispielen hinterlegt.

2. Allgemeine Konfiguration

In diesem Bereich werden die Grund-Einstellungen der Software festgelegt:

• E-Mail-Adressen des internen Nachrichtensystems
• Verweildauer der Termine
• Datumsformat
• Währungs- und Zahlenformat
• Zeichensatz
• Druckfunktion
• Popup-Fenstergröße und Fensterposition für das Druck-, das Detail-, das Benachrichtigungs- oder das Informations-Fenster, sofern diese als Popup geöffnet werden sollen. (Hinweis: Die eingetragenen Abmessungen gelten für alle Popup-Fenster.)
• Captcha zur Absicherung der Formulare

3. Administration konfigurieren

Die Darstellungen innerhalb der Administration werden in dieser Rubrik definiert. Auf das Frontend  (die webseitige Ausgabe, die der Besucher sieht) haben diese Einstellungen keine Auswirkung.

4. Terminliste konfigurieren

Die Terminliste ist eine Kurzübersicht der vorhandenen Termine, bzw. ein gefilterter Auszug der eingetragenen Termine. In diesem Bereich wird festgelegt, welche Felder in welcher Reihenfolge angezeigt werden sollen und wie insgesamt die Darstellung der Terminliste erfolgen soll. Dabei muss beachtet werden, das nur solche Felder für die Terminliste aktiviert werden, die für eine Kurzcharakterisierung der Termine absolut notwendig, bzw. sinnvoll sind, da die zur Verfügung stehende Breite einer Zeile in der Terminliste nur begrenzt zur Verfügung steht.

Zusatzhinweise:

• Werden Bildfelder als Listenfeld aktiviert, wird in der Terminliste ein Vorschaubild geringer Größe verwendet. Die Maximalmaße dieser Vorschaubilder können unter der Rubrik Eingabeformular eingestellt werden.
• Teminlisten-Felder können zu Sortierfeldern der Terminliste erklärt werden. Das bedeutet, nach diesen Sortierfeldern kann die tabellarische Liste vom Besucher geordnet werden. Ein Sortierfeld wird im Kopf der Terminliste als Link dargestellt und erhält rechts ein Dreiecksymbol als Sortier-Schalter.

5. Detailanzeige konfigurieren

In der Detailanzeige wird ein einzelner ausgewählter Termin dargestellt. In diesem Bereich wird festgelegt, welche Felder angezeigt werden sollen und wie insgesamt die Darstellung der Terminliste erfolgen soll (Die Reihenfolge ergibt sich aus der verwendeten Terminstruktur).

6. Benutzerverwaltung konfigurieren

Die Software unterscheidet die Besucher des Kalenders nach Gästen und angemeldeteten Benutzern. In der Standard-Einstellung können nur angemeldete Benutzer Termine eintragen und ändern. Innerhalb dieser Rubrik wird festgelegt, welche Daten eines Benutzers bei dessen Registrierung erfasst werden und in welcher Form diese freigeschaltet werden. Der Administrator kann unabhängig davon, stets neue Benutzer manuell anlegen.

Die Freischaltung neuer Benutzer kann auf zwei Arten erfolgen:

• Ein neuer Benutzer registriert sich und erhält anschließend eine E-Mail mit einem Freischaltlink. Damit kann er sein Benutzerkonto selber aktivieren.
• Ein neuer Benutzer registriert sich und der Administrator schaltet, nach Überprüfung das Benutzerkonto aktiv.
  Hinweis: Die Benutzer-Freischaltung hat keine Auswirkung auf die Art der Termin-Freischaltung.

In den E-Mail Mitteilungen, die das System versendet, werden Platzhalter (#..) benutzt, die von der Software, je nach Benutzer automatisch mit Daten gefüllt werden. Welche Platzhalter benutzt werden können und dessen Bedeutung ist links neben den Eingabe-Textfeldern vermerkt.

7. Eingabeformular konfigurieren

Über das Eingabeformular können Besucher Termineingaben vornehmen. Dabei wird die Art der Termin-Eingabe in zwei Arten unterschieden:

• Direkteintrag
  Bei einem Direkteintrag wird der Termin unmittelbar nach Eingabe sichtbar veröffentlicht.
• Terminvormerkung
  Bei einer Terminvormerkung wird der Termin zunächst gespeichert, aber nicht veröffentlicht. Erst nach Kontrolle und Freigabe durch den Administrator erfolgt die Veröffentlichung.
   

Sofern zu den Terminen auch die Möglichkeit einer Bild-Anzeige und/oder das Hinterlegen von Dateien (PDF etc.) angeboten werden soll, muss innerhalb der Terminstruktur ein Feld vom Typ Bild und/oder Typ Datei enthalten sein. Die Abmessungen und Dateigrößen werden ebenfalls in diesem Bereich definiert. Das System überprüft während des Uploads die angegebenen Werte.

Für die Termineingabe kann ein Periodikverhalten zugeschaltet werden. Das bedeutet, ein Termin kann damit über einen bestimmten Zeitraum mehrfach eingetragen werden. Nachdem ein periodischer Termin eingetragen und veröffentlicht wurde, entstehen daraus unabhängige Einzeltermine, die auch einzeln verwaltet werden.

Bei einem Termineintrag werden E-Mail Mitteilungen versendet. Innerhalb dieser Mitteilungen werden Platzhalter (#..) benutzt, die von der Software, je nach Benutzer automatisch mit Daten gefüllt werden. Welche Platzhalter benutzt werden können und dessen Bedeutung ist links neben den Eingabe-Textfeldern vermerkt. Hinweis: Für den korrekten Mail-Versand der Info- oder Freischalt-Mail an den Benutzer, ist es erforderlich, das innerhalb der Terminstruktur ein Feld vom Typ e-Mail existiert und im Eingabeformular aktiviert ist.

8. Suchformular konfigurieren

Für das Suchformular kann eingestellt werden, welche Felder der Terminstruktur im Suchformular dargestellt werden, bzw. durchsucht werden sollen. Zusätzlich kann eingestellt werden, wie oft und mit welcher Deutung ein Feld erscheint und ausgewertet wird. Das bedeutet, eine einmalige Verwendung eines Feldes bewirkt, dass nach dem eingetragenen Suchbegriff exakt gesucht wird. Eine zweimalige Verwendung eines Feldes bewirkt, das nach einem Bereich zwischen zwei Suchvariablen gesucht wird. Eine dreimalige Verwendung eines Feldes ist nur für Textfelder möglich und bewirkt, das zusätzlich im dritten Feld ein Suchbegriff ausgeschlossen werden kann.

9. Informationsformular konfigurieren

Das Informationsformular bietet die Funktion, über die ein Besucher eine andere Person auf einen Termin hinweisen kann. Das System generiert, je nach ausgewählten Termin,  eine E-Mail Mitteilung mit einem variablen Vortext, einem Link auf den konkreten Termin und einen Auszug der Termindetails.

Die Informationsfunktion kann aus der Terminliste und/oder aus der Detailanzeige heraus, über einen Link aufgerufen werden. Ob diese Funktion genutzt werden soll, wird innerhalb der Rubriken Terminliste und Detailanzeige eingestellt.

10. Kontaktformular konfigurieren

Das Kontaktformular bietet die Funktion, über die ein Besucher Kontakt zu dem Autor von einem Termin aufnehmen kann. Das System generiert, je nach ausgewählten Termin, eine E-Mail Mitteilung mit einem variablen Vortext, einem Link auf den konkreten Termin und einen Auszug der Termindetails.

Die Kontaktfunktion kann aus der Terminliste und/oder aus der Detailanzeige heraus, über einen Link aufgerufen werden. Ob diese Funktion genutzt werden soll, wird innerhalb der Rubriken Terminliste und Detailanzeige eingestellt.

11. Gesamt-Layout

In diesem Bereich werden im ersten Teil die Titel und das Layout der Navigationsleisten definiert, die über und unter den Terminen angezeigt werden. Im zweiten Teil werden die Farben hinterlegt, die in allen Bereichen verwendet werden. Alle Eingaben die hier über Formular-Felder eingegeben werden, hinterlegt das System in der Style-Datei kalStyle.css Alle Formatierungen können auch direkt in dieser CSS-Datei editiert werden. Einen Link zur direkten Editierung finden Sie am Ende von dieser Admin-Rubrik.

Hinweis: Wenn Farb-Einstellungen geändert wurden, dann werden diese im Frontend des Kalenders eventuell nicht sofort angezeigt, weil alte Dateien aus dem Browser-Speicher geladen werden (abhängig von den Browser-Einstellungen). In so einem Fall bitte die Funktion Aktualisieren/Seite neu laden des Browsers benutzen.

12. Einstellungen - Aktuelle Termine und Laufende Termine

Die Funktionen Aktuelle Termine und Laufende Termine sind Zusatzprogramme, die für den Einsatz auf Webseiten außerhalb von diesem System vorgesehen sind. Das bedeutet, diese Zusatzprogramme können auf einer externen Webseite als Info-Block dargestellt werden und verlinken direkt in dieses System.

• Das Zusatzprogramm Aktuelle Termine zeigt, je nach Einstellung, nur die Termine an, die als nächste(r) Termin(e), ab aktuellen Datum, stattfinden.
• Das Zusatzprogramm Laufende Termine zeigt, je nach Einstellung, nur die Termine an, die als aktuelle(r) Termin(e) jetzt stattfinden.

Diese Zusatzprogramme können auf zwei unterschiedlichen Wegen aufgerufen werden. Als eigenständige Seite (z.B. I-Frame) oder per include-Einfügung als eigener Bereich in beliebigen anderen PHP-Seiten der Website.

Falls diese Zusatzprogramme z.B. als I-Frame eingebunden werden sollen, dann erfolgt eine direkte Verlinkung auf das jeweilige Script aktuelleTermine.php bzw. laufendeTermine.php. Bitte beachten: Damit die Verlinkung von diesen Zusatzprogrammen zu der Termin-Detailanzeige im gewünschten Fenster Ihrer Website angezeigt wird, muss das Zielfenster (Target) passend eingestellt werden.

Wenn diese Zusatzprogramme in eine externen PHP-Seite eingebunden werden sollen, ergänzen Sie die folgenden include-Befehle:

Dabei muss gegebenenfalls die Pfadangabe kalender/ gemäß Ihren Bedingungen angepasst werden. Es wird durch diese Include-Anweisung nur ein HTML-Codeblock (Schnipsel) mit dem aktuellen Ereignis in Ihre vorhandene Seite eingefügt.
Damit die Zusatzprogramme im passenden Layout erscheinen, ist ggf. der Verweis auf die CSS-Datei des Kalenders herzustellen. Das sollte im Kopfteil des aufrufenden PHP-Scripts so erfolgen:

13. Einstellungen - Minikalender

Die Funktion Minikalender ist ein Zusatzprogramm das für den Einsatz auf Webseiten außerhalb von diesem System vorgesehen ist. Dieses Programm erzeugt ein Monats-Kalenderblatt, das die Terminsuche im Kalender unterstützt. Alle Kalendertage, die einen Termin enthalten, werden als Link dargestellt, und verlinken auf die Detail-Ansicht des Termins.

Der Minikalender kann auf zwei unterschiedlichen Wegen aufgerufen werden. Als eigenständige Seite (z.B. I-Frame) oder per include-Einfügung als eigener Bereich in beliebigen anderen PHP-Seiten der Website.

Falls dieses Zusatzprogramm z.B. als I-Frame eingebunden werden soll, dann erfolgt eine direkte Verlinkung auf das Script miniKalender.php. Bitte beachten: Damit die Verlinkung von dem Minikalender zu der Termin-Detailanzeige im gewünschten Fenster Ihrer Website angezeigt wird, muss das Zielfenster (Target) passend eingestellt werden.

Wenn der Minikalender in eine externen PHP-Seite eingebunden werden sollen, ergänzen Sie die folgenden include-Befehle:

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

Dabei muss gegebenenfalls die Pfadangabe kalender/ gemäß Ihren Bedingungen angepasst werden. Es wird durch diese Include-Anweisung nur ein HTML-Codeblock (Schnipsel) mit dem Minikalender in Ihre vorhandene Seite eingefügt.
Damit der Minikalender im passenden Layout erscheint, ist ggf. der Verweis auf die CSS-Datei des Kalenders herzustellen. Das sollte im Kopfteil des aufrufenden PHP-Scripts so erfolgen:

14. Terminstruktur einstellen

Innerhalb von diesem Bereich können die Datenfelder des Kalenders in Anzahl, Art und Reihenfolge, entsprechend den eigenen Bedürfnissen, definiert werden. Die Struktur der Termine ist frei wählbar. Das Feld Nummer vom Typ Zählnummer und ein Feld vom Typ Datum müssen am Anfang der Terminstruktur immer vorhanden sein. Es empfiehlt sich (aus Platzgründen) , die Feldbezeichnung möglichst kurz zu gestalten (ca. 10-15 Zeichen).

Die Erklärung zu den Feldern ist eine optionale Zusatzinformation und wird nur in den Eingabeformularen eingeblendet. Damit können Sie Ihren Kalenderbesuchern Hilfestellungen zum Ausfüllen der einzelnen Datenfelder mitteilen.

Der Feldtyp bestimmt, wie die Software das Feld darstellt und die eingetragenen Daten verarbeitet. Falsche oder unlogische Zuordnung des Feldtyp, können zu einer mangelhaften Darstellung und/oder Verarbeitung der Feldinhalte führen. Es ist deshalb wichtig, das Änderungen in diesem Bereich äußerst sorgfältig durchgeführt werden. In der folgende Tabelle werden alle möglichen Feldtypen mit einer kurzen Erklärung aufgelistet:

15. RSS-Feed konfigurieren

Mittels diesem Zusatzprogramm können Sie, bei Bedarf, ein RSS-Feed von Ihrem Kalender erzeugen. Dieser Feed gibt Informationen gemäß RSS-Spezifikation über eine Terminauswahl, die innerhalb der Admin-Rubrik RSS-Feed eingestellt wird. Sowohl der Inhalt der Inforamtionen, ein Terminintervall, ein Auswahlfilter und eine Sortierfolge können hier definiert werden.

16. Datenbasis einstellen

Das Programm speichert sämtliche System-Daten standardmäßig in Text-Dateien auf dem Webserver. Diese Art der Datenspeicherung ist effizient und für die meisten Anwendungsfälle völlig ausreichend.. Sollte Ihr Kalender jedoch mehrere tausend Termine beinhalten und/oder sollten Sie eine Benutzerverwaltung mit sehr vielen registrierten Benutzern betreiben, kann unter Umständen die Datenspeicherung in einer MySQL-Datenbank von Vorteil sein.

Die Software kann jederzeit, auch während des Betriebes, von einer Art der Datenspeicherung auf die jeweils andere Datenquelle umgeschaltet werden. Alle Termindaten und Benutzerdaten werden dabei übernommen. Lediglich eventuell vorhandene Terminvormerkungen, die zu diesem Zeitpunkt vom Administrator noch nicht freigeschaltet sind, gehen bei einem Wechsel der Datenbasis verloren.

17. Individuelle Layout-Gestaltung mittels Templates

Mit der Administration können bereits viele Veränderungen an dem Layout des Kalenders vorgenommen werden. Darüber hinaus kann die Web-Ausgabe zusätzlich im Layout individualisiert werden. Dafür stehen Templates (Vorlagen) zur Verfügung, mit denen die webseitige Ausgabe beeinflusst werden kann. Hinweis: Verwenden Sie diese Möglichkeit nur dann, wenn gute HTML- und CSS-Kenntnisse vorhanden sind. Die zur Verfügung stehenden Templates werden nachfolgend beschrieben. Alle Templates befinden sich im Verzeichnis /kalender.

Alle Templates und dessen Einsatz-Bereich:

• kalSeite.htm - wird vom Programm für alle Seiten der Termin-Ausgabe benutzt.
• kalListenKopf... kalListenZeile.htm - Layout der Terminliste
• kalDetail.htm - Layout der Termin-Detailansicht
• kalPopup.htm - Layout der Popup-Fenster
• kalDruck.htm - Layout der Druckansicht
• aktuelleTermine... aktuelleKopf... aktuelleZeile.htm - Layout vom Zusatzprogramm Aktuelle Termine
• laufendeTermine... laufendeKopf... laufendeZeile.htm - Layout vom Zusatzprogramm Laufende Termine
• miniKalender.htm - Layout vom Minikalender

Alle Templates basieren auf üblichen HTML-Code. Falls Sie die Möglichkeit einer zusätzlichen Layout-Gestaltung über die Templates nutzen möchten, schauen Sie sich bitte zunächst die hinterlegten Templates an. Hinweis: Nicht alle Templates enthalten eine komplette HTML-Seite mit Header und Footer, teilweise sind nur HTML Code-Fragmente notwendig für den Einsatz des jeweiligen Templates. Verwenden Sie deshalb auch nur einen einfachen Text-Editor, um Templates zu bearbeiten. Viele HTML-Editoren fügen automatisch fehlenden Header- und Footer-Code ein. Das führt allerdings zu einer fehlerhaften Web-Ausgabe.

Wenn Sie in einem Bereich ein individuelles Templates benutzen möchten, muss teilweise innerhalb der Administration die Ausgabe des Standard-Layout umgestellt werden auf ein individuelles Layout. Erst dann verwendet das System das von Ihnen editierte Template. Falls Ihnen bei der Template-Umprogrammierung Fehler unterlaufen sind, die zu einer mangelhaften Anzeige führen, dann verwenden Sie einfach aus dem vorliegenden Programm-Archiv, die Original Template-Dateien und bauen darauf erneut auf.

18. Benutzer-Berechtigungen

Bei der Eingabe und Änderung von Terminen können unterschiedliche Berechtigungen eingestellt werden. Im Auslieferungs-Zustand der Software können der Administrator und angemeldete, registrierte Benutzer Termine eintragen und ändern.

Termineingabe und Änderung ausschließlich durch den Administrator.
Der Administrator kann grundsätzlich über den Admin-Bereich Termine verwalten neue Termine eintragen oder vorhandene Termine ändern. Soll das die ausschließliche Möglichkeit der Terminpflege darstellen, dann entfernen Sie innerhalb der Admin Rubrik Gesamt-Layout die Navigations-Links Eintragen, Ändern, Anmelden und Abmelden (Die entsprechenden Link-Texte innerhalb der Eingabefelder Anzeige oben und Anzeige unten komplett löschen.)

Termineingabe und Änderung auch durch registrierte Benutzer. (Standard)
Sollen registrierte Benutzer Termine eintragen und ändern können, so ist die Benutzerverwaltung zu aktivieren, indem in die Terminstruktur ein Feld vom Typ Benutzer (jedoch kein Feld vom Typ Passwort) aufgenommen wird.

Termineingabe und Änderung auch durch Gäste
Sollen Gäste (unangemeldete, unregistrierte Besucher) Termine für den Kalender eintragen können, dann muss innerhalb der Terminstruktur ein Feld vom Typ Passwort aufgenommen werden, damit sichergestellt ist, das unregistrierte Gäste auch nur den per Passwort zugeordneten Termin nachträglich ändern können.
Hinweis: Der Gast-Modus ist in den meisten Einsatzfällen nicht zu empfehlen, weil Termin-Eingaben und dessen Autoren nur schwer kontrollierbar sind. Wenn der öffentliche Eintrag von Terminen gewünscht ist, dann sollte das insgesamt nur über registrierte Benutzer erfolgen.