get_events_by_series

Funktion
Liefert eine Liste von Veranstaltungen aus einer VEROWA-Serie. Serien werden meistens dazu benutzt, wiederkehrende Veranstaltungen zu gruppieren.
Falls Sie mehrere Serien-IDs übergeben, wird die Summe der Ergebnisse abgefragt, nicht die Schnittmenge. 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.
Über den Parameter „auszuschliessende Veranstaltungen“ können Sie z.B. von der Detailseite einer Veranstaltung alle anderen Veranstaltungen der Serie anzeigen, indem Sie die aktuelle ID ausschliessen.
Falls „nur spontan Zugängliches zeigen“ auf 1 (true) gesetzt ist, werden alle Veranstaltungen von geschlossenen Gruppen ignoriert, z.B. der Religionsunterricht, den man ja nicht „einfach so“ besuchen kann. Bei Serien hat diese Angabe kaum je Bedeutung.

Eingabe
•  IDs der Serien (STRING), z.B. „4311, 2936“ (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. „7694, 7695“
•  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)
    •  subscription_person_name : Anmelde-Name
    •  subscription_person_email : Anmelde-E-Mail
    •  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)