Dropbox

Après avoir installé l’application Dropbox, vous pouvez facilement référencer les ressources média de votre compte Dropbox directement dans l’application web Contentful.

L’application Dropbox est un widget qui permet aux éditeurs de sélectionner des ressources média à partir de leur compte Dropbox. Cliquez simplement sur Sélectionner ou télécharger un fichier sur Dropbox et sélectionnez les ressources média que vous souhaitez référencer à partir de votre entrée.

Les identifiants des ressources média sélectionnées sont ensuite stockés dans Contentful. Dans votre application client, vous récupérez ensuite le contenu de Contentful et résolvez tous les détails nécessaires sur les médias par les URL stockées.

Pour utiliser cette application, vous aurez besoin d’un type de contenu avec un champ de type objet JSON pour contenir les références aux ressources Dropbox.

Étape 1 : installer et configurer

Sous Affectation de champ, sélectionnez les champs de type de contenu pour lesquels vous souhaitez que cette application soit utilisée. Veuillez noter que seuls les champs compatibles de type objet JSON sont affichés ici.

Cliquez sur Installer pour terminer l’installation et enregistrer la configuration.

Étape 2 : comment utiliser l’application

Pour référencer une ressource média sur Dropbox à partir de votre entrée :

1. Cliquez sur Sélectionner ou télécharger un fichier sur Dropbox.

2. Sélectionnez les ressources média dans Dropbox à l’aide de la boîte de dialogue.

3. Cliquez sur Choisir.

Les aperçus de vos ressources média sont affichés dans votre entrée.

Il n’y a pas de types de contenu avec le champ objet JSON, à l’aide !

Dropbox enregistre les données dans une entrée Contentful à l’aide de données JSON. Si vous souhaitez associer des ressources Dropbox à un type de contenu spécifique, vous devez mettre à jour ce type de contenu afin d’y inclure un nouveau champ de type objet JSON. Pour en savoir plus sur le type de champ objet JSON, consultez notre documentation sur les concepts.

Que faire si l’éditeur d’entrées affiche l’avertissement « La valeur du champ est incompatible » ?

Le champ objet JSON de cette entrée contient déjà des données qui n’ont pas été générées par l’application Dropbox. Veuillez vous assurer que vous avez sélectionné le bon champ dans la configuration de l’application à utiliser avec Dropbox et que vous n’avez plus besoin des données précédemment saisies. Sélectionnez ensuite Je souhaite remplacer la valeur à l’aide de l’application, ce qui initialisera le champ avec une sélection vide. Vous pouvez maintenant commencer à ajouter des médias à votre entrée.

Pour accéder à la valeur du champ sous-jacent, désélectionnez le champ dans la configuration de l’application Dropbox. Cela réinitialisera l’éditeur à l’affichage JSON par défaut pour les champs d’objet.

Comment utiliser la réponse JSON sur mon implémentation client ?

L’objet JSON renvoyé par l’API Contentful sera rempli avec certaines données Dropbox. La propriété principale à rechercher lors de l’ajout de votre ressource média Dropbox à une balise img est la propriété du lien. Cependant, le lien nécessitera une modification mineure. Dropbox envoie un lien avec une chaîne de requête de ?dl=0. Vous devrez remplacer cela par ?raw=1. Cela garantit que vous obtenez une URL de téléchargement qui convient à l’utilisation avec une balise img.