Créer l’app Dropbox et connecter votre compte

Pour que votre site puisse lire votre Dropbox, vous créez une « app » privée dans la Dropbox App Console, vous copiez ses deux clés dans WordPress et vous cliquez sur Connect Dropbox. L’écran Dropbox Documents > Dropbox connection vous guide avec des étapes numérotées. Voici le détail de chaque étape.

Avant de commencer

• Connectez-vous à dropbox.com avec le compte Dropbox qui contient les fichiers à partager.
• Dans un autre onglet du navigateur, ouvrez l’administration de WordPress et allez dans Dropbox Documents > Dropbox connection. Gardez cet onglet ouvert : vous allez copier des valeurs d’un onglet à l’autre.
• Vérifiez que l’adresse de votre site commence par https://. Si l’écran Dropbox connection affiche « The site is not on HTTPS » (le site n’est pas en HTTPS), activez d’abord un certificat SSL auprès de votre hébergeur.

Étape 1 : créer l’app sur Dropbox

1. Ouvrez la Dropbox App Console (la page est aussi accessible depuis l’étape 1 Create the app de l’écran Dropbox connection).
2. Cliquez sur Create app.
3. Sous « Choose an API », sélectionnez Scoped access.
4. Sous « Choose the type of access you need », choisissez une option :
   • App folder (recommandé, plus sûr) : Dropbox crée un dossier dédié, Apps/<your app name>, et le site ne peut lire que ce qu’il contient. Vous y placez les fichiers à partager.
   • Full Dropbox : le site peut lire tout votre Dropbox. Choisissez cette option si les fichiers sont déjà rangés ailleurs dans votre Dropbox et que vous ne voulez pas les déplacer. Vos règles d’accès décident alors des dossiers que les visiteurs voient.
5. Donnez un nom à l’app, par exemple « Portail monsite ». Le nom doit être unique sur tout Dropbox : ajoutez-y quelque chose de personnel.
6. Cliquez sur Create app. Dropbox ouvre la page des réglages de l’app, avec plusieurs onglets en haut.

Étape 2 : définir les autorisations

1. Cliquez sur l’onglet Permissions.
2. Cochez ces trois autorisations (Dropbox les appelle « scopes ») :
   • account_info.read
   • files.metadata.read
   • files.content.read
3. Faites défiler jusqu’en bas de la page et cliquez sur Submit.

Ce sont des autorisations en lecture seule. L’extension ne demande jamais le droit de modifier ou de supprimer vos fichiers.

Étape 3 : coller la Redirect URI

La Redirect URI (URI de redirection) est l’adresse de votre site vers laquelle Dropbox vous renvoie une fois la connexion approuvée. Dropbox n’accepte que les adresses enregistrées à l’avance.

1. Dans WordPress, sur l’écran Dropbox connection, regardez l’étape 3 Paste the Redirect URI. Vous voyez votre adresse dans un cadre, avec un bouton Copy. Cliquez sur Copy.
2. De retour sur Dropbox, cliquez sur l’onglet Settings de votre app.
3. Repérez la section OAuth 2 et le champ Redirect URIs.
4. Collez l’adresse et cliquez sur Add.

L’adresse a toujours cette forme, avec l’adresse de votre site au début :

https://yoursite.com/wp-admin/admin.php?page=lr-dropbox-portal&lrdbp_oauth=callback

Si WordPress est installé dans un sous-dossier, celui-ci en fait partie (par exemple https://yoursite.com/blog/wp-admin/...). Copiez toujours la valeur exacte affichée par l’extension : elle doit correspondre caractère pour caractère, y compris les deux parties après le point d’interrogation.

Étape 4 : copier l’App key et l’App secret

1. Toujours dans l’onglet Settings de Dropbox, repérez App key et App secret. Pour le secret, cliquez sur Show pour l’afficher.
2. Copiez l’App key et collez-la dans le champ App key de l’étape 4 Copy the keys here de l’écran Dropbox connection.
3. Copiez l’App secret et collez-le dans le champ App secret.
4. Cliquez sur Save keys (enregistrer les clés). Vous voyez « Keys saved. Next: connect your Dropbox account. » (clés enregistrées, connectez maintenant votre compte Dropbox).

Après l’enregistrement, le champ du secret reste vide et affiche « Saved. Leave empty to keep it » (enregistré, laissez vide pour le conserver). C’est normal : le secret est enregistré mais n’est plus jamais affiché. Laissez-le vide si vous enregistrez à nouveau les clés plus tard.

Étape 5 : connecter le compte

1. En haut de l’écran Dropbox connection, le cadre Connect your Dropbox account contient maintenant un bouton Connect Dropbox. Cliquez dessus. (Le même bouton apparaît aussi dans le guide Start here de l’écran Folders and access.)
2. Dropbox s’ouvre et vous demande d’autoriser l’app à accéder à votre compte. Vérifiez que vous êtes connecté au bon compte Dropbox, puis cliquez sur Continue et Allow.
3. Dropbox vous renvoie vers WordPress, sur l’écran Folders and access, qui affiche « Your Dropbox account is connected. » (votre compte Dropbox est connecté). Dans le guide Start here, les deux premières étapes ont maintenant une coche.

Le haut de l’écran Dropbox connection affiche maintenant votre nom et votre e-mail Dropbox avec une étiquette verte Connected, ainsi que trois boutons : Check the connection (vérifier la connexion), Clear cache et Disconnect. Les étapes de création de l’app se replient sous Your Dropbox app : cliquez dessus pour les rouvrir.

Vérifier que tout fonctionne

Cliquez sur Check the connection. Il effectue deux vrais appels à Dropbox et affiche la réponse, avec une dernière ligne en langage clair. S’il se termine par « Both calls work: the connection to Dropbox is fine. » (les deux appels fonctionnent : la connexion à Dropbox est correcte), c’est terminé.

Ensuite : Donner aux rôles l’accès aux dossiers. Si la connexion a échoué, consultez Corriger les erreurs de connexion Dropbox.

Installer sur plusieurs sites clients

Chaque site a sa propre Redirect URI, générée à partir de sa propre adresse. La configuration habituelle est une app Dropbox par site, créée dans le compte Dropbox du client concerné. Vous pouvez aussi ajouter plusieurs Redirect URIs à la même app, une par site.