Bildergalerien

 

Hier können Bildergalerien angelegt werden, die auf der Website chronologisch sortiert als Element hinzugefügt werden können.

 

 

Dokumentation zur Schnittstellen für Bildergalerien

Mit dem Paket "Schnittstellen (Galerien als IFrame einbetten, XML/JSON-Schnittstelle) können über eine URL verschiedene Bildinformationen zu den Bildern aus aus den Bildergalerien abgerufen werden. Dabei wird die Domain des Kunden wiefolgt aufgerufen:

http://www.{domain}.de/index.php?api=galleries&act=search&token={token}&out=xml

 

Dabei können mit verschiedenen Parametern die Suchergebnisse genauer gefilter werden:

Parameter / Bezeichnung	Datentyp	Info / Beschreibung
id	int	Bild-ID
gallery	int	Galerie-ID
filename	string	Dateiname der ursprünglichen Bild-Datei.
term	string	Suchbegriff, dieser Sucht in der Datenpank nach übereinstimmungen im Titel, der Beschreibung und den Tags.
tags	string	Bild-Tags, mehrere mit Komma getrennt (z.B. tags=Gebirte,Sommer).
date	date	Datum, an dem das Bild erstellt wurde / Ist diese Information bei einem Bild nicht vorhanden, wird das Datum verwendet, an dem das Bild in die Galerie hochgeladen wurde.
year	int	Jahr an dem das Bild erstellt bzw. hochgeladen wurde.
month	int	Monat an dem das Bild erstellt bzw. hochgeladen wurde. Hier muss auch das Jahr definiert werden (z.B. year=2015&month=1).
date-from	date	Definierter Zeitraum, an dem das Bild hochgeladen / erstellt wurde.
date-to	date	Definierter Zeitraum, an dem das Bild hochgeladen / erstellt wurde.
limit	int	Hier kann die Anzahl der zurückgelieferten Bilder festgelegt werden. (z.B. limit=100 liefert maximal 100 Bilder zurück, limit=100,100 liefert maximal 100 Bilder zurück, angefangen vom 100ersten Suchergebnis)
out	string	Ausgabetyp der Rückgabe (json oder xml, Standardgemäß json)

 

Rückgabe

In der Rückgabe werden die Bilder mit den Verschiedenen Informationen zurückgeliefert.

Bezeichnung	Datentyp	Info / Beschreibung
id	int	Bild-ID
gallery	array	id (int) Galerie-ID name (string) Galerie Bezeichnung
filename	string	Dateiname der ursprünglichen Bild-Datei.
thumb	array	link (string) Link zur Quelldatei / Vorschau (ca. 300 Pixel in der maximalen Seitelänge). width (int) Bild-Breite in Pixel. height (int) Bild-Höhe in Pixel.
image	array	link (string) Link zur Quelldatei / (ca. 800-1000 Pixel in der maximalen Seitelänge). width (int) Bild-Breite in Pixel. height (int) Bild-Höhe in Pixel.
hd	array	link (string) Link zur HD-Quelldatei - falls vorhanden - (ca. 1920 Pixel in der maximalen Seitelänge). width (int) Bild-Breite in Pixel. height (int) Bild-Höhe in Pixel.
original	array	link (string) Link zur Originalen Quelldatei - falls vorhanden - (ca. 2000-4000 Pixel in der maximalen Seitelänge). width (int) Bild-Breite in Pixel. height (int) Bild-Höhe in Pixel.
title	string	Titel des Bild - falls vorhanden.
description	string	Kurze Beschreibung zum Bild - falls vorhanden.
date	date	Datum an dem das Bild aufgenommen wurde oder zur Galerie hochgeladen wurde, sollte der erste Wert nicht vorhanden sein.
tags	array	Tags / Schlüsselwörter zum Bild.

 

XML

http://www.bwcms.eu/index.php?api=galleries&act=search&token=XYZ&out=xml

<?xml version="1.0" encoding="UTF-8"?>
<data>
  <image id="32828">
    <id><![CDATA[ 32828 ]]></id>
    <gallery>
      <id><!CDATA[ 1 ]]></id>
      <name><!CDATA[ Testgalerie ]]></name>
    </gallery>
    <filename><!CDATA[ Testbild_001.jpg ]]></filename>
    <thumb>
      <link>
        <![CDATA[
          https://ssl.bwhosting.eu/system/data/files/00/00_th.jpg
        ]]>
      </link>
      <width><![CDATA[ 300 ]]></width>
      <height><![CDATA[ 189 ]]></height>
    </thumb>
    <image>
      <link>
        <![CDATA[
          https://ssl.bwhosting.eu/system/data/files/00/00_lo.jpg
        ]]>
      </link>
      <width><![CDATA[ 6048 ]]></width>
      <height><![CDATA[ 3809 ]]></height>
    </image>
    <original>
      <link>
        <![CDATA[
          https://ssl.bwhosting.eu/system/data/files/00/00.jpg
        ]]>
      </link>
      <width><![CDATA[ 6048 ]]></width>
      <height><![CDATA[ 3809 ]]></height>
    </original>
    <title><![CDATA[ Testbild 001 ]]></title>
    <description>
      <![CDATA[
        13.01.2015: Hier steht die Beschreibung als Beispiel
      ]]>
    </description>
    <date><![CDATA[ 2015-01-13 ]]></date>
    <tags>
      <tag><![CDATA[ Aktion ]]></tag>
      <tag><![CDATA[ Commercial ]]></tag>
      <tag><![CDATA[ Gegenlicht ]]></tag>
      <tag><![CDATA[ Löffel ]]></tag>
      <tag><![CDATA[ Manderine ]]></tag>
    </tags>
  </image>
  <image>
    ...
  </image>
  ...
</data>

 

JSON

http://www.bwcms.eu/index.php?api=galleries&act=search&token=XYZ&out=json

{
  '32828' : {
    'id' : '32828',
    'gallery' : {
      'id' : '1',
      'name' : 'Testgalerie'
    },
    filename : 'Testbild_001.jpg',
    'thumb' : {
      'link' : 'https://ssl.bwhosting.eu/system/data/files/00/00_th.jpg',
      'width' : '300',
      'height' : '189'
    },
    'image' : {
      'link' : 'https://ssl.bwhosting.eu/system/data/files/00/00_lo.jpg',
      'width' : '6048',
      'height' : '3809'
    },
    'original' : {
      'link' : 'https://ssl.bwhosting.eu/system/data/files/00/00.jpg',
      'width' : '6048',
      'height' : '3809'
    },
    'title' : 'Testbild 001',
    'description' : '13.01.2015: Hier steht die Beschreibung als Beispiel',
    'date' : '2015-01-13',
    'tags' : [
      'Aktion', 'Commercial', 'Gegenlicht', 'Löffel', 'Manderine'
    ]
  },
  '20238' : {
    ...
  }
  ...
}