Entwickler

Für das Content-Management-System Joomla stehen Komponenten und Module bereit, die einfach installierrt werden können, um auf die Events der Community zuzugreifen. Sie können diese Komponenten auf dieser Seite downloden. Für WordPress sind Extensions in der Enwicklung. Für andere Systeme, kann die FastBroadcast-API über eine Klassenlibrary angesprochen werden, die hier auch zum Download bereit steht.

Mit den PHP-Klassenlibrary von FastBroadcast können Entwickler eigene Kalender erstellen, die auf die Daten von FastBroadcast zugreifen. Der folgende Code-Schnipsel zeigt den Zugriff auf Veranstaltungen der Hamburger Salsaszene:

// laden der Klassenlibrary
require_once dirname(__FILE__).'/FastBroadcast.class.php';
 
// FastBroadcast erstellt einen HTTP-Client
$httpClient = FastBroadcast::HttpClient();
 
// Die Parameter für den Methodenaufruf werden in ein Array geschrieben
$params = array (
    'scenes'        => 'salsa',
    'catgroups'     => 'event',
    'period'        => 'week',
    'ccty'          => 'Hamburg',
    'responsegroup' => 'medium');
 
// Mit den Parametern wird die GetEventList-Methode aufgerufen
$retcode = $httpClient->GetEventList( $params );
 
if ( $retcode != FastBroadcast::SUCCESS ) {
    // Minimale Fehlerbehandlung für Demo
    die ( FastBroadcast::GetLastErrorMessage() );
}
 
// Der Aufruf war erfolgreich und das Result kann verwendet werden 
$result = $httpClient->Result();
 
var_dump( $result['eventlist'] );

Das gezeigte Beispiel liefert alle Events der Hamburger Salsasszene der aktuellen Woche in einem PHP-Array zurück. Die Webseiten CrossBody.de und Mindandlife.de sind gute Beispiele, wie gezielt die Daten selektiert werden können.

Die hier vorgestellte Methode GetEventList ist die wichtigste Methode der API. Die Möglichkeiten der Einstellung sind umfangreich. Die einzelnen Parameter können kombiniert werden, um gezielt für eine bestimmte Region Events einer bestimmte Szene und Kategorie zu selektieren.

Es ist sinnvoll, nicht direkt mit den Events in dem zurückgelieferten Array weiter zu arbeiten, sondern über eine Eventobjekt der Klassenlibrary, dann bleibt der Code auch bei Änderungen an der Array-Struktur valide.

// FastBroadcast erzeugt ein Objekt der Klasse FastBroadcastCalendarEvent
// Die Eventklasse wird benötigt, um den Zugriff auf die zurückgegebenen 
// Events sicherer zu machen. Der Quellcode wird dadurch auch besser lesbar
$event = FastBroadcast::CreateEvent();
 
// Die ganze Eventliste wird in dieser foreach-Schleife gelesen.        
foreach ( $result['eventlist'] as $event_array ) {
 
    // Die einzelnen Event-Arrays werden an ein Objekt 
    // der Klasse FastBroadcastEvent übergeben 
    $event->SetEvent( $event_array );
 
    // TODO: Die Rückgabewerte des Eventobjekts in HTML-Code einbetten
    // Beispiel hier die Ausgabe des Titels 
    echo $event->Summary() . '<br />';
}
 

Hier soll nur gezeigt werden, wie die Klassenlibrary zu benutzen ist. Die FastBroadcast-Library zur Ausgabe von Kalendern mit Anwendungsbeispielen können Sie hier downloaden. Für Fragen, Anregungen und Vorschläge nutzen Sie bitte gern das Forum.