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 account. La page Dropbox Documents vous guide avec des étapes numérotées. Cet article explique chaque étape en détail.

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 cliquez sur Dropbox Documents. 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 la page de l’extension 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 de la page de l’extension).
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. Ce sont alors vos règles d’accès qui décident des dossiers que les visiteurs voient vraiment.
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 la page Dropbox Documents, regardez l’étape 1 Create your Dropbox app. Sous « Settings tab: paste this Redirect URI and press Add. », 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 1 de la page WordPress.
3. Copiez l’App secret et collez-le dans le champ App secret.
4. Faites défiler jusqu’en bas de la page WordPress et cliquez sur Save settings.

Après l’enregistrement, le champ du secret reste vide et affiche « Stored: 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 quand vous enregistrez d’autres réglages plus tard.

Étape 5 : connecter le compte

1. À l’étape 2 Connect the account, un bouton Connect Dropbox account est maintenant visible. Cliquez dessus.
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, qui affiche « Dropbox account connected. » (compte Dropbox connecté).

L’étape 2 affiche maintenant votre nom et votre e-mail Dropbox avec un badge vert Connected, ainsi que deux boutons : Clear cache et Disconnect.

Vérifier que tout fonctionne

Sous le compte, le panneau Connection check contient un bouton Run check. 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.