Reviewed version for over 2.0.
Valery Fremaux 2008
With additions of Tomaz Murasz till 2013

USING THE Flashcard Activity
-----------------------------

1. Unzip the archive and read this file

2. Make a new directory called flashcard in your
modules directory. Put the files from this zip
into that directory.

3. Visit the admin page and your module should be
noticed and registered as a new entry in the
table "modules". This will also update the
tables for the matching questions.

4. Go into the quiz module and make some matching
questions.

5. Create a new flashcard activity. Select the
matching quiz question you want to use for importing.
Force import when creating.

Major features
--------------

Now flashcard is completely autonomous module, except when importing a first set
of questions. As the flashcard module do provide in this version a complete editor for
questions/answer couples, there is no absolute need to use a matching question.

The flashcard implements two play modes :

- Freeplay mode :

The users can use a single deck and rotate into cards for helping getting answers in memory.
This mode is similar to the old version (Gustav Delius') of flashcard. There is no instance
memory of what is done in the deck.

The freeplay can be disabled by configuration.

- Leitner play mode

The users may use 2, 3 or 4 decks with a schedule for review that is calculated automatically.
The cards will propagate from most difficult decks to easier decks, as good answers are checked
in by the users. The cards may backpropagate if "autodowngrade" mode is enabled and the review is not
performed in required time.

-- Summaries

Teachers now can access a summary of the game, to check user's assiduity and lateness.

Card management and multimedia aspects
-------------------------------------

Cards are edited as a set of quesion/answer couples. Question and answers can be flipped so
that questions are used as answers and answers as questions.

Any question or answer can be set a media mode. This flashcard version supports text cards,
but also image cards and sound cards. For using images or sounds, just upload necessary files
where the file chooser will suggest it (you'll find a file chooser for each non text media
input in the card editor). Then let the file name as it returns from the file chooser.

Handling manually file names could files be shared in the same course scope.

The flashcard can thus be used to construct :

Text -> Text
Text -> Image
Image -> Text
Image -> Image
Sound -> Image
Image -> Sound
Text -> Sound
Sound -> Text
Sound -> Sound

quizzes.

Adds-on to the new design : flashcard "by instance" customization
------------------------------------------------------------------

Flashcard intance can have card backgrounds and faces customized by uploading
some images in the settings of your instance. Additionaly you have provision
to add additional CSS rules to adjust the layout of the card presentation.

This version maturity (2013101100)
----------------------

This version disontinues the previous way of handling media files and customisation
images, with more strict use of the Moodle file system. We DO NOT plan at the moment to provide
any cross upgrading script from the previous published version as a standard uprader, specially
handling diverging work about using media files.

In addition, this version now fully handles course completion requirements, and completes
properly summary and course overviews.