Skip to content

2. Building Lessons with Poodll MiniLesson

A MiniLesson is a short, self-guided lesson made from a sequence of items. Each item is one screen that presents content or sets the student a task, such as answering a question, repeating a sentence or chatting with an AI partner. Students work through the items at their own pace. Most items are graded automatically, and the result goes to the Moodle gradebook.

A student working through a MiniLesson

Figure 2.1. A student working through a MiniLesson.

Use a MiniLesson when you want students to practise independently through a guided sequence. Typical uses include:

  • Topic lessons: introduce vocabulary, practise it, then ask students to use it in speech or writing.
  • Pronunciation practice: listen-and-repeat sentences with feedback on each spoken word.
  • Listening practice: dictations and gap fills with automatically generated audio.
  • Grammar practice: a short explanation followed by word-order or gap-fill tasks.
  • Homework: a short task that students can complete outside class, with grades recorded automatically.

If you want one extended speaking task, Solo may be simpler (see Section 3). If you want to track a set of words over a whole course, use WordCards (see Section 4).

  1. In your course, turn Edit mode on and select +, then Activity or resource.
  2. Choose Poodll MiniLesson.
  3. Enter a name and, if you wish, a description.
  4. Set Target/Voice Language to the language students are learning.
  5. Set Learner’s Native Language if you want AI feedback, definitions and translations in the students’ first language.
  6. Review the other settings described below, then select Save and display.
SettingWhat it controlsDefault
Show item titles in lessonWhether students see each item’s title.No
Show Item ReviewWhether students see the correct answer and any feedback immediately after an item.Yes
Max. AttemptsHow many times a student can attempt the lesson.Unlimited
TranscriberThe speech recognition mode. See Section 6.3.Open STT (Strict)
Text and MediaWhether text and media are entered separately or together in a rich text editor. Separate is recommended because it lays out more reliably on different screen sizes.Separate
Enable native language featuresTurns on the translate button and related features. See Section 6.2.Yes
Can continue previous attemptWhether a student can return and finish an incomplete attempt.Yes
Finish Screen (Advanced)Whether students finish on a Full results breakdown, a Simple score or a Custom screen.Full
Link to next activity (Post attempt options)An activity that students can continue to after finishing.None

The main MiniLesson settings

Figure 2.2. The main MiniLesson settings.

After saving the settings, you can add items in any of these ways, and you can combine them.

MethodTabBest when…
Add items by handLesson ItemsYou want full control of the content.
Generate with AIAI GenerateYou have a topic, word list, text or YouTube video and want a fast first draft.
ImportImportYou have items in a CSV or JSON file, or are copying from another lesson.

Your site may also offer a ready-made Lesson Bank and an Assistant tab, where you can build the lesson by chatting with an AI assistant. An administrator must enable these.

  1. Open the Lesson Items tab and choose + Add new item.
  2. Select the item type. A short description appears beside the list. Select Add.
  3. Enter an item title. Students see it only if Show item titles in lesson is on.
  4. Enter any instructions for the student.
  5. Add any media prompts (see below), then choose a layout, or leave it on Auto.
  6. Complete the settings for that item type, such as the sentences for a dictation.
  7. Save the item.
  8. Use the View tab or the item’s preview to check it.

Choosing an item type. Your administrator can hide item types, so your list may be shorter

Figure 2.3. Choosing an item type.

The Lesson Items tab, where you can move, preview, edit and delete items

Figure 2.4. The Lesson Items tab, where you can move, preview, edit and delete items.

Most items can show content above the task. Choose what you need from the Media Prompts list:

  • Image / audio or video: upload a file.
  • Text Block: add a reading text or instructions.
  • TTS Audio: type text, choose a voice and let Poodll generate the audio.
  • TTS Dialog: generate a conversation with up to three voices.
  • TTS Passage: generate audio for a longer passage.
  • YouTube clip: play part of a YouTube video.
  • Audio Story: make a narrated slide show from an audio track and a set of images.
  • iFrame / custom HTML: embed content from elsewhere.
  • Native language chooser: set the user’s native language preference.

Adding text-to-speech audio as a media prompt

Figure 2.5. Adding text-to-speech audio as a media prompt.

Item typeWhat the student does
Listen and SpeakListens to audio prompts and responds by speaking; often used for listen-and-repeat.
Speech CardsReads aloud a series of cards, each with a phrase or sentence.
FluencySays sentences aloud and sees which parts were good, OK or not good.
Self CheckCompares their recording with a model and decides whether to try again. It does not use speech recognition, so it works in any language.
Passage ReadingReads a passage aloud while recording and receives a score.
Video ShadowingSpeaks along with a YouTube clip, line by line.
Short AnswerAnswers a question by speaking. You set the acceptable answers.
MC AudioAnswers a multiple-choice question by speaking the answer aloud.
Speaking GapfillSays the completed sentence aloud.
Free SpeakingResponds to an open speaking task and receives an AI grade and feedback.
Audio ChatHas a spoken conversation with an AI partner about a topic or picture.
Item typeWhat the student does
DictationListens to audio and types what they hear.
Dictation ChatAnswers audio prompts by typing, in a chat-style layout. Administrators may need to switch this type on.
Listening GapfillListens to a sentence and types the missing words.
Passage GapfillListens to a passage and fills in the missing words.
Typing GapfillTypes the missing words in a sentence.
Free WritingResponds to an open writing task and receives an AI grade and feedback.
Word ChatHas a text chat with AI in which they try to use target words.
Item typeWhat the student does
Multi ChoiceChooses one of up to four answers, which can be text, audio or images.
Multichoice QuizAnswers several questions, one at a time, while a resource such as a reading passage stays on screen.
Word ShufflePuts scrambled words back in the correct order.
FictionPlays through a branching story. Stories are authored in a format called Yarn, so this is for advanced users.
Item typeWhat the student does
CardsStudies cards containing text, pictures and audio. Good for introducing vocabulary.
WordCardsChooses or types the correct word from a set of new words.
ScatterClears a grid of cards by matching word pairs.
Space GamePlays an arcade-style game by “shooting” the correct words.

These item types are for presenting content.

Item typeWhat it does
Content PageShows your text or media and a next button.
SlidesShows a presentation authored in Markdown. For advanced users.
H5PEmbeds an H5P activity from the Moodle content bank.

Teaching tip: You do not need to learn every item type. Start with Content Page, Multi Choice, and Listen and Speak, then add others as your lessons develop.

The AI Generate tab builds items for you from a template. Templates range from a single item, such as a dictation from a topic, to complete lessons, such as a grammar lesson or a YouTube-based lesson.

  1. Check the activity’s Target/Voice Language and Learner’s Native Language. AI uses these when it generates the lesson.
  2. Open the AI Generate tab.
  3. Select a lesson template. You can filter the list by skill, such as Speaking or Vocabulary Practice, or by Single-Item and Multi-Item.
  4. Enter the information the template requests, such as a topic, keywords, a passage, a language level or an image style.
  5. Confirm, then wait. A progress bar shows how the generation is going, and a tick appears when an item is finished. Generation runs in the background, so it is safe to leave the page.
  6. Open the Lesson Items tab, then review and edit what was created.

Choosing a template and entering options on the AI Generate tab

Figure 2.6. Choosing a template and entering options on the AI Generate tab.

AI generation in progress and complete

Figure 2.7. AI generation in progress and complete.

Always review AI-generated lessons. Check the content for accuracy and level. You may want to change which words are gaps, adjust time limits or word counts, or choose a different voice. Generated items can be edited just like ones you made by hand.

If a generation stays pending for a long time, ask your administrator to check that the Moodle cron job is running.

2.7 Importing, exporting and other options

Section titled “2.7 Importing, exporting and other options”

On the Import tab, you can import items from a JSON file and export the current lesson as JSON. Exporting and importing is a convenient way to reuse a lesson in another MiniLesson. See Importing Items into MiniLesson (CSV) for the CSV format.

Quick Tip It is also possible to export an individual item from it’s row in the lesson items page.

Several sentence-based item types, including Listen-and-Speak and Fluency, let you upload an image or your own audio for each sentence. Name each file after the sentence number, such as 2.jpg or 3.mp3. See Sentence audio and images.

Sentence Media

If students type in a language their keyboard does not support, you can enable a virtual keyboard in items such as Free Writing, Typing Gapfill and Listening Gapfill. It uses the activity’s target language. See Virtual Keyboard Feature.

Virtual Keyboard

Students open the activity and work through the items in order. If Show Item Review is on, they see the correct answers and feedback after each item. At the end, the Finish Screen shows their score and stars and, on the Full setting, a breakdown of each item. If attempts remain, they can select Try Again.

The Full finish screen with the per-item breakdown open

Figure 2.8. The Full finish screen with the per-item breakdown open.

Teachers can review results on two tabs:

  • Grades: see each student’s latest grade and open their attempt. Select View, then See All Results, for item-by-item scores. On spoken items, see details shows information such as the Audio Chat transcript or the Fluency sentences. To change a grade, use the Moodle gradebook.
  • Reports: view the Grade Report, Attempts Report, Incomplete Attempts Report and Course Attempts Report. Grades data can be exported to CSV.

Reviewing student attempts on the Grades tab

Figure 2.9. Reviewing student attempts on the Grades tab.

For activity completion, you can require that the student has finished the activity, reached a Minimum Grade, or both.

Your Moodle administrator can hide item types site-wide. Items that have already been added to a lesson are not affected.

The Lesson Bank must be enabled in the site administration settings. Ask your administrator.

No. Prompts can use text-to-speech voices, so no recording is needed. You can also upload your own audio.

Some item types have a retry option, immediately after it is completed and retry is enabled (eg audiochat or wordshuffle). Otherwise students can retake the whole lesson if Max. Attempts allows it.

Can students navigate back to an earlier item?

Section titled “Can students navigate back to an earlier item?”

No. Currently they can not go back.

Can I embed a MiniLesson elsewhere in Moodle?

Section titled “Can I embed a MiniLesson elsewhere in Moodle?”

Yes, with the Poodll or Generico filter. See Embedding MiniLessons.