admin/setting/blocksettingmrbs

From MoodleDocs

MRBS Block Settings

(MRBS stands for Meeting Room Booking System.)

Window

When set to 'New window', the MRBS block will open in a new window. When set to 'Same window', the MRBS block will open inside Moodle, with the Moodle headers.


MRBS Installation Path

Place on your Moodle's server where the MRBS block is installed. This is usually at:

http://www.yourwebsitename.suffix/moodle/blocks/mrbs/web


MRBS Admin

Name of the MRBS administrator


MRBS admin email Email address of the MRBS administrator. In order to receive MRBS email notifications, the email address must be associated with a Moodle user account.


Use Periods

If set to 'No', MRBS will present a standard time resolution for room bookings. If set to 'Yes', then MRBS will refer to the 'Custom periods' you define below...

Setting 'Use periods' to 'Yes', will make an empty 'Custom Periods' text box appear, for you to fill in (see below).

Warning: If you set MRBS to Use custom periods and then define and save these, and later decide that you do not wish to use Custom periods after all and set 'Use periods' top 'No', then this may cause errors in the proper functioning of MRBS. If this happens, re-set 'Use periods' to 'Yes' and ensure the desired period resolution is typed into the 'Custom Periods' box (see below).


Custom Periods

Typing times into this box in an appropriate format, will present the user with those times to be able to book rooms to. For example, if you want users to be able to book a room at 3.15pm or 3.45pm, then you will need to define presented (Custom) periods to resolve to a quarter hour. If you wanted users to be able to book rooms only every half hour, then you would need to define custom periods in that way.

The required format for lists of times in the Custom periods box can be in am/pm format or 24-hour format. For am/pm, the following will work:


9.00am

9.30am

10.00am

10.30am

...etc.


Notice that there has to be a carriage return between each individual given time, with no spaces in between.

To save you time, you may wish to copy and paste from the lists below, extending or curtailing these earlier or later as required before pasting them in to your 'Custom Periods' box:

Half-hourly custom periods to paste into Custom periods box:


8.00am

8.30am

9.00am

9.30am

10.00am

10.30am

11.00am

11.30am

12.00pm

12.30pm

1.00pm

1.30pm

2.00pm

2.30pm

3.00pm

3.30pm

4.00pm

4.30pm

5.00pm

5.30pm

6.00pm

6.30pm

7.00pm

7.30pm

8.00pm

8.30pm

9.00pm



Quarter-hourly custom periods to paste into Custom periods box:


8.00am

8.15am

8.30am

8.45am

9.00am

9.15am

9.30am

9.45am

10.00am

10.15am

10.30am

10.45am

11.00am

11.15am

11.30am

11.45am

12.00pm

12.15pm

12.30pm

12.45pm

1.00pm

1.15pm

1.30pm

1.45pm

2.00pm

2.15pm

2.30pm

2.45pm

3.00pm

3.15pm

3.30pm

3.45pm

4.00pm

4.15pm

4.30pm

4.45pm

5.00pm

5.15pm

5.30pm

5.45pm

6.00pm

6.15pm

6.30pm

6.45pm

7.00pm

7.15pm

7.30pm

7.45pm

8.00pm

8.15pm

8.30pm

8.45pm

9.00pm


Alternatively, you might want to have rooms bookable to a resolution of 5-minute intervals etc.


Start of Week

Day you want your week to start, e.g. 'Monday'.


Length of week

The week can be curtailed, for example to exclude weekends. Do do this, set 'Start of week' (see above) to 'Monday' and 'Length of week' to '5'.


Date format

Choose how you want your dates to be displayed from the drop-down menu.


Time format

Choose how you want your times to be displayed from the drop-down menu.


Max. Rep Entries

It's possible for someone booking a room to repeat that booking (e.g. every day or every week). In this box you can set a limit on the number of repeats that someone booking a room could type in. The default is 365, which restricts a person to booking a room daily for the next year, or weekly for the next seven years (!) etc.


Maximum advance booking

If you want to stop users from booking rooms too many days in advance, then you can set a limit here. For example, typing in '7' would stop users from booking a room more than seven days in advance - the booking date would only become available seven days before.

To turn this feature off and allow users to book as far ahead of time as they like, type '-1' in the box.


Report span (days)

Default report span in days - This is the length of time in days that a report generated by MRBS covers. The default is '60' (approx. two months).


Search results per page

If you're searching for a booking, this limits the number of results displayed per page.


Show area list

In MRBS, an 'Area' is a category of room (NB not a Moodle category).

For example, if you ran a Science department comprising rooms used exclusively for Physics, Chemistry or Biology, then you could predefine three 'Areas': Physics, Chemistry and Biology. The Physics rooms (1, 2 and 3) would be named under the Physics Area, The Biology rooms (4, 5 & 6) under the Biology Area etc.

To book a room in MRBS's user interface, a user first selects an Area. In the MRBS user interface, the list of rooms for that area then becomes visible.

'Show area list' sets how you want the area list to display for users: 'List' shows a list. 'Select' will present users with a drop-down menu.


View monthly details

Entries in monthly view can be shown as start/end slot, brief description or both. Set to 'description' for brief description, 'slot' for time slot and 'both' for both. Default is 'both', but 6 entries per day are shown instead of 12.


View week number

To view weeks in the bottom as week numbers (42) instead of 'first day of the week' (13 Oct), set this to TRUE.

Display of weeks in the bottom of the MRBS user interface are handled by the trailer.php file.


Time right side

To display times on right side in day and week view, set to 'Yes'.


Javascript cursor

Change to 'false' if clients have old browsers incompatible with JavaScript.


Show plus link

Change to 'true' always to show the (+) link. The plus link is a small icon displaying a plus sign inside each bookable time cell.


Highlight method

Choose one of the highlight methods: bgcolor, class, or hybrid.

THIS SECTION REQUIRES MORE DETAIL.


Default view

Define default starting view (month, week or day) - MRBS can show any of these three and they can be switched between.


Default room

Define default room to start with (used by index.php). Room numbers can be determined by looking at the 'Edit' or 'Delete' page URL for a room from the admin page.


Entry type A - J

Entry types is a way of defining purposes for room use. In this way, a user can book a room for a named class (e.g. 'Drama') and then indicate what kind of booked session that is going to be. For example:

• Lecture • Lesson • Seminar • Tutorial • Practice • Private meeting • Maintenance

etc.

While this function may seem useful, it may make MRBS seem unnecessarily complicated for users. Each entry type will appear on the MRBS timetable in a different colour (one per Entry type). Colours will define Entry type (Tutorial /Private meeting etc.) and not the subject of the class (e.g. English /Maths etc.)

The Entry type colours can be defined inside MRBS php files on the server.


Mail admin bookings

Send email to admin. notifying of a new booking. - Every time a booking is made, an email will be sent to the MRBS admin's email address as defined in the MRBS Admin email box (towards the top of the page).


Mail area admin

Send email to area admin notifying of a new booking. - This seems to be an as-yet undeveloped part of MRBS, as no boxes are provided to define separate email addresses for administrators associated with particular Areas. - This would be useful for larger institutions.

See 'Mail admin email' above.


Mail room admin

Send email to room admin notifying of a new booking - This seems to be an as-yet undeveloped part of MRBS, as no boxes are provided to define separate email addresses for administrators associated with individual Rooms.

See 'Mail admin email' above.


Mail admin deletes

Sends an email to the admin notifying of room bookings having been deleted.

See 'Mail admin email' above.


Mail admin all

Sends an email to the MYBS administrator whenever any change is made by users to the MRBS system.

See 'Mail admin email' above.


Mail details

Mail details.

THIS SECTION REQUIRES MORE DETAIL.


Mail scheduler

Send an email to the scheduler of a new booking.

THIS SECTION REQUIRES MORE DETAIL.


Mail from

Set the email address of the From field. Default is site admin.

This is the email address from which MRBS notification emails will be sent. It has to be associated with a Moodle user account.


Mail recipients

Set the recipient email. You can define more than one recipient like this 'john@doe.com,scott@tiger.com'. Recipient email(s) must be associated with a Moodle user account.


Mail cc

Set email address of the Carbon Copy field. Default is blank. Similar to mail recipients, you can define more than one recipient. All recipient emails must be associated with a Moodle user account.


Location of session import file

If you wish to use the automatic session import feature, enter the location of the file here. The file must be able to be moved by the webserver user. By entering a location, you will enable special booking types for imported bookings.

A session import file is a comma-separated value (CSV) file which can be uploaded by Moodle's automated scripts (cron) to import a timetable into MRBS. Details for how to do this are here:

https://docs.moodle.org/24/en/MRBS_block/import

Prepared CSV files made to populate the MRBS with (perhaps) an initial set of bookings, can be left in the folder located at the URL pasted into the 'Location of session import file' box. When the appropriate Moodle cron file runs, it will look in this location for a CSV file to implement.