Note:

If you want to create a new page for developers, you should create it on the Moodle Developer Resource site.

Repository Administration Specification: Difference between revisions

From MoodleDocs
 
(6 intermediate revisions by the same user not shown)
Line 10: Line 10:
'''Related Documents:'''
'''Related Documents:'''
*[[Repository API| Repository API]]
*[[Repository API| Repository API]]
*[[Repository_Plugins| Repository Plugins]]
*[[Repository_Interface_for_Moodle/Course/User| Repository Interface for Moodle/Course/User]]
*[[QA:Use Case Number Attribution| Use Case Number Attribution]]
*[[QA:Use Case Number Attribution| Use Case Number Attribution]]
<br />
<br />
==Introduction==
==Introduction==
This document is about functional specification for Repository Administration
This document is about functional specification for Repository Administration<br />
Note: parts of this document about "settings a repository" (UC001-3) are generic to all plugins. Please see the [[Repository_Plugins| Repository Plugins]] wiki page for specific plugin specification.


==Requirements==
==Requirements==
Line 21: Line 24:


==User Interface==
==User Interface==
We want something similar to Admin > Modules > Filters > Manage Filters. Below an example:
We want something similar to Admin > Modules > Filters > Manage Filters (Admin > Modules > Repositories > Manage Repositories). Below an example:


[[Image:Admin repository.jpg]]
[[Image:Admin repository.jpg]]
Line 28: Line 31:
*Enable/Disable operation is available for all plugin
*Enable/Disable operation is available for all plugin
*Order operation is available for all plugin
*Order operation is available for all plugin
*Settings operation is not mandatory. This operation is available when the plugin package come with a settings.php file. All these plugin settings page should also be available from the Administration menu Admin > Modules > Repositories > "Repository Name"
*Settings operation is not mandatory. This operation is available when the plugin package come with a settings.php file. All these plugin settings page should also be available from some Administration menu entries: Admin > Modules > Repositories > "Repository Name"


=== Settings operation ===
=== Settings operation ===
Line 67: Line 70:
====Base scenario====
====Base scenario====
#User goes to the Repository Administration page
#User goes to the Repository Administration page
#User select Settings operation for a repository
#User selects Settings operation for a repository
#System displays Settings page
#User fills the settings form
#User selects save operation
#System displays a save successfull message
#System displays a save successfull message



Latest revision as of 09:09, 27 June 2008

Functional Specification Revisions:

0.1 - 26/06/2008 - Jerome Mouneyrac - Draft Version

Audience:

Moodle Administrator/Developer/QA tester

Status:

not implemented (Tracker Issue)

Related Documents:


Introduction

This document is about functional specification for Repository Administration
Note: parts of this document about "settings a repository" (UC001-3) are generic to all plugins. Please see the Repository Plugins wiki page for specific plugin specification.

Requirements

  • be able to enable/disable a repository
  • be able to order a repository (it will change the way repositories are displayed in the file picker)
  • be able to setup a repository

User Interface

We want something similar to Admin > Modules > Filters > Manage Filters (Admin > Modules > Repositories > Manage Repositories). Below an example:

Admin repository.jpg

  • The list is automatically generated. The list displays all repository plugin located in the moodle/repository/plugins folder
  • Enable/Disable operation is available for all plugin
  • Order operation is available for all plugin
  • Settings operation is not mandatory. This operation is available when the plugin package come with a settings.php file. All these plugin settings page should also be available from some Administration menu entries: Admin > Modules > Repositories > "Repository Name"

Settings operation

When user selects Settings operation for a repository, the system display a new page with a new form.
Settings options can be different for each module:

  • allow the user to "Remember password"
  • URL to the repository
  • Rename the repository (affect only the name displayed in Moodle)

Use Cases

UC001-1 Enable/Disable a repository

Base scenario

  1. User goes to the Repository Administration page
  2. User select Enable/Disable repository operation
  3. System displays the repository as Enable/Disable

Pre conditions

- the user has Admin permission in Moodle
- the repository is Disable/Enable

Post conditions

- the repository is available/not available

UC001-2 Order a repository

Base scenario

  1. User goes to the Repository Administration page
  2. User select Move operation for a repository
  3. System displays the new ordered repository list

Pre conditions

- the user has Admin permission in Moodle
- their is at least two repository in the list

Post conditions

- the repository has been moved one step up or down in the file picker repository list.

UC001-3 Setup a repository

Base scenario

  1. User goes to the Repository Administration page
  2. User selects Settings operation for a repository
  3. System displays Settings page
  4. User fills the settings form
  5. User selects save operation
  6. System displays a save successfull message

Pre conditions

- the user has Admin permission in Moodle
- the repository has been installed and has settings available