Lesson clusters

Revision as of 10:57, 21 July 2006 by David Scotson (talk | contribs) (added note, please expand summary line if you can sum up what a cluster is)

Jump to: navigation, search

Note: You are currently viewing documentation for Moodle 2.2. Up-to-date documentation for the latest stable version is available here: Lesson clusters.


Clusters are special navigational sections in a Lesson.

Note: If you are a Moodle administrator looking for information on using multiple machines in a server cluster see the Performance page instead.

What are clusters?

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: the start and end cluster pages are not seen by the student. In the teacher's edit mode, these pages appear to have a title, page contents (with the standard toolbar) and a jump. But like an end of branch page, they are not visible to the student.


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.

Special uses

Looking for a page that redirects without the student seeing it? Alison Schubert discovered that an end of cluster will fill that function. As long as it is not placed within an existing cluster, insert it any place in a lesson. The student will not see it.