Crear la app de Dropbox y conectar tu cuenta

Para que tu sitio pueda leer tu Dropbox, creas una "app" privada en la Dropbox App Console, copias sus dos claves en WordPress y haces clic en Connect Dropbox. La pantalla Dropbox Documents > Dropbox connection te guía con pasos numerados. Este artículo explica cada paso en detalle.

Antes de empezar

• Inicia sesión en dropbox.com con la cuenta de Dropbox que contiene los archivos que quieres compartir.
• En otra pestaña del navegador, abre la administración de WordPress y ve a Dropbox Documents > Dropbox connection. Deja esta pestaña abierta: vas a copiar valores de un lado a otro.
• Comprueba que la dirección de tu sitio empieza por https://. Si la pantalla Dropbox connection muestra "The site is not on HTTPS" (El sitio no está en HTTPS), activa primero un certificado SSL con tu proveedor de hosting.

Paso 1: crea la app en Dropbox

1. Abre la Dropbox App Console (la página también está enlazada en el paso 1 Create the app de la pantalla Dropbox connection).
2. Haz clic en Create app.
3. En "Choose an API", selecciona Scoped access.
4. En "Choose the type of access you need", elige una opción:
   • App folder (recomendada, más segura): Dropbox crea una carpeta dedicada, Apps/<your app name>, y el sitio solo puede leer lo que hay dentro. Pones en esa carpeta los archivos que quieres compartir.
   • Full Dropbox: el sitio puede leer todo tu Dropbox. Elígela si los archivos ya están organizados en otro lugar de tu Dropbox y no quieres moverlos. Tus reglas de acceso deciden entonces qué carpetas ven realmente los visitantes.
5. Pon un nombre a la app, por ejemplo "Portal tusitio". El nombre debe ser único en todo Dropbox, así que añade algo personal.
6. Haz clic en Create app. Dropbox abre la página de ajustes de la app, con varias pestañas arriba.

Paso 2: configura los permisos

1. Haz clic en la pestaña Permissions.
2. Marca estos tres permisos (Dropbox los llama "scopes"):
   • account_info.read
   • files.metadata.read
   • files.content.read
3. Baja hasta el final de la página y haz clic en Submit.

Son permisos de solo lectura. El plugin nunca pide el derecho a modificar o borrar tus archivos.

Paso 3: pega la Redirect URI

La Redirect URI es la dirección de tu sitio a la que Dropbox te devuelve después de aprobar la conexión. Dropbox solo acepta direcciones que hayas registrado antes.

1. En WordPress, en la pantalla Dropbox connection, mira el paso 3 Paste the Redirect URI. Ves tu dirección en un recuadro, con un botón Copy. Haz clic en Copy.
2. De vuelta en Dropbox, haz clic en la pestaña Settings de tu app.
3. Busca la sección OAuth 2 y el campo Redirect URIs.
4. Pega la dirección y haz clic en Add.

La dirección siempre tiene esta forma, con la dirección de tu sitio al principio:

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

Si WordPress está instalado en una subcarpeta, la subcarpeta forma parte de ella (por ejemplo https://yoursite.com/blog/wp-admin/...). Copia siempre el valor exacto que muestra el plugin: debe coincidir carácter por carácter, incluidas las dos partes que van después del signo de interrogación.

Paso 4: copia la App key y el App secret

1. Todavía en la pestaña Settings de Dropbox, busca App key y App secret. Para ver el secret, haz clic en Show.
2. Copia la App key y pégala en el campo App key del paso 4 Copy the keys here de la pantalla Dropbox connection.
3. Copia el App secret y pégalo en el campo App secret.
4. Haz clic en Save keys (guardar claves). Verás "Keys saved. Next: connect your Dropbox account." (Claves guardadas. Ahora conecta tu cuenta de Dropbox).

Después de guardar, el campo del secret queda vacío y muestra "Saved. Leave empty to keep it" (Guardado. Déjalo vacío para conservarlo). Es normal: el secret está guardado pero nunca se vuelve a mostrar. Déjalo vacío si más adelante vuelves a guardar las claves.

Paso 5: conecta la cuenta

1. En la parte superior de la pantalla Dropbox connection, el recuadro Connect your Dropbox account tiene ahora un botón Connect Dropbox. Haz clic en él. (El mismo botón aparece también en la guía Start here de la pantalla Folders and access).
2. Se abre Dropbox y te pide que permitas a la app acceder a tu cuenta. Comprueba que has iniciado sesión con la cuenta de Dropbox correcta y haz clic en Continue y Allow.
3. Dropbox te devuelve a WordPress, a la pantalla Folders and access, que muestra "Your Dropbox account is connected." (Tu cuenta de Dropbox está conectada). En la guía Start here, los dos primeros pasos tienen ya su marca.

La parte superior de la pantalla Dropbox connection muestra ahora tu nombre y tu correo de Dropbox con una etiqueta verde Connected, además de tres botones: Check the connection (comprobar la conexión), Clear cache (vaciar la caché) y Disconnect (desconectar). Los pasos de configuración de la app se pliegan en Your Dropbox app: haz clic ahí para volver a abrirlos.

Comprueba que funciona

Haz clic en Check the connection. Hace dos llamadas reales a Dropbox y muestra lo que recibe, con una línea final en lenguaje sencillo. Si termina con "Both calls work: the connection to Dropbox is fine." (Las dos llamadas funcionan: la conexión con Dropbox está bien), ya has terminado.

Siguiente: Dar acceso a las carpetas por rol. Si la conexión ha fallado, consulta Solucionar errores de conexión con Dropbox.

Instalar en varios sitios de clientes

Cada sitio tiene su propia Redirect URI, generada a partir de su dirección. Lo habitual es una app de Dropbox por sitio, creada en la cuenta de Dropbox de ese cliente. También puedes añadir varias Redirect URIs a la misma app, una por sitio.