MoodleDocs - User contributions [en]

MySQL

2020-07-29T10:26:06Z

Bostelm: /* Command line */ remove "identified by"

{{Installing Moodle}}
MySQL is one of the supported databases that underpins a Moodle installation.

== Installing MySQL ==

* If you are running Linux your preference should be to install using your distribution's package manager. This ensures you will get any available updates. However, you can also use apt-get or yum depending on the distribution that you are running.
* There are installers available for most popular operating systems at http://www.mysql.com/downloads/mysql/.
* It is possible and reasonably straightforward to build mysql from source but it is not recommended (the pre-built binaries are supposedly better optimised).
* Make sure you set a password for the 'root' user (see http://dev.mysql.com/doc/refman/5.0/en/default-privileges.html).
* Consider installing and configuring my.cnf (the MySQL settings file) to suit your needs. The default configuration is usually very conservative in respect of memory usage versus performance. Increase the 'max_allowed_packet' setting to at least 4 megabytes.
* If you are going to use Master/Slave replication, you must add binlog_format = 'ROW' into your my.cnf within [mysqld]. Otherwise, Moodle will not be able to write to the database.

=== Configure full UTF-8 support ===

It's recommended that you have full UTF-8 support configured in MySQL. If this is not done some character sets, notably emojis, cannot be used. It is possible to do this after your site is installed but it is much easier before installation.

First check if this is already configured by running the following statement, e.g. at the '''mysql>''' prompt or in phpMyAdmin:
<pre>SHOW GLOBAL VARIABLES WHERE variable_name IN ('innodb_file_format', 'innodb_large_prefix', 'innodb_file_per_table');</pre>
{| class="nicetable"
|-
! Variable_name
! Value
|-
| innodb_file_format
| Barracuda
|-
| innodb_file_per_table
| ON
|-
| innodb_large_prefix
| ON
|}

If the three settings you see match the above list then no further configuration changes are needed and you can skip to [[#Creating_Moodle_database| Creating Moodle database]].

If your settings do not match this list then you will have to edit your MySQL configuration file. On Linux this may be the file '''/etc/my.cnf''' or '''/etc/mysql/my.cnf''', on Microsoft Windows it may be '''my.ini'''.

* Note: You should back up your configuration file before changing it.
* Note: You should back up your databases before making this change.
* Note: Other systems using databases on this server may be impacted by this change.

Add the following settings to the configuration file:
<pre>[client]
default-character-set = utf8mb4

[mysqld]
innodb_file_format = Barracuda
innodb_file_per_table = 1
innodb_large_prefix = 1

character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
skip-character-set-client-handshake

[mysql]
default-character-set = utf8mb4</pre>

Restart MySQL to apply these settings.

If you have any difficulty applying these settings, see [[MySQL_full_unicode_support]] for further information.

If for some reason you cannot change to the recommended settings as described here you can continue to install Moodle, however you must select '''utf8''' and '''utf8_unicode_ci''' for the default character set and collation respectively.

== Creating Moodle database ==

These are the steps to create an empty Moodle database. Substitute your own database name, user name and password as appropriate.

The instructions assume that the web server and MySQL server are on the same machine. In this case the 'dbhost' is 'localhost'. If they are on different machines substitute the name of the web server for 'localhost' in the following instructions and the 'dbhost' setting will be the name of the database server.
Databases have a "Character set" and a "Collation". For Moodle, we recommend the Character Set be set to '''utf8mb4''' and the Collation '''utf8mb4_unicode_ci'''. You may get the option to set these values when you create the database. If you are not given a choice, the default options are probably good. An install on an old server may have the wrong settings.

=== Command line ===

* To create a database using the 'mysql' command line client, first log into MySQL
<pre>
$ mysql -u root -p
Enter password:
</pre>
(Enter the password you previously set - or been given - for the MySQL 'root' user). After some pre-amble this should take you to the ''mysql>'' prompt.
* Create a new database (called 'moodle' - substitute your own name if required).
If you have successfully configured the recommended full UTF-8 support as described above run:
<pre>
mysql> CREATE DATABASE moodle DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
</pre>
If you do not have the recommended full UTF-8 support run:
<pre>mysql> CREATE DATABASE moodle DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci;</pre>
* Add a user/password with the minimum needed permissions:
<pre>
mysql> CREATE USER moodleuser@localhost IDENTIFIED BY 'yourpassword';
mysql> GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,CREATE TEMPORARY TABLES,DROP,INDEX,ALTER ON moodle.* TO moodleuser@localhost;
mysql> FLUSH PRIVILEGES;
</pre>
...which creates a user called 'moodleuser' with a password 'yourpassword'. Make sure you invent a strong password and resist the temptation to 'GRANT ALL'.
* Exit from mysql:
<pre>
mysql> quit
</pre>

=== phpMyAdmin ===

[http://www.phpmyadmin.net/ phpMyAdmin] is a web based administration tool for MySQL. If this is available you can use it to create a new database. If you have successfully configured the recommended full UTF-8 support as described above select collation '''utf8mb4_unicode_ci'''. If you do not have the recommended full UTF-8 support select collation '''utf8_unicode_ci'''.

==Which database belongs to which Moodle==
If you have installed several Moodle installations on the same server, there will be several databases in your MySQL server. The names might be quite poor reflections of the content like _mdl1 _mdl2 _mdl3 . So how do I see which database goes with which Moodle installation? You can go in with phpMyAdmin and in the various databases check for the table "mdl_course". There you will easily see the name of that Moodle Installation. In table mdl_config you can see the Moodle version. The main URL for the site is not in the database except where there are absolute links.

== See also ==

* [[MariaDB]]
* [[MySQL full unicode support]]
* [http://www.mysql.com/ The MySQL homepage]
* [http://en.wikipedia.org/wiki/MySQL Wikipedia article about ''MySQL'']
* [http://forums.mysql.com/read.php?24,92131,92131 List of articles on MySQL performance tuning]

[[Category:SQL databases]]

[[ja:MySQL]]
[[de:MySQL]]
[[es:MySQL]]

MySQL

2020-07-29T10:25:22Z

Bostelm: /* Command line */ User first needs to be created, then rights granted, at least in recent versions of mysql

{{Installing Moodle}}
MySQL is one of the supported databases that underpins a Moodle installation.

== Installing MySQL ==

* If you are running Linux your preference should be to install using your distribution's package manager. This ensures you will get any available updates. However, you can also use apt-get or yum depending on the distribution that you are running.
* There are installers available for most popular operating systems at http://www.mysql.com/downloads/mysql/.
* It is possible and reasonably straightforward to build mysql from source but it is not recommended (the pre-built binaries are supposedly better optimised).
* Make sure you set a password for the 'root' user (see http://dev.mysql.com/doc/refman/5.0/en/default-privileges.html).
* Consider installing and configuring my.cnf (the MySQL settings file) to suit your needs. The default configuration is usually very conservative in respect of memory usage versus performance. Increase the 'max_allowed_packet' setting to at least 4 megabytes.
* If you are going to use Master/Slave replication, you must add binlog_format = 'ROW' into your my.cnf within [mysqld]. Otherwise, Moodle will not be able to write to the database.

=== Configure full UTF-8 support ===

It's recommended that you have full UTF-8 support configured in MySQL. If this is not done some character sets, notably emojis, cannot be used. It is possible to do this after your site is installed but it is much easier before installation.

First check if this is already configured by running the following statement, e.g. at the '''mysql>''' prompt or in phpMyAdmin:
<pre>SHOW GLOBAL VARIABLES WHERE variable_name IN ('innodb_file_format', 'innodb_large_prefix', 'innodb_file_per_table');</pre>
{| class="nicetable"
|-
! Variable_name
! Value
|-
| innodb_file_format
| Barracuda
|-
| innodb_file_per_table
| ON
|-
| innodb_large_prefix
| ON
|}

If the three settings you see match the above list then no further configuration changes are needed and you can skip to [[#Creating_Moodle_database| Creating Moodle database]].

If your settings do not match this list then you will have to edit your MySQL configuration file. On Linux this may be the file '''/etc/my.cnf''' or '''/etc/mysql/my.cnf''', on Microsoft Windows it may be '''my.ini'''.

* Note: You should back up your configuration file before changing it.
* Note: You should back up your databases before making this change.
* Note: Other systems using databases on this server may be impacted by this change.

Add the following settings to the configuration file:
<pre>[client]
default-character-set = utf8mb4

[mysqld]
innodb_file_format = Barracuda
innodb_file_per_table = 1
innodb_large_prefix = 1

character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
skip-character-set-client-handshake

[mysql]
default-character-set = utf8mb4</pre>

Restart MySQL to apply these settings.

If you have any difficulty applying these settings, see [[MySQL_full_unicode_support]] for further information.

If for some reason you cannot change to the recommended settings as described here you can continue to install Moodle, however you must select '''utf8''' and '''utf8_unicode_ci''' for the default character set and collation respectively.

== Creating Moodle database ==

These are the steps to create an empty Moodle database. Substitute your own database name, user name and password as appropriate.

The instructions assume that the web server and MySQL server are on the same machine. In this case the 'dbhost' is 'localhost'. If they are on different machines substitute the name of the web server for 'localhost' in the following instructions and the 'dbhost' setting will be the name of the database server.
Databases have a "Character set" and a "Collation". For Moodle, we recommend the Character Set be set to '''utf8mb4''' and the Collation '''utf8mb4_unicode_ci'''. You may get the option to set these values when you create the database. If you are not given a choice, the default options are probably good. An install on an old server may have the wrong settings.

=== Command line ===

* To create a database using the 'mysql' command line client, first log into MySQL
<pre>
$ mysql -u root -p
Enter password:
</pre>
(Enter the password you previously set - or been given - for the MySQL 'root' user). After some pre-amble this should take you to the ''mysql>'' prompt.
* Create a new database (called 'moodle' - substitute your own name if required).
If you have successfully configured the recommended full UTF-8 support as described above run:
<pre>
mysql> CREATE DATABASE moodle DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
</pre>
If you do not have the recommended full UTF-8 support run:
<pre>mysql> CREATE DATABASE moodle DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci;</pre>
* Add a user/password with the minimum needed permissions:
<pre>
mysql> CREATE USER moodleuser@localhost IDENTIFIED BY 'yourpassword';
mysql> GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,CREATE TEMPORARY TABLES,DROP,INDEX,ALTER ON moodle.* TO moodleuser@localhost IDENTIFIED BY 'yourpassword';
mysql> FLUSH PRIVILEGES;
</pre>
...which creates a user called 'moodleuser' with a password 'yourpassword'. Make sure you invent a strong password and resist the temptation to 'GRANT ALL'.
* Exit from mysql:
<pre>
mysql> quit
</pre>

=== phpMyAdmin ===

[http://www.phpmyadmin.net/ phpMyAdmin] is a web based administration tool for MySQL. If this is available you can use it to create a new database. If you have successfully configured the recommended full UTF-8 support as described above select collation '''utf8mb4_unicode_ci'''. If you do not have the recommended full UTF-8 support select collation '''utf8_unicode_ci'''.

==Which database belongs to which Moodle==
If you have installed several Moodle installations on the same server, there will be several databases in your MySQL server. The names might be quite poor reflections of the content like _mdl1 _mdl2 _mdl3 . So how do I see which database goes with which Moodle installation? You can go in with phpMyAdmin and in the various databases check for the table "mdl_course". There you will easily see the name of that Moodle Installation. In table mdl_config you can see the Moodle version. The main URL for the site is not in the database except where there are absolute links.

== See also ==

* [[MariaDB]]
* [[MySQL full unicode support]]
* [http://www.mysql.com/ The MySQL homepage]
* [http://en.wikipedia.org/wiki/MySQL Wikipedia article about ''MySQL'']
* [http://forums.mysql.com/read.php?24,92131,92131 List of articles on MySQL performance tuning]

[[Category:SQL databases]]

[[ja:MySQL]]
[[de:MySQL]]
[[es:MySQL]]

Capabilities/mod/scheduler:editallnotes

2019-12-03T14:19:53Z

Bostelm: create redirect

#REDIRECT [[Scheduler Module capabilities#mod/scheduler:editallnotes]]

Capabilities/mod/scheduler:editallattended

2019-12-03T14:19:30Z

Bostelm: create redirect

#REDIRECT [[Scheduler Module capabilities#mod/scheduler:editallattended]]

Capabilities/mod/scheduler:editallgrades

2019-12-03T14:19:03Z

Bostelm: create redirect

#REDIRECT [[Scheduler Module capabilities#mod/scheduler:editallgrades]]

Scheduler Module capabilities

2019-12-03T14:12:32Z

Bostelm: /* Teacher side */ new capabilities in 3.7

[[Scheduler module|Back to index]]

The behavior of [[Scheduler module|Scheduler]] can be customized by setting various [[Permissions|capabilities]] at the activity level.

== Student side ==

=== mod/scheduler:viewslots ===
View appointments that are available for booking. This allows a user to view the student screen of Scheduler and to view any appointments that would be available for booking (i.e., which have free capacity available and fall within relevant time limits). The capability does ''not'' allow students to actually book a slot; for this, see [[#mod/scheduler:appoint]] below.

=== mod/scheduler:viewfullslots ===
Allows students to see slots in the future even if they are already fully booked. This is not enabled by default or the student role, and needs to be set ''in addition'' to [[#mod/scheduler:viewslots]].

===mod/scheduler:appoint===

Book an appointment which has been offered by a teacher, using the student screen. This is useful only for users that have the [[#mod/scheduler:viewslots]] capability.

===mod/scheduler:seeotherstudentsbooking===

See which other students have booked a slot. This applies both to slots which the current student has booked, and to slots which are displayed to the student for booking.

===mod/scheduler:seeotherstudentsresults===

See other slot student's results (grade), in slots which the current student has booked an appointment.

== Teacher side ==

===mod/scheduler:manage===

Create and manage your own slots and appointments. This capability allows a user to see the teacher screen, to create slots for themself (and offer them to students), and to edit these slots afterwards.

===mod/scheduler:attend===

Users with this permission are able to be the "Teacher" for an appointment slot and meet with students.

===mod/scheduler:manageallappointments===

Manage all scheduler data, in particular slots for other teachers.

===mod/scheduler:canscheduletootherteachers===

Schedule appointments for other staff members. This is valuable when a third-party staff member (e.g., an administrator) has to set up appointments for other teachers.

===mod/scheduler:canseeotherteachersbooking===

Browse other teachers' appointments. See also [[#mod/scheduler:seeoverviewoutsideactivity]] below.

=== mod/scheduler:seeoverviewoutsideactivity ===

Use the [[Scheduler Overview screen|overview screen]] in order to see data from other staff members. In the overview screen, users can access data not only from the current scheduler, but from all schedulers they (or others) have offered slots in. Access control used in that screen does not always perfectly match Moodle's fine-grained permissions system (for example, it would not take into account whether teachers are enrolled in the relevant other courses, or whether activities there are hidden). To accommodate this, teachers are allowed to see data "outside the current activity" only if they have the mod/scheduler:seeoverviewoutsideactivity capability. The default teacher role does have this capability, but if you believe it leads to problems in your installation, you can revoke it.

Given "mod/scheduler:seeoverviewoutsideactivity", teachers always see their own bookings in any scope. However, for seeing ''other'' teachers' bookings they would need the following additional permissions:

* "In this scheduler": [[#mod/scheduler:canseeotherteachersbooking]] at the level of the present scheduler
* "In this course": mod/scheduler:canseeotherteachersbooking at the level of the present course
* "Anywhere": mod/scheduler:canseeotherteachersbooking at site level

In typical setups, this means that a teacher can see all bookings in the current course, whereas a site admin would see all bookings at site level.

===mod/scheduler:editallgrades===

Edit grades in appointments of any teacher, using the appointment screen. (Note that users with the [[#mod/scheduler:manageallappointments]] capability can edit all grades as well.)

===mod/scheduler:editallnotes===

Edit all appointment-related notes in appointments of any teacher, using the appointment screen. (Note that users with the [[#mod/scheduler:manageallappointments]] capability can edit all notes as well.)

===mod/scheduler:editallattended===

Mark or unmark students as attended in appointments of any teacher, using the checkboxes in the "[[Scheduler: All Appointments|All appointments]]" screen or in individual appointment screens. (Note that users with the [[#mod/scheduler:manageallappointments]] capability can mark/unmark students as attended as well.)

==See also==
[[Category:Scheduler]]

[[es:Capacidades del módulo agendador]]

Talk:Global search

2018-08-06T13:32:19Z

Bostelm: solr 7

== Solr 7 ==

Re [[Global search#Setting up Solr]], it seems that the compatibility problems with Solr 7 are now fixed (for Moodle 3.5)? See https://tracker.moodle.org/browse/MDL-60759 . --[[User:Henning Bostelmann|Henning Bostelmann]] ([[User talk:Henning Bostelmann|talk]]) 13:32, 6 August 2018 (UTC)

== (old discussion) ==

Can you please add information what data are searched by Simple Global Search and what the difference between Global Search and Simple Global Search for a user is. Otherwise its confusing.

I've
{| class="wikitable" border="1"
|-
! Standard search options in Moodle
! Simple Search
! Global search (with SolR)
|-
| Several search options in special contexts:
* Courses (Title and description)
* Users (Messenger)
*Interests
*Tags (blogs, content)
*Forum (posts)
*Glossaries, Content
| Simple search allows searching for content that is stored in the database. The search results are notlimitied to one context. Its posisble to allow for search only in courses a user is enrolled to or in all courses the user can enrole himself
| Global Search with SolR will also find search results from files that are used in the courses. The SolR indexing service reads the database and the file content.
|}

Scheduler module

2017-05-13T23:32:44Z

Bostelm: a bit of cleanup

{{Infobox plugin
|type = Activity module
|entry = https://moodle.org/plugins/view.php?plugin=mod_scheduler
|tracker = [https://tracker.moodle.org/issues/?jql=project%20%3D%20CONTRIB%20AND%20component%20%3D%20%22Module%3A%20Scheduler%22 Moodle Tracker]
|discussion = https://moodle.org/mod/forum/view.php?id=7139
|maintainer = [[User:Henning Bostelmann|Henning Bostelmann]]
|float = right
}}

The '''Scheduler module''' helps you to schedule one-on-one appointments with all your students. You specify the periods during which you are available to see the students and the length of each appointment. The students then book themselves into one of the available timeslots. The module also lets you record the attendance and grade the appointment.

==Quick start for the Moodle Scheduler==
This section shows you how to quickly make your ''first'' Moodle scheduler, so only the basics are described. Like any other first attempt, your first Moodle scheduler will probably be more for learning than using, but after you finished it, you'll be able to choose which features you want to learn more about.

===Prerequisites===
*You must have teacher access to a Moodle course.
*Teachers and students must be enrolled in the course.
*The Moodle scheduler must be installed, since it is not part of the core Moodle package.

===Creating a basic scheduler===

#Click the "Turn editing on" button.
#Click the link "Add an activity or resource."
#In the box that appears, choose "Scheduler" and click the "Add" button. [[File:Scheduler01.png]]
#A web page will appear called "Adding a new Scheduler." Type in the name of the scheduler, which can be changed later.
#Scroll to the bottom of the webpage and click the "Save and display" button.
#A webpage will appear with the name of your scheduler at the top. Click the "Add slots" link. [[File:Scheduler_slots01.png]]
#A drop-down menu will appear that allows you to add repeated slots or a single slot. Click the link to add repeated slots.
#Options will appear to add time slots. For this lesson, the slots you add can be real or fictitious, for practice. All time slots must occur in the future, and the start time must be before the end time. The simplest option is to:
##Click the "Start time" menu and choose a time that is one hour from now.
##Click the "End time" menu and choose a time that is one hour after the start time.
#Scroll to the bottom of the webpage and click "Save changes."

After these steps, a basic scheduler will appear. To learn more, view the scheduler as a student or explore the options below.

==Overview of Scheduler screens==

* Teacher screens
** [[Scheduler: My Appointments|My appointments]]
** [[Scheduler: All Appointments|All Appointments]]
** [[Scheduler: Adding slots|Adding a slot or a series of slots]]
** Scheduling a student or a group of students
** Adding a student to the slot when scheduling
** Overview
** Statistics
** [[Scheduler: Exporting schedule tables|Exports]]
** View student
*** [[Scheduler: Setting feedback|View of comments]]
*** [[Scheduler: Grading|View of appointments and grades]]

* Student screens
** [[Scheduler : Appointing|Viewing and booking slots]]

==Features==

===Settings===
Please see: [[Scheduler Module settings and parameters|Scheduler Module settings]]

===Scheduling modes===

The Scheduler module allows two behaviours relative to appointing, depending on configuration settings. When set to "one only", a student can propose a unique appointment. When set to "one at a time", the student may propose one appointment, and will have to wait to be seen, before being able to make a subsequent appointment.

===Slots exclusivity===

A slot may accept an unlimited number of students (say, when scheduling for open meetings), or only one (face-to-face meeting), or may be set to accept a predefined number of students.

=== Messages and notifications===

An optional notification service sends [[Messaging|messages]] to teachers and students on certain changes:
* To teachers, when a student books or cancels an appointment,
* To students, when a teacher declines an appointment. (Note, no message is sent when the teacher ''deletes'' the slot instead.)

This can be enabled or disabled on each Scheduler's settings page.

Scheduler also sends reminders of upcoming appointments to students, if the teacher has selected this on a per-slot basis.

Further, teachers can use a web form for manually sending invitations or reminders to students who did not yet make an appointment.

===Behaviour with groups===

Scheduler has two different group-related features, both of which can be enabled independently on a per-scheduler basis:
* Restriction to groups: Students can schedule appointments only with teachers in their group,
* Booking in groups: Students can schedule an appointment for the entire group at once.

'''Restriction to groups''' is controlled by Moodle's usual [[Groups#Group_modes|Group mode]] feature (in "Common settings"). Setting "Group mode" to "Visible groups" or "Separate groups" will mean that students can see, and book, only slots which are offered by a teacher with whom they are in a common group. Additionally, in "Separate groups" mode, teachers won't be able to see slots outside their group unless they have [[Capabilities/moodle/site:accessallgroups|permission to access all groups]].

'''Booking in groups''' means that each students of the group can make an appointment for the entire group, i.e., when they click the "Book slot" button, they have the option to assign the entire group to that slot. In order for a student to schedule a group, they will have to belong to at least one group in the course. In the special case where the student belongs to several groups and they wishes to make an appointment within a group, they will not be able to make the appointment until the student has been seen (one-at-a-time setting) or at all (only-one-time setting). With "Booking in groups" enabled, teachers will also be able to assign an entire group to a slot at once.

Note that irrespective of the group features, slots are always remain assigned to one teacher and zero or more individual students, and are not as such tied to a group.

=== Scheduling conflicts ===

Scheduler will, in some situations, warn the user if they are creating [[Scheduler: Conflicts|scheduling conflicts]], i.e., two appointments for the same person at the same time.

=== Booking forms and student-supplied data ===
Optionally, students can be presented with a [[Scheduler: Booking form|booking form]] in which they can enter a message for the teacher or upload files. They can also be required to solve a CAPTCHA to prevent automated bookings.

== Moodle standard interfaces ==

=== Capabilities===
For an overview of the permission system in Scheduler, see [[Scheduler Module capabilities]].

===Backup/Restore===
The module performs complete backup/restore within the course context. Both slots and appointments are considered as "user related data". Therefore, backup/restore without user data (for example, when clicking the "duplicate" button) will copy only the configuration settings, but not slots or appointments.

==Links==
* [https://moodle.org/mod/forum/view.php?id=7139 Scheduler module forum]
* [https://moodle.org/plugins/view.php?plugin=mod_scheduler Plug-in database entry for Scheduler module]

[[Category:Scheduler]]

[[es:Módulo agendador]]
[[fr:Rendez-Vous]]

Scheduler: Booking form

2017-05-13T19:04:09Z

Bostelm: /* Configuring the booking screen */ guard time link

{{New features}}

When students book a slot in a [[Scheduler module|Scheduler]], they can optionally be presented with a separate booking screen before the actual booking is made. This screen my be just to display information to the student; or it may require the student to enter some text, to upload files, or to solve a CAPTCHA security question.

== Configuring the booking screen ==

[[Image:scheduler-booking-settings.png|thumb|right|Scheduler booking form settings]]

To set up the booking screen, go to the Settings page of the scheduler concerned, and expand the section "Booking form and student-supplied data". Here you can activate the booking screen (first entry field) and, if enabled, configure its contents:

* You can enter a text message which will be shown to students at booking time. Here you should include instructions on what students should enter in the data fields described below.
* You can add a (optional or mandatory) text box where students can enter a message for the teacher.
* You can ask students to upload files (again optional or mandatory).
* A security question (CAPTCHA) can be displayed on new bookings. See below for details.

[[Image:scheduler-bookingform.png|thumb|right|Booking form as seen by student]]

Students will need to fill out the booking screen before they make a new booking. They can later return to edit their data, up until the [[Scheduler_Module_settings_and_parameters#Guard_Time|Guard Time]] if enabled.

== Using a CAPTCHA ==

On the settings page, you can activate a CAPTCHA security question which will be shown to students when they make a new booking. (Existing bookings are now affected.) This can be useful if you suspect that students use automated programs (bots) to snap up appointments as they become available.

Scheduler uses the same captcha system as the [[Email-based self registration]] feature, that is, based on Google's reCAPTCHA system. Before using captchas in Scheduler, you need to register an account with Google and [[Managing_authentication#ReCAPTCHA|set this up in the global configuration settings]]. Only after that, the captcha option will be visible in your Scheduler settings screen.

== Accessing data supplied by students ==

If a student has entered data in the booking screen, a little "paperclip" symbol will be displayed next to their name. Clicking on the student's name will take you to the appointment screen, where the data supplied by the student is displayed.

[[Category:Scheduler]]

Scheduler: Exporting schedule tables

2017-05-13T19:01:03Z

Bostelm: /* Data to include */ profile fields

[[Scheduler module|Return to Schedule module page]]

[[Image:exports_EN.jpg|right|Scheduler export screen]]

In a [[Scheduler module|scheduler]], teachers can export appointment data to spreadsheets and other files in several formats. This feature can also be used to print lists of appointments or sign-up sheets.

== Options for exports ==

Layout and format of the export files can be customized using various options. If you're unsure what the effect of these are, try the "Preview" button at the bottom of the form.

=== Format ===

There are three basic choices for the export format, differing in how slots with several appointments are handled.

;One line per slot
The output file will contain one line for each slot. If a slot contains multiple appointments, then instead of the student's name, etc., a marker "(multiple)" will be shown.

;One line per appointment
The output file will contain one line for each appointment. If a slot contains multiple appointments, then it will appear several times in the list (with its data repeated).

;Appointments grouped by slot
All appointments of one slot are grouped together, preceded by a header line that indicates the slot in question. This may not work well with the CSV output file format, as the number of columns is not constant.

=== Teacher selection ===

; Include slots for...
Select whether slots for all teachers or only for the current teacher should be included.

; Pagination
The output can optionally be formatted with a separate "page" for each teacher. In Excel and in ODS file format, these "pages" correspond to tabs (worksheets) in the workbook. In PDF format, they correspond to pages in the PDF document. HTML and CSV files do not support actual pagination, but will display a heading before each teacher's slots.

=== Include empty slots ===

Select whether empty slots (which no student has booked yet) should be included.

=== Data to include ===

Teachers can select which data fields should be included in each row of the export, including slots-related data (date, time, location, ...), student-related data (name, username, ...) and appointment-related data (whether attended, and any appointment notes). Note that formatting will be stripped from appointment notes on export.

Custom [[User profile fields]] for students can be included in the export, but the data will appear only if the current user has the necessary permissions to view them for the students affected.

=== File format ===
Scheduler supports the following output file formats:

* Comma Separated Value (CSV) text files. The field separator, by default a comma, can be customized. CSV files can be opened in most spreadshet applications.
* Microsoft Excel files (Excel 2007 .xslx format)
* Open Document spreadsheets (ODS), suitable for OpenOffice / LibreOffice
* HTML format. The output will be displayed as a web page containing a table. This page can then be saved, or printed using the browser's print feature.
* PDF documents. A choice between landscape and portrait formats is available.

[[Category:Scheduler]]

[[es:Agendador: Exportar tablas de agenda]]

Scheduler: Exporting schedule tables

2017-05-13T19:00:06Z

Bostelm: /* Data to include */ profile fields

[[Scheduler module|Return to Schedule module page]]

[[Image:exports_EN.jpg|right|Scheduler export screen]]

In a [[Scheduler module|scheduler]], teachers can export appointment data to spreadsheets and other files in several formats. This feature can also be used to print lists of appointments or sign-up sheets.

== Options for exports ==

Layout and format of the export files can be customized using various options. If you're unsure what the effect of these are, try the "Preview" button at the bottom of the form.

=== Format ===

There are three basic choices for the export format, differing in how slots with several appointments are handled.

;One line per slot
The output file will contain one line for each slot. If a slot contains multiple appointments, then instead of the student's name, etc., a marker "(multiple)" will be shown.

;One line per appointment
The output file will contain one line for each appointment. If a slot contains multiple appointments, then it will appear several times in the list (with its data repeated).

;Appointments grouped by slot
All appointments of one slot are grouped together, preceded by a header line that indicates the slot in question. This may not work well with the CSV output file format, as the number of columns is not constant.

=== Teacher selection ===

; Include slots for...
Select whether slots for all teachers or only for the current teacher should be included.

; Pagination
The output can optionally be formatted with a separate "page" for each teacher. In Excel and in ODS file format, these "pages" correspond to tabs (worksheets) in the workbook. In PDF format, they correspond to pages in the PDF document. HTML and CSV files do not support actual pagination, but will display a heading before each teacher's slots.

=== Include empty slots ===

Select whether empty slots (which no student has booked yet) should be included.

=== Data to include ===

Teachers can select which data fields should be included in each row of the export, including slots-related data (date, time, location, ...), student-related data (name, username, ...) and appointment-related data (whether attended, and any appointment notes). Note that formatting will be stripped from appointment notes on export.

Custom [[user profile fields]] for students can be included in the export, but the data will appear only if the current user has the necessary permissions to view them for the students affected.

=== File format ===
Scheduler supports the following output file formats:

* Comma Separated Value (CSV) text files. The field separator, by default a comma, can be customized. CSV files can be opened in most spreadshet applications.
* Microsoft Excel files (Excel 2007 .xslx format)
* Open Document spreadsheets (ODS), suitable for OpenOffice / LibreOffice
* HTML format. The output will be displayed as a web page containing a table. This page can then be saved, or printed using the browser's print feature.
* PDF documents. A choice between landscape and portrait formats is available.

[[Category:Scheduler]]

[[es:Agendador: Exportar tablas de agenda]]

Scheduler module

2017-05-13T18:56:13Z

Bostelm: new feature: booking form

{{Infobox plugin
|type = Activity module
|entry = https://moodle.org/plugins/view.php?plugin=mod_scheduler
|tracker = [https://tracker.moodle.org/issues/?jql=project%20%3D%20CONTRIB%20AND%20component%20%3D%20%22Module%3A%20Scheduler%22 Moodle Tracker]
|discussion = https://moodle.org/mod/forum/view.php?id=7139
|maintainer = [[User:Henning Bostelmann|Henning Bostelmann]]
|float = right
}}

The '''Scheduler module''' helps you to schedule one-on-one appointments with all your students. You specify the periods during which you are available to see the students and the length of each appointment. The students then book themselves into one of the available timeslots. The module also lets you record the attendance and grade the appointment.

=Quick Start for the Moodle Scheduler=
This lesson shows you how to quickly make your ''first'' Moodle scheduler, so only the basics are described. Like any other first attempt, your first Moodle scheduler will probably be more for learning than using, but after you finished it, youll be able to choose which features you want to learn more about.

==Prerequisites==
*You must have teacher access to a Moodle course.
*Teachers and students must be enrolled in the course.
*The Moodle scheduler must be installed, since it is not part of the core Moodle package.

==Creating A Basic Scheduler==

#Click the "Turn editing on" button.
#Click the link "Add an activity or resource."
#In the box that appears, choose "Scheduler" and click the "Add" button. [[File:Scheduler01.png]]
#A web page will appear called "Adding a new Scheduler." Type in the name of the scheduler, which can be changed later.
#Scroll to the bottom of the webpage and click the "Save and display" button.
#A webpage will appear with the name of your scheduler at the top. Click the "Add slots" link. [[File:Scheduler_slots01.png]]
#A drop-down menu will appear that allows you to add repeated slots or a single slot. Click the link to add repeated slots.
#Options will appear to add time slots. For this lesson, the slots you add can be real or fictitious, for practice. All time slots must occur in the future, and the start time must be before the end time. The simplest option is to:
##Click the "Start time" menu and choose a time that is one hour from now.
##Click the "End time" menu and choose a time that is one hour after the start time.
#Scroll to the bottom of the webpage and click "Save changes."
  
After these steps, a basic scheduler will appear. To learn more, view the scheduler as a student or explore the options below.


=Scheduler Options=

==Screens==

* Teacher screens
** [[Scheduler: My Appointments|My appointments]]
** [[Scheduler: All Appointments|All Appointments]]
** [[Scheduler: Adding slots|Adding a slot or a series of slots]]
** Scheduling a student or a group of students
** Adding a student to the slot when scheduling
** Overview
** Statistics
** [[Scheduler: Exporting schedule tables|Exports]]
** View student
*** [[Scheduler: Setting feedback|View of comments]]
*** [[Scheduler: Grading|View of appointments and grades]]

* Student screens
** [[Scheduler : Appointing|Viewing and booking slots]]

==Features and Defines==

===Scheduling Modes===

The Scheduler module allows two behaviours relative to appointing, depending on configuration settings. When set to "one only", a student can propose a unique appointment. When set to "one at a time", the student may propose one appointment, and will have to wait to be seen, before being able to make a subsequent appointment.

===Slots exclusivity===

A slot may accept an unlimited number of students (say, when scheduling for open meetings), or only one (face-to-face meeting), or may be set to accept a predefined number of students.

==Moodle Module standard implementations==

===Settings===

* [[Scheduler Module settings and parameters|Scheduler Module settings]]

===Capabilities===

* [[Scheduler Module capabilities]]

===Backup/Restore===

The module performs complete backup/restore within the course context. Slots are considered as module scope information, while appointments are considered as user related data.

==Additional features==

=== Messages and notifications===

An optional notification service sends [[Messaging|messages]] to teachers and students on certain changes:
* To teachers, when a student books or cancels an appointment,
* To students, when a teacher declines an appointment. (Note, no message is sent when the teacher ''deletes'' the slot instead.)

This can be enabled or disabled on each Scheduler's settings page.

Scheduler also sends reminders of upcoming appointments to students, if the teacher has selected this on a per-slot basis.

Further, teachers can use a web form for manually sending invitations or reminders to students who did not yet make an appointment.

===Behaviour with groups===

Scheduler has two different group-related features, both of which can be enabled independently on a per-scheduler basis:
* Restriction to groups: Students can schedule appointments only with teachers in their group,
* Booking in groups: Students can schedule an appointment for the entire group at once.

'''Restriction to groups''' is controlled by Moodle's usual [[Groups#Group_modes|Group mode]] feature (in "Common settings"). Setting "Group mode" to "Visible groups" or "Separate groups" will mean that students can see, and book, only slots which are offered by a teacher with whom they are in a common group. Additionally, in "Separate groups" mode, teachers won't be able to see slots outside their group unless they have [[Capabilities/moodle/site:accessallgroups|permission to access all groups]].

'''Booking in groups''' means that each students of the group can make an appointment for the entire group, i.e., when they click the "Book slot" button, they have the option to assign the entire group to that slot. In order for a student to schedule a group, they will have to belong to at least one group in the course. In the special case where the student belongs to several groups and they wishes to make an appointment within a group, they will not be able to make the appointment until the student has been seen (one-at-a-time setting) or at all (only-one-time setting). With "Booking in groups" enabled, teachers will also be able to assign an entire group to a slot at once.

Note that irrespective of the group features, slots are always remain assigned to one teacher and zero or more individual students, and are not as such tied to a group.

=== Scheduling conflicts ===

Scheduler will, in some situations, warn the user if they are creating [[Scheduler: Conflicts|scheduling conflicts]], i.e., two appointments for the same person at the same time.

=== Booking forms and student-supplied data ===

Optionally, students can be presented with a [[Scheduler: Booking form|booking form]] in which they can enter a message for the teacher or upload files. They can also be required to solve a CAPTCHA to prevent automated bookings.

==Links==
* [https://moodle.org/mod/forum/view.php?id=7139 Scheduler module forum]
* [https://moodle.org/plugins/view.php?plugin=mod_scheduler Plug-in database entry for Scheduler module]

[[Category:Scheduler]]

[[es:Módulo agendador]]
[[fr:Rendez-Vous]]

Scheduler: Booking form

2017-05-13T18:54:07Z

Bostelm: adding screenshots

{{New features}}

When students book a slot in a [[Scheduler module|Scheduler]], they can optionally be presented with a separate booking screen before the actual booking is made. This screen my be just to display information to the student; or it may require the student to enter some text, to upload files, or to solve a CAPTCHA security question.

== Configuring the booking screen ==

[[Image:scheduler-booking-settings.png|thumb|right|Scheduler booking form settings]]

To set up the booking screen, go to the Settings page of the scheduler concerned, and expand the section "Booking form and student-supplied data". Here you can activate the booking screen (first entry field) and, if enabled, configure its contents:

* You can enter a text message which will be shown to students at booking time. Here you should include instructions on what students should enter in the data fields described below.
* You can add a (optional or mandatory) text box where students can enter a message for the teacher.
* You can ask students to upload files (again optional or mandatory).
* A security question (CAPTCHA) can be displayed on new bookings. See below for details.

[[Image:scheduler-bookingform.png|thumb|right|Booking form as seen by student]]

Students will need to fill out the booking screen before they make a new booking. They can later return to edit their data, up until the Guard Time if enabled.

== Using a CAPTCHA ==

On the settings page, you can activate a CAPTCHA security question which will be shown to students when they make a new booking. (Existing bookings are now affected.) This can be useful if you suspect that students use automated programs (bots) to snap up appointments as they become available.

Scheduler uses the same captcha system as the [[Email-based self registration]] feature, that is, based on Google's reCAPTCHA system. Before using captchas in Scheduler, you need to register an account with Google and [[Managing_authentication#ReCAPTCHA|set this up in the global configuration settings]]. Only after that, the captcha option will be visible in your Scheduler settings screen.

== Accessing data supplied by students ==

If a student has entered data in the booking screen, a little "paperclip" symbol will be displayed next to their name. Clicking on the student's name will take you to the appointment screen, where the data supplied by the student is displayed.

[[Category:Scheduler]]

File:scheduler-bookingform.png

2017-05-13T18:49:11Z

Bostelm: Booking form as viewed by a student. This includes a text box for message, a file upload area, and a CAPTCHA to be solved.

Booking form as viewed by a student. This includes a text box for message, a file upload area, and a CAPTCHA to be solved.

File:scheduler-booking-settings.png

2017-05-13T18:45:54Z

Bostelm: Options related to the booking form and student-provided data in the Scheduler settings screen. (Scheduler 3.3)

Options related to the booking form and student-provided data in the Scheduler settings screen. (Scheduler 3.3)

Scheduler: Booking form

2017-05-13T15:38:26Z

Bostelm: filling in content

{{New features}}

When students book a slot in a [[Scheduler module|Scheduler]], they can optionally be presented with a separate booking screen before the actual booking is made. This screen my be just to display information to the student; or it may require the student to enter some text, to upload files, or to solve a CAPTCHA security question.

== Configuring the booking screen ==

To set up the booking screen, go to the Settings page of the scheduler concerned, and expand the section "Booking form and student-supplied data". Here you can activate the booking screen (first entry field) and, if enabled, configure its contents:

* You can enter a text message which will be shown to students at booking time. Here you should include instructions on what students should enter in the data fields described below.
* You can add a (optional or mandatory) text box where students can enter a message for the teacher.
* You can ask students to upload files (again optional or mandatory).
* A security question (CAPTCHA) can be displayed on new bookings. See below for details.

Students will need to fill out the booking screen before they make a new booking. They can later return to edit their data, up until the Guard Time if enabled.

== Using a CAPTCHA ==

On the settings page, you can activate a CAPTCHA security question which will be shown to students when they make a new booking. (Existing bookings are now affected.) This can be useful if you suspect that students use automated programs (bots) to snap up appointments as they become available.

Scheduler uses the same captcha system as the [[Email-based self registration]] feature, that is, based on Google's reCAPTCHA system. Before using captchas in Scheduler, you need to register an account with Google and [[Managing_authentication#ReCAPTCHA|set this up in the global configuration settings]]. Only after that, the captcha option will be visible in your Scheduler settings screen.

== Accessing data supplied by students ==

If a student has entered data in the booking screen, a little "paperclip" symbol will be displayed next to their name. Clicking on the student's name will take you to the appointment screen, where the data supplied by the student is displayed.

[[Category:Scheduler]]

Scheduler: Booking form

2017-05-13T14:48:15Z

Bostelm: half-empty draft

When students book a slot in a [[Scheduler module|Scheduler]], they can optionally be presented with a separate booking screen before the actual booking is made. This screen my be just to display information to the student; or it may require the student to enter some text, to upload files, or to solve a CAPTCHA security question.

== Configuring the booking screen ==

== Accessing data supplied by students ==

== Using a CAPTCHA ==

[[Category:Scheduler]]

mod/scheduler/bookingform

2017-05-13T14:45:19Z

Bostelm: New help redirect fro release 3.3

#REDIRECT [[Scheduler: Booking form]]

Scheduler Module capabilities

2017-05-09T10:49:20Z

Bostelm: /* mod/scheduler:viewfullslots */

[[Scheduler module|Back to index]]

The behavior of [[Scheduler module|Scheduler]] can be customized by setting various [[Permissions|capabilities]] at the activity level.

== Student side ==

=== mod/scheduler:viewslots ===

View appointments that are available for booking. This allows a user to view the student screen of Scheduler and to view any appointments that would be available for booking (i.e., which have free capacity available and fall within relevant time limits). The capability does ''not'' allow students to actually book a slot; for this, see [[#mod/scheduler:appoint]] below.

=== mod/scheduler:viewfullslots ===

Allows students to see slots in the future even if they are already fully booked. This is not enabled by default or the student role, and needs to be set ''in addition'' to [[#mod/scheduler:viewslots]].

===mod/scheduler:appoint===

Book an appointment which has been offered by a teacher, using the student screen. This is useful only for users that have the [[#mod/scheduler:viewslots]] capability.

===mod/scheduler:seeotherstudentsbooking===

See which other students have booked a slot. This applies both to slots which the current student has booked, and to slots which are displayed to the student for booking.

===mod/scheduler:seeotherstudentsresults===

See other slot student's results (grade), in slots which the current student has booked an appointment,

== Teacher side ==

===mod/scheduler:manage===

Create and manage your own slots and appointments. This capability allows a user to see the teacher screen, to create slots for himself (and offer them to students), as wel as to edit these slots afterwards.

===mod/scheduler:attend===

Attend students.

===mod/scheduler:manageallappointments===

Manage all scheduler data, in particular slots for other teachers.

===mod/scheduler:canscheduletootherteachers===

Schedule appointments for other staff members. This is valuable when a third-party staff member (e.g., an administrator) has to set up appointments for other teachers.

===mod/scheduler:canseeotherteachersbooking===

Browse other teacher's appointments. See also [[#mod/scheduler:seeoverviewoutsideactivity]] below.

=== mod/scheduler:seeoverviewoutsideactivity ===

Use the [[Scheduler Overview screen|overview screen]] in order to see data from other schedulers. In the overview screen, users can access data not only from the current scheduler, but from all schedulers they (or others) have offered slots in. Access control used in that screen does not always perfectly match Moodle's fine-grained permissions system (for example, it would not take into account whether teachers are enrolled in the relevant other courses, or whether activities there are hidden). To accommodate this, teachers are allowed to see data "outside the current activity" only if they have the mod/scheduler:seeoverviewoutsideactivity capability. The default teacher role does have this capability, but if you believe it leads to problems in your installation, you can revoke it.

Given "mod/scheduler:seeoverviewoutsideactivity", teachers always see their own bookings in any scope. However, for seeing ''other'' teachers' bookings they would need the following additional permissions:

* "In this scheduler": [[#mod/scheduler:canseeotherteachersbooking]] at the level of the present scheduler
* "In this course": mod/scheduler:canseeotherteachersbooking at the level of the present course
* "Anywhere": mod/scheduler:canseeotherteachersbooking at site level

In typical setups, this means that a teacher can see all bookings in the current course, whereas a site admin would see all bookings at site level.

==See also==
[[Category:Scheduler]]

[[es:Capacidades del módulo agendador]]

Scheduler Module capabilities

2017-05-09T10:49:08Z

Bostelm: /* mod/scheduler:viewslots */

[[Scheduler module|Back to index]]

The behavior of [[Scheduler module|Scheduler]] can be customized by setting various [[Permissions|capabilities]] at the activity level.

== Student side ==

=== mod/scheduler:viewslots ===

View appointments that are available for booking. This allows a user to view the student screen of Scheduler and to view any appointments that would be available for booking (i.e., which have free capacity available and fall within relevant time limits). The capability does ''not'' allow students to actually book a slot; for this, see [[#mod/scheduler:appoint]] below.

=== mod/scheduler:viewfullslots ===
(To be released with Scheduler 3.1)

Allows students to see slots in the future even if they are already fully booked. This is not enabled by default or the student role, and needs to be set ''in addition'' to [[#mod/scheduler:viewslots]].

===mod/scheduler:appoint===

Book an appointment which has been offered by a teacher, using the student screen. This is useful only for users that have the [[#mod/scheduler:viewslots]] capability.

===mod/scheduler:seeotherstudentsbooking===

See which other students have booked a slot. This applies both to slots which the current student has booked, and to slots which are displayed to the student for booking.

===mod/scheduler:seeotherstudentsresults===

See other slot student's results (grade), in slots which the current student has booked an appointment,

== Teacher side ==

===mod/scheduler:manage===

Create and manage your own slots and appointments. This capability allows a user to see the teacher screen, to create slots for himself (and offer them to students), as wel as to edit these slots afterwards.

===mod/scheduler:attend===

Attend students.

===mod/scheduler:manageallappointments===

Manage all scheduler data, in particular slots for other teachers.

===mod/scheduler:canscheduletootherteachers===

Schedule appointments for other staff members. This is valuable when a third-party staff member (e.g., an administrator) has to set up appointments for other teachers.

===mod/scheduler:canseeotherteachersbooking===

Browse other teacher's appointments. See also [[#mod/scheduler:seeoverviewoutsideactivity]] below.

=== mod/scheduler:seeoverviewoutsideactivity ===

Use the [[Scheduler Overview screen|overview screen]] in order to see data from other schedulers. In the overview screen, users can access data not only from the current scheduler, but from all schedulers they (or others) have offered slots in. Access control used in that screen does not always perfectly match Moodle's fine-grained permissions system (for example, it would not take into account whether teachers are enrolled in the relevant other courses, or whether activities there are hidden). To accommodate this, teachers are allowed to see data "outside the current activity" only if they have the mod/scheduler:seeoverviewoutsideactivity capability. The default teacher role does have this capability, but if you believe it leads to problems in your installation, you can revoke it.

Given "mod/scheduler:seeoverviewoutsideactivity", teachers always see their own bookings in any scope. However, for seeing ''other'' teachers' bookings they would need the following additional permissions:

* "In this scheduler": [[#mod/scheduler:canseeotherteachersbooking]] at the level of the present scheduler
* "In this course": mod/scheduler:canseeotherteachersbooking at the level of the present course
* "Anywhere": mod/scheduler:canseeotherteachersbooking at site level

In typical setups, this means that a teacher can see all bookings in the current course, whereas a site admin would see all bookings at site level.

==See also==
[[Category:Scheduler]]

[[es:Capacidades del módulo agendador]]

Solution sheet

2017-01-28T19:04:05Z

Bostelm: /* Summary */

{{Infobox plugin
|type = Assignment feedback
|entry = https://moodle.org/plugins/view.php?plugin=assignfeedback_solutionsheet
|tracker = [https://tracker.moodle.org/issues/?jql=project%20%3D%20CONTRIB%20AND%20component%20%3D%20%22Assignment%20feedback%3A%20Solution%20sheet%22 Moodle Tracker]
|discussion = https://moodle.org/mod/forum/view.php?id=733
|maintainer = [[User:Henning Bostelmann|Henning Bostelmann]]
|float = right
}}

The '''Solution sheet''' assignment plugin allows teachers to upload files with solutions to their assignment, which can be released to students manually or at a scheduled time.

== Summary ==

In Mathematics and other science subjects, coursework assignments are usually accompanied by model solutions which are released to students after the due date, and to markers beforehand. This plugin allows teachers to upload these solution sheets as files, e.g., in PDF format, to the Moodle [[Assignment]] activity.

Solutions are initially hidden to students, and the teacher can release them either manually, or at a specified time after the due date. Further, they can automatically be made unavailable after a configurable date.

Teachers and markers (nonediting teachers) can view the solutions at any time.

== Usage ==

To add solution sheets to your assignment, edit the [[Assignment settings]] and expand the section "Feedback". Tick the "Solution sheets" box.

You can now upload one ore more files (solution sheets) using the file picker below. Also, choose when the solutions will be released to students:

* ''No'' means they are not visible, but can be released manually by the teacher, using a button on the main assignment page.
* ''Yes, from now on'' releases the solutions immediately.
* ''Yes, ... after the due date'' will release them at the specified time after the assignment due date. Note that this refers to the main assignment due date and does not take any user-specific or group-specific extensions into account. If you need to cater for these, manual release will likely be the better option.

You can also specify a date from when the released solutions will be hidden, e.g., the end of term.

Students can view the released solution sheets from the main assignment page, directly below the assignment description.

== Capabilities ==

The plugin uses the following [[capabilities]]:

'''assignfeedback/solutionsheet:viewsolution'''

:Required to view the solution sheets after they have been released. Assigned by default to the student role.

'''assignfeedback/solutionsheet:viewsolutionanytime'''

:Required to view the solution sheets at any time, even before they have been released. Assigned by default to the editingteacher and teacher role.

'''[[Capabilities/moodle/course:manageactivities|moodle/course:manageactivities]]'''

:Required to upload solution sheets and to change their visibility.

[[Category:Contributed code]]
[[Category:Plugin]]
[[Category:Assignment]]
[[Category:Mathematics]]
[[Category:Physics]]

Solution sheet

2017-01-26T21:33:29Z

Bostelm: now available

{{Infobox plugin
|type = Assignment feedback
|entry = https://moodle.org/plugins/view.php?plugin=assignfeedback_solutionsheet
|tracker = [https://tracker.moodle.org/issues/?jql=project%20%3D%20CONTRIB%20AND%20component%20%3D%20%22Assignment%20feedback%3A%20Solution%20sheet%22 Moodle Tracker]
|discussion = https://moodle.org/mod/forum/view.php?id=733
|maintainer = [[User:Henning Bostelmann|Henning Bostelmann]]
|float = right
}}

The '''Solution sheet''' assignment plugin allows teachers to upload files with solutions to their assignment, which can be released to students manually or at a scheduled time.

== Summary ==

In Mathematics and other science subjects, coursework assignments are usually accompanied by model solutions which are released to students after the due date, and to markers beforehand. This plugin allows teachers to upload these solution sheets as files, e.g., in PDF format, to the Moodle [[Assignment]] activity.

Solutions are initially hidden to students, and the teacher can release them either manually, or at a specified time after the due date. Futher, they can automatically be made unavailable after a configurable date.

== Usage ==

To add solution sheets to your assignment, edit the [[Assignment settings]] and expand the section "Feedback". Tick the "Solution sheets" box.

You can now upload one ore more files (solution sheets) using the file picker below. Also, choose when the solutions will be released to students:

* ''No'' means they are not visible, but can be released manually by the teacher, using a button on the main assignment page.
* ''Yes, from now on'' releases the solutions immediately.
* ''Yes, ... after the due date'' will release them at the specified time after the assignment due date. Note that this refers to the main assignment due date and does not take any user-specific or group-specific extensions into account. If you need to cater for these, manual release will likely be the better option.

You can also specify a date from when the released solutions will be hidden, e.g., the end of term.

Students can view the released solution sheets from the main assignment page, directly below the assignment description.

== Capabilities ==

The plugin uses the following [[capabilities]]:

'''assignfeedback/solutionsheet:viewsolution'''

:Required to view the solution sheets after they have been released. Assigned by default to the student role.

'''assignfeedback/solutionsheet:viewsolutionanytime'''

:Required to view the solution sheets at any time, even before they have been released. Assigned by default to the editingteacher and teacher role.

'''[[Capabilities/moodle/course:manageactivities|moodle/course:manageactivities]]'''

:Required to upload solution sheets and to change their visibility.

[[Category:Contributed code]]
[[Category:Plugin]]
[[Category:Assignment]]
[[Category:Mathematics]]
[[Category:Physics]]

Capabilities/assignfeedback/solutionsheet:viewsolutionanytime

2016-12-06T23:55:59Z

Bostelm: redirect

#REDIRECT [[Solution sheet#Capabilities]]

Solution sheet

2016-12-06T23:14:20Z

Bostelm: /* Capabilities */

{{Infobox plugin
|type = Assignment feedback
|entry = https://moodle.org/plugins/view.php?plugin=assignfeedback_solutionsheet (TBD)
|tracker = [https://tracker.moodle.org/issues/?jql=project%20%3D%20CONTRIB%20AND%20component%20%3D%20%22Assignment%20feedback%3A%20Solution%20sheet%22 Moodle Tracker]
|discussion = https://moodle.org/mod/forum/view.php?id=733
|maintainer = [[User:Henning Bostelmann|Henning Bostelmann]]
|float = right
}}

The '''Solution sheet''' assignment plugin allows teachers to upload files with solutions to their assignment, which can be released to students manually or at a scheduled time.

== Summary ==

In Mathematics and other science subjects, coursework assignments are usually accompanied by model solutions which are released to students after the due date, and to markers beforehand. This plugin allows teachers to upload these solution sheets as files, e.g., in PDF format, to the Moodle [[Assignment]] activity.

Solutions are initially hidden to students, and the teacher can release them either manually, or at a specified time after the due date. Futher, they can automatically be made unavailable after a configurable date.

== Usage ==

To add solution sheets to your assignment, edit the [[Assignment settings]] and expand the section "Feedback". Tick the "Solution sheets" box.

You can now upload one ore more files (solution sheets) using the file picker below. Also, choose when the solutions will be released to students:

* ''No'' means they are not visible, but can be released manually by the teacher, using a button on the main assignment page.
* ''Yes, from now on'' releases the solutions immediately.
* ''Yes, ... after the due date'' will release them at the specified time after the assignment due date. Note that this refers to the main assignment due date and does not take any user-specific or group-specific extensions into account. If you need to cater for these, manual release will likely be the better option.

You can also specify a date from when the released solutions will be hidden, e.g., the end of term.

Students can view the released solution sheets from the main assignment page, directly below the assignment description.

== Capabilities ==

The plugin uses the following [[capabilities]]:

'''assignfeedback/solutionsheet:viewsolution'''

:Required to view the solution sheets after they have been released. Assigned by default to the student role.

'''assignfeedback/solutionsheet:viewsolutionanytime'''

:Required to view the solution sheets at any time, even before they have been released. Assigned by default to the editingteacher and teacher role.

'''[[Capabilities/moodle/course:manageactivities|moodle/course:manageactivities]]'''

:Required to upload solution sheets and to change their visibility.

[[Category:Contributed code]]
[[Category:Plugin]]
[[Category:Assignment]]
[[Category:Mathematics]]
[[Category:Physics]]

Capabilities/assignfeedback/solutionsheet:viewsolution

2016-12-06T23:13:48Z

Bostelm: redirect

#REDIRECT [[Solution sheet#Capabilities]]

assignfeedback/solutionsheet

2016-12-06T23:12:26Z

Bostelm: redirect

#REDIRECT [[Solution sheet]]

Solution sheet

2016-12-06T22:52:20Z

Bostelm: Initial creation

{{Infobox plugin
|type = Assignment feedback
|entry = https://moodle.org/plugins/view.php?plugin=assignfeedback_solutionsheet (TBD)
|tracker = [https://tracker.moodle.org/issues/?jql=project%20%3D%20CONTRIB%20AND%20component%20%3D%20%22Assignment%20feedback%3A%20Solution%20sheet%22 Moodle Tracker]
|discussion = https://moodle.org/mod/forum/view.php?id=733
|maintainer = [[User:Henning Bostelmann|Henning Bostelmann]]
|float = right
}}

The '''Solution sheet''' assignment plugin allows teachers to upload files with solutions to their assignment, which can be released to students manually or at a scheduled time.

== Summary ==

In Mathematics and other science subjects, coursework assignments are usually accompanied by model solutions which are released to students after the due date, and to markers beforehand. This plugin allows teachers to upload these solution sheets as files, e.g., in PDF format, to the Moodle [[Assignment]] activity.

Solutions are initially hidden to students, and the teacher can release them either manually, or at a specified time after the due date. Futher, they can automatically be made unavailable after a configurable date.

== Usage ==

To add solution sheets to your assignment, edit the [[Assignment settings]] and expand the section "Feedback". Tick the "Solution sheets" box.

You can now upload one ore more files (solution sheets) using the file picker below. Also, choose when the solutions will be released to students:

* ''No'' means they are not visible, but can be released manually by the teacher, using a button on the main assignment page.
* ''Yes, from now on'' releases the solutions immediately.
* ''Yes, ... after the due date'' will release them at the specified time after the assignment due date. Note that this refers to the main assignment due date and does not take any user-specific or group-specific extensions into account. If you need to cater for these, manual release will likely be the better option.

You can also specify a date from when the released solutions will be hidden, e.g., the end of term.

Students can view the released solution sheets from the main assignment page, directly below the assignment description.

== Capabilities ==

The plugin uses the following [[capabilities]]:

'''assignfeedback/solutionsheet:viewsolutions'''

:Required to view the solution sheets after they have been released. Assigned by default to the student role.

'''assignfeedback/solutionsheet:viewsolutionsanytime'''

:Required to view the solution sheets at any time, even before they have been released. Assigned by default to the editingteacher and teacher role.

'''[[Capabilities/moodle/course:manageactivities|moodle/course:manageactivities]]'''

:Required to upload solution sheets and to change their visibility.

[[Category:Contributed code]]
[[Category:Plugin]]
[[Category:Assignment]]
[[Category:Mathematics]]
[[Category:Physics]]

Scheduler module

2016-12-05T16:45:07Z

Bostelm: tracker url

{{Infobox plugin
|type = Activity module
|entry = https://moodle.org/plugins/view.php?plugin=mod_scheduler
|tracker = [https://tracker.moodle.org/issues/?jql=project%20%3D%20CONTRIB%20AND%20component%20%3D%20%22Module%3A%20Scheduler%22 Moodle Tracker]
|discussion = https://moodle.org/mod/forum/view.php?id=7139
|maintainer = [[User:Henning Bostelmann|Henning Bostelmann]]
|float = right
}}

The '''Scheduler module''' helps you to schedule one-on-one appointments with all your students. You specify the periods during which you are available to see the students and the length of each appointment. The students then book themselves into one of the available timeslots. The module also lets you record the attendance and grade the appointment.

=Quick Start for the Moodle Scheduler=
This lesson shows you how to quickly make your ''first'' Moodle scheduler, so only the basics are described. Like any other first attempt, your first Moodle scheduler will probably be more for learning than using, but after you finished it, youll be able to choose which features you want to learn more about.

==Prerequisites==
*You must have teacher access to a Moodle course.
*Teachers and students must be enrolled in the course.
*The Moodle scheduler must be installed, since it is not part of the core Moodle package.

==Creating A Basic Scheduler==

#Click the "Turn editing on" button.
#Click the link "Add an activity or resource."
#In the box that appears, choose "Scheduler" and click the "Add" button. [[File:Scheduler01.png]]
#A web page will appear called "Adding a new Scheduler." Type in the name of the scheduler, which can be changed later.
#Scroll to the bottom of the webpage and click the "Save and display" button.
#A webpage will appear with the name of your scheduler at the top. Click the "Add slots" link. [[File:Scheduler_slots01.png]]
#A drop-down menu will appear that allows you to add repeated slots or a single slot. Click the link to add repeated slots.
#Options will appear to add time slots. For this lesson, the slots you add can be real or fictitious, for practice. All time slots must occur in the future, and the start time must be before the end time. The simplest option is to:
##Click the "Start time" menu and choose a time that is one hour from now.
##Click the "End time" menu and choose a time that is one hour after the start time.
#Scroll to the bottom of the webpage and click "Save changes."
  
After these steps, a basic scheduler will appear. To learn more, view the scheduler as a student or explore the options below.


=Scheduler Options=

==Screens==

* Teacher screens
** [[Scheduler: My Appointments|My appointments]]
** [[Scheduler: All Appointments|All Appointments]]
** [[Scheduler: Adding slots|Adding a slot or a series of slots]]
** Scheduling a student or a group of students
** Adding a student to the slot when scheduling
** Overview
** Statistics
** [[Scheduler: Exporting schedule tables|Exports]]
** View student
*** [[Scheduler: Setting feedback|View of comments]]
*** [[Scheduler: Grading|View of appointments and grades]]

* Student screens
** [[Scheduler : Appointing|Viewing and booking slots]]

==Features and Defines==

===Scheduling Modes===

The Scheduler module allows two behaviours relative to appointing, depending on configuration settings. When set to "one only", a student can propose a unique appointment. When set to "one at a time", the student may propose one appointment, and will have to wait to be seen, before being able to make a subsequent appointment.

===Slots exclusivity===

A slot may accept an unlimited number of students (say, when scheduling for open meetings), or only one (face-to-face meeting), or may be set to accept a predefined number of students.

==Moodle Module standard implementations==

===Settings===

* [[Scheduler Module settings and parameters|Scheduler Module settings]]

===Capabilities===

* [[Scheduler Module capabilities]]

===Backup/Restore===

The module performs complete backup/restore within the course context. Slots are considered as module scope information, while appointments are considered as user related data.

==Additional features==

=== Messages and notifications===

An optional notification service sends [[Messaging|messages]] to teachers and students on certain changes:
* To teachers, when a student books or cancels an appointment,
* To students, when a teacher declines an appointment. (Note, no message is sent when the teacher ''deletes'' the slot instead.)

This can be enabled or disabled on each Scheduler's settings page.

Scheduler also sends reminders of upcoming appointments to students, if the teacher has selected this on a per-slot basis.

Further, teachers can use a web form for manually sending invitations or reminders to students who did not yet make an appointment.

===Behaviour with groups===

Scheduler has two different group-related features, both of which can be enabled independently on a per-scheduler basis:
* Restriction to groups: Students can schedule appointments only with teachers in their group,
* Booking in groups: Students can schedule an appointment for the entire group at once.

'''Restriction to groups''' is controlled by Moodle's usual [[Groups#Group_modes|Group mode]] feature (in "Common settings"). Setting "Group mode" to "Visible groups" or "Separate groups" will mean that students can see, and book, only slots which are offered by a teacher with whom they are in a common group. Additionally, in "Separate groups" mode, teachers won't be able to see slots outside their group unless they have [[Capabilities/moodle/site:accessallgroups|permission to access all groups]].

'''Booking in groups''' means that each students of the group can make an appointment for the entire group, i.e., when they click the "Book slot" button, they have the option to assign the entire group to that slot. In order for a student to schedule a group, they will have to belong to at least one group in the course. In the special case where the student belongs to several groups and they wishes to make an appointment within a group, they will not be able to make the appointment until the student has been seen (one-at-a-time setting) or at all (only-one-time setting). With "Booking in groups" enabled, teachers will also be able to assign an entire group to a slot at once.

Note that irrespective of the group features, slots are always remain assigned to one teacher and zero or more individual students, and are not as such tied to a group.

=== Scheduling conflicts ===

Scheduler will, in some situations, warn the user if they are creating [[Scheduler: Conflicts|scheduling conflicts]], i.e., two appointments for the same person at the same time.

==Links==
* [https://moodle.org/mod/forum/view.php?id=7139 Scheduler module forum]
* [https://moodle.org/plugins/view.php?plugin=mod_scheduler Plug-in database entry for Scheduler module]

[[Category:Scheduler]]

[[es:Módulo agendador]]
[[fr:Rendez-Vous]]

User:Henning Bostelmann/Solution sheet

2016-12-05T14:35:49Z

Bostelm: draft

{{Infobox plugin
|type = Assignment feedback
|entry = https://moodle.org/plugins/view.php?plugin=assignfeedback_solutionsheet (TBD)
|tracker = [https://tracker.moodle.org/issues/?jql=project%20%3D%20CONTRIB%20AND%20component%20%3D%20%22Assignment%20feedback%3A%20Solution%20sheet%22 Moodle Tracker]
|discussion = https://moodle.org/mod/forum/view.php?id=733
|maintainer = [[User:Henning Bostelmann|Henning Bostelmann]]
|float = right
}}

The '''Solution sheet''' assignment plugin allows teachers to upload files with solutions to the assignment, which can be released to students manually or at a scheduled time.

== Summary ==

In Mathematics and in technical disciplines, coursework assignments are usually accompanied by model solutions which are released to students after the due date, and to markers beforehand. This plugin allows teachers to upload these solution sheets as files, e.g., in PDF format, to the Moodle [[Assignment]] activity.

Solutions are initially hidden to students, and the teacher can released them either manually, or at a specified time after the due date.

== Usage ==

To add solution sheets to your assignment, edit the [[Assignment settings]] and expand the section "Feedback". Tick the "Solution sheets" box.

You can now upload one ore more files (solution sheets) using the file picker below. Also, choose when the solutions will be released to students:

* ''No'' means they are not visible, but can be released manually by the teacher, using a button on the main assignment page.
* ''Yes, from now on'' releases the solutions immediately.
* ''Yes, ... after the due date'' will release them at the specified time after the assignment due date. Note that this refers to the main assignment due date and does not take any user-specific or group-specific extensions into account. If you need to cater for these, manual release will likely be the better option.

You can also specify a date from when the released solutions will be hidden, e.g., the end of term.

Students can view the released solution sheets from the main assignment page, directly below the assignment description.

== Capabilities ==

The plugin uses the following [[capabilities]]:

'''assignfeedback/solutionsheet:viewsolutions'''

:Required to view the solution sheets after they have been released. Assigned by default to the student role.

'''assignfeedback/solutionsheet:viewsolutionsanytime'''

:Required to view the solution sheets at any time, even before they have been released. Assigned by default to the editingteacher and teacher role.

'''[[Capabilities/moodle/course:manageactivities|moodle/course:manageactivities]]'''

:Required to upload solution sheets and to change their visibility.

[[Category:Contributed code]]
[[Category:Plugin]]
[[Category:Assignment]]
[[Category:Mathematics]]
[[Category:Physics]]

capabilities

2016-12-05T14:11:07Z

Bostelm: redirect from lowercase version

#redirect [[Roles and permissions]]

Scheduler module

2016-09-20T18:12:31Z

Bostelm: /* Notifications */ update

{{Infobox plugin
|type = Activity module
|entry = https://moodle.org/plugins/view.php?plugin=mod_scheduler
|tracker = http://tracker.moodle.org/browse/CONTRIB/component/10241
|discussion = https://moodle.org/mod/forum/view.php?id=7139
|maintainer = [[User:Henning Bostelmann|Henning Bostelmann]]
|float = right
}}

The '''Scheduler module''' helps you to schedule one-on-one appointments with all your students. You specify the periods during which you are available to see the students and the length of each appointment. The students then book themselves into one of the available timeslots. The module also lets you record the attendance and grade the appointment.

=Quick Start for the Moodle Scheduler=
This lesson shows you how to quickly make your ''first'' Moodle scheduler, so only the basics are described. Like any other first attempt, your first Moodle scheduler will probably be more for learning than using, but after you finished it, youll be able to choose which features you want to learn more about.

==Prerequisites==
*You must have teacher access to a Moodle course.
*Teachers and students must be enrolled in the course.
*The Moodle scheduler must be installed, since it is not part of the core Moodle package.

==Creating A Basic Scheduler==

#Click the "Turn editing on" button.
#Click the link "Add an activity or resource."
#In the box that appears, choose "Scheduler" and click the "Add" button. [[File:Scheduler01.png]]
#A web page will appear called "Adding a new Scheduler." Type in the name of the scheduler, which can be changed later.
#Scroll to the bottom of the webpage and click the "Save and display" button.
#A webpage will appear with the name of your scheduler at the top. Click the "Add slots" link. [[File:Scheduler_slots01.png]]
#A drop-down menu will appear that allows you to add repeated slots or a single slot. Click the link to add repeated slots.
#Options will appear to add time slots. For this lesson, the slots you add can be real or fictitious, for practice. All time slots must occur in the future, and the start time must be before the end time. The simplest option is to:
##Click the "Start time" menu and choose a time that is one hour from now.
##Click the "End time" menu and choose a time that is one hour after the start time.
#Scroll to the bottom of the webpage and click "Save changes."
  
After these steps, a basic scheduler will appear. To learn more, view the scheduler as a student or explore the options below.


=Scheduler Options=

==Screens==

* Teacher screens
** [[Scheduler: My Appointments|My appointments]]
** [[Scheduler: All Appointments|All Appointments]]
** [[Scheduler: Adding slots|Adding a slot or a series of slots]]
** Scheduling a student or a group of students
** Adding a student to the slot when scheduling
** Overview
** Statistics
** [[Scheduler: Exporting schedule tables|Exports]]
** View student
*** [[Scheduler: Setting feedback|View of comments]]
*** [[Scheduler: Grading|View of appointments and grades]]

* Student screens
** [[Scheduler : Appointing|Viewing and booking slots]]

==Features and Defines==

===Scheduling Modes===

The Scheduler module allows two behaviours relative to appointing, depending on configuration settings. When set to "one only", a student can propose a unique appointment. When set to "one at a time", the student may propose one appointment, and will have to wait to be seen, before being able to make a subsequent appointment.

===Slots exclusivity===

A slot may accept an unlimited number of students (say, when scheduling for open meetings), or only one (face-to-face meeting), or may be set to accept a predefined number of students.

==Moodle Module standard implementations==

===Settings===

* [[Scheduler Module settings and parameters|Scheduler Module settings]]

===Capabilities===

* [[Scheduler Module capabilities]]

===Backup/Restore===

The module performs complete backup/restore within the course context. Slots are considered as module scope information, while appointments are considered as user related data.

==Additional features==

=== Messages and notifications===

An optional notification service sends [[Messaging|messages]] to teachers and students on certain changes:
* To teachers, when a student books or cancels an appointment,
* To students, when a teacher declines an appointment. (Note, no message is sent when the teacher ''deletes'' the slot instead.)

This can be enabled or disabled on each Scheduler's settings page.

Scheduler also sends reminders of upcoming appointments to students, if the teacher has selected this on a per-slot basis.

Further, teachers can use a web form for manually sending invitations or reminders to students who did not yet make an appointment.

===Behaviour with groups===

Scheduler has two different group-related features, both of which can be enabled independently on a per-scheduler basis:
* Restriction to groups: Students can schedule appointments only with teachers in their group,
* Booking in groups: Students can schedule an appointment for the entire group at once.

'''Restriction to groups''' is controlled by Moodle's usual [[Groups#Group_modes|Group mode]] feature (in "Common settings"). Setting "Group mode" to "Visible groups" or "Separate groups" will mean that students can see, and book, only slots which are offered by a teacher with whom they are in a common group. Additionally, in "Separate groups" mode, teachers won't be able to see slots outside their group unless they have [[Capabilities/moodle/site:accessallgroups|permission to access all groups]].

'''Booking in groups''' means that each students of the group can make an appointment for the entire group, i.e., when they click the "Book slot" button, they have the option to assign the entire group to that slot. In order for a student to schedule a group, they will have to belong to at least one group in the course. In the special case where the student belongs to several groups and they wishes to make an appointment within a group, they will not be able to make the appointment until the student has been seen (one-at-a-time setting) or at all (only-one-time setting). With "Booking in groups" enabled, teachers will also be able to assign an entire group to a slot at once.

Note that irrespective of the group features, slots are always remain assigned to one teacher and zero or more individual students, and are not as such tied to a group.

=== Scheduling conflicts ===

Scheduler will, in some situations, warn the user if they are creating [[Scheduler: Conflicts|scheduling conflicts]], i.e., two appointments for the same person at the same time.

==Links==
* [https://moodle.org/mod/forum/view.php?id=7139 Scheduler module forum]
* [https://moodle.org/plugins/view.php?plugin=mod_scheduler Plug-in database entry for Scheduler module]

[[Category:Scheduler]]

[[es:Módulo agendador]]
[[fr:Rendez-Vous]]

Scheduler module

2016-08-23T16:25:05Z

Bostelm: /* Behaviour with groups */ typos

{{Infobox plugin
|type = Activity module
|entry = https://moodle.org/plugins/view.php?plugin=mod_scheduler
|tracker = http://tracker.moodle.org/browse/CONTRIB/component/10241
|discussion = https://moodle.org/mod/forum/view.php?id=7139
|maintainer = [[User:Henning Bostelmann|Henning Bostelmann]]
|float = right
}}

The '''Scheduler module''' helps you to schedule one-on-one appointments with all your students. You specify the periods during which you are available to see the students and the length of each appointment. The students then book themselves into one of the available timeslots. The module also lets you record the attendance and grade the appointment.

=Quick Start for the Moodle Scheduler=
This lesson shows you how to quickly make your ''first'' Moodle scheduler, so only the basics are described. Like any other first attempt, your first Moodle scheduler will probably be more for learning than using, but after you finished it, youll be able to choose which features you want to learn more about.

==Prerequisites==
*You must have teacher access to a Moodle course.
*Teachers and students must be enrolled in the course.
*The Moodle scheduler must be installed, since it is not part of the core Moodle package.

==Creating A Basic Scheduler==

#Click the "Turn editing on" button.
#Click the link "Add an activity or resource."
#In the box that appears, choose "Scheduler" and click the "Add" button. [[File:Scheduler01.png]]
#A web page will appear called "Adding a new Scheduler." Type in the name of the scheduler, which can be changed later.
#Scroll to the bottom of the webpage and click the "Save and display" button.
#A webpage will appear with the name of your scheduler at the top. Click the "Add slots" link. [[File:Scheduler_slots01.png]]
#A drop-down menu will appear that allows you to add repeated slots or a single slot. Click the link to add repeated slots.
#Options will appear to add time slots. For this lesson, the slots you add can be real or fictitious, for practice. All time slots must occur in the future, and the start time must be before the end time. The simplest option is to:
##Click the "Start time" menu and choose a time that is one hour from now.
##Click the "End time" menu and choose a time that is one hour after the start time.
#Scroll to the bottom of the webpage and click "Save changes."
  
After these steps, a basic scheduler will appear. To learn more, view the scheduler as a student or explore the options below.


=Scheduler Options=

==Screens==

* Teacher screens
** [[Scheduler: My Appointments|My appointments]]
** [[Scheduler: All Appointments|All Appointments]]
** [[Scheduler: Adding slots|Adding a slot or a series of slots]]
** Scheduling a student or a group of students
** Adding a student to the slot when scheduling
** Overview
** Statistics
** [[Scheduler: Exporting schedule tables|Exports]]
** View student
*** [[Scheduler: Setting feedback|View of comments]]
*** [[Scheduler: Grading|View of appointments and grades]]

* Student screens
** [[Scheduler : Appointing|Viewing and booking slots]]

==Features and Defines==

===Scheduling Modes===

The Scheduler module allows two behaviours relative to appointing, depending on configuration settings. When set to "one only", a student can propose a unique appointment. When set to "one at a time", the student may propose one appointment, and will have to wait to be seen, before being able to make a subsequent appointment.

===Slots exclusivity===

A slot may accept an unlimited number of students (say, when scheduling for open meetings), or only one (face-to-face meeting), or may be set to accept a predefined number of students.

==Moodle Module standard implementations==

===Settings===

* [[Scheduler Module settings and parameters|Scheduler Module settings]]

===Capabilities===

* [[Scheduler Module capabilities]]

===Backup/Restore===

The module performs complete backup/restore within the course context. Slots are considered as module scope information, while appointments are considered as user related data.

==Additional features==

===Notifications===

A notification service (by mail) sends messages to teachers and students about any unilateral change to the agreed appointment.

===Behaviour with groups===

Scheduler has two different group-related features, both of which can be enabled independently on a per-scheduler basis:
* Restriction to groups: Students can schedule appointments only with teachers in their group,
* Booking in groups: Students can schedule an appointment for the entire group at once.

'''Restriction to groups''' is controlled by Moodle's usual [[Groups#Group_modes|Group mode]] feature (in "Common settings"). Setting "Group mode" to "Visible groups" or "Separate groups" will mean that students can see, and book, only slots which are offered by a teacher with whom they are in a common group. Additionally, in "Separate groups" mode, teachers won't be able to see slots outside their group unless they have [[Capabilities/moodle/site:accessallgroups|permission to access all groups]].

'''Booking in groups''' means that each students of the group can make an appointment for the entire group, i.e., when they click the "Book slot" button, they have the option to assign the entire group to that slot. In order for a student to schedule a group, they will have to belong to at least one group in the course. In the special case where the student belongs to several groups and they wishes to make an appointment within a group, they will not be able to make the appointment until the student has been seen (one-at-a-time setting) or at all (only-one-time setting). With "Booking in groups" enabled, teachers will also be able to assign an entire group to a slot at once.

Note that irrespective of the group features, slots are always remain assigned to one teacher and zero or more individual students, and are not as such tied to a group.

=== Scheduling conflicts ===

Scheduler will, in some situations, warn the user if they are creating [[Scheduler: Conflicts|scheduling conflicts]], i.e., two appointments for the same person at the same time.

==Links==
* [https://moodle.org/mod/forum/view.php?id=7139 Scheduler module forum]
* [https://moodle.org/plugins/view.php?plugin=mod_scheduler Plug-in database entry for Scheduler module]

[[Category:Scheduler]]

[[es:Módulo agendador]]
[[fr:Rendez-Vous]]

Scheduler module

2016-08-23T16:17:27Z

Bostelm: /* Behaviour with groups */ new behaviour

{{Infobox plugin
|type = Activity module
|entry = https://moodle.org/plugins/view.php?plugin=mod_scheduler
|tracker = http://tracker.moodle.org/browse/CONTRIB/component/10241
|discussion = https://moodle.org/mod/forum/view.php?id=7139
|maintainer = [[User:Henning Bostelmann|Henning Bostelmann]]
|float = right
}}

The '''Scheduler module''' helps you to schedule one-on-one appointments with all your students. You specify the periods during which you are available to see the students and the length of each appointment. The students then book themselves into one of the available timeslots. The module also lets you record the attendance and grade the appointment.

=Quick Start for the Moodle Scheduler=
This lesson shows you how to quickly make your ''first'' Moodle scheduler, so only the basics are described. Like any other first attempt, your first Moodle scheduler will probably be more for learning than using, but after you finished it, youll be able to choose which features you want to learn more about.

==Prerequisites==
*You must have teacher access to a Moodle course.
*Teachers and students must be enrolled in the course.
*The Moodle scheduler must be installed, since it is not part of the core Moodle package.

==Creating A Basic Scheduler==

#Click the "Turn editing on" button.
#Click the link "Add an activity or resource."
#In the box that appears, choose "Scheduler" and click the "Add" button. [[File:Scheduler01.png]]
#A web page will appear called "Adding a new Scheduler." Type in the name of the scheduler, which can be changed later.
#Scroll to the bottom of the webpage and click the "Save and display" button.
#A webpage will appear with the name of your scheduler at the top. Click the "Add slots" link. [[File:Scheduler_slots01.png]]
#A drop-down menu will appear that allows you to add repeated slots or a single slot. Click the link to add repeated slots.
#Options will appear to add time slots. For this lesson, the slots you add can be real or fictitious, for practice. All time slots must occur in the future, and the start time must be before the end time. The simplest option is to:
##Click the "Start time" menu and choose a time that is one hour from now.
##Click the "End time" menu and choose a time that is one hour after the start time.
#Scroll to the bottom of the webpage and click "Save changes."
  
After these steps, a basic scheduler will appear. To learn more, view the scheduler as a student or explore the options below.


=Scheduler Options=

==Screens==

* Teacher screens
** [[Scheduler: My Appointments|My appointments]]
** [[Scheduler: All Appointments|All Appointments]]
** [[Scheduler: Adding slots|Adding a slot or a series of slots]]
** Scheduling a student or a group of students
** Adding a student to the slot when scheduling
** Overview
** Statistics
** [[Scheduler: Exporting schedule tables|Exports]]
** View student
*** [[Scheduler: Setting feedback|View of comments]]
*** [[Scheduler: Grading|View of appointments and grades]]

* Student screens
** [[Scheduler : Appointing|Viewing and booking slots]]

==Features and Defines==

===Scheduling Modes===

The Scheduler module allows two behaviours relative to appointing, depending on configuration settings. When set to "one only", a student can propose a unique appointment. When set to "one at a time", the student may propose one appointment, and will have to wait to be seen, before being able to make a subsequent appointment.

===Slots exclusivity===

A slot may accept an unlimited number of students (say, when scheduling for open meetings), or only one (face-to-face meeting), or may be set to accept a predefined number of students.

==Moodle Module standard implementations==

===Settings===

* [[Scheduler Module settings and parameters|Scheduler Module settings]]

===Capabilities===

* [[Scheduler Module capabilities]]

===Backup/Restore===

The module performs complete backup/restore within the course context. Slots are considered as module scope information, while appointments are considered as user related data.

==Additional features==

===Notifications===

A notification service (by mail) sends messages to teachers and students about any unilateral change to the agreed appointment.

===Behaviour with groups===

Scheduler has two different group-related features, both of which can be enabled independently on a per-scheduler basis:
* Restriction to groups: Students can schedule appointments only with teachers in their group,
* Booking in groups: Students can schedule an appointment for the entire group at once.

'''Restriction to groups''' is controlled by Moodle's usual [[Groups#Group_modes|Group mode]] feature (in "Common settings"). Setting "Group mode" to "Visible groups" or "Separate groups" will mean that students can see, and book, only slots which are offered by a teacher with whom they are in a common group. Additionally, in "Separate groups" mode, teachers won't be able to see slots outside their group unbless they have [[Capabilities/moodle/site:accessallgroups|permission to access all groups]].

'''Booking in groups''' means each students of the group can make an appointment for the entire group, i.e., when they click the "Book slot" button, they have the option to assign the entire group to that slot. In order for a student to schedule a group, he will have to belong to at least one group in the course. In the special case where he belongs to several groups and he wishes to make an appointment within a group, he will not be able to make the appointment until he has been seen (one-at-a-time setting) or at all (only-one-time setting). With "booking in groups" enabled, Teachers will also be able to assign an entire group to a slot at once.

Note that irrespective of the group features, slots are always remain assigned to one teacher and zero or more individual students, and are not as such tied to a group.

=== Scheduling conflicts ===

Scheduler will, in some situations, warn the user if they are creating [[Scheduler: Conflicts|scheduling conflicts]], i.e., two appointments for the same person at the same time.

==Links==
* [https://moodle.org/mod/forum/view.php?id=7139 Scheduler module forum]
* [https://moodle.org/plugins/view.php?plugin=mod_scheduler Plug-in database entry for Scheduler module]

[[Category:Scheduler]]

[[es:Módulo agendador]]
[[fr:Rendez-Vous]]

Scheduler module

2016-06-22T16:20:55Z

Bostelm: /* Additional implementations */

{{Infobox plugin
|type = Activity module
|entry = https://moodle.org/plugins/view.php?plugin=mod_scheduler
|tracker = http://tracker.moodle.org/browse/CONTRIB/component/10241
|discussion = https://moodle.org/mod/forum/view.php?id=7139
|maintainer = [[User:Henning Bostelmann|Henning Bostelmann]]
|float = right
}}

The '''Scheduler module''' helps you to schedule one-on-one appointments with all your students. You specify the periods during which you are available to see the students and the length of each appointment. The students then book themselves into one of the available timeslots. The module also lets you record the attendance and grade the appointment.

=Quick Start for the Moodle Scheduler=
This lesson shows you how to quickly make your ''first'' Moodle scheduler, so only the basics are described. Like any other first attempt, your first Moodle scheduler will probably be more for learning than using, but after you finished it, youll be able to choose which features you want to learn more about.

==Prerequisites==
*You must have teacher access to a Moodle course.
*Teachers and students must be enrolled in the course.
*The Moodle scheduler must be installed, since it is not part of the core Moodle package.

==Creating A Basic Scheduler==

#Click the "Turn editing on" button.
#Click the link "Add an activity or resource."
#In the box that appears, choose "Scheduler" and click the "Add" button. [[File:Scheduler01.png]]
#A web page will appear called "Adding a new Scheduler." Type in the name of the scheduler, which can be changed later.
#Scroll to the bottom of the webpage and click the "Save and display" button.
#A webpage will appear with the name of your scheduler at the top. Click the "Add slots" link. [[File:Scheduler_slots01.png]]
#A drop-down menu will appear that allows you to add repeated slots or a single slot. Click the link to add repeated slots.
#Options will appear to add time slots. For this lesson, the slots you add can be real or fictitious, for practice. All time slots must occur in the future, and the start time must be before the end time. The simplest option is to:
##Click the "Start time" menu and choose a time that is one hour from now.
##Click the "End time" menu and choose a time that is one hour after the start time.
#Scroll to the bottom of the webpage and click "Save changes."
  
After these steps, a basic scheduler will appear. To learn more, view the scheduler as a student or explore the options below.


=Scheduler Options=

==Screens==

* Teacher screens
** [[Scheduler: My Appointments|My appointments]]
** [[Scheduler: All Appointments|All Appointments]]
** [[Scheduler: Adding slots|Adding a slot or a series of slots]]
** Scheduling a student or a group of students
** Adding a student to the slot when scheduling
** Overview
** Statistics
** [[Scheduler: Exporting schedule tables|Exports]]
** View student
*** [[Scheduler: Setting feedback|View of comments]]
*** [[Scheduler: Grading|View of appointments and grades]]

* Student screens
** [[Scheduler : Appointing|Viewing and booking slots]]

==Features and Defines==

===Scheduling Modes===

The Scheduler module allows two behaviours relative to appointing, depending on configuration settings. When set to "one only", a student can propose a unique appointment. When set to "one at a time", the student may propose one appointment, and will have to wait to be seen, before being able to make a subsequent appointment.

===Slots exclusivity===

A slot may accept an unlimited number of students (say, when scheduling for open meetings), or only one (face-to-face meeting), or may be set to accept a predefined number of students.

==Moodle Module standard implementations==

===Settings===

* [[Scheduler Module settings and parameters|Scheduler Module settings]]

===Capabilities===

* [[Scheduler Module capabilities]]

===Backup/Restore===

The module performs complete backup/restore within the course context. Slots are considered as module scope information, while appointments are considered as user related data.

==Additional features==

===Notifications===

A notification service (by mail) sends messages to teachers and students about any unilateral change to the agreed appointment.

===Behaviour with groups===

The Scheduler Module uses the standard grouping mode of Moodle to enable or disable features related to groups scheduling. When the group mode of the module is set to "NO GROUPS", all group related adds-on are hidden. When set to "GROUPS VISIBLE" or "SEPARATE GROUPS", all group related features are enabled. For group features to be usable, students in the current course should of course be grouped (obvious).

*'''Teacher side group features'''
**A teacher can schedule on a group basis rather than on a per student basis. When scheduling a full group, the exclusivity status of the time slot changes to fit the group size. The appointment of the group locks definitively the time slot for that group. Notifications are handled individually, just as if each student had made the appointment.

*'''Student side group features'''
**A student can schedule an appointment for one of the groups he belongs to. When choosing this option, he will make the appointment for all colleagues in the group, locking the slot exclusively at that number of users. In order for a student to schedule a group, he will have to belong to at least one group in the course. In the special case where he belongs to several groups and he wishes to make an appointment within a group, he will not be able to make the appointment until he has been seen (one-at-a-time setting) or at all (only-one-time setting).

=== Scheduling conflicts ===

Scheduler will, in some situations, warn the user if they are creating [[Scheduler: Conflicts|scheduling conflicts]], i.e., two appointments for the same person at the same time.

==Links==
* [https://moodle.org/mod/forum/view.php?id=7139 Scheduler module forum]
* [https://moodle.org/plugins/view.php?plugin=mod_scheduler Plug-in database entry for Scheduler module]

[[Category:Scheduler]]

[[es:Módulo agendador]]
[[fr:Rendez-Vous]]

mod/scheduler/conflict

2016-06-22T16:18:11Z

Bostelm: Redirected page to Scheduler: Conflicts

#REDIRECT [[Scheduler: Conflicts]]

Scheduler: Conflicts

2016-06-22T16:17:40Z

Bostelm: /* Student side */ clarification

When offering or booking time slots in [[Scheduler module|Scheduler]], a user might end up with '''scheduling conflicts''',
that is, with two overlapping appointments at the same date and time;
either within the same scheduler activity, or across several scheduler activities on the system.

Scheduler attempts to warn ''teachers'' of such scheduling conflicts, but it does not ultimately enforce conflict-free appointments.
When a ''student'' makes a booking, however, no checks for conflicts are performed.

(The following describes the situation as of Scheduler 3.1, to be released. Previous versions of Scheduler may differ slightly.)

== Teacher side ==

In the teacher screens, Scheduler will generally warn when a new or updated slot would create a conflict for a teacher.
It does ''not'' check whether ''students'' on the slot have scheduling conflicts.

Slots that happen in the past will never be regarded as conflicting. Since these are normally added/moved for documentation purposes only, it is not useful to check for conflicts in this case.

; Adding or editing a single slot

When the edit form for a single slot is saved, Scheduler will check whether the time range of the slot overlaps with any other slots of the same teacher, in any scheduler activity on the system.
If a conflict is found, this will result in a warning message. You can override the warning - and save the conflicting slot nevertheless - by ticking the "Ignore scheduling conflicts" box.

; Adding repeated slots

When adding a series of (empty) slots, Scheduler will check while creating the slots whether any of them conflicts with existing slots for the same teacher.

In case a conflict is found, the behavior depends on the setting "Force when overlap" in the [[Scheduler: Adding_slots|Add multiple slots]] screen. If this is set to "no", then those new slots that would create a conflict will not be created.
If the switch is set to "yes", then existing conflicting slots will be deleted before the new slot is being created.

However, Scheduler will never delete a conflicting slot if students are already booked on it, or if the slot is located outside the current scheduler activity.

;Mark as seen now

When a teacher clicks "mark as seen now" on a student, this will always create an appointment with the student at the current time, with no checks for conflicts performed.

== Student side ==

Scheduler does '''not''' detect any scheduling conflicts in the student screens.
That is, nothing prevents a student from scheduling two appointments at the same time,
either in the same scheduler or in separate schedulers.

The assumption here is that students will check their calendars for other commitments (whether Scheduler appointments or otherwise, online or offline) before making a booking.

[[Category:Scheduler]]

Scheduler: Conflicts

2016-06-22T16:16:00Z

Bostelm: documenting the status quo

When offering or booking time slots in [[Scheduler module|Scheduler]], a user might end up with '''scheduling conflicts''',
that is, with two overlapping appointments at the same date and time;
either within the same scheduler activity, or across several scheduler activities on the system.

Scheduler attempts to warn ''teachers'' of such scheduling conflicts, but it does not ultimately enforce conflict-free appointments.
When a ''student'' makes a booking, however, no checks for conflicts are performed.

(The following describes the situation as of Scheduler 3.1, to be released. Previous versions of Scheduler may differ slightly.)

== Teacher side ==

In the teacher screens, Scheduler will generally warn when a new or updated slot would create a conflict for a teacher.
It does ''not'' check whether ''students'' on the slot have scheduling conflicts.

Slots that happen in the past will never be regarded as conflicting. Since these are normally added/moved for documentation purposes only, it is not useful to check for conflicts in this case.

; Adding or editing a single slot

When the edit form for a single slot is saved, Scheduler will check whether the time range of the slot overlaps with any other slots of the same teacher, in any scheduler activity on the system.
If a conflict is found, this will result in a warning message. You can override the warning - and save the conflicting slot nevertheless - by ticking the "Ignore scheduling conflicts" box.

; Adding repeated slots

When adding a series of (empty) slots, Scheduler will check while creating the slots whether any of them conflicts with existing slots for the same teacher.

In case a conflict is found, the behavior depends on the setting "Force when overlap" in the [[Scheduler: Adding_slots|Add multiple slots]] screen. If this is set to "no", then those new slots that would create a conflict will not be created.
If the switch is set to "yes", then existing conflicting slots will be deleted before the new slot is being created.

However, Scheduler will never delete a conflicting slot if students are already booked on it, or if the slot is located outside the current scheduler activity.

;Mark as seen now

When a teacher clicks "mark as seen now" on a student, this will always create an appointment with the student at the current time, with no checks for conflicts performed.

== Student side ==

Scheduler does '''not''' detect any scheduling conflicts on the student side.
That is, there is nothing to prevent a student from scheduling two appointments at the same time,
either in the same scheduler or in separate schedulers.

Likewise, there is nothing that prevents teachers from scheduling two appointments with the same student at the same time.

The assumption here is that students will check their calendars for other commitments (whether Scheduler appointments or otherwise, online or offline) before making a booking.

[[Category:Scheduler]]

File:scheduler parameters EN.jpg

2016-06-20T23:31:23Z

Bostelm: Bostelm uploaded a new version of File:scheduler parameters EN.jpg

Scheduler module parameter screen

Scheduler module

2016-06-20T23:18:16Z

Bostelm: /* Screens */

{{Infobox plugin
|type = Activity module
|entry = https://moodle.org/plugins/view.php?plugin=mod_scheduler
|tracker = http://tracker.moodle.org/browse/CONTRIB/component/10241
|discussion = https://moodle.org/mod/forum/view.php?id=7139
|maintainer = [[User:Henning Bostelmann|Henning Bostelmann]]
|float = right
}}

The '''Scheduler module''' helps you to schedule one-on-one appointments with all your students. You specify the periods during which you are available to see the students and the length of each appointment. The students then book themselves into one of the available timeslots. The module also lets you record the attendance and grade the appointment.

=Quick Start for the Moodle Scheduler=
This lesson shows you how to quickly make your ''first'' Moodle scheduler, so only the basics are described. Like any other first attempt, your first Moodle scheduler will probably be more for learning than using, but after you finished it, youll be able to choose which features you want to learn more about.

==Prerequisites==
*You must have teacher access to a Moodle course.
*Teachers and students must be enrolled in the course.
*The Moodle scheduler must be installed, since it is not part of the core Moodle package.

==Creating A Basic Scheduler==

#Click the "Turn editing on" button.
#Click the link "Add an activity or resource."
#In the box that appears, choose "Scheduler" and click the "Add" button. [[File:Scheduler01.png]]
#A web page will appear called "Adding a new Scheduler." Type in the name of the scheduler, which can be changed later.
#Scroll to the bottom of the webpage and click the "Save and display" button.
#A webpage will appear with the name of your scheduler at the top. Click the "Add slots" link. [[File:Scheduler_slots01.png]]
#A drop-down menu will appear that allows you to add repeated slots or a single slot. Click the link to add repeated slots.
#Options will appear to add time slots. For this lesson, the slots you add can be real or fictitious, for practice. All time slots must occur in the future, and the start time must be before the end time. The simplest option is to:
##Click the "Start time" menu and choose a time that is one hour from now.
##Click the "End time" menu and choose a time that is one hour after the start time.
#Scroll to the bottom of the webpage and click "Save changes."
  
After these steps, a basic scheduler will appear. To learn more, view the scheduler as a student or explore the options below.


=Scheduler Options=

==Screens==

* Teacher screens
** [[Scheduler: My Appointments|My appointments]]
** [[Scheduler: All Appointments|All Appointments]]
** [[Scheduler: Adding slots|Adding a slot or a series of slots]]
** Scheduling a student or a group of students
** Adding a student to the slot when scheduling
** Overview
** Statistics
** [[Scheduler: Exporting schedule tables|Exports]]
** View student
*** [[Scheduler: Setting feedback|View of comments]]
*** [[Scheduler: Grading|View of appointments and grades]]

* Student screens
** [[Scheduler : Appointing|Viewing and booking slots]]

==Features and Defines==

===Scheduling Modes===

The Scheduler module allows two behaviours relative to appointing, depending on configuration settings. When set to "one only", a student can propose a unique appointment. When set to "one at a time", the student may propose one appointment, and will have to wait to be seen, before being able to make a subsequent appointment.

===Slots exclusivity===

A slot may accept an unlimited number of students (say, when scheduling for open meetings), or only one (face-to-face meeting), or may be set to accept a predefined number of students.

==Moodle Module standard implementations==

===Settings===

* [[Scheduler Module settings and parameters|Scheduler Module settings]]

===Capabilities===

* [[Scheduler Module capabilities]]

===Backup/Restore===

The module performs complete backup/restore within the course context. Slots are considered as module scope information, while appointments are considered as user related data.

==Additional implementations==

===Notifications===

A notification service (by mail) sends messages to teachers and students about any unilateral change to the agreed appointment.

===Behaviour with groups===

The Scheduler Module uses the standard grouping mode of Moodle to enable or disable features related to groups scheduling. When the group mode of the module is set to "NO GROUPS", all group related adds-on are hidden. When set to "GROUPS VISIBLE" or "SEPARATE GROUPS", all group related features are enabled. For group features to be usable, students in the current course should of course be grouped (obvious).

*'''Teacher side group features'''
**A teacher can schedule on a group basis rather than on a per student basis. When scheduling a full group, the exclusivity status of the time slot changes to fit the group size. The appointment of the group locks definitively the time slot for that group. Notifications are handled individually, just as if each student had made the appointment.

*'''Student side group features'''
**A student can schedule an appointment for one of the groups he belongs to. When choosing this option, he will make the appointment for all colleagues in the group, locking the slot exclusively at that number of users. In order for a student to schedule a group, he will have to belong to at least one group in the course. In the special case where he belongs to several groups and he wishes to make an appointment within a group, he will not be able to make the appointment until he has been seen (one-at-a-time setting) or at all (only-one-time setting).

==Links==
* [https://moodle.org/mod/forum/view.php?id=7139 Scheduler module forum]
* [https://moodle.org/plugins/view.php?plugin=mod_scheduler Plug-in database entry for Scheduler module]

[[Category:Scheduler]]

[[es:Módulo agendador]]
[[fr:Rendez-Vous]]

mod/scheduler/mod

2016-06-20T23:05:57Z

Bostelm: Redirected page to Scheduler Module settings and parameters

#REDIRECT [[Scheduler Module settings and parameters]]

Scheduler Module settings and parameters

2016-06-20T23:05:21Z

Bostelm: /* Reuse Guard Time */

The [[Scheduler module]] let you configure per instance a small amount of important parameters. these parameters might change the overall behaviour of the appointment system.

[[Image:scheduler_parameters_EN.jpg]]

==Scheduler Name And Description (not shown)==

As usual the name and the description are used as short reference (resp. description) in the course or the scheduler index.

==Role Name Of The Attendant==

The scheduler might be used not only in a strict pedagogic relationship (student->teacher). Some institution might not even use the word of teacher for the attendant. Here could you change the label used when the attendant's quality is mentionned to the student eyes.

==Mode==

This parameter allows switching between the "one only" and the "one at a time" mode.

* ''One only'': The student will be allowed to appoint only one time in this scheduler. He will not be allowed to appoint for a new slot, event if his previous appointment has been concluded and marked as "seen".

* ''One at a time'': The student will be allowed to appoint as soon as his current appointment has been marked as seen. This allows multiple encounters between student and teacher in the scope of this scheduler purpose.

== Guard Time==

This parameter sets a "guard time" from the time that an appointment takes place; within the "guard time", students cannot modify their booking.
That is, if the "guard time" is set to 1 hour, then students must book slots at least 1 hour in advance, and they won't be able to cancel their booking less than 1 hour before the appointment.

==Default Slot Duration==

Specifies the default duration of a slot (in minutes) when adding slots. This value can be overridden when adding slots.

==Scale==

Specifies the grading scales that might be used to grade the student's interview.

==Notifications==

Allows enabling or disabling mail notification service for this scheduler. If set to "no", no message will be sent when moving, removing or adding an appointment.

==Grading Strategy==

When mode is "one at a time", a single student might accumulate more than one "seen" appointment. There are two way of calculating the given grade for the appointments:

* ''Take the mean grade:'' The grade will be the mean of all given grades for that student in the scheduler.
* ''Take the highest grade:'' The highest grade over all the appointments will be retained for grading.

==See also==

[[Category:Scheduler]]

[[es:Configuraciones y Parámetros del módulo agendador]]

mod/scheduler/mod

2016-06-20T23:01:42Z

Bostelm: Created page with "REDIRECT Scheduler Module settings and parameters"

REDIRECT [[Scheduler Module settings and parameters]]

Scheduler module

2016-06-20T22:56:03Z

Bostelm: /* Volatile slots */ volatile slots feature no longer exists

{{Infobox plugin
|type = Activity module
|entry = https://moodle.org/plugins/view.php?plugin=mod_scheduler
|tracker = http://tracker.moodle.org/browse/CONTRIB/component/10241
|discussion = https://moodle.org/mod/forum/view.php?id=7139
|maintainer = [[User:Henning Bostelmann|Henning Bostelmann]]
|float = right
}}

The '''Scheduler module''' helps you to schedule one-on-one appointments with all your students. You specify the periods during which you are available to see the students and the length of each appointment. The students then book themselves into one of the available timeslots. The module also lets you record the attendance and grade the appointment.

=Quick Start for the Moodle Scheduler=
This lesson shows you how to quickly make your ''first'' Moodle scheduler, so only the basics are described. Like any other first attempt, your first Moodle scheduler will probably be more for learning than using, but after you finished it, youll be able to choose which features you want to learn more about.

==Prerequisites==
*You must have teacher access to a Moodle course.
*Teachers and students must be enrolled in the course.
*The Moodle scheduler must be installed, since it is not part of the core Moodle package.

==Creating A Basic Scheduler==

#Click the "Turn editing on" button.
#Click the link "Add an activity or resource."
#In the box that appears, choose "Scheduler" and click the "Add" button. [[File:Scheduler01.png]]
#A web page will appear called "Adding a new Scheduler." Type in the name of the scheduler, which can be changed later.
#Scroll to the bottom of the webpage and click the "Save and display" button.
#A webpage will appear with the name of your scheduler at the top. Click the "Add slots" link. [[File:Scheduler_slots01.png]]
#A drop-down menu will appear that allows you to add repeated slots or a single slot. Click the link to add repeated slots.
#Options will appear to add time slots. For this lesson, the slots you add can be real or fictitious, for practice. All time slots must occur in the future, and the start time must be before the end time. The simplest option is to:
##Click the "Start time" menu and choose a time that is one hour from now.
##Click the "End time" menu and choose a time that is one hour after the start time.
#Scroll to the bottom of the webpage and click "Save changes."
  
After these steps, a basic scheduler will appear. To learn more, view the scheduler as a student or explore the options below.


=Scheduler Options=

==Screens==

* Teacher screens
** [[Scheduler: My Appointments|My appointments]]
** [[Scheduler: All Appointments|All Appointments]]
** [[Scheduler: Adding slots|Adding a slot or a series of slots]]
** Scheduling a student or a group of students
** Adding a student to the slot when scheduling
** Overview (release 1.9 added)
** Statistics
** [[Scheduler: Exporting schedule tables|Exports]]
** View student
*** [[Scheduler: Setting feedback|View of comments]]
*** [[Scheduler: Grading|View of appointments and grades]]

* Student screens
** [[Scheduler : Appointing|Appoint]]

==Features and Defines==

===Scheduling Modes===

The Scheduler module allows two behaviours relative to appointing, depending on configuration settings. When set to "one only", a student can propose a unique appointment. When set to "one at a time", the student may propose one appointment, and will have to wait to be seen, before being able to make a subsequent appointment.

===Slots exclusivity===

A slot may accept an unlimited number of students (say, when scheduling for open meetings), or only one (face-to-face meeting), or may be set to accept a predefined number of students.

==Moodle Module standard implementations==

===Settings===

* [[Scheduler Module settings and parameters|Scheduler Module settings]]

===Capabilities===

* [[Scheduler Module capabilities]]

===Backup/Restore===

The module performs complete backup/restore within the course context. Slots are considered as module scope information, while appointments are considered as user related data.

==Additional implementations==

===Notifications===

A notification service (by mail) sends messages to teachers and students about any unilateral change to the agreed appointment.

===Behaviour with groups===

The Scheduler Module uses the standard grouping mode of Moodle to enable or disable features related to groups scheduling. When the group mode of the module is set to "NO GROUPS", all group related adds-on are hidden. When set to "GROUPS VISIBLE" or "SEPARATE GROUPS", all group related features are enabled. For group features to be usable, students in the current course should of course be grouped (obvious).

*'''Teacher side group features'''
**A teacher can schedule on a group basis rather than on a per student basis. When scheduling a full group, the exclusivity status of the time slot changes to fit the group size. The appointment of the group locks definitively the time slot for that group. Notifications are handled individually, just as if each student had made the appointment.

*'''Student side group features'''
**A student can schedule an appointment for one of the groups he belongs to. When choosing this option, he will make the appointment for all colleagues in the group, locking the slot exclusively at that number of users. In order for a student to schedule a group, he will have to belong to at least one group in the course. In the special case where he belongs to several groups and he wishes to make an appointment within a group, he will not be able to make the appointment until he has been seen (one-at-a-time setting) or at all (only-one-time setting).

==Links==
* [https://moodle.org/mod/forum/view.php?id=7139 Scheduler module forum]
* [https://moodle.org/plugins/view.php?plugin=mod_scheduler Plug-in database entry for Scheduler module]

[[Category:Scheduler]]

[[es:Módulo agendador]]
[[fr:Rendez-Vous]]

Scheduler: Exporting schedule tables

2016-06-20T22:47:45Z

Bostelm: Expanding the page for Scheduler 3.1

[[Scheduler module|Return to Schedule module page]]

[[Image:exports_EN.jpg|right|Scheduler export screen]]

In a [[Scheduler module|scheduler]], teachers can export appointment data to spreadsheets and other files in several formats. This feature can also be used to print lists of appointments or sign-up sheets.

== Options for exports ==

Layout and format of the export files can be customized using various options. If you're unsure what the effect of these are, try the "Preview" button at the bottom of the form.

=== Format ===

There are three basic choices for the export format, differing in how slots with several appointments are handled.

;One line per slot
The output file will contain one line for each slot. If a slot contains multiple appointments, then instead of the student's name, etc., a marker "(multiple)" will be shown.

;One line per appointment
The output file will contain one line for each appointment. If a slot contains multiple appointments, then it will appear several times in the list (with its data repeated).

;Appointments grouped by slot
All appointments of one slot are grouped together, preceded by a header line that indicates the slot in question. This may not work well with the CSV output file format, as the number of columns is not constant.

=== Teacher selection ===

; Include slots for...
Select whether slots for all teachers or only for the current teacher should be included.

; Pagination
The output can optionally be formatted with a separate "page" for each teacher. In Excel and in ODS file format, these "pages" correspond to tabs (worksheets) in the workbook. In PDF format, they correspond to pages in the PDF document. HTML and CSV files do not support actual pagination, but will display a heading before each teacher's slots.

=== Include empty slots ===

Select whether empty slots (which no student has booked yet) should be included.

=== Data to include ===

Teachers can select which data fields should be included in each row of the export, including slots-related data (date, time, location, ...), student-related data (name, username, ...) and appointment-related data (whether attended, and any appointment notes). Note that formatting will be stripped from appointment notes on export.

=== File format ===
Scheduler supports the following output file formats:

* Comma Separated Value (CSV) text files. The field separator, by default a comma, can be customized. CSV files can be opened in most spreadshet applications.
* Microsoft Excel files (Excel 2007 .xslx format)
* Open Document spreadsheets (ODS), suitable for OpenOffice / LibreOffice
* HTML format. The output will be displayed as a web page containing a table. This page can then be saved, or printed using the browser's print feature.
* PDF documents. A choice between landscape and portrait formats is available.

[[Category:Scheduler]]

[[es:Agendador: Exportar tablas de agenda]]

File:exports EN.jpg

2016-06-20T22:11:35Z

Bostelm: Bostelm uploaded a new version of File:exports EN.jpg

mod/scheduler/export

2016-06-20T21:57:16Z

Bostelm: Redirected page to Scheduler: Exporting schedule tables

#REDIRECT [[Scheduler: Exporting schedule tables]]

Capabilities/mod/scheduler:viewslots

2016-06-20T21:36:10Z

Bostelm: Redirected page to Scheduler Module capabilities#mod/scheduler:viewslots

#REDIRECT [[Scheduler Module capabilities#mod/scheduler:viewslots]]

Capabilities/mod/scheduler:viewfullslots

2016-06-20T21:34:49Z

Bostelm: Redirected page to Scheduler Module capabilities#mod/scheduler:viewfullslots

#REDIRECT [[Scheduler Module capabilities#mod/scheduler:viewfullslots]]

Capabilities/mod/scheduler:seeoverviewoutsideactivity

2016-06-20T21:34:20Z

Bostelm: Redirected page to Scheduler Module capabilities#mod/scheduler:seeoverviewoutsideactivity

#REDIRECT [[Scheduler Module capabilities#mod/scheduler:seeoverviewoutsideactivity]]

Capabilities/mod/scheduler:seeotherstudentsresults

2016-06-20T21:33:58Z

Bostelm: Redirected page to Scheduler Module capabilities#mod/scheduler:seeotherstudentsresults

#REDIRECT [[Scheduler Module capabilities#mod/scheduler:seeotherstudentsresults]]