Dialog Cards papi Jo (doc)


Dialog Cards Papi Jo Version 1.9.3 January 2020


Here you will find details of the various differences between the official H5P distribution (currently version 1.7.9) of the Dialog Cards content type and the "experimental" version I developed.

1. Dialog cards editor

Added some functions to the text editor: Font size, font color (s), bulleted and numbered lists, horizontal ruler.

Add an image to the back of the card.

A card can have any of the following: no attached images at all; a front image only (which will be displayed on the front and on the back); a front image and a back image; no front image and a back image.

No front but back image feature requested on the H5P forum here: https://h5p.org/node/70099 and https://h5p.org/node/310259.

The combination of blank response text and no image for the front of the card but an image for the back is shown in the Flags and Countries example.

Added web-link support to the Text and Answer Editors as requested on the H5P forum here: https://h5p.org/node/563736

Each link will be followed by an external link icon like this: external link

Add an audio file to the back of a card (new in version 1.9.3 of January 2020)

Feature requested on the H5P forum here: https://h5p.org/node/696079

2 - Parameters

2.1 Select Mode

Free browsing is the default mode. In Match mode the user will have to pair the front and the back sides of cards. In Self Correction mode, they will be able to guess the other side of the cards and confirm if they got it correct or not.

I already introduced the Self correction mode in a pull request on the Github H5P a few years ago, but my suggestion has been replaced by the new "Repetition Mode". My own 'self-correction' mode is similar to but different from the Repeat mode of the official version.

When the Match or the Self-correction modes are selected, 2 further options become available:

2.2 Maximum score

Maximum score to be given to the user at the end of this activity. Set this field to 0 (zero) if no score is given. If a score is given, it is recorded in the user's H5P results.

2.3 Penalty percentage

Each extra round (in Self-correction mode) or each wrong match (in Match mode) will cost the user this percentage of the maximum score. Enter 0 for NO penalty. Maximum penalty is 50(%). Do NOT enter the % sign in the box.

2.4 Background colour of the maps

The background colour of the cards. The default value is transparent rgba(0, 0, 0, 0, 0, 0, 0, 0).  A colour selector is provided.

2.5 Order of cards

Select the order of the cards displayed to the user. The options are: Normal order / Random order / User choice. If "User Choice" and the user selects "Random", he will be able to choose the number of cards drawn from the card pool.

Please note that in the current official H5P Dialog Cards content, the Normal/Random Order option is only available in Normal mode; in Repetition mode the cards are always displayed in random order.

When Random order or User choice are selected, one further option becomes available:

2.6 Select number of cards displayed

Allow user to select the number of cards drawn from the pool for the current session. It is especially useful if your cards pool has a large number of cards. Even if the option is selected in the parameters, it will only get displayed to the end-user if there are at least 5 cards in the pool.

Feature requested on the H5P forum here: https://h5p.org/node/555063

2.7 Display which side first

Select the card display mode. The options are: Display front side first (normal display) / Display back side first (reverse display) / User's choice. This option is especially useful if the front of the cards is not really a question. It is illustrated in the Flags and Countries example.

Currently this option is only available in the Free browsing and Self Correction modes.

3 - To do

  • Add an audio file to the back of the card

4.- Compatibility & Accessibility

  • Successfully tested on Drupal 7 and 8; WordPress 5.2.2; Moodle 3.7 (including Moodle Mobile).
  • Unfortunately Content Type accessibility is not guaranteed to work correctly in this Dialog Cards Papi Jo version for these 2 reasons: I do not have the necessary programming skills nor the necessary testing equipment to guarantee this feature. For more details on accessibility in H5P see: https://h5p.org/documentation/installation/content-type-accessibility.

5.- H5P features availability

5.1.- The Save content state feature is available (if enabled site-wide on your site).

5.2.- The user's results are saved on the site, if you have set a Maximum Score value in the parameters, of course. This feature is currently not available to the official H5P Dialog Cards content.

5.3.- Unfortunately, this H5P Dialog Cards 'Papi Jo' version is not available to those H5P standard activities which accept embedded contents, i.e. Course Presentation and Quiz. I have asked for a solution but never got an answer here: https://h5p.org/node/431474