Datefix stellt drei verschiedene Techniken für den Einbau zur Verfügung. Alle Methoden führen Sie in wenigen Minuten zum Ziel. In der Code-Variante ist die Methode A, die Einbindung mit der Include-Funktion, die gängige. Die anderen beiden stammen aus der Mietversion und können von Ihnen verwendet werden, um den Kalender auch auf Seiten anzuzeigen, die nicht auf Ihrem Server laufen. Beachten Sie, dass es sich hier um die Einbautechniken der Code-Version handelt, der Einabau der Mietversion ist hier beschrieben.

A: Einbindung als PHP-Include

In den Code-Varianten wird Datefix als Include-Datei mit drei Zeilen PHP-Code in jede beliebige PHP-Datei eingebunden eingebunden.

<?
$basePath="datefix/";
include($basePath."termine.php");
?>

Tragen Sie in $basePath den relativen Pfad zu Ihrer Datefix-Installation aus Sicht der Datei ein, aus der heraus Datefix aufgerufen wird.

Ein Beispiel: Sie wollen Ihre Veranstaltungen mit der von Ihnen programmierten Datei "events.php" und der Url "http://www.IhreDomain.de/events.php" aufrufen. Ihre Datefix-Installation befindet sich im Unterverzeichnis "datefix" und wird mit der Url "http://www.IhreDomain.de/datefix/index.php" erreicht. Für diesen Fall ist der oben genannte Code unverändert zu übernehmen. Liegt Ihre Datei "events.php" in einem Unterverzeichnis, etwa in der Form "http://www.IhreDomain.de/services/events.php" und Datefix wie im ersten Beispiel im Dokumenten-Hauptverzeichnis würde sich der Code wie folgt ändern.

<?
$basePath="../datefix/";
include($basePath."termine.php");
?>

Wenn Sie Ihre Datei "events.php" ins Datefix-Verzeichnis legen und mit der Url "http://www.IhreDomain.de/datefix/events.php" aufrufen würde der Code wie folgt aussehen.

<?
$basePath="";
include($basePath."termine.php");
?>

Achtung, funktioniert nicht mit Kalendern, die auf einem anderen Server laufen als die Datefix-Installation.

B: Der direkte Aufruf

Bei der Variante B rufen Sie die Datefix-Dateien direkt auf. Sie ist vor allem für den Einsatz in Frames oder mit dem <iframe>/<layer>-Tag gedacht, wenn dieDaten auf seiten angzeigt werden sollen, die sich nicht auf Ihrem Server befinden. Aber Sie können Datefix auch in dieser Variante in beliebigen HTML-Code einbetten. Einzelheiten finden Sie im Schritt 5 ("HTML/CSS") der Konfiguration.

Folgende Url führt direkt zu ihrer Terminsuchmaske beziehungsweise Tageskalender.

http://www.datefix.de/kalender/index.php

mit dieser Url kommen sie direkt zur Terminliste:

http://www.datefix.de/kalender/termine.php

Beachten Sie dass die Datei termine.php im Kalender-Verzeichnis nicht identisch ist mit der gleichnamigen Datei im Datefix-Stammverzeichnis, die Sie bei der Include-Variante einbinden.

C: Einbindung als Javascript

Bei der Variante C werden alle Funktionen übere eine Javascript-Konstruktion eingebunden. Damit ist es möglich, den Kalender an jeder beliebigen Stelle einer HTML-Seite einzubauen. Diese Seite muss sich nicht auf Ihrem Server befinden. Diese Lösung ist für Seiten im Tabellen-Layout oder mit einem komplexeren Design gedacht. Kopieren Sie folgenden Code und bauen ihn in an der Stelle in Ihren HTML- Quellcode ein, an der der Kalender erscheinen soll.

<script language="JavaScript" type="text/javascript" src="http://www.datefix.de/dfx.js"</script>

Über das <noscript>-Tag können Sie ganz einfach die User bedienen, die Javascript deaktiviert haben. Fügen Sie einfach folgenden Code hinzu und passen ihn ggf. Ihren Bedürfnissen an.

<noscript><a href="http://www.datefix.de/kalender/index.php" target="_blank">Zum Veranstaltungskalender</a></noscript>

Beachten Sie bitte, dass die Einbindung von eigenem HTML-Code in Schritt 5 ("HTML/CSS") der Konfiguration und die Festlegung von Farben für den Seitenhintergrung bzw Auswahl einer Hintergrundgrafik in Schritt 3 ("Design") keine Auswirkung in der Javascript-Variante haben.

Für alle Varianten gilt:

Die Links zum Termin-Eingabeformular für Webuser, zur Kartenbestellung und zum Anmeldeformular sowie den Community-Funktionen werden bei der Generierung von Listen und Detailansichten automatisch erzeugt.

Sie können jederzeit die Konfiguration Ihres Veranstaltungskalenders ändern. Grundeinstellungen, Rubriken und Community-Funktionen werden in den "Einstellungen" festgelegt. Wählen Sie Ihr bevorzugtes Design in Schritt 3, Farben und Schriften in Schritt 4. Im Bereich "HTML/CSS" haben Sie die Möglichkeit, eigenen HTML-Code und eigene CSS-Festlegungen einzugeben. Userdaten und Passwort werden unter "Userdaten" festgelegt.

Wie Sie Terminübersichten mit einer Rubrikabfrage verbinden, finden Sie in der Hilfe beschrieben. Die dafür notwendigen Links erhalten Sie auch, wenn Sie Schritt 2 ("Einstellungen") der Konfiguration ausführen. Sie können dies jederzeit tun, auch wenn Sie keine Einstellungen ändern wollen.

Die Terminbox wird unter Verwendung Ihrer Terminbox-Konfigurationseinstellungen für Umfang sowie Farben (Schritt 4,"Schrift/Farbe" ) wahlweise mit einem PHP-Include (außer Server-Paket) oder von einem Javascript erzeugt. Das PHP-Include funktioniert aber nur, wenn sich die Seite, in die es eingebaut wird, auf dem gleichen Server befindet wie die Datefix-Installation.

In beiden Methoden wird eine Tabelle generiert, die standardmäßig 100 % ihres Umfelds füllt. Das heißt, wenn Sie die Terminbox in einer Tabellenzelle mit eine Breite von 175 Pixeln anzeigen lassen, dann wird Sie 175 Pixel breit. Sie können in Schritt 2 der Konfiguration aber auch eine feste Breite in Pixeln einstellen. Unter Verwendung des Seiten- oder Tabellenzellenhintergrunds lassen sich im Zusammenspiel mit den Farb-Konfigurationseinstellungen interessante Effekte erzielen. Das Javascript erzeuft eine einspaltige Tabelle mit einem Zellzwischenraum von zwei Pixeln.

A: Einbau aus PHP-Include

<?
$basePath="datefix/";
include($basePath."terminbox_inc.php");
?>

Beachten Sie, dass Sie ggf die Variable $basePath an Ihre Konfiguration anpassen müssen. Es gilt das gleiche wie beim Einbau des Veranstaltungskalenders (siehe oben).

B: Einbindung der Terminbox mittels Javascript

1. Bauen Sie zunächst folgenden Code in Ihren Seitenkopf zwischen <head> und </head> ein:

<script language="JavaScript" src="http://www.datefix.de/terminbox.js"></script>

Vergessen Sie auf keinen Fall Ihre Kalender-Nummer in den Querystring einzutragen.

2. An der Stelle, an der Ihre Terminbox stehen soll, müssen sie diese Zeilen in den HTML-Code einfügen:

<script language="JavaScript">
<!--
terminbox();
//-->
</script>

Bedenken Sie, dass vielleicht ein Teil Ihrer User Javascript deaktiviert hat. Benutzen Sie das <noscript>-Tag, um diesem Besucherkreis zum Beispiel einen Link zu Ihrer Veranstaltungsübersicht anzubieten.

Die Zahl der angezeigten Überschriften und Kurzfassungen sowie weitere Einstellungen nehmen Sie in Schritt 6 ("Terminbox") der Konfiguration vor.

Hinter Datefix steckt kein großer Apparat und keine 24-Stunden-Hotline. Trotzdem sind wir bemüht, Ihnen bei Problemen oder Fragen so schnell wie möglich zu helfen.

Wenn etwas nicht so funktioniert, wie Sie es erwarten, dann schauen Sie bitte, wo vorhanden, zunächst in den Hilfe-Funktionen nach einer Lösung. Kommen Sie dort nicht weiter, hilft vielleicht die FAQ. Hier werden alle Fragen gesammelt, die im Zusammenhang mit Datefix aufgetaucht sind.

Wenn Sie auch dort keine Antwort finden oder glauben, Sie haben einen Bug im Programm gefunden (auch Datefix ist noch nicht perfekt), dann können Sie sich an uns wenden.

Wir bitten um Verständnis, dass wir keinen telefonischen Support leisten können, sondern nur den Weg über die E-Mail anbieten.

support@datefix.de

Sie erleichtern uns die Problemlösung und Fehlersuche, wenn Sie uns Ihr Problem möglichst genau beschreiben. Nennen Sie uns die Operationen, die sie ausführen wollen und mögliche Fehlermeldungen. Geholfen ist uns auch, wenn Sie uns den Namen des Scripts nennen, das versagt hat, zum Beispiel "schritt2_do.php".

Vergessen Sie bitte auf keinen Fall, uns Ihre Datefix-Usernummer (das ist die Zahl mit der Sie sich einloggen) und die URL ihrer Homepage, in die Datefix eingebunden ist, anzugeben.

Bedenken Sie bitte: Ungenaue Angaben erfordern Rückfragen, die die Fehlerbehebung verzögern.