Attendance activity

The Attendance 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.

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 optional 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 is a user interface element that can be added to Moodle screens.)

General

See the Attendance module forum for discussion and support on this module.

Note: the Attendance module has not been published on the Moodle Plugins page. (There is a plugin called Attendance Register available through that page, but it's something different.)

History

Attendance was originally a Moodle block developed by Russell Jungwirth in 2003 (see post [1]). In 2005, Dmitry Pupinin picked up the reins and released version 1.0.2, his first version of the Attendance block (see post [2]). 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 along with a small block (see post [3]). Dmitry continued to develop the module and block through 2010.

In November 2010, Artem Andreev updated the code to version 2.2 (see post [4]) to add common and group session options and some user interface improvements. 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 [5]). Version 2.3 was released in January 2011.

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 [6]), a rewrite of the code as a module with an optional 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.

Branches

There are currently four branches of the Attendancde code available at http://github.com/andreev-artem/moodle_mod_attforblock for the Attendance module, and three branches of the Attendance module. Users should install the latest update of the branch that matches the version number of their Moodle installation, as given in the table below.

Moodle version	the module (attforblock)	the block (attendance)
Moodle v1.9	MDL_19 mod	MDL_19 block
Moodle v1.9 (v2.3 of Attendance)	v2.3	v2.3
Moodle v2.0 to v2.2	MDL_20 mod	MDL_20 block
Moodle v2.3	MDL_23 mod	MDL_20 block

For developers

The current version of the Attendance block and the Attendance module are hosted on Artem Andreev's github site.

The four branches of the Attendance module are available at:

Moodle version	the github branch
Moodle 1.9	http://github.com/andreev-artem/moodle_mod_attforblock/tree/MDL_19
Moodle 1.9 (v2.3 of Attendance)	http://github.com/andreev-artem/moodle_mod_attforblock/tree/v2.3
Moodle 2.0 to 2.2	http://github.com/andreev-artem/moodle_mod_attforblock/tree/MDL_20
Moodle 2.3	http://github.com/andreev-artem/moodle_mod_attforblock/tree/MDL_23

The three branches of the Attendance block are available at:

Moodle version	the github branch
Moodle 1.9	http://github.com/andreev-artem/moodle_blocks_attendance/tree/MDL_19
Moodle 1.9 (v2.3 of Attendance)	http://github.com/andreev-artem/moodle_blocks_attendance/tree/v2.3
Moodle 2.0 to 2.3	http://github.com/andreev-artem/moodle_blocks_attendance/tree/MDL_20

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 andreev-artem-moodle_mod_attforblock-175cd46. Rename it to attforblock.
• Move the downloaded, unzipped, and renamed directory attforblock to your Moodle installation directory/mod, resulting in directory your Moodle installation directory/mod/attforblock.
  • On a Linux system, assuming you've installed Moodle in the standard location, that directory should be /var/www/html/moodle/mod/attforblock.
  • 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 > Site administration > Plugins > Activity Modules > 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 ls -l /var/www/html/moodle.
    • Command sudo chown -R user:group /var/www/html/moodle/mod/attforblock, 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 andreev-artem-moodle_mod_attforblock-175cd46. Rename it to attendance.
• Move the downloaded, unzipped, and renamed directory attendance to your Moodle installation directory/blocks, resulting in directory your Moodle installation directory/mod/attendance. (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 > Site administration > 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 .../attforblock/lang/language code/attforblock.php. 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 > Site administration > Language > 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 en_us 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 .../attforblock/lang/en_us/attforblock.php and change the string definitions into this:

$string['strftimedm'] = '%m/%d';
$string['strftimedmy'] = '%m/%d/%Y';
$string['strftimedmyw'] = '%m/%d/%y (%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 en 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 > Site administration > Language > 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 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.

Adding an Attendance block to a course page

For a shortcut to attendance information for both teachers and students, it is recommended that you install the associated 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".

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.

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 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 pull-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 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.

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.

Reports

You can generate attendance reports on sessions.

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.

Discuss the module

If you have an idea about new features, or need support on using the module, participate in the discussion on the Attendance module forum.

See also

• Attendance module forum
• Attendance block
• Git for Administrators