Note: You are currently viewing documentation for Moodle 3.8. Up-to-date documentation for the latest stable version of Moodle may be available here: Lesson clusters.

Lesson clusters

From MoodleDocs

Template:Lessons

What are clusters?

Clusters are special navigational sections in a Lesson. The typical cluster section contains question pages and we will focus our attention on this kind of cluster.

A cluster is started in the logical order with a cluster page. Clusters should be completed with an End of Cluster page for best results (otherwise they treat the End of Lesson as the End of Cluster).

A cluster represents a set of pages from which one or more may be randomly chosen. Questions within a cluster are randomly selected by choosing "Random Question within a Cluster" as the jump in the "Start Cluster" page. Questions within a cluster may either link to the End of Cluster to exit the cluster, or jump to any other page in the lesson. They may also jump to an unseen question within the cluster but this causes problems when the questions have all been seen if the student is allowed to re-enter the cluster in the same lesson attempt.

Note that a cluster page is not similar to other pages. A cluster page appears to have a title, page contents (with the standard toolbar) and a jump. But it is not actually visible to students and it does not have any choices for a student to make. It is similar in layout to an end of branch and an end of cluster page.

Sub-Clusters

Clusters can contain sub-clusters by using Branch Tables and End of Branches. To implement this, set up a cluster as normal with a Cluster page followed by question pages (with the linking set up the same as above) and ended with an End of Cluster page. To set up a sub-cluster, wrap a group of questions with a Branch Table and an End of Branch. Neither the content nor the jumps of the Branch Table and the End of Branch have importance. Rather the two pages act as markers for the sub-cluster within the main cluster. When the student attempts the lesson, only one random question page within the sub-cluster will be displayed to the student.

When to use a cluster?

A cluster in the lesson works as if you had a random question quiz inside your lesson. If you have for example a set of 6 questions / a set of 6 pages inside your lesson AND you would like each student to go through ONLY two of these 6 pages, then you can use Cluster to arrange that.