Note: You are currently viewing documentation for Moodle 1.9. Up-to-date documentation for the latest stable version is available here: Stamp collection module.

Stamp collection module: Difference between revisions

From MoodleDocs
(→‎Feature ideas and requests: Stamps by students removed as it has been implemented recently)
(Rewritten Capabilities, removed implemented features from requests)
Line 16: Line 16:
The source codes live in [[CVS]] [http://cvs.moodle.org/contrib/plugins/mod/stampcoll/ contrib/plugins/mod/stampcoll]. To checkout the module, go to the Moodle mod/ directory and use:
The source codes live in [[CVS]] [http://cvs.moodle.org/contrib/plugins/mod/stampcoll/ contrib/plugins/mod/stampcoll]. To checkout the module, go to the Moodle mod/ directory and use:
  cvs -z3 -d:ext:myusername@cvs.moodle.org:/cvsroot/moodle co -d stampcoll contrib/plugins/mod/stampcoll
  cvs -z3 -d:ext:myusername@cvs.moodle.org:/cvsroot/moodle co -d stampcoll contrib/plugins/mod/stampcoll
To checkout the current stable version for Moodle 1.8:
cvs -z3 -d:ext:myusername@cvs.moodle.org:/cvsroot/moodle co -d stampcoll -r MOODLE_18_STABLE contrib/plugins/mod/stampcoll


==How to report a bug==
==How to report a bug==


Please, use [[Tracker]]. Stamp collection if one of the components in "Non-core contributed modules" project. See the list of tracked issues at http://tracker.moodle.org/browse/CONTRIB/component/10271
Please, use [[Tracker]]. Stamp collection if one of the components in "Non-core contributed modules" project. See the list of tracked issues at http://tracker.moodle.org/browse/CONTRIB/component/10271
==Capabilities==
{{Moodle 1.9}}
Roles and capabilities are supported since the version for Moodle 1.9. During the upgrade, the module settings "Publish" and "Teacher can collect stamps" are converted automatically into the role overrides.
{| cellpadding="3" cellspacing="0" border="1"
!Capability
!Description
!Status
|-
|mod/stampcoll:collectstamps
|a user can be given a stamp
|implemented in 1.9
|-
|mod/stampcoll:givestamps
|a user can give a stamp from her own pool (and the collection pool) to the other user
|partially implemented in 1.9 (the pools not supported yet)
|-
|mod/stampcoll:viewotherstamps
|a user can view stamps given to other users
|implemented in 1.9
|-
|mod/stampcoll:viewownstamps
|a user can view stamps given to her
|implemented in 1.9
|-
|mod/stampcoll:managestamps
|a user can do anything with stamps, i.e. give, remove and update them
|implemented in 1.9
|}


==Feature ideas and requests==
==Feature ideas and requests==
''Note: This section will be moved to the tracker feature reguests.''


===Stamps pools (banks?)===
===Stamps pools (banks?)===
Line 51: Line 87:
David's note: Or, keep collecting stamps by individuals but display them in per-group (or grouping?) report. Simply sum all stamps collected by student in a given group and display them.
David's note: Or, keep collecting stamps by individuals but display them in per-group (or grouping?) report. Simply sum all stamps collected by student in a given group and display them.


===See a comment attached to the stamp by hovering mouse===
Now, the comment is put into the "alt" tag of the stamp image. There is a plan to use [[overLIB]] (see e.g. the calendar of the [[Grader report]]).
==Planned capabilities==
Please discuss, as this might be very important part of the module setting.
* collect stamps - a user can be given a stamp
* give stamps to others - a user can give a stamp from her own pool (and the collection pool) to the other user
* give stamps to self - a user can give a stamp from her own pool (and the collection pool) to herself
* view own stamps - a user can view stamps given to her
* view others' stamps - a user can view stamps given to other users (user should be always allowed to view stamps given by herself)
* dtto with delete and update


==See also==
==See also==

Revision as of 13:10, 23 April 2008

By default, the module allows a teacher to give "stamps" (i.e. picture with a comment) to students so they collect these stamps. The activity can be used in many ways, such as motivative bonus marks, absence marks, certification records etc.

The module uses capabilities to declare who can e.g. collect stamps or give stamps. Therefore, student can be allowed to give stamps to other students, the stamps may be given to teachers etc. Teachers can setup the module to show all stamps to all students, to show stamps only to the individual student to whom it was awarded or to hide stamps completely.

The module was created and is currently maintained by David Mudrak.

Installation

  • Moodle 1.9 - checkout CVS HEAD or download latest development build
  • Moodle 1.8 - checkout CVS branch MOODLE_18_STABLE or download 1.8 build
  • Moodle 1.7 - is not supported nor tested. Maybe it works, maybe not. It was reported that the version for 1.6 worked in Moodle 1.7
  • Moodle 1.6 - checkout CVS branch MOODLE_16_STABLE or download 1.6 build
  • Earlier version are not supported

The source codes live in CVS contrib/plugins/mod/stampcoll. To checkout the module, go to the Moodle mod/ directory and use:

cvs -z3 -d:ext:myusername@cvs.moodle.org:/cvsroot/moodle co -d stampcoll contrib/plugins/mod/stampcoll

To checkout the current stable version for Moodle 1.8:

cvs -z3 -d:ext:myusername@cvs.moodle.org:/cvsroot/moodle co -d stampcoll -r MOODLE_18_STABLE contrib/plugins/mod/stampcoll

How to report a bug

Please, use Tracker. Stamp collection if one of the components in "Non-core contributed modules" project. See the list of tracked issues at http://tracker.moodle.org/browse/CONTRIB/component/10271

Capabilities

Moodle1.9


Roles and capabilities are supported since the version for Moodle 1.9. During the upgrade, the module settings "Publish" and "Teacher can collect stamps" are converted automatically into the role overrides.

Capability Description Status
mod/stampcoll:collectstamps a user can be given a stamp implemented in 1.9
mod/stampcoll:givestamps a user can give a stamp from her own pool (and the collection pool) to the other user partially implemented in 1.9 (the pools not supported yet)
mod/stampcoll:viewotherstamps a user can view stamps given to other users implemented in 1.9
mod/stampcoll:viewownstamps a user can view stamps given to her implemented in 1.9
mod/stampcoll:managestamps a user can do anything with stamps, i.e. give, remove and update them implemented in 1.9

Feature ideas and requests

Note: This section will be moved to the tracker feature reguests.

Stamps pools (banks?)

There might be settings of a maximum number of stamps given in one collection (so called collection pool), given by a user (personal pool) and given to a user. All these limits can be combined (logical AND). Then there might be statistics like percentual/total number given from the collection/personal pool, the number of available (unassigned, free) stamps in pools etc.

Another scenario: you have student teams. You allow team leaders to give stamp (via capability) and set a limited number of stamp they can give. Team leader can dispatch stamps from his/her pool to team members according to their contribution.

Grade based on the number of stamps collected

When the feature of maximum number of stamps that can be collected within particular collection is implemented, it is possible to compute the grade based on the number of stamps collected.

Ranking

Similar to overall feedback in the Quiz module, provide a possibility to map a number of collected stamp to a rank (letter or word "grade"). E.g. no stamps collected => Novice, 1 stamp collected => Beginner, 2 stamps collected => Advanced user, 3 stamps collected => Expert.

Forum patch

The patch adding a possibility to tie a stamp collection with a Forum module. Display similar selection box as for forum grading and allow adding stamp for a forum post.

Ajax support

Give stamps by drag and drop from the pool (bank) to a user.

Site level settings

The list of URLs to default stamp images (e.g. to some files at frontpage files section etc.)

Exports

  • text, CVS and Excel support

Group mode stamp awarding

A handy way to organize group competitions. Teachers should be able to award stamps for contributions (typically, forum posts and chat participation but other ideas are welcome too). Such stamps would be attributed not to the person who contributed but to his/her team and be accumulated by teams for later evaluation.

David's note: Or, keep collecting stamps by individuals but display them in per-group (or grouping?) report. Simply sum all stamps collected by student in a given group and display them.


See also