Note: You are currently viewing documentation for Moodle 3.7. Up-to-date documentation for the latest stable version of Moodle may be available here: Attendance activity.

Attendance activity: Difference between revisions

From MoodleDocs
m (update links to block repo (renamed to use standard convention))
 
(15 intermediate revisions by 7 users not shown)
Line 1: Line 1:
== Quick update, July 2013 ==
{{Infobox plugin
|type = Activity module and optional block
|entry = https://moodle.org/plugins/browse.php?list=set&id=36
|tracker = https://github.com/danmarsden/moodle-mod_attendance/issues
|discussion = https://moodle.org/mod/forum/view.php?id=741
|maintainer = [[User:Dan Marsden|Dan Marsden]]
|float = right
}}


# [https://moodle.org/mod/forum/discuss.php?d=228684#p997183 Artem Andreev] is no longer working on this plugin, [https://moodle.org/mod/forum/discuss.php?d=228684#p1006980 Dan Marsden] is now maintaining the plugin.
==About the Attendance activity==
# The old module was previously named 'attforblock' and has now been renamed to 'attendance'
# at this stage no restore code has been written to allow backup files with old style "attforblock" to be restored into the renamed module.
#See the [http://moodle.org/mod/forum/view.php?id=741 Attendance module forum] for discussion and support on this module.
#Location on GIT of the recent versions: [http://github.com/danmarsden/moodle-mod_attendance Attendance module], [http://github.com/danmarsden/moodle-block_attendance Attendance block]


===Introduction===
The '''Attendance activity''' is designed for ''teachers to be able to take attendance'' during class, and for ''students to be able to view their own attendance record''.
The '''Attendance''' [[Module|module]] is designed for ''teachers to be able take attendance'' during class, and for ''students to be able to view their own attendance record''.


A teacher can mark the attendance status of a student as "Present", "Absent", "Late", or "Excused". These status descriptions are configurable, and more can be added. The teacher adds Attendance as an activity of a course, and then sets up the sessions whose attendance is to be tracked.
A teacher can mark the attendance status of a student as "Present", "Absent", "Late", or "Excused". These status descriptions are configurable, and more can be added. The teacher adds Attendance as an activity of a course, and then sets up the sessions for which attendance is to be tracked.


The Attendance module can generate reports for either the entire class or for individual students. Students may also see their own attendance record if the activity is not hidden.
The Attendance activity can generate reports for either the entire class or for individual students. Students may also see their own attendance record if the activity is not hidden.


The optional [[Attendance_block|Attendance block]] allows teachers quick access to the Attendance functionality, and allows students quick access to a summary report for their own attendance. (A [[Block|block]] is a user interface element that can be added to Moodle screens.)
The optional Attendance block allows teachers quick access to the Attendance functionality, and allows students quick access to a summary report for their own attendance.


=== History ===
==Adding an Attendance activity==


Attendance was originally a Moodle [[Block|block]] developed by Russell Jungwirth in 2003 (see post [http://moodle.org/mod/forum/discuss.php?d=2431]). In 2005, [http://moodle.org/user/view.php?id=18237 Dmitry Pupinin] picked up the reins and released version 1.0.2, his first version of the Attendance block (see post [http://moodle.org/mod/forum/discuss.php?d=33132#p158189]). In May 2007, Dmitry released a new version 2.0 suitable for Moodle 1.8. This release was a dramatic restructuring of code that resulted in a significant [[Module|module]] along with a small block (see post [http://moodle.org/mod/forum/discuss.php?d=71597]). Dmitry continued to develop the module and block through 2010.
An Attendance activity can be added to a course in the same way as any other activity:


In November 2010, [http://moodle.org/user/profile.php?id=52322 Artem Andreev] updated the code to version 2.2 (see post [http://moodle.org/mod/forum/discuss.php?d=162960]) to add common and group session options and some user interface improvements. [http://moodle.org/user/view.php?id=1281787&course=5 Luis Ramón López] wrote modifications that added the ability to create multiple attendance instances in a single course; for example, one instance for laboratory activities and another instance for lecture periods (see post [http://moodle.org/mod/forum/discuss.php?d=162960#p724169]). Version 2.3 was released in January 2011. <!-- What is this version about, then? Why is it given alongside another version in the table in section Branches below? -->
# Turn editing on
# Click 'Add an activity or resource'
# Select Attendance


Immediately after the release of version 2.3, work began on porting the code to Moodle 2.x. In July 2011, Artem released Attendance version 2.4.0 (see post [http://moodle.org/mod/forum/discuss.php?d=181299]), a rewrite of the code as a [[Module|module]] with an optional [[Block|block]] for use with Moodle 2.x only. In July 2012, Artem released a new branch of version 2.4.0 updated to work with Moodle 2.3.
Note that you may now add as many Attendance instances as you like, and that each instance may have multiple sections. Be sure to give the instance a name that indicates what it will be used for; for example, "Lecture Attendance". If you will be using groups in your course, set the Group mode accordingly, because even if groups exist in the course, you will not be able to use them within the Attendance activity if you select ''No groups''.
 
In July 2013 Dan Marsden took over maintenance of the plugin and renamed the "attforblock" module to "attendance"
 
There is another unrelated attendance plugin in the plugins database: https://moodle.org/plugins/view.php?plugin=mod_attendanceregister
 
== Latest Branches ==
 
This is the latest code available for 2.4 and higher and uses the renamed module now called "attendance" - for information on the older "attforblock" module see the "OLD branches" details below.
 
{| class="wikitable"
|-
! Moodle version
! the module
! the block
|-
| Moodle v2.4/2.5
| [https://github.com/danmarsden/moodle-mod_attendance/archive/master.zip Moodle24/25]
| [http://github.com/danmarsden/moodle-block_attendance/zipball/master Moodle24/25 block]
|}
=== For developers ===
 
The current version of the Attendance block and the Attendance module are hosted on Dan Marsden's github site.
 
{| class="wikitable"
|-
! Moodle version
! Module
! Block
|-
| Moodle 2.4/2.5
| [https://github.com/danmarsden/moodle-mod_attendance/tree/master https://github.com/danmarsden/moodle-mod_attendance/tree/master]
| [http://github.com/danmarsden/moodle-block_attendance/tree/master http://github.com/danmarsden/moodle-block_attendance/tree/master]
|}
 
== OLD Branches ==
 
There are currently four branches of the older attforblock Attendance code available at http://github.com/danmarsden/moodle_mod_attforblock_old for the Attendance module,
 
{| class="wikitable"
|-
! Moodle version
! the module (attforblock)
! the block (attendance)
|-
| Moodle v1.9
| [http://github.com/danmarsden/moodle_mod_attforblock_old/zipball/MDL_19 MDL_19 mod]
| [http://github.com/danmarsden/moodle-block_attendance/zipball/MDL_19 MDL_19 block]
|-
| Moodle v1.9 (v2.3 of Attendance)
| [http://github.com/danmarsden/moodle_mod_attforblock_old/tree/v2.3 v2.3]
| [http://github.com/danmarsden/moodle-block_attendance/tree/v2.3 v2.3]
|-
| Moodle v2.0 to v2.2
| [http://github.com/danmarsden/moodle_mod_attforblock_old/zipball/MDL_20 MDL_20 mod]
| [http://github.com/danmarsden/moodle-block_attendance/zipball/MDL_20 MDL_20 block]
|-
| Moodle v2.3
| [http://github.com/danmarsden/moodle_mod_attforblock_old/zipball/MDL_23 MDL_23 mod]
| [http://github.com/danmarsden/moodle-block_attendance/zipball/MDL_20 MDL_20 block]
|-
| Moodle v2.4
| [https://github.com/danmarsden/moodle_mod_attforblock_old/archive/MDL_24.zip MDL_24 mod]
| [http://github.com/danmarsden/moodle-block_attendance/zipball/MDL_20 MDL_20 block]
|}
 
=== For developers (old attforblock code)===
 
The four branches of the '''Attendance module''' are available at:
 
{| class="wikitable"
|-
! Moodle version
! the github branch
|-
| Moodle 1.9
| [http://github.com/danmarsden/moodle_mod_attforblock_old/tree/MDL_19 http://github.com/danmarsden/moodle_mod_attforblock_old/tree/MDL_19]
|-
| Moodle 1.9 (v2.3 of Attendance)
| [http://github.com/danmarsden/moodle_mod_attforblock_old/tree/v2.3 http://github.com/danmarsden/moodle_mod_attforblock_old/tree/v2.3]
|-
| Moodle 2.0 to 2.2
| [http://github.com/danmarsden/moodle_mod_attforblock_old/tree/MDL_20 http://github.com/danmarsden/moodle_mod_attforblock_old/tree/MDL_20]
|-
| Moodle 2.3
| [http://github.com/danmarsden/moodle_mod_attforblock_old/tree/MDL_23 http://github.com/danmarsden/moodle_mod_attforblock_old/tree/MDL_23]
|-
| Moodle 2.4
| [https://github.com/danmarsden/moodle_mod_attforblock_old/tree/MDL_24 https://github.com/danmarsden/moodle_mod_attforblock_old/tree/MDL_24]
|}
 
The three branches of the '''Attendance block''' are available at:
 
{| class="wikitable"
|-
! Moodle version
! the github branch
|-
| Moodle 1.9
| [http://github.com/danmarsden/moodle-block_attendance/tree/MDL_19 http://github.com/danmarsden/moodle-block_attendance/tree/MDL_19]
|-
| Moodle 1.9 (v2.3 of Attendance)
| [http://github.com/danmarsden/moodle-block_attendance/tree/v2.3 http://github.com/danmarsden/moodle-block_attendance/tree/v2.3]
|-
| Moodle 2.0 to 2.3
| [http://github.com/danmarsden/moodle-block_attendance/tree/MDL_20 http://github.com/danmarsden/moodle-block_attendance/tree/MDL_20]
|}
 
== Upgrade from mod_attforblock to new mod_attendance ==
The new attendance module renames the attforblock module to attendance - when this module was first created you couldn't have a Module with the same name as a block - newer versions of Moodle allow this and in preparation for inclusion in the moodle.org plugins database we renamed "attforblock" to "attendance" - we have included some code to convert your old "attforblock" database entries to use the new "attendance" format.
# make sure you are running the latest attforblock code - the new attendance module will only allow upgrades from attforblock version 2012120700
# Download the new attendance module and install it in the usual place (in a folder called mod/attendance)
# remove the old "mod/attforblock" folder from your site (don't use the uninstall function in the admin menu unless you don't need to keep previously created attendance modules in your courses)
# Trigger the normal upgrade process by visiting admin > notifications and it will migrate the data from your old attforblock module to the newly named "attendance" module
 
=== Upgrade info for Developers/Admins ===
The rename of the module only changes one of the database table names - attforblock to attendance, all the other tables are already prefixed with 'attendance' so these aren't changed. The Moodle install process hits install.xml first which is a problem as it will fail as some of the tables listed in install.xml already exist. To work around this we abuse the mod/attendance/version.php file a bit. This file is included first when checking for upgrades so we do a check there to see if data from the old mod_attforblock still exists - it it does it renames the old 'attforblock' table to 'attendance' amd updates the record in the modules to rename it from 'attforblock' to 'attendance' - it also checks to make sure the old 'attforblock' directory has been deleted and will only upgrade from attforblock versions higher than 2012120700 - it's possible this could be improved, pull requests are welcome. After the upgrade has completed you may want to remove the upgrade code from version.php as it will result in an extra few db queries every time the version.php files are loaded to avoid the small unnecessary performance impact that the code causes.
 
== Installation ==
 
First, make sure you're familiar with page [[Installing contributed modules or plugins]].
 
The installation can only be performed by a user who has both write access to the file structure on the computer hosting Moodle and administrator rights for the Moodle installation.
 
=== The module ===
 
* Log into the computer that hosts your Moodle installation.
* Download the Attendance ''module'' zip file appropriate for your Moodle version, as linked to from the table in section "Branches" above, and unzip it.
* This should result in a directory with a name like '''<code>andreev-artem-moodle_mod_attforblock-175cd46</code>'''. Rename it to '''<code>attforblock</code>'''.
* Move the downloaded, unzipped, and renamed directory '''<code>attforblock</code>''' to ''your Moodle installation directory'''''<code>/mod</code>''', resulting in directory ''your Moodle installation directory'''''<code>/mod/attforblock</code>'''.
** On a Linux system, assuming you've installed Moodle in the standard location, that directory should be '''<code>/var/www/html/moodle/mod/attforblock</code>'''.
** Note: if you are upgrading from an earlier version of the module, first delete the old version by opening the Moodle page in your browser, logging in as an administrator, going to ''Settings &gt; Site administration &gt; Plugins &gt; Activity Modules &gt; Manage Activities'', then pressing the ''delete'' link next to the name "attforblock".
* Change the ownership and read/write/execute privileges of the directory's files to match the rest of your Moodle installation's files.
** On a Linux system, you can do this in the following way:
*** Check the owner and group of the other files by commanding '''<code>ls -l /var/www/html/moodle</code>'''.
*** Command '''<code>sudo chown -R</code>'' '''user'''''<code>:</code>'''''group'' '''<code>/var/www/html/moodle/mod/attforblock</code>''', where ''user'' and ''group'' are the same as for the other files of the Moodle installation.
 
=== The block (optional) ===
 
* Download the Attendance ''block'' zip file appropriate for your Moodle version, as given in the table in section "Branches" above, and unzip it.
* This should result in a directory with a name like '''<code>andreev-artem-moodle_mod_attforblock-175cd46</code>'''. Rename it to '''<code>attendance</code>'''.
* Move the downloaded, unzipped, and renamed directory '''<code>attendance</code>''' to ''your Moodle installation directory'''''<code>/blocks</code>''', resulting in directory ''your Moodle installation directory'''''<code>/blocks/attendance</code>'''. (If you already have such a directory when starting the installation, delete it first, or rather, rename it to keep it around for safety.)
* As with the module, change the ownership and read/write/execute privileges of the directory's files to match the rest of your Moodle installation's files.
 
=== Completing the installation ===
 
* In your browser, open the Moodle page, and log in as the administrator. You will be asked to complete the installation of the module (and the block, too, if you followed the instructions above for installing it). If you don't see a notification to this effect immediately, go to ''Settings &gt; Site administration &gt; Notifications''. You should now see a screen that indicates that you have installed a new plugin, and has an ''Update'' button. Click that button, and Moodle updates its database structure to complete the installation. After this, the Attendance module is ready for use.
 
=== Language files ===
 
The ''language files'' for localizing the module are '''<code>.../attforblock/lang/</code>'''''language code'''''<code>/attforblock.php</code>'''. In order to customize the strings, you can
* either edit the language file(s) of the language(s) you're interested in, or
* edit the string definitions through Moodle itself when logged in as an administrator, via ''Settings &gt; Site administration &gt; Language &gt; Language customization''. '''(Note: this method doesn't seem to work as of 4 Aug. 2012)'''
 
Note that the '''date format''' is controlled by the language file you install. As an example, assume that you're using the '''<code>en_us</code>''' language file, which defines the date format as m.d.y.  In order to change the format to m/d/y, you could use the first method mentioned above, and edit the language definition file '''<code>.../attforblock/lang/en_us/attforblock.php</code>''' and change the string definitions into this:
 
$string['strftimedm'] = '%m/%d';
$string['strftimedmy'] = '%m/%d/%Y';
$string['strftimedmyw'] = '%m/%d/%y&nbsp;(%a)';
$string['strftimeshortdate'] = '%m/%d/%Y';
$string['strftimedmyhm'] = '%m/%d/%Y %H:%M'; // line added to allow multiple sessions in the same day
 
Another example: if you're using the '''<code>en</code>''' language file, and want to change the sting "Late" to "Tardy", you could use the second method mentioned above, namely: '''(Note: this method doesn't seem to work as of 4 Aug. 2012)'''
* log in as an administrator;
* click ''Settings &gt; Site administration &gt; Language &gt; Language customization'';
* choose "English (en)" from the pull-down menu, which is shown if more than one language pack has been installed;
* click on the ''Open language pack for editing'' button;
* after the language pack has been loaded, click on the ''Continue'' button;
* in the "Filter strings" screen's component list, scroll down to the bolded "mod" heading, and then click on the "attforblock.php" line under it;
** (note: you could also reduce the number of strings shown, for example by writing "Late" in the "Only strings containing" filter input line)
* click on the ''Show strings'' button;
* scroll down until you find the string ''Lfull'', whose definition is "Late";
* write "Tardy" in the edit box to the right;
* (you might also want to change the definition of the string ''Lacronym'' from "L" to "T";)
* click on the ''Save changes to the language pack'' button on the bottom of the screen; and
* in the confirmation screen, click on the ''Continue'' button.
 
== Teacher's usage instructions ==
 
=== Adding an Attendance Activity instance ===
 
After the attendance module has been properly installed, the teacher must add Attendance as an activity to each course they wish to keep attendance for. This is done by first ensuring that you are in the edit mode and then selecting "Add an activity or resource" in a Moodle [[Course_sections|section]] box. Note that you may now add as many instances of the Attendance module as you like, and that each instance may have multiple sections. Be sure to give the instance a name that indicates what it will be used for; for example, "Lecture Attendance". If you will be using groups in your course, set the Group mode accordingly, because even if groups exist in the course, you will not be able to use them within the Attendance module if you select ''No groups''.


Once you have added an attendance instance, you are ready to start taking attendance during classes.
Once you have added an attendance instance, you are ready to start taking attendance during classes.


=== Adding an Attendance block to a course page ===
== Setting Attendance categories and grading options==
 
For a shortcut to attendance information for both teachers and students, it is recommended that you install the associated [[Attendance_block|Attendance block]] (see the installation instructions above). If you have done so, you also need to add the Attendance block to your course page, like this:
 
* Turn editing on.
* Find the block entitled "Add a block."
* In the drop-down menu in this block, select ''Attendance'' to add the Attendance block.
* As always, move the block to fit your viewing preference.
 
=== Setting Attendance categories and grading options ===


Now it is time to set your attendance options. Select your attendance activity and you will see a bar of options, the last of which is "Settings." Select "Settings" and you are presented with acronyms, attendance status descriptions, and grade (points) to assign. By default, the status descriptions are "Present", "Absent", "Late", and "Excused".
Now it is time to set your attendance options. Select your attendance activity and you will see a bar of tabs, the last of which is "Settings." Select "Status set" and you are presented with acronyms, attendance status descriptions, and grade (points) to assign. By default, the status descriptions are "Present", "Absent", "Late", and "Excused".


You may prefer to change the descriptions (for example, by changing "Late" to "Tardy"), change the way points are counted, or add new status descriptions. To do the latter, fill in the fifth line and click the ''Add'' button. Important: when you hit the ''Add'' button, any changes made to existing options that were made after the last time the ''Update'' button was used will be lost. Likewise, when you hit the ''Update'' button, any changes made to the ''Add'' after the last time the ''Add'' button was hit will be lost.
You may prefer to change the descriptions (for example, by changing "Late" to "Tardy"), change the way points are counted, or add new status descriptions. To do the latter, fill in the fifth line and click the ''Add'' button. Important: when you hit the ''Add'' button, any changes made to existing options that were made after the last time the ''Update'' button was used will be lost. Likewise, when you hit the ''Update'' button, any changes made to the ''Add'' after the last time the ''Add'' button was used will be lost.


Finally, when you are done changing items on this page, be sure to click the ''Update'' button to register the changes.
Finally, when you are done changing items on this page, be sure to click the ''Update'' button to register the changes.


=== Adding sessions ===
== Adding sessions ==


Next, it is time to add sessions. To add class sections, click the ''Add'' tab (second from left) at the top of the Attendance page. Alternatively, you can click the ''Add'' button from the Attendance block (if you've installed it) to directly navigate to the page for adding sessions. If you chose "No groups", or have not defined groups, then the Session type will be forced to "Common." If you have defined groups and have chosen to use them in your course's Attendance activity, then you will have the option to create sessions for a group or all students.
Next, it is time to add sessions. To add class sections, click the ''Add session'' tab (second from left) at the top of the Attendance page. Alternatively, you can click the ''Add'' button from the Attendance block (if you've installed it) to directly navigate to the page for adding sessions. If you chose "No groups", or have not defined groups, then the Session type will be forced to "Common." If you have defined groups and have chosen to use them in your course's Attendance activity, then you will have the option to create sessions for a group or all students.


You have two options for adding sessions, adding a single session or adding multiple sessions. The single session is self-explanatory as well as time-consuming to use when you have many class sessions, so we will go straight to the more useful option.
You have two options for adding sessions: adding a single session or adding multiple sessions. The single session is self-explanatory as well as time-consuming to use when you have many class sessions, so we will go straight to the more useful option.


Check the ''Create multiple sessions'' button. Select the date and time for the first session you wish to add, followed by the duration of the session. Then, enter the date for the last session you wish to add. Since most classes do not meet seven days a week, select the checkboxes for days the class meets. The final option, frequency, may look confusing but it is actually straightforward: if your class meets every week, as is typical, then you want a frequency of 1 week, which is the default. If your class meets every other week, then select a frequency of 2 weeks, and so on. If you wish, you may type a description for the sessions you are creating. If you leave the description field blank, it will default to "Regular class session". Finally, click the ''Add multiple sessions'' button to create your sessions. You will see a message confirming this.
Check the ''Create multiple sessions'' button. Select the date and time for the first session you wish to add, followed by the duration of the session. Then, enter the date for the last session you wish to add. Since most classes do not meet seven days a week, select the checkboxes for days the class meets. The final option, frequency, may look confusing but it is actually straightforward: if your class meets every week, as is typical, then you want a frequency of 1 week, which is the default. If your class meets every other week, then select a frequency of 2 weeks, and so on. If you wish, you may type a description for the sessions you are creating. If you leave the description field blank, it will default to "Regular class session". Finally, click the ''Add multiple sessions'' button to create your sessions. You will see a message confirming this.


=== Editing sessions ===
== Editing sessions ==


Click on the ''Attendance'' tab. <!-- Attendance tab of what page? --> Here, you will see the list of all attendance sessions you have added. You can delete an individual session by clicking the X on the session rectangle's right-hand side. Alternatively, you can check the checkboxes of each session you wish to delete, and then choose "Delete" from the pull-down menu at the bottom right-hand corner of the page to delete all the selected sessions.
Click on the ''Attendance'' tab. <!-- Attendance tab of what page? --> Here, you will see the list of all attendance sessions you have added. You can delete an individual session by clicking the X on the session rectangle's right-hand side. Alternatively, you can check the checkboxes of each session you wish to delete, and then choose "Delete" from the drop-down menu at the bottom right-hand corner of the page to delete all the selected sessions.


You can edit a session &mdash; for example, to change its date or description &mdash; by clicking the hand icon on the session rectangle's right-hand side.
You can edit a session &mdash; for example, to change its date or description &mdash; by clicking the hand icon on the session rectangle's right-hand side.


=== Taking attendance ===
== Taking attendance ==


Finally, we get to using the module for its intended purpose. You can take attendance for a session by clicking on the green radio button on the session rectangle's right-hand side. Those sessions whose attendance has already been taken do not have the green button. However, the description is a link that takes you to a screen for modifying the attendance record for that session.
Finally, we get to using the activity for its intended purpose. You can take attendance for a session by clicking on the green radio button on the session rectangle's right-hand side. Those sessions for which attendance has already been taken, do not have the green button. However, the description is a link that takes you to a screen for modifying the attendance record for that session.


Note that when taking attendance, the column headings for attendance status are links. If you click one of these column headings, all students will have their status changed to the status you selected. Thus, if everyone is present, you can merely click the ''P'' column header to change everyone's status to "Present". If only one person is absent, you could first click ''P'' to set everyone's status to "Present", and then set the absent student's status to "Absent".
Note that when taking attendance, the column headings for attendance status are links. If you click one of these column headings, all students will have their status changed to the status you selected. Thus, if everyone is present, you can merely click the ''P'' column header to change everyone's status to "Present". If only one person is absent, you could first click ''P'' to set everyone's status to "Present", and then set the absent student's status to "Absent".
Line 246: Line 60:
Enter remarks as appropriate &mdash; for example, the reason for an absence if known, or the number of minutes a student was late &mdash; and click the ''OK'' button to record the information.
Enter remarks as appropriate &mdash; for example, the reason for an absence if known, or the number of minutes a student was late &mdash; and click the ''OK'' button to record the information.


=== Reports ===
 
=== Self-recording attendance ===
 
Students can also record their own attendance if you configure it in the settings. Each session is assigned a unique password, and you can display this password to students to allow them mark themselves as present.
<gallery>
SelfRecordingAttendance.png|Key icon to display password to students
</gallery>
In addition, you can display a QR code containing a URL that students can scan with a mobile device, which brings them directly to the page where they record their attendance, and fills in the password for them too. Then they only need to select the status "Present", and record their attendance. In this case, the remarks contain the text "Self-recorded".
<gallery>
PasswordQRCode.png|Display password and QR code to students
</gallery>
 
== Reports ==


You can generate attendance reports on sessions:
You can generate attendance reports on sessions:
Line 256: Line 82:
* Your browser will now probably ask you to either display or save the file.
* Your browser will now probably ask you to either display or save the file.


One teacher's style of using the Attendance module, useful in those (probably frequent) situations where there's no access to Moodle in the classroom, is to first take attendance on paper, and then to transfer the information to Moodle later. To ease this task, one can print a monthly report before the start of the month and use the printout for recording attendance during class. This method has the added advantage of having a picture on the printed report for each student who has uploaded their photo to Moodle.  '''(as of 4 Aug. 2012, can't see this feature working)'''
One teacher's style of using the Attendance module, useful in those (probably frequent) situations where there's no access to Moodle in the classroom, is first to take attendance on paper, and then to transfer the information to Moodle later. To ease this task, one can print a monthly report before the start of the month and use the printout for recording attendance during class. This method has the added advantage of having a picture on the printed report for each student who has uploaded their photo to Moodle.  '''(as of 4 Aug. 2012, can't see this feature working)'''
 
== Discuss the module ==
 
If you have an idea about new features, or need support on using the module, participate in the discussion on the [http://moodle.org/mod/forum/view.php?f=125 Attendance module forum].
 
== See also ==
 
* [http://moodle.org/mod/forum/view.php?id=741 Attendance module forum]
* [[Attendance block]]
* [[Git for Administrators]]


[[Category:Contributed code]]
== FAQ ==
[[Category:Teacher]]
Why do some use users appear in red and across all groups even though only one group is selected?
Check your temporary users. Usually such users are created either by design or accident as temporary users and may appear as described. If unwanted, just delete these temporary users and you shouldn't have this problem anymore.


[[es:Actividad de asistencia]]
[[ja:出欠]]
[[ja:出欠]]

Latest revision as of 18:05, 21 October 2018

About the Attendance activity

The Attendance activity is designed for teachers to be able to take attendance during class, and for students to be able to view their own attendance record.

A teacher can mark the attendance status of a student as "Present", "Absent", "Late", or "Excused". These status descriptions are configurable, and more can be added. The teacher adds Attendance as an activity of a course, and then sets up the sessions for which attendance is to be tracked.

The Attendance activity can generate reports for either the entire class or for individual students. Students may also see their own attendance record if the activity is not hidden.

The optional Attendance block allows teachers quick access to the Attendance functionality, and allows students quick access to a summary report for their own attendance.

Adding an Attendance activity

An Attendance activity can be added to a course in the same way as any other activity:

  1. Turn editing on
  2. Click 'Add an activity or resource'
  3. Select Attendance

Note that you may now add as many Attendance instances as you like, and that each instance may have multiple sections. Be sure to give the instance a name that indicates what it will be used for; for example, "Lecture Attendance". If you will be using groups in your course, set the Group mode accordingly, because even if groups exist in the course, you will not be able to use them within the Attendance activity if you select No groups.

Once you have added an attendance instance, you are ready to start taking attendance during classes.

Setting Attendance categories and grading options

Now it is time to set your attendance options. Select your attendance activity and you will see a bar of tabs, the last of which is "Settings." Select "Status set" and you are presented with acronyms, attendance status descriptions, and grade (points) to assign. By default, the status descriptions are "Present", "Absent", "Late", and "Excused".

You may prefer to change the descriptions (for example, by changing "Late" to "Tardy"), change the way points are counted, or add new status descriptions. To do the latter, fill in the fifth line and click the Add button. Important: when you hit the Add button, any changes made to existing options that were made after the last time the Update button was used will be lost. Likewise, when you hit the Update button, any changes made to the Add after the last time the Add button was used will be lost.

Finally, when you are done changing items on this page, be sure to click the Update button to register the changes.

Adding sessions

Next, it is time to add sessions. To add class sections, click the Add session tab (second from left) at the top of the Attendance page. Alternatively, you can click the Add button from the Attendance block (if you've installed it) to directly navigate to the page for adding sessions. If you chose "No groups", or have not defined groups, then the Session type will be forced to "Common." If you have defined groups and have chosen to use them in your course's Attendance activity, then you will have the option to create sessions for a group or all students.

You have two options for adding sessions: adding a single session or adding multiple sessions. The single session is self-explanatory as well as time-consuming to use when you have many class sessions, so we will go straight to the more useful option.

Check the Create multiple sessions button. Select the date and time for the first session you wish to add, followed by the duration of the session. Then, enter the date for the last session you wish to add. Since most classes do not meet seven days a week, select the checkboxes for days the class meets. The final option, frequency, may look confusing but it is actually straightforward: if your class meets every week, as is typical, then you want a frequency of 1 week, which is the default. If your class meets every other week, then select a frequency of 2 weeks, and so on. If you wish, you may type a description for the sessions you are creating. If you leave the description field blank, it will default to "Regular class session". Finally, click the Add multiple sessions button to create your sessions. You will see a message confirming this.

Editing sessions

Click on the Attendance tab. Here, you will see the list of all attendance sessions you have added. You can delete an individual session by clicking the X on the session rectangle's right-hand side. Alternatively, you can check the checkboxes of each session you wish to delete, and then choose "Delete" from the drop-down menu at the bottom right-hand corner of the page to delete all the selected sessions.

You can edit a session — for example, to change its date or description — by clicking the hand icon on the session rectangle's right-hand side.

Taking attendance

Finally, we get to using the activity for its intended purpose. You can take attendance for a session by clicking on the green radio button on the session rectangle's right-hand side. Those sessions for which attendance has already been taken, do not have the green button. However, the description is a link that takes you to a screen for modifying the attendance record for that session.

Note that when taking attendance, the column headings for attendance status are links. If you click one of these column headings, all students will have their status changed to the status you selected. Thus, if everyone is present, you can merely click the P column header to change everyone's status to "Present". If only one person is absent, you could first click P to set everyone's status to "Present", and then set the absent student's status to "Absent".

Enter remarks as appropriate — for example, the reason for an absence if known, or the number of minutes a student was late — and click the OK button to record the information.


Self-recording attendance

Students can also record their own attendance if you configure it in the settings. Each session is assigned a unique password, and you can display this password to students to allow them mark themselves as present.

In addition, you can display a QR code containing a URL that students can scan with a mobile device, which brings them directly to the page where they record their attendance, and fills in the password for them too. Then they only need to select the status "Present", and record their attendance. In this case, the remarks contain the text "Self-recorded".

Reports

You can generate attendance reports on sessions:

  • Select the Attendance activity of the course and session you're interested in.
  • Click on the Export tab near the top.
  • Change the export settings if you wish.
  • From the Format pull-down menu, select the file format you'd like to export the attendance report in.
  • Click on the OK button.
  • Your browser will now probably ask you to either display or save the file.

One teacher's style of using the Attendance module, useful in those (probably frequent) situations where there's no access to Moodle in the classroom, is first to take attendance on paper, and then to transfer the information to Moodle later. To ease this task, one can print a monthly report before the start of the month and use the printout for recording attendance during class. This method has the added advantage of having a picture on the printed report for each student who has uploaded their photo to Moodle. (as of 4 Aug. 2012, can't see this feature working)

FAQ

Why do some use users appear in red and across all groups even though only one group is selected? Check your temporary users. Usually such users are created either by design or accident as temporary users and may appear as described. If unwanted, just delete these temporary users and you shouldn't have this problem anymore.