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

Attendance module: Difference between revisions

From MoodleDocs
(remove some old cruft.)
 
(32 intermediate revisions by 13 users not shown)
Line 1: Line 1:
There are two version of the '''attendance''' module: from [http://moodle.org/user/view.php?id=18237 Dmitry Pupinin] and from [http://human-logic.com/ Human Logic].
{{Infobox plugin
Both published in the Using Moodle [http://moodle.org/mod/forum/view.php?f=125 Attendance module forum].
|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
}}


At this time Dmitry's version is more stable and useful.
== Quick update, July 2013 ==


[http://moodle.org/mod/data/view.php?d=13&rid=1062 Download daily build of Dmitry's version]
# [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.
# 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]


==Installation by Moodle Administrator==
===Introduction===
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''.


To install Dmitry's version of the attendance module, follow these directions (provided by [http://moodle.org/user/view.php?id=40637&course=5 Richard Webb] in [http://moodle.org/mod/forum/discuss.php?d=79134#p436449 this post]).  Installation can only be completed by a user having write access to the file structure on the computer hosting Moodle and with administration rights for your installation of Moodle.
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.


===Language Files===
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.


Moodle has a general language folder with subfolders for installed languages, and language files within these subfolders. This structure allows Moodle to efficiently work in an unlimited variety of languages with relative ease. Every block and module in Moodle has its own language strings that must be defined in a language file with a name specified by the block or module. "In the old days" (meaning prior to Moodle 1.9) the language files for each mod or block were copied into the appropriate subfolders in the <code>moodle/lang/</code> folder. This still works, but can be tedious and is not the preferred method anymore.
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.)


Newer versions of Moodle (1.9 and up) allow you to keep the language files with the mods and blocks so they are self-contained and you don't have to do so much work with language files. Older versions of the Attendance module did not have all language files correctly placed resulting in tags that say <nowiki>[[attendance]]</nowiki>.  As of June 20, 2008, the problem has been resolved.  If you are having problems with the language files for the Attendance module, it is recommended that you download the latest version and replace your current installation as described below.
=== History ===


'''Additional Language Considerations'''
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.


You might consider editing the <code>block_attendance_for_v19/mod/attforblock/lang/en_utf8/attforblock.php</code> language file and replacing each occurrence of 'Attendances' with 'Attendance'. Some dictionaries say that attendances is the plural form of attendance while others say there is no plural form.
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? -->


Note that the '''date format''' is controlled by the language file you install. If you prefer Month/Day/Year format, for example, you will want to use the US_en language file found in the block folder.
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.


You can easily edit the date format yourself, if you so desire.  These strings show the M/D/Y format.
In July 2013 Dan Marsden took over maintenance of the plugin and renamed the "attforblock" module to "attendance"


$string['strftimedm'] = '%%m.%%d';
There is another unrelated attendance plugin in the plugins database: https://moodle.org/plugins/view.php?plugin=mod_attendanceregister
$string['strftimedmy'] = '%%m.%%d.%%Y';
$string['strftimedmyw'] = '%%m.%%d.%%y&nbsp;(%%a)';
$string['strftimeshortdate'] = '%%m.%%d.%%Y';


===Mod and Block Installation===
=== For developers ===


If you look at your Moodle installation, you will see that among the many subfolders in the Moodle folder you have folders named <code>blocks/</code> and <code>mod/</code>, matching the two folders in the <code>block_attendance_for_v19/</code> folder. Installation is completed by copying the contents of the <code>block_attendance_for_v19/blocks/</code> folder into your <code>moodle/blocks/</code> folder (so you have a <code>moodle/blocks/attendance/</code> folder with all of the files and subfolders copied as well) and likewise copying the contents of the <code>block_attendance_for_v19/mod</code> folder into your <code>moodle/mod/</code> folder.
The current version of the Attendance block and the Attendance module are hosted on Dan Marsden's github site.


Once you have completed the installation, you need to log into Moodle as the administrator and go to the admin pageThis will set up the Attendance database structure.
{| class="wikitable"
|-
! Module
! Block
|-
| [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]
|}


==Using Attendance in a Class by a Teacher==


===Adding Attendance Activity===
== 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


After the attendance block and module have been properly installed, you (the teacher) must add attendance as an activity to each course you wish to keep attendance in. This is done by first ensuring that you are in the edit mode and then selecting, "Attendance" from the "Add an activity..." pull-down menu. Note that you may only add the attendance activity once per class and it may be located in any of the section blocks. Because attendance is for the entire course, it seems logical to put it in the top box (the one that always shows).
=== 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.


Once you have added the attendance activity, you are ready to start using the attendance module. However, the section link that was just added in the preceding paragraph is the "clunky way" to work with the attendance module. In fact, it is recommended that you simply hide that link! That way students won't see it cluttering up the section block where you placed it. Of course, we DO want students to be able to view their attendance records, just not with that link. There is a second, better, way to accomplish this. Select "Attendance" from the pull-down menu in the "Blocks" block. This will create a block with teacher options to take attendance, report on attendance, or change the attendance settings.  The same block will instead have an attendance report for students.
== Installation ==


===Setting Attendance Categories and Grading Options===
First, make sure you're familiar with page [[Installing contributed modules or plugins]].


Now it is time to set your attendance options. Select "Settings" from the attendance block. This brings you to the letters, descriptions, and grade (points) to assign for the four attendance options. By default these are Present, Absent, Late, and Excused. You may prefer to change the descriptions (e.g., change the word Late to Tardy), change the order, or change the way points are counted so make appropriate changes here to the names, order, and grades.  Be sure to click the "Update" button when you are done.
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.


===Adding Sessions===
=== Language files ===


Next it is time to add sessions. Note that there is a restriction here. You can only have one session per day. Since you can only have one attendance activity installed (which means that you cannot have a lab attendance activity and a lecture attendance activity) and can only have one attendance session per day, if you have more than one class session per day you will have to be creative in taking attendance. And if you have more than seven class sessions for a single class in a week--then you are overworked!
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)'''


To add class sections, click the "Add" tab (second from left) at the top of the page (if you left the attendance page, select any of the three links from the attendance block to return to the attendance page and gain access to the "Add" tab). You have two options here, to add a single session or to add multiple sessions. The single session is self-explanatory as well as time consuming to use when you have many class sessions so I will go straight the more useful option, how to add multiple sessions.
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:


Under the "Create multiple sessions" label choose the date for the first session you wish to add followed by the date for the last session you wish to add. Next select the days of the week on which the class meets. The final option, frequency, may look confusing but it is actually straight-forward. If your class meets every week (the normal situation) then you want a frequency of 1 week which is the default. If your class meets every other week, then you want a frequency of 2 weeks, and so on. When you click the "Add multiple sessions" button, your sessions will be created and you will see a message indicating 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


===Taking Attendance===
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.


Now head to the attendance tab. Here you see the list of all attendance sessions you have added. You can delete an individual session by clicking the X to the right of it. (Personal note, it sure would be nice if there was an option to select a few sessions and delete them all at once--I use the multiple sessions option to put my sessions in for the entire semester and then have to go and remove sessions for vacation days one at a time.) You can edit a session (change the date or add a description) with the standard hand icon to the right of the session, or you can take attendance for a session by clicking the green radio button to the right of the session. Sessions where attendance has already been taken do not have the green button, but instead the description is a link that takes you to the screen to modify the attendance record for that session.
== Teacher's usage instructions ==


You will note that when taking attendance the column headings for attendance state 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 absent (God forbid!), you merely click the '''A''' and it will change everyone's status to absent. If Little Johnny is the only student absent, you would logically click '''P''' to set everyone to present and then go down to Little Johnny and change his status to '''A'''. Enter remarks as appropriate (e.g., the reason for an absence if known or the minutes late if someone is tardy) and click OK to complete taking record.
=== Adding an Attendance Activity instance ===


===Reports===
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''.


Finally, you have the reports. This is, again, obvious. One of my colleagues prefers to take record on paper and transfer it to Moodle. She suggested printing the monthly report before the start of the month and then taking record on this report. It has an added advantage because you have each student's picture with the record sheet. Of course, that is only useful for students who actually put photos of themselves in for their picture.
Once you have added an attendance instance, you are ready to start taking attendance during classes.


A final note here. If you added the attendance block as recommended, you may wonder what it looks like for students. It is completely different--showing a summary of their attendance record and having a single link for them to view the details of their personal attendance. Another reason why I think the attendance block should always be added when you use the attendance module.
=== 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|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. <!-- 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.
 
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 ===
 
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 &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 ===
 
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 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)'''
 
== 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 ==
 
* [[Git for Administrators]]


[[Category:Contributed code]]
[[Category:Contributed code]]
[[ja:出欠]]

Latest revision as of 23:50, 12 July 2015

Quick update, July 2013

  1. Artem Andreev is no longer working on this plugin, Dan Marsden is now maintaining the plugin.
  2. The old module was previously named 'attforblock' and has now been renamed to 'attendance'
  3. at this stage no restore code has been written to allow backup files with old style "attforblock" to be restored into the renamed module.
  4. See the Attendance module forum for discussion and support on this module.
  5. Location on GIT of the recent versions: Attendance module, Attendance block

Introduction

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

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.

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

For developers

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

Module Block
https://github.com/danmarsden/moodle-mod_attendance/tree/master http://github.com/danmarsden/moodle-block_attendance/tree/master


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.

  1. make sure you are running the latest attforblock code - the new attendance module will only allow upgrades from attforblock version 2012120700
  2. Download the new attendance module and install it in the usual place (in a folder called mod/attendance)
  3. 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)
  4. 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.

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:

  • 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 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)

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