---

Kultur!Aktuell [- zum kostenlosen Download] | [- auf Ihrer Homepage] | [- als iframe] | [- selbst konfiguriert (API)]

---

Kultur!Aktuell - selbst konfiguriert (API)

Anleitung für "Fortgeschrittene"
Neben den bereits in der Anordnung der Daten "fertigen" Export-Dateien können Sie mit Hilfe der Datei datenexport.php auch ihre ganz eigene Export-Datei gestalten und erstellen. Dies ist zum Beispiel notwendig, wenn Sie die Daten in eine eigene Datenbank integrieren möchten.

Aufruf der Export-Funktion

Der Aufruf erfolgt über die Datei https://www.siwikultur.de/termine/datenexport.php
gefolgt von einem Fragezeichen und den im folgendem beschriebenen Parametern.
Die einzelnen Parameter, jeweils gefolgt von einem = und dem gewünschten Wert werden mit dem &-Zeichen voneinander getrennt.
Es sind keine Leerzeichen erlaubt!

Beispiel-Aufruf:
https://www.siwikultur.de/termine/datenexport.php?art=3&link=4&daten=DATUM-VONDATUM-BISDATUM-(txt)%20/%20-ZEIT-TITEL1-TITEL2-TEXT-ADRESSE-(txt)Tel.:%20-INFOTEL-ID-TITLINK-TXTLINK-ORTLINK-VVKLINK&vonfilter=mi&datform=de

Parameter und mögliche Werte:

• Bestimmung der Ausgaben-Art:
  art=
  Wenn "art=" fehlt oder ohne Wert ist, erfolgt die Ausgabe im Format 1
  ! Wenn "art=" 3 oder 4 ist, wird "trenn=" automatisch auf 6 (kein Trenner) und "lim=" automatisch auf 3 (keine Limiter) gesetzt. Andere Angaben zu "trenn=" oder "lim=" werden ignoriert !
  
  

  Wert:	Hinweise:
  1	Ausgabe im Text- bzw. CSV-Format. In der ersten Zeile werden die Feldnamen angegeben * Voreinstellung
  2	Ausgabe im Text- bzw. CSV-Format. Die Feldnamen werden NICHT in der ersten Zeile angegeben
  3	Ausgabe als eigenständige html-Seite zum Einbinden z.B. als I-frame
  4	Ausgabe als Codeschnipsel im html-Format mit <div> und <span>-TAGs als Trenner, geeignet zum Einbinden per script (z.B. Java, PHP, Ajax etc). Die Formatierung erfolgt über vom Nutzer selbst einzubindende CSS-Formate.
  5	Ausgabe im XML-Format im Format <DATENFELDNAME>Feldinhalt</DATENFELDNAME> Wenn Sie alle Veranstaltungen mit allen Informationen abrufen möchten, kann auch der Link zu https://www.siwikultur.de/termine/xml genutzt werden.
  6	Ausgabe im JSON-Format im Format "DATENFELDNAME_1": "Feldinhalt_1" Alle Inhalte (auch die ID) werden als String zurückgegeben. Wenn Sie alle Veranstaltungen mit allen Informationen abrufen möchten, kann auch der Link zu https://www.siwikultur.de/termine/json genutzt werden.
  7	Ausgabe im XML-Format Sonderversion für Export nach https://bühnen-südwestfalen.de
  8	Ausgabe im XML-Format Sonderversion für Export nach OutdoorActive. Auch erreichbar über https://siwitermine.de/outdoor.php

  
  
• Bestimmung des Trennzeichens zwischen den einzelnen Datenbankfeldern:
  trenn=
  Wenn "trenn=" fehlt oder ohne Wert ist, erfolgt die Ausgabe im Format 1
  ! Wenn "art=" 3, 4 oder 5 ist, wird "trenn=" automatisch auf 6 (kein Trenner) gesetzt. Andere Angaben zu "trenn=" werden ignoriert !
  
  

  Wert:	Ergebnis:	Hinweise:
  1	;	(Semikolon) * Voreinstellung
  2	,	(Komma)
  3	|	(Senkrechter Strich)
  4		(Leerzeichen)
  5	<br>	kleiner html-Absatz)
  6		kein Trenner

  
  
• Bestimmung der Feldlimiter:
  lim=
  Jeder Inhalt eines Feldes wird bzw. wird nicht eingeschlossen von Limitern
  Wenn "lim=" fehlt oder ohne Wert ist, erfolgt die Ausgabe im Format 1
  ! Wenn "art=" 3, 4 oder 5 ist, wird "lim=" automatisch auf 3 (keine Limiter) gesetzt. Andere Angaben zu "lim=" werden ignoriert !
  
  

Wert:	Ergebnis:	Hinweise:
1	Doppelte Anführungsstriche.	Doppelte Anführungsstriche innerhalb der Feldinhalte werden in einfache Anführungsstriche gewandelt * Voreinstellung
2	Einfache Anführungsstriche	Einfache Anführungsstriche innerhalb der Feldinhalte werden in doppelte Anführungsstriche gewandelt
3	Keine Limiter	Das unter "trenn" bestimmte Trennzeichen wird vorher in den Feldinhalten durch ein Leerzeichen ersetzt
4	Doppelte Anführungsstriche	Einfachen und doppelten Anführungsstriche innerhalb der Feldinhalte wird jeweils ein Backslash "\" vorangestellt, sql-konform
5	Einfache Anführungsstriche	Einfachen und doppelten Anführungsstriche innerhalb der Feldinhalte wird jeweils ein Backslash "\" vorangestellt, sql-konform

• Bestimmung der Datensatz-Trenner:
  satz=
  Wenn "satz=" fehlt oder ohne Wert ist, erfolgt die Ausgabe im Format 1
  
  

• Wert:	Ergebnis:	Beschreibung:
  1	\r\n	(Standard-Zeilenumbruch)* Voreinstellung
  2		(Leerzeichen)
  3	<br>\r\n	(html-Zeilenumbruch + Standard-Zeilenumbruch. Erleichtert die Darstellung der Ergebnisse beim Ausprobieren)
  4	;	(Semikolon)
  5	,	(Komma)
  6	|	(Senkrechter Strich)

  
  
• Anzeige und Reihenfolge der Rückgabe-Felder
  daten=
  Aufreihung der gewünschten Datenbankfelder. Als Trennzeichen wird das Minus-Zeichen (-) verwendet. Wenn mehrere der unten aufgeführten Werte gemeinsam zwischen einem unter "trenn=" eingegebenen Trennzeichen-Paar zusammengefasst werden sollen, müssen diese mit einem Unterstrich (_) getrennt werden. (Beispiel siehe unten)
  ! Die Rückgabe der Inhalte erfolgt in der Reihenfolge, in der die Werte benannt werden !
  Wenn "daten=" fehlt oder ohne Wert ist, erfolgt die Ausgabe aller Felder in der hier aufgeführten Reihenfolge. * Voreinstellung
  Das Format der Rückgabe wird über die weiter unten beschriebenen Parameter bestimmt.
  
  

• Wert:	Rückgabe:
  ID	eindeutige Veranstaltungsnummer
  SPARTENNR	Sparten-Nummer (2stellig) als Zahl wie unter "spartenfilter" angegeben
  SPARTE	Sparten-Name als Text wie unter "spartenfilter" vorgegeben oder unter "spnam" selbst definiert. Wenn "art" den Wert 3 oder 4 erhält, wird der Spartenname automatisch den Veranstaltungen dieser Sparte einmalig (als Überschrift) vorangestellt, unabhängig davon, ob dieser Parameter angegeben wird.
  TAG	Anzeige des Wochentages (Montag, Dienstag....) von DATUM
  tag	Anzeige Kurzform des Wochentages (Mo. Di. ...) von DATUM
  DATUM	Veranstaltungsdatum bei eintägigen Veranstaltungen. Nicht belegt bei Ausstellungen. Wenn "art" den Wert 3 oder 4 erhält, wird das Datum automatisch den Veranstaltungen dieses Datums einmalig (als Überschrift) vorangestellt, unabhängig davon, ob dieser Parameter angegeben wird.
  VONDATUM	Bei Ausstellungen das Anfangsdatum. Bei allen anderen Veranstaltungsarten ist dieser Wert leer.
  BISDATUM	Bei Ausstellungen das Enddatum. Bei allen anderen Veranstaltungsarten ist dieser Wert leer. Wenn "art" den Wert 3 oder 4 erhält, wird vor das "BISDATUM" automatisch das Wort " bis " eingefügt. Bei anderen Werten für "art" muss dies, wenn gewünscht, über den txt- bzw. trt- Parameter gemacht werden.
  ZEIT	Anfangszeit(en) bzw Öffnungszeiten der Veranstaltung, maximal 120 Buchstaben. Kombination aus ZEITK ( aber mit dem Wort " Uhr") und ZEITL. Wenn der Stunden/Minuten-Trenner (Voreinstellung: Punkt) ein Doppelpunkt sein soll, muss dem Wert ein Doppelpunkt nachgestellt werden. ( ?ZEIT: )
  ZEITK	Anfangszeit der Veranstaltung in Kurzform, maximal 5 Zeichen, ohne "Uhr": "12.30". Wenn der Stunden/Minuten-Trenner (Voreinstellung: Punkt) ein Doppelpunkt sein soll, muss dem Wert ein Doppelpunkt nachgestellt werden. ( ?ZEITK: ) Keine Rückgabe, wenn ZEITL ein Ergebnis liefert !
  ZEITL	Anfangs-/Öffnungszeiten, max 120 Buchstaben, meist bei Ausstellungen und Filmveranst.: "12.30 Uhr und 13.30 Uhr während der Ferien" . Wenn der Stunden/Minuten-Trenner (Voreinstellung: Punkt) ein Doppelpunkt sein soll, muss dem Wert ein Doppelpunkt nachgestellt werden. ( ?ZEITL: ) ! Keine Rückgabe, wenn ZEITK ein Ergebnis liefert !
  TITEL1	erste Zeile des Veranstaltungstitel, maximal 120 Buchstaben
  TITEL2	zweite Zeile des Veranstaltungstitels, maximal 120 Buchstaben
  TEXT	Veranstaltungstext
  GKZ	Eindeutige Gemeindekennziffer wie unter "ortfilter" angegeben
  GKZTEXT	Name der Gemeinde/Stadt wie unter "ortfilter" angegeben, in der die Veranstaltung stattfindet
  PLZ	Postleitzahl des Veranstaltungsortes
  ADRESSE	Veranstaltungs-Ort-Adresse
  GEO	Geodaten des Veranstaltungs-Ortes
  VERANST	Name des Veranstalters
  INFOTEL	Telefonnummer für mehr Infos
  TITLINK	Internet-Links zum Titel. Formatierung möglich wie unter "link=" beschrieben
  TXTLINK	Internet-Links zum Veranstaltungstext. Formatierung möglich wie unter "link=" beschrieben
  ORTLINK	Internet-Links zum Veranstaltungsort. Formatierung möglich wie unter "link=" beschrieben
  VERLINK	Internet-Links zum Veranstalter. Formatierung möglich wie unter "link=" beschrieben
  VVKLINK	Internet-Links zum Online-Vorverkauf . Formatierung möglich wie unter "link=" beschrieben
  BILD	Falls vorhanden, wird der Dateiname eines passenden Bildes (ohne Pfad) angegeben. Thumbs (ca. 110px breit) liegen im Pfad https://www.siwikultur.de/termine/thumbs/ größere Bilder (ca. 650px breit) im Pfad https://www.siwikultur.de/termine/bilder/
  BILDTITEL	Falls vorhanden, wird der Bildtitel zurückgegeben.
  STAND	Datum der Eingabe bzw. der letzten Änderung
  DEL	Wenn eine Veranstaltung wieder gelöscht wurde (z.B. wg. Ausfall, Doppler), wird hier J zurückggeben. Wird dieses Feld nicht angegeben, werden keine gelöschten Veranstaltungen ausgegeben (*Voreinstellung).
  (txt)	nach den in Klammern gesetzten Kleinbuchstaben txt folgt beliebiger Text, der immer an dieser Position erscheinen soll. Platzhalter: Leerzeichen: %20 Bindestriche: %minus% Unterstriche: %u% Fragezeichen: %frage% Gleich (=) : %gleich% Et (&) : %et% ! Keine Werte aus dieser Auflistung oder Trenn- bzw. Limiter- Zeichen verwenden! !
  (trt)	Dieser Wert bewirkt nur etwas, wenn mehrere Datenbankfelder mit Unterstrichen zusammengefasst werden sollen. Nach den in Klammern gesetzten Kleinbuchstaben trt folgt beliebiger Text, der aber nur angezeigt wird, wenn der Wert der mit einem Unterstrich davon abgegrenzten Datenbankfelder davor und dahinter einen Inhalt zurückgeben (= hier Wert1 und Wert2). Schreibweise: WERT1_(trt)text_WERT2 Platzhalter siehe oben unter "(txt)" ! Keine Werte aus dieser Auflistung oder Trenn- bzw. Limiter- Zeichen verwenden!
  (trtl)	Ähnlich wie (trt): Dieser Wert gibt den darauffolgenden Text wieder, wenn der Wert des links davon mit einem Unterstrich abgegrenzten Datenbankfeldes (also das Feld davor = hier Wert1) einen Inhalt zurückgibt. Schreibweise: WERT1_(trtl)text-Wert2 Platzhalter siehe oben unter "(txt)" ! Keine Werte aus dieser Auflistung oder Trenn- bzw. Limiter- Zeichen verwenden!
  (trtr)	Ähnlich wie (trtl): Dieser Wert gibt den darauffolgenden Text wieder, wenn der Wert des rechts davon mit einem Unterstrich abgegrenzten Datenbankfeldes (also das Feld dahinter = hier Wert2) einen Inhalt zurückgibt. Schreibweise: WERT1-(trtr)text_Wert2 Platzhalter siehe oben unter "(txt)" ! Keine Werte aus dieser Auflistung oder Trenn- bzw. Limiter- Zeichen verwenden!

  • Beispiel: ?daten=ID-ZEIT:-DATUM_VONDATUM_(trt)%20bis%20_BISDATUM-TITEL1-(txt)%20%minus%%20Ein%20Beispiel
    Die Werte von ID und ZEIT werden normal (Standard: Semikolon als Feldtrenner, Anführungsstriche als Limiter) voneinander getrennt. Die Ausgabe der Zeit wird mit Doppelpunkten als Std/Min-Trenner ausgegeben. DATUM und VONDATUM erscheinen direkt hintereinander (wg. Unterstrich statt minus). Da aber entweder nur DATUM oder nur VONDATUM Werte ausgeben, wird nur eines dieser Datumswerte angezeigt. Zwischen VONDATUM und BISDATUM wird ein Text-Trenner mit Leerzeichen (%20) eingefügt. Der Texttrenner erscheint aber nur, wenn VONDATUM und BISDATUM existieren. Zum Abschluss wird ein Feld nur aus Text angelegt. Für das Minus-Zeichen im Text wird ein Platzhalter verwendet (%minus%).
    Ausgabe bei Werten in VONDATUM und BISDATUM: "164";"11:00 Uhr";"05.12.2009 bis 05.12.2009";"Kultur in der Klinik";" - Ein Beispiel"
    Ausgabe bei Wert in DATUM: "74";"16:00 Uhr";"29.11.2009";"Treffpunkt Kunst";" - Ein Beispiel"
    

• Anzeige-Namen der Rückgabe-Felder in der ersten Zeile
  datentitel=
  Aufreihung der gewünschten Namen der unter "daten=" aufgelisteten Datenbankfelder bei der Verwendung von "art=1". Als Trennzeichen wird das Minus-Zeichen (-) verwendet.
  ! Die Anzahl und Reihenfolge entspricht der unter daten= aufgelisteten Felder/Textbausteine (Tipp: Anzahl der Minus-Zeichen vergleichen)
  Wenn "datentitel=" fehlt oder ohne Wert ist, werden die Namen der unter "daten=" verwendeten Felder angezeigt. * Voreinstellung
  
  
• Format des Veranstaltungsdatums in der Rückgabe
  datform=
  Kürzel für das Rückgabe-Format von Datums-Angaben
  Wenn "datform=" fehlt oder ohne Wert ist, wird das Datum im Format de ausgegeben
  Mögliche Werte:
  d (Deutsch mit Punkten: 04.11.2010)
  de (Deutsch mit Wochentagsnamen in Kurzform und Punkten: Do., 04.11.2010)
  DE (Deutsch mit Wochentagsnamen und Punkten: Donnerstag, 04.11.2010)
  us (Amerikanisch mit Strichen: 2010-11-04)
  
  
• Anzeige-Format von Links in der Rückgabe:
  link=
  Kürzel für das allgemeine Rückgabeformat von Links:
  Wenn "link=" fehlt oder ohne Wert ist, erfolgt die Ausgabe im Format 1
  Wenn es mehrere Links gibt, erfolgt die Trennung der Links bei 1 und 2 mit einem Leerzeichen, bei 3 mit einer Raute "#"
  ! Wenn einzelne Links unterschiedlich behandelt werden sollen, kann man den gewünschten Formatierungswert (1,2,3,4,5 oder 6) auch direkt an den Feldnamen des Links (TITLINK,TXTLINK,ORTLINK oder VVKLINK) unter "daten=" anhängen. (Beispiel: TXTLINK6 oder TXTLINK3)
   

• Wert:	Ergebnis:
  1	html-Link (Fertiger html-Link mit Text: <a href="https://www.domain.de/datei.htm">Siegerlandhalle</a> ) * Voreinstellung
  2	nur Adresse (nur der Link: https://www.domain.de/datei.htm ) * Voreinstellung wenn art=5 (xml)
  3	Link-array (verlinkter Text + "|"+ der Link Bsp.: Bsp.: Siegerlandhalle|https://www.domain.de/datei.htm
  4	eingebettet (Die Verlinkung erfolgt im Format 1, allerdings innerhalb des jeweilig zugehörigen Textes. TITLINK in TITEL1 und TITEL2; TXTLINK in TEXT; ORTLINK in ADRESSE; VVKLINK im Anschluss an INFOTEL. Voraussetzung ist, dass der jeweils einzubauende Link {also TITLINK, TXTLINK, ORTLINK, VVKLINK} unter "daten=" mit angegeben wird. Die Position wird dabei automatisch an die des verlinkten Textes angepasst.)
  5	angehängt (wie 4, nur dass die Links nicht im zugehörigen Text erfolgen, sondern im Format 1 an den jeweils zugehörigen Text angehängt wird.)
  6	überlagert (wie 4, nur dass die Links nicht im zugehörigen Text erfolgen, sondern dem kompletten jeweils zugehörigen Text unterlegt sind.)

  
  
• Anzeige-Namen der Sparten in der Rückgabe:
  spnam=
  Synonyme für die Rückgabe der Sparten:
  Wenn "spnam=" fehlt oder ohne Wert ist, erfolgt die Ausgabe mit den unter "spartenfilter" verwendeten Bezeichnungen:
  Musik-Theater/Kleinkunst-Vorträge-Film-Literatur-Kinder-Märkte/Feste-Verschiedenes-Kunst/Vernissage-10-11-Ausstellungen-Natur-SportEvents-Gründung
  Als Wert muss eine Liste der Ausgabenamen, jew. getrennt durch ein Minus-Zeichen, als Text angegeben werden. Die Reihenfolge entspricht den Spartennummern. Zur Zeit nicht belegte Nummern müssen als Nummern eingetragen werden.
  Beispiel: ?spnam=Musik-Theater-Bildung-Kino-Lesung-Kinder-Feste-Sonstiges-Kunst-10-11-Ausstellung
  
  
• Anzeige der Sparten-Nummer in der Rückgabe:
  spcodenam=
  Synonym-Werte für die Rückgabe des Sparten-Codes:
  Wenn "spcodenam=" fehlt oder ohne Wert ist, erfolgt die Ausgabe mit den unter "spartenfilter" verwendeten Code-Zahlen für Sparten (z.Zt. 01 bis 12):
  01-02-03-04-05-06-07-08-09-10-11-12
  Als Wert muss eine Liste der Ausgabecodes, jew. getrennt durch ein Minus-Zeichen, als Text angegeben werden. Die Reihenfolge entspricht den Spartennummern. Zur Zeit müssen mindestens 12 Codezahlen eingegeben werden. Mehrfachnennungen sind möglich.
  Beispiel: ?spcodenam=7-8-11-9-26-10-5-9-28-9-9-28
  
  

Abfrage-Filter:

• Zeitraum-Filter:
  vonfilter= Veranstaltungen ab diesem Datum
  bisfilter= Veranstaltungen bis zu diesem Datum
  Wenn "vonfilter=" und "bisfilter=" fehlen oder ohne Wert sind, werden alle Daten ab dem aktuellen Datum aus KulturAktuell übertragen
  Wenn "bisfilter=" fehlt oder ohne Wert ist, werden nur Veranstaltungen am unter "vonfilter=" eingetragenen Datum übertragen.
  ! "vonfilter=" sollte immer die ältere Datumsangabe enthalten, Eine Rückwärts-Sortierung ist nicht möglich !
  
  

• Übergabewerte:	Erklärung:
  yyyy-mm-tt	4stellige Jahreszahl Minus 2stellige Monatszahl Minus 2stellige Tageszahl ) Beispiel für 4. November 2010: vonfilter=2010-11-04
  Alternativ mögliche Angabe-Werte unter "vonfilter=" und "bisfilter=":
  heute	Veranstaltungen des aktuellen Tages
  morgen	Veranstaltungen des folgenden Tages
  1W	Veranstaltungen der nächsten 7 Tage ab einschl. des akt. Tages bzw. ab einschl. des unter "vonfilter=" eingetragenen Datums
  2W	Veranstaltungen der nächsten 14 Tage ab einschl. des akt. Tages bzw. ab einschl. des unter "vonfilter=" eingetragenen Datums
  Alternativ mögliche Angabe-Werte nur unter "vonfilter=": ("bisfilter=" wird nicht angegeben bzw. ignoriert):
  mo di mi do fr sa oder so	Veranstaltungen des nächsten Montags, Dienstags, Mittwochs, Donnerstags, Freitags, Samstags oder Sonntags werden zurückgegeben. Nur ein Wert möglich!

  
  
• Sparten-Filter:
  spartenfilter=
  Auflistung der gewünschten Sparten. Als Trennzeichen wird das Minus-Zeichen (-) verwendet.
  Wenn "spartenfilter=" fehlt oder ohne Wert ist, werden Veranstaltungen aller Sparten übertragen
  
  01 (Musik)
  02 (Theater/Kleinkunst)
  03 (Vorträge)
  04 (Film)
  05 (Literatur)
  06 (Kinder)
  07 (Märkte/Feste)
  08 (Verschiedenes)
  09 (Kunst/Vernissage)
  12 (Ausstellungen)
  15 (Natur)
  16 (SportEvents)
  17 (Gründung)
  
  
• Orte-Filter:
  ortfilter=
  Auflistung der gewünschten Orte. Als Trennzeichen wird das Minus-Zeichen (-) verwendet.
  Wenn "ortfilter=" fehlt oder ohne Wert ist, werden Veranstaltungen aus allen Orten übertragen
  Die Parameter entsprechen i.d.R. den Gemeindekennziffern.
  
  610 (Bad Berleburg)
  630 (Bad Laasphe)
  010 (Burbach)
  620 (Erndtebrück)
  030 (Freudenberg)
  040 (Hilchenbach)
  060 (Kreuztal)
  070 (Netphen)
  080 (Neunkirchen)
  090 (Siegen)
  100 (Wilnsdorf)
  200 (überregional, kreisnahe Orte)
  

Beispiel: csv-Export