Dropbox repository: Difference between revisions

From MoodleDocs
(page update - thanks to info from https://moodle.org/mod/forum/discuss.php?d=448105)
 
(27 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Repositories}}
{{Repositories}}
The Dropbox repository enables users to copy (but not link to) files from ''their own'' Dropbox into Moodle.  
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 ''Settings > Site administration > Modules > Repositories > Manage repositories''.
To use the Dropbox repository, an administrator must first create an [[OAuth 2 services|OAuth 2 service]].


===Sign up app keys at dropbox===
# 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.


# Go to https://www.dropbox.com/developers/apps and sign in.
==Using the Dropbox repository==
# Click on "Create an app", select "core" and give your app a name. (See note below about naming guidelines.)
# Complete the rest of the fields on the page.
# Copy the app keys to Moodle


NOTE: Make sure your app name does not contain the word "Dropbox" as it goes against Dropbox branding policy(found here: https://www.dropbox.com/developers/branding).
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:
[[File:dropboxlogin.png|center]]


===Dropbox configuration===
When they are done, they can log out.
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.  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. Select "Core" to get the API Secret and Key.  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 and users can log in with their own Dropbox credentials to access their own Dropbox files. 
 
To access it editing teachers need only "Add..." a new file while editing or creating a resource to see Dropbox as a new option.
 
Import files from Dropbox into Moodle 2.0 video:
 
<mediaplayer>http://www.youtube.com/watch?v=V221JLCywWs</mediaplayer>


==Repository capabilities==
==Repository capabilities==
Line 30: Line 23:
==See also==
==See also==


* MDL-26949 - Dropbox repository - only app creator can use the dropbox but no other user in dropbox development mode
* MDL-70268 - Dropbox scope updates
* [http://www.somerandomthoughts.com/blog/2012/10/23/using-dropbox-repository-with-moodle/ Using Dropbox Repository with Moodle] blog post by Gavin Henrick
* MDL-70271 - Dropbox API token updates


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

Latest revision as of 07:57, 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