Dropbox repository: Difference between revisions

Latest revision as of 05:22, 7 July 2013

The Dropbox repository enables users to copy (but not link to) files from their own Dropbox into Moodle.

Enabling the Dropbox repository

The Dropbox repository may be enabled by a site administrator in Settings > Site administration > Plugins> Repositories > Manage repositories.

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 and follow the instructions below.

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", select "core" and give your app a name. (Make sure your app 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 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.

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. When they are done, they can log off.

Repository capabilities

There is just one capability, View a Dropbox folder, which is allowed for the default authenticated user role.

@@ Line 1: / Line 1: @@
-{{stub}}{{Moodle 2.0}}
+{{Repositories}}
+The Dropbox repository enables users to copy (but not link to) files from ''their own'' Dropbox into Moodle.
-A Dropbox repository can be enabled by an administrator in ''Site administration > Modules > Repositories > Manage repositories''.
+==Enabling the Dropbox repository==
-==Configuration==
+The Dropbox repository may be enabled by a site administrator in ''Settings > Site administration > Plugins> Repositories > Manage repositories''.
-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.
+===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 and follow the instructions below.
-To access it editing teachers need only "Add..." a new file while editing or creating a resource to see Dropbox as a new option.
+===Getting sign up app keys at Dropbox===
-==Configuration for Multiple Users==
+# Click the "Dropbox Developers" link to go to https://www.dropbox.com/developers/apps and sign in.
-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...
+# Click on "Create an app", select "core" and give your app a name. (Make sure your app 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 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.
+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. When they are done, they can log off.
+==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==
-* [http://www.youtube.com/watch?v=V221JLCywWs Import files from Dropbox into Moodle 2.0 video]
+* [http://www.somerandomthoughts.com/blog/2012/10/23/using-dropbox-repository-with-moodle/ Using Dropbox Repository with Moodle] blog post by Gavin Henrick
-* MDL-19168
-[[Category:Repositories]]
+[[de:Dropbox Repository]]
-[[de:Dropbox]]
+[[ja:Dropbox]]

Documentation