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

Dropbox repository: Difference between revisions

From MoodleDocs
(see also tracker issue link)
 
(18 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 > Plugins> 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 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:


===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. (Make sure the name does not contain the word "dropbox". See note below.)
# Complete the rest of the fields on the page.
# Copy the app keys to Moodle and save your changes.
# 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: Your app name cannot contain the word "Dropbox" as it goes 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