Note: You are currently viewing documentation for Moodle 3.4. Up-to-date documentation for the latest stable version of Moodle is likely available here: Dropbox repository.

Dropbox repository: Difference between revisions

From MoodleDocs
(see also tracker issue link)
 
(19 intermediate revisions by 3 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''.
The Dropbox repository may be enabled by a site administrator from the Manage repositories link in Site administration.


===Dropbox configuration===
===Dropbox configuration===
Once enabled by the administrator, a Dropbox API Key and Secret will need to be added.  To get one, click on 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.
*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:


===Getting sign up app keys at dropbox===
[[File:dropboxrepo01.png|thumb|700px|center]]


# Go to https://www.dropbox.com/developers/apps and sign in.
*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.
# 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
# Please note that to make your repository available for more than one hundred users, you need to request that your status be changed to "Production".


NOTE: Make sure your app name does not contain the word "Dropbox" as it is against Dropbox branding policy (found here: https://www.dropbox.com/developers/branding).
* Choose '''Dropbox API', 'Full dropbox''' and name your app according to the branding rules:


[[File:dropboxrepo02.png|thumb|center|700px]]


To access it editing teachers need only "Add..." a new file while editing or creating a resource to see Dropbox as a new option.
* Click the blue 'Create app' button


Import files from Dropbox into Moodle 2.0 video:
* 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.


<mediaplayer>http://www.youtube.com/watch?v=V221JLCywWs</mediaplayer>
* 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:
 
[[File:dropboxrepo05.png|center]]
 
*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:
 
[[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:
[[File:dropboxlogin.png|center]]
 
When they are done, they can log out.


==Repository capabilities==
==Repository capabilities==
Line 32: Line 46:
==See also==
==See also==


* MDL-26949 - Dropbox repository - only app creator can use the dropbox but no other user in dropbox development mode
* [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


[[de:Dropbox Repository]]
[[de:Dropbox Repository]]
[[ja:Dropbox]]
[[ja:Dropbox]]

Latest revision as of 14:28, 2 June 2017

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.

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
  • 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