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
(Rewritten module introduction)
(→‎Installation: rewritten versions info)
Line 8: Line 8:
==Installation==
==Installation==


===Required Moodle versions===
* Moodle 1.9 - checkout [[CVS]] HEAD or download [http://download.moodle.org/plugins/mod/stampcoll.zip latest development build]
* Moodle 1.9 is required for the latest code in [[CVS]] HEAD
* Moodle 1.8 - checkout [[CVS]] branch MOODLE_18_STABLE or download [http://download.moodle.org/plugins18/mod/stampcoll.zip 1.8 build]
* Moodle 1.8 is required for the code from CVS branch MOODLE_18_STABLE
* 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.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 [http://download.moodle.org/plugins16/mod/stampcoll.zip 1.6 build]
* Moodle 1.6 is required for the code from CVS branch MOODLE_16_STABLE
* Earlier version are not supported
* Earlier version are not supported


===How to get===
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 latest development version built from HEAD - [http://download.moodle.org/plugins/mod/stampcoll.zip ZIP archive]
cvs -z3 -d:ext:myusername@cvs.moodle.org:/cvsroot/moodle co -d stampcoll contrib/plugins/mod/stampcoll
* The latest version built from MOODLE_18_STABLE - [http://download.moodle.org/plugins18/mod/stampcoll.zip ZIP archive]
* The latest version built from MOODLE_16_STABLE - [http://download.moodle.org/plugins16/mod/stampcoll.zip ZIP archive]
* The source codes live in [[CVS]] [http://cvs.moodle.org/contrib/plugins/mod/stampcoll/ contrib/plugins/mod/stampcoll].


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

Revision as of 00:10, 21 February 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

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

Feature ideas and requests

Stamps given by students

In current versions, only teachers are allowed to give stamps. There is a plan to implement capability to do this and this capability could be assigned to students as well. Then students can give stamps to each other, or to teachers, or both.

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