Unsere Ideen für Ihr Projekt

Contao-Erweiterung Pixabay

Pixabay ist eine Erweiterung (Bundle) für Contao ab Version 4.4, die es ermöglicht, auf die über eine Million Bilder der kostenfreien Bilddatenbank Pixabay zuzugreifen, ausgewählte herunterzuladen und einfach in einer Contao-Installation einzufügen. Die Pixabay-Bilddatenbank stellt Bilder und Videos ohne Einschränkung der Nutzungsrechte zur freien Verwendung zur Verfügung. Die Bilder auf der Seite werden zum Zeitpunkt des Erscheinens dieses Blog-Beitrags unter dem Creative Commons CC0 veröffentlicht, wodurch eine sichere Verwendung selbst für kommerzielle Zwecke ermöglicht wird. Die Bilder sind somit für jeden frei zu verwenden und zu verbreiten. Dadurch können die Bilder ohne große Bedenken wegen Copyrightverletzungen benutzt werden. Bitte beachten Sie die auf Pixabay stehenden Regularien, da sich diese ändern können.

Das Ziel dieser Erweiterung ist es, dem Benutzer die Möglichkeit zu geben aus einer Vielzahl an Bildern auszusuchen und diese so einfach wie möglich für eine Contao-Installation zu verwenden. Hierbei wird der Benutzer durch das umfangreiche aber einfach gehaltene Programm unterstützt. Viel Wert wurde darauf gelegt, dass man weder großes Vorwissen braucht noch viel Aufwand betreiben muss um das passende Bild herunterzuladen. Mit der Option auch nach IDs zu suchen, werden dem Benutzer nochmals mehr Möglichkeiten offen gelassen um sich seine Wunsch Bilder in eine Contao-Installation einzufügen. Und durch das Anzeigen der Informationen hat der Benutzer weitere Kriterien, nach denen er sein Bild aussuchen kann.

Um die Erweiterung nutzen zu können, müssen Sie zuerst das Pixabay-Icon in der Dateiverwaltung anklicken, daraufhin werden Sie noch gefragt wohin sie die Bilder speichern wollen, die sie herunterladen werden und dann öffnet sich die Pixabay Erweiterung. Die Oberfläche der Pixabay Erweiterung ist hierbei designtechnisch an Contao angelehnt. Die Pixabay Erweiterung funktioniert über eine in Contao eingebaute Suche und eine Auswahl an Filtern, mit der spezifisch nach Bildern gesucht werden kann. Die Filter sind von der originalen Pixabay-Seite übernommen. Zur Auswahl stehen die Filtermöglichkeit nach Fotos oder Illustrationen und nach der Ausrichtung also vertikale oder horizontale Bilder. Natürlich können Bilder nicht nur nach bestimmten Kriterien gefiltert, sondern auch sortiert werden. Die Suche berücksichtigt Tags und IDs der einzelnen Bilder, dabei ist es auch möglich, mehrere Bilder auf einmal zu suchen, man muss nur darauf achten die einzelnen IDs durch Kommas zu trennen.

Daraufhin werden dem Nutzer alle Bilder die zu dem eingegebenen Tag passen, ausgegeben und auf mehrere Seiten mitvoreingestellt je 20 Bildern pro Seite angezeigt. Zusätzlich zu dem Bild werden Informationen zum Bild angezeigt, darunter zum Beispiel der Ersteller, die Bild-ID und die Like- und Download-Anzahl. Mit einem Klick auf das Bild werden Sie außerdem auf die Pixabay-Seite dieses Bildes weitergeleitet und können dort weitere Informationen einsehen. Um das Bild dann schließlich in Contao einzufügen, muss man nur die Checkbox der jeweiligen Bilder anklicken und dann am Ende der Seite auf "Dateien hochladen" drücken. Das Bild oder die Bilder werden in den zuvor angegebenen Ordner gespeichert. Außerdem - das ist Vorgabe von Pixabay - werden die Suchergebnisse für 24h gecachet.

Wo bekomme ich die Contao 4 Erweiterung her?

Die trilobit Contao-Erweiterung Pixabay kann über zwei Wege installiert werden:

  • Contao Manager
    hier nach "trilobit-gmbh/contao-pixabay-bundle" suchen und installieren
  • direkt über Composer
php composer.phar require trilobit-gmbh/contao-pixabay-bundle

Danach noch die Datenbank aktualisieren.

Kann ich danach sofort loslegen?

Nicht ganz.

Zuerst benötigem Sie einen Pixabay-API-Key. Den bekommsen Sie schnell und unkompliziert auf der Pixabay-Seite. Einfach bei Pixabay registrieren.

Wenn Sie sich jetzt auf Pixabay einloggen und die folgende Seite aufrufen, finden Sie Ihren API-Key unter "Parameters".

Diesen Key jetzt in Contao unter "Einstellungen > Pixabay-Einstellungen" hinterlegen.
Die weiteren Daten sind:
Pixabay API-URL: "https://pixabay.com/api/"

Haben Sie einen API-Key, mit dem auch hoch aufgelöste Bilder gesucht werden können, können Sie die entsprechende Checkbox aktivieren. Die Erweiterung versucht dann beim Speichern der Bilder nach Contao die hoch aufgelöste Version zu ermitteln. In diesem Fall können Sie auch angeben, welche "Quelle" für die hoch aufgelösten Bilder verwendet werden soll.

Weitere Feature

Für jeden Contao-Backend-Benutzer kann eine Vorbelegung der Filter vorgenommen werden. Hierzu einfach den fraglichen Benutzer auswählen und die passenden Optionen auswählen.

Diese Optionen werden dann bei der Pixabay-Suche vorausgewählt. Natürlich kann der Benutzer aber auch die Suche immer noch an seine aktuellen Bedürfnisse anpassen.

Meta-Daten (Tags, User, Bild-ID und Direkt-Link zum entsprechenden Bild bei Pixabay) werden in die Dateiverwaltung von Contao übernommen.

Einschränkungen der Pixabay-Api (durch Pixabay)

Die API gibt immer nur 500 Treffer zurück auch wenn eigentlich deutlich mehr Bilder gefunden werden könnten. Hier einfach etwas mit der Suche "spielen". ;-)

Um die API für alle Benutzer "normal zur Verfügung stellen zu können" müssen Suchanfragen für 24 Stunden gecachet werden. Weiter sind "nur" bis zu 5.000 Anfragen pro Stunde möglich. Anfragen sind an den API-Key geknüpft.

Wird ein gecachetes Suchergebnis ausgegeben erscheint ein kleiner Hinweis am Ende der Suche.

Fehler

...können passieren. Wenn Ihnen etwas auffällt oder Sie weitere Wünsche und Feedback für uns haben - nur her damit!


Hilfe

Bei Fragen und Anregungen zu der Erweiterung stehen wir natürlich gerne zur Verfügung. Nutzen Sie einfach unser Kontaktformular.


Wir engagieren uns gerne und unentgeldlich für die Contao-Community. Am liebsten ist es uns, wenn wir durch unser Beispiel andere dazu motivieren sich ebenfalls einzubringen. Sollte Ihnen das aber nicht möglich sein, dann freuen wir uns auch über eine kleine Spende für unsere Arbeit. Auch das motiviert uns weiter zu machen.


Für diese Erweiterung spenden

Diese Erweiterung hat Ihnen gefallen und Sie nutzen sie auch in Ihren Kundenprojekten? Hier können Sie uns unterstützen.

...oder spenden Sie per Überweisung auf folgendes Konto bei der EthikBank:

BIC: GENODEF1ETK
IBAN: DE77 8309 4495 0003 2066 02
Verwendungszweck: Spende Contao-Erweiterung