get_events_by_list

Funktion
Liefert eine Liste von Veranstaltungen anhand einer VEROWA-Listendefinition (siehe z.B. get_listnames_by_group). Diese Funktion ist sehr praktisch, um eine Veranstaltungsliste auf statischen Seiten zusammenzustellen, da die Konfiguration der Liste nicht im CMS erfolgt, sondern in VEROWA. Damit hat der Admin. die Möglichkeit, die Liste anzupassen, ohne ins CMS einzugreifen.
Falls Sie mehrere Listen-IDs übergeben, wird die Schnittmenge der Ergebnisse abgefragt, nicht die Summe. 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 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. Das kann je nach Liste nützlich sein, um die Anzahl Ergebnisse übersichtlich zu halten und nur das zu zeigen, was die Besucher der Website interessiert.

Eingabe
•  IDs der Listen (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)