Dialog Cards papi Jo (doc)


Dialog Cards Papi Jo Version 1.14.1 September 2021


Here you will find details of the various differences between the official H5P distribution (currently version 1.8.6) 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 colour (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

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

Added a filter cards by categories option

Just above the list of cards/dialogs when the is selected, an extra Card Category/ies field is made available at the end of each card's parameters. It says: Optional. Category item(s) that this card belongs to. Enter the item name(s) separated by a comma and no space.

Added a text only option (new in version 1.13.1 of April 2021). Feature requested by Adrian Mielke (thanks for your A...n gift, Adrian!)

2 - Parameters / Behavioural settings

2.1.1 Categories filtering

Create one or more filters to be used to filter the cards displayed to the end user. Use the Card Categories entered for the cards above. Each filter consists of 2 fields:

  • the list of the category/ies to be used in this filter
  • a Filter Boolean operator
    Select the Boolean operator to process the list of filters defined above. The default value is AND. The AND operator will limit the choice to cards that belong to ALL the categories listed in this filter. The OR operator will expand the choice to all cards that belong to at least ONE category. The NOT operator will exclude all cards belonging to any category listed in the filter.

2.1.2 Filter by Categories

After you have created one or more filters in the : Categories filtering option, you can use the following drop-down selection list to enable the filtering mode, out of 3 options:

  • No filtering
  • First (or unique) filter defined above.
  • If more than one filter has been defined, enable user to select a filter at runtime.

Important note.- This---new in version 1.12---Filter by categories option needs careful planning in order to give the desired results. Unfortunately, due to the limits of the H5P so-called "semantics" authoring mode, it is not possible to check that the activity author (you) will use consistent category names both in each card's settings nor in the filter(s) created. You must be particularly careful with your spelling and only use the very same category names in the cards and in the filter(s). You must also make sure you understand the concepts of filtering by Boolean operators.

From a pedagogical point of view you must make sure that you are using a useful & meaningful set of filter categories in your activity. The Flags and countries (with categories) example is, I think, the best demonstration of such features.

2.2 Select Mode  (display 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.3 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.4 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.5 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.6 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.7 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.8 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.


Description: "Check this box if you only use only images and audio on front and back of cards, no text". Even if you have entered text for the front or back cards, if you check this option, those texts will not be displayed to the end-user (student). This option will noticeably reduce the height of the Dialog cards, by removing the unused blank space under the pictures (or audio buttons).
General remark.- In each "pack of cards" it is not advised to mix cards with different type of content, e.g. card #1 front picture only; card #2 audio on front and back but no picture and no text, etc. If you do, then unwanted display problems may happen. Try to be consistent!

3.- Compatibility & Accessibility

  • Successfully tested on Drupal 7 and 8; WordPress 5.7; Moodle 3.11 (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.

4.- H5P features availability

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

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

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