**********************************************
Xml format of conditional module [xmodule]
**********************************************

.. module:: conditional_module

Format description
==================

The main tag of Conditional module input is:

.. code-block:: xml

    <conditional> ... </conditional>

``conditional`` can include any number of any xmodule tags (``html``, ``video``, ``poll``, etc.) or ``show`` tags.

conditional tag
---------------

The main container for a single instance of Conditional module. The following attributes can
be specified for this tag::

    sources - location id of required modules, separated by ';'
    [message | ""] - message for case, where one or more are not passed. Here you can use variable {link}, which generate link to required module.
        
    [submitted] - map to `is_submitted` module method.
    (pressing RESET button makes this function to return False.)

    [correct] - map to `is_correct` module method
    [attempted] - map to `is_attempted` module method
    [poll_answer] - map to `poll_answer` module attribute
    [voted] - map to `voted` module attribute

show tag
--------

Symlink to some set of xmodules. The following attributes can
be specified for this tag::

    sources - location id of modules, separated by ';'

Example
=======

Examples of conditional depends on poll
-------------------------------------------

.. code-block:: xml

    <conditional sources="i4x://MITx/0.000x/poll_question/first_real_poll_seq_with_reset" poll_answer="man"
    message="{link} must be answered for this to become visible.">
        <html>
            <h2>You see this, cause your vote value for "First question" was "man"</h2>
        </html>
    </conditional>

Examples of conditional depends on poll (use <show> tag)
--------------------------------------------------------

.. code-block:: xml

    <conditional sources="i4x://MITx/0.000x/poll_question/first_real_poll_seq_with_reset" poll_answer="man"
    message="{link} must be answered for this to become visible.">
        <html>
            <show sources="i4x://MITx/0.000x/problem/test_1; i4x://MITx/0.000x/Video/Avi_resources; i4x://MITx/0.000x/problem/test_1"/>
        </html>
    </conditional>

Examples of conditional depends on problem
-------------------------------------------

.. code-block:: xml

    <conditional sources="i4x://MITx/0.000x/problem/Conditional:lec27_Q1" attempted="True">
        <html display_name="HTML for attempted problem">You see this, cause "lec27_Q1" is attempted.</html>
    </conditional>
    <conditional sources="i4x://MITx/0.000x/problem/Conditional:lec27_Q1" attempted="False">
        <html display_name="HTML for not attempted problem">You see this, cause "lec27_Q1" is not attempted.</html>
    </conditional>