Note: You are currently viewing documentation for Moodle 1.9. Up-to-date documentation for the latest stable version is available here: MRBS block.

MRBS block: Difference between revisions

From MoodleDocs
Line 10: Line 10:
* Code - Copy the files into your Moodle blocks folder ($CFG->dirroot/blocks)
* Code - Copy the files into your Moodle blocks folder ($CFG->dirroot/blocks)
* Database - Login in as a Moodle Administrator and go to the Administration notifications page to create the MRBS tables
* Database - Login in as a Moodle Administrator and go to the Administration notifications page to create the MRBS tables
* Capabilities - The MRBS block is primarily intended for use on the Moodle front page. Privileges to use the scheduler are currently based on three custom defined capabilities: block/mrbs:administermrbs, block/mrbs:editmrbs, and block/mrbs:viewmrbs. Whlie these capabilities are created automatically, the system roles are not. As such, it is recommended that you create three system wide roles by going to the Site Administration block and clicking on Users - Permissions - Define Roles. Then click on the 'Add a new role' pushbutton. Fill in the Name, Short name, and description fields with MRBS Administrator, MRBS Scheduler, or MRBS Viewer depending on the role you are creating. Then under Permissions set the capability to allow for the respective role (i.e. block/mrbs:administermrbs for the MRBS Administrator role, block/mrbs:editmrbs for the MRBS Scheduler role, and block/mrbs:viewmrbs for the MRBS Viewer role). Scroll down to the bottom and click on the 'Add a new role' (or 'Save changes' if editing the role) pushbutton. Once the roles are created, then go to Site Administration block, and click on Frontpage - Frontpage roles. Assign users to the appropriate roles that you want. Typically, teachers get assigned as MRBS Schedulers and students as MRBS Viewers.
* Capabilities - The MRBS block is primarily intended for use on the Moodle front page. Privileges to use the scheduler are currently based on three custom defined capabilities:  
 
# block/mrbs:administermrbs
# block/mrbs:editmrbs
# block/mrbs:viewmrbs  
 
** While these capabilities are created automatically, the system roles are not. As such, it is recommended that you create three system wide roles by:
 
# Login as the Site administrator
# Go to the Site Administration block
# Click on Users -> Permissions -> Define Roles
# Click on the 'Add a new role' pushbutton
# Fill in the Name, Short name, and description fields with MRBS Administrator, MRBS Scheduler, or MRBS Viewer depending on the role you are creating.  
# Under Permissions set the capability to allow for the respective role (i.e. block/mrbs:administermrbs for the MRBS Administrator role, block/mrbs:editmrbs for the MRBS Scheduler role, and block/mrbs:viewmrbs for the MRBS Viewer role).  
# Scroll down to the bottom and click on the 'Add a new role' (or 'Save changes' if editing the role) pushbutton.  
# Once the roles are created, go to Site Administration block, click on Frontpage -> Frontpage roles and assign users to the appropriate/desired roles.  
 
** Typically, teachers get assigned as MRBS Schedulers and students as MRBS Viewers. Keep in mind that no assignment is equivalent to MRBS Viewers. Site administrators have the option of making the MRBS Calendar viewable to guests and non-logged in users. To force users to login in order to view the MRBS Calendar:
# Login as the site administrator
# Go to the Site Administration block under Security -> Site Policies
# Enable the 'Force users to login' setting


===Languages===
===Languages===

Revision as of 23:33, 17 August 2008

MRBS Block

The MRBS block integrates the MRBS project (http://sourceforge.net/projects/mrbs/) by using settings in the Moodle config.php to authenticate against the mdl_user file as its external database and thus allows for single sign on (SSO). While initially designed to work with Moodle 1.6 as a single sign on integration, later work made the MRBS project a contributed Moodle block. Stephen Bourget was kind enough to work on some changes to prepare the MRBS block to take advantage of roles and for use with Moodle 1.7 and beyond. Furthermore, a recently discovered SQL injection vulnerability in the MRBS application was patched. As a result, the MRBS integration/block is no longer supported or maintained for versions prior to Moodle 1.7. The MRBS block currently requires MySQL; however, I have added an issue in the tracker (http://tracker.moodle.org/browse/CONTRIB-340) to provide Postgresql support.

As with any customization, it is recommended that you have a good backup of your Moodle site before attempting to install contributed code. While those contributing code make every effort to provide the best code that they can, using contributed code nevertheless entails a certain degree of risk as contributed code is not as carefully reviewed and/or tested as the Moodle core code.

MRBS is useful for scheduling a variety of resources. More information about MRBS can be obtained at http://mrbs.sourceforge.net/. As distributed here it is setup for periods; however, this can easily be changed to times by modifying the config.inc.php file.

Installation

  • Code - Copy the files into your Moodle blocks folder ($CFG->dirroot/blocks)
  • Database - Login in as a Moodle Administrator and go to the Administration notifications page to create the MRBS tables
  • Capabilities - The MRBS block is primarily intended for use on the Moodle front page. Privileges to use the scheduler are currently based on three custom defined capabilities:
  1. block/mrbs:administermrbs
  2. block/mrbs:editmrbs
  3. block/mrbs:viewmrbs
    • While these capabilities are created automatically, the system roles are not. As such, it is recommended that you create three system wide roles by:
  1. Login as the Site administrator
  2. Go to the Site Administration block
  3. Click on Users -> Permissions -> Define Roles
  4. Click on the 'Add a new role' pushbutton
  5. Fill in the Name, Short name, and description fields with MRBS Administrator, MRBS Scheduler, or MRBS Viewer depending on the role you are creating.
  6. Under Permissions set the capability to allow for the respective role (i.e. block/mrbs:administermrbs for the MRBS Administrator role, block/mrbs:editmrbs for the MRBS Scheduler role, and block/mrbs:viewmrbs for the MRBS Viewer role).
  7. Scroll down to the bottom and click on the 'Add a new role' (or 'Save changes' if editing the role) pushbutton.
  8. Once the roles are created, go to Site Administration block, click on Frontpage -> Frontpage roles and assign users to the appropriate/desired roles.
    • Typically, teachers get assigned as MRBS Schedulers and students as MRBS Viewers. Keep in mind that no assignment is equivalent to MRBS Viewers. Site administrators have the option of making the MRBS Calendar viewable to guests and non-logged in users. To force users to login in order to view the MRBS Calendar:
  1. Login as the site administrator
  2. Go to the Site Administration block under Security -> Site Policies
  3. Enable the 'Force users to login' setting

Languages

Thanks to the generosity of translators, the MRBS Block is available in:

If you would like to supply translations for other languages, please create an issue in the tracker and attach a zip file of the language files.

To Do List

  • Postgresql support

Contributor/Maintainer

The MRBS Block was contributed and is maintained by Anthony Borrow. More information about the MRBS Block is available at: http://moodle.org/mod/data/view.php?d=13&rid=734