-

Note: You are currently viewing documentation for Moodle 3.10. Up-to-date documentation for the latest stable version of Moodle may be available here: Dropbox repository.

Dropbox repository: Difference between revisions

From MoodleDocs
(updating Dropbox app info (MDL-52051))
 
(4 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Repositories}}
{{Repositories}}
See MDL-52051 for details of the Dropbox API v2 migration.
The Dropbox repository enables users to copy or create a shortcut or alias to files from ''their own'' Dropbox. See [[Working with files]] for more details.
The Dropbox repository enables users to copy or create a shortcut or alias to files from ''their own'' Dropbox. See [[Working with files]] for more details.


Line 7: Line 5:


The Dropbox repository may be enabled by a site administrator from the Manage repositories link in Site administration.
The Dropbox repository may be enabled by a site administrator from the Manage repositories link in Site administration.
Site administration > Plugins > Repositories > Manage repositories > Settings


===Dropbox configuration===
===Dropbox configuration===
Line 30: Line 29:


[[File:dropboxrepo05.png|center]]
[[File:dropboxrepo05.png|center]]
* Go to the 'Permissions' tab and set the following scopes:
# account_info.read
# files.metadata.read
# files.content.read
# sharing.read
# sharing.write
'''NOTE: This is not required if it is an existing backpack created prior to Sept 17, 2020.'''


*If you wish, you can click the Branding tab and  add extra information for your users, including a custom logo they will see when they connect to Dropbox on your site:
*If you wish, you can click the Branding tab and  add extra information for your users, including a custom logo they will see when they connect to Dropbox on your site:
Line 49: Line 56:


* [http://www.somerandomthoughts.com/blog/2012/10/23/using-dropbox-repository-with-moodle/ Using Dropbox Repository with Moodle] blog post by Gavin Henrick  
* [http://www.somerandomthoughts.com/blog/2012/10/23/using-dropbox-repository-with-moodle/ Using Dropbox Repository with Moodle] blog post by Gavin Henrick  
* MDL-52051 - Dropbox API v2 migration
* MDL-70268 - Dropbox scope updates
* MDL-70271 - Dropbox API token updates


[[de:Dropbox Repository]]
[[de:Dropbox Repository]]
[[es:Repositorio Dropbox]]
[[ja:Dropbox]]
[[ja:Dropbox]]

Latest revision as of 03:40, 17 May 2021

The Dropbox repository enables users to copy or create a shortcut or alias to files from their own Dropbox. See Working with files for more details.

Enabling the Dropbox repository

The Dropbox repository may be enabled by a site administrator from the Manage repositories link in Site administration.

Site administration > Plugins > Repositories > Manage repositories > Settings

Dropbox configuration

  • Once enabled the administrator will need to add a Dropbox API Key and Secret. To get one, click on the "Dropbox developers" link on the Dropbox repository settings page, opening it in a new tab for convenience:
dropboxrepo01.png
  • On the next screen, sign in or create an account on Dropbox. If you don't immediately see a blue button 'Create app' then click the Developers link at the bottom of the screen. On the next screen, click to create a new app.
  • Choose Dropbox API', 'Full dropbox and name your app according to the branding rules:
dropboxrepo02.png
  • Click the blue 'Create app' button
  • On the next screen you will see an App key and an App secret. Copy these and go back to your Moodle site Dropbox repository settings page.
  • Paste these into the appropriate fields (1 below) and then copy the Redirect URL (2 below):
dropboxrepo4.png
  • Return to the Dropbox site. Paste in the Redirect URl and click Add:
dropboxrepo05.png
  • Go to the 'Permissions' tab and set the following scopes:
  1. account_info.read
  2. files.metadata.read
  3. files.content.read
  4. sharing.read
  5. sharing.write

NOTE: This is not required if it is an existing backpack created prior to Sept 17, 2020.

  • If you wish, you can click the Branding tab and add extra information for your users, including a custom logo they will see when they connect to Dropbox on your site:
dropboxrepo06.png

Using the Dropbox repository

To select a file via Dropbox, editing teachers will click on the Dropbox link in the file picker and log on to access the files in their account. They will see a message requesting access:

dropboxlogin.png

When they are done, they can log out.

Repository capabilities

There is just one capability, View a Dropbox folder, which is allowed for the default authenticated user role.

See also