Dropbox-App erstellen und Konto verbinden

Damit deine Website deine Dropbox lesen kann, erstellst du in der Dropbox App Console eine private „App“, kopierst ihre zwei Schlüssel in WordPress und klickst auf Connect Dropbox account. Die Seite Dropbox Documents führt dich in nummerierten Schritten durch den Ablauf. Dieser Artikel erklärt jeden Schritt im Detail.

Bevor du beginnst

• Melde dich auf dropbox.com mit dem Dropbox-Konto an, in dem die Dateien liegen, die du teilen möchtest.
• Öffne in einem anderen Browser-Tab deinen WordPress-Adminbereich und klicke auf Dropbox Documents. Lass diesen Tab offen: Du kopierst Werte hin und her.
• Stelle sicher, dass deine Website-Adresse mit https:// beginnt. Wenn die Plugin-Seite „The site is not on HTTPS“ (Die Website läuft nicht über HTTPS) anzeigt, aktiviere zuerst bei deinem Hosting-Anbieter ein SSL-Zertifikat.

Schritt 1: die App bei Dropbox erstellen

1. Öffne die Dropbox App Console (die Seite ist auch in Schritt 1 der Plugin-Seite verlinkt).
2. Klicke auf Create app.
3. Wähle unter „Choose an API“ die Option Scoped access.
4. Wähle unter „Choose the type of access you need“ eine Option:
   • App folder (empfohlen, sicherer): Dropbox legt einen eigenen Ordner an, Apps/<your app name>, und die Website kann nur lesen, was darin liegt. Die Dateien zum Teilen legst du in diesen Ordner.
   • Full Dropbox: Die Website kann deine gesamte Dropbox lesen. Wähle diese Option, wenn die Dateien schon an anderer Stelle in deiner Dropbox geordnet sind und du sie nicht verschieben möchtest. Deine Zugriffsregeln bestimmen dann, welche Ordner Besucher tatsächlich sehen.
5. Gib der App einen Namen, zum Beispiel „Portal yoursite“. Der Name muss in ganz Dropbox einmalig sein, also füge etwas Persönliches hinzu.
6. Klicke auf Create app. Dropbox öffnet die Einstellungsseite der App mit mehreren Tabs oben.

Schritt 2: die Berechtigungen setzen

1. Klicke auf den Tab Permissions.
2. Setze ein Häkchen bei diesen drei Berechtigungen (Dropbox nennt sie „Scopes“):
   • account_info.read
   • files.metadata.read
   • files.content.read
3. Scrolle ganz nach unten auf der Seite und klicke auf Submit.

Das sind reine Leseberechtigungen. Das Plugin fragt nie nach dem Recht, deine Dateien zu ändern oder zu löschen.

Schritt 3: die Redirect URI einfügen

Die Redirect URI ist die Adresse deiner Website, zu der Dropbox dich zurückschickt, nachdem du die Verbindung erlaubt hast. Dropbox akzeptiert nur Adressen, die du vorher registriert hast.

1. Sieh dir in WordPress auf der Seite Dropbox Documents den Schritt 1 Create your Dropbox app an. Unter „Settings tab: paste this Redirect URI and press Add.“ siehst du deine Adresse in einem Feld mit einem Copy-Button. Klicke auf Copy.
2. Klicke bei Dropbox auf den Tab Settings deiner App.
3. Suche den Abschnitt OAuth 2 und das Feld Redirect URIs.
4. Füge die Adresse ein und klicke auf Add.

Die Adresse hat immer diese Form, mit deiner eigenen Website-Adresse am Anfang:

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

Wenn WordPress in einem Unterordner installiert ist, gehört der Unterordner dazu (zum Beispiel https://yoursite.com/blog/wp-admin/...). Kopiere immer genau den Wert, den das Plugin anzeigt: Er muss Zeichen für Zeichen übereinstimmen, auch die zwei Teile nach dem Fragezeichen.

Schritt 4: App key und App secret kopieren

1. Suche weiterhin im Dropbox-Tab Settings nach App key und App secret. Klicke beim Secret auf Show, um es anzuzeigen.
2. Kopiere den App key und füge ihn in Schritt 1 der WordPress-Seite in das Feld App key ein.
3. Kopiere das App secret und füge es in das Feld App secret ein.
4. Scrolle auf der WordPress-Seite ganz nach unten und klicke auf Save settings.

Nach dem Speichern bleibt das Secret-Feld leer und zeigt „Stored: leave empty to keep it“ (Gespeichert: leer lassen, um es zu behalten). Das ist normal: Das Secret ist gespeichert, wird aber nie wieder angezeigt. Lass das Feld leer, wenn du später andere Einstellungen speicherst.

Schritt 5: das Konto verbinden

1. In Schritt 2 Connect the account ist jetzt ein Button Connect Dropbox account sichtbar. Klicke darauf.
2. Dropbox öffnet sich und fragt, ob die App auf dein Konto zugreifen darf. Prüfe, dass du im richtigen Dropbox-Konto angemeldet bist, und klicke dann auf Continue und Allow.
3. Dropbox schickt dich zurück zu WordPress, das „Dropbox account connected.“ (Dropbox-Konto verbunden.) anzeigt.

Schritt 2 zeigt jetzt deinen Dropbox-Namen und deine E-Mail-Adresse mit einem grünen Abzeichen Connected, dazu zwei Buttons: Clear cache und Disconnect.

Prüfen, ob alles funktioniert

Unter dem Konto hat der Bereich Connection check einen Button Run check. Er führt zwei echte Abfragen bei Dropbox aus und zeigt, was zurückkommt, mit einer Schlusszeile in einfachen Worten. Wenn sie mit „Both calls work: the connection to Dropbox is fine.“ (Beide Abfragen funktionieren: Die Verbindung zu Dropbox ist in Ordnung.) endet, bist du fertig.

Weiter geht es mit Rollen Zugriff auf Ordner geben. Wenn die Verbindung fehlgeschlagen ist, lies Dropbox-Verbindungsfehler beheben.

Installation auf mehreren Kunden-Websites

Jede Website hat ihre eigene Redirect URI, die aus ihrer eigenen Adresse erzeugt wird. Üblich ist eine Dropbox-App pro Website, erstellt im Dropbox-Konto des jeweiligen Kunden. Du kannst aber auch mehrere Redirect URIs zur selben App hinzufügen, eine pro Website.