get_events_by_ids

Funktion
Liefert eine Liste von Veranstaltungen nach Veranstaltungs-IDs. Dies ist insbesondere nützlich, falls Sie eine freie Liste zusammenstellen möchten, die nicht über Zielgruppen, Bereiche, Serien oder Ähnliches definiert werden kann, z.B. eine Themenreihe, die sich über verschiedene Veranstaltungen zieht.
Sie können die Abfrage durch weitere Parameter eingrenzen, um z.B. eine Anzeige nach Monaten oder einzelnen Seiten zu generieren, ohne dass immer sämtliche Veranstaltungen übertragen werden müssten. Das „Datum von“ kann nicht in der Vergangenheit liegen, da VEROWA nur aktuelle Veranstaltungen öffentlich zeigt.
Die Parameter „auszuschliessende Veranstaltungen“ und „nur spontan Zugängliches zeigen“ machen in dieser Funktion nur selten Sinn. Der Konsistenz wegen sind sie aber trotzdem verfügbar.

Eingabe
•  Veranstaltungs-IDs (STRING), z.B. „5418, 6033, 8240“ (leer = alle Veranstaltungen)
•  Datum von (INT), Format JJJJMMDD
•  Datum bis (INT)
•  Offset (INT), z.B. „40“ für die dritte 20er-Seite: 40 Events werden übersprungen
•  max. Anzahl Veranstaltungen (INT): z.B. „20“
•  IDs der auszuschliessenden Veranstaltungen (STRING), z.B. „5418“
•  nur spontan Zugängliches zeigen (BOOL)

Ausgabe
•  Veranstaltungen (ARRAY)
    •  event_id (INT)
    •  date_from : Startdatum und -zeit, Format „JJJJ-MM-DD HH:MM:SS“ (STRING)
    •  date_to : Enddatum und -zeit (STRING)
    •  hide_time : soll die Uhrzeigt verborgen werden? (BOOL)
    •  date_text : z.B. „Montag, 6. Mai 2013, 15.00–17.00 Uhr“ im HTML-Format (STRING)
    •  title : Titel (STRING)
    •  topic : Thema der Veranstaltung (STRING)
    •  short_desc : Kurzbeschreibung (STRING)
    •  organizer : Veranstalter/in (ARRAY)
        •  id : Personen-ID, z.B. für get_person_details (INT)
        •  name : Vor- und Nachname (STRING)
        •  phone : Tel., G oder P (STRING)
        •  profession : Beruf (STRING)
        •  email : E-Mail (STRING)
    •  childcare_id : ID des Kinderhüte-Angebots (siehe get_childcare_options) (INT)
    •  subscribe_date : Anmelde-Datum, Format „JJJJ-MM-DD“ (STRING)
    •  subscription : Anmeldung erforderlich, true/false (BOOL)
    •  baptism_offer_id : ID des Taufangebots (INT)
    •  room : erster Ort (ARRAY)
        •  id : Raum-ID, z.B. für get_rooms (INT)
        •  name : Raumbezeichnung oder Ort ausserhalb der Raum-Liste (STRING)
        •  location_name : Bezeichnung des Gebäudes (STRING)
        •  location_url : URL zur Seite, welche das Gebäude beschreibt (STRING)
        •  location_url_is_external : ist die URL eine externe Seite? (BOOL)