Integration von Events

Aus iTrack
Wechseln zu: Navigation, Suche
Übersicht
Name Event
Voraussetzungen keine
JavaScript empfohlen
Basis-URL http://lib.itrack.de/event/
Funktionen getByID
getByKey
getArchive
getRSSHeader
getRSSLink

Bitte beachten Sie die Angaben unter Modulintegration.

Inhaltsverzeichnis

[Bearbeiten] Funktionen

Übersicht der verfügbaren Funktionen
getByID Ausgabe eines speziellen Events anhand der Event-ID
getByKey Ausgabe einer Gruppe von Events als Liste anhand eines Musters
getArchive Ausgabe alter Events als Archiv anhand eines Musters nach Zeiträumen gegliedert
getRSSHeader Ausgabe eines Verweises auf den RSS-Feed in den Meta-Daten
getRSSLink Ausgabe eines Links auf den RSS-Feed

[Bearbeiten] EventTypen

[Bearbeiten] HauptTypen

Grundsätzlich liegt jedem Event dieselbe Datenstruktur zugrunde. Für das sinnvolle Arbeiten werden Events jedoch verschiedenen HauptTypen zugeordnet, wodurch sie sich in Bearbeiung und Ausgabe unterscheiden. Nicht alle davon müssen in Ihrem Sytem vorkommen. Es wird zwischen folgenden HauptTypen unterschieden:

[Bearbeiten] MasterDateien

Wenn Sie für die Ausgabe der Events nicht den Darstellungsmodus EVT_COMPLETE gewählt haben, wird ein Event in einer Kurzform ausgegeben. Sind dabei für dieses Event noch weitere Informationen gespeichert, wird die Anzeige um einen Link ergänzt, über den man auf die Seite für die vollständige Anzeige eines Events gelangt.

Wo diese Seite liegt, können Sie frei innerhalb Ihres Internetauftritts wählen. Die Adresse der Seite müssen Sie dann beim Aufruf einer Funktion durch einen Parameter übergeben (siehe jeweilge Funktionsbeschreibung).

Diese Seite muß innerhalb Ihrer WebSite angelegt werden wie folgt:

  1. Erstellen Sie die Datei innerhalb Ihrer WebSite mit der Endung php.
  2. Öffnen Sie die Datei in Ihrem Editor.
  3. Bearbeiten Sie die Seite, bis sie in Optik und Funktionalität Ihrem Bedarf entspricht.
  4. Wechseln Sie in Ihrem Editor ggf. zur Codeansicht.
  5. Bewegen Sie den Cursor an die Stelle, an der die Ausgabe des Events erfolgen soll.
  6. Rufen Sie die gewünschte Funktion an dieser Stelle mit folgendem Code auf:
    <?php include("http://lib.itrack.de/event/?getById&id=".$_GET['id']) ?>

Grundsätzlich können Sie auf derselben Seite auch mehrere Aufrufe nach obigem Muster einfügen. I.A. dürfte dies aber nicht zweckdienlich sein.

[Bearbeiten] Darstellungsmodus

Neben dem Typ werden die ausgegebenen Daten im Wesentlichen durch den Darstellungsmodus bestimmt. Für die Ausgabe von Events gibt es drei Darstellungmodi:

  • EVT_SHORT
    kurze Darstellung
  • EVT_SUMMARY
    kurze Darstellung mit Zusammenfassung
  • EVT_COMPLETE
    komplette Darstellung

[Bearbeiten] RSS

Dieses Modul ermöglicht Ihnen, Events über einen RSS-Feed zur Verfügung zu stellen. Eingebunden werden ausschließlich Events der betroffenen Gliederung, wenn sie einem Typ zugeordnet sind, der für RSS aktiviert ist. Die Aktualisierung des Feeds erfolgt, sobald ein betroffenes Event erstellt, geändert oder gelöscht wird. Die Ausgabe erfolgt in der RSS-Version 2.0.

[Bearbeiten] Voraussetzungen

Zur Aktivierung und Nutzung dieser Funktion müssen Sie folgende Voraussetzungen erfüllen:

  • Hinterlegen der FTP-Zugangsdaten im Modul Units
  • Hinterlegen von Root- und RSS-Verzeichnis sowie der MasterDatei im Modul Units (siehe Hinweise)
  • Intergration der RSS-Elemente (Links etc.) im Internetauftritt (Funktionen getRSSHeader, getRSSLink)
  • Hinterlegen von Events, die einem RSS-Typ zugeordnet sind

[Bearbeiten] Hinweise

  • Der Feed wird in die Datei news.rss geschrieben. Diese kann grundsätzlich in jedem Verzeichnis abgelegt werden. Sie können hierfür (per FTP) auch ein eigenes Verzeichnis anlegen.
  • Die „MasterDatei“ ist diejenige Datei, auf die ein Feed-Eintrag (Item) verlinkt ist und die das Item vollständig anzeigt. Nehmen Sie hierfür diejenige Datei, über die Ihre Events auf der WebSite vollständig anzeigt werden (siehe getByID oder getByKey). Systembedingt hat diese die Endung .php. Sie können hierfür auch eine eigene Datei erstellen unter Nutzung der Funktion getByID erstellen. Als Parameter bekommt die MasterDatei die ID des Events übergeben.
Meine Werkzeuge
Namensräume

Varianten
Aktionen
Navigation
Werkzeuge