MoodleDocs - User contributions [en]

Forum settings

2020-01-27T14:13:35Z

Ghillenb: /* Using groups with Forums */

{{Forum}}
A teacher can add a Forum activity in a course when editing is turned on by clicking an 'Add an activity or resource' link (or, if not present, the "Add an activity" drop down menu) and selecting Forum.
==Activity settings==
To see all the settings expanded, click the link "Expand all" top right.

Give the Forum a name (which students see on the course page) and a description if required. (For the Single simple discussion forum type, your description must include the question or topic you wish to discuss.)

For forum type, see the section 'Which forum do I need?' in [[Forum activity]] for further details with screenshots.

Clicking the question mark icon [[File:helppopup.png]]next to any setting you don't understand will display extra help.

===Attachments and word count===

The maximum file size that may be attached to a forum post depends on the Moodle site settings. The teacher may want a smaller size limit for the forum and should bear in mind the download speeds of the course participants.

If "Display word count" is enabled, then the number of words in forum posts will be shown at the bottom of each post.

===Forum subscriptions===

When a participant is subscribed to a forum it means that they will receive notification (depending on the user’s messaging settings preferences) of each new posting. By default, forum notifications are sent about 30 minutes after the post was saved.

Participants can usually choose whether or not they want to be subscribed to each forum. However, the teacher can choose to force subscription on a particular forum then all course users will be subscribed automatically, even those that enrol at a later time.

The subscription mode and subscribe or unsubscribe links can be found via the gear menu inside the forum in Boost or via the Forum administration in Clean. Teachers can quickly change the mode via the 'Subscription mode' options and view the current subscribers via the 'Show/edit current subscribers' link. Teachers can manually subscribe or unsubscribe participants by clicking the 'Manage subscriptions' button. (Button renamed and re-positioned in 3.3; previously named 'Turn editing on'.)

Tips:
* Forcing everyone to subscribe is especially useful in the news forum and in forums towards the beginning of the course (before everyone has worked out that they can subscribe to these emails themselves).
* Changing the setting from "Auto subscription" to "Optional" will not unsubscribe existing users; it will only affect those who enrol in the course in the future. Similarly changing "Optional" to "Auto subscription" will not subscribe existing course users but only those enrolling later.
* There is also a "Subscription disabled" setting which prevents students from subscribing to a Forum. Teachers may choose to subscribe to a forum if they wish.

====Subscribe to individual forum discussions====

In a forum with optional or auto subscription you can choose which discussions to subscribe to by clicking the subscribe / unsubscribe icon to the right of the discussion.
[[File:forumsubscribe.png|thumb|center|600px]]

When you reply to a post you will see a tickbox 'Discussion subscription'. It will already be ticked if you have chosen in your forum preferences to be subscribed to discussions you post in by default. If you have chosen not to subscribe to forum discussions by default, then you can tick this box to be notified of posts from this particular thread.

===RSS===
If [[RSS feeds]] are enabled for the site and for forums, then an expandable section for RSS settings will appear. Here the teacher can turn RSS feeds on or off for that forum.When set to “Discussions,” the RSS feed will send out new discussions to subscribers. When set to “Posts,” the RSS feed will send out any new posts to subscribers.

Cron must be working regularly for the RSS feed to work; otherwise participants will see ' Error reading RSS data'.

===Blocking posts===
By default, course participants can post any number of messages to forums. If you want to restrict this number and block them after a certain number or time, the expandable section 'Post threshold for blocking' allows you to specify your choice. You can also send a warning that they are about to be blocked.

===Whole forum grading===
{{New features}}
When grading is enabled from here, grading options appear, allowing the teacher to select points or a scale. Advanced grading methods such as rubrics may also be used and can be selected from the forum cog menu / Advanced grading. For more information on grading with forums, see [[Using Forum]]

==== Ratings====
Forums use a rating [[Scales|scale]] which you can customise. You can also set a "Grade to pass" which may be connected with [[Activity completion]] and [[Restrict access]] such that a student will not be able to access a follow up activity until they have obtained a required grade (rating) in the forum.

By default, only teachers can rate forum posts, though students can be given permission to do so if desired (see forum permissions below). This is a useful tool for giving students participation grades. Any ratings given in the forum are recorded in the [[Gradebook|gradebook]].

You can set an 'aggregate type' to decide how all the ratings given to posts in a forum are combined to form the final grade (for each post and for the whole forum activity). See [[Ratings]] for an explanation of aggregate types and which one is best for you.

===Other settings===
Depending on what is enabled for your site and course, you may also need to explore [[Common module settings]], [[Conditional activities| Restrict access]] and [[Activity completion]]

If you want your forum to display in the [[Course overview block]], you need to add an 'Expect completed by' date in the [[Activity completion]] section.

If your Forum activity doesn't display as you wish, check the site settings below:

===Using groups with Forums===
For 'Group mode' in the expandable Common module settings section allows you to specify how your forum works with groups. (Note that Single simple discussions cannot be used with groups as this feature is not implemented. Use a standard forum instead. )
For more information about using groups with forums, see the documentation [[Using Forum]].

==Site settings==

A description for the Forum may or may not be obligatory depending on ''Site administration > Plugins > Activity modules > Common settings''.

The forum module has additional settings which may be changed by an administrator in ''Administration > Site administration > Plugins > Activity modules > Forum'' and, for 'Maximum time to edit posts', in ''Administration > Site administration > Security > Site policies''.

===Subscription mode===

'''New in 3.4:''' Administrators can select the default subscription mode for new forums from a drop down menu.
===Timed forum posts===

Teachers (and others with the capability [[Capabilities/mod/forum:viewhiddentimedposts|mod/forum:viewhiddentimedposts]]) can then set a display period of a date and time for the forum post to appear.

[[File:timedposts.png]]

===Changing the subject line of forum notifications===

Normally when forum subscribers receive emails from forums, the subject line is of the form: Course short name + Subject of post:

[[File:forum1.png]]

The subject line can be changed - for example to: Course short name + Forum name + Subject by going to ''Site administration>Language>Language customisation'' and in forum.php changing the string ''postmailsubject'' to
{$a->courseshortname} {$a->forumname} {$a->subject}

[[File:forum2.png]]

Currently the placeholders available for use are:

{$a->courseshortname}
{$a->forumname}
{$a->subject}

[[de:Forum konfigurieren]]
[[fr:Ajouter/modifier un forum]]
[[ja:フォーラムの追加/編集]]
[[es:Configuraciones del foro]]

Forum settings

2020-01-27T14:08:53Z

Ghillenb: /* Using groups with Forums */

{{Forum}}
A teacher can add a Forum activity in a course when editing is turned on by clicking an 'Add an activity or resource' link (or, if not present, the "Add an activity" drop down menu) and selecting Forum.
==Activity settings==
To see all the settings expanded, click the link "Expand all" top right.

Give the Forum a name (which students see on the course page) and a description if required. (For the Single simple discussion forum type, your description must include the question or topic you wish to discuss.)

For forum type, see the section 'Which forum do I need?' in [[Forum activity]] for further details with screenshots.

Clicking the question mark icon [[File:helppopup.png]]next to any setting you don't understand will display extra help.

===Attachments and word count===

The maximum file size that may be attached to a forum post depends on the Moodle site settings. The teacher may want a smaller size limit for the forum and should bear in mind the download speeds of the course participants.

If "Display word count" is enabled, then the number of words in forum posts will be shown at the bottom of each post.

===Forum subscriptions===

When a participant is subscribed to a forum it means that they will receive notification (depending on the user’s messaging settings preferences) of each new posting. By default, forum notifications are sent about 30 minutes after the post was saved.

Participants can usually choose whether or not they want to be subscribed to each forum. However, the teacher can choose to force subscription on a particular forum then all course users will be subscribed automatically, even those that enrol at a later time.

The subscription mode and subscribe or unsubscribe links can be found via the gear menu inside the forum in Boost or via the Forum administration in Clean. Teachers can quickly change the mode via the 'Subscription mode' options and view the current subscribers via the 'Show/edit current subscribers' link. Teachers can manually subscribe or unsubscribe participants by clicking the 'Manage subscriptions' button. (Button renamed and re-positioned in 3.3; previously named 'Turn editing on'.)

Tips:
* Forcing everyone to subscribe is especially useful in the news forum and in forums towards the beginning of the course (before everyone has worked out that they can subscribe to these emails themselves).
* Changing the setting from "Auto subscription" to "Optional" will not unsubscribe existing users; it will only affect those who enrol in the course in the future. Similarly changing "Optional" to "Auto subscription" will not subscribe existing course users but only those enrolling later.
* There is also a "Subscription disabled" setting which prevents students from subscribing to a Forum. Teachers may choose to subscribe to a forum if they wish.

====Subscribe to individual forum discussions====

In a forum with optional or auto subscription you can choose which discussions to subscribe to by clicking the subscribe / unsubscribe icon to the right of the discussion.
[[File:forumsubscribe.png|thumb|center|600px]]

When you reply to a post you will see a tickbox 'Discussion subscription'. It will already be ticked if you have chosen in your forum preferences to be subscribed to discussions you post in by default. If you have chosen not to subscribe to forum discussions by default, then you can tick this box to be notified of posts from this particular thread.

===RSS===
If [[RSS feeds]] are enabled for the site and for forums, then an expandable section for RSS settings will appear. Here the teacher can turn RSS feeds on or off for that forum.When set to “Discussions,” the RSS feed will send out new discussions to subscribers. When set to “Posts,” the RSS feed will send out any new posts to subscribers.

Cron must be working regularly for the RSS feed to work; otherwise participants will see ' Error reading RSS data'.

===Blocking posts===
By default, course participants can post any number of messages to forums. If you want to restrict this number and block them after a certain number or time, the expandable section 'Post threshold for blocking' allows you to specify your choice. You can also send a warning that they are about to be blocked.

===Whole forum grading===
{{New features}}
When grading is enabled from here, grading options appear, allowing the teacher to select points or a scale. Advanced grading methods such as rubrics may also be used and can be selected from the forum cog menu / Advanced grading. For more information on grading with forums, see [[Using Forum]]

==== Ratings====
Forums use a rating [[Scales|scale]] which you can customise. You can also set a "Grade to pass" which may be connected with [[Activity completion]] and [[Restrict access]] such that a student will not be able to access a follow up activity until they have obtained a required grade (rating) in the forum.

By default, only teachers can rate forum posts, though students can be given permission to do so if desired (see forum permissions below). This is a useful tool for giving students participation grades. Any ratings given in the forum are recorded in the [[Gradebook|gradebook]].

You can set an 'aggregate type' to decide how all the ratings given to posts in a forum are combined to form the final grade (for each post and for the whole forum activity). See [[Ratings]] for an explanation of aggregate types and which one is best for you.

===Other settings===
Depending on what is enabled for your site and course, you may also need to explore [[Common module settings]], [[Conditional activities| Restrict access]] and [[Activity completion]]

If you want your forum to display in the [[Course overview block]], you need to add an 'Expect completed by' date in the [[Activity completion]] section.

If your Forum activity doesn't display as you wish, check the site settings below:

====Using groups with Forums====
For 'Group mode' in the expandable Common module settings section allows you to specify how your forum works with groups. (Note that Single simple discussions cannot be used with groups as this feature is not implemented. Use a standard forum instead. )
For more information about using groups with forums, see the documentation [[Using Forum]].

==Site settings==

A description for the Forum may or may not be obligatory depending on ''Site administration > Plugins > Activity modules > Common settings''.

The forum module has additional settings which may be changed by an administrator in ''Administration > Site administration > Plugins > Activity modules > Forum'' and, for 'Maximum time to edit posts', in ''Administration > Site administration > Security > Site policies''.

===Subscription mode===

'''New in 3.4:''' Administrators can select the default subscription mode for new forums from a drop down menu.
===Timed forum posts===

Teachers (and others with the capability [[Capabilities/mod/forum:viewhiddentimedposts|mod/forum:viewhiddentimedposts]]) can then set a display period of a date and time for the forum post to appear.

[[File:timedposts.png]]

===Changing the subject line of forum notifications===

Normally when forum subscribers receive emails from forums, the subject line is of the form: Course short name + Subject of post:

[[File:forum1.png]]

The subject line can be changed - for example to: Course short name + Forum name + Subject by going to ''Site administration>Language>Language customisation'' and in forum.php changing the string ''postmailsubject'' to
{$a->courseshortname} {$a->forumname} {$a->subject}

[[File:forum2.png]]

Currently the placeholders available for use are:

{$a->courseshortname}
{$a->forumname}
{$a->subject}

[[de:Forum konfigurieren]]
[[fr:Ajouter/modifier un forum]]
[[ja:フォーラムの追加/編集]]
[[es:Configuraciones del foro]]

Forum settings

2020-01-27T14:07:27Z

Ghillenb: /* Using groups with Forums */

{{Forum}}
A teacher can add a Forum activity in a course when editing is turned on by clicking an 'Add an activity or resource' link (or, if not present, the "Add an activity" drop down menu) and selecting Forum.
==Activity settings==
To see all the settings expanded, click the link "Expand all" top right.

Give the Forum a name (which students see on the course page) and a description if required. (For the Single simple discussion forum type, your description must include the question or topic you wish to discuss.)

For forum type, see the section 'Which forum do I need?' in [[Forum activity]] for further details with screenshots.

Clicking the question mark icon [[File:helppopup.png]]next to any setting you don't understand will display extra help.

===Attachments and word count===

The maximum file size that may be attached to a forum post depends on the Moodle site settings. The teacher may want a smaller size limit for the forum and should bear in mind the download speeds of the course participants.

If "Display word count" is enabled, then the number of words in forum posts will be shown at the bottom of each post.

===Forum subscriptions===

When a participant is subscribed to a forum it means that they will receive notification (depending on the user’s messaging settings preferences) of each new posting. By default, forum notifications are sent about 30 minutes after the post was saved.

Participants can usually choose whether or not they want to be subscribed to each forum. However, the teacher can choose to force subscription on a particular forum then all course users will be subscribed automatically, even those that enrol at a later time.

The subscription mode and subscribe or unsubscribe links can be found via the gear menu inside the forum in Boost or via the Forum administration in Clean. Teachers can quickly change the mode via the 'Subscription mode' options and view the current subscribers via the 'Show/edit current subscribers' link. Teachers can manually subscribe or unsubscribe participants by clicking the 'Manage subscriptions' button. (Button renamed and re-positioned in 3.3; previously named 'Turn editing on'.)

Tips:
* Forcing everyone to subscribe is especially useful in the news forum and in forums towards the beginning of the course (before everyone has worked out that they can subscribe to these emails themselves).
* Changing the setting from "Auto subscription" to "Optional" will not unsubscribe existing users; it will only affect those who enrol in the course in the future. Similarly changing "Optional" to "Auto subscription" will not subscribe existing course users but only those enrolling later.
* There is also a "Subscription disabled" setting which prevents students from subscribing to a Forum. Teachers may choose to subscribe to a forum if they wish.

====Subscribe to individual forum discussions====

In a forum with optional or auto subscription you can choose which discussions to subscribe to by clicking the subscribe / unsubscribe icon to the right of the discussion.
[[File:forumsubscribe.png|thumb|center|600px]]

When you reply to a post you will see a tickbox 'Discussion subscription'. It will already be ticked if you have chosen in your forum preferences to be subscribed to discussions you post in by default. If you have chosen not to subscribe to forum discussions by default, then you can tick this box to be notified of posts from this particular thread.

===RSS===
If [[RSS feeds]] are enabled for the site and for forums, then an expandable section for RSS settings will appear. Here the teacher can turn RSS feeds on or off for that forum.When set to “Discussions,” the RSS feed will send out new discussions to subscribers. When set to “Posts,” the RSS feed will send out any new posts to subscribers.

Cron must be working regularly for the RSS feed to work; otherwise participants will see ' Error reading RSS data'.

===Blocking posts===
By default, course participants can post any number of messages to forums. If you want to restrict this number and block them after a certain number or time, the expandable section 'Post threshold for blocking' allows you to specify your choice. You can also send a warning that they are about to be blocked.

===Whole forum grading===
{{New features}}
When grading is enabled from here, grading options appear, allowing the teacher to select points or a scale. Advanced grading methods such as rubrics may also be used and can be selected from the forum cog menu / Advanced grading. For more information on grading with forums, see [[Using Forum]]

==== Ratings====
Forums use a rating [[Scales|scale]] which you can customise. You can also set a "Grade to pass" which may be connected with [[Activity completion]] and [[Restrict access]] such that a student will not be able to access a follow up activity until they have obtained a required grade (rating) in the forum.

By default, only teachers can rate forum posts, though students can be given permission to do so if desired (see forum permissions below). This is a useful tool for giving students participation grades. Any ratings given in the forum are recorded in the [[Gradebook|gradebook]].

You can set an 'aggregate type' to decide how all the ratings given to posts in a forum are combined to form the final grade (for each post and for the whole forum activity). See [[Ratings]] for an explanation of aggregate types and which one is best for you.

===Other settings===
Depending on what is enabled for your site and course, you may also need to explore [[Common module settings]], [[Conditional activities| Restrict access]] and [[Activity completion]]

If you want your forum to display in the [[Course overview block]], you need to add an 'Expect completed by' date in the [[Activity completion]] section.

If your Forum activity doesn't display as you wish, check the site settings below:

====Using groups with Forums====
For 'Group mode' in the expandable Common module settings section allows you to specify how your forum works with groups. (Note that Single simple discussions cannot be used with groups as this feature is not implemented. Use a standard forum instead. )
For more information about using groups with forums, see the documentation [[Using Forum]]
The '''group mode''' setting has three options:

==Site settings==

A description for the Forum may or may not be obligatory depending on ''Site administration > Plugins > Activity modules > Common settings''.

The forum module has additional settings which may be changed by an administrator in ''Administration > Site administration > Plugins > Activity modules > Forum'' and, for 'Maximum time to edit posts', in ''Administration > Site administration > Security > Site policies''.

===Subscription mode===

'''New in 3.4:''' Administrators can select the default subscription mode for new forums from a drop down menu.
===Timed forum posts===

Teachers (and others with the capability [[Capabilities/mod/forum:viewhiddentimedposts|mod/forum:viewhiddentimedposts]]) can then set a display period of a date and time for the forum post to appear.

[[File:timedposts.png]]

===Changing the subject line of forum notifications===

Normally when forum subscribers receive emails from forums, the subject line is of the form: Course short name + Subject of post:

[[File:forum1.png]]

The subject line can be changed - for example to: Course short name + Forum name + Subject by going to ''Site administration>Language>Language customisation'' and in forum.php changing the string ''postmailsubject'' to
{$a->courseshortname} {$a->forumname} {$a->subject}

[[File:forum2.png]]

Currently the placeholders available for use are:

{$a->courseshortname}
{$a->forumname}
{$a->subject}

[[de:Forum konfigurieren]]
[[fr:Ajouter/modifier un forum]]
[[ja:フォーラムの追加/編集]]
[[es:Configuraciones del foro]]

Forum settings

2020-01-27T13:29:17Z

Ghillenb: /* Ratings */

{{Forum}}
A teacher can add a Forum activity in a course when editing is turned on by clicking an 'Add an activity or resource' link (or, if not present, the "Add an activity" drop down menu) and selecting Forum.
==Activity settings==
To see all the settings expanded, click the link "Expand all" top right.

Give the Forum a name (which students see on the course page) and a description if required. (For the Single simple discussion forum type, your description must include the question or topic you wish to discuss.)

For forum type, see the section 'Which forum do I need?' in [[Forum activity]] for further details with screenshots.

Clicking the question mark icon [[File:helppopup.png]]next to any setting you don't understand will display extra help.

===Attachments and word count===

The maximum file size that may be attached to a forum post depends on the Moodle site settings. The teacher may want a smaller size limit for the forum and should bear in mind the download speeds of the course participants.

If "Display word count" is enabled, then the number of words in forum posts will be shown at the bottom of each post.

===Forum subscriptions===

When a participant is subscribed to a forum it means that they will receive notification (depending on the user’s messaging settings preferences) of each new posting. By default, forum notifications are sent about 30 minutes after the post was saved.

Participants can usually choose whether or not they want to be subscribed to each forum. However, the teacher can choose to force subscription on a particular forum then all course users will be subscribed automatically, even those that enrol at a later time.

The subscription mode and subscribe or unsubscribe links can be found via the gear menu inside the forum in Boost or via the Forum administration in Clean. Teachers can quickly change the mode via the 'Subscription mode' options and view the current subscribers via the 'Show/edit current subscribers' link. Teachers can manually subscribe or unsubscribe participants by clicking the 'Manage subscriptions' button. (Button renamed and re-positioned in 3.3; previously named 'Turn editing on'.)

Tips:
* Forcing everyone to subscribe is especially useful in the news forum and in forums towards the beginning of the course (before everyone has worked out that they can subscribe to these emails themselves).
* Changing the setting from "Auto subscription" to "Optional" will not unsubscribe existing users; it will only affect those who enrol in the course in the future. Similarly changing "Optional" to "Auto subscription" will not subscribe existing course users but only those enrolling later.
* There is also a "Subscription disabled" setting which prevents students from subscribing to a Forum. Teachers may choose to subscribe to a forum if they wish.

====Subscribe to individual forum discussions====

In a forum with optional or auto subscription you can choose which discussions to subscribe to by clicking the subscribe / unsubscribe icon to the right of the discussion.
[[File:forumsubscribe.png|thumb|center|600px]]

When you reply to a post you will see a tickbox 'Discussion subscription'. It will already be ticked if you have chosen in your forum preferences to be subscribed to discussions you post in by default. If you have chosen not to subscribe to forum discussions by default, then you can tick this box to be notified of posts from this particular thread.

===RSS===
If [[RSS feeds]] are enabled for the site and for forums, then an expandable section for RSS settings will appear. Here the teacher can turn RSS feeds on or off for that forum.When set to “Discussions,” the RSS feed will send out new discussions to subscribers. When set to “Posts,” the RSS feed will send out any new posts to subscribers.

Cron must be working regularly for the RSS feed to work; otherwise participants will see ' Error reading RSS data'.

===Blocking posts===
By default, course participants can post any number of messages to forums. If you want to restrict this number and block them after a certain number or time, the expandable section 'Post threshold for blocking' allows you to specify your choice. You can also send a warning that they are about to be blocked.

===Whole forum grading===
{{New features}}
When grading is enabled from here, grading options appear, allowing the teacher to select points or a scale. Advanced grading methods such as rubrics may also be used and can be selected from the forum cog menu / Advanced grading. For more information on grading with forums, see [[Using Forum]]

==== Ratings====
Forums use a rating [[Scales|scale]] which you can customise. You can also set a "Grade to pass" which may be connected with [[Activity completion]] and [[Restrict access]] such that a student will not be able to access a follow up activity until they have obtained a required grade (rating) in the forum.

By default, only teachers can rate forum posts, though students can be given permission to do so if desired (see forum permissions below). This is a useful tool for giving students participation grades. Any ratings given in the forum are recorded in the [[Gradebook|gradebook]].

You can set an 'aggregate type' to decide how all the ratings given to posts in a forum are combined to form the final grade (for each post and for the whole forum activity). See [[Ratings]] for an explanation of aggregate types and which one is best for you.

===Other settings===
Depending on what is enabled for your site and course, you may also need to explore [[Common module settings]], [[Conditional activities| Restrict access]] and [[Activity completion]]

If you want your forum to display in the [[Course overview block]], you need to add an 'Expect completed by' date in the [[Activity completion]] section.

If your Forum activity doesn't display as you wish, check the site settings below:

===Using groups with Forums===
For 'Group mode' in the expandable Common module settings section allows you to specify how your forum works with groups. (Note that Single simple discussions cannot be used with groups as this feature is not implemented. Use a standard forum instead. )
For more information about using groups with forums, see the documentation [[Using Forum]]
The '''group mode''' setting has three options:

==Site settings==

A description for the Forum may or may not be obligatory depending on ''Site administration > Plugins > Activity modules > Common settings''.

The forum module has additional settings which may be changed by an administrator in ''Administration > Site administration > Plugins > Activity modules > Forum'' and, for 'Maximum time to edit posts', in ''Administration > Site administration > Security > Site policies''.

===Subscription mode===

'''New in 3.4:''' Administrators can select the default subscription mode for new forums from a drop down menu.
===Timed forum posts===

Teachers (and others with the capability [[Capabilities/mod/forum:viewhiddentimedposts|mod/forum:viewhiddentimedposts]]) can then set a display period of a date and time for the forum post to appear.

[[File:timedposts.png]]

===Changing the subject line of forum notifications===

Normally when forum subscribers receive emails from forums, the subject line is of the form: Course short name + Subject of post:

[[File:forum1.png]]

The subject line can be changed - for example to: Course short name + Forum name + Subject by going to ''Site administration>Language>Language customisation'' and in forum.php changing the string ''postmailsubject'' to
{$a->courseshortname} {$a->forumname} {$a->subject}

[[File:forum2.png]]

Currently the placeholders available for use are:

{$a->courseshortname}
{$a->forumname}
{$a->subject}

[[de:Forum konfigurieren]]
[[fr:Ajouter/modifier un forum]]
[[ja:フォーラムの追加/編集]]
[[es:Configuraciones del foro]]

Forum settings

2020-01-27T11:52:07Z

Ghillenb: /* Whole forum grading */

{{Forum}}
A teacher can add a Forum activity in a course when editing is turned on by clicking an 'Add an activity or resource' link (or, if not present, the "Add an activity" drop down menu) and selecting Forum.
==Activity settings==
To see all the settings expanded, click the link "Expand all" top right.

Give the Forum a name (which students see on the course page) and a description if required. (For the Single simple discussion forum type, your description must include the question or topic you wish to discuss.)

For forum type, see the section 'Which forum do I need?' in [[Forum activity]] for further details with screenshots.

Clicking the question mark icon [[File:helppopup.png]]next to any setting you don't understand will display extra help.

===Attachments and word count===

The maximum file size that may be attached to a forum post depends on the Moodle site settings. The teacher may want a smaller size limit for the forum and should bear in mind the download speeds of the course participants.

If "Display word count" is enabled, then the number of words in forum posts will be shown at the bottom of each post.

===Forum subscriptions===

When a participant is subscribed to a forum it means that they will receive notification (depending on the user’s messaging settings preferences) of each new posting. By default, forum notifications are sent about 30 minutes after the post was saved.

Participants can usually choose whether or not they want to be subscribed to each forum. However, the teacher can choose to force subscription on a particular forum then all course users will be subscribed automatically, even those that enrol at a later time.

The subscription mode and subscribe or unsubscribe links can be found via the gear menu inside the forum in Boost or via the Forum administration in Clean. Teachers can quickly change the mode via the 'Subscription mode' options and view the current subscribers via the 'Show/edit current subscribers' link. Teachers can manually subscribe or unsubscribe participants by clicking the 'Manage subscriptions' button. (Button renamed and re-positioned in 3.3; previously named 'Turn editing on'.)

Tips:
* Forcing everyone to subscribe is especially useful in the news forum and in forums towards the beginning of the course (before everyone has worked out that they can subscribe to these emails themselves).
* Changing the setting from "Auto subscription" to "Optional" will not unsubscribe existing users; it will only affect those who enrol in the course in the future. Similarly changing "Optional" to "Auto subscription" will not subscribe existing course users but only those enrolling later.
* There is also a "Subscription disabled" setting which prevents students from subscribing to a Forum. Teachers may choose to subscribe to a forum if they wish.

====Subscribe to individual forum discussions====

In a forum with optional or auto subscription you can choose which discussions to subscribe to by clicking the subscribe / unsubscribe icon to the right of the discussion.
[[File:forumsubscribe.png|thumb|center|600px]]

When you reply to a post you will see a tickbox 'Discussion subscription'. It will already be ticked if you have chosen in your forum preferences to be subscribed to discussions you post in by default. If you have chosen not to subscribe to forum discussions by default, then you can tick this box to be notified of posts from this particular thread.

===RSS===
If [[RSS feeds]] are enabled for the site and for forums, then an expandable section for RSS settings will appear. Here the teacher can turn RSS feeds on or off for that forum.When set to “Discussions,” the RSS feed will send out new discussions to subscribers. When set to “Posts,” the RSS feed will send out any new posts to subscribers.

Cron must be working regularly for the RSS feed to work; otherwise participants will see ' Error reading RSS data'.

===Blocking posts===
By default, course participants can post any number of messages to forums. If you want to restrict this number and block them after a certain number or time, the expandable section 'Post threshold for blocking' allows you to specify your choice. You can also send a warning that they are about to be blocked.

===Whole forum grading===
{{New features}}
When grading is enabled from here, grading options appear, allowing the teacher to select points or a scale. Advanced grading methods such as rubrics may also be used and can be selected from the forum cog menu / Advanced grading. For more information on grading with forums, see [[Using Forum]]

=== Ratings===
Forums use a rating [[Scales|scale]] which you can customise. You can also set a "Grade to pass" which may be connected with [[Activity completion]] and [[Restrict access]] such that a student will not be able to access a follow up activity until they have obtained a required grade (rating) in the forum.

By default, only teachers can rate forum posts, though students can be given permission to do so if desired (see forum permissions below). This is a useful tool for giving students participation grades. Any ratings given in the forum are recorded in the [[Gradebook|gradebook]].

You can set an 'aggregate type' to decide how all the ratings given to posts in a forum are combined to form the final grade (for each post and for the whole forum activity). See [[Ratings]] for an explanation of aggregate types and which one is best for you.

===Other settings===
Depending on what is enabled for your site and course, you may also need to explore [[Common module settings]], [[Conditional activities| Restrict access]] and [[Activity completion]]

If you want your forum to display in the [[Course overview block]], you need to add an 'Expect completed by' date in the [[Activity completion]] section.

If your Forum activity doesn't display as you wish, check the site settings below:

===Using groups with Forums===
For 'Group mode' in the expandable Common module settings section allows you to specify how your forum works with groups. (Note that Single simple discussions cannot be used with groups as this feature is not implemented. Use a standard forum instead. )
For more information about using groups with forums, see the documentation [[Using Forum]]
The '''group mode''' setting has three options:

==Site settings==

A description for the Forum may or may not be obligatory depending on ''Site administration > Plugins > Activity modules > Common settings''.

The forum module has additional settings which may be changed by an administrator in ''Administration > Site administration > Plugins > Activity modules > Forum'' and, for 'Maximum time to edit posts', in ''Administration > Site administration > Security > Site policies''.

===Subscription mode===

'''New in 3.4:''' Administrators can select the default subscription mode for new forums from a drop down menu.
===Timed forum posts===

Teachers (and others with the capability [[Capabilities/mod/forum:viewhiddentimedposts|mod/forum:viewhiddentimedposts]]) can then set a display period of a date and time for the forum post to appear.

[[File:timedposts.png]]

===Changing the subject line of forum notifications===

Normally when forum subscribers receive emails from forums, the subject line is of the form: Course short name + Subject of post:

[[File:forum1.png]]

The subject line can be changed - for example to: Course short name + Forum name + Subject by going to ''Site administration>Language>Language customisation'' and in forum.php changing the string ''postmailsubject'' to
{$a->courseshortname} {$a->forumname} {$a->subject}

[[File:forum2.png]]

Currently the placeholders available for use are:

{$a->courseshortname}
{$a->forumname}
{$a->subject}

[[de:Forum konfigurieren]]
[[fr:Ajouter/modifier un forum]]
[[ja:フォーラムの追加/編集]]
[[es:Configuraciones del foro]]

Course relative dates

2020-01-24T14:10:18Z

Ghillenb:

{{Courses}}
{{New features}}
The course relative dates feature enables course or activity dates to be displayed relative to the user's start date in the course.

The user's course start date is their enrolment start date, unless they are enrolled before the course begins, in which case their start date will be the course start date.

Course relative dates is an 'experimental feature' as it has not yet been implemented in all activities. In Moodle 3.8 it is implemented in the assignment activity and for the weekly course format.

==Using course relative dates==

To use course relative dates, an admin must first enable it for the site in ''Site administration / Development / Experimental settings''.

If course relative dates is enabled for the site, when adding a new course, you can choose to enable relative dates mode.

Note: After saving the course settings, relative dates mode cannot be changed. The setting is displayed greyed out. Relative dates mode cannot be enabled for existing courses.

[[es:Fechas relativas del curso]]
[[de:Relative Daten für Kurs]]

Display H5P filter

2020-01-24T14:09:36Z

Ghillenb:

{{Filters}}{{New features}}

The Display H5P filter converts URLs into embedded [[H5P]] content.

If the filter is disabled, or if users attempt to add H5P content from a different source than specified in the site administration, the URLs will remain as links and not be displayed as embedded H5P content.

==Site administration settings==

The Display H5P filter must be enabled by an administrator via ''Site administration > Plugins > Filters''.

The list of URLs from which users can embed H5P content is specified in ''Site administration / Plugins / Filters / Display H5P''. By default it is <nowiki>https://h5p.org/h5p/embed/[id]</nowiki> where '[id]' is a placeholder for the H5P content ID in the external source.

==Course administration settings==

Within a course, the filter may be enabled or disabled from the Filters link from the cog icon top right in the [[Boost theme]] or from ''Course administration > Filters'' in the [[Classic theme]].

[[Category:H5P]]

[[es:Filtro para mostrar H5P]]
[[de:H5P anzeigen]]

Capabilities/moodle/h5p:updatelibraries

2020-01-24T14:08:43Z

Ghillenb:

{{New features}}
{{Capabilities}}
*This capability allows a user to manage H5P content types.
*It is enabled by default for managers and admins, but not for teachers
*Users with h5p:deploy capability but without h5p:updatelibraries capability will be able to upload new H5P content that uses existing libraries in the site. If any of the libraries they are trying to use in the uploaded content are not available, they will see an error asking them to contact their admin to make that library available.
[[Category:Capabilities]]

[[es:Capabilities/moodle/h5p:updatelibraries]]
[[de:Capabilities/moodle/h5p:updatelibraries]]

Capabilities/moodle/h5p:deploy

2020-01-24T14:08:12Z

Ghillenb:

{{New features}}
{{Capabilities}}
*This capability allows a user to display uploaded H5P content.
*This capability is allowed by default for managers and teachers.
*Users with h5p:deploy capability but without [[Capabilities/moodle/h5p:updatelibraries|h5p:updatelibraries]] capability will be able to upload new H5P content that uses existing libraries in the site. If any of the libraries they are trying to use in the uploaded content are not available, they will see an error asking them to contact their admin to make that library available.

[[Category:Capabilities]]

[[es:Capabilities/moodle/h5p:deploy]]
[[de:Capabilities/moodle/h5p:deploy]]

Capabilities/mod/assign:grade

2019-07-31T09:34:50Z

Ghillenb:

{{Capabilities}}
*This allows a user to see submissions, add comments to and [[Using Assignment|grade assignments]]
*This capability is allowed for the default roles of manager, teacher and non-editing teacher

[[Category:Capabilities|Assignment]]
[[Category:Assignment]]

[[eu:Capabilities/mod/assignment:grade]]
[[fr:Capabilities/mod/assignment:grade]]
[[ja:ケイパビリティ/mod/assignment:grade]]
[[es:Capabilities/mod/assign:grade]]
[[de:Capabilities/mod/assign:grade]]

Curriculum theory

2019-07-29T14:16:51Z

Ghillenb:

{{About Moodle}}

"Curriculum theory" is a term for how an educational institution decides what is at worth to learn and teach, and how learning will be measured. [[Pedagogy]] is closely related to curriculum theory, but where pedagogy describes how people teach and learn, curriculum describes how people decide what to teach and learn. Moodle is capable of supporting a variety of different curriculum theories and pedagogies.

== Overview ==
The mission of Moodle is "Empowering educators to improve our world." Moodle strives to help educators to provide quality education around the world. But first, we have to answer an important question: “What is quality education?” We can’t measure what we haven’t defined. But this is a very difficult question to answer-- in fact, there is not just one single answer. The answer can differ depending on time and place, and most people work with more than one of these definitions. Here are some things “quality education” might mean. They are all valid. Some are much harder to measure than others, but that doesn’t mean the hard things are less important. In fact, they may be MOST important.

* The best students will be identified and will become scholars
* All students will demonstrate essential competencies
* All students will develop lifelong learning habits and skills and pursue their own goals
* All students will be included and will commit to community ideals and action

There are many ways to categorize curriculum theories, but this structure serves as a useful reference:

{| class="wikitable" border="1"
|-
!colspan = "4"|Source of knowledge
|-
! rowspan = "2"|Objective reality
|'''Academic'''<br>''Students become scholars''<br>Traditional teaching<br>Cognitivism
|'''Individualist'''<br>''Students develop lifelong learning habits''<br>Learner centered<br>Constructivism
! rowspan = "2"|Subjective reality
|-
|'''Pragmatic'''<br>''Students achieve competencies''<br>Workplace training<br>Behaviorism
| '''Idealist'''<br>''Students commit to ideals and take action''<br>Transformational learning<br>Social constructivism
|-
!colspan = "4"|Use of knowledge
|}
<small>For more information, see [https://us.sagepub.com/en-us/nam/curriculum-theory/book230562 Curriculum Theory: Conflicting visions and enduring concerns] by Michael Schiro.</small>

In this structure, an educational program (or teacher) can be aligned with any of these four curriculum theories, and most are aligned with more than one at any given time. The alignment can change over time, and by context. These are just terms used to reference the educational priorities currently in effect.

The important thing to note is that each curriculum theory aligns with a specific pedagogy, and this has implications for choosing teaching strategies, assessments, program evaluation criteria, [[Learning analytics|learning analytics models]], etc. Moodle provides a wide variety of tools to support these different curriculum theories.

== Academic ==
An institution focused on an Academic curriculum has the following goals:
* Student capabilities will be accurately measured
* Student grades follow normal curve
* Students graduate on time
* Top students pursue academic careers

Every community needs to be able to identify and encourage its own scholars. Moodle supports the growth of local scholars in many ways, especially by providing a flexible [[Assignment]] module that can accept a wide variety of files, incorporating [[Advanced grading methods]] like Rubrics and Marking Guides to support consistency in grading. Files can be [[Assignment activity#Feedback_types|annotated online]] by the teacher, and comments can be exchanged between teacher and student.

Moodle also supports external academic honesty and reference checking tools like [[Plagiarism Prevention Crot Settings|Crot]] and [[Plagiarism Prevention Turnitin|TurnItIn]], often requested by academic institutions to help teach good scholarship practices. Moodle provides tools requiring students to agree to academic codes of conduct when [[Policy settings|first logging in]] or when [[Assignment settings#Submission_settings |submitting particular assessments]].

Moodle provides a detailed [[Quiz statistics report]] that provides psychometric analysis of individual quiz questions. This helps to ensure that quizzes are assessing students accurately and fairly.

Learning analytics for this perspective might focus on features of the program, rather than the individual students, although advising students of where they rank in the program may also be appropriate. Note that there can be consequences to this notification-- students who are not ranked highest may become discouraged.

== Pragmatic ==
We don’t want to focus only on the highest-potential students. We also want to make sure that all students (or as many as possible) achieve essential competencies. In this case, we have different tools, targets and process indicators. In this curriculum theory, the institution prioritizes these goals:

* All students complete course
* All students master designated competencies
* All students obtain jobs

Moodle includes a wide range of “Personalized Learning” tools to allow courses and materials to be tailored to individual needs, taking into account each learner’s prior knowledge and skills:
* [[Restrict access settings|Access restrictions]]
* [[Lesson]] module with branching
* [[Quiz|Quizzes]] with [[Quiz settings#Review_options|feedback]]
* [[SCORM]] support
* [[Course completion]] criteria
* [[Competencies]] and [[Learning plans]]

The [[Students at risk of dropping out]] learning analytics model uses the target of continuing participation in learning. This target was chosen because it makes few assumptions. Final grades or summative assessment results are often not stored in Moodle, and many institutions do not yet use Moodle Competencies or Course Completion Criteria. Only success criteria that are stored in Moodle can be used to train a model.

== Individualist ==
We also know that we don’t want to focus only on “schooling.” We hope to encourage students to continue to learn throughout their lives, in both formal and informal environments. This involves helping students develop “metacognitive” skills, such as finding and evaluating information, self-regulation, and the ability to self-assess skills and knowledge. Learners have their own personal goals as well, which we need to respect. These targets and indicators are especially important when trying to use learning analytics in MOOCs, which students enroll in for many different reasons, with different success criteria:

* Learner Centered
* Each learner’s own goals are reached
* Each learner is satisfied
* Each learner improves in capabilities over time

[https://moodle.org/plugins/mod_checklist “Checklist”] is a third-party Moodle plugin that allows learners to specify their own goals and target dates, as well as allowing them to self-evaluate on those goals. This is one kind of feature we need to help assess self-directed learning capacity. We can use the [[Feedback]] tool to capture learner satisfaction data and comments, including site-wide feedback tools set up on the site front page and accessed in each course via the [[Feedback block]]. We might also integrate goal-setting with external calendar and reminder systems, or help learners “gamify” their own personal goals. (It is also possible to create a personal goal registry like this using [[Database]], though the completion bar would require custom CSS.)

We might consider making self-assessment a measured skill, e.g. by using the [[Workshop]] Submission/[[Workshop settings#Use_self-assessment|Self-Assessment]] feature. This feature measures assessment skill compared to a mean of peer and/or teacher scores, and assigns a separate grade for assessment skill as well as a grade for the main task.

[[Portfolio]] tools are often used to help learners curate and compare samples of their work to see progress over time.

== Idealist ==
In the Idealist curriculum theory, we stress the inclusion of all students and [[Pedagogy|social constructivist learning]].

* All students participate fully in the course (are not marginalized)
* All students commit to ideals
* All students carry learning to the real world

We believe learners adopt new ideals through open dialogue and engagement, and Moodle provides robust [[Forum]] tools for supporting discussion.

However, the commitment to such ideals in the real world can’t be measured within the constraints of a course or training program. To follow up with learners “in the real world,” we might need a tool like this third-party Moodle module, [https://moodle.org/plugins/mod_reengagement “Reengagement”]. This tool contacts learners at a specified time after an event, asking them to return to the course to complete additional activities.

[[de:Curriculum-Theorie]]

Researcher role

2019-07-25T09:02:36Z

Ghillenb:

{{Learning analytics}}

Researchers at Moodle-using institutions can be supported by creating a special [[Managing_roles|Role]] at the site level with capabilities specific to researchers. This can be based on the [[Manager role]], or can be a new role that can be added to users with other roles in the system. The most relevant capabilities to provide to researchers include:

* [[Capabilities/moodle/analytics:listinsights]]
* [[Capabilities/moodle/analytics:managemodels]]
* [[Capabilities/moodle/site:configview]]

A user with this role will be able to see all insights, but not all insights actions are available to this researcher user because action links depend on other capabilities (e.g. before showing enrol users link as a suggested action for a course without teachers we check that the user can enrol users).

[[es:Rol de investigador]]
[[de:Forscher-Rolle]]

Learning analytics quick guide

2019-07-25T09:00:49Z

Ghillenb:

{{Learning analytics}}

This quick guide is intended to introduce teachers to Moodle Learning Analytics. For further details about the Moodle Learning Analytics system, see the links in the sidebar.

== Overview ==
If your Moodle site administrator has enabled Moodle Learning Analytics, you may receive special notifications called "insights" sent by learning analytics models.
[[File:insight_notifications.png|frame|center]]

These will vary based on the '''models''' enabled on your site. Insights may be predictions about future performance, or may detect current, hidden aspects or processes of learning. They may apply to students, courses, cohorts, or any other entity in Moodle. One model that is included with Moodle core is [[Students at risk of dropping out]], which makes predictions about the future performance of all students enroled in current courses (those with a start date in the past and an end date in the future). The system is flexible and allows the creation of many other types of models, as well. Each model is defined around one '''target'''. See [[Learning analytics targets]] for more details.

== View Insights ==
Models will start generating predictions at different points in time, depending on the site prediction models and details like the course start and end dates.

Each model defines which '''samples''' (e.g. student enrolments) will generate insights and which samples will be ignored. For example, the ''[[Students at risk of dropping out]]'' prediction model does not generate an insight if a student is predicted as "not at risk," since the primary interest is which students are at risk of dropping out of courses, not which students are not at risk.

Users can specify how they wish to receive insights notifications, or turn them off, via their User menu > Preferences > Notification preferences.
[[File:insight_notification_settings.png|thumb|left]]
<br clear=all>
To access insights as a teacher, go to an ongoing course and access Course administration > Reports > Insights

<gallery>
File:course_admin_menu_more.png|Course administration menu
File:course_insights_report.png|Reports tab
</gallery>

A user with tool/inspire:listinsights capability in the context of the model will also automatically receive notifications when new predictions are available for them. In this case, Course teachers will receive a notification about their students at risk of dropping out.

<gallery>
File:access_predictions_teacher.png|Insight notifications
File:view_insights.png|View insights
</gallery>

== Prediction details ==
[[File:prediction_details.png|thumb]]
The prediction details show which of the indicator values were used in the prediction, and what the student’s values for those indicators are. Indicator calculated values that are low and are affecting the prediction are highlighted.

Each model can contain different indicators. These are included in the calculations of the model target. For more information, see [[Learning analytics indicators]].

== Actions==

Each insight can have one or more actions defined. Actions provide a way to act on the insight as it is read. These actions may include a way to send a message to another user, a link to a report providing information about the sample the prediction has been generated for (e.g. a report for an existing student), or a way to view the details of the model prediction.

In the ''[[Students at risk of dropping out]]'' prediction model, the teacher can send a message to each student included in the Insights list, view the student’s Outline report for the Course, or view Prediction details.

The teacher can also simply acknowledge the Insight, or can mark the insight as Not useful. Both of these options will remove the Insight from the list of current predictions. This data can be incorporated into the model in the future to help improve model quality.

[[Image:08_insights.png|thumb|right|Insights and Actions]]

Insights can also offer two important general actions that are applicable to all insights. First, the user can acknowledge the insight. This removes that particular prediction from the view of the user, e.g. a notification about a particular student at risk is removed from the display.

The second general action is to mark the insight as "Not useful." This also removes the insight associated with this calculation from the display, but the model is adjusted to make this prediction less likely in the future.

== See also ==

[[Category:Quick guide]]
[[Category:Analytics]]

[[es:Guía rápida de analítica del aprendizaje]]
[[de:Analytics-Kurzanleitung]]

Managing analytics

2019-07-25T08:59:28Z

Ghillenb: /* Monitoring model quality */

{{Learning analytics}}
Once models have been selected, enabled and trained (see [[Using analytics]]), they will start to generate predictions.

== Predictions and Insights ==
Models will start generating predictions at different points in time, depending on the site prediction models and the site courses start and end dates.

Each model defines which predictions will generate [[dev:Analytics API#Insights|insights]] and which predictions will be ignored. For example, the ''[[Students at risk of dropping out]]'' prediction model does not generate an insight if a student is predicted as "not at risk," since the primary interest is which students are at risk of dropping out of courses, not which students are not at risk.

Users can specify how they wish to receive insights notifications, or turn them off, via their User menu > Preferences > Notification preferences.

'''Note''': If all indicator calculations for a sample return a "null" calculation, that sample will not be used for training and no predictions will be generated for it.

== Viewing predictions as a teacher ==
To access predictions as a teacher, go to an ongoing course and access Course administration > Reports > Insights
[[File:access_predictions_teacher.png|thumb]]
A user with tool/inspire:listinsights capability will also automatically receive notifications when new predictions are available for them. In this case, Course teachers will receive a notification about their students at risk of dropping out.

== Viewing predictions as a manager or site administrator ==
To access the report as a manager, view the Analytics Models list, and use the “Insights” menu to select a specific course.
[[File:access_predictions.png|thumb]]

== View predictions ==
[[File:view_insights.png|thumb]]Whether as a manager or as a teacher, the list of insights is the same. The user can send a message to the student, view the student’s Outline report for the Course, or view Prediction details.

The teacher can also simply acknowledge the Insight, or can mark the insight as Not useful. Both of these options will remove the Insight from the list of current predictions. This data can be incorporated into the model in the future to help improve model quality.

== Prediction details ==
[[File:prediction_details.png|thumb]]
The prediction details show which of the indicator values were used in the prediction, and what the student’s values for those indicators are. Indicator calculated values that are low and are affecting the prediction are highlighted.

== Actions==

Each insight can have one or more actions defined. Actions provide a way to act on the insight as it is read. These actions may include a way to send a message to another user, a link to a report providing information about the sample the prediction has been generated for (e.g. a report for an existing student), or a way to view the details of the model prediction.

[[Image:08_insights.png|thumb|right|Insights and Actions]]

Insights can also offer two important general actions that are applicable to all insights. First, the user can acknowledge the insight. This removes that particular prediction from the view of the user, e.g. a notification about a particular student at risk is removed from the display.

The second general action is to mark the insight as "Not useful." This also removes the insight associated with this calculation from the display, but the model is adjusted to make this prediction less likely in the future.

== Monitoring model quality ==
Check the log reports regularly to review the accuracy of your models.

[[es:Gestión de analítica]]
[[de:Analytics verwalten]]

Learning analytics targets

2019-07-25T08:58:03Z

Ghillenb:

{{Learning analytics}}
== About targets ==
[[File:create_model_2.png|thumb]]Targets represent a “known good”-- something about which we have very strong evidence of value. Targets must be designed carefully to align with the curriculum priorities of the institution. Each model has a single target. The “Analyser”[[File:analyser.png|thumb]] (context in which targets will be evaluated) is automatically controlled by the Target selection.

== Targets provided with Moodle core ==
Moodle provides a growing list of targets shipped with Moodle core:

* '''Students at risk of not achieving the competencies assigned to a course''' -- This target provides predictions for students enroled in courses with competencies assigned. To train the model, a history of courses with competencies and records of competencies achieved must be available on the site. Courses in both the training and prediction sets must have start and end dates.
* '''Students at risk of not meeting the course completion conditions''' -- This target provides predictions for students enroled in courses with completion conditions set. To train the model, a history of courses with completion conditions set and calculated must be available on the site. Courses in both the training and prediction sets must have start and end dates.
* '''Students at risk of dropping out''' -- This target uses minimal assumptions to estimate student dropout. If the student participates at all in the last quarter of the course, the student is assumed not to have dropped out. The only requirement is that the courses in both the training and prediction sets must have start and end dates.
* '''Students at risk of not achieving the minimum grade to pass the course''' -- This target provides predictions for students enroled in courses with a minimum passing grade configured. To train the model, a history of courses with passing grades must be available on the site. Courses in both the training and prediction sets must have start and end dates.

Although these targets all apply to student enrolments in courses, this is not a requirement. Targets can be based on any outcome or process in Moodle.

[[es:Metas de analítica del aprendizaje]]
[[de:Analytics-Ziele]]

Learning analytics indicators

2019-07-25T08:44:41Z

Ghillenb:

{{Learning analytics}}
== Overview ==
Models can contain multiple indicators (predictors). Conceptually, indicators collect and aggregate values from a set of data and will combine with targets to make predictions using the selected machine learning algorithms. Indicators can be re-used between models, or can be created specifically for a new model. However, it is best to understand the target you are trying to predict before selecting indicators. [[File:indicators.png|thumb]]

To be used in a model, indicators need to be centered and scaled. In Moodle learning analytics, indicators need to return values converted to a range between -1 and 1. Not all of this range needs to be used-- some indicators will make more sense if scaled from 0 to 1, with 0 indicating a missing value. [[File:centering_scaling_indicators.png|thumb]]

How the data points are processed involves important assumptions that affect the indicators. In particular, indicators can be absolute, meaning that the value of the indicator stays the same no matter what other samples are in the context, or relative, meaning that the indicator compares the sample to others in the context.

Currently, Moodle does not filter the available indicators for a model according to the analyser (controled by the [[Learning analytics targets | target]] of the model). However, not all indicators are designed to work with all targets. For example, an indicator about a user will not perform well in a model about course design. In the future, Moodle may offer more guidance about how to select indicators that match the target.

== General indicators ==
* '''Course accessed after end date''' -- This binary indicator is set to 1 if the user has accessed the course after the end date.
* '''Course accessed before start date''' -- This binary indicator is set to 1 if the user has accessed the course before the start date.
* '''Any write action''' -- This binary indicator is set to 1 if the user has completed a "write" action (saved content) anywhere on the site.
* '''Any write action in the course''' -- This binary indicator is set to 1 if the user has completed a "write" action (saved content) in the enroled course.
* '''Read actions amount''' -- This indicator estimates the amount of content the user has accessed (read) on a scale of -1 to 1.
* '''Activities due''' -- This binary indicator is set to 1 if the user has activities due and not yet submitted.
* '''Completion tracking enabled''' -- This binary indicator is set to 1 if the course has completion tracking enabled.
* '''There are no students''' -- This binary indicator is set to 1 if there are no students enroled in the course.
* '''There are no teachers''' -- This binary indicator is set to 1 if there are no teachers enroled in the course.
* '''User profile is completed''' -- This binary indicator is set to 1 if the user has completed their profile.
* '''User is tracking forums''' -- This binary indicator is set to 1 if the user has forum tracking turned on.

== Community of Inquiry indicators ==
A set of indicators is provided that are based on the [https://en.wikipedia.org/wiki/Community_of_inquiry Community of Inquiry] model of student engagement. These indicators are divided into two types: '''cognitive depth''' and '''social breadth'''. For each activity in Moodle core, one indicator of each type has been implemented. There are also two course-level "potential" indicators that estimate the potential cognitive depth and social breadth of the course as a whole.

Third-party activity plugins require support by their maintainers to add indicators of any type.

=== Potential indicator levels for selected activity modules ===

The potential for engagement via cognitive presence and social presence constitutes '''instructional design''', which is one key element of teaching presence.
This diagram shows the potential cognitive depth and social breadth of all core activities and select non-core activities:

[[File:coi_model_indicators.png|thumb]]

By categorizing each activity by potential cognitive depth and social breadth, we can anticipate what level of engagement is supported (and possibly expected) of the learner, even without a history of many learners’ actions in that activity instance. Note that higher levels along each axis include all lower levels, i.e. an activity that involves a student and all peers (social breadth 3) automatically includes levels 1 (student only) and 2 (student +1). In many cases, the specific level can only be determined by analyzing the parameter settings for the activity.

=== Cognitive depth ===

Cognitive depth is a measure of the construct "cognitive presence" within the Community of Inquiry theoretical framework. Cognitive presence is defined as “The extent to which the participants in any particular configuration of a community of inquiry are able to construct meaning through sustained communication” ([http://www.sciencedirect.com/science/article/pii/S1096751600000166 Garrison, Anderson & Archer, 2000], p 89). Cognitive presence has usually been determined in research by manual content analysis. In these indicators, we define this construct based on the type of activity offered to the student, and the extent to which the student demonstrates cognitive engagement in that activity. The level of depth ranges from 0 to 5, where 0 indicates that the learner has not even viewed the activity. The levels of potential cognitive depth are:

# The learner has viewed the activity details
# The learner has submitted content to the activity
# The learner has viewed feedback from an instructor or peer for the activity (including automated feedback)
# The learner has provided feedback to the instructor or a peer within the activity
# The learner has revised and/or resubmitted content to the activity

This model begins by assigning a maximum potential value of cognitive depth to each activity module. For example, the Assignment module allows ''up to'' cognitive depth of 5.

Once the potential levels are assigned, each student enroled in a course is evaluated based on the proportion of the potential depth reached. For example, if an activity only supports up to level 3 (viewing feedback) and the student has reached level 3, the student is participating at 100 percent of the possible level of cognitive depth and the value of the indicator is 1. If the student does not view the activity, they are at cognitive depth of 0, and the value of the indicator is -1. If the student has viewed the activity and submitted a response, but not viewed feedback, they are at cognitive depth level 2 (out of a potential depth in this activity of 3) so the indicator is calculated at .33.

==== Course level cognitive depth indicators ====

* '''Course potential cognitive depth''' - calculated from all the activities in the course as a measure of potential engagement

==== Course enrolment level cognitive depth indicators ====
The following cognitive depth indicators have 1 level and report 0% (not viewed), or 100% (viewed).
* '''Book cognitive'''
* '''Folder cognitive'''
* '''IMS pkg cognitive'''
* '''Label cognitive''' (considered viewed if that portion of the course is viewed)
* '''Page cognitive'''
* '''File cognitive'''
* '''URL cognitive'''

The following cognitive depth indicators have 2 levels and report 0% (not viewed), 50% (viewed) or 100% (interacted with at least one other participant).
* '''Choice cognitive''' (if results are not viewable)
* '''Database cognitive'''
* '''Feedback cognitive'''
* '''Glossary cognitive'''
* '''Survey cognitive'''
* '''Wiki cognitive'''

The following cognitive depth indicators have 3 levels and report 0% (not viewed), 33% (viewed), 67% (submitted) or 100% (submitted and viewed feedback).
* '''Choice cognitive''' (if results are viewable)
* '''LTI cognitive'''
* '''SCORM cognitive'''

The following cognitive depth indicators have 4 levels and report 0% (not viewed), 25% (viewed), 50% (submitted), 75% (submitted and viewed feedback) or 100% (provided feedback to instructor or peer).
* '''Chat cognitive'''
* '''Forum cognitive'''

The following cognitive depth indicators have 4 levels and report 0% (not viewed), 20% (viewed), 40% (submitted), 60% (submitted and viewed feedback), 80% (provided feedback to instructor or peer), or 100% (revised and resubmitted).
* '''Assignment cognitive'''
* '''Lesson cognitive'''
* '''Quiz cognitive'''
* '''Workshop cognitive'''

=== Social breadth ===

Social breadth is a measure of the construct "social presence" within the Community of Inquiry theoretical framework. It is defined as “The ability of participants to identify with the group or course of study, communicate purposefully in a trusting environment, and develop personal and affective relationships progressively by way of projecting their individual personalities” ([https://www.igi-global.com/chapter/communities-inquiry-online-learning/11779 Garrison, 2009], p 352). In the past, social presence has usually been measured via post-course surveys and manual discourse analysis, though there have been increasing attempts to automate this process. This model implements social presence as "social breadth" by examining the breadth of opportunities the participant has to communicate with others. The level of breadth ranges from 0 to 5, where 0 indicates the learner has not interacted with anyone. The levels of potential social breadth are:

# The learner has not interacted with any other participant in this activity (e.g. they have read a page)
# The learner has interacted with at least one other participant (e.g. they have submitted an assignment or attempted a self-grading quiz providing feedback)
# ''The learner has interacted with multiple participants in this activity, e.g. posting to a discussion forum, wiki, database, etc.*''
# ''The learner has interacted with participants in at least one "volley" of communications back and forth*''
# ''The learner has interacted with people outside the class, e.g. in an authentic community of practice*''
''* Not yet implemented''

This model begins by assigning a maximum potential value of social breadth to each activity module. For example, the Assignment module allows up to social breadth of 2. See below for more details of how these levels are assigned for core activity modules.

Once the potential levels are assigned, each student enroled in a course is evaluated based on the proportion of the potential depth reached. For example, if an activity only supports up to level 3 and the student has reached level 3, the student is participating at 100 percent of the possible level of social breadth.

'''Note''': at present, Moodle only provides indicators up to Social Breadth level 2. All "[[Resources|resources]]" have a maximum social breadth of 1. [[Activities|Activities]] vary in their supported social breadth. This feature is meant to be expanded in future versions of Moodle.

==== Course level social breadth indicators ====
* '''Course potential social breadth''' - calculated from all the activities in the course

==== Enrolment level social breadth indicators====
The following social breadth indicators have only one levels and report either 0% (not viewed) or 100% (viewed).

* '''Book social'''
* '''Database social'''
* '''Folder social'''
* '''Glossary social'''
* '''IMS pkg social'''
* '''Label social'''
* '''Page social'''
* '''File social'''
* '''Survey social'''
* '''URL social'''
* '''Wiki social'''

The following social breadth indicators have two levels and report 0% (not viewed), 50% (viewed) or 100% (interacted with at least one other participant).
* '''Assignment social'''
* '''Chat social'''
* '''Choice social'''
* '''Feedback social'''
* '''Forum social'''
* '''Lesson social'''
* '''LTI social'''
* '''Quiz social'''
* '''SCORM social'''
* '''Workshop social'''

[[es:Indicadores de analítica del aprendizaje]]
[[de:Analytics-Indikatoren]]

Badges settings

2019-07-25T05:48:14Z

Ghillenb: /* Badges capabilities */

{{Badges}}
==Individual user settings==
*A user can [[Managing badges|manage badges]] from ''Navigation>My profile>My badges''.
*A user can view available course badges from ''Navigation>Current course>Badges''.

{|
|[[File:coursebadgenav1.png|thumb|Viewing course badges]]
|}

==Viewing the badges of other users==

A student can view other students' course badges by going to ''Navigation>Participants'' and clicking on the course profile of a chosen user. Badges are visible in the short (course) profile.

==Course administration settings==
*A teacher can add and manage badges in their course if the administrator has enabled course badges in ''Site administration>Badges settings.''
*They will see a link to badges in ''Course administration>Badges.'' where badges may be [[Managing badges| managed]] and added.

==Site administration settings==

* Badges are enabled by default and can be disabled in 'Advanced features' in the Site administration. (Note that disabling the feature once badges have been awarded does not prevent those badges being verified by external backpacks.)
* The site settings for badges are located in 'Badges' in the Site administration.
*From 'Backpack settings' you can select the active external backpack.

===Default badge issuer===
Here you set the name and email address of the issuer. The name will appear where the badges are displayed and might typically be the name of the organization.

===Salt for hashing recipient's email address===
If a hash is used (numbers and letters only) then backpack services can confirm a badge earner without exposing their email address.

===Enable course badges===
Ticking this box will allow teachers to add and manage badges in their courses.

===Backpack settings===

{{New features}}In Moodle 3.7 onwards, ''backpack.openbadges.org'' or ''badgr.io'' can be set as the external backpack for users to connect to.

Note that the Mozilla Open Badges service is due to be transitioned to Badgr in the near future. Open Badges users will then receive notification emails advising them to move their badges from Open Badges to Badgr.

* For new 3.7 sites, it is recommended to set badgr.io as the active external backpack.
* For upgraded 3.7 sites with users who previously connected to the Open Badges backpack, it is recommended to leave the active external backpack as backpack.openbadges.org until users receive notification emails about moving their badges to Badgr.

===Enabling Badgr as the active external backpack===

To enable Badgr as the active external backpack, you first need to create an account on https://badgr.io (let's call it the 'Badgr admin account'). The account email address and password will need to be entered in to your Moodle site.

# Go to Site administration / Badges / Backpack settings and set the site backpack to https://badgr.io.
# Go to Site administration / Badges / Badges settings and set the badge issuer email address to your Badgr admin account email, and save changes.
# Go to Site administration / Badges / Manage backpacks, edit the settings for the badgr.io backpack and enter your Badgr admin account password, and save changes.

Users with an account on https://badgr.io will then be able to connect to their Badgr backpack as follows:

# In the user menu (top right), select Preferences, then 'Backpack settings' under Badges.
# Enter your Badgr user account email and password.
# Look in your mailbox for a verification email and copy and paste the link to verify your connection to the backpack.

==Badges capabilities==
There are a number of capabilities associated with badges:

*[[Capabilities/block/badges:addinstance|Add a new My latest badges block]]
*[[Capabilities/block/badges:myaddinstance|Add a new My latest badges block to the dashboard]]
*[[Capabilities/moodle/badges:awardbadge| Award a badge]]
*[[Capabilities/moodle/badges:configurecriteria|Set up criteria for awarding a badge]]
*[[Capabilities/moodle/badges:configuredetails|Set up and edit badge details]]
*[[Capabilities/moodle/badges:configuremessages|Configure badges messages]]
*[[Capabilities/moodle/badges:createbadge| Create or duplicate badges]]
*[[Capabilities/moodle/badges:deletebadge| Delete badges]]
*[[Capabilities/moodle/badges:earnbadge|Earn badges]]
*[[Capabilities/moodle/badges:manageglobalsettings | Manage badges site administration settings]]
*[[Capabilities/moodle/badges:manageownbadges|View and manage your own earned badges]]
*[[Capabilities/moodle/badges:viewawarded|View users who earned a specific badge without being able to award a badge]]
*[[Capabilities/moodle/badges:viewbadges |View badges without earning them]]
*[[Capabilities/moodle/badges:viewotherbadges|View public badges in other users' profiles]]

[[de:Badges konfigurieren]]
[[es:Configuraciones de insignias]]
[[ja:バッジ設定]]

Using analytics

2019-07-22T08:51:09Z

Ghillenb:

{{Learning analytics}}
== Overview ==
The Moodle Learning Analytics API is an open system that can become the basis for a very wide variety of models. Models can contain indicators (a.k.a. predictors), targets (the outcome we are trying to predict), insights (the predictions themselves), notifications (messages sent as a result of insights), and actions (offered to recipients of messages, which can become indicators in turn).

[[File:learning_analytics_components.png|thumb]]

Most learning analytics models are not enabled by default. Enabling models for use should be done after considering the institutional goals the models are meant to support. When selecting or creating an analytics model, the following steps are important:

* What outcome do we want to predict? Or what process do we want to detect? (Positive or negative)
* How will we detect that outcome/process?
* What clues do we think might help us predict that outcome/process?
* What should we do if the outcome/process is very likely? Very unlikely?
* Who should be notified? What kind of notification should be sent?
* What opportunities for action should be provided on notification?

Moodle can support multiple prediction models at once, even within the same course. This can be used for A/B testing to compare the performance and accuracy of multiple models.

{{New features}}Moodle learning analytics supports two types of models.
* '''Machine-learning''' based models, including predictive models, make use of AI models trained using site history to detect or predict hidden aspects of the learning process.
* "'''Static'''" models use a simpler, rule-based system of detecting circumstances on the Moodle site and notifying selected users.

Moodle core ships with three models, ''[[Students at risk of dropping out]]'' and the static models ''Upcoming activities due'' and ''No teaching.'' Additional prediction models can be created by using the [[dev:Analytics API| Analytics API]] or by using the new web UI. Each model is based on the prediction of a single, specific "target," or outcome (whether desirable or undesirable), based on a number of selected indicators.

You can view and manage your system models from ''Site Administration > Analytics > Analytics models''.

[[File:manage_models.png|thumb]]

== Existing models ==
Moodle core ships with three models, [[Students at risk of dropping out]] and the static models Upcoming activities due and No teaching. Other models can be added to your system by installing plugins or by using the web UI (see below). Existing models can be examined and altered from the "Analytics models" page in Site administration:
[[File:analytics_models.png|thumb]]

These are some of the actions you can perform on an existing model:

* '''Get predictions''' Train machine learning algorithms with the new data available on the system and get predictions for ongoing courses. ''Predictions are not limited to ongoing courses-- this depends on the model.''

* '''View Insights''' Once you have trained a machine learning algorithm with the data available on the system, you will see insights (predictions) here for each "analysable." In the included model "[[Students at risk of dropping out]], insights may be selected per course. ''Predictions are not limited to ongoing courses-- this depends on the model.''

* '''Evaluate''' This is normally done in the background as a series of scheduled tasks, but you can trigger the start of the process with this menu. Evaluate the prediction model by getting all the training data available on the site, calculating all the indicators and the target and passing the resulting dataset to machine learning backends. This process will split the dataset into training data and testing data and calculate its accuracy. Note that the evaluation process uses all information available on the site, even if it is very old. Because of this, the accuracy returned by the evaluation process may be lower than the real model accuracy as indicators are more reliably calculated immediately after training data is available because the site state changes over time. The metric used to describe accuracy is the ''[https://en.wikipedia.org/wiki/Matthews_correlation_coefficient Matthews correlation coefficient]'' (a metric used in machine learning for evaluating binary classifications)

You can also force the model evaluation process to run from the command line:

$ admin/tool/analytics/cli/evaluate_model.php

[[File:model-evaluation.jpeg|thumb]]

* '''Log''' View previous evaluation logs, including the model accuracy as well as other technical information generated by the machine learning backends like ROC curves, learning curve graphs, the tensorboard log dir or the model's Matthews correlation coefficient. The information available will depend on the machine learning backend in use. [[File:log_info.png|thumb]]

* '''Edit''' You can edit the models by modifying the list of indicators or the time-splitting method. All previous predictions will be deleted when a model is modified. Models based on assumptions (static models) can not be edited.

* '''Enable / Disable''' The scheduled task that trains machine learning algorithms with the new data available on the system and gets predictions for ongoing courses skips disabled models. Previous predictions generated by disabled models are not available until the model is enabled again.

{{New features}}
* '''Export''' Export your site training data to share it with your partner institutions or to use it on a new site. The Export action for models allows you to generate a csv file containing model data about indicators and weights, without exposing any of your site-specific data. We will be asking for submissions of these model files to help evaluate the value of models on different kinds of sites. Please see the [https://moodle.org/project_inspire Learning Analytics community] for more information.

* '''Invalid site elements''' Reports on what elements in your site can not be analysed by this model

* '''Clear predictions''' Clears all the model predictions and training data

=== Core models ===

==== Students at risk of dropping out ====

[[Students at risk of dropping out|This model]] predicts students who are at risk of non-completion (dropping out) of a Moodle course, based on low student engagement. In this model, the definition of "dropping out" is "no student activity in the final quarter of the course." The prediction model uses the [https://en.wikipedia.org/wiki/Community_of_inquiry Community of Inquiry] model of student engagement, consisting of three parts:

* [[Students at risk of dropping out#Cognitive depth|Cognitive presence]]
* [[Students at risk of dropping out#Social Breadth|Social presence]]
* [[Students at risk of dropping out#Potential indicator levels for selected activity modules|Teacher presence]]

This prediction model is able to analyse and draw conclusions from a wide variety of courses, and apply those conclusions to make predictions about new courses. The model is not limited to making predictions about student success in exact duplicates of courses offered in the past. However, there are some limitations:

# This model requires a certain amount of in-Moodle data with which to make predictions. At the present time, only core Moodle activities are included in the [[Students at risk of dropping out#Indicators|indicator]] set (see below). Courses which do not include several core Moodle activities per “time slice” (depending on the time splitting method) will have poor predictive support in this model. This prediction model will be most effective with fully online or “hybrid” or “blended” courses with substantial online components.
# This prediction model assumes that courses have fixed start and end dates, and is not designed to be used with rolling enrollment courses. Models that support a wider range of course types will be included in future versions of Moodle. Because of this model design assumption, it is very important to properly set course start and end dates for each course to use this model. If both past courses and ongoing courses start and end dates are not properly set predictions cannot be accurate. Because the course end date field was only introduced in Moodle 3.2 and some courses may not have set a course start date in the past, we include a command line interface script:

$ admin/tool/analytics/cli/guess_course_start_and_end.php

This script attempts to estimate past course start and end dates by looking at the student enrolments and students' activity logs. After running this script, please check that the estimated start and end dates script results are reasonably correct.

==== Upcoming activities due ====
{{New features}}
The static “upcoming activities due” model checks for activities with upcoming due dates and outputs to the user’s calendar page.

==== No teaching ====
This model's insights will inform site managers of which courses with an upcoming start date will not have teaching activity. This is a simple "static" model and it does not use machine learning backend to return predictions. It bases the predictions on assumptions, e.g. there is no teaching if there are no students.

== Creating and editing models ==
{{New features}}
New machine learning models can be created by using the Analytics API, by importing an exported model from another site, or by using the new web UI in 3.7. [[File:new_model.png|thumb]] If you delete a "default" model (shipped with Moodle core) you can restore it from the Create menu. (Note: "static" models cannot be created using the web UI at this time.)

There are four components of a model that can be defined through the web UI:

=== Target ===
[[File:create_model_2.png|thumb]]Targets represent a “known good”-- something about which we have very strong evidence of value. Targets must be designed carefully to align with the [[Curriculum theory|curriculum priorities]] of the institution. Each model has a single target. The “Analyser” (context in which targets will be evaluated) is automatically controlled by the Target selection. See [[Learning analytics targets]] for more information.

=== Indicators ===
Indicators are data points that may help to predict targets. We are free to add many indicators to a model to find out if they predict a target-- the only limit is that the data must be available within Moodle and must have a connection to the context of the model (e.g. the user, the course, etc.). The machine learning “training” process will determine how much weight to give to each indicator in the model.

We do want to make sure any indicators we include in a production model have a clear purpose and can be interpreted by participants, especially if they are used to make prescriptive or diagnostic decisions.

Indicators are constructed from data, but the data points need to be processed to make consistent, reusable indicators. In many cases, events are counted or combined in some way, though other ways of defining indicators are possible and will be discussed later. How the data points are processed involves important assumptions that affect the indicators. In particular, indicators can be absolute, meaning that the value of the indicator stays the same no matter what other samples are in the context, or relative, meaning that the indicator compares the sample to others in the context.

See [[Learning analytics indicators]] for more information.

[[File:indicators.png|thumb]]

=== Analysis intervals ===
[[File:analysis_intervals.png|thumb]]Analysis intervals control how often the model will run to generate insights, and how much information will be included in each generation cycle. The two analysis intervals enabled by default for selection are “Quarters” and “Quarters accumulative.” Both options will cause models to execute four times-- after the first, second, third and fourth quarters of the course (the final execution is used to evaluate the accuracy of the predictions against the actual outcome). The difference lies in how much information will be included. “Quarters” will only include information from the most recent quarter of the course in its predictions. “Quarters accumulative” will include the most recent quarter and all previous quarters, and tends to generate more accurate predictions (though it can take more time and memory to execute). Moodle Learning Analytics also includes “Tenths” and “Tenths accumulative” options in Core, if you choose to enable them from the Analytics Settings panel. These generate predictions more frequently.

* '''Single range''' indicates that predictions will be made once, but will take into account a range of time, e.g. one prediction at the end of a course. The prediction is made at the end of the range.

* '''Upcoming...''' indicates that the model generates an insight based on a snapshot of data at a given moment, e.g. the "no teaching" model looks to see if there are currently any teachers or students assigned to a course one week before the start of the term, and issues one insight warning the site administrator that no teaching is likely to occur in that empty course.

* '''All previous...''' (formerly "accumulative") and '''Last...''' methods differ in how much data is included in the prediction. Both "All previous quarters" and "Last quarter" predictions are made at the end of each quarter of a time span (e.g. a course), but in "Last quarter," only the information from the most recent quarter is included in the prediction, whereas in "All previous quarters" all information up to the present is included in the prediction.

'''Single range''' and '''No time splitting''' methods do not have time constraints. They run during the next scheduled task execution, although models apply different restrictions (e.g. require that a course is finished to use it for training or some data in the course and students to use it to get predictions...). 'Single range' and 'No splitting' are not appropriate for students at risk of dropping out of courses. They are intended to be used in models like 'No teaching' or 'Spammer user' that are designed to make only one prediction per eligible sample. To explain this with an example: 'No teaching' model uses 'Single range' analysis interval; the target class (the main PHP class of a model) only accepts courses that will start during the next week. Once we provide a 'No teaching' insight for a course we won't provide any further 'No teaching' insights for that course.

The difference between 'Single range' and 'No splitting' is that models analysed using 'Single range' will be limited to the analysable elements (the course in students at risk model) start and end dates, while 'No splitting' do not have any time contraints and all data available in the system is used to calculate the indicators.

'''Note''': Although the examples above refer to courses, analysis intervals can be used on any analysable element. For example, enrolments can have start and end dates, so an analysis interval could be applied to generate predictions about aspects of an enrollment. For analysable elements with no start and end dates, different analysis intervals would be needed. For example, a "weekly" analysis interval could be applied to a model intended to predict whether a user is likely to log in to the system in the future, on the basis of activity in the previous week.

=== Predictions processor ===
This setting controls which machine learning backend and algorithm will be used to estimate the model. Moodle currently supports two predictions processors:

* PHP machine learning backend - implements logistic regression using php-ml (contributed by Moodle)
* Python machine learning backend - implements single hidden layer feed-forward neural network using TensorFlow.

You can only choose from the predictions processors enabled on your site.

[[File:regression.png|thumb]]
[[File:ffnn.png|thumb]]

Each prediction processor may support multiple algorithms in the future.

=== Changing the model name ===
The model name is used to identify insights generated by the model, and by default, is the same as the Target name. You can edit this by clicking the "pencil" icon next to the model name in the list of models:

[[File:edit_model_name.png|thumb]]

== Training models ==
Machine-learning based models require a training process using previous data from the site. "Static" models make use of sets of pre-defined rules, and do not need to be trained.

There are two main categories of machine-learning based analytics models: '''supervised''' and '''unsupervised'''.

* Supervised models must be trained by using a data set with the target values already identified. For example, if the model will predict course completion, the model must be trained on a set of courses and enrollments with known completion status.
* Unsupervised models look for patterns in existing data, e.g. grouping students based on similarities in their behavior in courses.

At the present time, Moodle Learning Analytics only supports supervised models.

While we hope to include pre-trained models with the Moodle core installation in the future, at the current time we do not have large enough data sets to train a model for external use. (If you would like to help contribute data for this effort, please see the [https://moodle.org/course/view.php?id=17233&section=6 Moodle Learning Analytics Working Group].)

=== Training data ===
The model code includes criteria for "training" and "prediction" data sets. For example, only courses with enrolled students and an end date in the past can be used to train the [[Students at risk of dropping out]] model, because it is impossible to determine whether a student dropped out until a course has ended. On the other hand, for this model to make predictions, there must be a course with students enrolled that has started, but not yet ended.

The training set is defined in the php code for the Target. Models can only be trained if a site contains enough data matching the training criteria. Most models will require Moodle log data for the time period covering the events being analysed. For example, the [[Students at risk of dropping out]] model can only be trained if there is log data covering student activity in the courses that meet the training criteria. It is possible to train a model on an "archive" system and then use the model on a production system.

=== Triggering model evaluation ===

[[File:model_menu_evaluate.png|thumb]]This is normally done in the background as a series of scheduled tasks, but you can trigger the start of the process from the model menu. This causes Moodle to assemble the training data available on the site, calculate all the indicators and the target and pass the resulting dataset to machine learning backends. This process will split the dataset into training data and testing data and calculate its accuracy. Note that the evaluation process uses all information available on the site, even if it is very old. Because of this, the accuracy returned by the evaluation process may be lower than the real model accuracy as indicators are more reliably calculated immediately after training data is available because the site state changes over time. The metric used to describe accuracy is the ''[https://en.wikipedia.org/wiki/Matthews_correlation_coefficient Matthews correlation coefficient]'' (a metric used in machine learning for evaluating binary classifications)

You can also force the model evaluation process to run from the command line:

$ admin/tool/analytics/cli/evaluate_model.php

=== Review evaluation results ===
[[File:model_menu_log.png|thumb]]

You can review the results of the model training process by accessing the evaluation log.[[File:model_log.png|thumb]]
[[File:log_info.png|thumb]]
Check for warnings about evaluation completion, model accuracy, and model variability.

[[File:invalid_site_elements.png|thumb]]
You can also check the ''invalid site elements'' list to verify which site elements were included or excluded in the analysis. If you see a large number of unexpected elements in this report, it may mean that you need to check your data. For example, if courses don't have appropriate start and end dates set, or enrolment data has been purged, the system may not be able to include data from those courses in the model training process.

== Exporting and Importing models ==
Models can also be exported from one site and imported to another. [[File:export_menu.png|thumb]]
=== Exporting models ===
You can export the data used to train the model, or the model configuration and the weights of the trained model. [[File:export_dialogue.png|thumb]]

'''Note''': the model weights are completely anonymous, containing no personally identifiable data! This means it is safe to share them with researchers without worrying about privacy regulations.

=== Importing models ===
When a model is imported with weights, the site administrator has the option to evaluate the trained model using site data, or to evaluate the model configuration by re-training it using the current site data. [[File:import_model.png|thumb]][[File:evaluate_model.png|thumb]]

[[Category:Analytics]]

[[es:Uso de analítica]]
[[de:Analytics nutzen]]

Moodle Learning Analytics FAQ

2019-07-22T08:47:19Z

Ghillenb: /* See also */

{{Learning analytics}}

Here are some common questions about Moodle Learning Analytics. You may also find it helpful to visit the [https://moodle.org/analytics Moodle Learning Analytics Working Group] site.

==Will I start getting predictions as soon as I enable the model?==

'''Static''' models do not require training, and will begin to deliver insights as soon as they are enabled (and the circumstances that trigger the model occur). '''Machine-learning based''' learning analytics models, such as [[Students at risk of dropping out]], must be trained on your site data before they can generate predictions. The Moodle Learning Analytics machine-learning engine needs historical data (previous courses or other activity, depending on the model), so it will need to be enabled on a production site or a copy of your production site. The model training process happens in the background once the model is enabled on your Moodle site. Once the model has been trained, you will start to receive predictions about current courses or other components. See [[Managing analytics]] for more information on how to manage notifications.

==Is there a way to export and import model data between sites?==

Model '''training data''' can be [[Using analytics#Exporting_and_Importing_models | exported]] from one site and placed in the [[Analytics settings#Models_output_directory | model data directory]] of a new site. This consists of a file of calculated target and indicator values for each sample examined by the model, along with some header information. No personally identifying information is included, but one row per sample (e.g. per course enrolment and analysis interval) is included. We are working to collect model data from many sites to construct a training set we can provide with Moodle installations. Please see [https://moodle.org/course/view.php?id=17233#| How to Participate in Learning Analytics Data Collection] for more details.

==Is there a way to export and import the settings of a model between sites?==

{{New features}}Yes. Models can be created and tested on one site, and can be [[Using analytics#Exporting_and_Importing_models | exported]] with weights and imported to a new site. This data does not reference individual users or courses in any way, and can be safely shared with researchers or other sites. On the new site, a model can be re-trained after import, or the imported model weights can be tested on historical site data to evaluate the accuracy of the model on the new site. We are working to collect model configuration and weighting data from many sites to construct a pre-trained model we can provide with Moodle installations. Please see [https://moodle.org/course/view.php?id=17233#| How to Participate in Learning Analytics Data Collection] for more details.

==How can I disable Moodle Learning Analytics notifications, or restrict them to certain users, while still enabling models for testing purposes?==

Notifications go to users with the [[Capabilities/moodle/analytics:listinsights|"analytics:listinsights" capability]] in the context of the prediction-- what this means for the [[Students at risk of dropping out]] model is that notifications go to teachers in each course. What you can do is modify the "Teacher" role (editingteacher) to remove that capability. Currently that capability is also turned on for Managers by default. If you want to restrict the notifications to a few individuals, make a new role with just this capability, and assign that role to the individuals you wish to grant permission to in each context.

==How accurate are the model predictions?==

This varies depending on the quality and quantity of site data (including how many activities are in each course and what percentage of the course is conducted online in Moodle). See [[Using analytics#Review_evaluation_results| Using analytics: Review evaluation results]] for more details on how to review model accuracy.

==How can I create my own Learning Analytics models?==

New machine learning models can be created by using the [[dev:Analytics_API|Analytics API]], by importing an exported model from another site, or by using the {{New features}}new web UI in 3.7. For more information, see [[Using analytics#Creating_and_editing_models| Using analytics: Creating and editing models]]. (Note: "static" models cannot be created using the web UI at this time.)

==See also==

* [[Analytics]]
* [https://moodle.org/analytics Moodle Learning Analytics Working Group]
* [https://docs.moodle.org/dev/Analytics_API Moodle Learning Analytics API]

[[Category:FAQ]]
[[Category:Analytics]]

[[es:Analítica del aprendizaje en Moodle FAQ]]
[[de:Analytics FAQ]]

Analytics settings

2019-07-17T12:51:03Z

Ghillenb:

{{Learning analytics}}
The Moodle learning analytics system requires some initial configuration before it can be used. You can access ''Analytics settings'' from ''Site administration > Analytics > Analytics settings''.

== Site information ==
{{New features}}
Site information will be used to help learning analytics models take characteristics of the institution into account. This information is also reported as part of site data collection when you register your site. This will allow HQ to understand which areas in learning analytics are seeing the most use and prioritize development resources appropriately.

== Configure learning analytics settings ==
[[File:configure_settings.png|thumb]] The settings for the Moodle Learning Analytics system are set to reasonable defaults, but let’s review them. To configure and enable Moodle Learning Analytics settings, access the Analytics settings panel under Site Administration/Analytics.

=== Predictions processor ===

[[Image:analytics01_predictions_processor34.png|frame|center|Predictions processor selection]]

Prediction processors are the machine learning backends that process the datasets generated from the calculated indicators and targets and return predictions. Moodle core includes 2 prediction processors:

* The PHP processor is the default. There are no other system requirements to use this processor.
* The Python processor is more powerful and it generates [https://www.tensorflow.org/get_started/summaries_and_tensorboard graphs that explain the model performance]. It requires setting up extra tools: Python itself (https://wiki.python.org/moin/BeginnersGuide/Download) and the moodlemlbackend python package. The latest version of the package for Moodle 3.7 is compatible with python 2.7 and python 3.4.

pip install "moodlemlbackend>=1.0.0,<2.0.0"

=== Log store ===
From Moodle version 2.7 and up, the “Standard logstore” is the default. If for some reason you also have data in the older “legacy logs,” you can enable the Moodle Learning Analytics system to access them instead.

=== Analysis intervals ===

[[dev:Analytics API#Time splitting methods|Analysis intervals]] determine how often insights will be generated, and how much information to use for each calculation. Using proportional analysis intervals allows courses of different lengths to be used to train a single model.

[[Image:06_timesplitting.png|frame|center|Analysis intervals]]

Each analysis interval divides the course duration into segments. At the end of each defined segment, the predictions engine will run and generate insights. It is recommended that you only enable the analysis intervals you are interested in using; the evaluation process will iterate through all enabled analysis intervals, so the more analysis intervals enabled, the slower the evaluation process will be.

=== Models output directory ===

[[Image:03_models_output_directory.png|frame|center|Models output directory]]

This setting allows you to define a directory where machine learning backends data is stored. Be sure this directory exists and is writable by the web server. This setting can be used by Moodle sites with multiple frontend nodes (a cluster) to specify a shared directory across nodes. This directory can be used by machine learning backends to store trained algorithms (its internal variables weights and stuff like that) to use them later to get predictions. Moodle cron lock will prevent multiple executions of the analytics tasks that train machine learning algorithms and get predictions from them.

== Scheduled tasks ==

Most analytics API processes are executed through [[Scheduled_tasks|scheduled tasks]]. These processes usually read the activity log table and can require some time to finish. You can find ''Train models'' and ''Predict models'' scheduled tasks listed in ''Administration > Site administration > Server > Scheduled tasks.'' It is recommended to edit the tasks schedule so they run nightly.

== Defining roles ==

Moodle learning analytics makes use of a number of capabilities. These can be added or removed from roles at the site level or within certain contexts to customise who can view insights.

To receive notifications and view insights, a user must have the [[Capabilities/moodle/analytics:listinsights|analytics:listinsights]] capability within the context used as the "Analysable" for the model. For example, the [[Students at risk of dropping out]] model operates within the context of a course. Insights will be generated for each enrolment within any course matching the criteria of the model (courses with a start date in the past and an end date in the future, with at least one teacher and student), and these insights will be sent to anyone with the listinsights capability in that course. By default, the roles of [[Teacher role|Teacher]], [[Non-editing teacher role|Non-editing teacher]], and [[Manager role|Manager]] have this capability.

Some models (e.g. the ''No teaching'' model) generate insights at the Site level. To receive insights from these models, the user must have a role assignment at the System level which includes the listinsights capability. By default, this is included in the [[Manager role]] if assigned at the site level.

'''Note''': Site administrators do '''not''' automatically receive insight notifications, though they can choose to view details of any insight notifications on the system. To enable site administrators to receive notifications of insights, assign an additional role that includes the listinsights capability to the site administrator at the system level (e.g. the [[Manager role]]).

[[Category:Analytics]]

[[es:Configuraciones de analítica]]
[[de:Analytics-Einstellungen]]

Moodle app guide for admins

2019-07-12T12:12:09Z

Ghillenb: /* See also */

{{Mobile}}
==Enable mobile services on your site==
Your site needs to have mobile access enabled so users can use the mobile app.

For sites using https, mobile access is enabled by default in new installations of Moodle 3.0 onwards.

For http sites, mobile access can be enabled by an administrator as follows:

# In ''Site administration > Mobile app > Mobile settings'' tick the 'Enable web services for mobile devices' checkbox
# Click the button to save changes.

If your site uses a [https://en.wikipedia.org/wiki/Transport_Layer_Security SSL certificate], it must be a trusted certificate. For security reasons the app doesn't work with self-signed certificates.

Please, verify that your certificate is valid via: https://www.geocerts.com/ssl_checker (you shouldn't see any warning).

If your site has the /login directory protected (frequently done when using the Shibboleth authentication method), you must enable access to the login/token.php script.

===Frame embedding===
If your sites uses [https://en.wikipedia.org/wiki/ReCAPTCHA reCaptcha], Vimeo videos or custom menu items (as described bellow) you must enable the admin setting "Allow frame embedding" (allowframembedding).

==Mobile authentication==

If your site uses a SSO authentication method (CAS, Shibboleth, LDAP SSO, OAuth...), then select via a browser window or via an embedded browser for 'Type of login' (typeoflogin) in 'Mobile authentication' in the Site administration. (This setting is provided for older pre-Moodle 3.2 sites via the [[Moodle Mobile additional features]] plugin.)

The options 'browser window' and 'embedded browser' are very similar; the only difference is when redirecting the user to enter their credentials in the site, the site will be opened in the device's default browser (for browser window) or the site will be opened "embedded" in the mobile app (for embedded browser). The user experience is better in embedded browser, but not all the authentication plugins will work in embedded browser (for example, if JavaScript popups are required they must use the 'browser window'). The admin should check whether both options work, and if so, choose 'embedded browser'.

If you are using Google OAuth you will have to use the 'browser window' method because Google recently blocked authentication via 'embedded browsers'.

If your organisation uses a custom branded app and 'Type of login' is set to 'Via a browser window' or 'Via embedded browser', then a URL scheme (forcedurlscheme) may be set. This will result in only the custom branded app working for the site: the official Moodle Mobile app will not work.

== Customise your app theme ==

The app can also retrieve your custom styles from your Moodle site. Since the app is a HTML5 app, you can safely apply any CSS, CSS2 and CSS3 style.

Go to ''Administration > Site administration > Mobile app > Mobile appearance'' and enter in the mobilecssurl field a valid URL pointing to a CSS file containing your custom styles.

The CSS should be placed inside your Moodle installation (in your custom theme or inside a local plugin).

'''For example:''' ''https://mymoodlesite.com/theme/mytheme/style/mymobileapp.css''

Once the user is logged in the app, remote CSS files for applying your custom styles are regularly retrieved.

Notice that on the first time a user opens the app, he will see the default "orange" style. Your custom styles will be applied once the user has added a site in the app.

For further information, see the dev docs [[:dev:Moodle Mobile Themes|Moodle Mobile Themes]].

If you want your own custom branding for your organization, Moodle offers the The Branded Moodle Mobile app service, please visit https://moodle.com/mobileapp/ for more information.

== Moodle Mobile additional features plugin for old Moodle sites ==

For old Moodle sites it is recommended to install the [[Moodle Mobile additional features]] plugin.

== Notifications ==

You might find them annoying but push notifications keeps you and your users informed and updated on everything about the app. Moodle only send useful and important notifications such as new features or service disruptions.

Enabling push notifications is easy! An administrator can enable it by connecting their Moodle site/s to our free Notifications server available (only) for registered Moodle sites.

An access key can be obtained via ''Site administration > Plugins > Message outputs > Manage message outputs''. Then by clicking the link to the Mobile settings, on the next page select ''Request access key''.

The full guide on enabling push notifications can be found here: [[Mobile app notifications]]

== App banners ==
[[File:app banner.png|thumb|Moodle Mobile app banner]]
App banners let your users know that there is a mobile app available for the site. App banners are only displayed when accessing the site using a mobile browser.

In Moodle 3.3 onwards, app banners for Android are supported as well as for iOS.

App banners are disabled by default. They can be enabled in 'Mobile appearance' in the Site administration.

If you are using a custom mobile app, you need to provide the unique identifier for the iOS and Android app; if you are using the Moodle Mobile app, the settings may be left as default.

Please, notice the following:
* App banners for iOS devices (iPhone, iPad or iPod) are only shown when accessing the site using the Safari browser
* App banners for Android devices are only shown in very recent Chrome browser versions and when the app is not installed. Note also that Chrome uses an engagement heuristic that will display the banner only on certain conditions, like interactions with the site, the last time you interacted with it, etc. You can remove the engagement restriction check by disabling this special chrome flag: chrome://flags/#bypass-app-banner-engagement-checks

=='Get the mobile app' link==

In Moodle 3.4 onwards, the link 'Get the mobile app' in the footer of each page on the site encourages users to make use of the mobile app.

By default, the link is https://download.moodle.org/mobile however the setting 'App download page' can be changed e.g. for sites using a branded mobile app.

If mobile services are not enabled for the site, then the 'Get the mobile app' link is not displayed.

To prevent the 'Get the mobile app' link being displayed, simply remove the URL from the 'App download page' setting and save changes.

== Configuring the app from your site ==

In Moodle 3.3 onwards, or with the [[Moodle Mobile additional features]] plugin, settings in the Site administration enable admins to configure the app.

* In Moodle 3.3 onwards go to ''Site administration > Mobile features''
* In sites with the Moodle Mobile additional features plugin installed, go to ''Site administration > Plugins > Local plugins > Mobile additional features''

===Force log out===

Replace the Change site option to "Log out" so that users must enter their credentials on their next access. This is useful for custom mobile apps, as there is no reason for users wanting to switch to a different site.

===Disabled features===

The mobile app may be simplified by removing unwanted features. Some items may already be not available in the app because they are not enabled on your site.

Options to remove include:

* Offline use
* Blocks
* Comments
* Ratings
* Tags
* Create new account
* Responsive menu items (new in 3.7)
* Main menu
** Site home
** My courses
** Dashboard
** Calendar
** Notifications
** Messages
** Grades
** My learning plans
** Blog
** Files
** Web page
** Help
* Course
** Blocks
** Blog
** Search
** Competencies
** Participants
** Grades
** Course completion
** Notes
** Download course (new in 3.5)
** Download courses (new in 3.5)
* User
** Blog
** Badges
** Competencies
** Course completion
** Grades
** Send message
** Add contact
** Block contact
** Add a new note
** User picture
* Files
** Private files
** Ste files
** Upload
* Modules (Each module can be disabled separately)
* Blocks (Each block available in the app can be disabled separately)

===Custom menu items===

Additional items can be added to the app main menu (the side menu), such as a link to a different grade book.

Each custom menu item should have format: item text, link URL, link-opening method and language code (optional, for displaying the item to users of the specified language only), separated by pipe characters.

Possible link-opening methods are:

* app - for linking to an activity supported by the app i.e. almost all activity types, as listed in [[Moodle Mobile features]].
* inappbrowser - for linking to external URLs or site functionalities not supported by the app. The link will open in a browser inside the app overlaying the complete screen.
* browser - as for inappbrowser except that the link will instead open in the device default browser outside the app.
* embedded - as for inappbrowser except that the link will instead open in an iframe in a new page in the app. (For this option you may need to enable the admin setting "Allow frame embedding" (allowframembedding)

Tip: If you add a custom menu item and save changes, then it doesn't appear in the app main menu, double check that the item is correctly formatted.

Please, note that if the app is using a language not indicated in the previous list, the first language in the list will be used.

If you want options tied to a language, you can append _only to the language code, for example:
en_only
es_only

Will display the custom menu item only when the app language is English or Spanish.

===Responsive menu items===

From 3.7 onwards menu items on bottom tabs are moved to the side of the screen on big screens. Also the number of items displayed on the menu may vary:

* On small screens (usually phones) from 2 to 5 items will be displayed depending on the size of the screen.
* On big screens (usually tablets an desktop version) more than 2 items will be displayed without limit.

If '''Responsive menu items''' is selected in Disabled features items will be displayed in side of bottom anyway but 5 items will be displayed in all cases without depending on the size of the screen.

===Custom language strings ===

Words and phrases displayed in the app can be customised via the "Custom language strings" (customlangstrings) setting.

Enter each custom language string on a new line with format: string identifier, custom language string and language code, separated by pipe characters. For example:

mm.user.student|Learner|en
mm.user.student|Aprendiz|es

The complete list of string identifiers is listed in https://raw.githubusercontent.com/moodlehq/moodlemobile-phonegapbuild/master/assets/lang/en.json. The string identifier is before the colon.

For example:

[[File:Mobile string identifiers list examples.png|300px]]

means that the string "Student" has string identifier "mm.user.student".

==Web services token duration==

In Moodle 3.4 onwards, an admin can set how long a web services token created by a user (for example via the mobile app) is valid. (In previous versions of Moodle a token was valid for 3 months.)

==App's cache==

The app caches WebService requests to decrease data usage and increase the app's speed. When the app needs to get some data from Moodle, it will use a cached request as long as it isn't expired.

This cache was improved in Moodle App 3.7.0, now there are several cache times depending on the WS being called. This means that some requests will expire more often than others. Also, if the user isn't using a WiFi connection, the expiration time will also be longer to decrease the data usage. These cache times cannot be configured using a Moodle setting.

==See also==

* [[Moodle Mobile FAQ]] for other administration-related mobile app questions.
* [[:dev:Moodle Mobile debugging WS requests]] - a guide to helping you find and report problems with the Moodle Mobile app on your site
* [[:dev: Moodle Mobile Roadmap]]
* [[:dev:Moodle Mobile release notes]]
* [[:dev:Moodle Mobile|Moodle Mobile developer docs]]
* [[Moodle Mobile availability plugin]]
* [[Mobile web services]]

[[fr: Guide mobile pour administrateurs]]
[[es:Moodle app guía para administradores]]
[[de:Moodle App - Anleitung für Administrator/innen]]

Moodle app synchronization

2019-07-10T09:26:40Z

Ghillenb:

{{Mobile}}
There are two ways of synchronizing data: automatic and manual.

== Automatic synchronization ==

When an activity that can generate offline data is opened in the app, that activity will always be synchronized if the device is connected. For example, when opening a wiki while online, any offline data will be synchronized.

Furthermore, each activity type has an automatic synchronization process that runs regularly, usually every 10 minutes. Let's use wiki as an example. When the wiki synchronization process runs, it synchronizes all wikis that have offline data and haven't been synchronized in the last 5 minutes. This is to decrease the data usage of the app since the server might be down. This means that an activity could take up to 15 minutes to be synchronized in the worst case scenario. An example of the worst case scenario:

# Time = 0. The wiki automatic sync process runs. Nothing to sync.
# Time = 5 minutes and 1 second. The user opens a wiki with no offline data, so the synchronization is successful.
# Time = 5 minutes and a few seconds. The user generates some offline data for that wiki.
# Time = 10 minutes. The wiki automatic sync process runs again. The wiki has offline data, but it has been synchronized in less than 5 minutes (step 2), so it isn't synchronized again.
# Time = 20 minutes. The wiki automatic sync process runs again. Now the wiki is synchronized.

If an automatic synchronization runs when the device is offline, it will stop running until the device is online again. When the device is next online, all the automatic sync processes that were stopped will be run immediately, synchronizing the activities with offline data that weren't synchronized in the last 5 minutes. For example:

# Forum sync process runs. Device is online, so it is executed.
# Device goes offline.
# Wiki sync process runs. Device is offline, so it stops being executed.
# Device goes online.
# Wiki sync process is executed since it was stopped. Forum isn't executed yet because it wasn't stopped, it will be executed after 10 minutes from step 1.

Finally, in ''App Settings > Synchronization'' there is a setting "''Allow sync only when on Wi-Fi''". If this is enabled and the device is using a 3G/4G connection, the automatic sync processes won't be run; their execution will be delayed for 10 minutes until the device uses a Wi-Fi connection.

Note that the automatic sync processes will only run if the app is alive; if the app is closed, the data won't be synchronized until it is started again. Also, in iOS the app needs to be in the foreground (active) in order to execute the sync processes; if it is put in background (minimized) the processes won't be executed until the app is in the foreground again.

== Manual synchronization ==

When a user generates data offline, the app will display a message inside the activity informing the user that there is data to be synchronized. Performing a Pull To Refresh in that view will synchronize the data for that activity only (not for other activities). The activity can also be synchronized by opening the context menu in the top right and clicking "''Synchronize''". So if a user performs a Pull To Refresh in a certain wiki, only that wiki will be synchronized. Performing a Pull To Refresh outside of the activity (e.g. in the section) will do nothing.

In ''App Settings > Synchronization'' the app will display a list of the sites stored in the app. Clicking the refresh button next to a site results in all automatic sync processes being executed immediately, so all activities with offline data that haven't been synchronized in the last 5 minutes will be synchronized.

[[de:Moodle App - Synchronisierung]]

Unexpected installation halts

2019-06-07T12:21:22Z

Ghillenb: /* See also */

{{Installing Moodle}}
Sometimes the installation will hang when setting up tables, where only half the page displayed in the browser and/or other outputs are removed. Examples and causes are:

==Truncated MySQL statements==

(mysql): SET NAMES 'utf8'
--------------------------------------------------------------------------------
(mysql): SHOW LOCAL VARIABLES LIKE 'character_set_database'
...
...
(no more statements are displayed)

==Missing Continue button==
The “Scroll to continue” link is displayed but no “Continue” button is there.

:'''Note''': There is an exception to this when upgrading an existing database and the installation may appear to hang at the roles generation phase. This process can take a very long time - so please be patient.

Below are some solutions you can try to overcome this problem:

*'''Check for MySQL limits'''. This is often a MySQL error and not a php error. Check that there is no limit placed on your mysql database, e.g. a "questions" limit. See [http://dev.mysql.com/doc/refman/5.0/en/user-resources.html Limiting Account Resources in the MySQL manual].

*'''Check your .htaccess files'''. If the install is on a webhost, adding the following line to the .htaccess file in the Moodle directory has been known to solve the problem.
AddType x-mapp-php5 .php

:Try also renaming the .htaccess file so that it is disabled.

==Code customizations==
You may also want to look and see if you've customized any of your code. Look at the last successful table, and then look at the block, mod, or other code that is referenced by that table. For example, if your install hangs and continues to say that the forum tables were successful as the last message, look at /mod/forum/ for any custom code. If you have customized code, backup those files and replace with the correct files. You can then restart the install by renaming config.php or reinstalling your database from the backup. If your install is successful, you can make your code changes back into the stock Moodle code.

==Check your memory limit==
It may also be that the "memory_limit" in your php.ini is set too low. Please check your php.ini file and allocate the recommended amount (see [https://docs.moodle.org/en/Installing_Moodle#Requirements Moodle requirements]). For Moodle version 1.8 and above at least 40MB is recommended.

==Do not upgrade incrementally==
To avoid this problem when upgrading, it is recommended to upgrade directly from any previous version to these versions:

1.x -> 1.9.19+ -> 2.2.11 -> 2.7.14 -> 3.1

A work-around to this problem is to setup a working Moodle system on your local PC or server using the [http://download.moodle.org Moodle Packages]. Once you have a running Moodle, [https://docs.moodle.org/en/Upgrading_Moodle#Backup_important_data backup the database] and import to your webhost. Then backup the Moodle code itself (the "moodle" directory on your PC) and copy this to your webhost using (for example) FTP. Finally, edit the moodle/config.php file for the new settings that have to be changed for the webhost.

Some Moodlers have found the suggestion in http://moodle.org/mod/forum/discuss.php?d=65786#p297433 helpful, for some unknown reason. It claims that it is because the fopen function in the line (now line 426 instead of 406) was not being given a string as the first argument, but that's not true. It was a string; after the edit it is a string whose first and last characters are single quote marks. The amazing thing is that it works at all after that edit. What's even more amazing is that it fixes the problem, at least for some users. Go figure.

==Database configuration issues==
If the installation hangs after entering your database details, it is likely that there is a problem with the details that you have entered for accessing the database. For example, if your MySQL database is running on port 3309 rather than the default 3306, make sure that you set the database URL to "http://localhost:3309" rather than just "http://localhost".

==See also==

*[http://moodle.org/mod/forum/view.php?id=28 Installation Forum at Moodle.org]

[[es:Paros inesperados de la instalación]]
[[ja:予期しないインストールの停止]]
[[de:Unerwartete Installationsabbrüche]]

Capabilities/mod/forum:canposttomygroups

2019-05-28T12:34:24Z

Ghillenb:

{{Capabilities}}
* For users who have access to all or several groups in a forum, this capability allows them post the same message once only to all groups
[[File:forumdiscussiongroup2.png]]
*This capability is allowed for default roles of manager, teacher and non-editing teacher

==See also==

* [[Using Forum]]

[[Category:Capabilities|Forum]]
[[Category:Forum]]

[[es:Capabilities/mod/forum:canposttomygroups]]
[[de:Capabilities/mod/forum:canposttomygroups]]

Workshop quick guide

2019-05-21T13:50:14Z

Ghillenb: /* See a workshop in action */

{{Workshop}}
Workshop is a powerful peer (and self) assessment activity. This quick guide takes you through the basics of setting up a workshop for your students. If you really want to make the most of everything a Workshop can do, make sure you study the full '''[[Workshop activity]]''' documentation.
__NOTOC__
==Setting up your workshop==
*In the course where you want your workshop, turn on the editing and from the Activity Chooser, select 'Workshop'.
*Give it a name and a description telling students what the workshop is about.
*Clicking the question mark icon [[File:helppopup.png]] next to any setting you don't understand will display extra help.
*If you're not sure about the '''Grading settings''', leave them as default. Students get two grades - one for the work they submit and one for the quality of their peer assessments. You can change the default 80% and 20% if you wish and you can also set passing grades for both scores. It is usually only the students who do the assessing, although you as a teacher can assess too, and you can change individual student grades later on if you think it is necessary. The page '''[[Workshop grading strategies]]''' gives more information.
* The '''Submission settings''' is where you tell them what they must do for this task. They can type directly into Moodle or upload one or more files. You can let them submit late if you wish and you can specify which file types they are allowed to upload.
*The '''Assessment settings''' is where you tell them briefly what they are looking for when assessing the work of their peers. Don't give detailed instructions because this will be done later.You can let them assess their own work too, based on the more detailed criteria you will add later.
*'''Feedback''' will give the students the option of typing in some free text comments when they peer assess. You can make this optional, required or turn it off. They may also upload files as feedback, and you can specify which file types they may add. You can also add a conclusion to the workshop which will display when it is over.
*You might find it useful to give your students one or more '''Example submissions''' to practise on first. If you do, you can make them optional or required. You can force them to practise on any example submissions before they upload their own or afterwards before they do the peer-assessments.
*Think about whether, in the '''Availability''' section, you want the students to be given submissions to assess automatically once the submission deadline is over.

==Workshop phases==
Once saved, you will see the Workshop displayed like this:

[[File:workshopphases33.png]]

A workshop moves between different phases. You can automate some phases and (if needed) you can move back a phase. You as teacher switch phases when you are ready by clicking the icon or text. The Setup phase will be highlighted because it's the phase you are in when you have just created the workshop.

===Setup phase===
*Click 'Edit assessment form' to provide detailed grading criteria for your students to use. When finished, click 'Save and close', and all ticks on the Setup phase will be the same colour.
*You are ready to switch to the Submission phase which lets students send in their work. Click the icon or text at the top of Submission phase. This phase will be highlighted.

===Submission phase===
*Students will now be able to submit their work during this time, until any deadline you specified - unless you also allowed late submissions.
*Click the link 'Allocate submissions' to decide if you yourself want to choose which student assesses whose work (''Manual allocation''), or if you want Moodle to choose for you (''Random allocation'') And do you want students to assess others' work even if they have not submitted anything themselves?
*If,in the '''Availability''' section you set the workshop to switch to the submission phase automatically once the submission deadline is over, choose ''Scheduled allocation.''

[[File:33workshopsubmissionphase.png]]

*You can see how many have submitted and how many still need to submit. Click the icon or text to move to the Assessment phase if you chose to switch phases yourself. The phase will be highlighted. (Remember that you can move back a phase if you need to, for example if you want to allow a student to resubmit.)

===Assessment phase===
*Students will assess the work of their peers according to the instructions and criteria you gave them.
*You can monitor their progress by looking at the grades underneath the phases screen:

[[File:workshopqgreport.png]]

*When you are ready, click the icon or text to move to the Grading evaluation phase. This phase will be highlighted.

===Grading evaluation phase===
*Here, Moodle calculates the final grades for submission and for assessment. The page '''[[Using Workshop]]''' gives more details on how the grading works.
*For the grade for assessment, you can decide how strict you want the comparison to be. If you are not sure, leave it as the default 'fair'.
*You can recalcuate the grades several times.
*You as teacher can change grades here if you need to.
'''Publish submissions:''' You can show to other students selected submissions if you wish. Click on a submission in the workshop grades report (image above) and scroll down to 'Feedback for the author'. Tick the box to publish this submission. Other students will see it once the workshop is closed.

===Closing the workshop===
When you are satisfied with the final grading, click the icon or text to close the workshop. The Closed phase will be highlighted and students will be able to see their grades, any published submissions and a conclusion if you added one.

==See a workshop in action==
If you would like to practise with a workshop with students and data, log in to the [http://school.demo.moodle.net/ Mount Orange School] demonstration site and access the course '''[http://school.demo.moodle.net/course/view.php?id=59 Celebrating Cultures]''' with the username ''teacher'' and password ''moodle''. You can switch phases, check grading, publish submissions and explore other features of this useful activity.

[[Category:Quick guide]]

[[es:Guía rápida del taller]]
[[de:Kurzanleitung für Gegenseitige Beurteilungen]]

Grader report

2019-05-20T07:40:56Z

Ghillenb:

{{Grades}}
All the grades for each student in a course can be found in the course gradebook, or 'Grader report', accessed from the Grades link either in the nav drawer or navigation block depending on your theme.

{{MediaPlayer | url = https://youtu.be/ZR4AvpD3bVA | desc = Overview of the gradebook}}

The grader report collects [[Grade_items|items]] that have been graded from the various parts of Moodle that are assessed, and allows you to view and change them as well as sort them out into [[Grade_categories|categories]] and calculate totals in various ways. When you add an assessed item in a Moodle course, the gradebook automatically creates space for the grades it will produce and also adds the grades themselves as they are generated, either by the system or by you.

The grades displayed are initially displayed as the raw marks from the assessments themselves, so will depend on how you set those up e.g. an essay out of 36 will appear as however many raw marks that student got, not a percentage (although this can be changed later, see below).

Note that various default options for the gradebook are set at system level by the administrator in and can be marked as being overridable by you, or fixed. This means that the options will not always be set up the same way for every user when they see the grader report for the first time.

==Hiding settings globally==

New settings hide parts of the user interface:

*''Site administration>Grades>General settings'': 'Show minimum grade' . If this setting is disabled, the minimum grade will default to zero and cannot be edited (the minimum grade can never be edited).
*''Site administration>Grades>Grade category settings'': 'Allow category grades to be manually overridden'. If this setting is disabled, users cannot override category grades.

==Display==

Along the top of the grader report are several rows: first the course, then the category, then the columns for each graded activity (for example: Assignment, Quiz, Lesson). Any activities settings which were left "uncategorised" will appear in the general category which is named after the course by default (any category name can be changed).

[[Image:gradereportcategories.png|center|thumb|600px]]

You can add a row showing the range of possible scores by selecting 'Show ranges' in 'My report preferences.

There are three ways that the categories can be displayed:

* Grades only - without the category totals column
* Aggregates - Category total column only
* Full view - grades and the aggregates (the totals column for the category)

Each section has a small icon immediately to the right of its name. Clicking this will cycle through these display modes for that category;

[[Image:grades3iconsa.png|thumb|500px|center]]

===Scrolling through the gradebook===

The gradebook allows for smooth and stable scrolling horizontally and vertically through grades. It uses the whole window, making it accessible on all platforms.( Note: horizontal scrolling is at the bottom of the browser window, and there is no horizontal scrollbar at the top.)

{|
| [[File:scrolling28a.png|thumb|500px|Scrolling in all directions]]
| [[File:wholewindow.png|thumb|500px|Using the whole window]]
|}

[[File:newgradereporta.png|thumb|600px|center]]

===Sorting by columns===

You can sort by any column. Click the [[Image:iconsort.png]] symbol near the top of a column to sort by that column (1 below). This will change the symbol to a single down arrow. Clicking again will sort lowest-to-highest, changing the symbol to an up arrow. The arrows will toggle between these two states until you click on a different column.

You can also access the [[Single view]] by clicking the pencil icon next to the arrows (2 below).

[[File:iconsgrades.png]]

You can sort the students by clicking the arrow (1 below), access individual [[User report| user reports]] by clicking the icon (2 below) and similar to the grade items you can access [[Single view]] by clicking the pencil icon (3 below)

[[File:studentsort.png]]

===Searching and filtering the gradebook===
If you change the course settings Group mode to Visible groups or Separate groups a drop-down menu will appear in the gradebook to allow you to filter your students by groups.

It is also possible to search students by first name and last name:

[[File:gradebooksearch.png]]

==Editing==

Note: Editing anything in the gradebook refers to editing the grades '''only''' and none of the available operations bear any relationship to editing the main course page i.e. the appearance of your course page cannot be influenced by anything you do in the gradebook. The "Turn editing on" button functions separately from the main course one, so editing can be on in the gradebook, but simultaneously off when you switch back to course view. This is because editing grades and editing the course page are separate capabilities. Roles such as 'non-editing teacher' may only have one or the other.

===Altering the grades===
You can click "Turn editing on" at the top right to show an edit icon next to each grade. Clicking on the icon will bring up the editing screen for that grade which will allow you to set the grade, its written feedback and a number of other attributes.

Alternatively, you can choose "Quick grading" and "Quick feedback" in 'My preferences' to make the report appear with editable boxes containing each grade, so you can change many at once. This capability can be a real time saver, but make sure to save at reasonable intervals lest a pageful of changes be lost.

Note: If you make changes here, they are then shown highlighted to indicate grades which have been manually changed.

===Altering the grades using Single View===
There is a new way to enter grades into the grader report using the Single View tab (or listing in the dropdown) under Setup. (This interface can also be accessed by clicking on the pencil icon at the top of the column by the item name).
The single view interface allows you to enter grades in bulk for a specific grade item or a specific user. To change a specific grade or all grades, click on the Override checkbox by the specific grade row or use the Override All link to check every row. If you wish to override all grades with a set grade, check the Bulk Insert checkbox and enter the grade that you wish to insert. You can select whether to fill the grade for just empty grades or for all grades from the dropdown list.
Click on Save and you will now see in the Grader Report that all grades the specific item/user have been overridden with the grade/grades that you entered.

===Hiding columns or individual grades===
Turning on editing then clicking the "Show show/hide icons" link will give you the familiar show/hide eye icon next to each grade and at the top of each column. For more information, read about [[Grade_hiding|grade hiding]].

===Recalculating===
If you change any part of an assessment e.g. alter the maximum grade for one of the questions in a quiz, you may find that the columns do not yet reflect the change you have made. Click '''Turn editing on''' twice to force the gradebook to re-check.

==Gradebook capabilities==

There is just one gradebook capability, [[Capabilities/gradereport/grader:view|View the grader report]], which is allowed for the default roles of manager, teacher and non-editing teacher.

==Extending the gradebook==

The Gradebook can be extended in three main ways:

===1. [https://moodle.org/plugins/browse.php?list=category&id=9 Grade reports]===
Which are the main way to view and manipulate grades
* [[LAEGrader report|LAE Grader Report]] Alternative to Grader report that scrolls vertically and horizontally without losing student columns or grade item header rows. Lot of additional enhancements.
* [https://moodle.org/plugins/view.php?plugin=gradereport_updfgrades Upload PDF Grader Report] lets you view assignment grades, comments and lateness in a report

===2. Grade import plugins===
Which allow data to be imported from external sources

===3. [https://moodle.org/plugins/browse.php?list=category&id=10 Grade export plugins]:===
Which allow you to export grade data for other systems
* [https://moodle.org/plugins/view.php?plugin=gradeexport_pdf PDF document] This is moodle plugin for exporting grades in PDF format. It is developed by using "Moodle PDF library"
* [https://moodle.org/plugins/view.php?plugin=gradeexport_checklist Checklist] This is a grade export plugin which will create an Excel spreadsheet containing all the checkmarks from a single checklist.

==See also==

* Join the discussions about gradebook plugins in the [https://moodle.org/mod/forum/view.php?id=2122 Gradebook forum].

[[de:Bewertungen]]
[[es:Libro de calificaciones]]
[[fr:Carnet de notes]]
[[ja:評定表]]

Classic theme

2019-05-16T10:56:04Z

Ghillenb:

{{Themes}}
{{New features}}
Classic is a new core theme which combines the block navigation of the deprecated Clean theme and the customisation options of the [[Boost theme]]

'''VIDEO COMING HERE SOON'''

The Classic theme is a child theme of Boost, using the upstream Bootstrap 4 Stable library, with a general look inspired by the Clean theme. The amount of CSS added on top of the Boost theme CSS has been kept to a minimum.
==Customising the Classic theme==
The theme provides a number of customisation options previously found on the Clean theme settings page.

===Invert navbar colour===
This changes the navbar background color to the brand colour. By default, it is set to blue as shown in the previous screenshots. Links and icons will be shown in a shade of white.

===Presets===
Moodle presets are files containing a list of custom Bootstrap variables and raw SCSS that can be used to customise themes. The Classic theme uses the exact same preset structure as Boost, so preset files can easily by reused.

===Background image===
The theme allows selecting a background image to be used on all pages.

===Brand colour===
The branch colour is used as the default colour for the inverted navbar background color, links and buttons.

===Advanced settings===
The Classic theme provides the same customisation options as the [[Boost theme]] for injecting raw SCSS. These settings allow users to have the same results as using Moodle presets.

==Using Classic as a parent theme==
[https://docs.moodle.org/dev/Themes The Developer documentation on Themes] contains useful information for developing Classic-based themes.

[[de:Classic Design]]

Capabilities/tool/dataprivacy:requestdeleteforotheruser

2019-05-16T10:30:31Z

Ghillenb:

{{Capabilities}}{{New features}}
* This allows a user to request data deletion on behalf of another user
* This capability is not set for any of the default roles. It may only be applied in the system context i.e. as a system role.

==See also==

* [[Data privacy]]

[[Category:Capabilities|Privacy]]
[[Category:Privacy]]

[[en:Capabilities/tool/dataprivacy:requestdeleteforotheruser]]

Capabilities/tool/dataprivacy:requestdelete

2019-05-16T10:29:04Z

Ghillenb:

{{Capabilities}}{{New features}}
* This allows a user to request data deletion for themselves
* This capability is allowed for the default role of authenticated user.

==See also==

* [[Data privacy]]

[[Category:Capabilities|Privacy]]
[[Category:Privacy]]

[[de:Capabilities/tool/dataprivacy:requestdelete]]

Capabilities/tool/dataprivacy:makedatadeletionrequestsforchildren

2019-05-16T10:23:52Z

Ghillenb:

{{Capabilities}}{{New features}}
* This allows a user to make data deletion requests for minors.
* This capability is not set for any of the default roles. It may only be applied in the system context i.e. as a system role.

==See also==

* [[Data privacy]]

[[Category:Capabilities|Privacy]]
[[Category:Privacy]]

[[de:Capabilities/tool/dataprivacy:makedatadeletionrequestsforchildren]]

Capabilities/moodle/course:configurecustomfields

2019-05-16T10:19:57Z

Ghillenb:

{{Capabilities}}{{New features}}
*This allows a user to configure custom fields
*This capability is available in Moodle 3.7 onwards and is not allowed for any of the default roles

[[Category:Capabilities|Course]]
[[Category:Course]]

[[de:Capabilities/moodle/course:configurecustomfields]]

Capabilities/moodle/course:changelockedcustomfields

2019-05-16T10:18:04Z

Ghillenb:

{{Capabilities}}{{New features}}
*This allows a user to change locked custom fields
*This capability is available in Moodle 3.7 onwards and is allowed for the default role of manager only

[[Category:Capabilities|Course]]
[[Category:Course]]

[[de:Capabilities/moodle/course:changelockedcustomfields]]

Capabilities/moodle/category:viewcourselist

2019-05-16T10:09:31Z

Ghillenb:

{{Capabilities}}
{{New features}}
*This capability allows a user to view the list of courses
*It is allowed by default for the [[Student role]], the [[Guest role]] and the [[Authenticated user role]]

You might want to use this capability in combination with the [[Course list viewer role]] to define which users may and may not view course lists.

[[Category:Capabilities]]
[[de:Capabilities/moodle/category:viewcourselist]]

Capabilities/mod/forum:readprivatereplies

2019-05-16T10:05:41Z

Ghillenb:

{{Capabilities}}{{New features}}
*This allows a user to view private replies in a [[Forum|forum]] (in addition to the user whom the private reply is directed to)
*This capability is available in Moodle 3.7 onwards and is allowed for the default roles of manager, teacher and non-editing teacher

[[Category:Capabilities|Forum]]
[[Category:Forum]]

[[de:Capabilities/mod/forum:readprivatereplies]]

Capabilities/mod/forum:postprivatereply

2019-05-16T10:03:41Z

Ghillenb:

{{Capabilities}}{{New features}}
*This allows a user to reply privately to posts in a [[Forum|forum]]
*This capability is available in Moodle 3.7 onwards and is allowed for the default roles of manager, teacher and non-editing teacher

[[Category:Capabilities|Forum]]
[[Category:Forum]]

[[de:Capabilities/mod/forum:postprivatereply]]

Capabilities/mod/forum:canoverridecutoff

2019-05-16T10:00:40Z

Ghillenb:

{{Capabilities}}{{New features}}
*This allows a user to post to a [[Forum|forum]] after the cut-off date
*This capability is available in Moodle 3.7 onwards and is allowed for the default roles of manager, teacher and non-editing teacher

[[Category:Capabilities|Forum]]
[[Category:Forum]]

[[de:Capabilities/mod/forum:canoverridecutoff]]

Capabilities/mod/forum:cantogglefavourite

2019-05-16T10:00:07Z

Ghillenb:

{{Capabilities}}{{New features}}
*This allows a user to star [[Forum|forum]] discussions
*This capability is available in Moodle 3.7 onwards and is allowed for the default role of authenticated user

[[Category:Capabilities|Forum]]
[[Category:Forum]]

[[de:Capabilities/mod/forum:cantogglefavourite]]

Capabilities/mod/assign:showhiddengrader

2019-05-16T09:45:07Z

Ghillenb:

{{Capabilities}}{{New features}}
*This allows a user to see the identity of a hidden [[Assignment]] grader
*This capability is available in Moodle 3.7 onwards and is allowed for the default roles of manager, teacher and non-editing teacher

[[Category:Capabilities|Assignment]]
[[Category:Assignment]]

[[de:Capabilities/mod/assign:showhiddengrader]]

Capabilities/mod/assign:showhiddengrader

2019-05-16T09:44:26Z

Ghillenb:

Learning plan supervisor

2019-05-10T12:07:04Z

Ghillenb: /* See also */

{{Competencies}}Course teachers cannot by default create, manage or view student [[Learning plans|learning plans]], since competencies and learning plans exist outside of a course context, whereas the role of teacher is assigned in the course context. To allow course teachers to create, manage and view learning plans ''for the students they are responsible for only'', follow these steps:

==Create two custom roles==

====Learning plan supervisor (system)====

#From Site administration, access the Define Roles screen and click the button to Add a new role.
#Click the Continue button.
#Give your role the name ''Learning plan supervisor (system)''
#Tick 'System' as the context type where the role may be assigned.
#Scroll down and set the capabilities moodle/site:configview, moodle/competency:templatemanage, moodle/competency:templateview and block/lp:view all to Allow.
#Save the new role.

====Learning plan supervisor (user)====

#From Site administration, access the Define Roles screen and click the button to Add a new role.
#Click the Continue button.
#Give your role the name ''Learning plan supervisor (user)''
#Tick 'User' as the context type where the role may be assigned.
#Scroll down and set the capabilities moodle/competency:planmanage, moodle/competency:planreview, moodle/competency:plancomment all to Allow.
#Save the new role.

==Create a cohort of the teacher's students==
In order to ensure the new learning plan supervisor can only deal with his/her own students, we need to create a cohort.

#From Site administration, access the Cohorts screen and add a new cohort.
#Add the students of the teacher you wish to make a learning plan supervisor.

==Match the cohort to their teacher==
#From Site administration, access the Cohorts screen and create a cohort with the relevant students in it.
#Then from the Users tab, click the link Assign user roles to cohort.
#From the top dropdown, choose your teacher.
#In the middle ('Select role') dropdown, choose 'Learning plan supervisor (user)'. (Note that only roles with 'User' ticked as the context type where they may be assigned will be visible here.)
#From the bottom ('Select cohorts') dropdown, choose the cohort with the teacher's students.
# Click the Assign button.

==Assign your teacher the new role==
#From Site administration, access the Users screen, and then from Permissions, click Assign system roles.
#Assign your chosen teacher the role of Learning plan supervisor (system).

==What the teacher sees==
''Note: The role will not take effect immediately; only once the scheduled task has run.''

The course teacher will see a Site administration link and be able to access learning plan templates:

[[File:learninplanmanager1.png|center|thumb|500px]]

He/she will be able to add a new learning template.

[[File:learningplanmanager2.png|center|thumb|500px]]

Once the template is created, clicking the Edit link will allow them to create new learning plans ''only for the students in the cohort'' created by the admin.

[[File:learninplanmanager3.png|center|thumb|500px]]

The course teacher and learning plan supervisor will be able to see the learning plans from their students' profiles.

==See also==
*The [[Learning plan viewer]] role allows course teachers to view (but not create or edit) the learning plans of their students.
*The [[Competency reviewer]] role allows course teachers to view evidence uploaded by students and review their competencies.

[[Category:Roles]]

[[es:Supervisor de plan de aprendizaje]]
[[de:Lernplan-Verwalter-Rolle]]

Capabilities/moodle/analytics:listowninsights

2019-05-09T10:30:44Z

Ghillenb:

{{Capabilities}}{{New features}}
*This allows a user to list their own [[Analytics|analytics insights]]
*This capability is available in Moodle 3.7 onwards and is allowed for the default role of authenticated user

[[Category:Capabilities|Analytics]]
[[Category:Analytics]]

[[es:Capabilities/moodle/analytics:listowninsights]]
[[de:Capabilities/moodle/analytics:listowninsights]]

Moodle Mobile assignment

2019-04-02T09:39:09Z

Ghillenb:

{{Mobile}}
==Features==

* Students can make [[Assignment activity|assignment submissions]] using the app, review their submissions and check their feedback, comments and grades.
* Teachers can view and download the students' submissions and review comments, feedback and grades.
* When uploading a file submission, all files are uploaded again if any changes have been made.

<div><ul>
<li style="display: inline-block;">[[File:Android assignment 1.png|thumb|250px|View assignment, check status and submit]]</li>
<li style="display: inline-block;">[[File:Android assignment 2.png|thumb|250px|Online text submission]]</li>
<li style="display: inline-block;">[[File:Android assignment 3.png|thumb|250px|File submissions]]</li>
<li style="display: inline-block;">[[File:Android assignment 4.png|thumb|250px|Submit for grading]]</li>
<li style="display: inline-block;">[[File:Android assignment 5.png|thumb|250px||Teacher: Check user submissions]]</li>
<li style="display: inline-block;">[[File:Android assignment 6.png|thumb|250px|Teacher: Blind marking]]</li>
</ul></div>

== Requirements ==

Moodle Mobile assignment requires Moodle 3.1 onwards.

Alternatively, it may be used with sites running Moodle 2.8 to Moodle 3.0 with the [[Moodle Mobile additional features]] plugin installed. For earlier versions of Moodle, only basic information will be displayed.

Third party submission and feedback plugins are only supported if the Moodle website has the appropriate remote add-on installed.

==See also==

For submission of files using iOS please refer to [[Sharing files with Moodle Mobile with iOS]].

[[Category:Assignment]]

[[es:Tarea de Moodle Mobile]]
[[de:Moodle App - Aufgaben]]

Moodle app SCORM player

2019-04-02T09:37:24Z

Ghillenb:

{{Mobile}}
==Features==

The Moodle app SCORM player enables the playing of SCORM 1.2 packages online and offline.

When a user loses connectivity, offline mode is enabled automatically and all interactions that are tracked by the SCORM package are saved.

When a user is online again, the offline attempt is synchronised back to the Moodle site, either merging it with other incomplete attempts on the site or saving it as a new attempt.

== Requirements ==

The Moodle app SCORM player requires Moodle 3.0 onwards. In ''Site administration > Plugins > Activity Modules > SCORM Package'' the setting 'Protect package downloads' should be disabled (default setting).

The Moodle app SCORM player may be used on sites running Moodle 2.6 to Moodle 2.9 if the [[Moodle app additional features]] plugin is installed.

If the playing of SCORM packages offline is not desired, the setting 'Protect package downloads' may be enabled. If the Moodle app additional features plugin is being used, the setting can be found in ''Site administration > Plugins > Local plugins > Moodle Mobile additional features''.

The ZIP file containing the SCORM contents should not be Windows specific. If your SCORM package contains directories using the inverted path separator "\" they won't work in Android.

== Technical details ==

The Moodle app SCORM player provides support for:

* SCORM 1.2 packages
* Objectives, interactions and prerequisites
* SCO navigation via nav.event
* Uploaded packages, remote zip packages and zip packages in any type of repository supported by Moodle

The Moodle app SCORM player does not currently support:

* Remote imsmanifest.xml packages or file system repository unzipped SCORMS
* Opening of packages outside the app e.g. in a new browser window
* JavaScript pop-ups via window.open (Mobile device limitation)

==Tips for Moodle app friendly SCORM packages ==

* Try to reduce the size of the images and use mobile-compatible formats e.g. png
* Try to reduce the size of videos and use mobile-compatible formats e.g. mp4
* Avoid using Flash or FLV
* Avoid using images, files or media on remote sites
* Avoid using pop-ups
* Avoid using advanced HTML5 features, as they may not be supported by old devices such as iOS 4 or Android < 4.4
* Avoid having a left navigation menu as part of the SCORM package, as this reduces the space available for the package content
* If you want to display your SCORM package in semi full-screen mode (it will just remove the app bottom menu), you have to configure it in Moodle so it will open in "New window" via the SCORM module Appearance settings.

[[Category:SCORM]]

[[es:Reproductor SCORM Moodle Mobile]]
[[de:Moodle App - SCORM Player]]

Moodle app features

2019-04-02T09:36:38Z

Ghillenb:

{{Mobile}}
__NOTOC__
<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:36MoodleApp.png|600px]]
<div class="caption">
<h4>See your courses at glance</h4>
<p>Your courses are listed with easy access to contents, participants, grades and notes. A useful filter field lets you find a particular course quickly. If your token expires during a session, you're prompted to re-enter your password and continue. </p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35timeline.png|600px]]
<div class="caption">
<h4>View and access activities which are due</h4>
<p> The timeline display shows you which tasks you need to complete, with quick access links. </p>
</div>
</div>
</li>
</ul>
</div>

<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile35connectparticipants1.png|600px]]
<div class="caption">
<h4>Connect with course participants</h4>
<p>Easily connect to course participants.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35dashboardbothorientations.png|600px]]
<div class="caption">
<h4> Orientation and resolution support </h4>
<p>The app displays in portrait or landscape view, whatever your screen resolution.</p>
</div>
</div>
</li>
</ul>
</div>

<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile35accesscourses.png|600px]]
<div class="caption">
<h4>Easily access course content</h4>
<p>View course activities and download materials for offline use. Work through Books and IMS Content packages directly in the app. The downloading status of resources is preserved even when changing sections or pages.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35activitycompletion.png|600px]]
<div class="caption">
<h4>Activity completion</h4>
<p>Track progress from your device with [[Activity completion]]. Automatic completion is registered, and students can also manually mark a task complete on their mobile.</p>
</div>
</div>
</li>
</ul>
</div>

<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile35gradebook.png|600px]]
<div class="caption">
<h4>Grades and grading</h4>
<p> A Grades link for each course gives fingertip access to the gradebook, and teachers can view assignment submissions on the move.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35notes.png|600px]]
<div class="caption">
<h4>Notes</h4>
<p>Teachers can view site, course and personal notes about their students and add their own notes.</p>
</div>
</div>
</li>
</ul>
</div>

<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile35messages.png|600px]]
<div class="caption">
<h4>Message participants</h4>
<p>Send and view private messages to colleagues and students from the Messages link in the side tab.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35calendar.png|600px]]
<div class="caption">
<h4>Keep up to date with calendar events</h4>
<p>Site, course and user events can be viewed in the calendar.Calendar events can now be viewed offline and infinite scrolling is available.</p>
</div>
</div>
</li>
</ul>
</div>

<div class="contentblock">
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile35privatefiles.png|600px]]
<div class="caption">
<h4>View and upload to your Private files</h4>
<p>Check the contents of your private files and upload media to them on the go. You're now allowed up to 50MB storage (depending on your SD card).</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35notifications.png|600px]]
<div class="caption">
<h4>Notifications</h4>
<p>Keep up to date with notifications. The app supports both local (calendar events) and push (messages, forum posts, submitted assignments etc) notifications. See [[Mobile app notifications]] for more details. Infinite scrolling is available and local notifications have multi-site support.</p>
</div>
</div>
</li>
</ul>
</div>

<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File: mobile35choice.png|600px]]
<div class="caption">
<h4>Make choices</h4>
<p>The app supports students making and removing choices.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35chat.png|600px]]
<div class="caption">
<h4>Engage in chat, on the move</h4>
<p>Participate in a course [[Chat activity]].</p>
</div>
</div>
</li>
</ul>
</div>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile35survey.png|600px]]
<div class="caption">
<h4> Feed back to teachers with a survey</h4>
<p>[[Survey|Surveys]] may now be taken using the app.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35searchcourses.png|600px]]
<div class="caption">
<h4>Search the list of courses</h4>
<p>App users can search courses to find one they wish to take.</p>
</div>
</div>
</li>
</ul>
</div>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile35selfenrol.png|600px]]
<div class="caption">
<h4>Enrol yourself from your smartphone</h4>
<p>Found a course you like? Enrol immediately via the app.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35scorm.png|600px]]
<div class="caption">
<h4>Play SCORM packages on and off-line</h4>
<p>The [[Moodle Mobile SCORM player]] tracks interactions and synchronises when you're back online.</p>
</div>
</div>
</li>
</ul>
</div>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile35downloadcourse.png|600px]]
<div class="caption">
<h4>Download all course sections</h4>
<p>Easily download all sections to view offline.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35glossary.png|600px]]
<div class="caption">
<h4>Browse glossary entries</h4>
<p>Search for and browse glossary entries.</p>
</div>
</div>
</li>
</ul>
</div>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File: mobile35quiz.png|600px]]
<div class="caption">
<h4>Take quizzes on your mobile</h4>
<p>Quizzes may now be completed on the move. Find out more about the [[Moodle Mobile Quiz module|Moodle Mobile quiz]].</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35learningplans.png|600px]]
<div class="caption">
<h4>Learning plans </h4>
<p>Learning plans may be viewed and progress checked from the mobile.</p>
</div>
</div>
</li>
</ul>
</div>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File:mobile35competencies.png|600px]]
<div class="caption">
<h4>Easiy view course competencies</h4>
<p>A Competencies tab allows you to see course competencies at a glance.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35teachergrading.png|600px]]
<div class="caption">
<h4>Teachers: Grade assignments</h4>
<p>Assignments may be graded on the move, from the app and may be graded offline</p>
</div>
</div>
</li>
</ul>
</div>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File: mobile35badges.png|600px]]
<div class="caption">
<h4>View badges from your profile</h4>
<p>Badges are now visible from a link in the user profile</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35preferences.png|600px]]
<div class="caption">
<h4>Notifications & Messaging preferences</h4>
<p>New preferences screen lets you decide how to be alerted</p>
</div>
</div>
</li>
</ul>
</div>
<div class="row-fluid">
<ul class="thumbnails">
<li class="span6">
<div class="thumbnail">
[[File: mobile35workshop.png|600px]]
<div class="caption">
<h4>Submit to workshops from the app</h4>
<p>Students can now do workshop activities from their mobile or tablet.</p>
</div>
</div>
</li>
<li class="span6">
<div class="thumbnail">
[[File:mobile35paypal.png|600px]]
<div class="caption">
<h4>Sign up to courses via PayPal</h4>
<p>PayPal enrolment is now supported in the app.</p>
</div>
</div>
</li>
</ul>
</div>
====Features summary====

* Responsive design for phone and tablets
* Upload a picture into your private file area
* Record an audio file and upload it into your private file area
* Record a video and upload it into your private file area
* Send a private message to a course participant (can be done offline)
* Take a personal note about a course participant (can be done offline)
* Add a course participant to your phone contact
* Call a course participant touching the phone number
* Locate a course participant address on Google map
* Download and view some course resources
* Quick access to your course contents
* View calendar events
* Reminder notifications for calendar events
* Mobile Push notifications
* Remote layout/style customization (see below)
* View all your past private messages and notifications
* Browse and download your private and course files
* View forum discussions
* Private messaging between users
* Calendar integration with warning reminders as local notifications
* Upload any type of file from your device to your Moodle private files area
* View site, course and personal users notes
* Support for sites using CAS or Shibboleth as auth methods
* View your activity and course total grades in a course
* Course search
* Self-enrolment in courses (including via PayPal)
* Access courses with guest access enrolment method enabled
* Follow app-specific activity links (see [[Creating Moodle Mobile friendly courses]] for details)
* Browse glossary entries
* Browse your learning plans
* View competencies of students in your course
* Support for all the course modules (activities and resources) except the Workshop module
* [[Moodle Mobile quiz|Attempt quizzes]]
* [[Moodle_Mobile_SCORM_player|SCORM player]]
* [[Moodle Mobile assignment|Make assignment submissions]] and review submissions, comments, feedback and grades
* Use a rich text editor when creating forum posts, attempting quizzes with essay questions, creating wiki pages or submitting assignments (only in Android 4.4 onwards)
* Submit to workshop activities

==Activities & Resources Support==

[[File:moodlemobile_activities_resources.png]]

==Comparison of features in different versions==
[[File:30_moodlemobile_features.png]]

=== Languages ===

The Moodle app is being translated into an increasing number of languages. As of August 2018, 35 languages are available:

(ar) عربي, (bg) Български, (ca) Català, (cs) Čeština, (da) Dansk, (de) Deutsch, (de-du) Deutsch - Du, (el) Ελληνικά, (en) English, (es) Español, (es-mx) Español - México, (eu) Euskara, (fa) فارسی, (fi) Suomi, (fr)Français, (he)עברית, (hu) magyar, (it) Italiano, (ja) 日本語, (ko) 한국어, (lt) Lietuvių, (mr) मराठी, (nl) Nederlands, (pl) Polski, (pt-br) Português - Brasil, (pt) Português - Portugal, (ro) Română, (ru) Русский, (sr-cr) Српски, (sr-lt) Srpski, (sv) Svenska, (tr) Türkçe, (uk) Українська, (zh-cn) 简体中文, (zh-tw) 正體中文

If the Moodle app is not yet available in your language, please consider helping with the translation. See [[:dev:Translating Moodle Mobile|Translating Moodle Mobile]] for details.

[[ca:Característiques_Moodle_Mobile]]
[[es:Características de Moodle Mobile]]
[[fr:Fonctionnalités de l'app mobile]]
[[de:Moodle App - Funktionalitäten]]

== See also ==
* [http://www.slideshare.net/juanleyva/moodle-mobile-offline-features Moodle Mobile offline features] - Presentation in the MoodleMoot UK 2016
* [[:dev:Moodle Mobile release notes|Moodle Mobile release notes]] in the dev docs

Moodle app notifications

2019-04-02T09:24:13Z

Ghillenb: /* Testing push notifications */

{{Mobile}}

==For students and teachers==
[[File:12Notifications.png|thumb|Forum post notification]]
The Moodle mobile app lets you keep up to date with all that's happening in your courses and on the site. Every time you open the app, events are synchronised with the website.

You will receive [[Calendar|Moodle calendar]] event notifications automatically. If you don't want to get them, you can turn them all off individually (or globally) in the Calendar events options in the main menu.

You will also receive notifications of messages, forum posts, submitted assignments etc (known as 'push notifications') if your site administrator has enabled these. To receive these notifications you need to enable them EITHER via the app OR via the website.

To enable mobile notifications via the app:

# Go to the app settings then Notification preferences
# Move the slider so that disable notifications is off
# Move the slider to turn on notifications for assignment, feedback, forum etc. as required

To enable mobile notifications via the website:

# Go to your user menu (top right of each page) and select Preferences
# Click the link 'Notification preferences'
# Click to turn on notifications for assignment, feedback, forum etc. as required

{|
|-
| [[File:notification preferences app.png|thumb|Notification preferences in the app]]
| [[File:notification preferences web.png|thumb|Notification preferences on website]]
|}

==For administrators==

Push notifications can be enabled by an administrator by connecting their Moodle site to a messaging server such https://messages.moodle.net (available for [[Site registration|registered Moodle sites]] only). An access key can be obtained via ''Administration > Site administration > Plugins > Message outputs > Mobile Notifications''.

You can enable by default Mobile notifications for your students, please read the "Default message outputs" section in [[Messaging settings]].

If you have problems requesting the access key, please fill in the [http://goo.gl/forms/WLwkbe8b7c Airnotifier access key manual request form]. (If your site is hosted so you can't obtain your siteidentifier, enter "cannot obtain" in the field.) Your site registration will be checked and you will be sent an access key in a few days if everything is correct.

Users then need to connect at least once with the latest version of the Moodle Mobile app in order to register their phones with the Moodle site.

=== Event Reminders plugin===

Push notifications can also include calendar event notifications, however this requires the [https://moodle.org/plugins/view/local_reminders Event Reminders plugin] to be installed on the Moodle site.

The Event Reminders plugin will automatically send reminders for Moodle calendar events in a timely manner via Moodle message interface. It also allows users to control how they receive messages for each type of event in the Moodle calendar.

=== Installing your own notifications infrastructure ===

If you have a customized version of the Moodle Mobile app, or you want to use your own notifications infrastructure, you will have to install a private [http://airnotifier.github.io AirNotifier] (backend server for notifications).

https://messages.moodle.net uses a slightly modified version of Airnotifier: https://github.com/moodlehq/airnotifier/tree/moodle2.

'''UPDATE''': Google is deprecating FCM in April, 2019. The following steps may not be valid starting that date

You will have to add your app certificates - see https://github.com/airnotifier/airnotifier/wiki/Installation for further information.

The Airnotifier message plugin allows you to point to your custom Airnotifier instance using your own access keys.

Remember to install using GIT (repository https://github.com/moodlehq/airnotifier.git branch ''moodle2'').

Moodle offers a branded app service including a private notifications infrastructure, for more information visit https://moodle.com/mobileapp/

== Troubleshooting ==

If your users are not receiving push notifications please check:

* You have entered an Airnotifier access key in the Mobile settings in the Site administration
* Mobile is enabled (open eye) in 'Manage message outputs' in the Site administration
* Any user not receiving notifications has enabled mobile notifications in the mobile app in App settings > Notification preferences then check that "Disable notifications" is not selected
* Any user not receiving notifications has enabled the type of notifications they want to receive in App settings > Notification preferences
* Any user not receiving notifications hasn't disabled his current device in App settings > Notification preferences > 3 dots menu > Configure devices
* Mobile notifications are not disallowed by an administrator in 'Default message outputs' in the Site administration
* Mobile notifications are enabled in the user's Android phone (Settings > Apps > Moodle Mobile > Show notifications ticked) or iOS phone (in iOS in Settings -> Moodle Mobile > Notifications)
* The server where your Moodle site is installed is able to connect to messages.moodle.net (port 443) via telnet
* You are using the Moodle Mobile official app. If you are using a custom/branded app for your institution, please contact your institution since custom apps need their own notifications infrastructure (see above).
* Your Moodle installation cron jobs are not locked. You can check it executing the CRON manually and reading the output, more info [https://moodle.org/mod/forum/discuss.php?d=361595 here]

=== Testing push notifications ===

To test push notifications:

# Ensure that mobile notifications are enabled (as described above).
# Go to a course and create a forum with forced subscription.
# Log in as a student and create a new discussion in the forum.
# As the same student, log in on the mobile app, go to App settings > Notification preferences > Forum and enable all the notifications.
# In the same page, check that at the top of the page you see "You are configuring Mobile notifications". If it says "You are configuring notifications for web (or email)", switch to mobile via the three dots menu at the top right.
# In the same page, tap the three dots menu (top right), go to Configure devices and check that your current device is enabled.
# Now, put the Moodle Mobile app in background (switching to a different app or going to your device home).
# Log in to the site (on the web) and post a reply to the discussion started by the student., ticking the option "Send forum post notifications with no editing-time delay".
# Verify that the student receives a push notification on their mobile device.

[[de:Moodle App - Systemnachrichten]]
[[ca:Notificacions_de_la_app_Mobile]]
[[es:Mobile app Notificaciones Push]]
[[fr:Notifications de l'app mobile]]

New for mobile

2019-04-02T09:19:26Z

Ghillenb: /* See also */

{{Mobile}}

__NOTOC__

The Moodle app for 3.6 will be released a short time after Moodle 3.6 and will support the new features in Moodle 3.6, along with infinite scrolling and improved performance.

== See also ==

* [[:dev:Moodle_Mobile_release_notes|Moodle Mobile release notes]] in the dev docs

[[Category:New features]]

[[es:Nuevo para mobile]]
[[de:Moodle App - Neuigkeiten]]

Moodle app additional features

2019-04-02T09:13:20Z

Ghillenb: /* Admin users, please read */

{{Mobile}}
{{Infobox plugin
|type = Local plugin
|entry = http://moodle.org/plugins/view.php?plugin=local_mobile
|tracker = https://tracker.moodle.org/browse/CONTRIB/component/13930
|discussion = https://moodle.org/mod/forum/view.php?id=7798
|maintainer = [[User:Juan Leyva|Juan Leyva]]
}}

The Moodle Mobile additional features plugin provides new features and web services for the Moodle Mobile app which are currently only available in the latest Moodle version.

This plugin is officially developed and maintained by Moodle HQ

== How it works ==

Once installed the plugin creates a new service "Moodle Mobile additional features". The Mobile app checks if this service is enabled. If not, the Mobile app falls backs to the standard core Mobile app service.

Please, open [[Moodle Mobile features]] to check what new features are added to your site depending on your Moodle version.

== Features ==

* Support for Moodle sites prior to 3.2 using SSO authentication methods (Shibboleth, CAS and Google OAuth 2)
* Support for sites using MNet authentication (Moodle Network authentication)
* Support for push notifications in Moodle sites prior to version 2.6

=== Enable authentication for sites using SSO methods (like Shibboleth and CAS) ===

VERY IMPORTANT NOTE: If SSO is not working for your (or it is failing randomly), you'd need to disable the "Auto login guest" option "autologinguests". This setting may not be compatible with the SSO via app in some sites (it should work fine in Moodle 3.2 onwards).

SSO and MNet authentication is not supported in the Windows 8 and Windows Phone 8 apps

Once the plugin is installed, you need to go to Site administration > Plugins > Local plugins > Moodle Mobile additional features

There you can choose the "Type of login":
; '''Via the app''' : Is the default login, the user must introduce his credentials in the app
; '''Via a browser window''' : A new browser instance is open in the mobile device pointing to the login form in the Moodle site (which may again redirect to external identity providers if required). The user must introduce his credentials there. This is the option that must be selected for sites using SSO methods (or for sites that wants to force the user to authenticate in the site, not in the app)

[https://www.youtube.com/watch?v=cl8rsyyyg9g Video showing Moodle Mobile SSO]

When using the "Via a browser window" option, you can optionally specify an URL scheme to be used by the system to open the Mobile app. By default, the URL scheme used to open the app will be the one indicated by the own app during the SSO process. If you've developed a custom app using its own URL scheme and you want to allow only SSO logins via your app, you can indicate there an URL scheme. The site will detect that setting and will use it instead of the value indicated by the app.

=== Configuring the app from your site ===

* Disable app functionalities for your site. If there's a feature you don't want to make available via the app you can disable it here.
* Rename app text strings.
* Add new items in the app's main menu (the side menu).
* Replace the Change site option with a "Log out" one to force the users to enter their credentials on their next access.

== Installation ==

# Unpack the zip file into the local/ directory. A new directory will be created called local/mobile.
# Go to ''Site administration > Notifications'' to complete the plugin installation.
# Go to ''Site administration > Mobile app > Mobile settings'' and enable web services for mobile devices (Remember to save the changes)
# Go to ''Site administration > Plugins > Web services > External services'', edit "Moodle Mobile additional features" and check the "Enabled" field, then save changes.
# Go to ''Site administration > Users > Permissions > Define roles'', edit the Authenticated user role and allow the capability moodle/webservice:createtoken.

Note: You need to have upgraded the Moodle Mobile app to version 1.4.4.

If you are currently using the Moodle Mobile app, you will need to log out of all your sites in order for the app to detect the new service.

== Admin users, please read ==

This plugin installs a new service in your Moodle installation, the automatic token creation for this type of services is forbidden for admin users. This means that admin users will not be able to use the Mobile app.

This can be solved easily, administrators must create a token manually in Moodle (''Plugins > Web Services > Manage tokens'') for the local_mobile service. '''Note:''' Be sure to toggle the default "Moodle mobile web services" setting to "Moodle mobile additional features service" before creating the token.

[[de:Moodle App - Zusatzfunktionen]]
[[es:Características adicionales de Moodle Mobile]]
[[fr:Fonctionnalités additionnelles de l'app mobile]]

Moodle Mobile quiz

2019-04-02T09:07:48Z

Ghillenb: /* See also */

{{Mobile}}
==Features==

Users can attempt a [[Quiz activity|quiz]] on their mobile device using the Moodle Mobile app.

Notes:
* Any quiz with standard [[Question types|question types]] and [[Question behaviours|question behaviours]] is suitable for mobile access, apart from essay questions which require the student to upload a file.
* Quizzes using additional plugins won't work in the app unless the plugin include support for mobile remote add-ons (see in the dev docs [[:dev:Moodle Mobile Remote add-ons|Moodle Mobile Remote add-ons]]).
* Quizzes requiring safe browser are not supported.
* Quizzes including blocked questions (questions that require that the previous question has been answered) are not supported.

== Requirements ==

Moodle Mobile quiz requires Moodle 3.1 onwards.

Alternatively, it may be used with sites running Moodle 2.6 to Moodle 3.0 if the [[Moodle Mobile additional features]] plugin is installed.

If you have quizzes with questions using TeX / MathJAX you must enable the [[TeX notation filter]] enabling all the LaTeX renderer settings. Please note that equations are rendered using LaTeX.

==See also==

* [[Moodle Mobile quiz offline attempts]] for details of how to enable students to download and attempt quizzes offline

[[Category:Quiz]]

[[es:Módulo de Examen Moodle Mobile]]
[[de:Moodle App - Tests]]

Box repository

2019-04-02T08:53:16Z

Ghillenb: /* Capabilities */

{{Repositories}}

The Box repository enables users to copy files from Box into Moodle.

In order to use the Box repository, your Moodle site must use HTTPS. In addition, an administrator must obtain a Box client ID and secret. The client ID and secret can then be used to configure all Box plugins.

==Obtaining a Box client ID and secret==
#Go to https://app.box.com and create an account or log in
#Go to https://app.box.com/developers/services and click the link 'Create new application'
#Select 'Custom app' and click 'Next'
#Select 'Standard OAuth 2.0 (User Authentication)' and click 'Next'
#Click 'View Your App'
#Enter an application name
#Edit 'Redirect URI' on the OAuth 2.0 Redirect URI section and write http://yourmoodleserver/admin/oauth2callback.php
#Click 'Save Changes' button
#On to the section 'OAuth 2.0 Credentials' make a note of the client ID and secret
#The client ID and secret can then be used to configure the Box repository and Box portfolio.

The client ID and secret can then be used to configure the Box repository and Box portfolio.

==Enabling the Box repository==

# Go to ''Administration > Site administration > Plugins > Repositories > Manage Repositories''
# Reactivate the Box.net repository by selecting 'Enabled and visible' in the dropdown menu
# Configure the repository plugin by entering the Box client ID and secret. Make sure you don't include any white space in the text boxes!
# Save changes

==Enabling the Box portfolio==

# Go to ''Administration > Site administration > Plugins > Portfolios > Manage Portfolios''
# Reactivate the Box.net portfolio by selecting 'Enabled and visible' in the dropdown menu
# Configure the portfolio plugin by entering the Box client ID and secret
# Save changes

==Capabilities==

There is just one capability, [[Capabilities/repository/boxnet:view|View box.net repository]], which is allowed for the default authenticated user role.

[[eu:Box.net_ezarpenak]]
[[de:Box Repository]]
[[es:Repositorio Box.net]]

Remote RSS feeds block

2019-04-02T08:17:37Z

Ghillenb: /* See also */

{{Blocks}}The '''RSS feeds''' block enables [[RSS]] feeds from external websites to be displayed within Moodle. As the information on the other site (for example, news headlines or recently added documents) is changed the block will update to show the latest information.

[[File:Rssexample.png]]

One or more RSS feeds can be added to a course by selecting them from an existing list. Site and course home pages are common places to place an RSS feed block(s).

==Configuring RSS feeds block==

After adding an RSS feed block, select the edit icon on the Remote News Feed block. The default will open up the '''Configure this block''' tab.

;Display each link's description?
:Choose yes or no from the drop-down menu to determine whether the block will display a description of each article, or just the title of the article. Both the title and description are generated by the external feed.

;Max number of entries to show per block
:Determines how many articles will be displayed. The most recent will be displayed first.

;Choose the feeds to make available
:Check the box next to each feed you would displayed in this block. You can have more than one instance of the RSS feed block if you would like to break them up.

;Title
:Enter a title for the block. If you leave this blank a title will be taken from the RSS feeds, which can be confusing if there are multiple feeds in one block.

;Display a link?
:Each article headline should link to the full article, but you can also display a link to the original site where available.

;Show channel image?
:Some feeds supply an image or logo from the original site which you can choose to display when available.

==Add/Manage all RSS feeds ==
All the Moodle site's RSS feeds can be managed on the ''Manage all my feeds'' tab in the RSS News Feed edit menu. The site administrator may give other roles permission to use this tab. This tab creates a list of RSS feeds that can be selected for display in every course on the Moodle site.

Copy and paste (or type) the URL address of the RSS feed in the space provided. This the generating site's actual RSS page address. For example here is a Moodle RSS feed address : http://moodle.org/rss/file.php/1/1/forum/1/rss.xml

Adding a custom title will take the place of the one supplied by the generating site.There is a validation tool included to confirm the feed URL is accurate.

When checked, the Shared Feed checkbox makes the feed available (although not necessarily visible) to all courses on the Moodle site. This would be useful, for example, when a college has an urgent announcements feed that would be of interest to all students, regardless of the Moodle course in which they are enrolled. Leave unchecked if the feed is of interest only to a single course.

Click the ''Add'' button to submit the feed.

==Site administration settings==

The RSS feeds block has some settings which may be changed by an administrator in ''Settings > Site administration > Plugins > Blocks > RSS client''.

* ''block_rss_client_num_entries'' - The default number of entries to show per feed shown in the block. This can be overridden when you actually set up a block in a course.
* ''block_rss_timeout'' - The time in minutes between a reread of the feed by Moodle. Since some feeds on busy sites can take long to load, it can slow down the load of your course page. Therefore it is wise to set this time rather high, so only every now and then a visitor of your course is the victim of the slow remote server. Time is in minutes here.

==See also==

* [[RSS feeds]]
*[http://www.youtube.com/watch?v=wiwSZNgXuzo RSS feeds and how to add them to your course video]
*[http://tracker.moodle.org/browse/MDL-31599 RSS feeds on front page not working]

[[Category:RSS]]
[[Category:Site administration]]

[[de:RSS Feeds Block]]
[[eu:RSS_jarioak_blokea]]
[[fr:Bloc Fil RSS]]
[[es:Bloque de canales RSS remotos]]