Dialog Cards papi Jo (doc)


Dialog Cards Papi Jo Version 1.16.8 August 2022


Here you will find details of the various differences between the official H5P distribution (currently version 1.8.8) of the Dialog Cards content type and the Dialog Cards 'papi Jo' version I have 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 and https://h5p.org/node/1371509

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 Azn gift, Adrian!).

Added audio on both sides of cards.

Enable Subtitles in Cards: Optional Subtitle for each card when the 'Free browsing with cards side by side' mode is enabled.

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. Match with Repetition is a combination of the Match and Self Correction modes.

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 modes other than Free browsing are selected, further options become available:

2.3 Penalty percentage

Each extra round (in Self-correction mode) or each wrong match (in Match with Repetition 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.

New in version 1.16.1. The penalty percentage is no longer available for the Match (without repetition) mode. In that mode, each incorrect match costs 1 point out of the total of selected cards.

Important note for users of previous versions. Even after updating your existing Dialog Cards 'papi Jo' contents to version 1.16.1, for those contents which used the Match (without repetition) mode, you will need to edit them and do this:

In Text overrides and translations
Match mode score explanation. (Used in Match mode if maximum score not reached.)
"Each incorrect match cost you a penalty of @penalty%". with "Each incorrect match cost you a penalty of 1 point."

2.4 Pass percentage (New in version 1.16.1)
When modes other than Free browsing are selected this new setting becomes available. This setting is the percentage of the total score required for getting result.success in xAPI statements reporting (e.g. in Moodle etc). If you do not use your H5P activities on Moodle or any other such platforms which record XAPI statements, you can ignore this setting.

2.5 Background colour of the cards

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.

2.9 Two more options available

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

2.9.2 Browse cards side by side?

Check this box if you want to browse the cards displayed side by side. If you have enabled sub-titles, they will be displayed below the cards. These 2 features are illustrated in the Countable vs Uncountable content.

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, 8 and 9; WordPress 5.7; Moodle 3.11 and 4.0 (forthcoming) (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. This feature is currently not available to the official H5P Dialog Cards content. If you use Dialog Cards 'papi Jo' activities on a Moodle site, for all those activities which use scored options (all options except for Free Browsing), a detailed report for each attempt will be available, including the "Pass percentage" option for the Student and the Teacher in the Grades menu.

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