Crea la app Dropbox e collega il tuo account

Per permettere al tuo sito di leggere il tuo Dropbox, crei una "app" privata nella Dropbox App Console, copi le sue due chiavi in WordPress e clicchi Collega Dropbox. La schermata Documenti Dropbox > Collegamento a Dropbox ti guida con dei passaggi numerati. Questo articolo spiega ogni passaggio nel dettaglio.

Prima di iniziare

• Accedi a dropbox.com con l'account Dropbox che contiene i file che vuoi condividere.
• In un'altra scheda del browser apri il pannello di WordPress e vai su Documenti Dropbox > Collegamento a Dropbox. Tieni aperta questa scheda: copierai valori avanti e indietro.
• Controlla che l'indirizzo del tuo sito inizi con https://. Se la schermata Collegamento a Dropbox mostra "Il sito non è in HTTPS", attiva prima un certificato SSL con il tuo hosting.

Passo 1: crea la app su Dropbox

1. Apri la Dropbox App Console (il link c'è anche nel passo 1 Crea l'app della schermata Collegamento a Dropbox).
2. Clicca Create app.
3. Sotto "Choose an API" seleziona Scoped access.
4. Sotto "Choose the type of access you need" scegli una delle due opzioni:
   • App folder (consigliata, più sicura): Dropbox crea una cartella dedicata, Apps/<your app name>, e il sito può leggere solo quello che c'è dentro. Metti in quella cartella i file da condividere.
   • Full Dropbox: il sito può leggere tutto il tuo Dropbox. Sceglila se i file sono già organizzati altrove nel tuo Dropbox e non vuoi spostarli. Saranno poi le regole di accesso a decidere quali cartelle vedono davvero i visitatori.
5. Dai un nome alla app, per esempio "Portale tuosito". Il nome deve essere unico su tutto Dropbox, quindi aggiungi qualcosa di personale.
6. Clicca Create app. Dropbox apre la pagina delle impostazioni della app, con diverse schede in alto.

Passo 2: imposta i permessi

1. Clicca la scheda Permissions.
2. Spunta questi tre permessi (Dropbox li chiama "scopes"):
   • account_info.read
   • files.metadata.read
   • files.content.read
3. Scorri fino in fondo alla pagina e clicca Submit.

Sono permessi di sola lettura. Il plugin non chiede mai il diritto di modificare o eliminare i tuoi file.

Passo 3: incolla il Redirect URI

Il Redirect URI è l'indirizzo del tuo sito a cui Dropbox ti rimanda dopo che hai approvato il collegamento. Dropbox accetta solo indirizzi registrati in anticipo.

1. In WordPress, nella schermata Collegamento a Dropbox, guarda il passo 3 Incolla il Redirect URI. Vedi il tuo indirizzo in un riquadro, con un pulsante Copia. Clicca Copia.
2. Torna su Dropbox e clicca la scheda Settings della tua app.
3. Trova la sezione OAuth 2 e il campo Redirect URIs.
4. Incolla l'indirizzo e clicca Add.

L'indirizzo ha sempre questa forma, con l'indirizzo del tuo sito all'inizio:

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

Se WordPress è installato in una sottocartella, la sottocartella fa parte dell'indirizzo (per esempio https://yoursite.com/blog/wp-admin/...). Copia sempre il valore esatto mostrato dal plugin: deve corrispondere carattere per carattere, comprese le due parti dopo il punto interrogativo.

Passo 4: copia App key e App secret

1. Sempre nella scheda Settings di Dropbox, trova App key e App secret. Per il secret clicca Show per vederlo.
2. Copia la App key e incollala nel campo App key del passo 4 Copia qui le chiavi della schermata Collegamento a Dropbox.
3. Copia il App secret e incollalo nel campo App secret.
4. Clicca Salva le chiavi. Vedi "Chiavi salvate. Ora collega il tuo account Dropbox."

Dopo il salvataggio il campo del secret resta vuoto e mostra "Salvato. Lascia vuoto per mantenerlo". È normale: il secret è salvato ma non viene più mostrato. Lascialo vuoto se in seguito salvi di nuovo le chiavi.

Passo 5: collega l'account

1. In cima alla schermata Collegamento a Dropbox, il riquadro Collega il tuo account Dropbox ora ha un pulsante Collega Dropbox. Cliccalo. (Lo stesso pulsante compare anche nella guida Inizia da qui della schermata Cartelle e accessi.)
2. Si apre Dropbox e ti chiede di consentire alla app l'accesso al tuo account. Controlla di essere collegato all'account Dropbox giusto, poi clicca Continue e Allow.
3. Dropbox ti rimanda a WordPress, nella schermata Cartelle e accessi, che mostra "Il tuo account Dropbox è collegato." Nella guida Inizia da qui i primi due passaggi ora hanno la spunta.

Ora in cima alla schermata Collegamento a Dropbox vedi il tuo nome e la tua email di Dropbox con un'etichetta verde Connesso, più tre pulsanti: Verifica il collegamento, Svuota cache e Scollega. I passaggi di configurazione della app si richiudono in La tua app Dropbox: cliccalo per riaprirli.

Controlla che funzioni

Clicca Verifica il collegamento. Fa due chiamate reali a Dropbox e stampa le risposte, con una riga finale in parole semplici. Se termina con "Entrambe le chiamate funzionano: la connessione a Dropbox è a posto.", hai finito.

Prossimo passo: Dai ai ruoli l'accesso alle cartelle. Se il collegamento non è riuscito, vedi Risolvi gli errori di collegamento a Dropbox.

Installazione su più siti di clienti

Ogni sito ha il suo Redirect URI, generato dal suo indirizzo. La configurazione tipica è una app Dropbox per ogni sito, creata nell'account Dropbox di quel cliente. Puoi anche aggiungere più Redirect URI alla stessa app, uno per sito.