In diesem Dokument erfahren Sie, wie Sie API-Schluessel fuer die externe Bild- und Videosuche im Block-Editor konfigurieren. Die Einstellungen finden Sie unter Einstellungen > ZenBlocks > API Settings.
Zusammenfassung
Um die externe Mediensuche in ZenBlocks nutzen zu koennen, muessen Sie zunaechst API-Schluessel bei den jeweiligen Diensten registrieren:
| Dienst | Medientyp | Besonderheit |
|---|---|---|
| Unsplash | Bilder | Hochwertige Fotos, Download-Tracking |
| Pexels | Bilder + Videos | Ein Schluessel fuer Bild- und Videosuche |
| Pixabay | Bilder + Videos | Ein Schluessel fuer Bild- und Videosuche, CC0-Inhalte |
Pexels und Pixabay verwenden jeweils denselben API-Schluessel sowohl fuer die Bild- als auch fuer die Videosuche.
Grundlegendes Verstaendnis
ZenBlocks hostet keine Medien selbst. Stattdessen verwendet die Erweiterung Ihre API-Schluessel, um externe Dienste abzufragen und Medien direkt im Block-Editor durchsuchbar zu machen.
Was ist ein API-Schluessel?
Ein API-Schluessel ist eine Zugangskennung, die Sie bei einem externen Dienst erhalten. Er wird benoetigt, um Suchanfragen an den jeweiligen Dienst zu senden.
- Erforderlich: Ohne gueltigen Schluessel funktioniert die Suche nicht.
- Fehlerhafter Schluessel: Bei einem falschen oder abgelaufenen Schluessel erhalten Sie eine Fehlermeldung.
- Nutzungslimits: Einige Dienste begrenzen die Anzahl der Anfragen pro Zeitraum.
Unterstuetzte Dienste
| Dienst | Schluesseltyp | Funktion |
|---|---|---|
| Unsplash | Access Key | Bildersuche und Download-Tracking |
| Pexels | API Key | Bild- und Videosuche |
| Pixabay | API Key | Bild- und Videosuche |
Unterschiede zwischen den Diensten
Unsplash
- Hochwertige Fotografien mit Schwerpunkt auf kuenstlerischer Qualitaet
- Download-Tracking wird automatisch unterstuetzt
- Bitte beachten Sie die Nutzungsbedingungen von Unsplash
Pexels
- Bilder und Videos in einem Dienst vereint
- Derselbe API-Schluessel wird fuer Bild- und Videosuche verwendet
- Grosse Auswahl an kostenfreien Medien
Pixabay
- Bilder und Videos ueber einen einzigen Schluessel durchsuchbar
- Inhalte stehen unter CC0-Lizenz
- Besonders umfangreiche Medienbibliothek
Was ist CC0?
CC0 (Creative Commons Zero) ist eine aeusserst freizuegige oeffentliche Lizenz:
- Kommerzielle Nutzung ist in der Regel gestattet.
- Namensnennung ist haeufig nicht erforderlich.
Wichtige Einschraenkungen:
- Pruefen Sie immer die dienstspezifischen Nutzungsbedingungen.
- Abgebildete Personen, Logos und Markenzeichen koennen eigenen Rechten unterliegen.
- Ueberpruefen Sie die Lizenz jedes einzelnen Mediums vor der Verwendung.
Einrichtungsschritte
- Einstellungen oeffnen -- Navigieren Sie zu Einstellungen > ZenBlocks und waehlen Sie den Tab API Settings.
- API-Schluessel beschaffen -- Registrieren Sie sich beim gewuenschten Dienst (Unsplash, Pexels oder Pixabay) und erstellen Sie einen API-Schluessel.
- Schluessel eingeben -- Tragen Sie den erhaltenen Schluessel in das entsprechende Feld ein.
- Speichern -- Klicken Sie auf Save, um die Einstellungen zu sichern.
- Testen -- Oeffnen Sie den Block-Editor und pruefen Sie, ob die Mediensuche fuer den konfigurierten Dienst funktioniert.
Zusammenhang zwischen Bild- und Videosuche
Bei Pexels und Pixabay wird derselbe API-Schluessel fuer die Bild- und die Videosuche verwendet. Sobald Sie den Schluessel eingetragen haben, stehen beide Suchfunktionen zur Verfuegung. Bei Unsplash ist ausschliesslich die Bildersuche verfuegbar.
Checkpoints
- Der eingegebene API-Schluessel wird nach dem Speichern korrekt angezeigt.
- Die Mediensuche im Block-Editor liefert Ergebnisse fuer den konfigurierten Dienst.
- Bilder und Videos (sofern vom Dienst unterstuetzt) werden in den Suchergebnissen angezeigt.
Wichtige Hinweise
- Bewahren Sie Ihre API-Schluessel sicher auf und geben Sie sie nicht an Dritte weiter.
- Beachten Sie die Nutzungslimits der jeweiligen Dienste.
- Bei Problemen ueberpruefen Sie zunaechst, ob der API-Schluessel korrekt eingegeben wurde.
- Die API-Einstellungen gelten fuer die gesamte Website.
Fehlerbehebung -- Schritt fuer Schritt
Wenn die Mediensuche nicht funktioniert, gehen Sie in dieser Reihenfolge vor:
- Schluessel pruefen -- Stellen Sie sicher, dass der API-Schluessel korrekt und vollstaendig eingetragen ist (keine Leerzeichen am Anfang oder Ende).
- Dienststatus pruefen -- Ueberpruefen Sie, ob der externe Dienst (Unsplash, Pexels, Pixabay) aktuell erreichbar ist.
- Limits pruefen -- Manche Dienste beschraenken die Anzahl der Anfragen. Warten Sie ggf. ab oder pruefen Sie Ihr Kontingent auf der Dienstwebsite.
- Browser-Cache leeren -- Laden Sie den Block-Editor neu oder leeren Sie den Browser-Cache.
Welchen Dienst sollten Sie waehlen?
- Fuer hochwertige Fotos: Unsplash bietet kuenstlerisch ansprechende Fotografien.
- Fuer Bilder und Videos aus einer Hand: Pexels vereint beide Medientypen mit einem Schluessel.
- Fuer CC0-Inhalte und maximale Flexibilitaet: Pixabay bietet Bilder und Videos unter einer sehr freizuegigen Lizenz.
Sie koennen auch mehrere Dienste gleichzeitig konfigurieren und je nach Bedarf zwischen den Quellen wechseln.