Résumé
ZenBlocks vous permet de rechercher et d’insérer des images et vidéos provenant de services externes directement depuis l’éditeur. Pour activer cette fonctionnalité, vous devez enregistrer une clé API pour chaque service que vous souhaitez utiliser.
| Service | Type de contenu | Remarque |
|---|---|---|
| Unsplash | Photos | Photos haute résolution |
| Pexels | Images + Vidéos | Large bibliothèque d’images et de vidéos |
| Pixabay | Images + Vidéos | Contenu sous licence CC0 (domaine public) |
Comprendre le fonctionnement
Comment ZenBlocks interroge les services externes
Lorsque vous effectuez une recherche de médias dans l'éditeur, ZenBlocks envoie une requête au service externe via son API. Les résultats sont affichés directement dans l'éditeur, et vous pouvez insérer le média sélectionné dans votre contenu.
Qu'est-ce qu'une clé API ?
Une clé API est un identifiant unique qui permet à ZenBlocks de communiquer avec un service externe en votre nom. Chaque service nécessite sa propre clé, que vous obtenez en créant un compte développeur sur le site du service concerné.
Services pris en charge
| Service | Images | Vidéos | Licence |
|---|---|---|---|
| Unsplash | Oui | Non | Licence Unsplash |
| Pexels | Oui | Oui | Licence Pexels |
| Pixabay | Oui | Oui | CC0 (domaine public) |
Différences entre les services
- Unsplash se spécialise dans les photographies artistiques et éditoriales de haute qualité.
- Pexels propose un large choix d'images et de vidéos, avec une communauté active de contributeurs.
- Pixabay offre du contenu sous licence CC0, ce qui signifie que vous pouvez l'utiliser librement sans attribution, y compris à des fins commerciales.
Qu'est-ce que CC0 ?
CC0 (Creative Commons Zero) est une licence qui place le contenu dans le domaine public. Vous pouvez copier, modifier, distribuer et utiliser le contenu, même à des fins commerciales, sans demander de permission ni fournir d'attribution.
Procédure de configuration
- Rendez-vous dans Réglages > ZenBlocks et ouvrez l'onglet API Settings.
- Pour chaque service que vous souhaitez utiliser, cliquez sur le lien correspondant pour accéder au site du service et obtenir votre clé API.
- Saisissez la clé API dans le champ prévu à cet effet.
- Cliquez sur Save pour enregistrer vos paramètres.
- Ouvrez l'éditeur de blocs et effectuez une recherche de médias pour vérifier que le service fonctionne correctement.
Images et vidéos
Certains services (Pexels, Pixabay) proposent à la fois des images et des vidéos. Lorsque vous recherchez du contenu via ces services, vous pouvez filtrer les résultats par type de média. La même clé API donne accès aux deux types de contenu.
Points de vérification
- [ ] La clé API est correctement saisie et enregistrée pour au moins un service.
- [ ] La recherche de médias dans l'éditeur renvoie des résultats.
- [ ] Les images et/ou vidéos s'insèrent correctement dans le contenu.
- [ ] Les services configurés apparaissent dans le sélecteur de source de médias.
Remarques importantes
- Chaque clé API est liée à votre compte développeur sur le service concerné. Ne partagez pas vos clés API.
- Les quotas d'utilisation dépendent du plan de chaque service. Consultez la documentation du service pour connaître les limites.
- Si vous supprimez une clé API, le service correspondant ne sera plus disponible dans l'éditeur, mais les médias déjà insérés dans vos contenus ne seront pas affectés.
Résolution des problèmes
Aucun résultat n'apparaît lors de la recherche
- Vérifiez que la clé API est correctement saisie, sans espaces superflus.
- Assurez-vous que votre compte développeur est actif sur le site du service.
- Consultez la console du navigateur pour identifier d'éventuelles erreurs de requête.
- Testez avec un terme de recherche courant (par exemple, « nature » ou « city ») pour écarter un problème lié au mot-clé.
Comment choisir un service
- Si vous avez besoin de photos artistiques de haute qualité, commencez par Unsplash.
- Si vous recherchez à la fois des images et des vidéos, optez pour Pexels ou Pixabay.
- Si vous avez besoin de contenu libre de droits sans attribution, privilégiez Pixabay (CC0).
- Vous pouvez configurer plusieurs services simultanément et choisir la source au moment de la recherche.