We're currently working on documenting the new features and improvements in 4.5, ready for its release soon.

Dropbox repository: Difference between revisions

From MoodleDocs
(updating)
m (removing update template)
 
(12 intermediate revisions by 5 users not shown)
Line 4: Line 4:
==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''.
To use the Dropbox repository, an administrator must first create an [[OAuth 2 services|OAuth 2 service]].


===Dropbox configuration===
# Go to OAuth 2 services in Site administration - Server and click the button to create a new custom service.
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.
# 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.
===Getting sign up app keys at Dropbox===
 
*Click the "Dropbox Developers" link to go to https://www.dropbox.com/developers/apps and sign in.
* Click on "Create an app" and select "Dropbox API app":
[[File:dropboxapinew.png|center]]
*Choose the following:
** "Files and datastores"
** "My app needs access to files already on Dropbox
** "All file types"
[[File:dropboxsettings.png|center]]
 
*Give your app a name. (Make sure your app name does not contain the word "Dropbox". See note below.)
* 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.


==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:
[[File:dropboxlogin.png|center]]
[[File:dropboxlogin.png|center]]


When they are done, they can log out.
When they are done, they can log out.


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


* [http://www.somerandomthoughts.com/blog/2012/10/23/using-dropbox-repository-with-moodle/ Using Dropbox Repository with Moodle] blog post by Gavin Henrick
* 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 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