Box.net APIv1 migration: Difference between revisions
Helen Foster (talk | contribs) m (→Box.net API v2: rewording) |
Helen Foster (talk | contribs) |
||
Line 30: | Line 30: | ||
===Box.net repository configuration=== | ===Box.net repository configuration=== | ||
# Go to ''Administration > Site administration > Plugins > Repositories > Manage Repositories'' | # Go to ''Administration > Site administration > Plugins > Repositories > Manage Repositories'' | ||
# | # Reactivate the Box.net repository by selecting 'Enabled and visible' in the dropdown menu | ||
# Configure | # Configure the repository plugin by entering the client ID and secret from [https://app.box.com/developers/services Box.net]. Make sure you don't include any white space in the text boxes! | ||
# Save changes | # Save changes | ||
If you can't remember your Box.net client ID and secret, you can obtain new ones by following the instructions in [[Box.net repository]]. | |||
===Box.net portfolio configuration=== | ===Box.net portfolio configuration=== | ||
# Go to ''Administration > Site administration > Plugins > Portfolios > Manage Portfolios'' | # Go to ''Administration > Site administration > Plugins > Portfolios > Manage Portfolios'' | ||
# | # Reactivate the Box.net portfolio by selecting 'Enabled and visible' in the dropdown menu | ||
# Configure | # Configure the portfolio plugin by entering the client ID and secret from [https://app.box.com/developers/services Box.net] | ||
# Save changes | # Save changes | ||
Note: You can use the same client ID and secret for the Box.net repository and Box.net portfolio. | |||
[[Category:Site administration]] | [[Category:Site administration]] | ||
[[Category:Portfolios]] | [[Category:Portfolios]] |
Revision as of 10:48, 19 November 2013
Note: This page contains information for site administrators only.
Box.net API v2
Box.net API v1, which Moodle uses to interact with the Box.net repository and Box.net portfolio, is due to expire on 14 December 2013. It will be replaced by Box.net API v2. Two important consequences of the new API are:
- For Box.net repository users it will no longer be possible to create a shortcut/alias to a file stored in Box.net. Existing aliases will need to be converted to file copies by running the Box.net-alias-to-copy-conversion tool.
- The Moodle site must use HTTPS in order to access Box.net.
The Box.net-alias-to-copy-conversion tool
IMPORTANT: The Box.net-alias-to-copy-conversion tool must be used before 14 December 2013 to avoid data loss!
Administrators are advised to run the Box.net-alias-to-copy-conversion tool immediately after upgrading their site. It may be run
Either from within Moodle:
- Go to Administration > Site administration > Modules > Repositories > Manage repositories and click the settings link for Box.net
- Click the link to run the tool.
Or via a CLI script, found at /repository/boxnet/cli/migrationv1.php.
Please be aware that this tool could take several hours to run depending on the number of aliases and their size.
Continued use of the Box.net repository and portfolio
To continue using the Box.net repository and Box.net portfolio, the Moodle site must use HTTPS. Assuming this criterion is satisfied, after upgrading their site, administrators must reconfigure the Box.net repository and portfolio plugins as follows:
Box.net repository configuration
- Go to Administration > Site administration > Plugins > Repositories > Manage Repositories
- Reactivate the Box.net repository by selecting 'Enabled and visible' in the dropdown menu
- Configure the repository plugin by entering the client ID and secret from Box.net. Make sure you don't include any white space in the text boxes!
- Save changes
If you can't remember your Box.net client ID and secret, you can obtain new ones by following the instructions in Box.net repository.
Box.net portfolio configuration
- Go to Administration > Site administration > Plugins > Portfolios > Manage Portfolios
- Reactivate the Box.net portfolio by selecting 'Enabled and visible' in the dropdown menu
- Configure the portfolio plugin by entering the client ID and secret from Box.net
- Save changes
Note: You can use the same client ID and secret for the Box.net repository and Box.net portfolio.