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' : {
...
}
...
}

 

Cookies helfen uns bei der Bereitstellung unserer Dienste. Durch die Nutzung unserer Website erklären Sie sich damit einverstanden, dass wir Cookies setzen.