Dialog Cards 'papi Jo' Documentation
Dialog Cards Papi Jo Version 1.16.11 August 2022
Introduction
Here you will find details of the various differences between the official H5P distribution 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.
- Font colour feature
- Fixed alignment error for left-centred
-
It is now possible to leave the text in the Response field empty.
- Optional image for the front of the card.
- This image will also be displayed on the back of the card if no rear image is provided.
Add an image to the back of the card.
A card can have any of the following: no attached image 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
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 - Match example on page 11 of the Interactive Book with Examples.
Added web-link support to the Text and Answer Editors
Added an audio file to the back of a card
Added a filter cards by categories option
Just above the list of cards/dialogs when the Enable Categories in Dialogs option 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. Feature requested by Adrian Mielke (thanks for your Amzn 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 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 "Proverbs - categories" and the "Flags - categories" examples in the Examples Interactive Book provide demonstrations 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.
Note.- 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.
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.
2.4 Pass percentage
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", she 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.
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
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".
3.- H5P features availability
3.1.- The Save content state feature is available (if enabled site-wide on your site).
3.2.- The user's results are saved on the site. 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.