{"id":387,"date":"2025-10-23T11:45:55","date_gmt":"2025-10-23T09:45:55","guid":{"rendered":"https:\/\/www.rezeau.org\/wp-h5p\/?page_id=387"},"modified":"2025-10-23T18:49:05","modified_gmt":"2025-10-23T16:49:05","slug":"mtw-documentation","status":"publish","type":"page","link":"https:\/\/www.rezeau.org\/wp-h5p\/mtw-documentation\/","title":{"rendered":"MTW Documentation"},"content":{"rendered":"\n<h4 class=\"wp-block-heading\"><em>Mark the Words &#8216;papi Jo&#8217; Version 1.0.6 &#8211; September 2022<\/em><\/h4>\n\n\n\n<h4 class=\"wp-block-heading\">1. New features<\/h4>\n\n\n\n<p>Here you will find&nbsp; details of the various differences between the official H5P Mark the words content type and the &#8216;papi Jo&#8217; version.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Mark <em>Groups of Words<\/em><\/li>\n\n\n\n<li>Mark <em>Parts of Words<\/em><\/li>\n\n\n\n<li><em>Keep Correct Answers<\/em> when retrying<\/li>\n\n\n\n<li>New display mode for correct\/incorrect icons: <em>above the words<\/em><\/li>\n\n\n\n<li>Set a <em>minimum score<\/em> limit to allow viewing of the Solutions<\/li>\n\n\n\n<li><em>Spot the Mistakes<\/em> mode: instead of marking the correct words, the student must mark the incorrect ones (spelling mistakes, wrong grammar forms). This mode makes it possible to display mock Multiple Choice questions within the activity text. Incorrect choices <em>aka <\/em>distractors must be specified by the teacher when creating the activity.<\/li>\n\n\n\n<li>In the Spot the Mistakes mode an option is provided to completely <em>remove the wrong words\/parts of words<\/em> (mistakes) when the activity is completed.<\/li>\n\n\n\n<li><em>Display Non-Selectable<\/em> words\/text (useful for displaying sub-instructions within the activity text itself). Requested feature in <a href=\"\\&quot;https:\/\/h5p.org\/node\/25011\\&quot;\">2016<\/a>.<\/li>\n\n\n\n<li>The text editor now features the <em>table <\/em>format.<\/li>\n\n\n\n<li><em>Media insertion<\/em> at the top of the activity (Image, Video or Audio)<\/li>\n<\/ol>\n\n\n\n<h4 class=\"wp-block-heading\">2. Editor<\/h4>\n\n\n\n<h6 class=\"wp-block-heading\">1.- <em>Media insertion<\/em> at the top of the activity (Image, Video or Audio)<\/h6>\n\n\n\n<h6 class=\"wp-block-heading\">2.- Distractor delimiter character (optional)<\/h6>\n\n\n\n<p><em>Select the character to be used for delimiting distractors (wrong words\/groups of words).<\/em> You have a choice of 3 separators, the underscore character being the default.<\/p>\n\n\n\n<p>This option can be used in the following two cases:<\/p>\n\n\n\n<p><strong>a.- Used together with the <\/strong><em><strong>Mark selectable words<\/strong><\/em><strong> option<\/strong> (in the Behavioural settings) it makes it possible to display mock Multiple Choice questions within the activity text.<\/p>\n\n\n\n<p>Example text:<\/p>\n\n\n\n<p>When the Dominion of Canada was created in 1867, a time we refer to as Confederation, the *politicians* \/ _politics_ who wrote the British North America Act (since 1982 the Constitution Act of 1867) decided that there should be two levels of government to govern the people of Canada.<\/p>\n\n\n\n<p>In the activity:<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"637\" height=\"116\" src=\"https:\/\/www.rezeau.org\/wp-h5p\/wp-content\/uploads\/2025\/10\/2021-11-24_22-54-091.jpg\" alt=\"\" class=\"wp-image-459\" srcset=\"https:\/\/www.rezeau.org\/wp-h5p\/wp-content\/uploads\/2025\/10\/2021-11-24_22-54-091.jpg 637w, https:\/\/www.rezeau.org\/wp-h5p\/wp-content\/uploads\/2025\/10\/2021-11-24_22-54-091-300x55.jpg 300w\" sizes=\"auto, (max-width: 637px) 100vw, 637px\" \/><\/figure>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"632\" height=\"117\" src=\"https:\/\/www.rezeau.org\/wp-h5p\/wp-content\/uploads\/2025\/10\/2021-11-24_22-57-221.jpg\" alt=\"\" class=\"wp-image-461\" srcset=\"https:\/\/www.rezeau.org\/wp-h5p\/wp-content\/uploads\/2025\/10\/2021-11-24_22-57-221.jpg 632w, https:\/\/www.rezeau.org\/wp-h5p\/wp-content\/uploads\/2025\/10\/2021-11-24_22-57-221-300x56.jpg 300w\" sizes=\"auto, (max-width: 632px) 100vw, 632px\" \/><\/figure>\n\n\n\n<p><strong>b.- Used together with the Spot The Mistakes&#8217; mode<\/strong> (in the Behavioural settings) it makes it possible to mark words which are mistakes and words which are not mistakes (see \u00a73.5 below).<\/p>\n\n\n\n<h6 class=\"wp-block-heading\">3.- Textfield<\/h6>\n\n\n\n<p><em>Detailed explanations<\/em> and examples are provided in the <em>Show instructions <\/em>panel. In the Textfield box, correct words are marked like this: *lemonade*, correct parts of words (e:g: stressed syllables) are marked like this: le-mo-*nade*, correct phrases like this: *a glass of lemonade*.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">3.- Behavioural settings<\/h5>\n\n\n\n<h6 class=\"wp-block-heading\">1.- Enable &#8220;Retry&#8221;<\/h6>\n\n\n\n<h6 class=\"wp-block-heading\">2.- Enable &#8220;Show solution&#8221; button<\/h6>\n\n\n\n<p><strong>Minimum score percentage<\/strong><br>Minimum score percentage to obtain before Solutions can be displayed. Enter 0(%) OR leave empty for no minimum limit.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">3.- Mark selectable words?<\/h5>\n\n\n\n<p>Check this box if you want selectable words or groups of words to be displayed inside borders. See \u00a72.1.a above for uses of this option.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">4.- Display mode for ticks and score points<\/h5>\n\n\n\n<p><em>Select the display mode to be used to mark each word when the student checks their answers.<\/em> 3 modes are available:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Display score points and ticks or crosses<\/li>\n\n\n\n<li>Display ticks or crosses only<\/li>\n\n\n\n<li>Display ticks or crosses above the words<\/li>\n<\/ol>\n\n\n\n<p>The first 2 modes are equivalent to the official H5P Mark the Words activity: with or without the score points. If your text contains parts of words it&#8217;s preferable to use the 3rd mode (ticks or crosses above the words). It avoids the &#8220;ugly&#8221; display of ticks &amp; crosses inside the text.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">5.- Enable the &#8216;Spot The Mistakes&#8217; mode<\/h5>\n\n\n\n<p>This mode swaps your correct &lt;-&gt; incorrect answers. The student will have to click on the mistakes\/wrong answers. The correctly spotted wrong answers will be marked as correct (and give the point).<\/p>\n\n\n\n<p>Example <em>Textfield <\/em>text:<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>Mrs Tooth is a-_n_ dentist-_&#8217;s_ married to a-*n* architect.<\/p>\n\n\n\n<p>When her h-_o_-usband go-*es* to the dentist-*&#8217;s*, he see-*s* his wife.<\/p>\n<\/blockquote>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"438\" height=\"73\" src=\"https:\/\/www.rezeau.org\/wp-h5p\/wp-content\/uploads\/2025\/10\/2021-11-24_23-27-351.jpg\" alt=\"\" class=\"wp-image-463\" srcset=\"https:\/\/www.rezeau.org\/wp-h5p\/wp-content\/uploads\/2025\/10\/2021-11-24_23-27-351.jpg 438w, https:\/\/www.rezeau.org\/wp-h5p\/wp-content\/uploads\/2025\/10\/2021-11-24_23-27-351-300x50.jpg 300w\" sizes=\"auto, (max-width: 438px) 100vw, 438px\" \/><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"602\" height=\"260\" src=\"https:\/\/www.rezeau.org\/wp-h5p\/wp-content\/uploads\/2025\/10\/2021-11-24_23-29-511.jpg\" alt=\"\" class=\"wp-image-462\" srcset=\"https:\/\/www.rezeau.org\/wp-h5p\/wp-content\/uploads\/2025\/10\/2021-11-24_23-29-511.jpg 602w, https:\/\/www.rezeau.org\/wp-h5p\/wp-content\/uploads\/2025\/10\/2021-11-24_23-29-511-300x130.jpg 300w\" sizes=\"auto, (max-width: 602px) 100vw, 602px\" \/><\/figure>\n\n\n\n<h5 class=\"wp-block-heading\">6.- Keep correct answers<\/h5>\n\n\n\n<p>Check this option if you want to keep the correct answers displayed after pressing &#8216;Retry&#8217;. Not available in the <em>Spot The Mistakes <\/em>and <em>Mark selectable words<\/em> modes as it would give away the solutions.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">7.- Remove hyphens<\/h5>\n\n\n\n<p>Select this option if you do not want the &#8216;parts of words&#8217; separator (hyphen) to be displayed. In the &#8220;dentist&#8221; example above this option is used. But it&#8217;s not used in an exercise where we want the parts of the words to be clearly marked, as in a &#8220;mark the stressed syllables&#8221; exercise.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p><strong>Credits and Thanks<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/github.com\/sr258\">Sebastian Rettig<\/a> for developing the routine to make groups of words selectable in a Mark the Words activity.<\/li>\n\n\n\n<li><a href=\"https:\/\/www.olivertacke.de\/labs\/\">Oliver Tacke<\/a> for providing lots of much needed advice on writing better code.\ud83d\ude09<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Mark the Words &#8216;papi Jo&#8217; Version 1.0.6 &#8211; September 2022 1. New features Here you will find&nbsp; details of the various differences between the official H5P Mark the words content type and the &#8216;papi Jo&#8217; version. 2. Editor 1.- Media insertion at the top of the activity (Image, Video or Audio) 2.- Distractor delimiter character&hellip;<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"categories":[81,58],"tags":[],"class_list":["post-387","page","type-page","status-publish","hentry","category-mark-the-words","category-papi-jo-libraries"],"_links":{"self":[{"href":"https:\/\/www.rezeau.org\/wp-h5p\/wp-json\/wp\/v2\/pages\/387","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.rezeau.org\/wp-h5p\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.rezeau.org\/wp-h5p\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.rezeau.org\/wp-h5p\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.rezeau.org\/wp-h5p\/wp-json\/wp\/v2\/comments?post=387"}],"version-history":[{"count":2,"href":"https:\/\/www.rezeau.org\/wp-h5p\/wp-json\/wp\/v2\/pages\/387\/revisions"}],"predecessor-version":[{"id":464,"href":"https:\/\/www.rezeau.org\/wp-h5p\/wp-json\/wp\/v2\/pages\/387\/revisions\/464"}],"wp:attachment":[{"href":"https:\/\/www.rezeau.org\/wp-h5p\/wp-json\/wp\/v2\/media?parent=387"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.rezeau.org\/wp-h5p\/wp-json\/wp\/v2\/categories?post=387"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.rezeau.org\/wp-h5p\/wp-json\/wp\/v2\/tags?post=387"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}