MoodleDocs - User contributions [en]

Completion Progress block

2016-08-19T22:16:56Z

Deraadt: /* Installation */

{{Infobox plugin
|type = Block, Completion Progress
|entry = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|tracker = https://tracker.moodle.org/issues/?jql=project%20%3D%20CONTRIB%20AND%20component%20%3D%20%22Block%3A%20Completion%20Progress%22
|discussion = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|maintainer = [[User:Michael de Raadt|Michael de Raadt]]
|float = right
}}
[[Blocks|Back to Blocks page]]

== Features ==

[[Image:Completion_Progress_bar_in_block_-_with_details.png|A progress bar for a student]]

* The Completion Progress is a time-management tool for students.
* It visually shows what activities/resources a student is supposed to interact with in a course.
* It is colour-coded so students can quickly see what they have and have not completed/viewed.
* The block relies on completion settings of activities/resources in the course and when they should be completed by.
* Ordering can be based on expected completion times or on the ordering of activities in the course.
* There is an Overview page allowing teachers to see the progress of all students in a class, which is helpful for finding students at risk.
* Adding the Completion Progress block to the [[Dashboard]] shows users a combined view of their progress from all courses they are enrolled in (where the block is set up).

[[Image:Completion_Progress_Overview_of_students_with_messaging.png|right|thumb|The overview page]]

== Installation ==

* Download the latest version of the block from [https://moodle.org/plugins/block_completion_progress its entry on the Plugins directory] or using its [https://github.com/deraadt/moodle-block_completion_progress Git repository].
* The Completion Progress block is added like other blocks ([[Installing_contributed_modules_or_plugins|How to install a block]]).
* In Moodle versions prior to 3.1, [[Activity completion]] needs to be enabled.

== Global settings ==

The Completion Progress block has a number of global settings that will be seen on installation and can be accessed later at Site administration > Plugins > Blocks > Completion Progress.
[[Image:Completion_Progress_Global_settings.png|thumb|Global settings]]
* ''When wrapping, limit rows to...'' The progress bar shown in the block can be wrapped. This setting allows some control of how long the bar should be before wrapping. The default is 16.
* ''Default presentation for long bars'' The bar can be displayed by squeezing all segments, wrapping segments over multiple lines or allowing the bar to scroll. The default is to Squeeze.
* ''Course name to show on Dashboard'' The block can be added to the dashboard and combines visible Completion Progress block content from the courses a user is enrolled in. By default, the course name shown for each relevant course, is the short course name, but some institutions/organisations may not think this is appropriate in relation to their course naming scheme, so a long course name can be selected.
* ''Colours'' By default, the colours used in the block are red, blue and green. In certain cultures these colours may not have the same meaning. Also, institutions/organisations may wish to use colours that match their theme.
* ''Show inactive students in Overview'' In most cases, inactive students are not wanted in course lists, such as the Overview page associated with the block. However, in some cases, such as ongoing courses, inactive students might need to be visible on the Overview page.

== Capabilities (Controlling who sees parts of the block) ==

The block uses a number of capabilities that are added when the block is installed.

[[Image:Completion_Progress_Capabilities.png|thumb|Capabilities]]

* ''Add a Completion Progress block to My home'' (block/completion_progress:myaddinstance) Controls whether the Completion Progress block can be added by a user to the Dashboard (formerly My home) page. By default, this is allowed for all authenticated users.
* ''Add a new Completion Progress block'' (block/completion_progress:addinstance) Controls whether the Completion Progress block can be added to a course page. By default, this is allowed for the following archetypal roles.
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''View course overview of Completion Progress for all students'' (block/completion_progress:overview) Controls whether the Overview page and the button on the Completion Progress block used to access the Overview page can be viewed by a user. By default, this is allowed for the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''Show the bar in the Completion Progress block'' (block/completion_progress:showbar) Controls whether the bar in the Completion Progress block is shown to a user. The reason for not showing this to certain users is that this might not be relevant and possibly annoying. By default, this is shown to the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Student (student)
** (and Admins)

== Setting up a Completion Progress block in a course ==

In Moodle versions prior to 3.1, [[Activity completion]] needs to be enabled.

Once the block is installed on your site, you can use it in a course as follows.
# Turn editing on
# Create your activities/resources as normal
# Set completion settings for each activity you want to appear in the bar, including an expected by date
# Add the Completion Progress block to your page ([[Blocks|How to add a block]])
# Move your block into a prominent position (click and drag the block title)
# Choose to:
#(Optional) Configure how the block should appear

Hidden items will not appear in the Completion Progress block until they are unhidden. This is useful for a scheduled release of activities.

== Links ==

* [http://moodle.org/plugins/view.php?plugin=block_completion_progress Block in Plugins Directory]
* [https://tracker.moodle.org/issues/?jql=project%20%3D%20CONTRIB%20AND%20component%20%3D%20%22Block%3A%20Completion%20Progress%22 Bug Tracker Page] (Please report bugs here.)
* [https://github.com/deraadt/moodle-block_completion_progress Git repository]

[[Category:Contributed code]]
[[Category:Block]]

[[es:Bloque de Progreso de Finalización]]

Completion Progress block

2016-08-19T22:16:12Z

Deraadt: Add links in install instructions

{{Infobox plugin
|type = Block, Completion Progress
|entry = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|tracker = https://tracker.moodle.org/issues/?jql=project%20%3D%20CONTRIB%20AND%20component%20%3D%20%22Block%3A%20Completion%20Progress%22
|discussion = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|maintainer = [[User:Michael de Raadt|Michael de Raadt]]
|float = right
}}
[[Blocks|Back to Blocks page]]

== Features ==

[[Image:Completion_Progress_bar_in_block_-_with_details.png|A progress bar for a student]]

* The Completion Progress is a time-management tool for students.
* It visually shows what activities/resources a student is supposed to interact with in a course.
* It is colour-coded so students can quickly see what they have and have not completed/viewed.
* The block relies on completion settings of activities/resources in the course and when they should be completed by.
* Ordering can be based on expected completion times or on the ordering of activities in the course.
* There is an Overview page allowing teachers to see the progress of all students in a class, which is helpful for finding students at risk.
* Adding the Completion Progress block to the [[Dashboard]] shows users a combined view of their progress from all courses they are enrolled in (where the block is set up).

[[Image:Completion_Progress_Overview_of_students_with_messaging.png|right|thumb|The overview page]]

== Installation ==

* Grab the latest version of the block from [https://moodle.org/plugins/block_completion_progress its entry on the Plugins directory] or using its [https://github.com/deraadt/moodle-block_completion_progress Git repository].
* The Completion Progress block is added like other blocks ([[Installing_contributed_modules_or_plugins|How to install a block]]).
* In Moodle versions prior to 3.1, [[Activity completion]] needs to be enabled.

== Global settings ==

The Completion Progress block has a number of global settings that will be seen on installation and can be accessed later at Site administration > Plugins > Blocks > Completion Progress.
[[Image:Completion_Progress_Global_settings.png|thumb|Global settings]]
* ''When wrapping, limit rows to...'' The progress bar shown in the block can be wrapped. This setting allows some control of how long the bar should be before wrapping. The default is 16.
* ''Default presentation for long bars'' The bar can be displayed by squeezing all segments, wrapping segments over multiple lines or allowing the bar to scroll. The default is to Squeeze.
* ''Course name to show on Dashboard'' The block can be added to the dashboard and combines visible Completion Progress block content from the courses a user is enrolled in. By default, the course name shown for each relevant course, is the short course name, but some institutions/organisations may not think this is appropriate in relation to their course naming scheme, so a long course name can be selected.
* ''Colours'' By default, the colours used in the block are red, blue and green. In certain cultures these colours may not have the same meaning. Also, institutions/organisations may wish to use colours that match their theme.
* ''Show inactive students in Overview'' In most cases, inactive students are not wanted in course lists, such as the Overview page associated with the block. However, in some cases, such as ongoing courses, inactive students might need to be visible on the Overview page.

== Capabilities (Controlling who sees parts of the block) ==

The block uses a number of capabilities that are added when the block is installed.

[[Image:Completion_Progress_Capabilities.png|thumb|Capabilities]]

* ''Add a Completion Progress block to My home'' (block/completion_progress:myaddinstance) Controls whether the Completion Progress block can be added by a user to the Dashboard (formerly My home) page. By default, this is allowed for all authenticated users.
* ''Add a new Completion Progress block'' (block/completion_progress:addinstance) Controls whether the Completion Progress block can be added to a course page. By default, this is allowed for the following archetypal roles.
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''View course overview of Completion Progress for all students'' (block/completion_progress:overview) Controls whether the Overview page and the button on the Completion Progress block used to access the Overview page can be viewed by a user. By default, this is allowed for the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''Show the bar in the Completion Progress block'' (block/completion_progress:showbar) Controls whether the bar in the Completion Progress block is shown to a user. The reason for not showing this to certain users is that this might not be relevant and possibly annoying. By default, this is shown to the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Student (student)
** (and Admins)

== Setting up a Completion Progress block in a course ==

In Moodle versions prior to 3.1, [[Activity completion]] needs to be enabled.

Once the block is installed on your site, you can use it in a course as follows.
# Turn editing on
# Create your activities/resources as normal
# Set completion settings for each activity you want to appear in the bar, including an expected by date
# Add the Completion Progress block to your page ([[Blocks|How to add a block]])
# Move your block into a prominent position (click and drag the block title)
# Choose to:
#(Optional) Configure how the block should appear

Hidden items will not appear in the Completion Progress block until they are unhidden. This is useful for a scheduled release of activities.

== Links ==

* [http://moodle.org/plugins/view.php?plugin=block_completion_progress Block in Plugins Directory]
* [https://tracker.moodle.org/issues/?jql=project%20%3D%20CONTRIB%20AND%20component%20%3D%20%22Block%3A%20Completion%20Progress%22 Bug Tracker Page] (Please report bugs here.)
* [https://github.com/deraadt/moodle-block_completion_progress Git repository]

[[Category:Contributed code]]
[[Category:Block]]

[[es:Bloque de Progreso de Finalización]]

Completion Progress block

2016-08-18T11:34:06Z

Deraadt:

{{Infobox plugin
|type = Block, Completion Progress
|entry = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|tracker = https://tracker.moodle.org/issues/?jql=project%20%3D%20CONTRIB%20AND%20component%20%3D%20%22Block%3A%20Completion%20Progress%22
|discussion = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|maintainer = [[User:Michael de Raadt|Michael de Raadt]]
|float = right
}}
[[Blocks|Back to Blocks page]]

== Features ==

[[Image:Completion_Progress_bar_in_block_-_with_details.png|A progress bar for a student]]

* The Completion Progress is a time-management tool for students.
* It visually shows what activities/resources a student is supposed to interact with in a course.
* It is colour-coded so students can quickly see what they have and have not completed/viewed.
* The block relies on completion settings of activities/resources in the course and when they should be completed by.
* Ordering can be based on expected completion times or on the ordering of activities in the course.
* There is an Overview page allowing teachers to see the progress of all students in a class, which is helpful for finding students at risk.
* Adding the Completion Progress block to the [[Dashboard]] shows users a combined view of their progress from all courses they are enrolled in (where the block is set up).

[[Image:Completion_Progress_Overview_of_students_with_messaging.png|right|thumb|The overview page]]

== Installation ==

* The Completion Progress block is added like other blocks ([[Installing_contributed_modules_or_plugins|How to install a block]]).
* In Moodle versions prior to 3.1, [[Activity completion]] needs to be enabled.

== Global settings ==

The Completion Progress block has a number of global settings that will be seen on installation and can be accessed later at Site administration > Plugins > Blocks > Completion Progress.
[[Image:Completion_Progress_Global_settings.png|thumb|Global settings]]
* ''When wrapping, limit rows to...'' The progress bar shown in the block can be wrapped. This setting allows some control of how long the bar should be before wrapping. The default is 16.
* ''Default presentation for long bars'' The bar can be displayed by squeezing all segments, wrapping segments over multiple lines or allowing the bar to scroll. The default is to Squeeze.
* ''Course name to show on Dashboard'' The block can be added to the dashboard and combines visible Completion Progress block content from the courses a user is enrolled in. By default, the course name shown for each relevant course, is the short course name, but some institutions/organisations may not think this is appropriate in relation to their course naming scheme, so a long course name can be selected.
* ''Colours'' By default, the colours used in the block are red, blue and green. In certain cultures these colours may not have the same meaning. Also, institutions/organisations may wish to use colours that match their theme.
* ''Show inactive students in Overview'' In most cases, inactive students are not wanted in course lists, such as the Overview page associated with the block. However, in some cases, such as ongoing courses, inactive students might need to be visible on the Overview page.

== Capabilities (Controlling who sees parts of the block) ==

The block uses a number of capabilities that are added when the block is installed.

[[Image:Completion_Progress_Capabilities.png|thumb|Capabilities]]

* ''Add a Completion Progress block to My home'' (block/completion_progress:myaddinstance) Controls whether the Completion Progress block can be added by a user to the Dashboard (formerly My home) page. By default, this is allowed for all authenticated users.
* ''Add a new Completion Progress block'' (block/completion_progress:addinstance) Controls whether the Completion Progress block can be added to a course page. By default, this is allowed for the following archetypal roles.
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''View course overview of Completion Progress for all students'' (block/completion_progress:overview) Controls whether the Overview page and the button on the Completion Progress block used to access the Overview page can be viewed by a user. By default, this is allowed for the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''Show the bar in the Completion Progress block'' (block/completion_progress:showbar) Controls whether the bar in the Completion Progress block is shown to a user. The reason for not showing this to certain users is that this might not be relevant and possibly annoying. By default, this is shown to the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Student (student)
** (and Admins)

== Setting up a Completion Progress block in a course ==

In Moodle versions prior to 3.1, [[Activity completion]] needs to be enabled.

Once the block is installed on your site, you can use it in a course as follows.
# Turn editing on
# Create your activities/resources as normal
# Set completion settings for each activity you want to appear in the bar, including an expected by date
# Add the Completion Progress block to your page ([[Blocks|How to add a block]])
# Move your block into a prominent position (click and drag the block title)
# Choose to:
#(Optional) Configure how the block should appear

Hidden items will not appear in the Completion Progress block until they are unhidden. This is useful for a scheduled release of activities.

== Links ==

* [http://moodle.org/plugins/view.php?plugin=block_completion_progress Block in Plugins Directory]
* [https://tracker.moodle.org/issues/?jql=project%20%3D%20CONTRIB%20AND%20component%20%3D%20%22Block%3A%20Completion%20Progress%22 Bug Tracker Page] (Please report bugs here.)
* [https://github.com/deraadt/moodle-block_completion_progress Git repository]

[[Category:Contributed code]]
[[Category:Block]]

[[es:Bloque de Progreso de Finalización]]

Completion Progress block

2016-08-18T11:33:07Z

Deraadt: Fixing tracker link

{{Infobox plugin
|type = Block, Completion Progress
|entry = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|tracker = https://tracker.moodle.org/browse/CONTRIB/component/XXX/?selectedTab=com.atlassian.jira.jira-projects-plugin:component-summary-panel
|discussion = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|maintainer = [[User:Michael de Raadt|Michael de Raadt]]
|float = right
}}
[[Blocks|Back to Blocks page]]

== Features ==

[[Image:Completion_Progress_bar_in_block_-_with_details.png|A progress bar for a student]]

* The Completion Progress is a time-management tool for students.
* It visually shows what activities/resources a student is supposed to interact with in a course.
* It is colour-coded so students can quickly see what they have and have not completed/viewed.
* The block relies on completion settings of activities/resources in the course and when they should be completed by.
* Ordering can be based on expected completion times or on the ordering of activities in the course.
* There is an Overview page allowing teachers to see the progress of all students in a class, which is helpful for finding students at risk.
* Adding the Completion Progress block to the [[Dashboard]] shows users a combined view of their progress from all courses they are enrolled in (where the block is set up).

[[Image:Completion_Progress_Overview_of_students_with_messaging.png|right|thumb|The overview page]]

== Installation ==

* The Completion Progress block is added like other blocks ([[Installing_contributed_modules_or_plugins|How to install a block]]).
* In Moodle versions prior to 3.1, [[Activity completion]] needs to be enabled.

== Global settings ==

The Completion Progress block has a number of global settings that will be seen on installation and can be accessed later at Site administration > Plugins > Blocks > Completion Progress.
[[Image:Completion_Progress_Global_settings.png|thumb|Global settings]]
* ''When wrapping, limit rows to...'' The progress bar shown in the block can be wrapped. This setting allows some control of how long the bar should be before wrapping. The default is 16.
* ''Default presentation for long bars'' The bar can be displayed by squeezing all segments, wrapping segments over multiple lines or allowing the bar to scroll. The default is to Squeeze.
* ''Course name to show on Dashboard'' The block can be added to the dashboard and combines visible Completion Progress block content from the courses a user is enrolled in. By default, the course name shown for each relevant course, is the short course name, but some institutions/organisations may not think this is appropriate in relation to their course naming scheme, so a long course name can be selected.
* ''Colours'' By default, the colours used in the block are red, blue and green. In certain cultures these colours may not have the same meaning. Also, institutions/organisations may wish to use colours that match their theme.
* ''Show inactive students in Overview'' In most cases, inactive students are not wanted in course lists, such as the Overview page associated with the block. However, in some cases, such as ongoing courses, inactive students might need to be visible on the Overview page.

== Capabilities (Controlling who sees parts of the block) ==

The block uses a number of capabilities that are added when the block is installed.

[[Image:Completion_Progress_Capabilities.png|thumb|Capabilities]]

* ''Add a Completion Progress block to My home'' (block/completion_progress:myaddinstance) Controls whether the Completion Progress block can be added by a user to the Dashboard (formerly My home) page. By default, this is allowed for all authenticated users.
* ''Add a new Completion Progress block'' (block/completion_progress:addinstance) Controls whether the Completion Progress block can be added to a course page. By default, this is allowed for the following archetypal roles.
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''View course overview of Completion Progress for all students'' (block/completion_progress:overview) Controls whether the Overview page and the button on the Completion Progress block used to access the Overview page can be viewed by a user. By default, this is allowed for the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''Show the bar in the Completion Progress block'' (block/completion_progress:showbar) Controls whether the bar in the Completion Progress block is shown to a user. The reason for not showing this to certain users is that this might not be relevant and possibly annoying. By default, this is shown to the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Student (student)
** (and Admins)

== Setting up a Completion Progress block in a course ==

In Moodle versions prior to 3.1, [[Activity completion]] needs to be enabled.

Once the block is installed on your site, you can use it in a course as follows.
# Turn editing on
# Create your activities/resources as normal
# Set completion settings for each activity you want to appear in the bar, including an expected by date
# Add the Completion Progress block to your page ([[Blocks|How to add a block]])
# Move your block into a prominent position (click and drag the block title)
# Choose to:
#(Optional) Configure how the block should appear

Hidden items will not appear in the Completion Progress block until they are unhidden. This is useful for a scheduled release of activities.

== Links ==

* [http://moodle.org/plugins/view.php?plugin=block_completion_progress Block in Plugins Directory]
* [https://tracker.moodle.org/issues/?jql=project%20%3D%20CONTRIB%20AND%20component%20%3D%20%22Block%3A%20Completion%20Progress%22 Bug Tracker Page] (Please report bugs here.)
* [https://github.com/deraadt/moodle-block_completion_progress Git repository]

[[Category:Contributed code]]
[[Category:Block]]

[[es:Bloque de Progreso de Finalización]]

Completion Progress block

2016-08-18T11:30:19Z

Deraadt: /* Capabilities (Controlling who sees parts of the block) */

{{Infobox plugin
|type = Block, Completion Progress
|entry = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|tracker = https://tracker.moodle.org/browse/CONTRIB/component/XXX/?selectedTab=com.atlassian.jira.jira-projects-plugin:component-summary-panel
|discussion = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|maintainer = [[User:Michael de Raadt|Michael de Raadt]]
|float = right
}}
[[Blocks|Back to Blocks page]]

== Features ==

[[Image:Completion_Progress_bar_in_block_-_with_details.png|right|A progress bar for a student]]

* The Completion Progress is a time-management tool for students.
* It visually shows what activities/resources a student is supposed to interact with in a course.
* It is colour-coded so students can quickly see what they have and have not completed/viewed.
* The block relies on completion settings of activities/resources in the course and when they should be completed by.
* Ordering can be based on expected completion times or on the ordering of activities in the course.
* There is an Overview page allowing teachers to see the progress of all students in a class, which is helpful for finding students at risk.
* Adding the Completion Progress block to the [[Dashboard]] shows users a combined view of their progress from all courses they are enrolled in (where the block is set up).

[[Image:Completion_Progress_Overview_of_students_with_messaging.png|right|thumb|The overview page]]

== Installation ==

* The Completion Progress block is added like other blocks ([[Installing_contributed_modules_or_plugins|How to install a block]]).
* In Moodle versions prior to 3.1, [[Activity completion]] needs to be enabled.

== Global settings ==

The Completion Progress block has a number of global settings that will be seen on installation and can be accessed later at Site administration > Plugins > Blocks > Completion Progress.
[[Image:Completion_Progress_Global_settings.png|thumb|Global settings]]
* ''When wrapping, limit rows to...'' The progress bar shown in the block can be wrapped. This setting allows some control of how long the bar should be before wrapping. The default is 16.
* ''Default presentation for long bars'' The bar can be displayed by squeezing all segments, wrapping segments over multiple lines or allowing the bar to scroll. The default is to Squeeze.
* ''Course name to show on Dashboard'' The block can be added to the dashboard and combines visible Completion Progress block content from the courses a user is enrolled in. By default, the course name shown for each relevant course, is the short course name, but some institutions/organisations may not think this is appropriate in relation to their course naming scheme, so a long course name can be selected.
* ''Colours'' By default, the colours used in the block are red, blue and green. In certain cultures these colours may not have the same meaning. Also, institutions/organisations may wish to use colours that match their theme.
* ''Show inactive students in Overview'' In most cases, inactive students are not wanted in course lists, such as the Overview page associated with the block. However, in some cases, such as ongoing courses, inactive students might need to be visible on the Overview page.

== Capabilities (Controlling who sees parts of the block) ==

The block uses a number of capabilities that are added when the block is installed.

[[Image:Completion_Progress_Capabilities.png|thumb|Capabilities]]

* ''Add a Completion Progress block to My home'' (block/completion_progress:myaddinstance) Controls whether the Completion Progress block can be added by a user to the Dashboard (formerly My home) page. By default, this is allowed for all authenticated users.
* ''Add a new Completion Progress block'' (block/completion_progress:addinstance) Controls whether the Completion Progress block can be added to a course page. By default, this is allowed for the following archetypal roles.
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''View course overview of Completion Progress for all students'' (block/completion_progress:overview) Controls whether the Overview page and the button on the Completion Progress block used to access the Overview page can be viewed by a user. By default, this is allowed for the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''Show the bar in the Completion Progress block'' (block/completion_progress:showbar) Controls whether the bar in the Completion Progress block is shown to a user. The reason for not showing this to certain users is that this might not be relevant and possibly annoying. By default, this is shown to the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Student (student)
** (and Admins)

== Setting up a Completion Progress block in a course ==

In Moodle versions prior to 3.1, [[Activity completion]] needs to be enabled.

Once the block is installed on your site, you can use it in a course as follows.
# Turn editing on
# Create your activities/resources as normal
# Set completion settings for each activity you want to appear in the bar, including an expected by date
# Add the Completion Progress block to your page ([[Blocks|How to add a block]])
# Move your block into a prominent position (click and drag the block title)
# Choose to:
#(Optional) Configure how the block should appear

Hidden items will not appear in the Completion Progress block until they are unhidden. This is useful for a scheduled release of activities.

== Links ==

* [http://moodle.org/plugins/view.php?plugin=block_completion_progress Block in Plugins repository]
* [http://tracker.moodle.org/browse/CONTRIB/component/XXX Bug Tracker Page] (Please report bugs here.)
* [https://github.com/deraadt/moodle-block_completion_progress Git repository]

[[Category:Contributed code]]
[[Category:Block]]

[[es:Bloque de Progreso de Finalización]]

Completion Progress block

2016-08-18T11:29:53Z

Deraadt: Fixing image label

{{Infobox plugin
|type = Block, Completion Progress
|entry = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|tracker = https://tracker.moodle.org/browse/CONTRIB/component/XXX/?selectedTab=com.atlassian.jira.jira-projects-plugin:component-summary-panel
|discussion = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|maintainer = [[User:Michael de Raadt|Michael de Raadt]]
|float = right
}}
[[Blocks|Back to Blocks page]]

== Features ==

[[Image:Completion_Progress_bar_in_block_-_with_details.png|right|A progress bar for a student]]

* The Completion Progress is a time-management tool for students.
* It visually shows what activities/resources a student is supposed to interact with in a course.
* It is colour-coded so students can quickly see what they have and have not completed/viewed.
* The block relies on completion settings of activities/resources in the course and when they should be completed by.
* Ordering can be based on expected completion times or on the ordering of activities in the course.
* There is an Overview page allowing teachers to see the progress of all students in a class, which is helpful for finding students at risk.
* Adding the Completion Progress block to the [[Dashboard]] shows users a combined view of their progress from all courses they are enrolled in (where the block is set up).

[[Image:Completion_Progress_Overview_of_students_with_messaging.png|right|thumb|The overview page]]

== Installation ==

* The Completion Progress block is added like other blocks ([[Installing_contributed_modules_or_plugins|How to install a block]]).
* In Moodle versions prior to 3.1, [[Activity completion]] needs to be enabled.

== Global settings ==

The Completion Progress block has a number of global settings that will be seen on installation and can be accessed later at Site administration > Plugins > Blocks > Completion Progress.
[[Image:Completion_Progress_Global_settings.png|thumb|Global settings]]
* ''When wrapping, limit rows to...'' The progress bar shown in the block can be wrapped. This setting allows some control of how long the bar should be before wrapping. The default is 16.
* ''Default presentation for long bars'' The bar can be displayed by squeezing all segments, wrapping segments over multiple lines or allowing the bar to scroll. The default is to Squeeze.
* ''Course name to show on Dashboard'' The block can be added to the dashboard and combines visible Completion Progress block content from the courses a user is enrolled in. By default, the course name shown for each relevant course, is the short course name, but some institutions/organisations may not think this is appropriate in relation to their course naming scheme, so a long course name can be selected.
* ''Colours'' By default, the colours used in the block are red, blue and green. In certain cultures these colours may not have the same meaning. Also, institutions/organisations may wish to use colours that match their theme.
* ''Show inactive students in Overview'' In most cases, inactive students are not wanted in course lists, such as the Overview page associated with the block. However, in some cases, such as ongoing courses, inactive students might need to be visible on the Overview page.

== Capabilities (Controlling who sees parts of the block) ==

The block uses a number of capabilities that are added when the block is installed.

[[Image:Completion_Progress_Capabilities.png|thumb|Capabilities]

* ''Add a Completion Progress block to My home'' (block/completion_progress:myaddinstance) Controls whether the Completion Progress block can be added by a user to the Dashboard (formerly My home) page. By default, this is allowed for all authenticated users.
* ''Add a new Completion Progress block'' (block/completion_progress:addinstance) Controls whether the Completion Progress block can be added to a course page. By default, this is allowed for the following archetypal roles.
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''View course overview of Completion Progress for all students'' (block/completion_progress:overview) Controls whether the Overview page and the button on the Completion Progress block used to access the Overview page can be viewed by a user. By default, this is allowed for the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''Show the bar in the Completion Progress block'' (block/completion_progress:showbar) Controls whether the bar in the Completion Progress block is shown to a user. The reason for not showing this to certain users is that this might not be relevant and possibly annoying. By default, this is shown to the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Student (student)
** (and Admins)

== Setting up a Completion Progress block in a course ==

In Moodle versions prior to 3.1, [[Activity completion]] needs to be enabled.

Once the block is installed on your site, you can use it in a course as follows.
# Turn editing on
# Create your activities/resources as normal
# Set completion settings for each activity you want to appear in the bar, including an expected by date
# Add the Completion Progress block to your page ([[Blocks|How to add a block]])
# Move your block into a prominent position (click and drag the block title)
# Choose to:
#(Optional) Configure how the block should appear

Hidden items will not appear in the Completion Progress block until they are unhidden. This is useful for a scheduled release of activities.

== Links ==

* [http://moodle.org/plugins/view.php?plugin=block_completion_progress Block in Plugins repository]
* [http://tracker.moodle.org/browse/CONTRIB/component/XXX Bug Tracker Page] (Please report bugs here.)
* [https://github.com/deraadt/moodle-block_completion_progress Git repository]

[[Category:Contributed code]]
[[Category:Block]]

[[es:Bloque de Progreso de Finalización]]

Completion Progress block

2016-08-18T11:29:03Z

Deraadt: Fixing images

{{Infobox plugin
|type = Block, Completion Progress
|entry = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|tracker = https://tracker.moodle.org/browse/CONTRIB/component/XXX/?selectedTab=com.atlassian.jira.jira-projects-plugin:component-summary-panel
|discussion = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|maintainer = [[User:Michael de Raadt|Michael de Raadt]]
|float = right
}}
[[Blocks|Back to Blocks page]]

== Features ==

[[Image:Completion_Progress_bar_in_block_-_with_details.png|right|A progress bar for a student]]

* The Completion Progress is a time-management tool for students.
* It visually shows what activities/resources a student is supposed to interact with in a course.
* It is colour-coded so students can quickly see what they have and have not completed/viewed.
* The block relies on completion settings of activities/resources in the course and when they should be completed by.
* Ordering can be based on expected completion times or on the ordering of activities in the course.
* There is an Overview page allowing teachers to see the progress of all students in a class, which is helpful for finding students at risk.
* Adding the Completion Progress block to the [[Dashboard]] shows users a combined view of their progress from all courses they are enrolled in (where the block is set up).

[[Image:Completion_Progress_Overview_of_students_with_messaging.png|right|thumb|The overview page]]

== Installation ==

* The Completion Progress block is added like other blocks ([[Installing_contributed_modules_or_plugins|How to install a block]]).
* In Moodle versions prior to 3.1, [[Activity completion]] needs to be enabled.

== Global settings ==

The Completion Progress block has a number of global settings that will be seen on installation and can be accessed later at Site administration > Plugins > Blocks > Completion Progress.
[[Image:Completion_Progress_Global_settings.png|thumb|Global settings]]
* ''When wrapping, limit rows to...'' The progress bar shown in the block can be wrapped. This setting allows some control of how long the bar should be before wrapping. The default is 16.
* ''Default presentation for long bars'' The bar can be displayed by squeezing all segments, wrapping segments over multiple lines or allowing the bar to scroll. The default is to Squeeze.
* ''Course name to show on Dashboard'' The block can be added to the dashboard and combines visible Completion Progress block content from the courses a user is enrolled in. By default, the course name shown for each relevant course, is the short course name, but some institutions/organisations may not think this is appropriate in relation to their course naming scheme, so a long course name can be selected.
* ''Colours'' By default, the colours used in the block are red, blue and green. In certain cultures these colours may not have the same meaning. Also, institutions/organisations may wish to use colours that match their theme.
* ''Show inactive students in Overview'' In most cases, inactive students are not wanted in course lists, such as the Overview page associated with the block. However, in some cases, such as ongoing courses, inactive students might need to be visible on the Overview page.

== Capabilities (Controlling who sees parts of the block) ==

The block uses a number of capabilities that are added when the block is installed.
[[Image:Completion_Progress_Capabilities.png|thumb|Global settings]]
* ''Add a Completion Progress block to My home'' (block/completion_progress:myaddinstance) Controls whether the Completion Progress block can be added by a user to the Dashboard (formerly My home) page. By default, this is allowed for all authenticated users.
* ''Add a new Completion Progress block'' (block/completion_progress:addinstance) Controls whether the Completion Progress block can be added to a course page. By default, this is allowed for the following archetypal roles.
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''View course overview of Completion Progress for all students'' (block/completion_progress:overview) Controls whether the Overview page and the button on the Completion Progress block used to access the Overview page can be viewed by a user. By default, this is allowed for the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''Show the bar in the Completion Progress block'' (block/completion_progress:showbar) Controls whether the bar in the Completion Progress block is shown to a user. The reason for not showing this to certain users is that this might not be relevant and possibly annoying. By default, this is shown to the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Student (student)
** (and Admins)

== Setting up a Completion Progress block in a course ==

In Moodle versions prior to 3.1, [[Activity completion]] needs to be enabled.

Once the block is installed on your site, you can use it in a course as follows.
# Turn editing on
# Create your activities/resources as normal
# Set completion settings for each activity you want to appear in the bar, including an expected by date
# Add the Completion Progress block to your page ([[Blocks|How to add a block]])
# Move your block into a prominent position (click and drag the block title)
# Choose to:
#(Optional) Configure how the block should appear

Hidden items will not appear in the Completion Progress block until they are unhidden. This is useful for a scheduled release of activities.

== Links ==

* [http://moodle.org/plugins/view.php?plugin=block_completion_progress Block in Plugins repository]
* [http://tracker.moodle.org/browse/CONTRIB/component/XXX Bug Tracker Page] (Please report bugs here.)
* [https://github.com/deraadt/moodle-block_completion_progress Git repository]

[[Category:Contributed code]]
[[Category:Block]]

[[es:Bloque de Progreso de Finalización]]

Completion Progress block

2016-08-18T11:27:08Z

Deraadt: Note about activity completion.

{{Infobox plugin
|type = Block, Completion Progress
|entry = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|tracker = https://tracker.moodle.org/browse/CONTRIB/component/XXX/?selectedTab=com.atlassian.jira.jira-projects-plugin:component-summary-panel
|discussion = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|maintainer = [[User:Michael de Raadt|Michael de Raadt]]
|float = right
}}
[[Blocks|Back to Blocks page]]

== Features ==

[[Image:Completion_Progress_bar_in_block_-_with_details.png|right|A progress bar for a student]]
* The Completion Progress is a time-management tool for students.
* It visually shows what activities/resources a student is supposed to interact with in a course.
* It is colour-coded so students can quickly see what they have and have not completed/viewed.
* The block relies on completion settings of activities/resources in the course and when they should be completed by.
* Ordering can be based on expected completion times or on the ordering of activities in the course.
* There is an Overview page allowing teachers to see the progress of all students in a class, which is helpful for finding students at risk.
* Adding the Completion Progress block to the [[Dashboard]] shows users a combined view of their progress from all courses they are enrolled in (where the block is set up).
[[Image:Completion_Progress_Overview_of_students_with_messaging.png|The overview page]]

== Installation ==

* The Completion Progress block is added like other blocks ([[Installing_contributed_modules_or_plugins|How to install a block]]).
* In Moodle versions prior to 3.1, [[Activity completion]] needs to be enabled.

== Global settings ==

The Completion Progress block has a number of global settings that will be seen on installation and can be accessed later at Site administration > Plugins > Blocks > Completion Progress.
[[Image:Completion_Progress_Global_settings.png|thumb|Global settings]]
* ''When wrapping, limit rows to...'' The progress bar shown in the block can be wrapped. This setting allows some control of how long the bar should be before wrapping. The default is 16.
* ''Default presentation for long bars'' The bar can be displayed by squeezing all segments, wrapping segments over multiple lines or allowing the bar to scroll. The default is to Squeeze.
* ''Course name to show on Dashboard'' The block can be added to the dashboard and combines visible Completion Progress block content from the courses a user is enrolled in. By default, the course name shown for each relevant course, is the short course name, but some institutions/organisations may not think this is appropriate in relation to their course naming scheme, so a long course name can be selected.
* ''Colours'' By default, the colours used in the block are red, blue and green. In certain cultures these colours may not have the same meaning. Also, institutions/organisations may wish to use colours that match their theme.
* ''Show inactive students in Overview'' In most cases, inactive students are not wanted in course lists, such as the Overview page associated with the block. However, in some cases, such as ongoing courses, inactive students might need to be visible on the Overview page.

== Capabilities (Controlling who sees parts of the block) ==

The block uses a number of capabilities that are added when the block is installed.
[[Image:Completion_Progress_Capabilities.png|thumb|Global settings]]
* ''Add a Completion Progress block to My home'' (block/completion_progress:myaddinstance) Controls whether the Completion Progress block can be added by a user to the Dashboard (formerly My home) page. By default, this is allowed for all authenticated users.
* ''Add a new Completion Progress block'' (block/completion_progress:addinstance) Controls whether the Completion Progress block can be added to a course page. By default, this is allowed for the following archetypal roles.
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''View course overview of Completion Progress for all students'' (block/completion_progress:overview) Controls whether the Overview page and the button on the Completion Progress block used to access the Overview page can be viewed by a user. By default, this is allowed for the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''Show the bar in the Completion Progress block'' (block/completion_progress:showbar) Controls whether the bar in the Completion Progress block is shown to a user. The reason for not showing this to certain users is that this might not be relevant and possibly annoying. By default, this is shown to the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Student (student)
** (and Admins)

== Setting up a Completion Progress block in a course ==

In Moodle versions prior to 3.1, [[Activity completion]] needs to be enabled.

Once the block is installed on your site, you can use it in a course as follows.
# Turn editing on
# Create your activities/resources as normal
# Set completion settings for each activity you want to appear in the bar, including an expected by date
# Add the Completion Progress block to your page ([[Blocks|How to add a block]])
# Move your block into a prominent position (click and drag the block title)
# Choose to:
#(Optional) Configure how the block should appear

Hidden items will not appear in the Completion Progress block until they are unhidden. This is useful for a scheduled release of activities.

== Links ==

* [http://moodle.org/plugins/view.php?plugin=block_completion_progress Block in Plugins repository]
* [http://tracker.moodle.org/browse/CONTRIB/component/XXX Bug Tracker Page] (Please report bugs here.)
* [https://github.com/deraadt/moodle-block_completion_progress Git repository]

[[Category:Contributed code]]
[[Category:Block]]

[[es:Bloque de Progreso de Finalización]]

Completion Progress block

2016-08-18T11:25:57Z

Deraadt: Adding note about activity completion for earlier versions

{{Infobox plugin
|type = Block, Completion Progress
|entry = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|tracker = https://tracker.moodle.org/browse/CONTRIB/component/XXX/?selectedTab=com.atlassian.jira.jira-projects-plugin:component-summary-panel
|discussion = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|maintainer = [[User:Michael de Raadt|Michael de Raadt]]
|float = right
}}
[[Blocks|Back to Blocks page]]

== Features ==

[[Image:Completion_Progress_bar_in_block_-_with_details.png|right|A progress bar for a student]]
* The Completion Progress is a time-management tool for students.
* It visually shows what activities/resources a student is supposed to interact with in a course.
* It is colour-coded so students can quickly see what they have and have not completed/viewed.
* The block relies on completion settings of activities/resources in the course and when they should be completed by.
* Ordering can be based on expected completion times or on the ordering of activities in the course.
* There is an Overview page allowing teachers to see the progress of all students in a class, which is helpful for finding students at risk.
* Adding the Completion Progress block to the [[Dashboard]] shows users a combined view of their progress from all courses they are enrolled in (where the block is set up).
[[Image:Completion_Progress_Overview_of_students_with_messaging.png|The overview page]]

== Installation ==

* The Completion Progress block is added like other blocks ([[Installing_contributed_modules_or_plugins|How to install a block]]).
* In Moodle versions prior to 3.1, [[Activity completion]] needs to be enabled.

== Global settings ==

The Completion Progress block has a number of global settings that will be seen on installation and can be accessed later at Site administration > Plugins > Blocks > Completion Progress.
[[Image:Completion_Progress_Global_settings.png|thumb|Global settings]]
* ''When wrapping, limit rows to...'' The progress bar shown in the block can be wrapped. This setting allows some control of how long the bar should be before wrapping. The default is 16.
* ''Default presentation for long bars'' The bar can be displayed by squeezing all segments, wrapping segments over multiple lines or allowing the bar to scroll. The default is to Squeeze.
* ''Course name to show on Dashboard'' The block can be added to the dashboard and combines visible Completion Progress block content from the courses a user is enrolled in. By default, the course name shown for each relevant course, is the short course name, but some institutions/organisations may not think this is appropriate in relation to their course naming scheme, so a long course name can be selected.
* ''Colours'' By default, the colours used in the block are red, blue and green. In certain cultures these colours may not have the same meaning. Also, institutions/organisations may wish to use colours that match their theme.
* ''Show inactive students in Overview'' In most cases, inactive students are not wanted in course lists, such as the Overview page associated with the block. However, in some cases, such as ongoing courses, inactive students might need to be visible on the Overview page.

== Capabilities (Controlling who sees parts of the block) ==

The block uses a number of capabilities that are added when the block is installed.
[[Image:Completion_Progress_Capabilities.png|thumb|Global settings]]
* ''Add a Completion Progress block to My home'' (block/completion_progress:myaddinstance) Controls whether the Completion Progress block can be added by a user to the Dashboard (formerly My home) page. By default, this is allowed for all authenticated users.
* ''Add a new Completion Progress block'' (block/completion_progress:addinstance) Controls whether the Completion Progress block can be added to a course page. By default, this is allowed for the following archetypal roles.
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''View course overview of Completion Progress for all students'' (block/completion_progress:overview) Controls whether the Overview page and the button on the Completion Progress block used to access the Overview page can be viewed by a user. By default, this is allowed for the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''Show the bar in the Completion Progress block'' (block/completion_progress:showbar) Controls whether the bar in the Completion Progress block is shown to a user. The reason for not showing this to certain users is that this might not be relevant and possibly annoying. By default, this is shown to the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Student (student)
** (and Admins)

== Setting up a Completion Progress block in a course ==

Once the block is installed on your site, you can use it in a course as follows.
# Turn editing on
# Create your activities/resources as normal
# Set completion settings for each activity you want to appear in the bar, including an expected by date
# Add the Completion Progress block to your page ([[Blocks|How to add a block]])
# Move your block into a prominent position (click and drag the block title)
# Choose to:
#(Optional) Configure how the block should appear

Hidden items will not appear in the Completion Progress block until they are unhidden. This is useful for a scheduled release of activities.

== Links ==

* [http://moodle.org/plugins/view.php?plugin=block_completion_progress Block in Plugins repository]
* [http://tracker.moodle.org/browse/CONTRIB/component/XXX Bug Tracker Page] (Please report bugs here.)
* [https://github.com/deraadt/moodle-block_completion_progress Git repository]

[[Category:Contributed code]]
[[Category:Block]]

[[es:Bloque de Progreso de Finalización]]

Completion Progress block

2016-06-18T10:19:51Z

Deraadt: Created page with "{{Infobox plugin |type = Block, Completion Progress |entry = https://moodle.org/plugins/view.php?plugin=block_completion_progress |tracker = https://tracker.moodle.org/browse/..."

{{Infobox plugin
|type = Block, Completion Progress
|entry = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|tracker = https://tracker.moodle.org/browse/CONTRIB/component/XXX/?selectedTab=com.atlassian.jira.jira-projects-plugin:component-summary-panel
|discussion = https://moodle.org/plugins/view.php?plugin=block_completion_progress
|maintainer = [[User:Michael de Raadt|Michael de Raadt]]
|float = right
}}
[[Blocks|Back to Blocks page]]

== Features ==

[[Image:Completion_Progress_bar_in_block_-_with_details.png|right|A progress bar for a student]]
* The Completion Progress is a time-management tool for students.
* It visually shows what activities/resources a student is supposed to interact with in a course.
* It is colour-coded so students can quickly see what they have and have not completed/viewed.
* The block relies on completion settings of activities/resources in the course and when they should be completed by.
* Ordering can be based on expected completion times or on the ordering of activities in the course.
* There is an Overview page allowing teachers to see the progress of all students in a class, which is helpful for finding students at risk.
* Adding the Completion Progress block to the [[Dashboard]] shows users a combined view of their progress from all courses they are enrolled in (where the block is set up).
[[Image:Completion_Progress_Overview_of_students_with_messaging.png|The overview page]]

== Installation ==

The Completion Progress block is added like other blocks ([[Installing_contributed_modules_or_plugins|How to install a block]]).

== Global settings ==

The Completion Progress block has a number of global settings that will be seen on installation and can be accessed later at Site administration > Plugins > Blocks > Completion Progress.
[[Image:Completion_Progress_Global_settings.png|thumb|Global settings]]
* ''When wrapping, limit rows to...'' The progress bar shown in the block can be wrapped. This setting allows some control of how long the bar should be before wrapping. The default is 16.
* ''Default presentation for long bars'' The bar can be displayed by squeezing all segments, wrapping segments over multiple lines or allowing the bar to scroll. The default is to Squeeze.
* ''Course name to show on Dashboard'' The block can be added to the dashboard and combines visible Completion Progress block content from the courses a user is enrolled in. By default, the course name shown for each relevant course, is the short course name, but some institutions/organisations may not think this is appropriate in relation to their course naming scheme, so a long course name can be selected.
* ''Colours'' By default, the colours used in the block are red, blue and green. In certain cultures these colours may not have the same meaning. Also, institutions/organisations may wish to use colours that match their theme.
* ''Show inactive students in Overview'' In most cases, inactive students are not wanted in course lists, such as the Overview page associated with the block. However, in some cases, such as ongoing courses, inactive students might need to be visible on the Overview page.

== Capabilities (Controlling who sees parts of the block) ==

The block uses a number of capabilities that are added when the block is installed.
[[Image:Completion_Progress_Capabilities.png|thumb|Global settings]]
* ''Add a Completion Progress block to My home'' (block/completion_progress:myaddinstance) Controls whether the Completion Progress block can be added by a user to the Dashboard (formerly My home) page. By default, this is allowed for all authenticated users.
* ''Add a new Completion Progress block'' (block/completion_progress:addinstance) Controls whether the Completion Progress block can be added to a course page. By default, this is allowed for the following archetypal roles.
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''View course overview of Completion Progress for all students'' (block/completion_progress:overview) Controls whether the Overview page and the button on the Completion Progress block used to access the Overview page can be viewed by a user. By default, this is allowed for the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''Show the bar in the Completion Progress block'' (block/completion_progress:showbar) Controls whether the bar in the Completion Progress block is shown to a user. The reason for not showing this to certain users is that this might not be relevant and possibly annoying. By default, this is shown to the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Student (student)
** (and Admins)

== Setting up a Completion Progress block in a course ==

Once the block is installed on your site, you can use it in a course as follows.
# Turn editing on
# Create your activities/resources as normal
# Set completion settings for each activity you want to appear in the bar, including an expected by date
# Add the Completion Progress block to your page ([[Blocks|How to add a block]])
# Move your block into a prominent position (click and drag the block title)
# Choose to:
#(Optional) Configure how the block should appear

Hidden items will not appear in the Completion Progress block until they are unhidden. This is useful for a scheduled release of activities.

== Links ==

* [http://moodle.org/plugins/view.php?plugin=block_completion_progress Block in Plugins repository]
* [http://tracker.moodle.org/browse/CONTRIB/component/XXX Bug Tracker Page] (Please report bugs here.)
* [https://github.com/deraadt/moodle-block_completion_progress Git repository]

[[Category:Contributed code]]
[[Category:Block]]

File:Completion Progress Capabilities.png

2016-06-18T10:19:39Z

Deraadt:

File:Completion Progress Global settings.png

2016-06-18T10:19:02Z

Deraadt:

File:Completion Progress bar in block - with details.png

2016-06-18T10:18:08Z

Deraadt:

File:Completion Progress Overview of students with messaging.png

2016-06-18T10:16:01Z

Deraadt:

Learning analytics

2016-04-06T07:32:51Z

Deraadt: /* Moodle Plugins */

Learning Analytics are any piece of information that can help an LMS user improve learning outcomes. Users include students, teachers, administrators and decision-makers.

== Moodle Plugins ==

There are a number of reports, blocks and other plugins for Moodle that provide learning analytics.

{| class="nicetable"
|-
! Plugin
! Plugin type
! Standard / Additional
! Useful for
! Description
! Reported usage*
|-
| [[:en:Logs|Logs]]
| Report
| Standard
| Teachers, Admins, Decision-makers
| Filterable log of events
| style="text-align:center;" | 71.4%
|-
| [[:en:Activity_report|Activity]]
| Report
| Standard
| Teachers
| View count of activities in course
| style="text-align:center;" | 69.1%
|-
| [[:en:Using_Activity_completion|Activity completion]], see also [[:en:Using_Course_completion|Course completion]]
| Report
| Standard
| Teachers
| Completion matrix of students and activities
| style="text-align:center;" | 66.3%
|-
| [[:en:Logs|Live logs]]
| Report
| Standard
| Teachers, Admins
| Automatically refreshing log of events
| style="text-align:center;" | 55.2%
|-
| [[:en:Feedback_activity|Feedback]]
| Activity
| Standard
| Teachers, Researchers
| Configurable survey tool
| style="text-align:center;" | 59.5%
|-
| [[:en:Quiz_statistics_report|(Quiz) Statistics]]
| Report
| Standard
| Teachers
| Student quiz performance report
| style="text-align:center;" | 53.0%
|-
| [[:en:Participation_report|(Course) Participation]]
| Report
| Standard
| Teachers
| Single student's participation in course
| style="text-align:center;" | 49.9%
|-
| [[:en:Survey_module|Survey]]
| Activity
| Standard
| Teachers, Researchers
| Set of standardised educational surveys
| style="text-align:center;" | 45.6%
|-
| [http://moodle.org/plugins/view.php?plugin=mod_questionnaire Questionnaire]
| Activity
| Additional
| Teachers, Researchers
| Configurable survey tool
| style="text-align:center;" | 45.3%
|-
| [[:en:Course_overview_report|Course overview]]
| Report
| Standard
| Admins, Decision-makers
| Comparison of participation across multiple courses
| style="text-align:center;" | 45.0%
|-
| [[:en:Course_completion_status_block|Course completion status]]
| Block
| Standard
| Students
| View of student's own completion of activities
| style="text-align:center;" | 41.4%
|-
| [http://moodle.org/plugins/view.php?plugin=block_progress Progress Bar]
| Block
| Additional
| Students, Teachers
| Time management tool for students with overview for teachers
| style="text-align:center;" | 32.0%
|-
| [[:en:Events_list_report|Events list]]
| Report
| Standard
| Teachers, Admins
| Events that can be monitored/searched in logs
| style="text-align:center;" | 28.6%
|-
| [[:en:Activity_results_block|Activity results block]]
| Block
| Standard
| Students
| Leader-board of results in single activity
| style="text-align:center;" | 26.1%
|-
| [http://moodle.org/plugins/view.php?id=82 Configurable Reports]
([https://docs.moodle.org/29/en/ad-hoc_contributed_reports A list of contributed reports])
| Block ([https://github.com/nadavkav/moodle-report_configurablereports Report] [https://github.com/nadavkav/moodle-filter_crgraph Graphs filter])
| Additional
| Teachers, Admins, Decision-makers
| Report generation and viewing
| style="text-align:center;" | 22.7%
|-
| [[Overview_report|(Gradebook) Overview]]
| Report
| Standard
| Teachers, Students
| View of student grades across activites
| style="text-align:center;" | N/A
|-
| [[Statistics]]
| Report
| Standard
| Admins, Decision-makers
| Daily activity across site
| style="text-align:center;" | N/A
|-
| [[:en:Event_monitoring|Event monitor]]
| Report
| Standard
| Teachers, Admins, Decision-makers
| Proactive, focussed monitor tool
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view/report_customsql Ad-hoc database queries]
| Report
| Additional
| Teachers, Admins, Decision-makers
| SQL-based report generation and viewing
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/browse.php?list=set&id=20 Engagement Analytics]
| Block, Report, Activity module
| Additional
| Teachers
| Configurable engagement measurement report and block
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view/block_dedication Course Dedication]
| Block
| Additional
| Students, Teachers
| Estimated time online for students
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view.php?plugin=block_graph_stats Graph Stats]
| Block
| Additional
| Teachers, Admins
| Daily visits to site or course
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view/block_gismo GISMO]
| Block
| Additional
| Teachers
| Numerous charts of student activity participation
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view/block_xp Level Up!]
| Block
| Additional
| Students, Teachers
| Incentive-drive participation meter
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/report_forumgraph Forum Graph]
| Report
| Additional
| Teachers
| Graph of forum interactions
| style="text-align:center;" | N/A
|-
| [https://moodle.org/plugins/block_analytics_graphs Analytics Graphs]
| Block
| Additional
| Teachers
| Visualisation of student participation
| style="text-align:center;" | N/A
|-
| [https://moodle.org/plugins/block_heatmap Heatmap]
| Block
| Additional
| Teachers
| Colour-coded indication of activity views on course page
| style="text-align:center;" | N/A
|-
| [https://moodle.org/plugins/local_analytics Analytics]
| Local
| Additional
| Admins, Decision-makers
| Enriched feed to Google Analytics and Pywick
| style="text-align:center;" | N/A
|-
| [https://moodle.org/plugins/logstore_xapi Logstore xAPI]
| Logstore
| Additional
| Admins, Decision-makers, Researchers
| xAPI event stream output
| style="text-align:center;" | N/A
|}

<nowiki>*</nowiki> Reported usage is drawn from the [http://research.moodle.net/71/1/Plugins%20Usage%20Survey%202015%20Report.pdf Plugins Usage Survey from 2015].

== Integrations with Moodle ==

A number of systems integrate with Moodle to provide learning analytics information externally.

* [http://damos.world/2013/08/30/the-moodle-activity-viewer-mav-heatmaps-of-student-activity/ Moodle Activity Viewer] (MAV) ([https://github.com/damoclark/mav-enterprise Git]), consider [https://moodle.org/plugins/block_heatmap Heatmap] as an alternative
* [http://www.intelliboard.net/ Intelliboard]
* [http://www.lambdasolutions.net/products/lmsreporting/ Analytika]
* [https://learninglocker.net/ Learning Locker], can be used with [https://moodle.org/plugins/logstore_xapi Logstore xAPI]
* [http://klassdata.com/smartklass-learning-analytics-plugin/learning-analytics-moodle-smartklass/ SmartKlass]

== Dimensions of Analytics ==

Learning analytics are a concept that has been emerging under a number of different names through the past decades. Its origins lie in research in data mining and intelligent tutoring systems. LA tools can be categorised in a number of ways. The diagram below describes such tools by how deeply they are integrated with other systems ([http://www.netdimensions.com/downloads-2015/others/lms-evolution-or-extinction.pdf?mkt_tok=3RkMMJWWfF9wsRokuKjMZKXonjHpfsX56OQtW6CwlMI%2F0ER3fOvrPUfGjI4DTsdlI%2BSLDwEYGJlv6SgFS7fAMaFl3bgIWBY%3D source]).

[[File:Learning-analytics.png]]

== See also... ==
* [https://moodle.org/mod/forum/view.php?id=8044 Analytics and reporting forum]
* [https://moodle.org/mod/forum/view.php?id=8205 Moodle Research forum]
* [[:dev:Moodle_research|Moodle research page]]
* [[Logging]]
* [[:en:Events_list_report|Events list]]
* [[:dev:Learning_Analytics_Specification|Learning Analytics API specification]]
* [[:dev:Working_Groups#Assessment_Analytics|Assessment Analytics working group details and issues]]
* [[:dev:Event_2|Events specification]]
* [[:dev:Logging_2|Logging specification]]
* [[:dev:reportbuilder/API|Report Builder API specification]]

[[Category:Report]]

[[es:Análisis del aprendizaje]]

Learning analytics

2016-04-06T07:31:24Z

Deraadt: Adding descriptions to plugins

Learning Analytics are any piece of information that can help an LMS user improve learning outcomes. Users include students, teachers, administrators and decision-makers.

== Moodle Plugins ==

There are a number of reports, blocks and other plugins for Moodle that provide learning analytics.

{| class="nicetable"
|-
! Plugin
! Plugin type
! Standard / Additional
! Useful for
! Description
! Reported usage*
|-
| [[:en:Logs|Logs]]
| Report
| Standard
| Teachers, Admins, Decision-makers
| Filterable log of events
| style="text-align:center;" | 71.4%
|-
| [[:en:Activity_report|Activity]]
| Report
| Standard
| Teachers
| View count of activities in course
| style="text-align:center;" | 69.1%
|-
| [[:en:Using_Activity_completion|Activity completion]], see also [[:en:Using_Course_completion|Course completion]]
| Report
| Standard
| Teachers
| Completion matrix of students and activities
| style="text-align:center;" | 66.3%
|-
| [[:en:Logs|Live logs]]
| Report
| Standard
| Teachers, Admins
| Automatically refreshing log of events
| style="text-align:center;" | 55.2%
|-
| [[:en:Feedback_activity|Feedback]]
| Activity
| Standard
| Teachers, Researchers
| Configurable survey tool
| style="text-align:center;" | 59.5%
|-
| [[:en:Quiz_statistics_report|(Quiz) Statistics]]
| Report
| Standard
| Teachers
| Student quiz performance report
| style="text-align:center;" | 53.0%
|-
| [[:en:Participation_report|(Course) Participation]]
| Report
| Standard
| Teachers
| Single student's participation in course
| style="text-align:center;" | 49.9%
|-
| [[:en:Survey_module|Survey]]
| Activity
| Standard
| Teachers, Researchers
| Set of standardised educational surveys
| style="text-align:center;" | 45.6%
|-
| [http://moodle.org/plugins/view.php?plugin=mod_questionnaire Questionnaire]
| Activity
| Additional
| Teachers, Researchers
| Configurable survey tool
| style="text-align:center;" | 45.3%
|-
| [[:en:Course_overview_report|Course overview]]
| Report
| Standard
| Admins, Decision-makers
| Comparison of participation across multiple courses
| style="text-align:center;" | 45.0%
|-
| [[:en:Course_completion_status_block|Course completion status]]
| Block
| Standard
| Students
| View of student's own completion of activities
| style="text-align:center;" | 41.4%
|-
| [http://moodle.org/plugins/view.php?plugin=block_progress Progress Bar]
| Block
| Additional
| Students, Teachers
| Time management tool for students with overview for teachers
| style="text-align:center;" | 32.0%
|-
| [[:en:Events_list_report|Events list]]
| Report
| Standard
| Teachers, Admins
| Events that can be monitored/searched in logs
| style="text-align:center;" | 28.6%
|-
| [[:en:Activity_results_block|Activity results block]]
| Block
| Standard
| Students
| Leader-board of results in single activity
| style="text-align:center;" | 26.1%
|-
| [http://moodle.org/plugins/view.php?id=82 Configurable Reports]
([https://docs.moodle.org/29/en/ad-hoc_contributed_reports A list of contributed reports])
| Block ([https://github.com/nadavkav/moodle-report_configurablereports Report] [https://github.com/nadavkav/moodle-filter_crgraph Graphs filter])
| Additional
| Teachers, Admins, Decision-makers
| Report generation and viewing
| style="text-align:center;" | 22.7%
|-
| [[Overview_report|(Gradebook) Overview]]
| Report
| Standard
| Teachers, Students
| View of student grades across activites
| style="text-align:center;" | N/A
|-
| [[Statistics]]
| Report
| Standard
| Admins, Decision-makers
| Daily activity across site
| style="text-align:center;" | N/A
|-
| [[:en:Event_monitoring|Event monitor]]
| Report
| Standard
| Teachers, Admins, Decision-makers
| Proactive, focussed monitor tool
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view/report_customsql Ad-hoc database queries]
| Report
| Additional
| Teachers, Admins, Decision-makers
| SQL-based report generation and viewing
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/browse.php?list=set&id=20 Engagement Analytics]
| Block, Report, Activity module
| Additional
| Teachers
| Configurable engagement measurement report and block
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view/block_dedication Course Dedication]
| Block
| Additional
| Students, Teachers
| Estimated time online for students
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view.php?plugin=block_graph_stats Graph Stats]
| Block
| Additional
| Teachers, Admins
| Daily visits to site or course
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view/block_gismo GISMO]
| Block
| Additional
| Teachers
| Numerous charts of student activity participation
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view/block_xp Level Up!]
| Block
| Additional
| Students, Teachers
| Incentive-drive participation meter
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/report_forumgraph Forum Graph]
| Report
| Additional
| Teachers
| Graph of forum interactions
| style="text-align:center;" | N/A
|-
| [https://moodle.org/plugins/block_analytics_graphs Analytics Graphs]
| Block
| Additional
| Teachers
| Visualisation of student participation
| style="text-align:center;" | N/A
|-
| [https://moodle.org/plugins/block_heatmap Heatmap]
| Block
| Additional
| Teachers
| Colour-coded indication of activity views on course page
| style="text-align:center;" | N/A
|-
| [https://moodle.org/plugins/local_analytics|Analytics]
| Local
| Additional
| Admins, Decision-makers
| Enriched feed to Google Analytics and Pywick
| style="text-align:center;" | N/A
|-
| [https://moodle.org/plugins/logstore_xapi Logstore xAPI]
| Logstore
| Additional
| Admins, Decision-makers, Researchers
| xAPI event stream output
| style="text-align:center;" | N/A
|}

<nowiki>*</nowiki> Reported usage is drawn from the [http://research.moodle.net/71/1/Plugins%20Usage%20Survey%202015%20Report.pdf Plugins Usage Survey from 2015].

== Integrations with Moodle ==

A number of systems integrate with Moodle to provide learning analytics information externally.

* [http://damos.world/2013/08/30/the-moodle-activity-viewer-mav-heatmaps-of-student-activity/ Moodle Activity Viewer] (MAV) ([https://github.com/damoclark/mav-enterprise Git]), consider [https://moodle.org/plugins/block_heatmap Heatmap] as an alternative
* [http://www.intelliboard.net/ Intelliboard]
* [http://www.lambdasolutions.net/products/lmsreporting/ Analytika]
* [https://learninglocker.net/ Learning Locker], can be used with [https://moodle.org/plugins/logstore_xapi Logstore xAPI]
* [http://klassdata.com/smartklass-learning-analytics-plugin/learning-analytics-moodle-smartklass/ SmartKlass]

== Dimensions of Analytics ==

Learning analytics are a concept that has been emerging under a number of different names through the past decades. Its origins lie in research in data mining and intelligent tutoring systems. LA tools can be categorised in a number of ways. The diagram below describes such tools by how deeply they are integrated with other systems ([http://www.netdimensions.com/downloads-2015/others/lms-evolution-or-extinction.pdf?mkt_tok=3RkMMJWWfF9wsRokuKjMZKXonjHpfsX56OQtW6CwlMI%2F0ER3fOvrPUfGjI4DTsdlI%2BSLDwEYGJlv6SgFS7fAMaFl3bgIWBY%3D source]).

[[File:Learning-analytics.png]]

== See also... ==
* [https://moodle.org/mod/forum/view.php?id=8044 Analytics and reporting forum]
* [https://moodle.org/mod/forum/view.php?id=8205 Moodle Research forum]
* [[:dev:Moodle_research|Moodle research page]]
* [[Logging]]
* [[:en:Events_list_report|Events list]]
* [[:dev:Learning_Analytics_Specification|Learning Analytics API specification]]
* [[:dev:Working_Groups#Assessment_Analytics|Assessment Analytics working group details and issues]]
* [[:dev:Event_2|Events specification]]
* [[:dev:Logging_2|Logging specification]]
* [[:dev:reportbuilder/API|Report Builder API specification]]

[[Category:Report]]

[[es:Análisis del aprendizaje]]

Learning analytics

2016-04-06T06:43:23Z

Deraadt: Adding Events list

Learning Analytics are any piece of information that can help an LMS user improve learning outcomes. Users include students, teachers, administrators and decision-makers.

== Moodle Plugins ==

There are a number of reports, blocks and other plugins for Moodle that provide learning analytics.

{| class="nicetable"
|-
! Plugin
! Plugin type
! Standard / Additional
! Useful for
! Reported usage*
|-
| [[:en:Logs|Logs]]
| Report
| Standard
| Teachers, Admins, Decision-makers
| style="text-align:center;" | 71.4%
|-
| [[:en:Activity_report|Activity]]
| Report
| Standard
| Teachers
| style="text-align:center;" | 69.1%
|-
| [[:en:Using_Activity_completion|Activity completion]], see also [[:en:Using_Course_completion|Course completion]]
| Report
| Standard
| Teachers
| style="text-align:center;" | 66.3%
|-
| [[:en:Logs|Live logs]]
| Report
| Standard
| Teachers, Admins
| style="text-align:center;" | 55.2%
|-
| [[:en:Feedback_activity|Feedback]]
| Activity
| Standard
| Teachers, Researchers
| style="text-align:center;" | 59.5%
|-
| [[:en:Quiz_statistics_report|(Quiz) Statistics]]
| Report
| Standard
| Teachers
| style="text-align:center;" | 53.0%
|-
| [[:en:Participation_report|(Course) Participation]]
| Report
| Standard
| Teachers
| style="text-align:center;" | 49.9%
|-
| [[:en:Survey_module|Survey]]
| Activity
| Standard
| Teachers, Researchers
| style="text-align:center;" | 45.6%
|-
| [http://moodle.org/plugins/view.php?plugin=mod_questionnaire Questionnaire]
| Activity
| Additional
| Teachers, Researchers
| style="text-align:center;" | 45.3%
|-
| [[:en:Course_overview_report|Course overview]]
| Report
| Standard
| Admins, Decision-makers
| style="text-align:center;" | 45.0%
|-
| [[:en:Course_completion_status_block|Course completion status]]
| Block
| Standard
| Students
| style="text-align:center;" | 41.4%
|-
| [http://moodle.org/plugins/view.php?plugin=block_progress Progress Bar]
| Block
| Additional
| Students, Teachers
| style="text-align:center;" | 32.0%
|-
| [[:en:Events_list_report|Events list]]
| Report
| Standard
| Teachers, Admins
| style="text-align:center;" | 28.6%
|-
| [[:en:Activity_results_block|Activity results block]]
| Block
| Standard
| Students
| style="text-align:center;" | 26.1%
|-
| [http://moodle.org/plugins/view.php?id=82 Configurable Reports]
([https://docs.moodle.org/29/en/ad-hoc_contributed_reports A list of contributed reports])
| Block ([https://github.com/nadavkav/moodle-report_configurablereports Report] [https://github.com/nadavkav/moodle-filter_crgraph Graphs filter])
| Additional
| Teachers, Admins, Decision-makers
| style="text-align:center;" | 22.7%
|-
| [[Overview_report|(Gradebook) Overview]]
| Report
| Standard
| Teachers, Students
| style="text-align:center;" | N/A
|-
| [[Statistics]]
| Report
| Standard
| Admins, Decision-makers
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view/report_customsql Ad-hoc database queries]
| Report
| Additional
| Teachers, Admins, Decision-makers
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/browse.php?list=set&id=20 Engagement Analytics]
| Block, Report, Activity module
| Additional
| Teachers
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view/block_dedication Course Dedication]
| Block
| Additional
| Students, Teachers
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view.php?plugin=block_graph_stats Graph Stats]
| Block
| Additional
| Teachers, Admins
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view/block_gismo GISMO]
| Block
| Additional
| Teachers
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view/block_xp Level Up!]
| Block
| Additional
| Students, Teachers
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/report_forumgraph Forum Graph]
| Report
| Additional
| Teachers
| style="text-align:center;" | N/A
|-
| [https://moodle.org/plugins/block_analytics_graphs Analytics Graphs]
| Block
| Additional
| Teachers
| style="text-align:center;" | N/A
|-
| [https://moodle.org/plugins/block_heatmap Heatmap]
| Block
| Additional
| Teachers
| style="text-align:center;" | N/A
|}

<nowiki>*</nowiki> Reported usage is drawn from the [http://research.moodle.net/71/1/Plugins%20Usage%20Survey%202015%20Report.pdf Plugins Usage Survey from 2015].

== Integrations with Moodle ==

A number of systems integrate with Moodle to provide learning analytics information.

* [http://damos.world/2013/08/30/the-moodle-activity-viewer-mav-heatmaps-of-student-activity/ Moodle Activity Viewer] (MAV) ([https://github.com/damoclark/mav-enterprise Git])
* [http://www.intelliboard.net/ Intelliboard]

== Dimensions of Analytics ==

Learning analytics are a concept that has been emerging under a number of different names through the past decades. Its origins lie in research in data mining and intelligent tutoring systems. LA tools can be categorised in a number of ways. The diagram below describes such tools by how deeply they are integrated with other systems ([http://www.netdimensions.com/downloads-2015/others/lms-evolution-or-extinction.pdf?mkt_tok=3RkMMJWWfF9wsRokuKjMZKXonjHpfsX56OQtW6CwlMI%2F0ER3fOvrPUfGjI4DTsdlI%2BSLDwEYGJlv6SgFS7fAMaFl3bgIWBY%3D source]).

[[File:Learning-analytics.png]]

== See also... ==
* [https://moodle.org/mod/forum/view.php?id=8044 Analytics and reporting forum]
* [https://moodle.org/mod/forum/view.php?id=8205 Moodle Research forum]
* [[:dev:Moodle_research|Moodle research page]]
* [[Logging]]
* [[:en:Events_list_report|Events list]]
* [[:dev:Learning_Analytics_Specification|Learning Analytics API specification]]
* [[:dev:Working_Groups#Assessment_Analytics|Assessment Analytics working group details and issues]]
* [[:dev:Event_2|Events specification]]
* [[:dev:Logging_2|Logging specification]]
* [[:dev:reportbuilder/API|Report Builder API specification]]

[[Category:Report]]

[[es:Análisis del aprendizaje]]

Learning analytics

2016-04-06T06:42:29Z

Deraadt: Adding more learning analytics plugins

Learning Analytics are any piece of information that can help an LMS user improve learning outcomes. Users include students, teachers, administrators and decision-makers.

== Moodle Plugins ==

There are a number of reports, blocks and other plugins for Moodle that provide learning analytics.

{| class="nicetable"
|-
! Plugin
! Plugin type
! Standard / Additional
! Useful for
! Reported usage*
|-
| [[:en:Logs|Logs]]
| Report
| Standard
| Teachers, Admins, Decision-makers
| style="text-align:center;" | 71.4%
|-
| [[:en:Activity_report|Activity]]
| Report
| Standard
| Teachers
| style="text-align:center;" | 69.1%
|-
| [[:en:Using_Activity_completion|Activity completion]], see also [[:en:Using_Course_completion|Course completion]]
| Report
| Standard
| Teachers
| style="text-align:center;" | 66.3%
|-
| [[:en:Logs|Live logs]]
| Report
| Standard
| Teachers, Admins
| style="text-align:center;" | 55.2%
|-
| [[:en:Feedback_activity|Feedback]]
| Activity
| Standard
| Teachers, Researchers
| style="text-align:center;" | 59.5%
|-
| [[:en:Quiz_statistics_report|(Quiz) Statistics]]
| Report
| Standard
| Teachers
| style="text-align:center;" | 53.0%
|-
| [[:en:Participation_report|(Course) Participation]]
| Report
| Standard
| Teachers
| style="text-align:center;" | 49.9%
|-
| [[:en:Survey_module|Survey]]
| Activity
| Standard
| Teachers, Researchers
| style="text-align:center;" | 45.6%
|-
| [http://moodle.org/plugins/view.php?plugin=mod_questionnaire Questionnaire]
| Activity
| Additional
| Teachers, Researchers
| style="text-align:center;" | 45.3%
|-
| [[:en:Course_overview_report|Course overview]]
| Report
| Standard
| Admins, Decision-makers
| style="text-align:center;" | 45.0%
|-
| [[:en:Course_completion_status_block|Course completion status]]
| Block
| Standard
| Students
| style="text-align:center;" | 41.4%
|-
| [http://moodle.org/plugins/view.php?plugin=block_progress Progress Bar]
| Block
| Additional
| Students, Teachers
| style="text-align:center;" | 32.0%
|-
| [[:en:Events_list_report|Events list]]
| Report
| Standard
| Teachers, Admins
| style="text-align:center;" | 28.6%
|-
| [[:en:Activity_results_block|Activity results block]]
| Block
| Standard
| Students
| style="text-align:center;" | 26.1%
|-
| [http://moodle.org/plugins/view.php?id=82 Configurable Reports]
([https://docs.moodle.org/29/en/ad-hoc_contributed_reports A list of contributed reports])
| Block ([https://github.com/nadavkav/moodle-report_configurablereports Report] [https://github.com/nadavkav/moodle-filter_crgraph Graphs filter])
| Additional
| Teachers, Admins, Decision-makers
| style="text-align:center;" | 22.7%
|-
| [[Overview_report|(Gradebook) Overview]]
| Report
| Standard
| Teachers, Students
| style="text-align:center;" | N/A
|-
| [[Statistics]]
| Report
| Standard
| Admins, Decision-makers
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view/report_customsql Ad-hoc database queries]
| Report
| Additional
| Teachers, Admins, Decision-makers
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/browse.php?list=set&id=20 Engagement Analytics]
| Block, Report, Activity module
| Additional
| Teachers
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view/block_dedication Course Dedication]
| Block
| Additional
| Students, Teachers
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view.php?plugin=block_graph_stats Graph Stats]
| Block
| Additional
| Teachers, Admins
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view/block_gismo GISMO]
| Block
| Additional
| Teachers
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/view/block_xp Level Up!]
| Block
| Additional
| Students, Teachers
| style="text-align:center;" | N/A
|-
| [http://moodle.org/plugins/report_forumgraph Forum Graph]
| Report
| Additional
| Teachers
| style="text-align:center;" | N/A
|-
| [https://moodle.org/plugins/block_analytics_graphs Analytics Graphs]
| Block
| Additional
| Teachers
| style="text-align:center;" | N/A
|-
| [https://moodle.org/plugins/block_heatmap Heatmap]
| Block
| Additional
| Teachers
| style="text-align:center;" | N/A
|}

<nowiki>*</nowiki> Reported usage is drawn from the [http://research.moodle.net/71/1/Plugins%20Usage%20Survey%202015%20Report.pdf Plugins Usage Survey from 2015].

== Integrations with Moodle ==

A number of systems integrate with Moodle to provide learning analytics information.

* [http://damos.world/2013/08/30/the-moodle-activity-viewer-mav-heatmaps-of-student-activity/ Moodle Activity Viewer] (MAV) ([https://github.com/damoclark/mav-enterprise Git])
* [http://www.intelliboard.net/ Intelliboard]

== Dimensions of Analytics ==

Learning analytics are a concept that has been emerging under a number of different names through the past decades. Its origins lie in research in data mining and intelligent tutoring systems. LA tools can be categorised in a number of ways. The diagram below describes such tools by how deeply they are integrated with other systems ([http://www.netdimensions.com/downloads-2015/others/lms-evolution-or-extinction.pdf?mkt_tok=3RkMMJWWfF9wsRokuKjMZKXonjHpfsX56OQtW6CwlMI%2F0ER3fOvrPUfGjI4DTsdlI%2BSLDwEYGJlv6SgFS7fAMaFl3bgIWBY%3D source]).

[[File:Learning-analytics.png]]

== See also... ==
* [https://moodle.org/mod/forum/view.php?id=8044 Analytics and reporting forum]
* [https://moodle.org/mod/forum/view.php?id=8205 Moodle Research forum]
* [[:dev:Moodle_research|Moodle research page]]
* [[Logging]]
* [[:dev:Learning_Analytics_Specification|Learning Analytics API specification]]
* [[:dev:Working_Groups#Assessment_Analytics|Assessment Analytics working group details and issues]]
* [[:dev:Event_2|Events specification]]
* [[:dev:Logging_2|Logging specification]]
* [[:dev:reportbuilder/API|Report Builder API specification]]

[[Category:Report]]

[[es:Análisis del aprendizaje]]

Heatmap block

2016-03-18T04:50:30Z

Deraadt: /* Capabilities (Controlling who sees parts of the block) */

{{Infobox plugin
|type = Block
|entry = https://moodle.org/plugins/view.php?plugin=block_heatmap
|tracker = https://tracker.moodle.org/browse/CONTRIB/component/15738
|discussion = https://moodle.org/mod/forum/discuss.php?d=329136
|maintainer = [[User:Michael de Raadt|Michael de Raadt]]
|float = right
}}
[[Blocks|Back to Blocks page]]

== Features ==

[[Image:Heatmap_in_course.png|thumb|right|A heatmap applied to a course]]
* The Heatmap block overlays a heatmap onto a course to highlight activities with more or less activity.
* Counts of visits and unique users to each activity is also shown.
* The Heatmap can be toggled off when it is not needed.

== Installation ==

The Heatmap block is added like other blocks ([[Installing_contributed_modules_or_plugins|How to install a block]]).

== Global settings ==

The Heatmap block has a number of global settings that will be seen on installation and can be accessed later at Site administration > Plugins > Blocks > Heatmap.
[[Image:Heatmap_global_settings.png|thumb|Global settings]]
* ''Cache lifespan'' A cache is used to retain results and reduce impact on the log table. The lifespan of the cache can be controlled. A longer-lived cache means the burden of querying the log table is reduced. A shorter-lived cache will show more recent results.
* ''Check for activity'' You can limit the timespan that is covered by the log entries queried by the block can be controlled. You can choose to search back to the start of the course (default) or to the beginning of the log. This option can be changed if courses are re-run and teachers want to see beyond the start of the current instance. Searching further back in the log may cause additional load.
* ''What to show on course page'' Two things can be added to course pages: a background colour for activities with visits and icons showing the count of visits and count of unique users. You can select to show both (default) or one or the other.

'''Note: Changes to cache-related settings may not appear immediately in the user interface unless you also purge caches after saving these settings.'''

== Capabilities (Controlling who sees parts of the block) ==

The block uses a number of capabilities that are added when the block is installed.
[[Image:Heatmap_capabilities.png|thumb|Capabilities]]
* ''Add a new Heatmap block'' (block/heatmap:addinstance) Controls whether the Heatmap block can be added to a course page. By default, this is allowed for the following archetypal roles.
** Teacher (editingteacher)
** Manager (manager)
** (and Admins)
* ''View the Heatmap'' (block/heatmap:view) Controls who can see the Heatmap block and subsequently the overlay of the heatmap on the course. This is something that will usually be relevant to Teachers, so it is hidden from students.
** Teacher (editingteacher)
** Manager (manager)
** (and Admins)

== Setting up a Heatmap in a course ==

Once the Heatmap block is installed, you can use it in a course as follows.
# Turn editing on
# Add the Heatmap block to your page ([[Blocks|How to add a block]])
# Toggle the Heatmap off and on as needed

== Links ==

* [http://moodle.org/plugins/view.php?plugin=block_heatmap Entry in Plugins repository]
* [https://tracker.moodle.org/browse/CONTRIB/component/15738 Bug Tracker Page] (Please report bugs here.)
* [https://github.com/deraadt/moodle-block_heatmap Git repository]

===Videos===

<mediaplayer>https://www.youtube.com/watch?v=jqZP0T0rR4U</mediaplayer>

[[Category:Contributed code]]
[[Category:Block]]

[[es:Bloque Heatmap]]

File:Heatmap capabilities.png

2016-03-18T04:45:35Z

Deraadt: Deraadt uploaded a new version of File:Heatmap capabilities.png

Heatmap block

2016-03-18T04:45:00Z

Deraadt: Removing capability for the Dashboard as it was removed from the block

{{Infobox plugin
|type = Block
|entry = https://moodle.org/plugins/view.php?plugin=block_heatmap
|tracker = https://tracker.moodle.org/browse/CONTRIB/component/15738
|discussion = https://moodle.org/mod/forum/discuss.php?d=329136
|maintainer = [[User:Michael de Raadt|Michael de Raadt]]
|float = right
}}
[[Blocks|Back to Blocks page]]

== Features ==

[[Image:Heatmap_in_course.png|thumb|right|A heatmap applied to a course]]
* The Heatmap block overlays a heatmap onto a course to highlight activities with more or less activity.
* Counts of visits and unique users to each activity is also shown.
* The Heatmap can be toggled off when it is not needed.

== Installation ==

The Heatmap block is added like other blocks ([[Installing_contributed_modules_or_plugins|How to install a block]]).

== Global settings ==

The Heatmap block has a number of global settings that will be seen on installation and can be accessed later at Site administration > Plugins > Blocks > Heatmap.
[[Image:Heatmap_global_settings.png|thumb|Global settings]]
* ''Cache lifespan'' A cache is used to retain results and reduce impact on the log table. The lifespan of the cache can be controlled. A longer-lived cache means the burden of querying the log table is reduced. A shorter-lived cache will show more recent results.
* ''Check for activity'' You can limit the timespan that is covered by the log entries queried by the block can be controlled. You can choose to search back to the start of the course (default) or to the beginning of the log. This option can be changed if courses are re-run and teachers want to see beyond the start of the current instance. Searching further back in the log may cause additional load.
* ''What to show on course page'' Two things can be added to course pages: a background colour for activities with visits and icons showing the count of visits and count of unique users. You can select to show both (default) or one or the other.

'''Note: Changes to cache-related settings may not appear immediately in the user interface unless you also purge caches after saving these settings.'''

== Capabilities (Controlling who sees parts of the block) ==

The block uses a number of capabilities that are added when the block is installed.
[[Image:Heatmap_capabilities.png|thumb|Global settings]]
* ''Add a new Heatmap block'' (block/heatmap:addinstance) Controls whether the Heatmap block can be added to a course page. By default, this is allowed for the following archetypal roles.
** Teacher (editingteacher)
** Manager (manager)
** (and Admins)
* ''View the Heatmap'' (block/heatmap:view) Controls who can see the Heatmap block and subsequently the overlay of the heatmap on the course. This is something that will usually be relevant to Teachers, so it is hidden from students.
** Teacher (editingteacher)
** Manager (manager)
** (and Admins)

== Setting up a Heatmap in a course ==

Once the Heatmap block is installed, you can use it in a course as follows.
# Turn editing on
# Add the Heatmap block to your page ([[Blocks|How to add a block]])
# Toggle the Heatmap off and on as needed

== Links ==

* [http://moodle.org/plugins/view.php?plugin=block_heatmap Entry in Plugins repository]
* [https://tracker.moodle.org/browse/CONTRIB/component/15738 Bug Tracker Page] (Please report bugs here.)
* [https://github.com/deraadt/moodle-block_heatmap Git repository]

===Videos===

<mediaplayer>https://www.youtube.com/watch?v=jqZP0T0rR4U</mediaplayer>

[[Category:Contributed code]]
[[Category:Block]]

[[es:Bloque Heatmap]]

admin/setting/blocksettingheatmap

2016-03-08T02:13:15Z

Deraadt: Redirected page to Heatmap block#Global settings

#REDIRECT [[Heatmap_block#Global_settings]]

Heatmap block

2016-03-08T02:12:04Z

Deraadt: Created page with "{{Infobox plugin |type = Block |entry = https://moodle.org/plugins/view.php?plugin=block_heatmap |tracker = https://tracker.moodle.org/browse/CONTRIB/component/15738 |discussi..."

{{Infobox plugin
|type = Block
|entry = https://moodle.org/plugins/view.php?plugin=block_heatmap
|tracker = https://tracker.moodle.org/browse/CONTRIB/component/15738
|discussion = https://moodle.org/mod/forum/discuss.php?d=329136
|maintainer = [[User:Michael de Raadt|Michael de Raadt]]
|float = right
}}
[[Blocks|Back to Blocks page]]

== Features ==

[[Image:Heatmap_in_course.png|thumb|right|A heatmap applied to a course]]
* The Heatmap block overlays a heatmap onto a course to highlight activities with more or less activity.
* Counts of visits and unique users to each activity is also shown.
* The Heatmap can be toggled off when it is not needed.

== Installation ==

The Heatmap block is added like other blocks ([[Installing_contributed_modules_or_plugins|How to install a block]]).

== Global settings ==

The Heatmap block has a number of global settings that will be seen on installation and can be accessed later at Site administration > Plugins > Blocks > Heatmap.
[[Image:Heatmap_global_settings.png|thumb|Global settings]]
* ''Cache lifespan'' A cache is used to retain results and reduce impact on the log table. The lifespan of the cache can be controlled. A longer-lived cache means the burden of querying the log table is reduced. A shorter-lived cache will show more recent results.
* ''Check for activity'' You can limit the timespan that is covered by the log entries queried by the block can be controlled. You can choose to search back to the start of the course (default) or to the beginning of the log. This option can be changed if courses are re-run and teachers want to see beyond the start of the current instance. Searching further back in the log may cause additional load.
* ''What to show on course page'' Two things can be added to course pages: a background colour for activities with visits and icons showing the count of visits and count of unique users. You can select to show both (default) or one or the other.

'''Note: Changes to cache-related settings may not appear immediately in the user interface unless you also purge caches after saving these settings.'''

== Capabilities (Controlling who sees parts of the block) ==

The block uses a number of capabilities that are added when the block is installed.
[[Image:Heatmap_capabilities.png|thumb|Global settings]]
* ''Add a Heatmap block to the Dashboard'' (block/heatmap:myaddinstance) Leave this off for all users. The block won't work on the Dashboard.
* ''Add a new Heatmap block'' (block/heatmap:addinstance) Controls whether the Heatmap block can be added to a course page. By default, this is allowed for the following archetypal roles.
** Teacher (editingteacher)
** Manager (manager)
** (and Admins)
* ''View the Heatmap'' (block/heatmap:view) Controls who can see the Heatmap block and subsequently the overlay of the heatmap on the course. This is something that will usually be relevant to Teachers, so it is hidden from students.
** Teacher (editingteacher)
** Manager (manager)
** (and Admins)

== Setting up a Heatmap in a course ==

Once the Heatmap block is installed, you can use it in a course as follows.
# Turn editing on
# Add the Heatmap block to your page ([[Blocks|How to add a block]])
# Toggle the Heatmap off and on as needed

== Links ==

* [http://moodle.org/plugins/view.php?plugin=block_heatmap Entry in Plugins repository]
* [https://tracker.moodle.org/browse/CONTRIB/component/15738 Bug Tracker Page] (Please report bugs here.)
* [https://github.com/deraadt/moodle-block_heatmap Git repository]

===Videos===

<mediaplayer>https://www.youtube.com/watch?v=jqZP0T0rR4U</mediaplayer>

[[Category:Contributed code]]
[[Category:Block]]

File:Heatmap capabilities.png

2016-03-08T01:44:41Z

Deraadt:

File:Heatmap global settings.png

2016-03-08T01:25:45Z

Deraadt:

File:Heatmap in course.png

2016-03-08T01:23:30Z

Deraadt:

Learning analytics

2016-02-26T03:17:34Z

Deraadt: Adding Level Up!

Progress Bar block

2016-02-25T21:44:00Z

Deraadt: Changing repo link to Github

{{Infobox plugin
|type = Block, Progress bar
|entry = https://moodle.org/plugins/view.php?plugin=block_progress
|tracker = https://tracker.moodle.org/browse/CONTRIB/component/10489/?selectedTab=com.atlassian.jira.jira-projects-plugin:component-summary-panel
|discussion = https://moodle.org/plugins/view.php?plugin=block_progress
|maintainer = [[User:Michael de Raadt|Michael de Raadt]]
|float = right
}}
[[Blocks|Back to Blocks page]]

== Features ==

[[Image:Bar_in_block_-_with_details.png|right|A progress bar for a student]]
* The Progress Bar is a time-management tool for students.
* It visually shows what activities/resources a student is supposed to interact with in a course.
* It is colour coded so students can quickly see what they have and have not completed/viewed.
* The teacher selects which pre-existing activities/resources are to be included in the Progress Bar and when they should be completed/viewed.
* Ordering can be done by times/deadlines or by the ordering of activities in the course.
* There is an overview page allowing teachers to see the progress of all students in a class, which is helpful for finding students at risk.
* Adding the Progress Bar block to the [[Dashboard]] shows users a combined view of their progress on all courses (where the block is set up).
[[Image:Overview_of_students.png|The overview page]]

== Installation ==

The Progress Bar block is added like other blocks ([[Installing_contributed_modules_or_plugins|How to install a block]]).

== Global settings ==

The Progress Bar block has a number of global settings that will be seen on installation and can be accessed later at Site administration > Plugins > Blocks > Progress Bar.
[[Image:Progress_Bar_Global_settings.png|thumb|Global settings]]
* ''Course name to show on Dashboard'' The block can be added to the dashboard and combines visible Progress Bar block content from the courses a user is enrolled in. By default, the course name shown for each relevant course, is the short course name, but some institutions/organisations may not think this is appropriate in relation to their course naming scheme, so a long course name can be selected.
* ''Colours'' By default, the colours used in the block are red, blue and green. In certain cultures these colours may not have the same meaning. Also, institutions/organisations may wish to use colours that match their theme.
* ''Show inactive students in Overview'' In most cases, inactive students are not wanted in course lists, such as the Overview page associated with the Progress Bar. However, in some cases, such as ongoing courses, inactive students might need to be visible on the Overview page.

== Capabilities (Controlling who sees parts of the block) ==

The block uses a number of capabilities that are added when the block is installed.
[[Image:Progress_Bar_Capabilities.png|thumb|Global settings]]
* ''Add a Progress Bar block to My home'' (block/progress:myaddinstance) Controls whether the Progress Bar can be added by a user to the Dashboard (formerly My home) page. By default, this is allowed for all authenticated users.
* ''Add a new Progress Bar block'' (block/progress:addinstance) Controls whether the Progress Bar block can be added to a course page. By default, this is allowed for the following archetypal roles.
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''View course overview of Progress bars for all students'' (block/progress:overview) Controls whether the Overview page and the button on the Progress Bar block used to access the Overview page can be viewed by a user. By default, this is allowed for the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''Show the bar in the Progress Bar block'' (block/progress:showbar) Controls whether the bar in the Progress Bar block is shown to a user. The reason for not showing this to certain users is that this might not be relevant and possibly annoying. By default, this is shown to the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Student (student)
** (and Admins)

== Setting up a Progress Bar in a course ==

Once the progress bar is installed, you can use it in a course as follows.
# Turn editing on
# Create your activities/resources as normal
# Add the Progress Bar block to your page ([[Blocks|How to add a block]])
# Move your Progress Bar block into a prominent position (click and drag the block title)
# Choose to:
#* Monitor all activities (pre-fills configuration page)
#* Select which activities to monitor (start from scratch)
# Set the activities/resources you want shown in the block to "Yes" and those you don't to "No".
# Set the date and time when the activity/resource is expected to be completed/viewed by (some activities have deadlines set, if so, that deadline can be used or another can be set in the Progress Bar block configuration).
# Save changes.

Hidden items will not appear in the Progress Bar until they are unhidden. This is useful for a scheduled release of activities.

== Links ==

* [http://moodle.org/plugins/view.php?plugin=block_progress Block code in Plugins repository]
* [http://tracker.moodle.org/browse/CONTRIB/component/10489 Bug Tracker Page] (Please report bugs here.)
* [https://github.com/deraadt/moodle-block_progress Git repository]

==Available translations==
This plugin has been (partly or completely) [https://docs.moodle.org/dev/Translation translated] in [http://lang.moodle.org/ AMOS] to these 24 languages by February 2016:
* Basque (eu)
* Catalan (ca)
* Chinese (Traditional/Big5) (zh_tw)
* Croatian (hr)
* Czech (cs)
* Dansk (da)
* Dutch (nl)
* Finnish (fi)
* French (fr)
* German (de)
* Hebrew (he)
* Japanese (ja)
* Lietuvių (lt)
* Macedonian (mk)
* Mongolian (mn)
* Norwegian (no)
* Polish (pl)
* Portuguese (Brazil) (pt_br)
* Romanian (ro)
* Russian (ru)
* Serbian (Cyrillic) (sr_cr)
* Serbian (Latin) (sr_lt)
* Spanish (International) (es)
* Spanish - Mexico (es_mx)

The documentation (this page that you are reading now) is available in spanish at [https://docs.moodle.org/all/es/Bloque_de_barra_de_progreso Bloque de barra de progreso].

== Acknowledgements ==

* Thanks to:
** Toshimi Hatanaka for contributing a Japanese translation
** Yvonne Schneider and Joachim Vogelgesang for contributing a German translation
** Maria João Spilker for contributing a Portuguese-Brazilian translation
** Pieter Wolters for contributing a Dutch translation
** Fernando Sánchez for contributing a Spanish translation
** Fabien Sartoretti for contributing a French translation
** Adam Levy for contributing queries and strings for Hot Potatoes support
** Petras Virzintas for contributing queries for Turnitin support
** Willian Mano for helping with the modern look CSS
** Matthieu Rolland for contributing queries for the Questionnaire module
** Johan Reinalda for contributing global config changes for block colours
** German Valero for Spanish - Mexico translation of the block and this page.

===Videos===

<mediaplayer>http://www.youtube.com/watch?v=06LA5Cv9Fhw</mediaplayer>

<mediaplayer>http://www.youtube.com/watch?v=ekH8IfCyGzM</mediaplayer>

[[Category:Contributed code]]
[[Category:Block]]

[[es:Bloque de barra de progreso]]

Learning analytics

2016-02-24T23:45:16Z

Deraadt: Adding Feedback and Questionnaire activities

Progress Bar block

2016-02-24T00:11:10Z

Deraadt: Adding global settings and capabilities

{{Infobox plugin
|type = Block, Progress bar
|entry = https://moodle.org/plugins/view.php?plugin=block_progress
|tracker = https://tracker.moodle.org/browse/CONTRIB/component/10489/?selectedTab=com.atlassian.jira.jira-projects-plugin:component-summary-panel
|discussion = https://moodle.org/plugins/view.php?plugin=block_progress
|maintainer = [[User:Michael de Raadt|Michael de Raadt]]
|float = right
}}
[[Blocks|Back to Blocks page]]

== Features ==

[[Image:Bar_in_block_-_with_details.png|right|A progress bar for a student]]
* The Progress Bar is a time-management tool for students.
* It visually shows what activities/resources a student is supposed to interact with in a course.
* It is colour coded so students can quickly see what they have and have not completed/viewed.
* The teacher selects which pre-existing activities/resources are to be included in the Progress Bar and when they should be completed/viewed.
* Ordering can be done by times/deadlines or by the ordering of activities in the course.
* There is an overview page allowing teachers to see the progress of all students in a class, which is helpful for finding students at risk.
* Adding the Progress Bar block to the [[Dashboard]] shows users a combined view of their progress on all courses (where the block is set up).
[[Image:Overview_of_students.png|The overview page]]

== Installation ==

The Progress Bar block is added like other blocks ([[Installing_contributed_modules_or_plugins|How to install a block]]).

== Global settings ==

The Progress Bar block has a number of global settings that will be seen on installation and can be accessed later at Site administration > Plugins > Blocks > Progress Bar.
[[Image:Progress_Bar_Global_settings.png|thumb|Global settings]]
* ''Course name to show on Dashboard'' The block can be added to the dashboard and combines visible Progress Bar block content from the courses a user is enrolled in. By default, the course name shown for each relevant course, is the short course name, but some institutions/organisations may not think this is appropriate in relation to their course naming scheme, so a long course name can be selected.
* ''Colours'' By default, the colours used in the block are red, blue and green. In certain cultures these colours may not have the same meaning. Also, institutions/organisations may wish to use colours that match their theme.
* ''Show inactive students in Overview'' In most cases, inactive students are not wanted in course lists, such as the Overview page associated with the Progress Bar. However, in some cases, such as ongoing courses, inactive students might need to be visible on the Overview page.

== Capabilities (Controlling who sees parts of the block) ==

The block uses a number of capabilities that are added when the block is installed.
[[Image:Progress_Bar_Capabilities.png|thumb|Global settings]]
* ''Add a Progress Bar block to My home'' (block/progress:myaddinstance) Controls whether the Progress Bar can be added by a user to the Dashboard (formerly My home) page. By default, this is allowed for all authenticated users.
* ''Add a new Progress Bar block'' (block/progress:addinstance) Controls whether the Progress Bar block can be added to a course page. By default, this is allowed for the following archetypal roles.
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''View course overview of Progress bars for all students'' (block/progress:overview) Controls whether the Overview page and the button on the Progress Bar block used to access the Overview page can be viewed by a user. By default, this is allowed for the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Manager (manager)
** Course creator (coursecreator)
** (and Admins)
* ''Show the bar in the Progress Bar block'' (block/progress:showbar) Controls whether the bar in the Progress Bar block is shown to a user. The reason for not showing this to certain users is that this might not be relevant and possibly annoying. By default, this is shown to the following archetypal roles.
** Non-editing teacher (teacher)
** Teacher (editingteacher)
** Student (student)
** (and Admins)

== Setting up a Progress Bar in a course ==

Once the progress bar is installed, you can use it in a course as follows.
# Turn editing on
# Create your activities/resources as normal
# Add the Progress Bar block to your page ([[Blocks|How to add a block]])
# Move your Progress Bar block into a prominent position (click and drag the block title)
# Choose to:
#* Monitor all activities (pre-fills configuration page)
#* Select which activities to monitor (start from scratch)
# Set the activities/resources you want shown in the block to "Yes" and those you don't to "No".
# Set the date and time when the activity/resource is expected to be completed/viewed by (some activities have deadlines set, if so, that deadline can be used or another can be set in the Progress Bar block configuration).
# Save changes.

Hidden items will not appear in the Progress Bar until they are unhidden. This is useful for a scheduled release of activities.

== Links ==

* [http://moodle.org/plugins/view.php?plugin=block_progress Block code in Plugins repository]
* [http://tracker.moodle.org/browse/CONTRIB/component/10489 Bug Tracker Page] (Please report bugs here)
* [http://cvs.moodle.org/contrib/plugins/blocks/progress/ CVS Repository]

==Available translations==
This plugin has been (partly or completely) [https://docs.moodle.org/dev/Translation translated] in [http://lang.moodle.org/ AMOS] to these 14 languages by Sept 2014:
* Basque (eu)
* Chinese (Traditional/Big5) (zh_tw)
* Dutch (nl)
* Finnish (fi)
* French (fr)
* German (de)
* Hebrew (he)
* Japanese (ja)
* Macedonian (mk)
* Norwegian (no)
* Portuguese (Brazil) (pt_br)
* Russian (ru)
* Spanish (International) (es)
* Spanish - Mexico (es_mx)

The documentation (this page that you are reading now) is available in spanish at [https://docs.moodle.org/all/es/Bloque_de_barra_de_progreso Bloque de barra de progreso].

== Acknowledgements ==

* Thanks to:
** Toshimi Hatanaka for contributing a Japanese translation
** Yvonne Schneider and Joachim Vogelgesang for contributing a German translation
** Maria João Spilker for contributing a Portuguese-Brazilian translation
** Pieter Wolters for contributing a Dutch translation
** Fernando Sánchez for contributing a Spanish translation
** Fabien Sartoretti for contributing a French translation
** Adam Levy for contributing queries and strings for Hot Potatoes support
** Petras Virzintas for contributing queries for Turnitin support
** Willian Mano for helping with the modern look CSS
** Matthieu Rolland for contributing queries for the Questionnaire module
** Johan Reinalda for contributing global config changes for block colours
** German Valero for Spanish - Mexico translation of the block and this page.

===Videos===

<mediaplayer>http://www.youtube.com/watch?v=06LA5Cv9Fhw</mediaplayer>

<mediaplayer>http://www.youtube.com/watch?v=ekH8IfCyGzM</mediaplayer>

[[Category:Contributed code]]
[[Category:Block]]

[[es:Bloque de barra de progreso]]

Capabilities/block/progress:addinstance

2016-02-24T00:07:48Z

Deraadt: Created page with "This capability controls whether the Progress Bar block can be added to a course page. By default, this is allowed for the following archetypal roles. * Teacher (editingteac..."

This capability controls whether the Progress Bar block can be added to a course page.

By default, this is allowed for the following archetypal roles.
* Teacher (editingteacher)
* Manager (manager)
* Course creator (coursecreator)
* (and Admins)

Capabilities/block/progress:overview

2016-02-24T00:07:45Z

Deraadt: Created page with "This capability controls whether the Overview page and the button on the Progress Bar block used to access the Overview page can be viewed by a user. By default, this is allo..."

This capability controls whether the Overview page and the button on the Progress Bar block used to access the Overview page can be viewed by a user.

By default, this is allowed for the following archetypal roles.
* Non-editing teacher (teacher)
* Teacher (editingteacher)
* Manager (manager)
* Course creator (coursecreator)
* (and Admins)

Capabilities/block/progress:showbar

2016-02-24T00:07:42Z

Deraadt: Created page with "This capability controls whether the bar in the Progress Bar block is shown to a user. The reason for not showing this to certain users is that this might not be relevant and..."

This capability controls whether the bar in the Progress Bar block is shown to a user.

The reason for not showing this to certain users is that this might not be relevant and possibly annoying.

By default, this is shown to the following archetypal roles.
* Non-editing teacher (teacher)
* Teacher (editingteacher)
* Student (student)
* (and Admins)

Capabilities/block/progress:myaddinstance

2016-02-24T00:05:38Z

Deraadt: Created page with "This capability controls whether the Progress Bar can be added by a user to the Dashboard (formerly My home) page. By default, this is allowed for all authenticated users."

This capability controls whether the Progress Bar can be added by a user to the Dashboard (formerly My home) page. By default, this is allowed for all authenticated users.

File:Progress Bar Capabilities.png

2016-02-23T23:53:14Z

Deraadt:

File:Progress Bar Global settings.png

2016-02-23T23:36:48Z

Deraadt:

Moodle research

2016-02-01T04:35:23Z

Deraadt: Redirecting to new Moodle research page on Dev docs. Papers listed have been copied to Moodle Research Library

#REDIRECT [[:dev:Moodle_research]]

Learning analytics

2016-02-01T04:22:46Z

Deraadt: Correcting Event 2 link

Learning analytics

2016-02-01T04:15:14Z

Deraadt: Adding some links

Learning analytics

2016-01-13T04:34:20Z

Deraadt: Adding link to assessment analytics work

Learning analytics

2016-01-12T00:02:54Z

Deraadt: Adding learning analytics dimensions image

File:Learning-analytics.png

2016-01-11T23:57:39Z

Deraadt:

Learning analytics

2015-11-03T01:24:23Z

Deraadt: Adding Git link for MAV

Learning analytics

2015-10-30T03:14:57Z

Deraadt: Adding external integrations

Statistics

2014-10-28T03:29:11Z

Deraadt: Updating instructions for forcing statistics generation in 2.7 onwards.

{{Course reports}}
If statistics are enabled for the site, graphs and tables of user activity may be generated.

[[File:Statistics.png]]

The statistics graphs and tables show how many '''hits''' there have been on various parts of your site during various time frames. They '''do not''' show how many distinct users there have been. They are processed daily at a time you specify. You must enable statistics before you will see anything.

==Enabling statistics==

Statistics must be enabled by a site administrator in ''Administration > Site administration > Advanced features''.

In Moodle 2.4.2 onwards, once statistics have been enabled, the screen to configure them becomes visible as a link in ''Administration > Site administration > Server > Statistics''. (In older versions the link was always available irrespective of whether statistics was enabled.)

The Course overview report will also then be accessible from ''Administration> Site administration > Reports''.

==Site administration settings==

Various settings for statistics may be set by an administrator in ''Administration > Site administration > Server > Statistics''.

As stats processing is quite resource intensive, it is recommended that you should set the stats processing to start in the early morning.

:''TIP:'' Set the stats processing to start an hour before your automated course backups are scheduled to start, then set the maximum runtime to 1 hour. This ensures that stats are not being processed at the same time as course backups are being made.

==Statistics not working?==

If statistics isn't working and you have checked all the obvious (such as whether it's enabled), check ''Settings > Site administration > Plugins > Activity modules'' for any old hidden modules in the database which miss the files in the ''moodle/mod'' folder on your server. If you find any, they should be deleted.

You can also try limiting the length of time logs are kept for to reduce the size of the tables. Go to ''Settings > Site administration > Server > Cleanup'' to set this.

To run stats manually, go to the database, go to the mdl_config table and set statslastdaily, statslastweekly and statslastmonthly to 0 (leave statslastmonthly alone if you think it might be large logtables causing the problem). Then go to ''Settings > Site administration > Server > Scheduled tasks'' and look for the task "Background processing for statistics"; set this to be a minute or two into the future by adjusting the hour and minute values. If you manually run cron, you should see output there showing that stats are processing, but be patient if it appears to hang - this can take between 5 mins and several hours depending on how big your site is, so just leave it going. Afterwards, you might want to return the Scheduled task's values back to asterisks so that it returns to the defined schedule.

==Viewing statistics==

A manager, teacher or non-editing teacher (or any other user with the capability [[Capabilities/report/stats:view|report/stats:view]]) can view statistics for their course in ''Administration > Course administration > Reports > Statistics''.

An administrator can view statistics for the site in ''Administration > Site administration > Reports > Statistics''.

[[Category:Site administration]]

[[de:Statistiken]]
[[es:Estadísticas]]
[[fr:Statistiques]]

Progress Bar block

2014-08-04T03:23:02Z

Deraadt: Adding My home feature

Progress Bar block

2014-08-04T01:49:54Z

Deraadt: Adding German to Acknowledgements.

Accessibility

2014-07-10T04:20:50Z

Deraadt: Adding some more info and links

{{About Moodle}}

Moodle's goal is to be fully accessible and usable for all users regardless of ability.

This page describes the current state of accessibility in Moodle as well as our plans for the future.

== Established practices ==

Moodle core developers spend a lot of time making sure new developments are accessible. Part of the process when building new code in Moodle is to follow established best practices and part of the process for accepting new code into core is to test pages carefully and gather feedback from experts.

== Screen-reader support ==

From Moodle 2.7 onwards, [[:dev:Moodle_2.7_release_notes#Screen_reader_support|supported screen-reader/browser configurations]] are described in release notes.

== Conformance to standards ==

The Moodle platform is a complex system with many parts. Its code is always evolving. Modules can be enabled and disabled. The interface can be heavily customised using themes and thousands of settings. Actual content can be produced by any teacher or any student. As such it is impossible to say with 100% certainty whether Moodle or any site based on Moodle is absolutely accessible or not. Accessibility is not a state, it is a process of continuous improvement in response to our users and the wider technical environment.

=== [http://www.w3.org/TR/WCAG20 WCAG 2.0] ===

* When deciding how Moodle should present its content for best Web accessibility, the [http://www.w3.org/TR/WCAG20 WCAG 2.0] guidelines is followed.
* We hope to have document here soon discussing how well Moodle meets WCAG 2.0 requirements.

=== [http://www.w3.org/TR/ATAG20 ATAG 2.0] ===

* As Moodle is a place to construct content (as well as consume content), we also refer to the [http://www.w3.org/TR/ATAG20 ATAG 2.0] guidelines.
* In Moodle 2.7 a new editor Atto was added that not only helps to improve how everyone can use the editor itself, but also helps to improve the accessibility of the content produced with it.

=== [http://www.w3.org/TR/wai-aria ARIA 1.0] ===

* As many parts of the Moodle user interface are dynamic and interactive, we follow the [http://www.w3.org/TR/wai-aria ARIA] recommendations to inform assistive technologies, such as screen-readers.

=== Section 508 (US) ===

* As Moodle is used by US Government agencies, the US Section 508 amendment can be relevant to Moodle.
* Moodlerooms (a Moodle Partner) have a [http://www.moodlerooms.com/accessibility VPAT statement] on their web site.

== Discussions ==

One of the main places accessibility work is being carried out right now is on the Moodle Accessibility Collaboration Group mailing list, see http://collaborate.athenpro.org/group/moodle/

There are also many discussion on issues in the [https://tracker.moodle.org/browse/MDL/component/10083/?selectedTab=com.atlassian.jira.jira-projects-plugin:component-issues-panel Moodle Tracker]

== Known Bugs and issues ==

This is [https://tracker.moodle.org/issues/?jql=component%20%3D%20Accessibility%20AND%20project%20%3D%20MDL%20AND%20resolution%20%3D%20Unresolved%20ORDER%20BY%20priority%20DESC the main list of accessibility issues], organised by priority. This list is always changing.

== Areas of ongoing development ==

* [https://tracker.moodle.org/browse/MDL-39663 Filepicker]
* [https://tracker.moodle.org/browse/MDL-41773 Forum]

== See also ==

[[dev:Accessibility|Accessibility for Moodle Developers]]

Security FAQ

2014-06-20T06:23:55Z

Deraadt: Removing duplicated content and directing to the security procedures page.

{{Security}}
==How do I report a security issue?==

See [[Moodle_security_procedures#How_can_I_report_a_security_issue.3F|How to report a security issue]] in the Moodle security procedures page.

Previously fixed security issues are listed in the [http://moodle.org/security/ Moodle.org Security news]. If you are unsure whether a problem has been fixed or not, it's best to report it anyway.

==How can I keep my site secure?==

It's good practice to always use the latest stable release of the version you are using. It is safe to upgrade to a more recent version on the branch you are using, say from Moodle 2.X.1 to the latest version on the 2.X branch. [[Git for Administrators|Downloading via Git]] makes it very easy way to do this.

==How do I keep track of recent security issues?==

* [[Site registration | Register your Moodle site with moodle.org]], making sure to enable the option of being notified about security issues and updates. After your registration is accepted, your email address will be automatically added to our low-volume security alerts mailing list.

* Eventually, all important security issues are published to the general public via the [http://moodle.org/mod/forum/view.php?f=996 Moodle Security forum]. You can subscribe to the [http://moodle.org/rss/file.php/1/1/forum/996/rss.xml forum RSS feed] to automatically add new issues in your favourite feed reader or portal. You can also follow [http://twitter.com/moodlesecurity moodlesecurity on Twitter].

==Who is able to view security issues in the Tracker?==

Depending upon the security level of a Tracker issue, access is restricted to developers, testers or members of the security team.

==Which versions of Moodle are supported?==

Currently supported versions are listed on [http://download.moodle.org/ download.moodle.org].

==My site was hacked. What do I do?==

See [[Hacked site recovery]].

==How can I reduce spam in Moodle?==

See [[Reducing spam in Moodle]].

==How can I increase privacy in Moodle?==

See [[Increasing privacy in Moodle]].

==How do I enable reCAPTCHA?==

To add spam protection to the [[Email-based self-registration]] new account form with a CAPTCHA element:

#Obtain a reCAPTCHA key from http://recaptcha.net by [https://admin.recaptcha.net/accounts/signup/?next= signing up for an account] (free) then entering a domain.
#Copy and paste the public and private keys provided into the ''recaptchapublickey'' and ''recaptchaprivatekey'' fields in the manage authentication common settings in ''Administration > Plugins > Authentication > [[Manage authentication]]''.
#Click the "Save changes" button at the bottom of the page.
#Follow the settings link for email-based self-registration in ''Administration > Plugins > Authentication > Manage authentication'' and enable the reCAPTCHA element.
#Click the "Save changes" button at the bottom of the page.

==How can I run the security overview report?==

To run the [[Security overview|security overview report]], go to ''Administration > Site administration > Reports > Security overview''.

==See also==

* Using Moodle [http://moodle.org/mod/forum/view.php?id=7301 Security and Privacy forum]

[[Category:FAQ]]

Moodle security procedures

2014-06-20T04:05:41Z

Deraadt: Adding email for security issues.

{{Security}}

We treat security issues in Moodle software very seriously. Even though we dedicate a lot of time designing our code to avoid such problems, it is inevitable in a project of this size that new vulnerabilities will occasionally be discovered.

==Disclosure policy==

We practice ''responsible disclosure'', which means we have a policy of disclosing all security issues that come to our attention, but only after we have solved the issue and given registered Moodle sites time to upgrade or patch their installations.

We ask that when reporting a security issue, you observe these same guidelines, and beyond communicating with the security team, do not share your knowledge of security issues with the public at large.

==How can I report a security issue?==

Please "[http://tracker.moodle.org/secure/CreateIssue.jspa Create a new issue]" in the Moodle Tracker describing the problem (and solution if possible) in detail. Make sure you set the security level accurately to make sure that the security team sees it. Bugs classified as a "Serious security issue" are hidden from everyone apart from the security team and the person who reported the problem. If you are not sure whether an issue is a security issue, you should still create a new issue in the tracker for review, using the security level "Could be a security issue".

If you are not able to create an issue on the Moodle Tracker, you may send an email to security@moodle.org, however this is less secure than using the Tracker.

Please do ''not'' post about security issues in the forums on moodle.org or elsewhere. This will cause the issue to be more widely known before a fix can be prepared.

==How we deal with a reported security issue==

# The security team reviews the issue and evaluates its potential impact on all supported versions of Moodle.
# The security team works with the issue reporter to resolve the problem, following the [[:dev:Process#Security_issues|Security issue development process]] and keeping details of the problem and its solution hidden until a release is made.
# New versions are created and tested.
# New packages are created and made available on download.moodle.org.
# Advisories are mailed to administrators of registered Moodle sites, giving a period of time when they can upgrade before the issue becomes public.
# A public announcement is made about the security issue in the [http://moodle.org/mod/forum/view.php?id=7128 Moodle security news forum].

==See also...==
* [[:dev:Process#Security_issues|Security issue development process]]

[[de:Sicherheitsprozeduren]]