Der Einbau des Veranstaltungskalenders

Datefix stellt drei verschiedene Techniken für den Einbau zur Verfügung. Alle Methoden führen Sie in wenigen Minuten zum Ziel. Beachten Sie, dass es sich hier um die Einbautechniken der Mietversion handelt, der Einabau der Code-Version ist hier beschrieben.

Außerden finden Sie am Ende dieser Seite Anleitungen, wie Sie die "Terminbox" einbauen und wie Sie den Tageskalender mit der Suchmaske getrennt von den Terminlisten variabel an einer beliebigen Stelle im Design einbauen.

A: Der direkt Aufruf

Bei der Variante A rufen Sie die Datefix-Dateien direkt auf. Sie ist vor allem für den Einsatz in Frames oder mit dem <iframe>/<layer>-Tag gedacht. 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 ihrem Veranstaltungskalender. Ersetzen Sie "IhreKalenderNr" durch Ihre individuelle Kalender-Nummer:

http://www.datefix.de/kalender/<i>IhreKalenderNr</i>/index.php

Wichtig ! Ihre Kalender-Nummer ist nicht identisch mit Ihrer Datefix-Usernummer, mit der Sie sich zur Administration einloggen. Beide Nummern erhalten Sie unmittelbar nach Ihrer Anmeldung per E-mail. Drucken Sie sich diese E-mail aus und heben Sie sie gut auf.

B: Einbindung als Javascript

Bei der Variante B werden alle Funktionen übere eine Javascript-Konstruktion eingebunden. Damit ist es möglich, den Kalender an jeder beliebigen Stelle einer HTML-Seite einzubauen. Diese Lösung ist für Seiten im modernen CSS-Design oder im Tabellen-Layout gedacht. Kopieren Sie folgenden Code und bauen ihn in an der Stelle in Ihren HTML- Quellcode ein, an der der Kalender erscheinen soll. Vergessen Sie nicht, "IhreKalenderNr" durch Ihre individuelle Kalender-Nummer zu ersetzen.

 <script language="JavaScript"type="text/javascript" src="http://www.datefix.de/dfx.js?kid=<i>IhreKalenderNr</i>"></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/<i>IhreKalenderNr</i>/index.php" target="_blank">Zum Veranstaltungskalender</a></noscript>

Testen Sie den Einbau. Erscheint ihre Terminliste korrekt, müssen Sie anschließend unbedingt im Konfigurationsbereich "Accountdaten/System" die Url zu Ihrer neuen Veranstaltungsseite anpassen, weil sonst ein Großteil der Links und Funktionen zu Fehlern führen.

Wenn Sie die Javascript-Variante lokal testen wollen, ist es unbedingt erfoderlich, dass Sie dabei eine funktionierende Internetverbindung haben.

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 Seitenhintergrund bzw Auswahl einer Hintergrundgrafik in Schritt 4 ("Schriften/Farbe") keine Auswirkung in der Javascript-Variante haben.

C: Einbindung mit den CURL-Funktionen von PHP

Die Scriptsprache PHP, die heute in nahezu allen Webserver-Tarifen enthalten ist, verfügt über einen Satz Funktionen, mit denen HTML-Code von einem anderen Server abgerufen und in die eigene Seite eingebunden werden kann. Ermöglicht wird dies durch eine als CURL bekannte PHP-Erweiterung. Der Vorteil: Der HTML-Code des Kalenders wird Bestandteil Ihrer Seite und kann zum Beispiel von Suchmaschinen bessser erfasst werden als Jvascript. Leider unterstützt aber nicht jeder PHP-fähige Server CURL Sollte Ihr Server CURL nicht unterstützen, erhalten Sie eine entsprechende Fehlermeldung beim Ausführen des Codes.

Einbauanleitung: Bauen Sie eine Seite für Ihren Veranstaltungskalender mit allem umgebenden HTML-Elementen. Fügen Sie an der Stelle, an der der Kalender erscheinen soll, den im Kasten stehenden PHP-Code ein.Ersetzen Sie den Text "IHRE_KALENDERNUMMER" in Zeile 2 durch Ihre Kalendernummer (nicht Usernummer). Speichern Sie die Datei mit der Endung ".php" ab und laden diese auf Ihren Webserver.

<?php
$kid = IHRE_KALENDERNUMMER;
$zieldatei= "termine.php";
// Ende Konfigurationsbereich, ab hier bitte keine Änderungen im Code vornehmen
  
$queryString = '?kid='.$kid;
$arParams=array("kid", "tid", "lid", "vid", "uid", "rubrik_nr", "item_start", "id_veranstalter", "id_location", "personen", "dfx_tpl", "nat", "kw", "t", "m", "alle", "plzarea", "user_id", "ort", "region", "veranstalter", "vst", "rubrik", "suche", "sendArt", "dfxquery", "kquery", "aktion", "ref", "code", "init", "do", "datum_von_tag", "datum_von_monat", "datum_von_jahr", "datum_bis_tag", "datum_bis_monat", "datum_bis_jahr", "ref");
foreach($arParams as $param){
  	if(isset($_REQUEST[$param])){
 		$queryString.='&'.$param.'='.$_REQUEST[$param];
  	}
}
$url = "http://www.datefix.de/".$zieldatei.$queryString;
if(function_exists('curl_init')){
  $dfxfp = curl_init($url);
  curl_setopt($dfxfp, CURLOPT_RETURNTRANSFER, 1);
  curl_setopt($dfxfp, CURLOPT_USERAGENT, 'Datefix-Curl-Script');
  curl_setopt($dfxfp, CURLOPT_REFERER, $_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']);
  if($_POST) {
  	if($_FILES['img']['size'] > 0){
  		$typ=strtolower(substr(strrchr($_FILES['img']['name'],"."),1));
  		if($typ=="jpg" ||$typ=="jpeg" || $typ=="png" || $typ=="gif"){
  			rename($_FILES["img"]['tmp_name'],$_FILES["img"]['tmp_name'].".".$typ);
  			$_POST['img']='@'.$_FILES["img"]['tmp_name'].".".$typ;
  		}else{
  			echo "<b>Fehler beim Dateiupload: </b>Ung&uuml;ltiges Dateiformat ($typ) - nur gif, png und jpg erlaubt</b><br />";
  		} 
  	}
  	curl_setopt($dfxfp,CURLOPT_POST,1);
  	curl_setopt ($dfxfp, CURLOPT_POSTFIELDS, $_POST); 
  }
  curl_setopt($dfxfp, CURLOPT_CONNECTTIMEOUT, 10);
  $pageContent = curl_exec ($dfxfp);
  $dfxfp_info = curl_getinfo ($dfxfp);
  if($dfxfp_info['http_code'] == '200'){
  	$pageContent = str_replace("http://_HOST_/", "http://".$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']	 , $pageContent);
  	echo $pageContent;
  } else {
  	echo 'Der Veranstaltungskalender ist derzeit nicht verf&uuml;gbar oder arbeitet fehlerhaft. Gesendeter Code: '.$dfxfp_info['http_code'];
  }
}else{
  echo "CURL wird von Ihrem Webserver nicht unterst&uuml;tzt, wenden Sie sich gegebenenfalls an Ihren Provider"; 
} 
?>

Beachten Sie beim Einbau in CMS-Systeme wie Joomla, Wordpress oder Contenido, dass für den Einbau von PHP-Code oft besondere Module oder Anleitungen notwendig sind. Bitte wenden Sie sich bei Fragen an die Support-Foren dieser Systeme.

Wenn Sie die CURL-Variante lokal testen wollen, ist es unbedingt erfoderlich, dass Sie dabei eine funktionierende Internetverbindung haben.

Direkte Aufrufe von Rubriken, Orten oder Veranstaltern

Wie Sie Terminübersichten mit einer Rubrikabfrage oder Filtern nach Orten oder anderen Parametern 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.

Getrennter Einbau von Veranstaltungsliste und Tageskalender/Suchmaske

Mit den Einbaumethoden "Javascript" und "CURL" ist es möglich, den Tageskalender mit der integrierten Suchmaske unabhängig von der Terminliste an einer beliebigen Stelle der Internetseite einzubauen. Unter "Einstellungen" im Konfigurationsbereich müssen Sie dazu die Anzeiges des Tageskalenders zunächst deaktivieren.

Einbau mit CURL: Kopieren Sie das folgende PHP-Script an die Stelle, an der der Tageskalender erscheinen soll.

<?php
$kid = IHRE_KALENDERNUMMER;
$zieldatei= "kalender_curl.php";
// Ende Konfigurationsbereich, ab hier bitte keine Änderungen im Code vornehmen
  
$queryString = '?kid='.$kid;
$arParams=array("kid", "tid", "lid", "vid", "uid", "rubrik_nr", "item_start", "id_veranstalter", "id_location", "personen", "dfx_tpl", "nat", "kw", "t", "m", "alle", "plzarea", "user_id", "ort", "region", "veranstalter", "vst", "rubrik", "suche", "sendArt", "dfxquery", "kquery", "aktion", "ref", "code", "init", "do", "datum_von_tag", "datum_von_monat", "datum_von_jahr", "datum_bis_tag", "datum_bis_monat", "datum_bis_jahr", "ref");
foreach($arParams as $param){
  	if(isset($_REQUEST[$param])){
 		$queryString.='&'.$param.'='.$_REQUEST[$param];
  	}
}
$url = "http://www.datefix.de/".$zieldatei.$queryString;
if(function_exists('curl_init')){
  $dfxfp = curl_init($url);
  curl_setopt($dfxfp, CURLOPT_RETURNTRANSFER, 1);
  curl_setopt($dfxfp, CURLOPT_USERAGENT, 'Datefix-Curl-Script');
  curl_setopt($dfxfp, CURLOPT_REFERER, $_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']);
  curl_setopt($dfxfp, CURLOPT_CONNECTTIMEOUT, 10);
  $pageContent = curl_exec ($dfxfp);
  $dfxfp_info = curl_getinfo ($dfxfp);
  if($dfxfp_info['http_code'] == '200'){
  	$pageContent = str_replace("http://_HOST_/", "http://".$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']	 , $pageContent);
  	echo $pageContent;
  } else {
  	echo 'Der Veranstaltungskalender ist derzeit nicht verf&uuml;gbar oder arbeitet fehlerhaft. Gesendeter Code: '.$dfxfp_info['http_code'];
  }
}else{
  echo "CURL wird von Ihrem Webserver nicht unterst&uuml;tzt, wenden Sie sich gegebenenfalls an Ihren Provider"; 
} 
?>

Einbau mit Jvascript: Kopieren Sie folgenden Code an die Stelle in Ihrem HTML-Code, an der der Tageskalender erscheinen soll.

<script language="JavaScript"type="text/javascript" src="http://www.datefix.de/kalender_javascript.js?kid=<i>IhreKalenderNr</i>"></script>

Einbau der Terminbox

Die Terminbox wird unter Verwendung Ihrer Terminbox-Konfigurationseinstellungen für Umfang sowie Farben (Schritt 4,"Schrift/Farbe" ) von einem Javascript erzeugt oder mit der PHP-Funktion CURL eingebunden.. Es wird dabei ein Container generiert, der standardmäßig 100 % seinesUmfelds 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.

Einbau mit Javascript: Fügen Sie folgenden Code an der Stelle ein, an der die Terminbox erscheinen soll: Ersetzen Sie "IhreKalenderNr" durch Ihre Account-Nummer.

 <script language="JavaScript"src="http://www.datefix.de/tbox.js?kid=<i>IhreKalenderNr</i>"></script>

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

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.

Einbau mit CURL: Kopieren Sie den folgenden, mit Ihren Daten vorkonfiguruierten PHP-Codet an die Stelle, an der die Terminbox erscheinen soll.

<?php
$kid = IHRE_KALENDERNUMMER;
$zieldatei= "tbox_curl.php";
// Ende Konfigurationsbereich, ab hier bitte keine Änderungen im Code vornehmen
  
$queryString = '?kid='.$kid;
$arParams=array("kid", "tid", "lid", "vid", "uid", "rubrik_nr", "item_start", "id_veranstalter", "id_location", "personen", "dfx_tpl", "nat", "kw", "t", "m", "alle", "plzarea", "user_id", "ort", "region", "veranstalter", "vst", "rubrik", "suche", "sendArt", "dfxquery", "kquery", "aktion", "ref", "code", "init", "do", "datum_von_tag", "datum_von_monat", "datum_von_jahr", "datum_bis_tag", "datum_bis_monat", "datum_bis_jahr", "ref");
foreach($arParams as $param){
  	if(isset($_REQUEST[$param])){
 		$queryString.='&'.$param.'='.$_REQUEST[$param];
  	}
}
$url = "http://www.datefix.de/".$zieldatei.$queryString;
if(function_exists('curl_init')){
  $dfxfp = curl_init($url);
  curl_setopt($dfxfp, CURLOPT_RETURNTRANSFER, 1);
  curl_setopt($dfxfp, CURLOPT_USERAGENT, 'Datefix-Curl-Script');
  curl_setopt($dfxfp, CURLOPT_REFERER, $_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']);
  curl_setopt($dfxfp, CURLOPT_CONNECTTIMEOUT, 10);
  $pageContent = curl_exec ($dfxfp);
  $dfxfp_info = curl_getinfo ($dfxfp);
  if($dfxfp_info['http_code'] == '200'){
  	$pageContent = str_replace("http://_HOST_/", "http://".$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']	 , $pageContent);
  	echo $pageContent;
  } else {
  	echo 'Der Veranstaltungskalender ist derzeit nicht verf&uuml;gbar oder arbeitet fehlerhaft. Gesendeter Code: '.$dfxfp_info['http_code'];
  }
}else{
  echo "CURL wird von Ihrem Webserver nicht unterst&uuml;tzt, wenden Sie sich gegebenenfalls an Ihren Provider"; 
} 
?>

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

Wenn etwas nicht so klappt, wie es sollte

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 ha".

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 und verzögern die Bearbeitung Ihrer Anfrage.