Dropbox repository: Difference between revisions

From MoodleDocs
No edit summary
m (removing update template)
 
(51 intermediate revisions by 13 users not shown)
Line 1: Line 1:
{{stub}}{{Moodle 2.0}}
{{Repositories}}
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.


A Dropbox repository can be enabled by an administrator in ''Site administration > Modules > Repositories > Manage repositories''.
==Enabling the Dropbox repository==


==Configuration==
To use the Dropbox repository, an administrator must first create an [[OAuth 2 services|OAuth 2 service]].
Once enabled by the administrator a Dropbox API Key and Secret will need to be added to the Dropbox settings in order for it to work.  This will be ''the'' Dropbox available to all users throughout the site (and each will need the correct Dropbox login credentials to access it from their courses).  To gather the Dropbox API Key and Secret click the "Dropbox Developers" link on the Dropbox repository settings page.  On the next page you'll be prompted to login with your Dropbox username and password and to create a Dropbox app.


Once the App has been created at Dropbox.com you'll have the API Secret and Key available at the bottom of the App page. Entering those on the Dropbox settings page (and clicking Save) back in Moodle will finish the configuration.  Dropbox is now available to the entire site.
# Go to OAuth 2 services in Site administration - Server and click the button to create a new custom service.
# Go to 'Manage repositories' in Site administration and enable the Dropbox repository.
# On the Dropbox configuration page, select the OAuth 2 service then save changes.


To access it editing teachers need only "Add..." a new file while editing or creating a resource to see Dropbox as a new option. 
==Using the Dropbox repository==


==Configuration for Multiple Users==
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:
Logging in with a different account from which the Dropbox App was created results in this error "Only the app owner can receive access token while this app is in development mode". To configure the Dropbox repository for multiple users you must...
[[File:dropboxlogin.png|center]]
 
When they are done, they can log out.
 
==Repository capabilities==
 
There is just one capability, [[Capabilities/repository/dropbox:view|View a Dropbox folder]], which is allowed for the default authenticated user role.  


==See also==
==See also==


* [http://www.youtube.com/watch?v=V221JLCywWs Import files from Dropbox into Moodle 2.0 video]
* MDL-70268 - Dropbox scope updates
* MDL-19168
* MDL-70271 - Dropbox API token updates


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

Latest revision as of 07:56, 16 August 2023

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

To use the Dropbox repository, an administrator must first create an OAuth 2 service.

  1. Go to OAuth 2 services in Site administration - Server and click the button to create a new custom service.
  2. Go to 'Manage repositories' in Site administration and enable the Dropbox repository.
  3. On the Dropbox configuration page, select the OAuth 2 service then save changes.

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