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

Dropbox repository: Difference between revisions

From MoodleDocs
(update template, tracker issue link)
(Added relevant issues that deal with setting up and connecting to dropbox)
 
(7 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Repositories}}
{{Repositories}}
{{Template:Update}}
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.


==Enabling the Dropbox repository==
==Enabling the Dropbox repository==


The Dropbox repository may be enabled by a site administrator in ''Administration > Site administration > Plugins> Repositories > Manage repositories''.
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===
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 and follow the instructions below.
*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:
 
[[File:dropboxrepo01.png|thumb|700px|center]]
 
*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:
 
[[File:dropboxrepo02.png|thumb|center|700px]]
 
* 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):
 
[[File:dropboxrepo4.png|thumb|center|700px]]
 
* Return to the Dropbox site. Paste in the Redirect URl and click Add:


===Getting sign up app keys at Dropbox===
[[File:dropboxrepo05.png|center]]


*Click the "Dropbox Developers" link to go to https://www.dropbox.com/developers/apps and sign in.
* Go to the 'Permissions' tab and set the following scopes:
* Click on "Create an app" and  select "Dropbox API app":
# account_info.read
[[File:dropboxapinew.png|center]]
# files.metadata.read
*Choose the following:
# files.content.read
** "Files and datastores"
# sharing.read
** "My app needs access to files already on Dropbox
# sharing.write
** "All file types"
'''NOTE: This is not required if it is an existing backpack created prior to Sept 17, 2020.'''
[[File:dropboxsettings.png|center]]


*Give your app a name. (Make sure your app name does not contain the word "Dropbox". See note below.)
*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:
* Copy the app keys to Moodle and save your changes.
* Please note that to make the Dropbox repository available to more than one hundred users on your site, you will need to request that your status be changed to "Production". Follow the link on Dropbox which allows you to make that request.


NOTE: Your app name cannot contain the word "Dropbox" as it goes against Dropbox branding policy (found here: https://www.dropbox.com/developers/branding). For quick approval of of your app to production status you are advised to completely follow the guidelines in the branding policy.
[[File:dropboxrepo06.png|center]]


==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:
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:
Line 42: 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 02:39, 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