Integration von Events

Version vom 14. August 2007, 10:04 Uhr

Bitte beachten Sie die Angaben unter Modulintegration.

EventTypen

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:

• News
• Termine
• Beschlüsse
• FAQs
• Jobs

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.

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

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.

Voraussetzungen

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

• Hinterlegen der FTP-Zugangsdaten im Modul Units
• Hinterlegen von RSS-Verzeichnis und News-Datei 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

Hinweise

• Der Feed wird in die Datei news.rss geschrieben. Diese kann grundsätzlich in jedem Verzeichnis abgelegt werden. Natürlich können Sie hierfür (per FTP) auch ein eigenes Verzeichnis anlegen.
• Die „News-Datei“ 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 vollständig anzeigt werden (MasterDatei) (siehe getByID oder getByKey).