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://login.bwcms.eu/data/files/00/00_th.jpg
]]>
</link>
<width><![CDATA[ 300 ]]></width>
<height><![CDATA[ 189 ]]></height>
</thumb>
<image>
<link>
<![CDATA[
https://login.bwcms.eu/data/files/00/00_lo.jpg
]]>
</link>
<width><![CDATA[ 6048 ]]></width>
<height><![CDATA[ 3809 ]]></height>
</image>
<original>
<link>
<![CDATA[
https://login.bwcms.eu/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://login.bwcms.eu/data/files/00/00_th.jpg',
'width' : '300',
'height' : '189'
},
'image' : {
'link' : 'https://login.bwcms.eu/data/files/00/00_lo.jpg',
'width' : '6048',
'height' : '3809'
},
'original' : {
'link' : 'https://login.bwcms.eu/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' : {
...
}
...
}