Linkgenerator
Hilfe


Logout

      Jomla XMLExport Modul 		Hilfe
Eine ausführliche Dokumentation zum XML Export ist in Arbeit. Um vorab schon mit diesem Tool arbeiten zu können ist hier eine kleine Anleitung wie Sie dabei vorgehen können.



1. Link erstellen
Um die Daten per XML abzurufen müssen Sie sich einen Link genrieren, in dem Sie festlegen welche Daten Sie über XML abrufen möchten. Ein Link setzt sich aus Vier bestandteilen zusammen.

Diese sind:

1. Nutzername
2. Nutzerpasswort
3. Was möchte ich abrufen
4. Aus welcher Liga oder welchen Verein möchte ich abrufen.

Sie können den Link selbst zusammen stellen oder mit dem Linkgenerator erstellen lassen.

2. Den Link nutzen
3.1. Wo sollten Sie den Link nutzen
Bitte achten Sie darauf das Sie den Link nur in Serverseitigen Dokumenten verwenden. Binden Sie diesen auf keinen Fall direkt in eine HTML Datei oder Javascript Datei ein, da Ihre Daten dort im klartext lesbar sind.

Im normalfall werden Sie den XML Dienst mit PHP oder einem vorgefertigtes Script nutzen. Sollte Ihnen der Begriff PHP nicht bekannt sein sollten Sie sich Hilfe beim XML Export suchen.

3.2. Wofür kann ich die XML Dateien nutzen?
Die Anwendungsmöglichkeiten für die XML Dienste sind sehr vielseitig. Primär ist es angedacht diese Daten bereitzustellen um Sie für Vereinsseiten und Presse zu Verfügung zu stellen. Sie können Beispielsweise mit Programmiersprachen wie C# oder PHP ausgelesen werden um auf der eigenen Homepage den Spielplan und die Tabellen der eigenen Mannschaften darzustellen. Es besteht aber auch die Möglichkeit damit Anwendungen zu erstellen die das Drucken dieser Daten möglich macht.


3.3. Benutzung mit PHP

Für PHP gibt es diverse XML Parser die die Auswertung unserer XML Dateien ermöglichen. Unter PHP 5 gibt es z.B. simpleXML wofür uns ein SIS Nutzer netter weise ein kleines Script geliefert hat.

<?php

// Abfragen der letzten Änderung der XML-Datei
$datei = 'naechsten_spiele.xml';
$LetzteAenderung = filemtime($datei);

// Zur Überprüfung kann man sich das Datum der letzten Aktualisierung ausgeben lassen; einfach die Schrägstriche am Anfang der folgenden Zeile entfernen

// echo"Die letzte Aktualisierung wurde am ", date("d.m.Y H:i:s", $LetzteAenderung), " durchgeführt.";

// Sofern die Datei älter als 30 min ist, wird sie neu heruntergeladen; Angabe erfolgt in Sekunden: 60*30=1800

if ( (time() - $LetzteAenderung) > 1800)
{
// Laden
$content = file_get_contents("http://link_zu_sis-handball.aspx");

// Parsen
$doc = DOMDocument::loadXML($content);

// damit die Datei überschrieben werden kann:
if (is_file($datei)) unlink($datei);

//Ausgeben
//echo $doc->saveXML();
//Speichern

$doc->save($datei);
}

if (file_exists($datei))
{

   $xml = simplexml_load_file($datei);
   
   echo "<html><head><link rel='stylesheet' href='http://www.deine-url.de/style.css' type='text/css'></head><body>";
   echo "<table class='tab'>";
   echo "<tr>";
   echo "<td class='a'>";
   echo "<b></b>";
   echo "</td>";
   echo "</tr>";
   echo "</table>";   
   echo "<table class='tab'>";

   foreach ($xml->Spiel as $platz)
   {
      echo "<tr>";
      echo "<td class='c'>";
      echo utf8_decode ($platz->LigaName);
      echo "</td>";
      echo "<td class='b'>";
      echo date('d.m.', strtotime ($platz->SpielDatum));
      echo "</td>";
      echo "<td class='b'>";
      echo date('H:i', strtotime ($platz->SpielVon));
      echo "</td>";
      echo "<td class='b'>";
      echo utf8_decode ($platz->Heim);
      echo "</td>";
      echo "<td class='b'>";
      echo ":";
      echo "</td>";
      echo "<td class='b'>";
      echo utf8_decode ($platz->Gast);
      echo "</td>";
      echo "</tr>";
    }
    echo "</table>";
    echo "</body></html>";

}
else
{
   exit('Konnte Datei nicht laden.');
}
?>



Außerdem gibt es eine Erweiterung für das Content Management System "Jomla" namens "SIS-Handballergebnisdienst". (Link Hier)

Als XML Parser können Sie z.B. auch miniXML benutzen. (http://minixml.psychogenic.com)


4. Weitere Hinweise zur Benutzung

4.1 Inhalte Cachen

Um Uns und Ihnen einen gefallen zu tun bietet es sich an die XML Dateien zwischen zu speichern. Legen Sie diese z.B. in einer Datenbank ab und aktualisieren sie den XML Abruf nur zu sinnvollen Zeiten.


4.2 XML Links nur selber benutzen

Da der Aufruf der XML Dateien ohne Passwort erfolgt ist der Aufruf theoretisch von jeder Person möglich. Wir bitten Sie jedoch diese Dateien nur selbst zu benutzen. Sollten wir Unregelmässigkeiten feststellen behalten wir es uns vor Nutzer zu sperren und gegebenenfalls den Aufruf zu erschweren.