= Bolt Tutorial, part II: Exercises =

Now let's add an exercise.
Create a file '''exercise1.php''':
{{{
<?php
echo "Conifers are so named because:";
bolt_exclusive_choice(
    array(
        'They carry their seeds in cones',
        'They are cone-shaped',
        'They originated in the Coniceous era',
    )
);
?>
}}}

and edit conifer.php:
{{{
<?php
...
return sequence(
    name('course'),
    lesson(
        name('Introduction'),
        filename('conifer_intro.php')
    ),
    lesson(
        name('Conifers and deciduous trees'),
        filename('conifer_decid.php')
    ),
    exercise(
        name(''),
        filename('conifer_ex1.php')
    )
);

?>
}}}
The course structure is now

[[Image(ex.png, nolink)]]

Start the course from the beginning.
When you get to the exercise you'll see

[[Image(bolt_ex.jpg, nolink)]]

You'll then see either

[[Image(bolt_right.jpg, nolink)]]

or

[[Image(bolt_wrong.jpg, nolink)]]

depending on whether you answered the question correctly.


Some notes:
 * The correct answer is always the first choice listed.  Bolt automatically randomly reorders the choices to remove any ordering effects.
 * The exercise page is used to generate both the exercise and the answer page.
 * If you look at your course history, you'll see that Bolt has stored your answers to the exercise, and your score, in its database.

== Reviewing and repeating exercises ==

Suppose the student doesn't perform the exercise correctly,
and you want to let them (or require them to) review the lessons and repeat the exercise?
Bolt provides a powerful mechanism for this, called '''exercise sets'''.
To illustrate this, first let's create a new exercise, '''conifer_ex2.php''':
{{{
<?php
echo "
Check the correct statements.
";

bolt_inclusive_choice(array(
    array("Conifers drop their leaves in autumn", 0),
    array("All conifers have needle-like leaves", 0),
    array("Conifers carry their seeds in cones", 1)
));
?>
}}}

[[Image(ex_set.png, nolink)]]