MoodleDocs - User contributions [en]

Markdown

2020-05-21T00:49:25Z

Mchurch: /* Lists */

{{Editing text}}
== About Markdown ==

Markdown expands upon the simple text entry format available in Moodle by allowing you to easily add emphasis (bold, italics), structure (bullet points and headings) and links (to images or other web resources).

To enter text simply type into the text entry area or text box, pressing the return key twice at the end of a paragraph to leave a blank line between the end of one paragraph and the start of the next.

==Using Markdown==

To use Markdown:

# Go to your editor preferences (via the user menu) and select 'Plain text area'
# Click the 'Save changes' button
# Select 'Markdown format' from the dropdown menu below any text entry area.

=== Emphasising Text ===

You can add three levels of emphasis with Markdown, italic text, bold text, or bold and italic text. This is achieved by surrounding the text you wish to emphasise with asterisks e.g.

*italic*
**bold**
***bold italic***

Emphasis can be added to single words, a sequence of words, or even parts of words:

a *single* word
***a sequence of words***
in**distinguish**able

Underscores (_) can be used interchangeably with asterisks for this purpose.

=== Headings===

Markdown allows you to subdivide your text with headings; six different levels are available though it is unusual for a normal text to use more than three. For example, there are three levels of heading used in the text you are currently reading.

You can create a heading by starting a line with one or more hash characters (#). One hash is the largest and most important heading, and six hashes gives you the least important or smallest heading.

# section heading
## sub-section heading
### sub-sub-section heading

etc.

The first two levels of headings are most common and can be created in alternative ways that make them stand out more in the text version (though the output is identical to the previous method). This alternative uses a line of equal signs (=) or hyphens (-) under the title as follows:

Section heading
===============

Subsection heading
------------------

=== Lists ===
To be recognized as a list, all lists must have a blank line before them. Without a blank line, the text will not be rendered as a list.

Will not
==== Bullet point lists ====

Bullet point lists can be created by starting each line with an asterisk followed by a space before the content of the bullet point. Note that the space is important and should not be forgotten.

* first point
* second point
* third point

==== Numbered lists ====

Similarly, numbered lists can be created by starting each line with a number followed by a space and then the relevant text.

1. first point
2. second point
3. third point

==== Indented lists ====

You can nest or indent bullet and numbered lists, even mixing bullet point and numbered lists in one structure:

* top level bullet one
* sub-bullet
* sub-bullet 2
* top level bullet two
1. numbered point one
1. nested numbered point
2. numbered point two

=== Quoted paragraphs ===

You can indicate a quoted section of text by beginning each line with an angle bracket (>). This character was chosen as many email programs use it to indicate quoted sections. The output will generally indent the quoted section in from both margins.

> This is a quoted paragraph
> spread over two lines

You can save some typing by only using a a single angle bracket at the beginning of the first line of the paragraph

> this is all one single quoted
paragraph even though it is spread
over several lines.

=== Web links ===

There are two ways to create links to web resources: the first is to include the link inline, placing the text you wish readers to click on in square brackets, and the URL of the page they will be taken to immediately afterwards in parentheses with no space or gap between the two sets of brackets; you can also add an optional title for the link in quotes after the URL.

An [example link](<nowiki>http://example.com/</nowiki> "Optional Title") in a sentence.

The title, if supplied, is displayed in a 'tooltip' which appears when the user hovers their mouse over the link text. Try it on the link that appears above.

For longer links you can avoid disrupting the flow of text by using a footnote style, attaching a short identifying name to the link in a second set of square brackets (either using a short explanatory word, phrase or simply a number).

An [example link][ex] in a sentence.

Then, anywhere else in the document, but preferably either directly after the paragraph with the link, or collected with other link URLs at the bottom of the document, you can define the URL associated with the id:

[ex]: <nowiki>http://example.com/</nowiki> "Optional Title"

The output of this second example would be indistinguishable from the first. It is simply a matter of keeping the working document neatly organised to aid further editing (particularly if you are working with others).

A final shortcut, if you wish your linked text to be the same as the URL, is to place the URL within angled brackets like so:

<<nowiki>http://moodle.org/</nowiki>>

=== Images ===

Images are included in a very similar manner to web links, but are preceded by an exclamation mark. The 'alt text' (alt meaning alternative) is provided to users that cannot see the image for various reasons, thus the text should make sense without any visual cues. Doing this will also provide a reminder or hint to those editing the text in Markdown as to the purpose of the image.

The 'title' is displayed in a small pop up when the user hovers over the image and so can provide additional information.

![alt text](/path/img.jpg "Optional Title")

And, like web links, you can organise your document by keeping all the URLs together with 'footnote' style references. Just give the image a short, unique name:

![alt text][photo]

and anywhere else in your document, associate that name with an image file:

[photo]: /url/to/img.jpg "Optional Title"

Here is an example:

![Google logo](<nowiki>http://www.google.com/images/logo.gif</nowiki> "The Google logo")

The 'alt text', which is also important for accessibility reasons, will often be used by browsers when links to images are broken or temporarily unavailable:

![alt text for broken image](<nowiki>http://example.com/intentionally.broken.link</nowiki> "This image will never display")

== See also ==

* [[Formatting text]]
* [[Advanced use of Markdown]]

Markdown

2020-05-21T00:49:04Z

Mchurch: /* Lists */

{{Editing text}}
== About Markdown ==

Markdown expands upon the simple text entry format available in Moodle by allowing you to easily add emphasis (bold, italics), structure (bullet points and headings) and links (to images or other web resources).

To enter text simply type into the text entry area or text box, pressing the return key twice at the end of a paragraph to leave a blank line between the end of one paragraph and the start of the next.

==Using Markdown==

To use Markdown:

# Go to your editor preferences (via the user menu) and select 'Plain text area'
# Click the 'Save changes' button
# Select 'Markdown format' from the dropdown menu below any text entry area.

=== Emphasising Text ===

You can add three levels of emphasis with Markdown, italic text, bold text, or bold and italic text. This is achieved by surrounding the text you wish to emphasise with asterisks e.g.

*italic*
**bold**
***bold italic***

Emphasis can be added to single words, a sequence of words, or even parts of words:

a *single* word
***a sequence of words***
in**distinguish**able

Underscores (_) can be used interchangeably with asterisks for this purpose.

=== Headings===

Markdown allows you to subdivide your text with headings; six different levels are available though it is unusual for a normal text to use more than three. For example, there are three levels of heading used in the text you are currently reading.

You can create a heading by starting a line with one or more hash characters (#). One hash is the largest and most important heading, and six hashes gives you the least important or smallest heading.

# section heading
## sub-section heading
### sub-sub-section heading

etc.

The first two levels of headings are most common and can be created in alternative ways that make them stand out more in the text version (though the output is identical to the previous method). This alternative uses a line of equal signs (=) or hyphens (-) under the title as follows:

Section heading
===============

Subsection heading
------------------

=== Lists ===
To be recognized as a list, All lists must have a blank line before them. Without a blank line, the text will not be rendered as a list.

Will not
==== Bullet point lists ====

Bullet point lists can be created by starting each line with an asterisk followed by a space before the content of the bullet point. Note that the space is important and should not be forgotten.

* first point
* second point
* third point

==== Numbered lists ====

Similarly, numbered lists can be created by starting each line with a number followed by a space and then the relevant text.

1. first point
2. second point
3. third point

==== Indented lists ====

You can nest or indent bullet and numbered lists, even mixing bullet point and numbered lists in one structure:

* top level bullet one
* sub-bullet
* sub-bullet 2
* top level bullet two
1. numbered point one
1. nested numbered point
2. numbered point two

=== Quoted paragraphs ===

You can indicate a quoted section of text by beginning each line with an angle bracket (>). This character was chosen as many email programs use it to indicate quoted sections. The output will generally indent the quoted section in from both margins.

> This is a quoted paragraph
> spread over two lines

You can save some typing by only using a a single angle bracket at the beginning of the first line of the paragraph

> this is all one single quoted
paragraph even though it is spread
over several lines.

=== Web links ===

There are two ways to create links to web resources: the first is to include the link inline, placing the text you wish readers to click on in square brackets, and the URL of the page they will be taken to immediately afterwards in parentheses with no space or gap between the two sets of brackets; you can also add an optional title for the link in quotes after the URL.

An [example link](<nowiki>http://example.com/</nowiki> "Optional Title") in a sentence.

The title, if supplied, is displayed in a 'tooltip' which appears when the user hovers their mouse over the link text. Try it on the link that appears above.

For longer links you can avoid disrupting the flow of text by using a footnote style, attaching a short identifying name to the link in a second set of square brackets (either using a short explanatory word, phrase or simply a number).

An [example link][ex] in a sentence.

Then, anywhere else in the document, but preferably either directly after the paragraph with the link, or collected with other link URLs at the bottom of the document, you can define the URL associated with the id:

[ex]: <nowiki>http://example.com/</nowiki> "Optional Title"

The output of this second example would be indistinguishable from the first. It is simply a matter of keeping the working document neatly organised to aid further editing (particularly if you are working with others).

A final shortcut, if you wish your linked text to be the same as the URL, is to place the URL within angled brackets like so:

<<nowiki>http://moodle.org/</nowiki>>

=== Images ===

Images are included in a very similar manner to web links, but are preceded by an exclamation mark. The 'alt text' (alt meaning alternative) is provided to users that cannot see the image for various reasons, thus the text should make sense without any visual cues. Doing this will also provide a reminder or hint to those editing the text in Markdown as to the purpose of the image.

The 'title' is displayed in a small pop up when the user hovers over the image and so can provide additional information.

![alt text](/path/img.jpg "Optional Title")

And, like web links, you can organise your document by keeping all the URLs together with 'footnote' style references. Just give the image a short, unique name:

![alt text][photo]

and anywhere else in your document, associate that name with an image file:

[photo]: /url/to/img.jpg "Optional Title"

Here is an example:

![Google logo](<nowiki>http://www.google.com/images/logo.gif</nowiki> "The Google logo")

The 'alt text', which is also important for accessibility reasons, will often be used by browsers when links to images are broken or temporarily unavailable:

![alt text for broken image](<nowiki>http://example.com/intentionally.broken.link</nowiki> "This image will never display")

== See also ==

* [[Formatting text]]
* [[Advanced use of Markdown]]

Adding/editing a questionnaire

2018-01-30T16:29:49Z

Mchurch: /* Send submission notifications */

{{Questionnaire}}

Moodle questionnaires enable staff to obtain feedback from students, with an option for the results to be anonymous. To help with consistency and reduce repetitive tasks template questionnaires can be constructed and deployed across any number of modules.

To add a questionnaire you should turn on the editing and select it from the Activity chooser. If you cannot find it in here, it may be that it has not been installed.

=Settings=
The following sections describe the settings possible for questionnaires.

[[File:questionnaire_settings.png]]

==Name==

Enter a name that describes the purpose of the questionnaire. This is what students will click on to access it on the Moodle course homepage.

==Description==

Add an optional description explaining how and why students should complete the questionnaire.
Note: If you are allowing students to Save/Resume answers you might like to explain this here.

==Timing==

Set the date window for when users can complete the questionnaire. You can leave the boxes unchecked if you want the questionnaire to be continually available.

==Response options==
===Type===

Select whether users will be allowed to respond once, daily, weekly, monthly or an unlimited number of times ('''many''').

===Respondent Type===

You can display your users' full names with each response by setting this to "fullname". You can hide your users' identities from the responses by setting this to "anonymous".

Once the "anonymous" option has been set in a questionnaire, it's impossible to revert to the "fullname" option, for obvious privacy reasons. So be careful when you set your questionnaire to "anonymous".

'''Note''': If your Moodle course allows guests, they will only be allowed to respond to a questionnaire whose responses have been set to ''anonymous''.

===Respondent Eligibility===

Decide whether everyone can answer or whether you want to restrict it to tutor only or student only responses. For restricted access options remember to assign the correct roles either at the course or activity level. For example, if you put a questionnaire on the front page, intended for teachers only, then you will have to let Moodle know which users are teachers.

===ALL Responses viewing===

====WHEN====

You can specify '''when''' Roles with the "''Read response summaries subject to open times''" capability can see the responses of ALL respondents to submitted questionnaires (i.e. the general statistics tables).

''' Students can view ALL responses -> '''

# ''' After answering the questionnaire'''.
# ''' After the questionnaire is closed'''.
# ''' Always.'''
# ''' Never.'''

====WHO (Which role can see what)====

Starting with Questionnaire version 2.'''5''', the ''"WHO" can view the ALL Responses report'' page settings have been moved to the Roles and Permissions settings.

As with all other Roles and capabilities settings in Moodle, you can set those permissions at site level, course level or activity level.

The following table sums up the correlation between the Questionnaire Response Options Settings and the Permissions settings. As you can see, the Roles and Permissions settings can OVERRIDE the Response options settings.

[[Image:2014-02-11_14-26-23.jpg]]

Note: 3.3 added the ''''Never'''" option. If this is selected, and the user does not have the "''Read all responses any time''" capability, then they will not be able to see all the responses at any time.

===Send submission notifications ===
Setting this to "Notification only" will use the Moodle notification system to notify roles with the "''mod/questionnaire:submissionnotification''" capability that a submission was made.

Setting this to "Full submission" will use the Moodle notification system to send the entire submission content to roles with the "''mod/questionnaire:submissionnotification''" when a submission is made. Note that full content will only be sent to notification plugins that support large messages (e.g. email).

===Save/Resume answers===

Setting this option allows users to save their answers to a questionnaire before submitting them. Users can leave the questionnaire unfinished and resume from the save point at a later date.

===Allow branching questions===

The Conditional Branching feature enables the Questionnaire creator to "branch" the respondent to different pages according to their choice of response to Yes/No, Dropdown boxes or Radio button questions. This option is enabled by default when you create a new questionnaire. If you do not plan to use this feature in the questionnaire, you should set it to No.

===Auto numbering===
If you have multiple questions or pages, you can choose to split them up and number them. You might want to disable automatic numbering for questionnaires with conditional branching.
# ''' Do not number questions or pages'''.
# ''' Auto number questions'''.
# ''' Auto number pages.'''
# ''' Auto number pages and questions.'''

===Submission grade===
Unlike the Quiz or Lesson Moodle activities the questionnaire activity is not meant to test the student's knowledge and therefore the responses cannot/should not be graded as correct or incorrect. However, in order to encourage the students to complete a questionnaire, you may choose to award the student a grade (on a 1-100 scale) upon completion.

==Content Options==

Select one of the radio button options. 'Create new' is the default.

'' You can create questionnaires using three different methods: ''
:''' Create New: '''
::This option allows you to create a completely new questionnaire from scratch.
:''' Copy Existing: '''
::This option copies a pre-existing questionnaire's content to a new questionnaire, pre-seeding the content. You can copy questionnaires belonging to the course, or ones specifically marked as 'template'.
:''' Use Template: '''
::This option consists of pre-existing templates from the activity that you can copy and edit into your questionnaire.
:''' Use Public: '''
::If a questionnaire has already been created (in another course on the same Moodle site) with the "public" setting, then you may use that "public" questionnaire in your own course(s). The number of settings available to such questionnaires is limited and you cannot edit its questions nor view the responses. ''''' Example: ''''' If a public questionnaire has been created in course A, it can be "used" in courses B, C, ... All the responses from courses A, B, C, ... are collected in the public questionnaire created in course A (the original course where it was created) and are viewable there by the person (admin or teacher) who originally created it.

=What next?=
Once you have clicked Save:

[https://docs.moodle.org/39/en/Setting_up_a_questionnaire Configure the questionnaire type]

[https://docs.moodle.org/39/en/Editing_Questionnaire_questions Add/Edit Questionnaire questions]

[[Category:Teacher]]

[[es:Añadiendo/editando un cuestionario]]
[[fr:Ajouter/modifier un questionnaire]]

Adding/editing a questionnaire

2018-01-30T16:29:33Z

Mchurch: /* Send submission notifications */

{{Questionnaire}}

Moodle questionnaires enable staff to obtain feedback from students, with an option for the results to be anonymous. To help with consistency and reduce repetitive tasks template questionnaires can be constructed and deployed across any number of modules.

To add a questionnaire you should turn on the editing and select it from the Activity chooser. If you cannot find it in here, it may be that it has not been installed.

=Settings=
The following sections describe the settings possible for questionnaires.

[[File:questionnaire_settings.png]]

==Name==

Enter a name that describes the purpose of the questionnaire. This is what students will click on to access it on the Moodle course homepage.

==Description==

Add an optional description explaining how and why students should complete the questionnaire.
Note: If you are allowing students to Save/Resume answers you might like to explain this here.

==Timing==

Set the date window for when users can complete the questionnaire. You can leave the boxes unchecked if you want the questionnaire to be continually available.

==Response options==
===Type===

Select whether users will be allowed to respond once, daily, weekly, monthly or an unlimited number of times ('''many''').

===Respondent Type===

You can display your users' full names with each response by setting this to "fullname". You can hide your users' identities from the responses by setting this to "anonymous".

Once the "anonymous" option has been set in a questionnaire, it's impossible to revert to the "fullname" option, for obvious privacy reasons. So be careful when you set your questionnaire to "anonymous".

'''Note''': If your Moodle course allows guests, they will only be allowed to respond to a questionnaire whose responses have been set to ''anonymous''.

===Respondent Eligibility===

Decide whether everyone can answer or whether you want to restrict it to tutor only or student only responses. For restricted access options remember to assign the correct roles either at the course or activity level. For example, if you put a questionnaire on the front page, intended for teachers only, then you will have to let Moodle know which users are teachers.

===ALL Responses viewing===

====WHEN====

You can specify '''when''' Roles with the "''Read response summaries subject to open times''" capability can see the responses of ALL respondents to submitted questionnaires (i.e. the general statistics tables).

''' Students can view ALL responses -> '''

# ''' After answering the questionnaire'''.
# ''' After the questionnaire is closed'''.
# ''' Always.'''
# ''' Never.'''

====WHO (Which role can see what)====

Starting with Questionnaire version 2.'''5''', the ''"WHO" can view the ALL Responses report'' page settings have been moved to the Roles and Permissions settings.

As with all other Roles and capabilities settings in Moodle, you can set those permissions at site level, course level or activity level.

The following table sums up the correlation between the Questionnaire Response Options Settings and the Permissions settings. As you can see, the Roles and Permissions settings can OVERRIDE the Response options settings.

[[Image:2014-02-11_14-26-23.jpg]]

Note: 3.3 added the ''''Never'''" option. If this is selected, and the user does not have the "''Read all responses any time''" capability, then they will not be able to see all the responses at any time.

===Send submission notifications ===
Setting this to "Notification only" will use the Moodle notification system to notify roles with the "''mod/questionnaire:submissionnotification''" capability that a submission was made.
Setting this to "Full submission" will use the Moodle notification system to send the entire submission content to roles with the "''mod/questionnaire:submissionnotification''" when a submission is made. Note that full content will only be sent to notification plugins that support large messages (e.g. email).

===Save/Resume answers===

Setting this option allows users to save their answers to a questionnaire before submitting them. Users can leave the questionnaire unfinished and resume from the save point at a later date.

===Allow branching questions===

The Conditional Branching feature enables the Questionnaire creator to "branch" the respondent to different pages according to their choice of response to Yes/No, Dropdown boxes or Radio button questions. This option is enabled by default when you create a new questionnaire. If you do not plan to use this feature in the questionnaire, you should set it to No.

===Auto numbering===
If you have multiple questions or pages, you can choose to split them up and number them. You might want to disable automatic numbering for questionnaires with conditional branching.
# ''' Do not number questions or pages'''.
# ''' Auto number questions'''.
# ''' Auto number pages.'''
# ''' Auto number pages and questions.'''

===Submission grade===
Unlike the Quiz or Lesson Moodle activities the questionnaire activity is not meant to test the student's knowledge and therefore the responses cannot/should not be graded as correct or incorrect. However, in order to encourage the students to complete a questionnaire, you may choose to award the student a grade (on a 1-100 scale) upon completion.

==Content Options==

Select one of the radio button options. 'Create new' is the default.

'' You can create questionnaires using three different methods: ''
:''' Create New: '''
::This option allows you to create a completely new questionnaire from scratch.
:''' Copy Existing: '''
::This option copies a pre-existing questionnaire's content to a new questionnaire, pre-seeding the content. You can copy questionnaires belonging to the course, or ones specifically marked as 'template'.
:''' Use Template: '''
::This option consists of pre-existing templates from the activity that you can copy and edit into your questionnaire.
:''' Use Public: '''
::If a questionnaire has already been created (in another course on the same Moodle site) with the "public" setting, then you may use that "public" questionnaire in your own course(s). The number of settings available to such questionnaires is limited and you cannot edit its questions nor view the responses. ''''' Example: ''''' If a public questionnaire has been created in course A, it can be "used" in courses B, C, ... All the responses from courses A, B, C, ... are collected in the public questionnaire created in course A (the original course where it was created) and are viewable there by the person (admin or teacher) who originally created it.

=What next?=
Once you have clicked Save:

[https://docs.moodle.org/39/en/Setting_up_a_questionnaire Configure the questionnaire type]

[https://docs.moodle.org/39/en/Editing_Questionnaire_questions Add/Edit Questionnaire questions]

[[Category:Teacher]]

[[es:Añadiendo/editando un cuestionario]]
[[fr:Ajouter/modifier un questionnaire]]

Questionnaire Personality test

2017-12-11T22:00:24Z

Mchurch: /* Editing Questionnaire Feedback Sections */

{{Questionnaire}}

==Overview==

===Definition===
A personality test is a tool that attempts to measure a person's social interaction skills and patterns of behavior. (US legal definition).

In the Moodle Questionnaire add-on, the "personality test" feature enables a questionnaire creator to attribute different "values" to the answers to certain types of questions. Those values can be added into scores - globally or in several "sections" - and relevant feedback messages based on those scores can be displayed to the respondent.

Given the particular nature of the "personality test" feature, great care should be exercised when using it in questionnaires.

===Organization===
The following question types can be used with the "personality test" feature: ''Radio buttons'', ''Dropdown Box'', ''Rate'' and ''Yes/No''. In order for the answers to those questions to be "scored", they ''must'' have a '''question name''', must be '''required''' and each of their choices must have a '''value'''. For the ''Yes/No'' question, the default values are 1 for a Yes answer and 0 for a No.

===Settings===
See the examples below.

==Global Feedback example==

Adapted from [https://jobmob.co.il/blog/dr-phil-human-resources-personality-test https://jobmob.co.il/blog/dr-phil-human-resources-personality-test]

===Questions===
*Create Q1 as a ''Radio Buttons'' (or Dropdown Box) question type
**'''Question Name''': ''feel your best''
**'''Response Required''': ''Yes''. We are giving question Q1 a '''name''' and setting it as '''Required''' because we plan to use it in the Personality test feedback.
**'''Question Text''': When do you feel your best?
**'''Possible answers''':
***2=In the morning
***4=During the afternoon and early evening
***6=Late at night
Each possible answer choice begins with a value ''immediately followed'' by the equal sign (=) ''immediately followed'' by the choice words(*). The values attributed to the various choices must be carefully considered in order to obtain a coherent "score" when they are added up in the feedback score calculation. Here we are using the values as given in the "personality fun test" of our example.

(*) '''No space''' before nor after the equal sign (=).

Continue to create all 10 questions in the sample questionnaire.

===Advanced settings===
Now go to the questionnaire's '''Advanced settings''' page.
====Additional Info====
As usual you may use the ''Additional Info'' field to enter instructions for the respondents.
====Feedback options====
Now that your questionnaire contains a number of questions which fill the requirements mentioned above for using the Personality test feature, the '''Feedback options''' section is available. In the Feedback options dropdown box, select the first option available, i.e. Global Feedback.
You may use the ''Feedback notes'' field to enter text which will be displayed to your repondents at the end of their "Feedback report", e.g. external link to more information on the topic, etc.
Now click the '''Save settings and edit Feedback Sections''' button.
====Editing Questionnaire Feedback Sections====
On this page is displayed the full list of the questions available for the Feedback report. Since we have selected the Global feedback option, all those questions have been default-set in Section 1, the only section available here. Each question is displayed, and the "value" of each choice is displayed, to help you check their coherence.
Normally, you have nothing to change on that page. However you might want to remove one or several questions from the list by clicking the 0 radio button instead of the (Section) 1 button.
Now click on the '''Save Sections settings and edit Feedback Messages''' button.
====Editing Questionnaire Feedback Messages====
=====Global Feedback heading=====
* This begins with a list of the names of all the questions that are used in this Global Feedback section.
* The ''Label'' text box should be kept as short as possible. It will be displayed in the Feedback report and - when the Chart feature is avaiblable in a later version of Questionnaire - will be used in the Charts.
* In the ''Heading'' field you may type a brief heading text. You may use 2 variables in this heading, $scorepercent and $oppositescorepercent. One example is: "You scored $scorepercent in this questionnaire."
=====Global Feedback messages=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, still taken from our sample Personality "Fun" test.
*Feedback Score boundary
**100%
**Feedback : Others see you as someone they should "handle with care" You're seen as vain, self-centered, and who is extremely dominant. Others may admire you, wishing they could be more like you, but don't always trust you, hesitating to become too deeply involved with you.

*Feedback Score boundary
**94%
**Feedback : Others see you as an exciting, highly volatile, rather impulsive personality; a natural leader, who's quick to make decisions, though not always the right ones. [etc.]

*Feedback Score boundary
**85%
etc.

This starts with 3 default boundaries and associated messages, but you may add more boundaries if needed.

When finished, click the '''Save settings''' button.

===Report===
This is how the Feedback report will look like to a respondent after taking our sample questionnaire.

[[File:03-12-2013 12-21-49.jpg]]

# This table shows the global score for respondent plus, if any, the average global score for all participants. If the questionnaire is set to "separate groups", this box may show the average global score for the group that the actual respondent belongs to.
# In the first box of the Feedback Report we see the Heading text, which may include the value of the $scorepercent variable.
# In the second box we see the "personalized" feedback message, relevant to the Feedback score boundaries that the actual respondent's score sits in.

On the View all Responses page, the Feedback report heading will be displayed, together with the average Global score for All participants. If the questionnaire is set to "visible" or "separate groups", the average global score for the current group will be displayed.

[[File:03-12-2013 13-42-07.jpg]]

==Several sections Feedback example==
A simplistic "health habits" questionnaire.
===Questions===
*Create Q1 as a ''Rate'' question type
**'''Question Name''': ''sports''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you practise these sports?
**'''Possible answers''':
***0=never
***1=once a month
***2=every week
***3=every day
***cycling
***running
***swimming
***walking

*Create Q2 as a ''yes/no'' question type
**'''Question Name''': ''fruit and vegetables''
**'''Response Required''': ''Yes''.
**'''Question Text''': Do you regularly eat fresh fruit and vegetables?

*Create Q3 as a ''Radio buttons'' question type
**'''Question Name''': ''smoking''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you smoke?
**'''Possible answers''':
***3=never
***2=less than one packet per month
***1=one packet per week
***0=one packet per day

*Create Q4 as a ''Radio buttons'' question type
**'''Question Name''': ''drinking''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you drink alcohol?
**'''Possible answers''':
***3=never
***2=less than one glass per month
***1=one glass per week
***0=one glass per day

===Advanced settings===
Now go to the questionnaire's '''Advanced settings''' page.
====Additional Info====
As usual you may use the ''Additional Info'' field to enter instructions for the respondents.
====Feedback options====
Now that your questionnaire contains a number of questions which fill the requirements mentioned above for using the Personality test feature, the '''Feedback options''' section is available. In the Feedback options dropdown box, select 2 Feedback sections.
You may use the ''Feedback notes'' field to enter text which will be displayed to your respondents at the end of their "Feedback report", e.g. external link to more information on the topic, etc.

[[Image:feedbackoptions171211.png]]

Now click the '''Save settings and edit Feedback Sections''' button.

====Editing Questionnaire Feedback Sections====

On this page is displayed the full list of the questions available for the Feedback report. Each question is displayed, and the "value" of each choice is displayed, to help you check their coherence.
By default, the questions are not set into any Feedback Section (all check boxes are set at 0). You now have to select which section or sections you would like each question to be part of for the feedback report. At this stage, those 2 Feedback Sections have not yet been named, so you really have to be careful and make a mental note of "which is which". Suppose you want Section 1 to be related to your respondents' practise of sport, you would put question 1 into section 1 (click check box 1 for that question). Now suppose you want your second section to be related to "healthy attitude" towards food, drinking and smoking; click all the remaining check boxes "2" for questions 2, 3 and 4.

You also have the ability to choose a smaller weight for a question's scores per section. The fraction selected will be applied to the scores (individual and total) for that question in that section. That way a question can have a different impact on different sections. Note that selecting zero (0) is the same as selecting one (1).

Suppose you get it wrong and you mistakenly put all of your questions in Section 1. Upon clicking on the "Save" button, this error message would be displayed:
''You must select at least ONE question per section!
Section(s) not selected: 2''

[[Image:feedbacksections171211.png]]

Now click on the '''Save Sections settings and edit Feedback Messages''' button.

====Editing Questionnaire Feedback Messages====
=====Feedback heading for section 1/2=====
You will now get a screen very similar to the one you get for Global Feedback messages (as in our previous example). But you will get several screens, one per section.

* Questions in this section:
** sports
* Label: Physical activity
* Heading: Your "physical activity" score is $scorepercent.
=====Feedback messages for section 1/2=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, taken from our sample "Healthy habits" questionnaire.
*Feedback Score boundary
**100%
**Feedback: You must be very fit. Congratulations!

*Feedback Score boundary
**66%
**Feedback: Your physical activity is only average. Come on!

*Feedback Score boundary
**33%
**Feedback: You seem to be a real couch potato. Make an effort!

When finished, click the '''Next section (2/2)''' button.

=====Feedback heading for section 2/2=====
* Questions in this section:
** fruit and vegetables
** smoking
** drinking
* Label: Healthy habits
* Heading: Your "healthy habits" score is $scorepercent.

=====Feedback messages for section 2/2=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, taken from our sample "Healthy habits" questionnaire.
*Feedback Score boundary
**100%
**Feedback: You seem to have quite healthy habits. Continue!

*Feedback Score boundary
**66%
**Feedback: You seem to have not very healthy habits. Make an effort to cut down on drinking and smoking.

*Feedback Score boundary
**33%
**Feedback: You seem to have not terribly healthy habits. You must make a serious effort.

When finished, click the '''Save settings''' button.

===Report===
This is how the Feedback report will look like to a respondent after taking our sample questionnaire.

[[File:03-12-2013 14-53-07.jpg]]

This report is similar to the Global Feedback report in our previous example, except that now the score is separated into 2 sections.

==Bipolar results==
Some "personality tests" aim at detecting a bipolar characteristic in respondents' character. For example, whether an individual's profile is rather visual or auditory, global or analytic, extrovert or introvert etc. See Julian Rotter's theory of [http://en.wikipedia.org/wiki/Julian_Rotter#Locus_of_control Locus of Control].

In such cases, you can enter the section labels as a set of 2 opposed (bipolar) concepts, separated by a pipe character.

[[File:03-12-2013 14-58-51.jpg]]

In a questionnaire based on the Locus of Control theory, this "bipolar" heading will give the following kind of report:

[[File:03-12-2013 15-13-09.jpg]]

==Chart display==

===Site settings===
Upon installing or updating the Questionnaire plugin, its "site settings" page is displayed. On that ''Site administration ► Plugins ► Activity modules ► Questionnaire'' page, an admin can choose to enable the Chart feature site-wide. The default is ''No'' (do not enable). The Questionnaire Chart feature currently uses the [http://www.rgraph.net/ RGraph] libraries, which are licensed under the MIT type of open source license.

===Chart types===
Navigate to the ''Advanced settings'' page and click the ''Feedback options'' button.

You can choose to display or not the table of scores in the Feedback report.

The Chart type drop down list that is available is dependent on the number of feedback sections in your questionnaire.

* Global Feedback (i.e. one section only): Bipolar bars or Vertical Progress bar.
* 2 Sections: Bipolar bars or Horizontal bars or Rose.
* More than 2 sections: Bipolar bars or Horizontal bars or Radar or Rose.

Your choice of Chart type depends on the type of questions in your questionnaire. It's up to you to find out the most suitable Chart type. The Bipolar bars type is only suited when your feedback sections include Bipolar_results (see above).

The selected Chart will be displayed on the All Responses page. It will be constructed with all participants' results or, if the questionnaire is set to Visible Groups, with the results of the currently selected group.

On an Individual Responses page, the current user's current results Chart will be displayed, and also the All participants (or current group) results Chart.

Some samples illustrating the complete Chart types that can be used are displayed below.

Vertical Progress bar

[[File:02-01-2014 11-44-28.jpg]]

Bipolar bars

[[File:02-01-2014 11-40-05.jpg]]

Horizontal bars

[[File:02-01-2014 11-42-27.jpg]]

Radar

[[File:02-01-2014 11-37-47.jpg]]

Rose

[[File:02-01-2014 11-38-58.jpg]]

[[fr:Questionnaire_test_de_personnalité]]
[[es:Examen de personalidad de cuestionario]]

File:feedbacksections171211.png

2017-12-11T21:55:11Z

Mchurch: Feedback sections screen.

Feedback sections screen.

Questionnaire Personality test

2017-12-11T21:54:37Z

Mchurch: /* Editing Questionnaire Feedback Sections */

{{Questionnaire}}

==Overview==

===Definition===
A personality test is a tool that attempts to measure a person's social interaction skills and patterns of behavior. (US legal definition).

In the Moodle Questionnaire add-on, the "personality test" feature enables a questionnaire creator to attribute different "values" to the answers to certain types of questions. Those values can be added into scores - globally or in several "sections" - and relevant feedback messages based on those scores can be displayed to the respondent.

Given the particular nature of the "personality test" feature, great care should be exercised when using it in questionnaires.

===Organization===
The following question types can be used with the "personality test" feature: ''Radio buttons'', ''Dropdown Box'', ''Rate'' and ''Yes/No''. In order for the answers to those questions to be "scored", they ''must'' have a '''question name''', must be '''required''' and each of their choices must have a '''value'''. For the ''Yes/No'' question, the default values are 1 for a Yes answer and 0 for a No.

===Settings===
See the examples below.

==Global Feedback example==

Adapted from [https://jobmob.co.il/blog/dr-phil-human-resources-personality-test https://jobmob.co.il/blog/dr-phil-human-resources-personality-test]

===Questions===
*Create Q1 as a ''Radio Buttons'' (or Dropdown Box) question type
**'''Question Name''': ''feel your best''
**'''Response Required''': ''Yes''. We are giving question Q1 a '''name''' and setting it as '''Required''' because we plan to use it in the Personality test feedback.
**'''Question Text''': When do you feel your best?
**'''Possible answers''':
***2=In the morning
***4=During the afternoon and early evening
***6=Late at night
Each possible answer choice begins with a value ''immediately followed'' by the equal sign (=) ''immediately followed'' by the choice words(*). The values attributed to the various choices must be carefully considered in order to obtain a coherent "score" when they are added up in the feedback score calculation. Here we are using the values as given in the "personality fun test" of our example.

(*) '''No space''' before nor after the equal sign (=).

Continue to create all 10 questions in the sample questionnaire.

===Advanced settings===
Now go to the questionnaire's '''Advanced settings''' page.
====Additional Info====
As usual you may use the ''Additional Info'' field to enter instructions for the respondents.
====Feedback options====
Now that your questionnaire contains a number of questions which fill the requirements mentioned above for using the Personality test feature, the '''Feedback options''' section is available. In the Feedback options dropdown box, select the first option available, i.e. Global Feedback.
You may use the ''Feedback notes'' field to enter text which will be displayed to your repondents at the end of their "Feedback report", e.g. external link to more information on the topic, etc.
Now click the '''Save settings and edit Feedback Sections''' button.
====Editing Questionnaire Feedback Sections====
On this page is displayed the full list of the questions available for the Feedback report. Since we have selected the Global feedback option, all those questions have been default-set in Section 1, the only section available here. Each question is displayed, and the "value" of each choice is displayed, to help you check their coherence.
Normally, you have nothing to change on that page. However you might want to remove one or several questions from the list by clicking the 0 radio button instead of the (Section) 1 button.
Now click on the '''Save Sections settings and edit Feedback Messages''' button.
====Editing Questionnaire Feedback Messages====
=====Global Feedback heading=====
* This begins with a list of the names of all the questions that are used in this Global Feedback section.
* The ''Label'' text box should be kept as short as possible. It will be displayed in the Feedback report and - when the Chart feature is avaiblable in a later version of Questionnaire - will be used in the Charts.
* In the ''Heading'' field you may type a brief heading text. You may use 2 variables in this heading, $scorepercent and $oppositescorepercent. One example is: "You scored $scorepercent in this questionnaire."
=====Global Feedback messages=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, still taken from our sample Personality "Fun" test.
*Feedback Score boundary
**100%
**Feedback : Others see you as someone they should "handle with care" You're seen as vain, self-centered, and who is extremely dominant. Others may admire you, wishing they could be more like you, but don't always trust you, hesitating to become too deeply involved with you.

*Feedback Score boundary
**94%
**Feedback : Others see you as an exciting, highly volatile, rather impulsive personality; a natural leader, who's quick to make decisions, though not always the right ones. [etc.]

*Feedback Score boundary
**85%
etc.

This starts with 3 default boundaries and associated messages, but you may add more boundaries if needed.

When finished, click the '''Save settings''' button.

===Report===
This is how the Feedback report will look like to a respondent after taking our sample questionnaire.

[[File:03-12-2013 12-21-49.jpg]]

# This table shows the global score for respondent plus, if any, the average global score for all participants. If the questionnaire is set to "separate groups", this box may show the average global score for the group that the actual respondent belongs to.
# In the first box of the Feedback Report we see the Heading text, which may include the value of the $scorepercent variable.
# In the second box we see the "personalized" feedback message, relevant to the Feedback score boundaries that the actual respondent's score sits in.

On the View all Responses page, the Feedback report heading will be displayed, together with the average Global score for All participants. If the questionnaire is set to "visible" or "separate groups", the average global score for the current group will be displayed.

[[File:03-12-2013 13-42-07.jpg]]

==Several sections Feedback example==
A simplistic "health habits" questionnaire.
===Questions===
*Create Q1 as a ''Rate'' question type
**'''Question Name''': ''sports''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you practise these sports?
**'''Possible answers''':
***0=never
***1=once a month
***2=every week
***3=every day
***cycling
***running
***swimming
***walking

*Create Q2 as a ''yes/no'' question type
**'''Question Name''': ''fruit and vegetables''
**'''Response Required''': ''Yes''.
**'''Question Text''': Do you regularly eat fresh fruit and vegetables?

*Create Q3 as a ''Radio buttons'' question type
**'''Question Name''': ''smoking''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you smoke?
**'''Possible answers''':
***3=never
***2=less than one packet per month
***1=one packet per week
***0=one packet per day

*Create Q4 as a ''Radio buttons'' question type
**'''Question Name''': ''drinking''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you drink alcohol?
**'''Possible answers''':
***3=never
***2=less than one glass per month
***1=one glass per week
***0=one glass per day

===Advanced settings===
Now go to the questionnaire's '''Advanced settings''' page.
====Additional Info====
As usual you may use the ''Additional Info'' field to enter instructions for the respondents.
====Feedback options====
Now that your questionnaire contains a number of questions which fill the requirements mentioned above for using the Personality test feature, the '''Feedback options''' section is available. In the Feedback options dropdown box, select 2 Feedback sections.
You may use the ''Feedback notes'' field to enter text which will be displayed to your respondents at the end of their "Feedback report", e.g. external link to more information on the topic, etc.

[[Image:feedbackoptions171211.png]]

Now click the '''Save settings and edit Feedback Sections''' button.

====Editing Questionnaire Feedback Sections====

On this page is displayed the full list of the questions available for the Feedback report. Each question is displayed, and the "value" of each choice is displayed, to help you check their coherence.
By default, the questions are not set into any Feedback Section (all radio buttons are set at 0). You now have to set each question into one of the 2 Sections you decided to display in your questionnaire's Feedback Report. At this stage, those 2 Feedback Sections have not yet been named, so you really have to be careful and make a mental note of "which is which". Suppose you want Section 1 to be related to your respondents' practise of sport, you would put question 1 into section 1 (click radio button 1 for that question). Now suppose you want your second section to be related to "healthy attitude" towards food, drinking and smoking; click all the remaining radio buttons "2" for questions 2, 3 and 4.

Suppose you get it wrong and you mistakenly put all of your questions in Section 1. Upon clicking on the "Save" button, this error message would be displayed:
''You must select at least ONE question per section!
Section(s) not selected: 2''

[[Image:feedbacksections171211.png]]

Now click on the '''Save Sections settings and edit Feedback Messages''' button.

====Editing Questionnaire Feedback Messages====
=====Feedback heading for section 1/2=====
You will now get a screen very similar to the one you get for Global Feedback messages (as in our previous example). But you will get several screens, one per section.

* Questions in this section:
** sports
* Label: Physical activity
* Heading: Your "physical activity" score is $scorepercent.
=====Feedback messages for section 1/2=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, taken from our sample "Healthy habits" questionnaire.
*Feedback Score boundary
**100%
**Feedback: You must be very fit. Congratulations!

*Feedback Score boundary
**66%
**Feedback: Your physical activity is only average. Come on!

*Feedback Score boundary
**33%
**Feedback: You seem to be a real couch potato. Make an effort!

When finished, click the '''Next section (2/2)''' button.

=====Feedback heading for section 2/2=====
* Questions in this section:
** fruit and vegetables
** smoking
** drinking
* Label: Healthy habits
* Heading: Your "healthy habits" score is $scorepercent.

=====Feedback messages for section 2/2=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, taken from our sample "Healthy habits" questionnaire.
*Feedback Score boundary
**100%
**Feedback: You seem to have quite healthy habits. Continue!

*Feedback Score boundary
**66%
**Feedback: You seem to have not very healthy habits. Make an effort to cut down on drinking and smoking.

*Feedback Score boundary
**33%
**Feedback: You seem to have not terribly healthy habits. You must make a serious effort.

When finished, click the '''Save settings''' button.

===Report===
This is how the Feedback report will look like to a respondent after taking our sample questionnaire.

[[File:03-12-2013 14-53-07.jpg]]

This report is similar to the Global Feedback report in our previous example, except that now the score is separated into 2 sections.

==Bipolar results==
Some "personality tests" aim at detecting a bipolar characteristic in respondents' character. For example, whether an individual's profile is rather visual or auditory, global or analytic, extrovert or introvert etc. See Julian Rotter's theory of [http://en.wikipedia.org/wiki/Julian_Rotter#Locus_of_control Locus of Control].

In such cases, you can enter the section labels as a set of 2 opposed (bipolar) concepts, separated by a pipe character.

[[File:03-12-2013 14-58-51.jpg]]

In a questionnaire based on the Locus of Control theory, this "bipolar" heading will give the following kind of report:

[[File:03-12-2013 15-13-09.jpg]]

==Chart display==

===Site settings===
Upon installing or updating the Questionnaire plugin, its "site settings" page is displayed. On that ''Site administration ► Plugins ► Activity modules ► Questionnaire'' page, an admin can choose to enable the Chart feature site-wide. The default is ''No'' (do not enable). The Questionnaire Chart feature currently uses the [http://www.rgraph.net/ RGraph] libraries, which are licensed under the MIT type of open source license.

===Chart types===
Navigate to the ''Advanced settings'' page and click the ''Feedback options'' button.

You can choose to display or not the table of scores in the Feedback report.

The Chart type drop down list that is available is dependent on the number of feedback sections in your questionnaire.

* Global Feedback (i.e. one section only): Bipolar bars or Vertical Progress bar.
* 2 Sections: Bipolar bars or Horizontal bars or Rose.
* More than 2 sections: Bipolar bars or Horizontal bars or Radar or Rose.

Your choice of Chart type depends on the type of questions in your questionnaire. It's up to you to find out the most suitable Chart type. The Bipolar bars type is only suited when your feedback sections include Bipolar_results (see above).

The selected Chart will be displayed on the All Responses page. It will be constructed with all participants' results or, if the questionnaire is set to Visible Groups, with the results of the currently selected group.

On an Individual Responses page, the current user's current results Chart will be displayed, and also the All participants (or current group) results Chart.

Some samples illustrating the complete Chart types that can be used are displayed below.

Vertical Progress bar

[[File:02-01-2014 11-44-28.jpg]]

Bipolar bars

[[File:02-01-2014 11-40-05.jpg]]

Horizontal bars

[[File:02-01-2014 11-42-27.jpg]]

Radar

[[File:02-01-2014 11-37-47.jpg]]

Rose

[[File:02-01-2014 11-38-58.jpg]]

[[fr:Questionnaire_test_de_personnalité]]
[[es:Examen de personalidad de cuestionario]]

Questionnaire Personality test

2017-12-11T21:49:37Z

Mchurch: /* Feedback options */

{{Questionnaire}}

==Overview==

===Definition===
A personality test is a tool that attempts to measure a person's social interaction skills and patterns of behavior. (US legal definition).

In the Moodle Questionnaire add-on, the "personality test" feature enables a questionnaire creator to attribute different "values" to the answers to certain types of questions. Those values can be added into scores - globally or in several "sections" - and relevant feedback messages based on those scores can be displayed to the respondent.

Given the particular nature of the "personality test" feature, great care should be exercised when using it in questionnaires.

===Organization===
The following question types can be used with the "personality test" feature: ''Radio buttons'', ''Dropdown Box'', ''Rate'' and ''Yes/No''. In order for the answers to those questions to be "scored", they ''must'' have a '''question name''', must be '''required''' and each of their choices must have a '''value'''. For the ''Yes/No'' question, the default values are 1 for a Yes answer and 0 for a No.

===Settings===
See the examples below.

==Global Feedback example==

Adapted from [https://jobmob.co.il/blog/dr-phil-human-resources-personality-test https://jobmob.co.il/blog/dr-phil-human-resources-personality-test]

===Questions===
*Create Q1 as a ''Radio Buttons'' (or Dropdown Box) question type
**'''Question Name''': ''feel your best''
**'''Response Required''': ''Yes''. We are giving question Q1 a '''name''' and setting it as '''Required''' because we plan to use it in the Personality test feedback.
**'''Question Text''': When do you feel your best?
**'''Possible answers''':
***2=In the morning
***4=During the afternoon and early evening
***6=Late at night
Each possible answer choice begins with a value ''immediately followed'' by the equal sign (=) ''immediately followed'' by the choice words(*). The values attributed to the various choices must be carefully considered in order to obtain a coherent "score" when they are added up in the feedback score calculation. Here we are using the values as given in the "personality fun test" of our example.

(*) '''No space''' before nor after the equal sign (=).

Continue to create all 10 questions in the sample questionnaire.

===Advanced settings===
Now go to the questionnaire's '''Advanced settings''' page.
====Additional Info====
As usual you may use the ''Additional Info'' field to enter instructions for the respondents.
====Feedback options====
Now that your questionnaire contains a number of questions which fill the requirements mentioned above for using the Personality test feature, the '''Feedback options''' section is available. In the Feedback options dropdown box, select the first option available, i.e. Global Feedback.
You may use the ''Feedback notes'' field to enter text which will be displayed to your repondents at the end of their "Feedback report", e.g. external link to more information on the topic, etc.
Now click the '''Save settings and edit Feedback Sections''' button.
====Editing Questionnaire Feedback Sections====
On this page is displayed the full list of the questions available for the Feedback report. Since we have selected the Global feedback option, all those questions have been default-set in Section 1, the only section available here. Each question is displayed, and the "value" of each choice is displayed, to help you check their coherence.
Normally, you have nothing to change on that page. However you might want to remove one or several questions from the list by clicking the 0 radio button instead of the (Section) 1 button.
Now click on the '''Save Sections settings and edit Feedback Messages''' button.
====Editing Questionnaire Feedback Messages====
=====Global Feedback heading=====
* This begins with a list of the names of all the questions that are used in this Global Feedback section.
* The ''Label'' text box should be kept as short as possible. It will be displayed in the Feedback report and - when the Chart feature is avaiblable in a later version of Questionnaire - will be used in the Charts.
* In the ''Heading'' field you may type a brief heading text. You may use 2 variables in this heading, $scorepercent and $oppositescorepercent. One example is: "You scored $scorepercent in this questionnaire."
=====Global Feedback messages=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, still taken from our sample Personality "Fun" test.
*Feedback Score boundary
**100%
**Feedback : Others see you as someone they should "handle with care" You're seen as vain, self-centered, and who is extremely dominant. Others may admire you, wishing they could be more like you, but don't always trust you, hesitating to become too deeply involved with you.

*Feedback Score boundary
**94%
**Feedback : Others see you as an exciting, highly volatile, rather impulsive personality; a natural leader, who's quick to make decisions, though not always the right ones. [etc.]

*Feedback Score boundary
**85%
etc.

This starts with 3 default boundaries and associated messages, but you may add more boundaries if needed.

When finished, click the '''Save settings''' button.

===Report===
This is how the Feedback report will look like to a respondent after taking our sample questionnaire.

[[File:03-12-2013 12-21-49.jpg]]

# This table shows the global score for respondent plus, if any, the average global score for all participants. If the questionnaire is set to "separate groups", this box may show the average global score for the group that the actual respondent belongs to.
# In the first box of the Feedback Report we see the Heading text, which may include the value of the $scorepercent variable.
# In the second box we see the "personalized" feedback message, relevant to the Feedback score boundaries that the actual respondent's score sits in.

On the View all Responses page, the Feedback report heading will be displayed, together with the average Global score for All participants. If the questionnaire is set to "visible" or "separate groups", the average global score for the current group will be displayed.

[[File:03-12-2013 13-42-07.jpg]]

==Several sections Feedback example==
A simplistic "health habits" questionnaire.
===Questions===
*Create Q1 as a ''Rate'' question type
**'''Question Name''': ''sports''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you practise these sports?
**'''Possible answers''':
***0=never
***1=once a month
***2=every week
***3=every day
***cycling
***running
***swimming
***walking

*Create Q2 as a ''yes/no'' question type
**'''Question Name''': ''fruit and vegetables''
**'''Response Required''': ''Yes''.
**'''Question Text''': Do you regularly eat fresh fruit and vegetables?

*Create Q3 as a ''Radio buttons'' question type
**'''Question Name''': ''smoking''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you smoke?
**'''Possible answers''':
***3=never
***2=less than one packet per month
***1=one packet per week
***0=one packet per day

*Create Q4 as a ''Radio buttons'' question type
**'''Question Name''': ''drinking''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you drink alcohol?
**'''Possible answers''':
***3=never
***2=less than one glass per month
***1=one glass per week
***0=one glass per day

===Advanced settings===
Now go to the questionnaire's '''Advanced settings''' page.
====Additional Info====
As usual you may use the ''Additional Info'' field to enter instructions for the respondents.
====Feedback options====
Now that your questionnaire contains a number of questions which fill the requirements mentioned above for using the Personality test feature, the '''Feedback options''' section is available. In the Feedback options dropdown box, select 2 Feedback sections.
You may use the ''Feedback notes'' field to enter text which will be displayed to your respondents at the end of their "Feedback report", e.g. external link to more information on the topic, etc.

[[Image:feedbackoptions171211.png]]

Now click the '''Save settings and edit Feedback Sections''' button.

====Editing Questionnaire Feedback Sections====

On this page is displayed the full list of the questions available for the Feedback report. Each question is displayed, and the "value" of each choice is displayed, to help you check their coherence.
By default, the questions are not set into any Feedback Section (all radio buttons are set at 0). You now have to set each question into one of the 2 Sections you decided to display in your questionnaire's Feedback Report. At this stage, those 2 Feedback Sections have not yet been named, so you really have to be careful and make a mental note of "which is which". Suppose you want Section 1 to be related to your respondents' practise of sport, you would put question 1 into section 1 (click radio button 1 for that question). Now suppose you want your second section to be related to "healthy attitude" towards food, drinking and smoking; click all the remaining radio buttons "2" for questions 2, 3 and 4.

Suppose you get it wrong and you mistakenly put all of your questions in Section 1. Upon clicking on the "Save" button, this error message would be displayed:
''You must select at least ONE question per section!
Section(s) not selected: 2''

Now click on the '''Save Sections settings and edit Feedback Messages''' button.
====Editing Questionnaire Feedback Messages====
=====Feedback heading for section 1/2=====
You will now get a screen very similar to the one you get for Global Feedback messages (as in our previous example). But you will get several screens, one per section.

* Questions in this section:
** sports
* Label: Physical activity
* Heading: Your "physical activity" score is $scorepercent.
=====Feedback messages for section 1/2=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, taken from our sample "Healthy habits" questionnaire.
*Feedback Score boundary
**100%
**Feedback: You must be very fit. Congratulations!

*Feedback Score boundary
**66%
**Feedback: Your physical activity is only average. Come on!

*Feedback Score boundary
**33%
**Feedback: You seem to be a real couch potato. Make an effort!

When finished, click the '''Next section (2/2)''' button.

=====Feedback heading for section 2/2=====
* Questions in this section:
** fruit and vegetables
** smoking
** drinking
* Label: Healthy habits
* Heading: Your "healthy habits" score is $scorepercent.

=====Feedback messages for section 2/2=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, taken from our sample "Healthy habits" questionnaire.
*Feedback Score boundary
**100%
**Feedback: You seem to have quite healthy habits. Continue!

*Feedback Score boundary
**66%
**Feedback: You seem to have not very healthy habits. Make an effort to cut down on drinking and smoking.

*Feedback Score boundary
**33%
**Feedback: You seem to have not terribly healthy habits. You must make a serious effort.

When finished, click the '''Save settings''' button.

===Report===
This is how the Feedback report will look like to a respondent after taking our sample questionnaire.

[[File:03-12-2013 14-53-07.jpg]]

This report is similar to the Global Feedback report in our previous example, except that now the score is separated into 2 sections.

==Bipolar results==
Some "personality tests" aim at detecting a bipolar characteristic in respondents' character. For example, whether an individual's profile is rather visual or auditory, global or analytic, extrovert or introvert etc. See Julian Rotter's theory of [http://en.wikipedia.org/wiki/Julian_Rotter#Locus_of_control Locus of Control].

In such cases, you can enter the section labels as a set of 2 opposed (bipolar) concepts, separated by a pipe character.

[[File:03-12-2013 14-58-51.jpg]]

In a questionnaire based on the Locus of Control theory, this "bipolar" heading will give the following kind of report:

[[File:03-12-2013 15-13-09.jpg]]

==Chart display==

===Site settings===
Upon installing or updating the Questionnaire plugin, its "site settings" page is displayed. On that ''Site administration ► Plugins ► Activity modules ► Questionnaire'' page, an admin can choose to enable the Chart feature site-wide. The default is ''No'' (do not enable). The Questionnaire Chart feature currently uses the [http://www.rgraph.net/ RGraph] libraries, which are licensed under the MIT type of open source license.

===Chart types===
Navigate to the ''Advanced settings'' page and click the ''Feedback options'' button.

You can choose to display or not the table of scores in the Feedback report.

The Chart type drop down list that is available is dependent on the number of feedback sections in your questionnaire.

* Global Feedback (i.e. one section only): Bipolar bars or Vertical Progress bar.
* 2 Sections: Bipolar bars or Horizontal bars or Rose.
* More than 2 sections: Bipolar bars or Horizontal bars or Radar or Rose.

Your choice of Chart type depends on the type of questions in your questionnaire. It's up to you to find out the most suitable Chart type. The Bipolar bars type is only suited when your feedback sections include Bipolar_results (see above).

The selected Chart will be displayed on the All Responses page. It will be constructed with all participants' results or, if the questionnaire is set to Visible Groups, with the results of the currently selected group.

On an Individual Responses page, the current user's current results Chart will be displayed, and also the All participants (or current group) results Chart.

Some samples illustrating the complete Chart types that can be used are displayed below.

Vertical Progress bar

[[File:02-01-2014 11-44-28.jpg]]

Bipolar bars

[[File:02-01-2014 11-40-05.jpg]]

Horizontal bars

[[File:02-01-2014 11-42-27.jpg]]

Radar

[[File:02-01-2014 11-37-47.jpg]]

Rose

[[File:02-01-2014 11-38-58.jpg]]

[[fr:Questionnaire_test_de_personnalité]]
[[es:Examen de personalidad de cuestionario]]

File:feedbackoptions171211.png

2017-12-11T21:49:06Z

Mchurch: Feedback options screen.

Feedback options screen.

Questionnaire Personality test

2017-12-11T21:47:49Z

Mchurch: /* Feedback options */

{{Questionnaire}}

==Overview==

===Definition===
A personality test is a tool that attempts to measure a person's social interaction skills and patterns of behavior. (US legal definition).

In the Moodle Questionnaire add-on, the "personality test" feature enables a questionnaire creator to attribute different "values" to the answers to certain types of questions. Those values can be added into scores - globally or in several "sections" - and relevant feedback messages based on those scores can be displayed to the respondent.

Given the particular nature of the "personality test" feature, great care should be exercised when using it in questionnaires.

===Organization===
The following question types can be used with the "personality test" feature: ''Radio buttons'', ''Dropdown Box'', ''Rate'' and ''Yes/No''. In order for the answers to those questions to be "scored", they ''must'' have a '''question name''', must be '''required''' and each of their choices must have a '''value'''. For the ''Yes/No'' question, the default values are 1 for a Yes answer and 0 for a No.

===Settings===
See the examples below.

==Global Feedback example==

Adapted from [https://jobmob.co.il/blog/dr-phil-human-resources-personality-test https://jobmob.co.il/blog/dr-phil-human-resources-personality-test]

===Questions===
*Create Q1 as a ''Radio Buttons'' (or Dropdown Box) question type
**'''Question Name''': ''feel your best''
**'''Response Required''': ''Yes''. We are giving question Q1 a '''name''' and setting it as '''Required''' because we plan to use it in the Personality test feedback.
**'''Question Text''': When do you feel your best?
**'''Possible answers''':
***2=In the morning
***4=During the afternoon and early evening
***6=Late at night
Each possible answer choice begins with a value ''immediately followed'' by the equal sign (=) ''immediately followed'' by the choice words(*). The values attributed to the various choices must be carefully considered in order to obtain a coherent "score" when they are added up in the feedback score calculation. Here we are using the values as given in the "personality fun test" of our example.

(*) '''No space''' before nor after the equal sign (=).

Continue to create all 10 questions in the sample questionnaire.

===Advanced settings===
Now go to the questionnaire's '''Advanced settings''' page.
====Additional Info====
As usual you may use the ''Additional Info'' field to enter instructions for the respondents.
====Feedback options====
Now that your questionnaire contains a number of questions which fill the requirements mentioned above for using the Personality test feature, the '''Feedback options''' section is available. In the Feedback options dropdown box, select the first option available, i.e. Global Feedback.
You may use the ''Feedback notes'' field to enter text which will be displayed to your repondents at the end of their "Feedback report", e.g. external link to more information on the topic, etc.
Now click the '''Save settings and edit Feedback Sections''' button.
====Editing Questionnaire Feedback Sections====
On this page is displayed the full list of the questions available for the Feedback report. Since we have selected the Global feedback option, all those questions have been default-set in Section 1, the only section available here. Each question is displayed, and the "value" of each choice is displayed, to help you check their coherence.
Normally, you have nothing to change on that page. However you might want to remove one or several questions from the list by clicking the 0 radio button instead of the (Section) 1 button.
Now click on the '''Save Sections settings and edit Feedback Messages''' button.
====Editing Questionnaire Feedback Messages====
=====Global Feedback heading=====
* This begins with a list of the names of all the questions that are used in this Global Feedback section.
* The ''Label'' text box should be kept as short as possible. It will be displayed in the Feedback report and - when the Chart feature is avaiblable in a later version of Questionnaire - will be used in the Charts.
* In the ''Heading'' field you may type a brief heading text. You may use 2 variables in this heading, $scorepercent and $oppositescorepercent. One example is: "You scored $scorepercent in this questionnaire."
=====Global Feedback messages=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, still taken from our sample Personality "Fun" test.
*Feedback Score boundary
**100%
**Feedback : Others see you as someone they should "handle with care" You're seen as vain, self-centered, and who is extremely dominant. Others may admire you, wishing they could be more like you, but don't always trust you, hesitating to become too deeply involved with you.

*Feedback Score boundary
**94%
**Feedback : Others see you as an exciting, highly volatile, rather impulsive personality; a natural leader, who's quick to make decisions, though not always the right ones. [etc.]

*Feedback Score boundary
**85%
etc.

This starts with 3 default boundaries and associated messages, but you may add more boundaries if needed.

When finished, click the '''Save settings''' button.

===Report===
This is how the Feedback report will look like to a respondent after taking our sample questionnaire.

[[File:03-12-2013 12-21-49.jpg]]

# This table shows the global score for respondent plus, if any, the average global score for all participants. If the questionnaire is set to "separate groups", this box may show the average global score for the group that the actual respondent belongs to.
# In the first box of the Feedback Report we see the Heading text, which may include the value of the $scorepercent variable.
# In the second box we see the "personalized" feedback message, relevant to the Feedback score boundaries that the actual respondent's score sits in.

On the View all Responses page, the Feedback report heading will be displayed, together with the average Global score for All participants. If the questionnaire is set to "visible" or "separate groups", the average global score for the current group will be displayed.

[[File:03-12-2013 13-42-07.jpg]]

==Several sections Feedback example==
A simplistic "health habits" questionnaire.
===Questions===
*Create Q1 as a ''Rate'' question type
**'''Question Name''': ''sports''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you practise these sports?
**'''Possible answers''':
***0=never
***1=once a month
***2=every week
***3=every day
***cycling
***running
***swimming
***walking

*Create Q2 as a ''yes/no'' question type
**'''Question Name''': ''fruit and vegetables''
**'''Response Required''': ''Yes''.
**'''Question Text''': Do you regularly eat fresh fruit and vegetables?

*Create Q3 as a ''Radio buttons'' question type
**'''Question Name''': ''smoking''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you smoke?
**'''Possible answers''':
***3=never
***2=less than one packet per month
***1=one packet per week
***0=one packet per day

*Create Q4 as a ''Radio buttons'' question type
**'''Question Name''': ''drinking''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you drink alcohol?
**'''Possible answers''':
***3=never
***2=less than one glass per month
***1=one glass per week
***0=one glass per day

===Advanced settings===
Now go to the questionnaire's '''Advanced settings''' page.
====Additional Info====
As usual you may use the ''Additional Info'' field to enter instructions for the respondents.
====Feedback options====
Now that your questionnaire contains a number of questions which fill the requirements mentioned above for using the Personality test feature, the '''Feedback options''' section is available. In the Feedback options dropdown box, select 2 Feedback sections.
You may use the ''Feedback notes'' field to enter text which will be displayed to your respondents at the end of their "Feedback report", e.g. external link to more information on the topic, etc.

[[Image:feedbackoptions171211.png]]
[[File:03-12-2013 14-23-55.jpg]]

Now click the '''Save settings and edit Feedback Sections''' button.

====Editing Questionnaire Feedback Sections====

On this page is displayed the full list of the questions available for the Feedback report. Each question is displayed, and the "value" of each choice is displayed, to help you check their coherence.
By default, the questions are not set into any Feedback Section (all radio buttons are set at 0). You now have to set each question into one of the 2 Sections you decided to display in your questionnaire's Feedback Report. At this stage, those 2 Feedback Sections have not yet been named, so you really have to be careful and make a mental note of "which is which". Suppose you want Section 1 to be related to your respondents' practise of sport, you would put question 1 into section 1 (click radio button 1 for that question). Now suppose you want your second section to be related to "healthy attitude" towards food, drinking and smoking; click all the remaining radio buttons "2" for questions 2, 3 and 4.

Suppose you get it wrong and you mistakenly put all of your questions in Section 1. Upon clicking on the "Save" button, this error message would be displayed:
''You must select at least ONE question per section!
Section(s) not selected: 2''

Now click on the '''Save Sections settings and edit Feedback Messages''' button.
====Editing Questionnaire Feedback Messages====
=====Feedback heading for section 1/2=====
You will now get a screen very similar to the one you get for Global Feedback messages (as in our previous example). But you will get several screens, one per section.

* Questions in this section:
** sports
* Label: Physical activity
* Heading: Your "physical activity" score is $scorepercent.
=====Feedback messages for section 1/2=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, taken from our sample "Healthy habits" questionnaire.
*Feedback Score boundary
**100%
**Feedback: You must be very fit. Congratulations!

*Feedback Score boundary
**66%
**Feedback: Your physical activity is only average. Come on!

*Feedback Score boundary
**33%
**Feedback: You seem to be a real couch potato. Make an effort!

When finished, click the '''Next section (2/2)''' button.

=====Feedback heading for section 2/2=====
* Questions in this section:
** fruit and vegetables
** smoking
** drinking
* Label: Healthy habits
* Heading: Your "healthy habits" score is $scorepercent.

=====Feedback messages for section 2/2=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, taken from our sample "Healthy habits" questionnaire.
*Feedback Score boundary
**100%
**Feedback: You seem to have quite healthy habits. Continue!

*Feedback Score boundary
**66%
**Feedback: You seem to have not very healthy habits. Make an effort to cut down on drinking and smoking.

*Feedback Score boundary
**33%
**Feedback: You seem to have not terribly healthy habits. You must make a serious effort.

When finished, click the '''Save settings''' button.

===Report===
This is how the Feedback report will look like to a respondent after taking our sample questionnaire.

[[File:03-12-2013 14-53-07.jpg]]

This report is similar to the Global Feedback report in our previous example, except that now the score is separated into 2 sections.

==Bipolar results==
Some "personality tests" aim at detecting a bipolar characteristic in respondents' character. For example, whether an individual's profile is rather visual or auditory, global or analytic, extrovert or introvert etc. See Julian Rotter's theory of [http://en.wikipedia.org/wiki/Julian_Rotter#Locus_of_control Locus of Control].

In such cases, you can enter the section labels as a set of 2 opposed (bipolar) concepts, separated by a pipe character.

[[File:03-12-2013 14-58-51.jpg]]

In a questionnaire based on the Locus of Control theory, this "bipolar" heading will give the following kind of report:

[[File:03-12-2013 15-13-09.jpg]]

==Chart display==

===Site settings===
Upon installing or updating the Questionnaire plugin, its "site settings" page is displayed. On that ''Site administration ► Plugins ► Activity modules ► Questionnaire'' page, an admin can choose to enable the Chart feature site-wide. The default is ''No'' (do not enable). The Questionnaire Chart feature currently uses the [http://www.rgraph.net/ RGraph] libraries, which are licensed under the MIT type of open source license.

===Chart types===
Navigate to the ''Advanced settings'' page and click the ''Feedback options'' button.

You can choose to display or not the table of scores in the Feedback report.

The Chart type drop down list that is available is dependent on the number of feedback sections in your questionnaire.

* Global Feedback (i.e. one section only): Bipolar bars or Vertical Progress bar.
* 2 Sections: Bipolar bars or Horizontal bars or Rose.
* More than 2 sections: Bipolar bars or Horizontal bars or Radar or Rose.

Your choice of Chart type depends on the type of questions in your questionnaire. It's up to you to find out the most suitable Chart type. The Bipolar bars type is only suited when your feedback sections include Bipolar_results (see above).

The selected Chart will be displayed on the All Responses page. It will be constructed with all participants' results or, if the questionnaire is set to Visible Groups, with the results of the currently selected group.

On an Individual Responses page, the current user's current results Chart will be displayed, and also the All participants (or current group) results Chart.

Some samples illustrating the complete Chart types that can be used are displayed below.

Vertical Progress bar

[[File:02-01-2014 11-44-28.jpg]]

Bipolar bars

[[File:02-01-2014 11-40-05.jpg]]

Horizontal bars

[[File:02-01-2014 11-42-27.jpg]]

Radar

[[File:02-01-2014 11-37-47.jpg]]

Rose

[[File:02-01-2014 11-38-58.jpg]]

[[fr:Questionnaire_test_de_personnalité]]
[[es:Examen de personalidad de cuestionario]]

Questionnaire Personality test

2017-12-11T21:47:11Z

Mchurch: /* Feedback options */

{{Questionnaire}}

==Overview==

===Definition===
A personality test is a tool that attempts to measure a person's social interaction skills and patterns of behavior. (US legal definition).

In the Moodle Questionnaire add-on, the "personality test" feature enables a questionnaire creator to attribute different "values" to the answers to certain types of questions. Those values can be added into scores - globally or in several "sections" - and relevant feedback messages based on those scores can be displayed to the respondent.

Given the particular nature of the "personality test" feature, great care should be exercised when using it in questionnaires.

===Organization===
The following question types can be used with the "personality test" feature: ''Radio buttons'', ''Dropdown Box'', ''Rate'' and ''Yes/No''. In order for the answers to those questions to be "scored", they ''must'' have a '''question name''', must be '''required''' and each of their choices must have a '''value'''. For the ''Yes/No'' question, the default values are 1 for a Yes answer and 0 for a No.

===Settings===
See the examples below.

==Global Feedback example==

Adapted from [https://jobmob.co.il/blog/dr-phil-human-resources-personality-test https://jobmob.co.il/blog/dr-phil-human-resources-personality-test]

===Questions===
*Create Q1 as a ''Radio Buttons'' (or Dropdown Box) question type
**'''Question Name''': ''feel your best''
**'''Response Required''': ''Yes''. We are giving question Q1 a '''name''' and setting it as '''Required''' because we plan to use it in the Personality test feedback.
**'''Question Text''': When do you feel your best?
**'''Possible answers''':
***2=In the morning
***4=During the afternoon and early evening
***6=Late at night
Each possible answer choice begins with a value ''immediately followed'' by the equal sign (=) ''immediately followed'' by the choice words(*). The values attributed to the various choices must be carefully considered in order to obtain a coherent "score" when they are added up in the feedback score calculation. Here we are using the values as given in the "personality fun test" of our example.

(*) '''No space''' before nor after the equal sign (=).

Continue to create all 10 questions in the sample questionnaire.

===Advanced settings===
Now go to the questionnaire's '''Advanced settings''' page.
====Additional Info====
As usual you may use the ''Additional Info'' field to enter instructions for the respondents.
====Feedback options====
Now that your questionnaire contains a number of questions which fill the requirements mentioned above for using the Personality test feature, the '''Feedback options''' section is available. In the Feedback options dropdown box, select the first option available, i.e. Global Feedback.
You may use the ''Feedback notes'' field to enter text which will be displayed to your repondents at the end of their "Feedback report", e.g. external link to more information on the topic, etc.
Now click the '''Save settings and edit Feedback Sections''' button.
====Editing Questionnaire Feedback Sections====
On this page is displayed the full list of the questions available for the Feedback report. Since we have selected the Global feedback option, all those questions have been default-set in Section 1, the only section available here. Each question is displayed, and the "value" of each choice is displayed, to help you check their coherence.
Normally, you have nothing to change on that page. However you might want to remove one or several questions from the list by clicking the 0 radio button instead of the (Section) 1 button.
Now click on the '''Save Sections settings and edit Feedback Messages''' button.
====Editing Questionnaire Feedback Messages====
=====Global Feedback heading=====
* This begins with a list of the names of all the questions that are used in this Global Feedback section.
* The ''Label'' text box should be kept as short as possible. It will be displayed in the Feedback report and - when the Chart feature is avaiblable in a later version of Questionnaire - will be used in the Charts.
* In the ''Heading'' field you may type a brief heading text. You may use 2 variables in this heading, $scorepercent and $oppositescorepercent. One example is: "You scored $scorepercent in this questionnaire."
=====Global Feedback messages=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, still taken from our sample Personality "Fun" test.
*Feedback Score boundary
**100%
**Feedback : Others see you as someone they should "handle with care" You're seen as vain, self-centered, and who is extremely dominant. Others may admire you, wishing they could be more like you, but don't always trust you, hesitating to become too deeply involved with you.

*Feedback Score boundary
**94%
**Feedback : Others see you as an exciting, highly volatile, rather impulsive personality; a natural leader, who's quick to make decisions, though not always the right ones. [etc.]

*Feedback Score boundary
**85%
etc.

This starts with 3 default boundaries and associated messages, but you may add more boundaries if needed.

When finished, click the '''Save settings''' button.

===Report===
This is how the Feedback report will look like to a respondent after taking our sample questionnaire.

[[File:03-12-2013 12-21-49.jpg]]

# This table shows the global score for respondent plus, if any, the average global score for all participants. If the questionnaire is set to "separate groups", this box may show the average global score for the group that the actual respondent belongs to.
# In the first box of the Feedback Report we see the Heading text, which may include the value of the $scorepercent variable.
# In the second box we see the "personalized" feedback message, relevant to the Feedback score boundaries that the actual respondent's score sits in.

On the View all Responses page, the Feedback report heading will be displayed, together with the average Global score for All participants. If the questionnaire is set to "visible" or "separate groups", the average global score for the current group will be displayed.

[[File:03-12-2013 13-42-07.jpg]]

==Several sections Feedback example==
A simplistic "health habits" questionnaire.
===Questions===
*Create Q1 as a ''Rate'' question type
**'''Question Name''': ''sports''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you practise these sports?
**'''Possible answers''':
***0=never
***1=once a month
***2=every week
***3=every day
***cycling
***running
***swimming
***walking

*Create Q2 as a ''yes/no'' question type
**'''Question Name''': ''fruit and vegetables''
**'''Response Required''': ''Yes''.
**'''Question Text''': Do you regularly eat fresh fruit and vegetables?

*Create Q3 as a ''Radio buttons'' question type
**'''Question Name''': ''smoking''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you smoke?
**'''Possible answers''':
***3=never
***2=less than one packet per month
***1=one packet per week
***0=one packet per day

*Create Q4 as a ''Radio buttons'' question type
**'''Question Name''': ''drinking''
**'''Response Required''': ''Yes''.
**'''Question Text''': How often do you drink alcohol?
**'''Possible answers''':
***3=never
***2=less than one glass per month
***1=one glass per week
***0=one glass per day

===Advanced settings===
Now go to the questionnaire's '''Advanced settings''' page.
====Additional Info====
As usual you may use the ''Additional Info'' field to enter instructions for the respondents.
====Feedback options====
Now that your questionnaire contains a number of questions which fill the requirements mentioned above for using the Personality test feature, the '''Feedback options''' section is available. In the Feedback options dropdown box, select 2 Feedback sections.
You may use the ''Feedback notes'' field to enter text which will be displayed to your repondents at the end of their "Feedback report", e.g. external link to more information on the topic, etc.

[[Image:feedbackoptions171211.png]]
[[File:03-12-2013 14-23-55.jpg]]

Now click the '''Save settings and edit Feedback Sections''' button.

====Editing Questionnaire Feedback Sections====

On this page is displayed the full list of the questions available for the Feedback report. Each question is displayed, and the "value" of each choice is displayed, to help you check their coherence.
By default, the questions are not set into any Feedback Section (all radio buttons are set at 0). You now have to set each question into one of the 2 Sections you decided to display in your questionnaire's Feedback Report. At this stage, those 2 Feedback Sections have not yet been named, so you really have to be careful and make a mental note of "which is which". Suppose you want Section 1 to be related to your respondents' practise of sport, you would put question 1 into section 1 (click radio button 1 for that question). Now suppose you want your second section to be related to "healthy attitude" towards food, drinking and smoking; click all the remaining radio buttons "2" for questions 2, 3 and 4.

Suppose you get it wrong and you mistakenly put all of your questions in Section 1. Upon clicking on the "Save" button, this error message would be displayed:
''You must select at least ONE question per section!
Section(s) not selected: 2''

Now click on the '''Save Sections settings and edit Feedback Messages''' button.
====Editing Questionnaire Feedback Messages====
=====Feedback heading for section 1/2=====
You will now get a screen very similar to the one you get for Global Feedback messages (as in our previous example). But you will get several screens, one per section.

* Questions in this section:
** sports
* Label: Physical activity
* Heading: Your "physical activity" score is $scorepercent.
=====Feedback messages for section 1/2=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, taken from our sample "Healthy habits" questionnaire.
*Feedback Score boundary
**100%
**Feedback: You must be very fit. Congratulations!

*Feedback Score boundary
**66%
**Feedback: Your physical activity is only average. Come on!

*Feedback Score boundary
**33%
**Feedback: You seem to be a real couch potato. Make an effort!

When finished, click the '''Next section (2/2)''' button.

=====Feedback heading for section 2/2=====
* Questions in this section:
** fruit and vegetables
** smoking
** drinking
* Label: Healthy habits
* Heading: Your "healthy habits" score is $scorepercent.

=====Feedback messages for section 2/2=====
This works exactly the same as the Moodle Quiz Score boundary system.
Here are a few examples, taken from our sample "Healthy habits" questionnaire.
*Feedback Score boundary
**100%
**Feedback: You seem to have quite healthy habits. Continue!

*Feedback Score boundary
**66%
**Feedback: You seem to have not very healthy habits. Make an effort to cut down on drinking and smoking.

*Feedback Score boundary
**33%
**Feedback: You seem to have not terribly healthy habits. You must make a serious effort.

When finished, click the '''Save settings''' button.

===Report===
This is how the Feedback report will look like to a respondent after taking our sample questionnaire.

[[File:03-12-2013 14-53-07.jpg]]

This report is similar to the Global Feedback report in our previous example, except that now the score is separated into 2 sections.

==Bipolar results==
Some "personality tests" aim at detecting a bipolar characteristic in respondents' character. For example, whether an individual's profile is rather visual or auditory, global or analytic, extrovert or introvert etc. See Julian Rotter's theory of [http://en.wikipedia.org/wiki/Julian_Rotter#Locus_of_control Locus of Control].

In such cases, you can enter the section labels as a set of 2 opposed (bipolar) concepts, separated by a pipe character.

[[File:03-12-2013 14-58-51.jpg]]

In a questionnaire based on the Locus of Control theory, this "bipolar" heading will give the following kind of report:

[[File:03-12-2013 15-13-09.jpg]]

==Chart display==

===Site settings===
Upon installing or updating the Questionnaire plugin, its "site settings" page is displayed. On that ''Site administration ► Plugins ► Activity modules ► Questionnaire'' page, an admin can choose to enable the Chart feature site-wide. The default is ''No'' (do not enable). The Questionnaire Chart feature currently uses the [http://www.rgraph.net/ RGraph] libraries, which are licensed under the MIT type of open source license.

===Chart types===
Navigate to the ''Advanced settings'' page and click the ''Feedback options'' button.

You can choose to display or not the table of scores in the Feedback report.

The Chart type drop down list that is available is dependent on the number of feedback sections in your questionnaire.

* Global Feedback (i.e. one section only): Bipolar bars or Vertical Progress bar.
* 2 Sections: Bipolar bars or Horizontal bars or Rose.
* More than 2 sections: Bipolar bars or Horizontal bars or Radar or Rose.

Your choice of Chart type depends on the type of questions in your questionnaire. It's up to you to find out the most suitable Chart type. The Bipolar bars type is only suited when your feedback sections include Bipolar_results (see above).

The selected Chart will be displayed on the All Responses page. It will be constructed with all participants' results or, if the questionnaire is set to Visible Groups, with the results of the currently selected group.

On an Individual Responses page, the current user's current results Chart will be displayed, and also the All participants (or current group) results Chart.

Some samples illustrating the complete Chart types that can be used are displayed below.

Vertical Progress bar

[[File:02-01-2014 11-44-28.jpg]]

Bipolar bars

[[File:02-01-2014 11-40-05.jpg]]

Horizontal bars

[[File:02-01-2014 11-42-27.jpg]]

Radar

[[File:02-01-2014 11-37-47.jpg]]

Rose

[[File:02-01-2014 11-38-58.jpg]]

[[fr:Questionnaire_test_de_personnalité]]
[[es:Examen de personalidad de cuestionario]]

File:dependentquestion171211.png

2017-12-11T21:24:52Z

Mchurch: Dependent question editing.

Dependent question editing.

Questionnaire Conditional branching

2017-12-11T21:24:28Z

Mchurch: /* Organization */

{{Questionnaire}}
==Overview==

===Definition===
Conditional branching (or Skip logic) is a feature that changes what question or page a respondent sees next based on how they answer the current question. Conditional branching creates a custom path through the survey that varies based on a respondent’s answers.

===Organization===
In the Questionnaire plugin, the Conditional branching path is organized through ''pages'', containing one or more "child" questions depending on one or more "parent" question answers.
For a question, you can add one or more mandatory parent question responses and / or one or more optional question responses. All question responses in the mandatory section must be met exactly for the child question to be displayed. At least one question response in the optional section must be met for the question to be displayed. You can also specify whether the question response option must be the one answered, or the one not answered. In previous versions, only one question response could be selected and it had to be the answer given. If only one mandatory question response is selected as the one that must be answered, then the functionality will be identical to previous versions.

[[Image:dependentquestion171211.png]]

===Settings===
If you want to use the Conditional branching feature in a Questionnaire, when you create or edit the questionnaire, in the Response options section of the settings, you must set the '''Allow branching questions''' option to ''Yes''. Please note that this option is set to ''No'' by default.

==A simple example==

===The flow we want to obtain===

*Page 1
**Question 1 Do you own a car? Yes/No.
*Page 2 - Display if question 1 answer is "Yes"
**Question 2: What is the colour of your car?
**Question 3: Did you buy it new or second-hand?
*Page 3 - Display if question 3 answer is "new"
**Question 4: Did you pay for your new car with cash or did you get a bank loan?
*Page 4 - Display if question 3 answer is "second-hand"
**Question 5: Did you buy your second-hand car from a garage or directly from its previous owner?
*Page 5
**Question 6: Do you work outside of your residence?
*Page 6 - Display if question 1 answer is "No" and question 6 answer is "Yes"
**Question 7: Do you use public transport to go to work?
*Page 7
**Question 8: Did you like this questionnaire?
etc.

===Procedure to obtain that flow===

*Create Q1 as a Yes/No question.
**'''Question Name''': ''Own car''. Note that you ''must'' give your question a name, as this name will be used later on in the Questionnaire to build the list of available Parent questions. Please keep this name as short as possible.
**'''Response Required''': ''Yes''. Since you plan to use question Q1 as a Parent question, it would not make sense to set it as non-required.
**'''Question Text''': ''Do you own a car?''
**Save Q1. No Page break will be inserted at this stage because you have not yet used a Parent question to create one or more Child questions.

*Create Q2 as a Text Box question type
**'''Question Name''': Optional colour
**'''Response Required''': ''Yes'' or ''No'' (depending on what you want to do with that question's answers later on).
**'''Parent Question''' : ''own car->Yes''. The Parent question (Q1) option offers 2 choices, since it is a Yes/No question.
**'''Question Text''': ''What is the colour of your car?''
**Save Q2. Upon saving Child question Q2 you notice that a Page break has been automatically inserted between the Parent question Q1 and its Child question Q2.

*Create Q3 as a Radio Buttons (or Dropdown Box) question type
**'''Question Name''': ''Car status''
**'''Response Required''': ''Yes''. We are giving question Q3 a name and setting it as Required because we plan to use it as a Parent question.
**'''Parent Question''': Own car->Yes
**'''Question Text''': Did you buy it new or second-hand?
**'''Possible answers''':
***''new::I bought it new''
***''used::I bought it second-hand''.
**Please note that in the Possible answers field we are using the "short label" feature. You should use this feature if the full text of your Possible answers choices is fairly long.
**Save Q3. Upon saving Child question Q3 you notice that no Page break has been inserted. This is because both Q2 and Q3 are Child questions of the same Parent question Q1 and thus will be displayed on the same page of the questionnaire.

*Create Q4 as a Radio Buttons question type
**'''Question Name''': Optional payment
**'''Response Required''': Yes or No
**'''Parent Question''': car status->new

**Please note that the list of potential Parent question choices displays the "short label" that we entered for the Possible answers in Q3, instead of the full text.

**'''Question Text''': How did you pay for your new car?
**'''Possible answers''':
***''I paid cash''
***''I got a bank loan''
**Save Q4. Upon saving Child question Q4 you notice that a Page break has been automatically inserted between Parent question Q3 and its Child question Q4.

*Create Q5 as a Radio Buttons question type
**'''Question Name''': Optional owner
**'''Response Required''': Yes or No
**'''Parent Question''': car status->used
**'''Question Text''': Where did you buy your second-hand car?
**'''Possible answers''':
***''I bought it from a garage''
***''I bought it directly from its previous owner''
**Save Q5. Upon saving Child question Q5 you notice that a Page break has been automatically inserted between Child question Q4 and Child question Q5 because these two question do not have the same Parent question.

*Create Q6 as YES/NO question type.
**'''Question Name''': Work outside home
**'''Response Required''': Yes or No
**'''Parent Question''': None. Question 6 is not dependent on any of the previous questions, and it will be displayed to the questionnaire respondent regardless of their previous answers.
**'''Question Text''': Do you work outside of your residence?
**Save Q6. Upon saving question Q6 you notice that a Page break has been automatically inserted between Child question Q5 and question Q6.

*Create Q7 as YES/NO question type.
**'''Question Name''': Transit
**'''Response Required''': Yes or No
**'''Parent Question 1''': Own car->No / This answer given
**'''Parent Question 2''':Work outside home->Yes / This answer given
**'''Question Text''': Do you sometimes use public transport to go to work?
**Save Q7. Upon saving question Q7 you notice that a Page break has been automatically inserted between Child question Q6 and question Q7.

*Create Q8 as YES/NO question type.
**'''Question Name''': Enjoy
**'''Response Required''': Yes or No
**'''Parent Question''': None. Question 6 is not dependent on any of the previous questions, and it will be displayed to the questionnaire respondent regardless of their previous answers.
**'''Question Text''': Did you enjoy this questionnaire?
**Save Q8. Upon saving question Q8 you notice that a Page break has been automatically inserted between Child question Q7 and question Q8.

Now continue creating questions normally, until you want to use Conditional branching again.

Here is what your Manage questions section will look like after you have created those first 8 questions.

[[Image:managequestions171211.png]]

==Operations on Conditional branching questions==
===Move===
By using the standard Moodle "Move" icon you can move your questionnaire questions to different positions. However, due to the special nature of the questionnaire flow when using the Conditional branching feature, there are restrictions on the new positions that you can move our questions to.

*You cannot move a Parent question ''below'' any of its Child questions.

*You cannot move a Child question ''above'' its Parent question.

*You cannot remove those Page breaks which are needed to ensure a correct flow of dependent questions.

[[Image:07-08-2013 18-04-16.jpg]]

Those restrictions will show on the Manage questions screen where the Move icon is replaced with a "Forbidden" (Moodle "block") icon. They will also operate when you are in "Move question" mode, where the Move to here icon/placeholder will not be displayed in the "forbidden" positions.

===Edit===
Using the standard Moodle "Edit" icon you may edit any question. However, for those questions which have both a Parent and / or Child questions, care should be taken when changing their Parent questions & Choice, as that might ruin the consequent flow.

===Delete===
You cannot Delete those Page breaks which have been automatically inserted when adding Child questions.

If you try to Delete a Parent question, you will get a warning with the list of its Child questions. If you answer Yes to the warning, the Parent question will be deleted, and the direct dependencies will be removed.

[[Image:deleteparent171211.png]]

===Setting as Required/Not required===

As said above, you would normally set all potential Parent questions as Required. However, there might be cases where you want to leave the respondent the choice to respond or not. If you set a question as Not required, then the usual "No answer" button will be displayed (for Yes/No and Radio Buttons questions). If the respondent does not answer a Parent question, all of its Child questions will be skipped over.

==Previewing Questionnaire==

The Previewing Questionnaire page is useful for a Questionnaire creator to see the questionnaire question display with the various dependencies displayed. The following screenshot illustrates an example preview screen with conditional questions.

[[Image:previewdependent171211.png]]

It is possible for a teacher previewing a questionnaire to "Submit the preview". This will mimic the behaviour of the real Submit questionnaire process: any required question that has not been responded to or any response that does not conform to the question's conditions will be marked with a Warning.

If all the required questions have been correctly filled in, then upon submitting the preview, a "correct" message will be displayed.

To simulate a new questionnaire flow, you can either click the Preview link in your course's navigation bar, or the Preview link in the Questionnaire Administration block or the Reset link at the bottom of the Preview window.

== Individual Responses Report ==

Branching questionnaire reports display the same as non-Branching ones. The only notable difference is with the Individual Responses Report, where it is possible to view the particular path that a respondent took through the various conditional questions. Here are 2 examples.

[[File:08-08-2013 23-40-12.jpg]]

Respondent "Michael Cane" said he owns a red car, bought it new and paid cash for it. He was not presented with Q5, which is displayed between parentheses and greyed out.

[[File:08-08-2013 23-43-18.jpg]]

Respondent "John Doe" said he does not own a car. He was not presented with any of the dependent questions Q2 through Q5.

[[fr:Questionnaire_branchement_conditionnel]]

Questionnaire Conditional branching

2017-12-11T21:13:32Z

Mchurch: /* Previewing Questionnaire */

{{Questionnaire}}
==Overview==

===Definition===
Conditional branching (or Skip logic) is a feature that changes what question or page a respondent sees next based on how they answer the current question. Conditional branching creates a custom path through the survey that varies based on a respondent’s answers.

===Organization===
In the Questionnaire plugin, the Conditional branching path is organized through ''pages'', containing one or more "child" questions depending on one or more "parent" question answers.

===Settings===
If you want to use the Conditional branching feature in a Questionnaire, when you create or edit the questionnaire, in the Response options section of the settings, you must set the '''Allow branching questions''' option to ''Yes''. Please note that this option is set to ''No'' by default.

==A simple example==

===The flow we want to obtain===

*Page 1
**Question 1 Do you own a car? Yes/No.
*Page 2 - Display if question 1 answer is "Yes"
**Question 2: What is the colour of your car?
**Question 3: Did you buy it new or second-hand?
*Page 3 - Display if question 3 answer is "new"
**Question 4: Did you pay for your new car with cash or did you get a bank loan?
*Page 4 - Display if question 3 answer is "second-hand"
**Question 5: Did you buy your second-hand car from a garage or directly from its previous owner?
*Page 5
**Question 6: Do you work outside of your residence?
*Page 6 - Display if question 1 answer is "No" and question 6 answer is "Yes"
**Question 7: Do you use public transport to go to work?
*Page 7
**Question 8: Did you like this questionnaire?
etc.

===Procedure to obtain that flow===

*Create Q1 as a Yes/No question.
**'''Question Name''': ''Own car''. Note that you ''must'' give your question a name, as this name will be used later on in the Questionnaire to build the list of available Parent questions. Please keep this name as short as possible.
**'''Response Required''': ''Yes''. Since you plan to use question Q1 as a Parent question, it would not make sense to set it as non-required.
**'''Question Text''': ''Do you own a car?''
**Save Q1. No Page break will be inserted at this stage because you have not yet used a Parent question to create one or more Child questions.

*Create Q2 as a Text Box question type
**'''Question Name''': Optional colour
**'''Response Required''': ''Yes'' or ''No'' (depending on what you want to do with that question's answers later on).
**'''Parent Question''' : ''own car->Yes''. The Parent question (Q1) option offers 2 choices, since it is a Yes/No question.
**'''Question Text''': ''What is the colour of your car?''
**Save Q2. Upon saving Child question Q2 you notice that a Page break has been automatically inserted between the Parent question Q1 and its Child question Q2.

*Create Q3 as a Radio Buttons (or Dropdown Box) question type
**'''Question Name''': ''Car status''
**'''Response Required''': ''Yes''. We are giving question Q3 a name and setting it as Required because we plan to use it as a Parent question.
**'''Parent Question''': Own car->Yes
**'''Question Text''': Did you buy it new or second-hand?
**'''Possible answers''':
***''new::I bought it new''
***''used::I bought it second-hand''.
**Please note that in the Possible answers field we are using the "short label" feature. You should use this feature if the full text of your Possible answers choices is fairly long.
**Save Q3. Upon saving Child question Q3 you notice that no Page break has been inserted. This is because both Q2 and Q3 are Child questions of the same Parent question Q1 and thus will be displayed on the same page of the questionnaire.

*Create Q4 as a Radio Buttons question type
**'''Question Name''': Optional payment
**'''Response Required''': Yes or No
**'''Parent Question''': car status->new

**Please note that the list of potential Parent question choices displays the "short label" that we entered for the Possible answers in Q3, instead of the full text.

**'''Question Text''': How did you pay for your new car?
**'''Possible answers''':
***''I paid cash''
***''I got a bank loan''
**Save Q4. Upon saving Child question Q4 you notice that a Page break has been automatically inserted between Parent question Q3 and its Child question Q4.

*Create Q5 as a Radio Buttons question type
**'''Question Name''': Optional owner
**'''Response Required''': Yes or No
**'''Parent Question''': car status->used
**'''Question Text''': Where did you buy your second-hand car?
**'''Possible answers''':
***''I bought it from a garage''
***''I bought it directly from its previous owner''
**Save Q5. Upon saving Child question Q5 you notice that a Page break has been automatically inserted between Child question Q4 and Child question Q5 because these two question do not have the same Parent question.

*Create Q6 as YES/NO question type.
**'''Question Name''': Work outside home
**'''Response Required''': Yes or No
**'''Parent Question''': None. Question 6 is not dependent on any of the previous questions, and it will be displayed to the questionnaire respondent regardless of their previous answers.
**'''Question Text''': Do you work outside of your residence?
**Save Q6. Upon saving question Q6 you notice that a Page break has been automatically inserted between Child question Q5 and question Q6.

*Create Q7 as YES/NO question type.
**'''Question Name''': Transit
**'''Response Required''': Yes or No
**'''Parent Question 1''': Own car->No / This answer given
**'''Parent Question 2''':Work outside home->Yes / This answer given
**'''Question Text''': Do you sometimes use public transport to go to work?
**Save Q7. Upon saving question Q7 you notice that a Page break has been automatically inserted between Child question Q6 and question Q7.

*Create Q8 as YES/NO question type.
**'''Question Name''': Enjoy
**'''Response Required''': Yes or No
**'''Parent Question''': None. Question 6 is not dependent on any of the previous questions, and it will be displayed to the questionnaire respondent regardless of their previous answers.
**'''Question Text''': Did you enjoy this questionnaire?
**Save Q8. Upon saving question Q8 you notice that a Page break has been automatically inserted between Child question Q7 and question Q8.

Now continue creating questions normally, until you want to use Conditional branching again.

Here is what your Manage questions section will look like after you have created those first 8 questions.

[[Image:managequestions171211.png]]

==Operations on Conditional branching questions==
===Move===
By using the standard Moodle "Move" icon you can move your questionnaire questions to different positions. However, due to the special nature of the questionnaire flow when using the Conditional branching feature, there are restrictions on the new positions that you can move our questions to.

*You cannot move a Parent question ''below'' any of its Child questions.

*You cannot move a Child question ''above'' its Parent question.

*You cannot remove those Page breaks which are needed to ensure a correct flow of dependent questions.

[[Image:07-08-2013 18-04-16.jpg]]

Those restrictions will show on the Manage questions screen where the Move icon is replaced with a "Forbidden" (Moodle "block") icon. They will also operate when you are in "Move question" mode, where the Move to here icon/placeholder will not be displayed in the "forbidden" positions.

===Edit===
Using the standard Moodle "Edit" icon you may edit any question. However, for those questions which have both a Parent and / or Child questions, care should be taken when changing their Parent questions & Choice, as that might ruin the consequent flow.

===Delete===
You cannot Delete those Page breaks which have been automatically inserted when adding Child questions.

If you try to Delete a Parent question, you will get a warning with the list of its Child questions. If you answer Yes to the warning, the Parent question will be deleted, and the direct dependencies will be removed.

[[Image:deleteparent171211.png]]

===Setting as Required/Not required===

As said above, you would normally set all potential Parent questions as Required. However, there might be cases where you want to leave the respondent the choice to respond or not. If you set a question as Not required, then the usual "No answer" button will be displayed (for Yes/No and Radio Buttons questions). If the respondent does not answer a Parent question, all of its Child questions will be skipped over.

==Previewing Questionnaire==

The Previewing Questionnaire page is useful for a Questionnaire creator to see the questionnaire question display with the various dependencies displayed. The following screenshot illustrates an example preview screen with conditional questions.

[[Image:previewdependent171211.png]]

It is possible for a teacher previewing a questionnaire to "Submit the preview". This will mimic the behaviour of the real Submit questionnaire process: any required question that has not been responded to or any response that does not conform to the question's conditions will be marked with a Warning.

If all the required questions have been correctly filled in, then upon submitting the preview, a "correct" message will be displayed.

To simulate a new questionnaire flow, you can either click the Preview link in your course's navigation bar, or the Preview link in the Questionnaire Administration block or the Reset link at the bottom of the Preview window.

== Individual Responses Report ==

Branching questionnaire reports display the same as non-Branching ones. The only notable difference is with the Individual Responses Report, where it is possible to view the particular path that a respondent took through the various conditional questions. Here are 2 examples.

[[File:08-08-2013 23-40-12.jpg]]

Respondent "Michael Cane" said he owns a red car, bought it new and paid cash for it. He was not presented with Q5, which is displayed between parentheses and greyed out.

[[File:08-08-2013 23-43-18.jpg]]

Respondent "John Doe" said he does not own a car. He was not presented with any of the dependent questions Q2 through Q5.

[[fr:Questionnaire_branchement_conditionnel]]

File:previewdependent171211.png

2017-12-11T21:11:22Z

Mchurch: Preview screen

Preview screen

Questionnaire Conditional branching

2017-12-11T21:10:50Z

Mchurch:

{{Questionnaire}}
==Overview==

===Definition===
Conditional branching (or Skip logic) is a feature that changes what question or page a respondent sees next based on how they answer the current question. Conditional branching creates a custom path through the survey that varies based on a respondent’s answers.

===Organization===
In the Questionnaire plugin, the Conditional branching path is organized through ''pages'', containing one or more "child" questions depending on one or more "parent" question answers.

===Settings===
If you want to use the Conditional branching feature in a Questionnaire, when you create or edit the questionnaire, in the Response options section of the settings, you must set the '''Allow branching questions''' option to ''Yes''. Please note that this option is set to ''No'' by default.

==A simple example==

===The flow we want to obtain===

*Page 1
**Question 1 Do you own a car? Yes/No.
*Page 2 - Display if question 1 answer is "Yes"
**Question 2: What is the colour of your car?
**Question 3: Did you buy it new or second-hand?
*Page 3 - Display if question 3 answer is "new"
**Question 4: Did you pay for your new car with cash or did you get a bank loan?
*Page 4 - Display if question 3 answer is "second-hand"
**Question 5: Did you buy your second-hand car from a garage or directly from its previous owner?
*Page 5
**Question 6: Do you work outside of your residence?
*Page 6 - Display if question 1 answer is "No" and question 6 answer is "Yes"
**Question 7: Do you use public transport to go to work?
*Page 7
**Question 8: Did you like this questionnaire?
etc.

===Procedure to obtain that flow===

*Create Q1 as a Yes/No question.
**'''Question Name''': ''Own car''. Note that you ''must'' give your question a name, as this name will be used later on in the Questionnaire to build the list of available Parent questions. Please keep this name as short as possible.
**'''Response Required''': ''Yes''. Since you plan to use question Q1 as a Parent question, it would not make sense to set it as non-required.
**'''Question Text''': ''Do you own a car?''
**Save Q1. No Page break will be inserted at this stage because you have not yet used a Parent question to create one or more Child questions.

*Create Q2 as a Text Box question type
**'''Question Name''': Optional colour
**'''Response Required''': ''Yes'' or ''No'' (depending on what you want to do with that question's answers later on).
**'''Parent Question''' : ''own car->Yes''. The Parent question (Q1) option offers 2 choices, since it is a Yes/No question.
**'''Question Text''': ''What is the colour of your car?''
**Save Q2. Upon saving Child question Q2 you notice that a Page break has been automatically inserted between the Parent question Q1 and its Child question Q2.

*Create Q3 as a Radio Buttons (or Dropdown Box) question type
**'''Question Name''': ''Car status''
**'''Response Required''': ''Yes''. We are giving question Q3 a name and setting it as Required because we plan to use it as a Parent question.
**'''Parent Question''': Own car->Yes
**'''Question Text''': Did you buy it new or second-hand?
**'''Possible answers''':
***''new::I bought it new''
***''used::I bought it second-hand''.
**Please note that in the Possible answers field we are using the "short label" feature. You should use this feature if the full text of your Possible answers choices is fairly long.
**Save Q3. Upon saving Child question Q3 you notice that no Page break has been inserted. This is because both Q2 and Q3 are Child questions of the same Parent question Q1 and thus will be displayed on the same page of the questionnaire.

*Create Q4 as a Radio Buttons question type
**'''Question Name''': Optional payment
**'''Response Required''': Yes or No
**'''Parent Question''': car status->new

**Please note that the list of potential Parent question choices displays the "short label" that we entered for the Possible answers in Q3, instead of the full text.

**'''Question Text''': How did you pay for your new car?
**'''Possible answers''':
***''I paid cash''
***''I got a bank loan''
**Save Q4. Upon saving Child question Q4 you notice that a Page break has been automatically inserted between Parent question Q3 and its Child question Q4.

*Create Q5 as a Radio Buttons question type
**'''Question Name''': Optional owner
**'''Response Required''': Yes or No
**'''Parent Question''': car status->used
**'''Question Text''': Where did you buy your second-hand car?
**'''Possible answers''':
***''I bought it from a garage''
***''I bought it directly from its previous owner''
**Save Q5. Upon saving Child question Q5 you notice that a Page break has been automatically inserted between Child question Q4 and Child question Q5 because these two question do not have the same Parent question.

*Create Q6 as YES/NO question type.
**'''Question Name''': Work outside home
**'''Response Required''': Yes or No
**'''Parent Question''': None. Question 6 is not dependent on any of the previous questions, and it will be displayed to the questionnaire respondent regardless of their previous answers.
**'''Question Text''': Do you work outside of your residence?
**Save Q6. Upon saving question Q6 you notice that a Page break has been automatically inserted between Child question Q5 and question Q6.

*Create Q7 as YES/NO question type.
**'''Question Name''': Transit
**'''Response Required''': Yes or No
**'''Parent Question 1''': Own car->No / This answer given
**'''Parent Question 2''':Work outside home->Yes / This answer given
**'''Question Text''': Do you sometimes use public transport to go to work?
**Save Q7. Upon saving question Q7 you notice that a Page break has been automatically inserted between Child question Q6 and question Q7.

*Create Q8 as YES/NO question type.
**'''Question Name''': Enjoy
**'''Response Required''': Yes or No
**'''Parent Question''': None. Question 6 is not dependent on any of the previous questions, and it will be displayed to the questionnaire respondent regardless of their previous answers.
**'''Question Text''': Did you enjoy this questionnaire?
**Save Q8. Upon saving question Q8 you notice that a Page break has been automatically inserted between Child question Q7 and question Q8.

Now continue creating questions normally, until you want to use Conditional branching again.

Here is what your Manage questions section will look like after you have created those first 8 questions.

[[Image:managequestions171211.png]]

==Operations on Conditional branching questions==
===Move===
By using the standard Moodle "Move" icon you can move your questionnaire questions to different positions. However, due to the special nature of the questionnaire flow when using the Conditional branching feature, there are restrictions on the new positions that you can move our questions to.

*You cannot move a Parent question ''below'' any of its Child questions.

*You cannot move a Child question ''above'' its Parent question.

*You cannot remove those Page breaks which are needed to ensure a correct flow of dependent questions.

[[Image:07-08-2013 18-04-16.jpg]]

Those restrictions will show on the Manage questions screen where the Move icon is replaced with a "Forbidden" (Moodle "block") icon. They will also operate when you are in "Move question" mode, where the Move to here icon/placeholder will not be displayed in the "forbidden" positions.

===Edit===
Using the standard Moodle "Edit" icon you may edit any question. However, for those questions which have both a Parent and / or Child questions, care should be taken when changing their Parent questions & Choice, as that might ruin the consequent flow.

===Delete===
You cannot Delete those Page breaks which have been automatically inserted when adding Child questions.

If you try to Delete a Parent question, you will get a warning with the list of its Child questions. If you answer Yes to the warning, the Parent question will be deleted, and the direct dependencies will be removed.

[[Image:deleteparent171211.png]]

===Setting as Required/Not required===

As said above, you would normally set all potential Parent questions as Required. However, there might be cases where you want to leave the respondent the choice to respond or not. If you set a question as Not required, then the usual "No answer" button will be displayed (for Yes/No and Radio Buttons questions). If the respondent does not answer a Parent question, all of its Child questions will be skipped over.

==Previewing Questionnaire==

The Previewing Questionnaire page is useful for a Questionnaire creator to see the questionnaire question display with the various dependencies displayed. The following screenshot illustrates an example preview screen with conditional questions.

[[Image:previewdependent171211.png]]

It is possible for a teacher previewing a questionnaire to "Submit the preview". This will mimic the behaviour of the real Submit questionnaire process: any required question that has not been responded to or any response that does not conform to the question's conditions will be marked with a Warning.

If all the required questions have been correctly filled in, then upon submitting the preview, a "correct" message will be displayed.

To simulate a new questionnaire flow, you can either click the Preview link in your course's navigation bar, or the Preview link in the Questionnaire Administration block or the Reset link at the bottom of the Preview window.

== Individual Responses Report ==

Branching questionnaire reports display the same as non-Branching ones. The only notable difference is with the Individual Responses Report, where it is possible to view the particular path that a respondent took through the various conditional questions. Here are 2 examples.

[[File:08-08-2013 23-40-12.jpg]]

Respondent "Michael Cane" said he owns a red car, bought it new and paid cash for it. He was not presented with Q5, which is displayed between parentheses and greyed out.

[[File:08-08-2013 23-43-18.jpg]]

Respondent "John Doe" said he does not own a car. He was not presented with any of the dependent questions Q2 through Q5.

[[fr:Questionnaire_branchement_conditionnel]]

File:deleteparent171211.png

2017-12-11T21:01:12Z

Mchurch: Delete parent question warning screen.

Delete parent question warning screen.

Questionnaire Conditional branching

2017-12-11T21:00:38Z

Mchurch:

{{Questionnaire}}
==Overview==

===Definition===
Conditional branching (or Skip logic) is a feature that changes what question or page a respondent sees next based on how they answer the current question. Conditional branching creates a custom path through the survey that varies based on a respondent’s answers.

===Organization===
In the Questionnaire plugin, the Conditional branching path is organized through ''pages'', containing one or more "child" questions depending on one or more "parent" question answers.

===Settings===
If you want to use the Conditional branching feature in a Questionnaire, when you create or edit the questionnaire, in the Response options section of the settings, you must set the '''Allow branching questions''' option to ''Yes''. Please note that this option is set to ''No'' by default.

==A simple example==

===The flow we want to obtain===

*Page 1
**Question 1 Do you own a car? Yes/No.
*Page 2 - Display if question 1 answer is "Yes"
**Question 2: What is the colour of your car?
**Question 3: Did you buy it new or second-hand?
*Page 3 - Display if question 3 answer is "new"
**Question 4: Did you pay for your new car with cash or did you get a bank loan?
*Page 4 - Display if question 3 answer is "second-hand"
**Question 5: Did you buy your second-hand car from a garage or directly from its previous owner?
*Page 5
**Question 6: Do you work outside of your residence?
*Page 6 - Display if question 1 answer is "No" and question 6 answer is "Yes"
**Question 7: Do you use public transport to go to work?
*Page 7
**Question 8: Did you like this questionnaire?
etc.

===Procedure to obtain that flow===

*Create Q1 as a Yes/No question.
**'''Question Name''': ''Own car''. Note that you ''must'' give your question a name, as this name will be used later on in the Questionnaire to build the list of available Parent questions. Please keep this name as short as possible.
**'''Response Required''': ''Yes''. Since you plan to use question Q1 as a Parent question, it would not make sense to set it as non-required.
**'''Question Text''': ''Do you own a car?''
**Save Q1. No Page break will be inserted at this stage because you have not yet used a Parent question to create one or more Child questions.

*Create Q2 as a Text Box question type
**'''Question Name''': Optional colour
**'''Response Required''': ''Yes'' or ''No'' (depending on what you want to do with that question's answers later on).
**'''Parent Question''' : ''own car->Yes''. The Parent question (Q1) option offers 2 choices, since it is a Yes/No question.
**'''Question Text''': ''What is the colour of your car?''
**Save Q2. Upon saving Child question Q2 you notice that a Page break has been automatically inserted between the Parent question Q1 and its Child question Q2.

*Create Q3 as a Radio Buttons (or Dropdown Box) question type
**'''Question Name''': ''Car status''
**'''Response Required''': ''Yes''. We are giving question Q3 a name and setting it as Required because we plan to use it as a Parent question.
**'''Parent Question''': Own car->Yes
**'''Question Text''': Did you buy it new or second-hand?
**'''Possible answers''':
***''new::I bought it new''
***''used::I bought it second-hand''.
**Please note that in the Possible answers field we are using the "short label" feature. You should use this feature if the full text of your Possible answers choices is fairly long.
**Save Q3. Upon saving Child question Q3 you notice that no Page break has been inserted. This is because both Q2 and Q3 are Child questions of the same Parent question Q1 and thus will be displayed on the same page of the questionnaire.

*Create Q4 as a Radio Buttons question type
**'''Question Name''': Optional payment
**'''Response Required''': Yes or No
**'''Parent Question''': car status->new

**Please note that the list of potential Parent question choices displays the "short label" that we entered for the Possible answers in Q3, instead of the full text.

**'''Question Text''': How did you pay for your new car?
**'''Possible answers''':
***''I paid cash''
***''I got a bank loan''
**Save Q4. Upon saving Child question Q4 you notice that a Page break has been automatically inserted between Parent question Q3 and its Child question Q4.

*Create Q5 as a Radio Buttons question type
**'''Question Name''': Optional owner
**'''Response Required''': Yes or No
**'''Parent Question''': car status->used
**'''Question Text''': Where did you buy your second-hand car?
**'''Possible answers''':
***''I bought it from a garage''
***''I bought it directly from its previous owner''
**Save Q5. Upon saving Child question Q5 you notice that a Page break has been automatically inserted between Child question Q4 and Child question Q5 because these two question do not have the same Parent question.

*Create Q6 as YES/NO question type.
**'''Question Name''': Work outside home
**'''Response Required''': Yes or No
**'''Parent Question''': None. Question 6 is not dependent on any of the previous questions, and it will be displayed to the questionnaire respondent regardless of their previous answers.
**'''Question Text''': Do you work outside of your residence?
**Save Q6. Upon saving question Q6 you notice that a Page break has been automatically inserted between Child question Q5 and question Q6.

*Create Q7 as YES/NO question type.
**'''Question Name''': Transit
**'''Response Required''': Yes or No
**'''Parent Question 1''': Own car->No / This answer given
**'''Parent Question 2''':Work outside home->Yes / This answer given
**'''Question Text''': Do you sometimes use public transport to go to work?
**Save Q7. Upon saving question Q7 you notice that a Page break has been automatically inserted between Child question Q6 and question Q7.

*Create Q8 as YES/NO question type.
**'''Question Name''': Enjoy
**'''Response Required''': Yes or No
**'''Parent Question''': None. Question 6 is not dependent on any of the previous questions, and it will be displayed to the questionnaire respondent regardless of their previous answers.
**'''Question Text''': Did you enjoy this questionnaire?
**Save Q8. Upon saving question Q8 you notice that a Page break has been automatically inserted between Child question Q7 and question Q8.

Now continue creating questions normally, until you want to use Conditional branching again.

Here is what your Manage questions section will look like after you have created those first 8 questions.

[[Image:managequestions171211.png]]

==Operations on Conditional branching questions==
===Move===
By using the standard Moodle "Move" icon you can move your questionnaire questions to different positions. However, due to the special nature of the questionnaire flow when using the Conditional branching feature, there are restrictions on the new positions that you can move our questions to.

*You cannot move a Parent question ''below'' any of its Child questions.

*You cannot move a Child question ''above'' its Parent question.

*You cannot remove those Page breaks which are needed to ensure a correct flow of dependent questions.

[[Image:07-08-2013 18-04-16.jpg]]

Those restrictions will show on the Manage questions screen where the Move icon is replaced with a "Forbidden" (Moodle "block") icon. They will also operate when you are in "Move question" mode, where the Move to here icon/placeholder will not be displayed in the "forbidden" positions.

===Edit===
Using the standard Moodle "Edit" icon you may edit any question. However, for those questions which have both a Parent and / or Child questions, care should be taken when changing their Parent questions & Choice, as that might ruin the consequent flow.

===Delete===
You cannot Delete those Page breaks which have been automatically inserted when adding Child questions.

If you try to Delete a Parent question, you will get a warning with the list of its Child questions. If you answer Yes to the warning, the Parent question will be deleted, and the direct dependencies will be removed.

[[Image:deleteparent171211.png]]
[[Image:07-08-2013 18-20-29.jpg]]

===Setting as Required/Not required===

As said above, you would normally set all potential Parent questions as Required. However, there might be cases where you want to leave the respondent the choice to respond or not. If you set a question as Not required, then the usual "No answer" button will be displayed (for Yes/No and Radio Buttons questions). If the respondent does not answer a Parent question, all of its Child questions will be skipped over.

==Previewing Questionnaire==

The Previewing Questionnaire page is useful for a Questionnaire creator to test it out before making it available in a course. In the case of a Conditional branching questionnaire, the Preview is especially useful as it will mimic the flow that a respondent will see, by selecting the various choices offered by the Parent questions.

When a Conditional branching questionnaire is first displayed on the Preview page, only those pages containing "top" parent questions are displayed, as well as pages containing questions that do not have a Parent question.

When a choice is made in the Parent questions, the Child question(s) corresponding to that choice is/are displayed.

The following screnshots illustrate the various possible sequences that can be displayed. In this example, we have set Question 3 as Non-required.

[[File:07-08-2013 18-52-40.jpg]]

The only 2 questions displayed are those with no Parent: Q1 and Q6.

[[File:07-08-2013 18-54-36.jpg]]

Upon clicking on Q1 'No', nothing changes in the display, because in our questionnaire we do not have any Child question dependent on that choice.

[[File:08-08-2013 19-07-13.jpg]]

It is possible for a teacher previewing a questionnaire to "Submit the preview". This will mimic the behaviour of the real Submit questionnaire process: any required question that has not been responded to or any response that does not conform to the question's conditions will be marked with a Warning.

[[File:08-08-2013 18-56-25.jpg]]

If all the required questions have been correctly filled in, then upon submitting the preview, a "correct" message will be displayed.

*To simulate a new questionnaire flow, you can either click the Preview link in your course's navigation bar, or the Preview link in the Questionnaire Administration block or the Reset link at the bottom of the Preview window.

[[File:08-08-2013 22-45-33.jpg]]

Upon clicking the ''Yes'' radio button in answer to Q1, questions Q2 and Q3 on Page 2, which depend on that Q1 ''Yes'' choice are automatically displayed. In "Answer the questions" mode, the respondent would be taken to Page 2 of the questionnaire. Now, if we click on the I bought it new radio button of Q3, Q4 on Page 3 will be displayed, etc.

== Individual Responses Report ==

Branching questionnaire reports display the same as non-Branching ones. The only notable difference is with the Individual Responses Report, where it is possible to view the particular path that a respondent took through the various conditional questions. Here are 2 examples.

[[File:08-08-2013 23-40-12.jpg]]

Respondent "Michael Cane" said he owns a red car, bought it new and paid cash for it. He was not presented with Q5, which is displayed between parentheses and greyed out.

[[File:08-08-2013 23-43-18.jpg]]

Respondent "John Doe" said he does not own a car. He was not presented with any of the dependent questions Q2 through Q5.

[[fr:Questionnaire_branchement_conditionnel]]

File:managequestions171211.png

2017-12-11T20:46:24Z

Mchurch: Manage questions screen with conditional branching questions.

Manage questions screen with conditional branching questions.

Questionnaire Conditional branching

2017-12-11T20:45:30Z

Mchurch:

{{Questionnaire}}
==Overview==

===Definition===
Conditional branching (or Skip logic) is a feature that changes what question or page a respondent sees next based on how they answer the current question. Conditional branching creates a custom path through the survey that varies based on a respondent’s answers.

===Organization===
In the Questionnaire plugin, the Conditional branching path is organized through ''pages'', containing one or more "child" questions depending on one or more "parent" question answers.

===Settings===
If you want to use the Conditional branching feature in a Questionnaire, when you create or edit the questionnaire, in the Response options section of the settings, you must set the '''Allow branching questions''' option to ''Yes''. Please note that this option is set to ''No'' by default.

==A simple example==

===The flow we want to obtain===

*Page 1
**Question 1 Do you own a car? Yes/No.
*Page 2 - Display if question 1 answer is "Yes"
**Question 2: What is the colour of your car?
**Question 3: Did you buy it new or second-hand?
*Page 3 - Display if question 3 answer is "new"
**Question 4: Did you pay for your new car with cash or did you get a bank loan?
*Page 4 - Display if question 3 answer is "second-hand"
**Question 5: Did you buy your second-hand car from a garage or directly from its previous owner?
*Page 5
**Question 6: Do you work outside of your residence?
*Page 6 - Display if question 1 answer is "No" and question 6 answer is "Yes"
**Question 7: Do you use public transport to go to work?
*Page 7
**Question 8: Did you like this questionnaire?
etc.

===Procedure to obtain that flow===

*Create Q1 as a Yes/No question.
**'''Question Name''': ''Own car''. Note that you ''must'' give your question a name, as this name will be used later on in the Questionnaire to build the list of available Parent questions. Please keep this name as short as possible.
**'''Response Required''': ''Yes''. Since you plan to use question Q1 as a Parent question, it would not make sense to set it as non-required.
**'''Question Text''': ''Do you own a car?''
**Save Q1. No Page break will be inserted at this stage because you have not yet used a Parent question to create one or more Child questions.

*Create Q2 as a Text Box question type
**'''Question Name''': Optional colour
**'''Response Required''': ''Yes'' or ''No'' (depending on what you want to do with that question's answers later on).
**'''Parent Question''' : ''own car->Yes''. The Parent question (Q1) option offers 2 choices, since it is a Yes/No question.
**'''Question Text''': ''What is the colour of your car?''
**Save Q2. Upon saving Child question Q2 you notice that a Page break has been automatically inserted between the Parent question Q1 and its Child question Q2.

*Create Q3 as a Radio Buttons (or Dropdown Box) question type
**'''Question Name''': ''Car status''
**'''Response Required''': ''Yes''. We are giving question Q3 a name and setting it as Required because we plan to use it as a Parent question.
**'''Parent Question''': Own car->Yes
**'''Question Text''': Did you buy it new or second-hand?
**'''Possible answers''':
***''new::I bought it new''
***''used::I bought it second-hand''.
**Please note that in the Possible answers field we are using the "short label" feature. You should use this feature if the full text of your Possible answers choices is fairly long.
**Save Q3. Upon saving Child question Q3 you notice that no Page break has been inserted. This is because both Q2 and Q3 are Child questions of the same Parent question Q1 and thus will be displayed on the same page of the questionnaire.

*Create Q4 as a Radio Buttons question type
**'''Question Name''': Optional payment
**'''Response Required''': Yes or No
**'''Parent Question''': car status->new

**Please note that the list of potential Parent question choices displays the "short label" that we entered for the Possible answers in Q3, instead of the full text.

**'''Question Text''': How did you pay for your new car?
**'''Possible answers''':
***''I paid cash''
***''I got a bank loan''
**Save Q4. Upon saving Child question Q4 you notice that a Page break has been automatically inserted between Parent question Q3 and its Child question Q4.

*Create Q5 as a Radio Buttons question type
**'''Question Name''': Optional owner
**'''Response Required''': Yes or No
**'''Parent Question''': car status->used
**'''Question Text''': Where did you buy your second-hand car?
**'''Possible answers''':
***''I bought it from a garage''
***''I bought it directly from its previous owner''
**Save Q5. Upon saving Child question Q5 you notice that a Page break has been automatically inserted between Child question Q4 and Child question Q5 because these two question do not have the same Parent question.

*Create Q6 as YES/NO question type.
**'''Question Name''': Work outside home
**'''Response Required''': Yes or No
**'''Parent Question''': None. Question 6 is not dependent on any of the previous questions, and it will be displayed to the questionnaire respondent regardless of their previous answers.
**'''Question Text''': Do you work outside of your residence?
**Save Q6. Upon saving question Q6 you notice that a Page break has been automatically inserted between Child question Q5 and question Q6.

*Create Q7 as YES/NO question type.
**'''Question Name''': Transit
**'''Response Required''': Yes or No
**'''Parent Question 1''': Own car->No / This answer given
**'''Parent Question 2''':Work outside home->Yes / This answer given
**'''Question Text''': Do you sometimes use public transport to go to work?
**Save Q7. Upon saving question Q7 you notice that a Page break has been automatically inserted between Child question Q6 and question Q7.

*Create Q8 as YES/NO question type.
**'''Question Name''': Enjoy
**'''Response Required''': Yes or No
**'''Parent Question''': None. Question 6 is not dependent on any of the previous questions, and it will be displayed to the questionnaire respondent regardless of their previous answers.
**'''Question Text''': Did you enjoy this questionnaire?
**Save Q8. Upon saving question Q8 you notice that a Page break has been automatically inserted between Child question Q7 and question Q8.

Now continue creating questions normally, until you want to use Conditional branching again.

Here is what your Manage questions section will look like after you have created those first 6 questions.

[[Image:managequestions171211.png]]
[[Image:07-08-2013 17-49-53.jpg]]

==Operations on Conditional branching questions==
===Move===
By using the standard Moodle "Move" icon you can move your questionnaire questions to different positions. However, due to the special nature of the questionnaire flow when using the Conditional branching feature, there are restrictions on the new positions that you can move our questions to.

*You cannot move a Parent question ''below'' any of its Child questions.

*You cannot move a Child question ''above'' its Parent question.

*You cannot remove those Page breaks which are needed to ensure a correct flow of dependent questions.

[[Image:07-08-2013 18-04-16.jpg]]

Those restrictions will show on the Manage questions screen where the Move icon is replaced with a "Forbidden" (Moodle "block") icon. They will also operate when you are in "Move question" mode, where the Move to here icon/placeholder will not be displayed in the "forbidden" positions.

===Edit===
Using the standard Moodle "Edit" icon you may edit any question. However, for those questions which have both a Parent question and one or more Child questions, you cannot change their Parent question & Choice, as that might ruin the consequent flow. The only way to change their Parent is to edit their Child question(s) first.

[[Image:07-08-2013 18-12-59.jpg]]

===Delete===
You cannot Delete those Page breaks which have been automatically inserted when adding Child questions.

If you try to Delete a Parent question, you will get a warning with the list of its Child questions. If you answer Yes to the warning, the Parent question will be deleted, together with all its Child (and Grand-Child questions).

[[Image:07-08-2013 18-20-29.jpg]]

===Setting as Required/Not required===

As said above, you would normally set all potential Parent questions as Required. However, there might be cases where you want to leave the respondent the choice to respond or not. If you set a question as Not required, then the usual "No answer" button will be displayed (for Yes/No and Radio Buttons questions). If the respondent does not answer a Parent question, all of its Child questions will be skipped over.

==Previewing Questionnaire==

The Previewing Questionnaire page is useful for a Questionnaire creator to test it out before making it available in a course. In the case of a Conditional branching questionnaire, the Preview is especially useful as it will mimic the flow that a respondent will see, by selecting the various choices offered by the Parent questions.

When a Conditional branching questionnaire is first displayed on the Preview page, only those pages containing "top" parent questions are displayed, as well as pages containing questions that do not have a Parent question.

When a choice is made in the Parent questions, the Child question(s) corresponding to that choice is/are displayed.

The following screnshots illustrate the various possible sequences that can be displayed. In this example, we have set Question 3 as Non-required.

[[File:07-08-2013 18-52-40.jpg]]

The only 2 questions displayed are those with no Parent: Q1 and Q6.

[[File:07-08-2013 18-54-36.jpg]]

Upon clicking on Q1 'No', nothing changes in the display, because in our questionnaire we do not have any Child question dependent on that choice.

[[File:08-08-2013 19-07-13.jpg]]

It is possible for a teacher previewing a questionnaire to "Submit the preview". This will mimic the behaviour of the real Submit questionnaire process: any required question that has not been responded to or any response that does not conform to the question's conditions will be marked with a Warning.

[[File:08-08-2013 18-56-25.jpg]]

If all the required questions have been correctly filled in, then upon submitting the preview, a "correct" message will be displayed.

*To simulate a new questionnaire flow, you can either click the Preview link in your course's navigation bar, or the Preview link in the Questionnaire Administration block or the Reset link at the bottom of the Preview window.

[[File:08-08-2013 22-45-33.jpg]]

Upon clicking the ''Yes'' radio button in answer to Q1, questions Q2 and Q3 on Page 2, which depend on that Q1 ''Yes'' choice are automatically displayed. In "Answer the questions" mode, the respondent would be taken to Page 2 of the questionnaire. Now, if we click on the I bought it new radio button of Q3, Q4 on Page 3 will be displayed, etc.

== Individual Responses Report ==

Branching questionnaire reports display the same as non-Branching ones. The only notable difference is with the Individual Responses Report, where it is possible to view the particular path that a respondent took through the various conditional questions. Here are 2 examples.

[[File:08-08-2013 23-40-12.jpg]]

Respondent "Michael Cane" said he owns a red car, bought it new and paid cash for it. He was not presented with Q5, which is displayed between parentheses and greyed out.

[[File:08-08-2013 23-43-18.jpg]]

Respondent "John Doe" said he does not own a car. He was not presented with any of the dependent questions Q2 through Q5.

[[fr:Questionnaire_branchement_conditionnel]]

Web services test client

2017-06-19T18:16:05Z

Mchurch:

{{Developer tools}}
Admins can simulate external access to their own [[Web Services]] using the URL <code><nowiki>http://yourmoodlesite.org/admin/webservice/testclient.php</nowiki></code>.

Warning: The test client is not clever! It lets you choose disabled/unavaibled functions (however it behaves well and produces an error in these case). This is normal because clients are going to be bad sometimes so we needed to simulate a bad client!

[[Category:Web Services]]

[[es:Cliente de prueba de servicios web]]
[[de:Webservice-Testrechner]]

Telegram message processor

2017-05-29T12:37:00Z

Mchurch: /* Configuring the plugin settings */

This plugin provides a message processor for Telegram, allowing sites to configure a Telegram bot that their users can configure to forward Moodle notifications and messages to their Telegram account.

==Configuring the plugin settings==

At the Telegram main settings page (Plugins / Message outputs / Telegram), you will need to configure a bot token to be used by the site. To get this token, you will need to create a new Telegram bot using the Telegram bot "Botfather".

After you have installed the plugin, at the settings screen, you will see this:

[[File:Settingscreen.png|600px|center]]

The only thing you really need to enter here is the "bot token for the site". The other two fields will be automatically filled in once you save the token. To get the token, you need to open the Botfather in Telegram, which you can do by clicking the provided link below the instructions. When you click it, you will see something like this:

[[File:opentelegram.png|center|600px]]

Open the link in the Telegram app (you need that), or alternatively in the Telegram Web (if your browser allows it). In Telegram, you should see this:

[[File:telegramstartscreen.png|center|600px]]

Click the "Start" button at the bottom to begin the conversation with Botfather. Once you have, you will see:

[[File:botfatherstart.png|center|600px]]

Enter the command "/newbot" in the conversation, and Botfather will ask you for all of the information you need. You will need to enter both a name and a unique username for your Bot. The Telegram settings screen provided some suggestions, but you can choose what you want. Since it should be unique, it is recommended you use your organization or sitename as part of these.

[[File:newbot.png|center|600px]]

Once you have given Botfather everything it needs, you will have the bot token displayed in the conversation:

[[File:bottoken.png|center|600px]]

Transfer the bot token information to the settings screen and hit "Save changes":

[[File:savechanges.png|center|600px]]

The name and username you chose will be filled in for you. Telegram is now ready for your users to configure their message preferences.

[[File:finalsettings.png|center|600px]]

NOTE: The "Setup Telegram webhook" option is still a work in progress.

==Configuring user preferences==

Once you have a Telegram bot configured, users can connect their Telegram accounts to receive notifications and messages. This is done in the user preferences screen under the notification preferences.
As a user, navigate to the "Notification preferences" screen. One the columns will be Telegram, and it will show that it is not configured. Click on the configuration link/icon and the Telegrams settings dialogue will open up:

[[File:telegrampreferences1.png|center|600px]]

At this point, the user needs to initiate a conversation with the Telegram bot that was created for the site. The dialogue offers a link to start this. Click on the "Connect my account to Telegram", and another browser window/tab will open:

[[File:telegramopenrequest.png|center|600px]]

Use the "Open Telegram app" to launch the Telegram app and initiate the conversation with the Telegram bot. You will see the conversation with a "Start" button at the bottom:

[[File:moodlebotstart.png|center|600px]]

Click "Start". A conversation will start like below:

[[File:moodlebotstarted.png|center|600px]]

At this point, return to your Moodle browser window/tab:

[[File:saveprefs.png|center|600px]]

Click "Save changes", and your Telegram connection should be configured. If it isn't (there could be a delay), wait a bit and open the settings dialogue again, and click "Save changes". Note, that if you do not click the save changes before logging off, you will need to start the connect process again. In any case, once you have saved, and the connection is made, you will see that the alert icon is gone, and when you look at your settings, it will give you a link to disconnect your account. Don't use that unless you don't want Telegram integrated with your Moodle account any more:

[[File:prefssaved.png|center|600px]]

You can now select what notifications and messages you want received through Telegram.

File:slackpreferences2.png

2017-05-26T19:14:17Z

Mchurch:

File:authorizeslack.png

2017-05-26T19:13:55Z

Mchurch:

File:addnewredirecturl.png

2017-05-26T19:13:33Z

Mchurch:

File:oauthredirecturl.png

2017-05-26T19:13:10Z

Mchurch:

File:completesettings.png

2017-05-26T19:12:44Z

Mchurch:

Slack message processor

2017-05-26T19:12:15Z

Mchurch:

This plugin provides a message processor for Slack. A site can configure a Slack team to be used for message outputs. Then, any Moodle users who are members of that Slack team can configure their account to be connected to a Slack channel.

==Configuring the plugin settings==
At the Slack plugin main settings page (Plugins / Message outputs / Slack), you will need to configure the Team URL, Client ID and Client secret for the Slack plugin. Once the plugin is installed, you will see:

[[File:slacksetupscreen1.png|center|600px]]

You can enter your Slack Team URL now, but you will need to do some steps on Slack to get the other two bits.
Make sure you are logged into your Slack team site as an administrator, and go to https://api.slack.com/apps. You'll see a screen like:

[[File:mainappscreen.png|center|600px]]

Click the "Create an App" button, and you should see:

[[File:createapp.png|center|600px]]

Enter a name for your App. If you have more than one Slack team, you will have to choose the one you want to use. Then click "Create App":

[[File:appcreatedscrolldown.png|center|600px]]

If you scroll down a bit on the resulting screen you will see the Client ID and Client Secret you need to enter on the Moodle Slack plugin settings screen (you have to click the "Show" button on the secret to see it). Leave this site open, as we need to do a few more steps, but go ahead and transfer the Client info to the plugin settings and save:

[[File:completesettings.png|center|600px]]

Go back to the Slack Apps screen. Look down the left menu for the "OAuth & Permissions" link. Click that and it will take you to the OAuth screen:

[[File:oauthredirecturl.png|center|600px]]

You need to add a redirect URL to the Slack script on your Moodle site. The URL is your Moodle URL, followed by '/message/output/slack/slackconnect.php'. Scroll down and click the "Add a new Redirect URL" button:

[[File:addnewredirecturl.png|center|600px]]

Enter the URL as above, and click the "Add" button. You will need to authorize a channel to post to. I recommend selecting your own name:

[[File:authorizeslack.png|center|600px]]

You may need to click the "Save URLs" button after this, if it is displayed. But now Slack should have everything it needs to work with your site.

==Configuring user preferences==

Once Slack is configured for your site, users can connect their Slack accounts to receive notifications and messages from Moodle. This is done in the user preferences screen under the notification preferences. On that screen, you will see a column for Slack, and it will show the "alert" icon indicating that it has not been configured. Click on that link to open the Slack settings dialogue:

[[File:slackpreferences2.png|center|600px]]

Click the "Add to Slack" button, and the user account will be connected to Slack. Now, the user can select what messages and notifications they wish to receive through Slack.

File:appcreatedscrolldown.png

2017-05-26T19:11:53Z

Mchurch:

File:createapp.png

2017-05-26T19:11:20Z

Mchurch:

File:mainappscreen.png

2017-05-26T19:10:55Z

Mchurch:

Slack message processor

2017-05-26T19:10:29Z

Mchurch: Created page with "This plugin provides a message processor for Slack. A site can configure a Slack team to be used for message outputs. Then, any Moodle users who are members of that Slack team..."

This plugin provides a message processor for Slack. A site can configure a Slack team to be used for message outputs. Then, any Moodle users who are members of that Slack team can configure their account to be connected to a Slack channel.

==Configuring the plugin settings==
At the Slack plugin main settings page (Plugins / Message outputs / Slack), you will need to configure the Team URL, Client ID and Client secret for the Slack plugin. Once the plugin is installed, you will see:

[[File:slacksetupscreen1.png|center|600px]]

You can enter your Slack Team URL now, but you will need to do some steps on Slack to get the other two bits.
Make sure you are logged into your Slack team site as an administrator, and go to https://api.slack.com/apps. You'll see a screen like:

[[File:mainappscreen.png|center|600px]]

Click the "Create an App" button, and you should see:

[[File:createapp.png|center|600px]]

Enter a name for your App. If you have more than one Slack team, you will have to choose the one you want to use. Then click "Create App":

[[File:appcreatedscrolldown|center|600px]]

If you scroll down a bit on the resulting screen you will see the Client ID and Client Secret you need to enter on the Moodle Slack plugin settings screen (you have to click the "Show" button on the secret to see it). Leave this site open, as we need to do a few more steps, but go ahead and transfer the Client info to the plugin settings and save:

[[File:completesettings.png|center|600px]]

Go back to the Slack Apps screen. Look down the left menu for the "OAuth & Permissions" link. Click that and it will take you to the OAuth screen:

[[File:oauthredirecturl.png|center|600px]]

You need to add a redirect URL to the Slack script on your Moodle site. The URL is your Moodle URL, followed by '/message/output/slack/slackconnect.php'. Scroll down and click the "Add a new Redirect URL" button:

[[File:addnewredirecturl.png|center|600px]]

Enter the URL as above, and click the "Add" button. You will need to authorize a channel to post to. I recommend selecting your own name:

[[File:authorizeslack.png|center|600px]]

You may need to click the "Save URLs" button after this, if it is displayed. But now Slack should have everything it needs to work with your site.

==Configuring user preferences==

Once Slack is configured for your site, users can connect their Slack accounts to receive notifications and messages from Moodle. This is done in the user preferences screen under the notification preferences. On that screen, you will see a column for Slack, and it will show the "alert" icon indicating that it has not been configured. Click on that link to open the Slack settings dialogue:

[[File:slackpreferences2.png|center|600px]]

Click the "Add to Slack" button, and the user account will be connected to Slack. Now, the user can select what messages and notifications they wish to receive through Slack.

File:slacksetupscreen1.png

2017-05-26T19:10:16Z

Mchurch:

File:prefssaved.png

2017-05-26T13:44:15Z

Mchurch:

File:saveprefs.png

2017-05-26T13:43:54Z

Mchurch:

File:moodlebotstarted.png

2017-05-26T13:43:28Z

Mchurch:

File:moodlebotstart.png

2017-05-26T13:42:57Z

Mchurch:

File:telegramopenrequest.png

2017-05-26T13:42:27Z

Mchurch:

File:telegrampreferences1.png

2017-05-26T13:41:59Z

Mchurch:

Telegram message processor

2017-05-26T13:41:36Z

Mchurch:

This plugin provides a message processor for Telegram, allowing sites to configure a Telegram bot that their users can configure to forward Moodle notifications and messages to their Telegram account.

==Configuring the plugin settings==

At the Telegram main settings page (Plugins / Message outputs / Telegram), you will need to configure a bot token to be used by the site. To get this token, you will need to create a new Telegram bot using the Telegram bot "Botfather".

After you have installed the plugin, at the settings screen, you will see this:

[[File:Settingscreen.png|600px|center]]

The only thing you really need to enter here is the "bot token for the site". The other two fields will be automatically filled in once you save the token. To get the token, you need to open the Botfather in Telegram, which you can do by clicking the provided link below the instructions. When you click it, you will see something like this:

[[File:opentelegram.png|center|600px]]

Open the link in the Telegram app (you need that), or alternatively in the Telegram Web (if your browser allows it). In Telegram, you should see this:

[[File:telegramstartscreen.png|center|600px]]

Click the "Start" button at the bottom to begin the conversation with Botfather. Once you have, you will see:

[[File:botfatherstart.png|center|600px]]

Enter the command "/newbot" in the conversation, and Botfather will ask you for all of the information you need. You will need to enter both a name and a unique username for your Bot. The Telegram settings screen provided some suggestions, but you can choose what you want. Since it should be unique, it is recommended you use your organization or sitename as part of these.

[[File:newbot.png|center|600px]]

Once you have given Botfather everything it needs, you will gave the bot token displayed in the conversation:

[[File:bottoken.png|center|600px]]

Transfer the bot token information to the settings screen and hit "Save changes":

[[File:savechanges.png|center|600px]]

The name and username you chose will be filled in for you. Telegram is now ready for your users to configure their message preferences.

[[File:finalsettings.png|center|600px]]

NOTE: The "Setup Telegram webhook" option is still a work in progress.

==Configuring user preferences==

Once you have a Telegram bot configured, users can connect their Telegram accounts to receive notifications and messages. This is done in the user preferences screen under the notification preferences.
As a user, navigate to the "Notification preferences" screen. One the columns will be Telegram, and it will show that it is not configured. Click on the configuration link/icon and the Telegrams settings dialogue will open up:

[[File:telegrampreferences1.png|center|600px]]

At this point, the user needs to initiate a conversation with the Telegram bot that was created for the site. The dialogue offers a link to start this. Click on the "Connect my account to Telegram", and another browser window/tab will open:

[[File:telegramopenrequest.png|center|600px]]

Use the "Open Telegram app" to launch the Telegram app and initiate the conversation with the Telegram bot. You will see the conversation with a "Start" button at the bottom:

[[File:moodlebotstart.png|center|600px]]

Click "Start". A conversation will start like below:

[[File:moodlebotstarted.png|center|600px]]

At this point, return to your Moodle browser window/tab:

[[File:saveprefs.png|center|600px]]

Click "Save changes", and your Telegram connection should be configured. If it isn't (there could be a delay), wait a bit and open the settings dialogue again, and click "Save changes". Note, that if you do not click the save changes before logging off, you will need to start the connect process again. In any case, once you have saved, and the connection is made, you will see that the alert icon is gone, and when you look at your settings, it will give you a link to disconnect your account. Don't use that unless you don't want Telegram integrated with your Moodle account any more:

[[File:prefssaved.png|center|600px]]

You can now select what notifications and messages you want received through Telegram.

Telegram message processor

2017-05-26T13:40:34Z

Mchurch:

This plugin provides a message processor for Telegram, allowing sites to configure a Telegram bot that their users can configure to forward Moodle notifications and messages to their Telegram account.

==Configuring the plugin settings==

At the Telegram main settings page (Plugins / Message outputs / Telegram), you will need to configure a bot token to be used by the site. To get this token, you will need to create a new Telegram bot using the Telegram bot "Botfather".

After you have installed the plugin, at the settings screen, you will see this:

[[File:Settingscreen.png|600px|center]]

The only thing you really need to enter here is the "bot token for the site". The other two fields will be automatically filled in once you save the token. To get the token, you need to open the Botfather in Telegram, which you can do by clicking the provided link below the instructions. When you click it, you will see something like this:

[[File:opentelegram.png|center|600px]]

Open the link in the Telegram app (you need that), or alternatively in the Telegram Web (if your browser allows it). In Telegram, you should see this:

[[File:telegramstartscreen.png|center|600px]]

Click the "Start" button at the bottom to begin the conversation with Botfather. Once you have, you will see:

[[File:botfatherstart.png|center|600px]]

Enter the command "/newbot" in the conversation, and Botfather will ask you for all of the information you need. You will need to enter both a name and a unique username for your Bot. The Telegram settings screen provided some suggestions, but you can choose what you want. Since it should be unique, it is recommended you use your organization or sitename as part of these.

[[File:newbot.png|center|600px]]

Once you have given Botfather everything it needs, you will gave the bot token displayed in the conversation:

[[File:bottoken.png|center|600px]]

Transfer the bot token information to the settings screen and hit "Save changes":

[[File:savechanges.png|center|600px]]

The name and username you chose will be filled in for you. Telegram is now ready for your users to configure their message preferences.

[[File:finalsettings.png|center|600px]]

NOTE: The "Setup Telegram webhook" option is still a work in progress.

==Configuring user preferences==

Once you have a Telegram bot configured, users can connect their Telegram accounts to receive notifications and messages. This is done in the user preferences screen under the notification preferences.
As a user, navigate to the "Notification preferences" screen. One the columns will be Telegram, and it will show that it is not configured. Click on the configuration link/icon and the Telegrams settings dialogue will open up:

[[File:telegrampreferences1.png|center|600px]]

At this point, the user needs to initiate a conversation with the Telegram bot that was created for the site. The dialogue offers a link to start this. Click on the "Connect my account to Telegram", and another browser window/tab will open:

[[File:telegramopenrequest.png|center|600px]]

Use the "Open Telegram app" to launch the Telegram app and initiate the conversation with the Telegram bot. You will see the conversation with a "Start" button at the bottom:

[[File:moodlebotstart.png|center|600px]]

Click "Start". A conversation will start like below:

[[File:moodlebotstarted.png|center|600px]]

At this point, return to your Moodle browser window/tab:

[[File:savechanges.png|center|600px]]

Click "Save changes", and your Telegram connection should be configured. If it isn't (there could be a delay), wait a bit and open the settings dialogue again, and click "Save changes". Note, that if you do not click the save changes before logging off, you will need to start the connect process again. In any case, once you have saved, and the connection is made, you will see that the alert icon is gone, and when you look at your settings, it will give you a link to disconnect your account. Don't use that unless you don't want Telegram integrated with your Moodle account any more:

[[File:prefssaved.png|center|600px]]

You can now select what notifications and messages you want received through Telegram.

Telegram message processor

2017-05-26T13:38:50Z

Mchurch:

This plugin provides a message processor for Telegram, allowing sites to configure a Telegram bot that their users can configure to forward Moodle notifications and messages to their Telegram account.

==Configuring the plugin settings==

At the Telegram main settings page (Plugins / Message outputs / Telegram), you will need to configure a bot token to be used by the site. To get this token, you will need to create a new Telegram bot using the Telegram bot "Botfather".

After you have installed the plugin, at the settings screen, you will see this:

[[File:Settingscreen.png|600px|center]]

The only thing you really need to enter here is the "bot token for the site". The other two fields will be automatically filled in once you save the token. To get the token, you need to open the Botfather in Telegram, which you can do by clicking the provided link below the instructions. When you click it, you will see something like this:

[[File:opentelegram.png|center|600px]]

Open the link in the Telegram app (you need that), or alternatively in the Telegram Web (if your browser allows it). In Telegram, you should see this:

[[File:telegramstartscreen.png|center|600px]]

Click the "Start" button at the bottom to begin the conversation with Botfather. Once you have, you will see:

[[File:botfatherstart.png|center|600px]]

Enter the command "/newbot" in the conversation, and Botfather will ask you for all of the information you need. You will need to enter both a name and a unique username for your Bot. The Telegram settings screen provided some suggestions, but you can choose what you want. Since it should be unique, it is recommended you use your organization or sitename as part of these.

[[File:newbot.png|center|600px]]

Once you have given Botfather everything it needs, you will gave the bot token displayed in the conversation:

[[File:bottoken.png|center|600px]]

Transfer the bot token information to the settings screen and hit "Save changes":

[[File:savechanges.png|center|600px]]

The name and username you chose will be filled in for you. Telegram is now ready for your users to configure their message preferences.

[[File:finalsettings.png|center|600px]]

NOTE: The "Setup Telegram webhook" option is still a work in progress.

==Configuring user preferences==

Once you have a Telegram bot configured, users can connect their Telegram accounts to receive notifications and messages. This is done in the user preferences screen under the notification preferences.
As a user, navigate to the "Notification preferences" screen. One the columns will be Telegram, and it will show that it is not configured. Click on the configuration link/icon and the Telegrams settings dialogue will open up:

[[File:telegrampreferences1.png|center|600px]]

At this point, the user needs to initiate a conversation with the Telegram bot that was created for the site. The dialogue offers a link to start this. Click on the "Connect my account to Telegram", and another browser window/tab will open:

[[File:telegramopenrequest.png|center|600px]]

Use the "Open Telegram app" to launch the Telegram app and initiate the conversation with the Telegram bot. You will see the conversation with a "Start" button at the bottom:

[[File:moodlebotstart.png|center|600px]]

Click "Start". A conversation will start like below:

[[File:moodlebotstarted.png|center|600px]]

At this point, return to your Moodle browser window/tab:

[[File:savechanges.png|center|600px]]

Click "Save changes", and your Telegram connection should be configured. If it isn't (there could be a delay), wait a bit and open the settings dialogue again, and click "Save changes". Note, that if you do not click the save changes before logging off, you will need to start the connect process again. In any case, once you have saved, and the connection is made, you will see that the alert icon is gone, and when you look at your settings, it will give you a link to disconnect your account. Don't use that unless you don't want Telegram integrated with your Moodle account any more:

[[File:changessaved.png|center|600px]]

You can now select what notifications and messages you want received through Telegram.

File:bottoken.png

2017-05-25T20:06:57Z

Mchurch: Mchurch uploaded a new version of File:bottoken.png

File:botfatherstart.png

2017-05-25T20:06:23Z

Mchurch: Mchurch uploaded a new version of File:botfatherstart.png

File:telegramstartscreen.png

2017-05-25T20:05:16Z

Mchurch: Mchurch uploaded a new version of File:telegramstartscreen.png

File:telegramstartscreen.png

2017-05-25T20:04:53Z

Mchurch: Mchurch uploaded a new version of File:telegramstartscreen.png

File:telegramstartscreen.png

2017-05-25T20:02:35Z

Mchurch: Mchurch uploaded a new version of File:telegramstartscreen.png

Telegram message processor

2017-05-25T19:55:30Z

Mchurch:

File:finalsettings.png

2017-05-25T19:54:51Z

Mchurch:

File:savechanges.png

2017-05-25T19:54:20Z

Mchurch: