MoodleDocs - User contributions [en]

MediaWiki:MoodleDocsVersionLinks

2026-04-14T09:00:09Z

Tsala: 5.2

4.5 docs: /405/en/{{FULLPAGENAMEE}}
5.2 docs: /502/en/{{FULLPAGENAMEE}}
5.1 docs: /501/en/{{FULLPAGENAMEE}}
5.0 docs: /500/en/{{FULLPAGENAMEE}}

report/view

2026-02-05T07:12:57Z

Tsala: redirect

#redirect [[Course reports]]

Redis cache store

2025-12-16T10:49:39Z

Tsala: /* Configuring Redis in Moodle */ screenshot added from 4.4 docs provided by Meirza Arson

{{Performance}}
The Redis cache store is one of the best options to handle session and application cache as it supports: data guarantee, locking, key awareness. (and also can be used for [[Session_handling#Redis_session_driver|user's sessions caching]] in the config.php file). Unfortunately due to the data types it supports and the data involved, it isn't fully compatible with the request cache, and so we'll only be configuring it for the Application and Session caches in this document. That isn't to say you couldn't have parts of the request cache using Redis, you would just need to manually set those cached objects to use Redis instead (and there are quite a few of them!).

Before Redis is available as a cache store, you will need to install Redis service (daemon) on your Moodle server, locally in case of a single Moodle app node architecture or externally if you are using a cluster of Moodle nodes. only then, you can configure Redis as an application or session level cache store.

If you are configuring a cluster of Moodle servers/nodes, the Redis service (daemon) should be installed on an external server and all Moodle nodes (servers/instances) should point to that external Redis, so that all the user's cached data (namely Session) is available when the user is using/connected to any of the Moodle nodes. An external Redis (NoSQL) service can be installed on the main SQL server alongside the MySQL/MariaDB service, just make sure you have enough memory allocated on that server for both services.

A good practice is to give the Redis cache store prefix a proper short name and not leave it empty, as later on, it might conflict with user's session Redis cache you might choose to use, or other Moodle instances that will be installed on the same server. for example "my-school-name_cs_", where you replace "my-school-name" with your short school name. (and if you are also using a user's session store on the config.php file, you might like to prefix it with "my-school-name_us_")

When using a cluster setup with several Moodle instances on each node that belong to different Schools/Institutes/clients, make sure that you use the same Prefix for all Moodle instances that are on different nodes and are of the same School/Institute/Client.

Moodle also supports connecting to '''Redis Cluster''', which is Redis’s built-in mechanism for distributing data across multiple Redis nodes. Redis Cluster provides horizontal scaling, automatic failover, and high availability, making it ideal for large or high-traffic Moodle deployments, or sites using cloud-managed Redis services. Using a Redis Cluster does not change the user-facing experience, it only enhances performance and reliability in distributed Moodle architectures.

==Installing Redis server==
There are plenty of guides on the internet on how to install Redis, so we won't repeat them here. Since Redis is a listening service, once it's installed it'll be ready to use (and should already be running) and ready to receive requests from Moodle, with no further configuration needed. With that said however, it's still wise to have a look through the configuration options and decide what is best for you and your setup - the DigitalOcean guide is a good place to start for adjusting these settings, as they're basically all in the redis.conf file.
*[https://www.digitalocean.com/community/tutorials/how-to-install-and-secure-redis-on-ubuntu-22-04 DigitalOcean's How To Install and Secure Redis on Ubuntu 22.04]
*[[Session_handling#Redis_session_driver]] and [https://www.digitalocean.com/community/tutorials/how-to-set-up-a-redis-server-as-a-session-handler-for-php-on-ubuntu-14-04 How to Set Up a Redis Server as a Session Handler for PHP]
*Install [https://dl.iuscommunity.org/pub/ius/stable/CentOS/7/x86_64/repoview/redis5.html Redis 5] via IUS CentOS 7 repository.
*[https://github.com/zkteco-home/redis-windows Redis Windows Port - zkteco-home/redis-windows on GitHub]
==Installing Redis php driver==
* For CentOS, you can use either [https://rpms.remirepo.net/ Remi] or [https://ius.io/ IUS] repositories, and install the [https://dl.iuscommunity.org/pub/ius/stable/CentOS/7/x86_64/repoview/php71u-pecl-redis.html php71u-pecl-redis] driver.
*[https://gist.github.com/hollodotme/418e9b7c6ebc358e7fda Redis php-fpm 7 driver on Ubuntu 14.04]
* [https://pecl.php.net/package/redis Windows PHP extensions] including DLLs for Windows. Check your PHP version, CPU (64bit or x86) and thread-safe value (see Site Admin > Server > PHP Info) to get the right version; add DLL file to ext directory, add 'extension=php_redis.dll' entry to php.ini and restart your web server.
==Configuring Redis in Moodle==
*Navigate to Site admin > Plugins > Caching > Configuration.
*When installed, you should see a green tick next to "Redis" under "Installed cache stores" and a link to add an instance.
[[File:Redis_cache_ready.png]]
*Click "Add instance".
**Give your Redis instance a name, like "Redis1".
**Tick the Cluster mode checkbox if you want to use the Redis Cluster. If the checkbox is disabled, it means your PHP Redis extension does not support the Cluster feature.
**Set the IP:port for the Redis server. If it is on the same machine, the default will be 127.0.0.1:6379. If cluster mode is enabled, specify servers separated by a new line, for example: ''172.23.0.11'' ''172.23.0.12'' ''172.23.0.13''
**Specify the file path to the Certificate Authority (CA) certificate to verify the TLS/SSL connection to a Redis server, confirming the server's authenticity. Leave it blank if you prefer not to use it.
**Enter the password for your Redis server. Leave it blank if you prefer not to use it.
**Enter a short, unique prefix that will be added to all Redis keys created by this Moodle site. Leave it blank if you prefer not to use it.
**Choose the method Moodle will use to encode cache data before storing it in Redis. If available, igbinary is recommended because it is faster and uses less memory than the default PHP serializer.If your system does not have igbinary installed, Moodle will fall back to the standard PHP serializer.
**Select whether Moodle should compress cache data before storing it in Redis.
**Set the maximum number of seconds Moodle will wait for a Redis node to accept a connection. If the Redis server is busy, overloaded, or unreachable, Moodle will stop waiting after this timeout and report a connection failure. Default is 3 seconds.
**Click the Save Changes button, and the new instance should appear under "Configured store instances" with a "Ready" tick.
[[File:add redis store.png|border|frameless|831x831px]]
*Under "Stores used when no mapping is present" click '''Edit mappings". Set "Redis1" (or the name used earlier) for the "Application" and "Session" caches.''' Note that Redis won't appear under the "Request" Cache section, since it isn't fully compatible with all of the different parts of the request cache. (Refer to the [[Caching]] page to better understand how the Moodle Universal Cache works).
[[File:Set_Redis_as_default_Application_and_Session_cache.png]]
*After saving this, you should see Redis as the cache for most cache stores, and should hopefully see a performance boost almost immediately.
*Next Step: Celebrate!

==See also==
*[https://gist.github.com/kabel/10023961 Monitor Redis stats (a php one page app)]
*MDL-48468 : Add a Redis cache store to Moodle core
*Redis lock : https://github.com/open-lms-open-source/moodle-local_redislock (get it into core: https://tracker.moodle.org/browse/MDL-67022)
*[https://redis.io/ Redis.io]
[[de:Redis Cache]]

File:add redis store.png

2025-12-16T10:44:16Z

Tsala:

Session handling

2025-12-15T11:19:21Z

Tsala: /* Redis session driver */ copying change from 4.4 docs

{{Server settings}}
An administrator can change the following settings in 'Session Handling' in the Site administration.

Once someone logs in to your Moodle server, the server starts a session. The session data allows the server to track users as they access different pages.
==Use database for session information==
Moodle needs to store the session data in some storage. By default either file or database session storage is selected, this option allows admin to change it. Large installation should use memcached driver described below.

Note that this option disappears after setting the $CFG->session_handler_class in config.php file.
==Timeout==
If users don't load a new page during the amount of time set here, Moodle will end their session and log them out.

Be sure this time frame is long enough to cover the longest test your teachers may offer. If a student is logged out while they are taking a test, their responses to the test questions may be lost.
==Cookie prefix==
Most of the time, you can leave this blank, unless you are running more than one Moodle site on the same server. In this case, you will want to customize the name of the cookie each Moodle site uses to track the session. This enables you to be logged into more than one Moodle site at the same time.

Note: If you change "Cookie prefix" or "Cookie path" you will need to login again as the changes take effect immediately.
==Cookie path==
The relative path to this Moodle installation, this may be used to force sending of Moodle session cookie to parent directories. Invalid values are ignored automatically.
==Cookie domain==
This can be used to send session cookies to higher domains instead of just the server domain. This may be useful for some SSO solutions. Invalid values are ignored automatically.
==Session drivers==
User sessions may be stored in different backends. Session drivers can be configured only in config.php file - see examples in [https://github.com/moodle/moodle/blob/e1d05182a60ab7df055dab9eca3ddd48e47bd60a/config-dist.php#L338 config-dist.php] file.
===Memcached session driver===
The Memcached session driver is the fastest driver. It requires external memcached server and memcached PHP extension. Server cluster nodes must use shared session storage.

Configuration options in config.php:
<syntaxhighlight lang="php">
$CFG->session_handler_class = '\core\session\memcached';
$CFG->session_memcached_save_path = '127.0.0.1:11211';
$CFG->session_memcached_prefix = 'memc.sess.key.';
$CFG->session_memcached_acquire_lock_timeout = 120;
$CFG->session_memcached_lock_expire = 7200; // Ignored if memcached extension <= 2.1.0
</syntaxhighlight>
Notes:
* Make sure the memcached server has enough memory.
* Use different prefix when storing sessions from multiple Moodle sites in one server.
* If PECL memcached extension version installed is less that 2.2.0, the locking works differently from other drivers - the lock is expired/released at the end of timeout - see MDL-42485.
* '''Don't use the same memcached server for both sessions and MUC. Events triggering MUC caches to be purged leads to MUC purging the memcached server - thus terminating ALL sessions.'''
* The <code php>$CFG->session_memcached_number_of_replicas</code> option is no longer supported.
For windows users, PHP.net only supplies binaries for memcache, (and not memcached). (http://windows.php.net/downloads/pecl/releases/)

(As of 2.7, two different contribs exist for memcache session handling - see MDL-42011 - it seems the OU one doesn't use prefix/lock_expire for some reason... possibly better to use the catalyst patch, where the only difference to the above config.php is the spelling of memcache(d).)
===File session driver===
This driver is used by default in new installation.

Configuration options in config.php:
<syntaxhighlight lang="php">
$CFG->session_handler_class = '\core\session\file';
$CFG->session_file_save_path = $CFG->dataroot.'/sessions';
</syntaxhighlight>
Notes:
* File based sessions require file system that supports file locking.
===Database session driver===
This type of driver was used by default in Moodle 2.0-2.5.
<syntaxhighlight lang="php">
$CFG->session_handler_class = '\core\session\database';
$CFG->session_database_acquire_lock_timeout = 120;
</syntaxhighlight>
Notes:
* If you are using MySQL/MariaDB make sure that \'max_allowed_packet\' in my.cnf (or my.ini) is at least 4M.
* The performance is relatively low, it is not recommended for large sites.

===Redis session driver===
The [[Redis]] session driver is available in Moodle 3.1.3 onwards (see MDL-54606). It requires a [[Redis_cache_store#Installing_Redis_server|Redis server]] and the [[Redis_cache_store#Installing_Redis_php_driver|Redis extension]].

Configuration options in config.php:
<syntaxhighlight lang="php">
$CFG->session_handler_class = '\core\session\redis';
$CFG->session_redis_host = '127.0.0.1';
$CFG->session_redis_port = 6379; // Optional.
$CFG->session_redis_database = 0; // Optional, default is db 0.
$CFG->session_redis_auth = ''; // Optional, default is don't set one.
$CFG->session_redis_prefix = ''; // Optional, default is don't set one.
$CFG->session_redis_acquire_lock_timeout = 120;
$CFG->session_redis_acquire_lock_retry = 100; // Optional, default is 100ms (from 3.9)
$CFG->session_redis_lock_expire = 7200;
$CFG->session_redis_serializer_use_igbinary = false; // Optional, default is PHP builtin serializer.
</syntaxhighlight>
Notes:
* If <code php>CFG->session_redis_host</code> only one host is specified, the session will establish a single Redis connection. When multiple hosts are listed, separated by commas, the session will connect to a Redis cluster.
* Be careful on changing the default serializer: it requires <code php>--enable-redis-igbinary</code> at ''phpredis'' extension compile time '''and''' you need to remove '''the previous session data''' before using Moodle again.

== Read only sessions ==
There was an experimental feature introduced in Moodle 3.9 and is now stable since 3.11. It allows certain pages to start readonly sessions which do not require a write lock with the aim of high performance at scale.

https://tracker.moodle.org/browse/MDL-58018
=== Configuration ===
==== 1) Using a compliant session store ====
In order to use readonly sessions you need to be using a session store which supports it, which includes database and redis.
==== 2) Mapping session caches ====
By default all MUC 'session caches' are stored in the $SESSION which is a subtle distinction that is easily misunderstood. MUC caches can be read and written at any time and are independent of the $SESSION being locked. So all cache definitions which have a mode of session need to be mapped to a store which is not in the session such as in redis. If this isn't done errors will be raised highlighting the configuration issue.
==== 3) Turning it on in config.php ====
$CFG->enable_read_only_sessions = true;
If you have concerns about rolling this out, there is a soft rollout mode which report on any issues and you could leave this on for say a month or two and then turn it on fully:
$CFG->enable_read_only_sessions_debug = true;
==== 4) Adding support for it to core and plugins ====
Various critical pages and web services in core have been declared and implemented as readonly, if you want to support readonly sessions please read:
https://docs.moodle.org/dev/Session_locks
==See also==
* [[Sessions FAQ]]
[[cs:admin/setting/sessionhandling]]
[[ja:セッションハンドリング]]
[[de:Sitzungsinformationen]]
[[es:Manejo de la sesión]]
[[fr:Gestion des sessions]]

Redis cache store

2025-12-15T11:15:47Z

Tsala: copying changes from 4.4 docs

{{Performance}}
The Redis cache store is one of the best options to handle session and application cache as it supports: data guarantee, locking, key awareness. (and also can be used for [[Session_handling#Redis_session_driver|user's sessions caching]] in the config.php file). Unfortunately due to the data types it supports and the data involved, it isn't fully compatible with the request cache, and so we'll only be configuring it for the Application and Session caches in this document. That isn't to say you couldn't have parts of the request cache using Redis, you would just need to manually set those cached objects to use Redis instead (and there are quite a few of them!).

Before Redis is available as a cache store, you will need to install Redis service (daemon) on your Moodle server, locally in case of a single Moodle app node architecture or externally if you are using a cluster of Moodle nodes. only then, you can configure Redis as an application or session level cache store.

If you are configuring a cluster of Moodle servers/nodes, the Redis service (daemon) should be installed on an external server and all Moodle nodes (servers/instances) should point to that external Redis, so that all the user's cached data (namely Session) is available when the user is using/connected to any of the Moodle nodes. An external Redis (NoSQL) service can be installed on the main SQL server alongside the MySQL/MariaDB service, just make sure you have enough memory allocated on that server for both services.

A good practice is to give the Redis cache store prefix a proper short name and not leave it empty, as later on, it might conflict with user's session Redis cache you might choose to use, or other Moodle instances that will be installed on the same server. for example "my-school-name_cs_", where you replace "my-school-name" with your short school name. (and if you are also using a user's session store on the config.php file, you might like to prefix it with "my-school-name_us_")

When using a cluster setup with several Moodle instances on each node that belong to different Schools/Institutes/clients, make sure that you use the same Prefix for all Moodle instances that are on different nodes and are of the same School/Institute/Client.

Moodle also supports connecting to '''Redis Cluster''', which is Redis’s built-in mechanism for distributing data across multiple Redis nodes. Redis Cluster provides horizontal scaling, automatic failover, and high availability, making it ideal for large or high-traffic Moodle deployments, or sites using cloud-managed Redis services. Using a Redis Cluster does not change the user-facing experience, it only enhances performance and reliability in distributed Moodle architectures.

==Installing Redis server==
There are plenty of guides on the internet on how to install Redis, so we won't repeat them here. Since Redis is a listening service, once it's installed it'll be ready to use (and should already be running) and ready to receive requests from Moodle, with no further configuration needed. With that said however, it's still wise to have a look through the configuration options and decide what is best for you and your setup - the DigitalOcean guide is a good place to start for adjusting these settings, as they're basically all in the redis.conf file.
*[https://www.digitalocean.com/community/tutorials/how-to-install-and-secure-redis-on-ubuntu-22-04 DigitalOcean's How To Install and Secure Redis on Ubuntu 22.04]
*[[Session_handling#Redis_session_driver]] and [https://www.digitalocean.com/community/tutorials/how-to-set-up-a-redis-server-as-a-session-handler-for-php-on-ubuntu-14-04 How to Set Up a Redis Server as a Session Handler for PHP]
*Install [https://dl.iuscommunity.org/pub/ius/stable/CentOS/7/x86_64/repoview/redis5.html Redis 5] via IUS CentOS 7 repository.
*[https://github.com/zkteco-home/redis-windows Redis Windows Port - zkteco-home/redis-windows on GitHub]
==Installing Redis php driver==
* For CentOS, you can use either [https://rpms.remirepo.net/ Remi] or [https://ius.io/ IUS] repositories, and install the [https://dl.iuscommunity.org/pub/ius/stable/CentOS/7/x86_64/repoview/php71u-pecl-redis.html php71u-pecl-redis] driver.
*[https://gist.github.com/hollodotme/418e9b7c6ebc358e7fda Redis php-fpm 7 driver on Ubuntu 14.04]
* [https://pecl.php.net/package/redis Windows PHP extensions] including DLLs for Windows. Check your PHP version, CPU (64bit or x86) and thread-safe value (see Site Admin > Server > PHP Info) to get the right version; add DLL file to ext directory, add 'extension=php_redis.dll' entry to php.ini and restart your web server.
==Configuring Redis in Moodle==
*Navigate to Site admin > Plugins > Caching > Configuration.
*When installed, you should see a green tick next to "Redis" under "Installed cache stores" and a link to add an instance.
[[File:Redis_cache_ready.png]]
*Click "Add instance".
**Give your Redis instance a name, like "Redis1".
**Tick the Cluster mode checkbox if you want to use the Redis Cluster. If the checkbox is disabled, it means your PHP Redis extension does not support the Cluster feature.
**Set the IP:port for the Redis server. If it is on the same machine, the default will be 127.0.0.1:6379. If cluster mode is enabled, specify servers separated by a new line, for example: ''172.23.0.11'' ''172.23.0.12'' ''172.23.0.13''
**Specify the file path to the Certificate Authority (CA) certificate to verify the TLS/SSL connection to a Redis server, confirming the server's authenticity. Leave it blank if you prefer not to use it.
**Enter the password for your Redis server. Leave it blank if you prefer not to use it.
**Enter a short, unique prefix that will be added to all Redis keys created by this Moodle site. Leave it blank if you prefer not to use it.
**Choose the method Moodle will use to encode cache data before storing it in Redis. If available, igbinary is recommended because it is faster and uses less memory than the default PHP serializer.If your system does not have igbinary installed, Moodle will fall back to the standard PHP serializer.
**Select whether Moodle should compress cache data before storing it in Redis.
**Set the maximum number of seconds Moodle will wait for a Redis node to accept a connection. If the Redis server is busy, overloaded, or unreachable, Moodle will stop waiting after this timeout and report a connection failure. Default is 3 seconds.
**Click the Save Changes button, and the new instance should appear under "Configured store instances" with a "Ready" tick.
*Under "Stores used when no mapping is present" click '''Edit mappings". Set "Redis1" (or the name used earlier) for the "Application" and "Session" caches.''' Note that Redis won't appear under the "Request" Cache section, since it isn't fully compatible with all of the different parts of the request cache. (Refer to the [[Caching]] page to better understand how the Moodle Universal Cache works).
[[File:Set_Redis_as_default_Application_and_Session_cache.png]]
*After saving this, you should see Redis as the cache for most cache stores, and should hopefully see a performance boost almost immediately.
*Next Step: Celebrate!
==See also==
*[https://gist.github.com/kabel/10023961 Monitor Redis stats (a php one page app)]
*MDL-48468 : Add a Redis cache store to Moodle core
*Redis lock : https://github.com/open-lms-open-source/moodle-local_redislock (get it into core: https://tracker.moodle.org/browse/MDL-67022)
*[https://redis.io/ Redis.io]
[[de:Redis Cache]]

Ordering question type

2025-11-26T16:56:07Z

Tsala: image updated

{{Questions}}
==Overview==
Originally developed by community moodler [https://moodle.org/user/profile.php?id=8277 Gordon Bateson] the ordering question type was added to standard Moodle from Moodle 4.4 onwards thanks to sponsorship by the Moodle Users Association.

It displays several items (words, phrases, images or other media) in a random order which must then be dragged into the correct sequential order.

{{MediaPlayer | url =https://youtu.be/r-P2IZp-ysg?feature=shared| desc = Ordering question type in Moodle 4.4}}

[[File:404orderingquestion.png|frame|none|link=|alt=|An example of an ordering question with the instruction 'Put this dialogue into the correct order'.]]

==How to create an ordering question==
* Add the question name and the question text:

*Choose whether you want the items to display vertically or horizontally.
[[File:Ordering question 02.png|600px]]

* Choose the best grading type for your learners.
[[File:Ordering question 03.png|600px]]

*Add the items in the correct order:
[[File:Ordering question 04.png|600px]]

*Add hints for multiple tries if needed and tags if required.

==What the student sees==
* The student will see a jumbled list of items. The student needs to drag and drop the items until the list is in the correct order:
[[File:Ordering question 07.png|600px]]

*If the student misplaced items, they will be marked red
[[File:Ordering question 08.png|600px]]

*It may be important to have a proper feedback sentence explaining what went wrong (if anything)
[[File:Ordering question 09.png|600px]]

==External links==
* [https://moodleformulas.org/course/view.php?id=30/ MoodleFormulas] where you can try some examples of the Ordering question type.

[[es:Tipo de pregunta de Ordenamiento]]
[[de:Fragetyp Anordnung]]

File:404orderingquestion.png

2025-11-26T16:55:20Z

Tsala:

MediaWiki:MoodleDocsVersionLinks

2025-09-12T10:59:29Z

Tsala: 5.1

4.5 docs: /405/en/{{FULLPAGENAMEE}}
5.1 docs: /501/en/{{FULLPAGENAMEE}}
5.0 docs: /500/en/{{FULLPAGENAMEE}}
4.4 docs: /404/en/{{FULLPAGENAMEE}}
4.1 docs: /401/en/{{FULLPAGENAMEE}}

Assignment settings

2025-08-06T07:29:00Z

Tsala: /* Submission settings */

{{Assignment}}
This page explores in more detail the settings for the [[Assignment activity]] once you have added it to your course and also covers the Site administration settings.

Note that if you want to edit an existing assignment, click the Edit link to its right and choose the action you wish to take, e.g. 'Edit settings'.

==General==
*In the Description, give a general explanation of the assignment. Check the box if you want this description to display on the course page.
*In Additional files, you can add files which may be of help to the students as they do their assignment, such as example submissions or answer templates.

*In Activity instructions, explain in greater detail what students must do. This is displayed when they edit and submit their assignment.

==Availability==

;Allow submissions from
:This stops students from submitting before the shown date, but it doesn't hide the assignment and any included instructions or materials.
;Due date
:Submissions are still allowed after this date but will be marked as late. Disable it by unticking the checkbox. Assignments without a due date will appear on the dashboard with 'No Due Date' displayed.
;Cut-off date
:After this date, the submit button will be hidden, and students will not be able to submit.
;Remind me to grade by.
:A date needs to be entered here for the assignment to display on the teacher's [[Timeline block]] and in the [[Calendar]]. It will show when at least one student has submitted.

;Time limit
:An assignment may have a time limit, similar to a the Quiz activity. However, the time limit does not prevent learners from submitting after the time has passed. They can still submit but their submission is marked as submitted after the time limit. The time limit feature must be enabled by the admin from ''Site administration > Plugins > Assignment settings > Enable timed assignments.''

==Submission types==

Here you can decide how you wish students to submit their work to you.

Note: If Submission comments are enabled in ''Administration>Plugins>Activity modules>Assignment>Submission plugins'', students will be able to add a note to their teacher on submitting work. If Anonymous submissions are enabled, student comments display in the gradebook as from "Participant 01 etc" to avoid revealing identities.

;Online text
:Students type their responses directly in Moodle using a text editor (such as the [[Atto editor]] which automatically saves text at regular intervals.)

It's possible to set a word limit on an online text assignment. Students get a warning if they try to exceed the word limit. Numbers are counted as words and abbreviations such as ''I'm'' or ''they're'' are counted as single words.

;File submissions
:Students can upload one or more files of any type the teacher can open. The teacher can annotate uploaded PDFs, docx and odt files within the browser, and on saving, the annotated file is made available to the student. (Check with your admin that [https://en.wikipedia.org/wiki/Ghostscript Ghostscript] and a [[Document converters|document converter]] are enabled, if you can't annotate uploaded files.)

[[File:404annotateassignment.png|center]]

Comments may be collapsed to make it easier to read the original text:

[[File:collapsedcommentexample.png]]

;Maximum submission size
:The maximum upload size refers to each file a student uploads. It cannot be larger than the limit in the Course settings.
;Accepted file types
:The teacher can specify the types of file the students may upload to the assignment. A file type selector appears upon clicking 'Choose', offering a choice of different file types. (See the video [https://youtu.be/vN1DlHeZkw4 File type selection] for more information.) Leaving the field blank will allow all file types.

If the file types have been restricted, then when students attempt to submit the assignment, they will see a message telling them which files are accepted:
[[File:studentfiletyperestrictions.png|thumb|500px|center|Student view of specified files]]

==Feedback types==
;Feedback comments
:With this enabled, markers can leave comments for each submission (which appear on the assignment grading screen.) Audio and video comments may also be left, using the icon in the text editor.

'''Annotate PDF''' appears if this setting is enabled by the Site administrator in the ''Manage assignment feedback plugins'' section of Site admin and will allow the teacher to annotate using comments, stamps and other features.

;Offline grading worksheet
:This is useful if you wish to download the grading list and edit it in a program such as MS Excel.
{|
|[[File:excelgrades.png|thumb|Editing the grades offline]]
|}

When the teacher has completed their grading offline, they can then upload the spreadsheet, confirm the changes and the grades and comments will be transferred over into Moodle's gradebook:

{|
|[[File:uploadgradingworksheet.png|thumb|Uploading the grading worksheet]]
|[[File:confirmchanges.png|thumb|Confirming the changes]]
|}

;Feedback files
:This allows markers to upload files with feedback when marking. These files may be the marked up student assignments, documents with comments, a completed marking guide, or spoken audio feedback. It enables the Feedback Files column in the assignment grading screen (accessed from the Submissions link in Assignment navigation). To upload feedback files, click the Grade button top right and then upload either with drag and drop or using the [[File picker]]. Alternatively, click the three dots next to a specific student in the grading screen, click Grade and upload in the same way.
{|
|[[File:45feedbackfiles.png|thumb|center|Uploading feedback files]]
|}
'''Uploading multiple feedback files''' is also possible:
#Download the students' assignments using the "Download all submissions" link.
#Extract the folder offline and add your comments to the student's submissions. Keep the names the same.
#Select the students' submissions and zip them into a new folder. Important: Don't just edit them inside their original folder and re-zip this; it will not work. The folder name does not matter as long as the feedback files have the same names as before.
#Upload this newly zipped folder.
#You will be presented with a confirmation screen displaying your feedback files. (If you zip files from a Mac, make sure to remove the folder _MACOSX)

{|
|[[File:multiplezip1.png|thumb|Confirmation screen displaying the feedback files to be uploaded]]
|[[File:multiplezip2.png|thumb|Screen confirming uploaded feedback]]
|}

;Comment inline
:This usefully allows you to comment directly on an 'online text' type submission.

==Submission settings==
;Require students click submit button
:If this is set to 'No' students can make changes to their submission at any time. (If you want to stop them changing work once you are ready to grade, click the Submissions link; locate the student and From the Status column, click the the three dots icon and select 'Prevent submission changes'.)
:If set to 'Yes', students can upload draft versions of the assignment until such time as they are ready to submit. Clicking the submit button tells the teacher they have finished drafting and want the work to be graded. They can no longer edit it and must ask the teacher to revert to draft status if they need to change it again. To do that, click the Submissions link, locate the student and from the Status column, click the three dots icon and select 'Revert the submission to draft'. To do this in bulk, select the relevant students and from the Status menu at the top of the grading screen, select your chosen action.

{|
|[[File:preventsubmissionchanges45.png|thumb|Prevent submission changes]]
|[[File:revertdraft.png|thumb|Status at top of screen for bulk select]]
|}

;Require that students accept the Submission statement
:An administrator can define a "Submission statement" (see below) i.e. a statement where students promise the work is their own and which they must agree to before submitting their work. If the administrator has given teachers the option of using a submission statement or not, then it will be available in the assignment settings screen. If the administrator has forced the statement throughout the site, a teacher will not have this option in the settings but a student will see the statement when accessing their assignment. '''Note:''' The admin can set different submission statements for individual or group submissions.
{{New features}}
;Allowed attempts
: The maximum number of attempts that can be made. Once this number is reached, the submission can no longer be reopened.

;Grant attempts
: If 'Allowed attempts' is set to unlimited or more than 1, you can specify how to grant further attempts - Manually (via the Submissions page or Grader page), Automatically (after grading), or Automatically until pass (after grading, until the student achieves the passing grade).

==Groups submission settings==
These settings allow students to collaborate on a single assignment, e.g. working in the same online area or uploading, editing and reuploading an MS Powerpoint in the common assignment area.

When grading, the teacher may choose to give a common grade and feedback to all students in the group or to give individual grades and feedback to each member.

;Require group to make submission
:Students not in a group can still submit assignments unless this is forced in ''Site administration > Plugins > Assignment > Assignment settings''. Moodle will then display a message ''You're not a member of any group; please contact your teacher'' , and the student will not be able to submit the assignment.
;Require all group members submit
:This setting will only appear if the teacher has ticked the "Require students click submit button" earlier. The assignment will not be classed as "submitted" until all members of the group have made a contribution. When one student has submitted, the other members of the group will be able to see who still has to submit.
;Grouping for student groups
:If a particular grouping is selected here, then the gradebook will display any other groups and non-grouped students in the "default group", while naming the group(s) that are in the chosen grouping. If "none" is selected, then the gradebook will display the names of all groups and put any non-grouped students in the "default group". See this [https://moodle.org/mod/forum/discuss.php?d=216399#p942913 forum post on grouping for student groups] for examples of how this might be used.

==Notifications==
(Note that if you are using group mode then course teachers need to be members of the group in order to receive submission and late submission notifications.)

{{New features}}
Learners receive the following assignment notifications (via their preferred notification format):
* Assignment due in 7 days
* Upcoming assignment due (48 hours before the due date)
* Assignment overdue.

==Grade==
*See [[Grade points]] and [[Advanced grading methods]] for more information on the settings here.
*Setting a passing grade may be connected with [[Activity completion]] and [[Restrict access]] such that a student will not be able to access a follow up activity until they have passed this assignment.

===Anonymous submissions===
This hides students' names when grading and instead shows randomly generated Participant numbers.

With Anonymous submissions, students cannot see the final grade until all of the students' names have been revealed. Rubrics will also be hidden from students' view until the names are revealed. To reveal student names after you are finished grading, look under ''Assignment settings > Reveal student identities''. Feedback comments will appear whether or not student names are hidden or revealed. Note that this level of anonymity might not suit the privacy requirements of your organisation. See MDL-35390 for more details.

Users with the capability [[Capabilities/mod/assign:viewblinddetails|View student identities when Anonymous submissions are enabled]] (by default managers only) can view student identities and participant numbers.

Users with the capability [[Capabilities/moodle/site:viewanonymousevents|View anonymous events in reports]] (by default managers only) can view student submissions to assignments with Anonymous submissions (in Moodle 3.9 onwards).

===Marking (grading) workflow===
This lets you keep grades and feedback hidden until you are ready to release them to students. It is also useful if you want to show your progress in grading, or co-ordinate multiple markers/graders.

{|
|[[File:26markingworkflow.png|thumb|Marking workflow state in the individual grading screen]]
|[[File:26quickgradingworkflow.png|thumb|Dropdown to select marking workflow state when quick grading]]
|}
The phases are:

* Not marked (the marker has not yet started)
*In marking (the marker has started but not yet finished)
*Marking completed (the marker has finished but might need to go back for checking/corrections)
*In review (the marking is now with the teacher in charge for quality checking)
*Ready for release (the teacher in charge is satisfied with the marking but wait before giving students access to the marking)
*Released (the student can access the grades/feedback)

;Marking allocation
:Marking allocation can be used if marking workflow is set to Yes. Teachers can then be selected to grade or review submitted work of specific students.

{|
|[[File:marking45.png|thumb|Allocated markers on the grading screen]]
|}

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

*[[Capabilities/mod/assign:exportownsubmission|Export own submission]]
*[[Capabilities/mod/assign:grade|Grade assignment]]
*[[Capabilities/mod/assign:submit|Submit assignment]]
*[[Capabilities/mod/assign:view|View assignment]]

Role permissions for the activity can be changed from the gear icon Actions menu.

==Site administration settings==
Administrators can access assignment configuration options by expanding ''Administration > Site administration > Plugins > Activity modules > Assignment''.

===Assignment settings===
Here, the administrator can set defaults for certain settings. They may also make certain settings 'Advanced' which means a course teacher has to click the 'Show more' link to see them, or they may 'lock' settings which means a course teacher cannot alter that setting.

If the site contains courses with over 100 participants, the number of assignments listed on the assignment grading page may be limited using the Maximum assignments per page (assign | maxperpage) setting. This removes 'All' from the 'Assignments per page' setting.

;Submission statement
:Here is where the administrator can enter text which will appear when students are about to submit an assignment. There are three options:

{|
|[[File:submission37.png|thumb|Admin view of Submission statement set up screens - click to enlarge]]
|[[File:44submissionstatement.png|thumb|Student view when about to submit - click to enlarge]]
|}

If it is left as the default "No", then teachers will have the choice within their own assignments to force this or not.

The submission statement may be shown in different languages. See [[Multi-language content filter]] for how to do this.

Note for sites using languages other than English: There is currently a bug affecting the default assignment submission statement - it doesn't display in a user's language (MDL-54731). A workaround is to enter the submission statement in the required language (using the multi-lang filter if multiple languages are required) in the 'Submission statement' (submissionstatement) field then save the changes.

===Submission plugins===
Here the administrator can enable, disable or change the order and default settings for any submission plugins.
;Submission comments
:Note that if submission comments are enabled here AND comments enabled globally in ''Site Administration > Advanced features'') then students will be able to send a message to their teacher when submitting their assignment. If either of those settings is disabled, then the submission comments link will not appear.

===Feedback plugins===
====Manage assignment feedback plugins====
Here the administrator can enable, disable or change the order and default settings for any feedback plugins.
;Annotate PDF
:This is the place to upload stamps for teachers to use when annotating student PDFs.

===== Check Ghostscript=====
You can also check the ghostscript path from here:
{|
|[[File:Selection_116.png|thumb|Ghostscript not installed or incorrectly installed]]
|[[File:Selection_115.png|thumb|Ghostscript correctly installed]]
|}

If the default stamps are deleted by accident, they can be found in mod/assign/feedback/editpdf/pix and re-uploaded.

[[de:Aufgabe konfigurieren]]
[[fr:Ajouter/modifier un devoir]]
[[ja:課題を追加/編集する]]
[[es:Configuraciones de tarea]]
[[it:Impostazioni Compito]]

Using Assignment

2025-08-05T13:23:03Z

Tsala: /* Submission status */

{{Assignment}}
This page explores the different types of assignment, how students submit assignments and how teachers can grade them.

==What are the options for submitting work in Moodle?==
The standard ways students can submit assignments are:
* File submissions (students submit a file for assessment)
* Online text (students can type their responses directly in Moodle)
* Audio or video (via the recording button in the [[Atto editor]])

Notes:
# It is also possible to use the assignment for grading an "offline assignment", ie, one where work is done outside of Moodle. This is done by simply unchecking the above three options.
# If you're not sure which assignment type best suits your needs, look at the section below [[#Which type of assignment submission suits you best?]]

==Which type of assignment submission suits you best?==

===You want students to type shorter or longer responses directly online===

Set ''Online text'' to Yes. This works well for younger children who will only manage a sentence or two and works just as well for higher education students who write more.
*Advantage - quick for the student to get started; no need to use a word-processing program and upload the file. The text is saved on a regular basis so it will be preserved if the student loses the page for some reason.
*Disadvantage: if the word count is expected to be large, setting ''Online text'' to No and ''File submission'' to Yes might be a better option.

===You want students to submit work you can download in a specified program===

Set ''File submission'' to Yes, set the number of files you will allow using the ''Maximum number of uploaded files'' setting and the file sizes by using the '' Maximum submission size'' setting.
*Advantage - better than students emailing work as the whole class's work is collated in one space on your course. Markers can provide comments directly on the student work.
*Advantage - with "Attempts reopened" enabled, teachers can see the progression through various drafts of a student's work.
*Disadvantage - assignments must downloaded to be viewed (but they can be [[Assignment_FAQ| downloaded in bulk]]) and the teacher needs the appropriate program to open them.

===You want students to submit files at different times for a project===

Set ''File submission'' to Yes, and use ''Maximum number of uploaded files'' to set the maximum number of separate files they can upload
*Advantage - all project files are in one assignment area for grading so they get a single grade.
*Disadvantage - all project files are in one assignment area for grading - so they can only have a single grade!
===You want students to write a response to a video/sound file/image===

Set up an assignment allowing ''online text'' submission and get students to use the Moodle media icon to add video/sound/image files.

===You want students to answer a series of questions on a video/sound file/image===

Investigate the [[Quiz]] module. Assignments are really just for a single question.

===You want to grade work students have done offline===
Uncheck the submission types when setting up the assignment. Students won't be required to do anything but you can use the assignment to grade them for work done outside of Moodle.

===You want to view, comment on and send back students' assignments===

Set up an assignment allowing ''file submissions''.
*Advantage: useful for teachers who like using the "comment" options in word-processing programs for example. If you have Ghostscript enabled on your server and the students upload PDF files, you can annotate them inline. See the section [[Using Assignment#Annotating PDF files| Annotating PDF files]] below.
*Disadvantage: if students upload other file types, you have to download them, comment and then re-upload them.

===You want students to send you a comment or note along with their uploaded work===

If [[Comments#Enabling_comments|comments are enabled site-wide]], students will be able to add submission comments; if comments are disabled site-wide, students will not be given the option to add submission comments.

===You want to allow students to redraft and decide when to submit the work===

In the settings set ''Require students click submit button'' to Yes. Students can then control when their draft work is submitted to the teacher.

===You want students to keep an ongoing journal or do an iterative assignment===

In the settings set ''Require students click submit button'' to No. Students can continue to make changes to their assignment and at no point do they 'submit'. If the work will be graded at some point it is recommended that either ''Prevent late submissions'' is set to Yes to ensure that no changes can be made after the due date, or [[Using_Assignment#Submission_status| all submissions are locked]] when grading commences to ensure that the work is not altered during grading.
*Advantage: the work remains in one place and is constantly improved, graded (if needed) and improved again.
*Disadvantage: there is no record/history of previous attempts (such as with the [[Wiki]]). The online text assignment does not replicate the display of a journal or blog where each new entry is additional to the previous ones.

===You want students to submit work in groups===

In the settings, set "Students submit in groups" to Yes. If you just do this, then once one student has submitted, the assignment will be flagged as submitted even if the others haven't contributed. If you want to ensure everyone has an input, set "Require students click submit button" to Yes and then change "Require all group members to submit" to Yes. The assignment will only be classed as submitted when each member has contributed, and once one student has submitted, the remaining members's names will be displayed for the group to see who still needs to add their input.

===You want to grade students' work anonymously===
In the settings, choose 'Anonymous submissions'. When students submit assignments, their names will be replaced by randomly-generated participant numbers so you will not know who is who. Note that this is not '''totally''' anonymous because you can reveal their identities in the assignment settings and you can work out identities from the logs - so this might not be suitable if your establishment has very precise privacy requirements.

===You want to read and grade student assignments offline===
In the settings, choose "Offline grading worksheet". When students have submitted, click "View/grade all submissions" and you can download their assignments from the link "Download all submissions" and download the grading sheet from the link "Download grading worksheet". You can then edit grades and re-upload the grading worksheet. You can also upload multiple feedback files in a zip from this drop down menu. See [[Assignment settings]] for an explanation of how to use the "upload multiple feedback files as zip" feature.

===You want to hide students' grades until a time of your choosing.===
Use 'marking workflow' as explained in [[Assignment settings]].
===You want to set a timed assignment===
Ask your administrator to enable the time limit feature from Site administration > Plugins > Assignment settings > Enable timed assignments and you will then have the option from the Availability section.

===You want to moderate other colleagues' marking or allocate certain teachers to certain students===
Use 'marking allocation' as explained in [[Assignment settings]].

==How do students submit their assignments?==
The first page students will see when they click on the assignment activity link from the course page will display the assignment name, optionally a description and the submission status. The first time a student views the assignment (with a description) it will look like this:
{|
|[[Image:44studentassignmentview.png|thumb|Student view of assignment]]
|}
The submission status section includes:
*'''Submission status'''
*'''Grading status'''
*Due date
*Time remaining
*Last modified
*Submission details

If the teacher prefers, the description may be left blank (1 below) and the assignment instructions only presented once the student clicks to do the assignment (2 below).
{|
|[[File:44assignmentinstructions.png|thumb|alt=assignment instructions]]
|}

As they progress through the assignment the Submission status and Grading status will update and the Last modified date will appear.
{|
|[[File:44submittedandgradedassignment.png|thumb|alt=student assignment submitted and graded]]
|}

If the student uploaded a file which the teacher has annotated, this will be made available in the feedback section. The student can search through the document and filter specific comments.
{|
|[[File:26pdfstudentgraded.png|thumb|Student view of graded pdf file]]
|[[File:26searchcomments.png|thumb|Searching and filtering comments in annotated pdf]]
|}
Submission statuses include:

*Nothing submitted for this assignment
*Draft (not submitted)
*Submitted for grading

Grading statuses include:

*Not graded
*Graded

===File submission===
To submit a file submission, students complete the following steps:

# Click the ‘Add submission’ button to bring up the file upload page.
# Upload the relevant file into the submission. They are able to ‘drag and drop’ the file into the submission box.
# Click ‘Save Changes’.

There should now be a Last modified date and the file(s) uploaded will also be displayed. Depending on how the assignment is setup the status will either read ‘Submitted for grading’ - in which case no further action is need, or ‘Draft (not submitted)’.

# If changes are required, click ‘Edit submission’.
# Once ready to submit, click ‘Submit assignment’.

Note that once the assignment is 'submitted’ no further changes are allowed.

{|
|[[File:file upload.jpg|thumb|Student view when adding a submission]]
|[[File:file uploaded.jpg|thumb|Student view once file is uploaded]]
|[[File:submit button.jpg|thumb|Student view when submitting assignment]]
|}
Note: Depending on how the assignment is setup students may see both a file submission page and an online text editor.

If file submissions and online text are enabled, and a word limit is set for the online text, it is possible for a student to end up with a submission status of 'No attempt' together with saved file submissions. This occurs when a student submits files, enters online text, clicks 'Save changes' then obtains a message informing them that the text exceeds the word limit. If they then click Cancel, the submission status is shown as 'No attempt' together with saved file submissions.

===Access controlled links===
If the administrator has enabled this feature for either the [[Google Drive repository]] or the [[OneDrive repository]] then students can upload a file as an 'access controlled link' from either of these repositories. The file is then copied to the site account and the student is no longer able to edit it.The student retains the original file in their own Google Drive or OneDrive. The teacher is given permission to edit the file for grading purposes, and the student is sent a copy of the edited file.
[[File:accesscontrolledlink.png|center|thumb|Student submits an access controlled link]]

===Online text===
To submit online text, students complete the following steps:

# Click the ‘Add submission’ button to bring up the online text editor page.
# Type the relevant text into the [[Text_editor|text editor]], or paste from a previously written file.
# Click ‘Save Changes’.

There should now be a Last modified date and the first 100 characters entered will also be displayed. Depending on how the assignment is setup the status will either read ‘Submitted for grading’ - in which case no further action is need, or ‘Draft (not submitted)’.

# If changes are required, click on ‘Edit my submission’.
# Once ready to submit, click ‘Submit assignment’.

Note that once the assignment is 'submitted’ no further changes are allowed.

{|
|[[File:online text entered.jpg|thumb|Online text entered]]
|[[File:submit button online text.jpg|thumb|Submitting assignment]]
|}

===Submission comments===
If enabled by the administrator, there may be a section where students can leave submission comments.
{|
|[[Image:student comments.jpg|thumb|Student comments]]
|}

==How do teachers grade assignments?==
When students have submitted their assignments, they can be accessed by clicking on the assignment activity. This will bring up the Grading Summary page.

The Grading Summary page displays a summary of the assignment, including; number of participants, number of drafts, number of submitted assignments, due date and time remaining.

Clicking 'Grade' will take you to the first student in the list so you can start grading individually. If you wish to grade several assignments, clicking Save and Show next will take you to the next submission.

[[File:saveandshownext.png|center|thumb|400px]]

Clicking 'View all submissions' will take you to the grading table where you see all students.

The Grading Table contains columns of information about the student, the status of their submission, a link to grade their submission, a link to each submission and feedback comments and files (if enabled).

===Filtering submissions===

The status filter allows you to filter submissions so you can for example quickly see which students have not submitted yet.

You can also filter submissions which have had extensions granted.

[[File:status filter.png]]

===Allocating submissions to markers===
If you need to divide submissions between more than one person, you can apply groups to the assignment and let markers know which group(s) to mark. Note that because group membership is not itself anonymised, this may make anonymised submissions that bit less anonymous, though as long as the groups aren't very small this should be acceptable.

An alternative is to use [[Assignment_settings#Use_marking_allocation|marking allocation]] - this allows anyone with a teacher role to allocate one marker to each submission. This works particularly well if marking is allocated by subject specialism.

===Submission status===
If you will be assigning grades to student work, you may want to take note of the submission status before you begin the marking process. If you have required students click the Submit button, you may find that some submissions are still marked as Draft (not submitted), meaning the student has either uploaded a file(s) or entered some text, but has not clicked ‘Submit assignment’.

If it's after the due date and you are about to commencing marking that you use ‘Prevent submission changes’ to stop students from making changes to their assignment. You can do this one by one by using the icon in the Edit column.

Or you can select two or more students by putting a tick in the select column and going to 'Lock submissions’ from the ''With selected'' menu under the grading table.

Likewise you can also revert a student's submission to draft if they have uploaded the incorrect file. Instead of selecting ‘Prevent submission changes’ select ‘Revert the submission to draft’, or place ticks against selected students and choose 'Revert the submission to draft status' from the ''With selected'' menu under the grading table.

{|
|[[File:submission statuses.jpg|thumb|Submission statuses]]
|[[File:prevent submission changes dropdown.jpg|thumb|Prevent submission changes dropdown]]
|[[File:lock submissions.jpg|thumb|Lock submissions]]
|[[File:revert to draft.jpg|thumb|Revert to draft]]
|[[File:revert submission to draft status.jpg|thumb|Revert to draft status]]
|}

If the submission setting 'Grant attempts' is set to 'Automatically' or 'Automatically until pass', the submission is automatically unlocked when the grade is saved. Similarly, if 'Grant attempts' is set to Manually, when a teacher selects 'Allow another attempt, the submission is unlocked.

===Overriding assignment deadlines===

A teacher can override a deadline for an individual or group from ''More'' > ''Overrides'' on the assignment page with the [[Boost theme]], or from Assignment administration with other themes.

When adding overrides for a group, it is possible to have one group override trump another. This is achieved by moving the override up/down on the group overrides page:

[[File:AssignGroupOverrides.png|||center]]

In this situation, a student in both groups (e.g. Frodo Baggins) will have the override from "The Council of Elrond" applied. By pressing the arrow icons on the right, the override for "The Fellowship" can be moved to the top of the list, and will have higher precedence.

Note also that if there exists a user override for a student, it will always take precedence over any group overrides.

===Granting extensions===
If an assignment has a deadline, a teacher can grant individual or group assignment extensions by selecting the Edit link next to a particular student or group.

#To grant an extension, open the assignment
#Click on "View all submissions"
#Locate the student who is to be allowed to submit after the "Cut-off date"
#Click on the adjacent "Edit" drop down menu and select "Grant extension"
##[[File:grantextension0.png|thumb|center|600px]]
#Set the extension date and time. The student's or group's name is also shown on this screen.
##[[File:grantextension.png||thumb|center|600px]]
#Click on "Save changes".

===Quick grading===

'''Quick grading''' allows you to enter numeric grades directly into the grading table, bypassing the more detailed grading interface. Please note:
*if you want to give feedback, you need to use the more detailed Grade interface.
*Quick grading is incompatible with advanced grading e.g. Rubrics, and is not recommended when there are multiple markers.
*'''Submission comments''' are a two-way private conversation between a student and staff and are visible to students immediately i.e. markers use the grading interface to give feedback, not the submission comments.

To access the Quick Grading interface, from the Grading Summary page click 'View all submissions'; the Grading Table displays. Scroll to bottom of the page to configure Options, and check the box for 'Quick grading'. While you're down there, you can also set the number of assignments to display per page, filter the assignments e.g. to see who has not submitted, unmarked assignments, etc.

When you are ready to Quick Grade:

#You can enter grades directly into the grading table.
#Scroll to the bottom of the grading table and click 'Save all quick grading changes'
#A confirmation displays.

===Grading individual submissions===
If you have enabled File Feedback in the [[Assignment settings]] and wish to upload either the marked student assignment, a completed text based feedback document or audio feedback, click on the green tick in the Grade column (or use the icon in the Edit column and select Grade).

This brings you to the Student Grading Page where you can give grades, feedback comments and feedback files (if enabled in the [[Assignment settings]]). You can use drag and drop to upload feedback files.

{|
|[[File:green tick.jpg|thumb|Green tick]]
|[[File:grade.jpg|thumb|Grading]]
|[[File:feedbackfiles.png|thumb|Feedback files]]
|}

====Annotating submissions====

If the student has uploaded a PDF, docx or odt file, or if you set 'Comment inline' for an online text submission, then their submission will be displayed on the grading screen, allowing you to annotate it (requires [http://www.ghostscript.com/ Ghostscript] for PDF and [[Universal Office Converter (unoconv)|unoconv]] for docx and odt files), using a variety of tools, stamps (if uploaded by the admin) and comments which may be saved to a comments bank. When the annotations are complete, clicking to save the changes will result in it being displayed to the student as part of their feedback.

'Rotate' icons let you change the orientation of an uploaded document if the student submitted it in landscape mode for example.

[[File:AnnotatingAssignment.png|thumb|500px|center|Annotating a student's submission]]

Comments may be added and then saved in a quick list for future use ''(1)'' Click the paper/magnifying glass icon to the right of the page selector to filter comments you have already added to the work''(2)'':
*In the '''Search comments''' pop-up window, enter the term you would like to search for in the '''Filter comments...''' box.
*Clicking on the comment will take you to the part of the paper where that comment has been added.

{|
|[[File:NFaddcomment.png|thumb|400px|1.Saving and re-using comments]]
|[[File:NFcommentsearch.png|thumb|400px|2. Accessing comments]]
|}

Note: To ensure that comments display to students as the marker intends, do instruct students to download the annotated PDF rather than just previewing it. Preview sometimes displays comments in a way which obscures the original text.

The review panel and / or the grading panel may be collapsed by clicking the icons at the bottom right of the screen.

[[File:CollapseReviewPanel.png|center]]

===Controlling when to notify students of graded work===

====Notifying as you mark====

If you need to notify individual students, one by one, as you mark, the '''Notify students''' checkbox is available when grading individual submissions. Choose Yes to notify the student immediately or No to grade without notifying the student. Assuming you are not hiding grades in the ways outlined below, then Moodle will send a notification.

Note: How students receive Moodle notifications depends on your local default settings, and any changes students have made to those.

[[File:44feedbackcomments.png|alt=assignment feedback]]

====Keeping grades hidden until a release date====

Assessors often decide to hide grades and feedback until marking is complete and finalised, and then release them all at once. There are two alternatives for this.

*[[Grade_hiding|Hide the item in the Grader Report]]. This is convenient if there are few markers and you have decided a provision date for releasing the marks and feedback.
*Or enable [[Assignment_settings#Use_marking_.28grading.29_workflow|Use marking workflow]] in the Assignment's settings. This way is best where there are many markers, and/or you don't have a provisional date to release marks and feedback.

====Examples of Marking workflow====

One marker, Marker, wants to release all grades at the same time
* Marker enables "Use marking workflow"
* Marker marks each submission and transitions the grading to "Marking completed" as each submission is graded.
* Marker then uses the batch operations to transition all grades to "Released" at the same time.

Multiple markers,
* Marker enables "Use marking workflow"
* Marker marks each submission and transitions the grading to "Marking completed" as each submission is graded.
* Marker then uses the batch operations to transition all grades to "Released" at the same time.

===Offline marking - downloading and uploading multiple grades and feedback files===

If you don't have an internet connection or prefer to grade outside Moodle, you can do so (including with anonymous submissions).
These easy stages explained below:
#Download the submissions
#Download the spreadsheet (grading worksheet) to record grades.
#Grade and annotate (if applicable) the submitted work.
#Upload the completed grading worksheet.
#Upload the annotated submissions (if applicable).

Note:You cannot upload marks and feedback to Moodle if you have enabled Rubrics or Marking Guides.

====Before you start, enable the multiple file upload settings====
Go to the settings of that assignment.
For Feedback types, ensure that the Moodle Assignment settings, Feedback comments, Feedback files, and Offline grading worksheet are ticked.

====Downloading student submissions====

You can download a zip file containing all of the assignment submissions by selecting ‘Download all submissions’ from the 'Grading actions' menu at the top of the grading table, or in the settings menu.

File submissions will be downloaded in the format uploaded by the student. Online text submissions will be downloaded as html files. Each file in the zip will be named with the student first and last name followed by a unique identifier (not the user ID number).

If each submission is more than a single file, then submissions may be downloaded in folders by ticking the option 'Download submissions in folders' (below the grading table). Each submission is put in a separate folder, with the folder structure kept for any subfolders, and files are not renamed. Each folder will be named with the student first and last name followed by a unique identifier (not the user ID number).

You can also download selected assignment submissions (rather than all of them) by selecting the ones you want and then choosing 'With selected....Download selected submissions'.

====Download the Grading Worksheet to record grades ====
#Next, to download the spreadsheet in which you'll enter the grades and brief comments, return to the Moodle Assignment page and from its Grading action drop-down menu choose Download grading worksheet and save that file (keep its csv file format).

Note: Helpfully that downloaded worksheet will contain any existing grades and summary comments which have already been given for that assignment i.e. if marking has already started. However, to see pre-existing comments fully you may need to set your spreadsheet to 'wrap text' within cells.

====Grade and annotate (if applicable) the submitted work====
After downloading the submissions and the grading worksheet:
#Open a downloaded assignment file to assess it.
#Open the csv file in a spreadsheet editor e.g. Excel.
#For that student's record (if anonymous, a number corresponding to the submission file name will display), enter grades in the Grade column and summary comments in the Feedback comments column for each student.
#Leave the other data untouched unless you know exactly what you're doing.
#Repeat as needed.
#Save the csv file.

Note: Take care to enter data in the correct column of the spreadsheet.

If you are annotating the submissions to return to students as feedback:
#Open a downloaded submission.
#Carry out your annotations.
#Save it in its original place i.e. the folder corresponding to that student.
#Repeat as needed.
If you have separate feedback files to upload to students:
#Save these within that student's folder.
#You can give students multiple feedback files in this way e.g. annotations on their work along with a separate pro forma.

Note: Don't change the name or location of the folder - Moodle needs this information to allocate the files correctly.

Compress (zip) all the feedback files:

#Locate the folder containing the feedback files in Moodle, select them all (Ctrl+A within the folder), then zip them:
##Windows: Right click one of the selected files and Send to > Compressed (zipped) folder.
##Mac: Right Click (or Ctrl+click) one of the selected files and click Compress.
#They are now ready for upload (see below).

====Upload the completed grading worksheet====
When you are ready to upload grades and summary feedback:
#Click on the assignment name on the Moodle course homepage to access the summary page and click '''View/grade all submissions'''.
#From the Grading action drop-down menu choose '''Upload grading worksheet'''.
#Click '''Choose a file...''' and upload the grading worksheet to Moodle, or drag the csv file to the arrow and wait for the file name to appear in the box.
#There is a checkbox to '''overwrite records that have been modified more recently in Moodle than in the spreadsheet''' - only check this if you want to spreadsheet to overwrite all Moodle records, including ones made more recently than the spreadsheet.
#Click '''Upload grading worksheet'''; a Confirmation box displays the students grades and feedback that will be imported - check this carefully.
#If you are ready to proceed, click '''Confirm'''; a summary of updates displays.
#Click '''Continue'''.

====Upload feedback files (if applicable)====
#Click on the assignment name on the Moodle course homepage to access the summary page and click '''View/grade all submissions'''.
#From the Grading action drop-down menu choose '''Upload multiple feedback files in a zip'''.
#Click '''Choose a file...''' and upload the zipped assignments file to Moodle, or drag the compressed/zipped file to the arrow and wait for the file name to appear in the box.
#Click '''Import feedback file(s)'''.
#The Confirmation box will list all the feedback files and student names that will be imported.
#Click '''Confirm'''; the next screen summarises the changes.
#Click '''Continue'''.
#From the page containing the Grading Table, you can check your feedback files by enabling Quick grading (see Options at the bottom of that page) and scrolling horizontally, if needed.

For an assignment with no file submissions, see the discussion [https://moodle.org/mod/forum/discuss.php?d=336438 upload feedback files without student file submissions] for details of what to do.

===Give the same feedback file to multiple students===
If you have high level feedback you want to give to an entire cohort, it is generally a good idea to give this feedback in the context of the assignment, rather than e.g. separately via a Forum. Moodle allows you to select some or all students and attach a single, common feedback file to their assignment feedback. This common feedback will appear to each student along with any other individual feedback files you have prepared for each.
#Prepare the single file of feedback.
#Click on the link to the Assignment; its summary page displays.
#Click '''View all submissions'''; the assignment's Grading Table displays.
#Use the checkboxes to select all or some students to receive the feedback (you may first prefer to configure the Grading Table to show as many students as possible on a single page).
#Underneath the Grading Table click the '''With selected...''' menu, choose '''Send feedback files''', then click '''Go'''; a page displays a list of selected students above a file upload area.
#Upload the file of feedback you prepapred, or drag it to the arrow and wait for the file name to appear in the box.
#Click '''Send feedback files'''; the Grading Table displays again.
#Check your file is in place by scrolling horizontally to the '''Feedback files''' column.

==Keeping records (archiving, exporting, backing up)==
When students unenrol from a Moodle area, their records become invisible through the Gradebook interface. In order to have the information to hand, departments or course teaching teams may need systems in place to keep their own records for the data retention period required in their particular context. There are two separate procedures for exporting student submissions and marks.

To export marks (with or without feedback):
#Go to your course administration block and click Grades.
#From the Grader Report Settings block, select Export; a menu displays.
#From the menu, if you need easy viewing and running calculations you probably want to select one of the spreadsheet formats; a page of export settings loads
#Use the Visible Groups pulldown menu to limit the export to specific groups, as required
#In Options, you indicate whether feedback comments are included
#In Grade Items To Be Included lists you can, if required, omit particular Activities from the report
#When you've finished with the settings, click on Submit; a preview of your export displays
#Click on Download to export to the format you chose, and save the file.

To download the original student submissions:
#In your course area, click the link to the Assignment whose submissions you want to download.
#Click on the link to View/Grade all submissions; the Grading Table will load.
#Click the link to 'Download all submissions' and save the file.
==Tips and Tricks==
* Want to use an Assignment activity again in another Moodle site? Use the [[Activity_backup| backup and restore]] options.
*Want to use an Assignment activity in another course you teach? Use the [[Import_course_data| Import function]] in the course administration block.
*Moodle will sometimes appear not to be uploading a resubmitted assignment - you seem to be downloading the original assignment. This is a cache issue, in short, go to ''"Tools > Clear Recent History"'' in Firefox or ''"Tools > Delete Browsing History > Delete Temporary Files"'' in Windows Explorer. The newer file will then appear.

==See also==

===Examples from [https://school.moodledemo.net School demo site]===

* [https://school.moodledemo.net/mod/assign/view.php?id=573&rownum=3&action=grade Teacher view of a PDF assignment which can be annotated inline.]Log in with username 'teacher'.
* [https://school.moodledemo.net/mod/assign/view.php?id=573&action=grading Teacher view of allocated markers and marking workflow status.] Log in with username 'teacher'.
* [https://school.moodledemo.net/mod/assign/view.php?id=190 Student view of an assignment.] Log in with username 'student'. Scroll down to see the rubric and feedback.
* [https://school.moodledemo.net/mod/assign/view.php?id=46&action=editsubmission Student view of a student submission statement] Log in with username 'student'.
* [https://school.moodledemo.net/mod/assign/view.php?id=715 Student view of group assignment grading screen] Log in with username 'student'.
* [https://school.moodledemo.net/mod/assign/view.php?id=715&action=grading Teacher view of a group assignment grading screen] Log in with username 'teacher'.
* [https://school.moodledemo.net/mod/assign/view.php?id=191&action=grading Teacher view of Anonymous submissions grading screen] Log in with username 'teacher'.

===Other===
* [http://www.somerandomthoughts.com/blog/2013/07/07/one-approach-for-group-project-grading/ One approach to group project grading] blog post by Gavin Henrick
* [http://moodle.org/mod/forum/discuss.php?d=201307 Advantages of using Assignment upload over emailing a document] forum discussion

[[de:Aufgabe nutzen]]
[[fr:Afficher un devoir]]
[[ja:課題を表示する]]
[[es:Usando Tarea]]

Capabilities/quizaccess/seb:manage seb configuremanually

2025-08-05T12:40:03Z

Tsala: improved wording

{{New features}}
{{Capabilities}}
*This allows a user to select the [[Safe Exam Browser]] quiz setting option 'Select manual configuration'.
*It is allowed for the default roles of Manager and Teacher.

[[Category:Capabilities]]

Capabilities/quizaccess/seb:manage seb usesebclientconfig

2025-08-05T12:38:57Z

Tsala: improved wording

{{New features}}
{{Capabilities}}
*This allows a user to select the [[Safe Exam Browser]] quiz setting option 'Use SEB client configuration'.
*This capability is allowed for the default roles of Manager and Teacher.

[[Category:Capabilities]]

Capabilities/quizaccess/seb:manage seb configuremanually

2025-08-05T12:32:28Z

Tsala:

{{New features}}
{{Capabilities}}
*This capability allows a user to configure [[Safe Exam Browser]] manually, without using a template.
*It is allowed for the default roles of Manager and Teacher.

[[Category:Capabilities]]

Capabilities/quizaccess/seb:manage seb usesebclientconfig

2025-08-05T12:28:54Z

Tsala:

{{New features}}
{{Capabilities}}
*This allows a user to specify that a [[quiz]] can be attempted with any configuration of [[Safe Exam Browser]], rather than relying on a configuration from Moodle.
*This capability is allowed for the default roles of Manager and Teacher.

[[Category:Capabilities]]

Assignment settings

2025-08-04T13:40:48Z

Tsala: /* Submission settings */

{{Assignment}}
This page explores in more detail the settings for the [[Assignment activity]] once you have added it to your course and also covers the Site administration settings.

Note that if you want to edit an existing assignment, click the Edit link to its right and choose the action you wish to take, e.g. 'Edit settings'.

==General==
*In the Description, give a general explanation of the assignment. Check the box if you want this description to display on the course page.
*In Additional files, you can add files which may be of help to the students as they do their assignment, such as example submissions or answer templates.

*In Activity instructions, explain in greater detail what students must do. This is displayed when they edit and submit their assignment.

==Availability==

;Allow submissions from
:This stops students from submitting before the shown date, but it doesn't hide the assignment and any included instructions or materials.
;Due date
:Submissions are still allowed after this date but will be marked as late. Disable it by unticking the checkbox. Assignments without a due date will appear on the dashboard with 'No Due Date' displayed.
;Cut-off date
:After this date, the submit button will be hidden, and students will not be able to submit.
;Remind me to grade by.
:A date needs to be entered here for the assignment to display on the teacher's [[Timeline block]] and in the [[Calendar]]. It will show when at least one student has submitted.

;Time limit
:An assignment may have a time limit, similar to a the Quiz activity. However, the time limit does not prevent learners from submitting after the time has passed. They can still submit but their submission is marked as submitted after the time limit. The time limit feature must be enabled by the admin from ''Site administration > Plugins > Assignment settings > Enable timed assignments.''

==Submission types==

Here you can decide how you wish students to submit their work to you.

Note: If Submission comments are enabled in ''Administration>Plugins>Activity modules>Assignment>Submission plugins'', students will be able to add a note to their teacher on submitting work. If Anonymous submissions are enabled, student comments display in the gradebook as from "Participant 01 etc" to avoid revealing identities.

;Online text
:Students type their responses directly in Moodle using a text editor (such as the [[Atto editor]] which automatically saves text at regular intervals.)

It's possible to set a word limit on an online text assignment. Students get a warning if they try to exceed the word limit. Numbers are counted as words and abbreviations such as ''I'm'' or ''they're'' are counted as single words.

;File submissions
:Students can upload one or more files of any type the teacher can open. The teacher can annotate uploaded PDFs, docx and odt files within the browser, and on saving, the annotated file is made available to the student. (Check with your admin that [https://en.wikipedia.org/wiki/Ghostscript Ghostscript] and a [[Document converters|document converter]] are enabled, if you can't annotate uploaded files.)

[[File:404annotateassignment.png|center]]

Comments may be collapsed to make it easier to read the original text:

[[File:collapsedcommentexample.png]]

;Maximum submission size
:The maximum upload size refers to each file a student uploads. It cannot be larger than the limit in the Course settings.
;Accepted file types
:The teacher can specify the types of file the students may upload to the assignment. A file type selector appears upon clicking 'Choose', offering a choice of different file types. (See the video [https://youtu.be/vN1DlHeZkw4 File type selection] for more information.) Leaving the field blank will allow all file types.

If the file types have been restricted, then when students attempt to submit the assignment, they will see a message telling them which files are accepted:
[[File:studentfiletyperestrictions.png|thumb|500px|center|Student view of specified files]]

==Feedback types==
;Feedback comments
:With this enabled, markers can leave comments for each submission (which appear on the assignment grading screen.) Audio and video comments may also be left, using the icon in the text editor.

'''Annotate PDF''' appears if this setting is enabled by the Site administrator in the ''Manage assignment feedback plugins'' section of Site admin and will allow the teacher to annotate using comments, stamps and other features.

;Offline grading worksheet
:This is useful if you wish to download the grading list and edit it in a program such as MS Excel.
{|
|[[File:excelgrades.png|thumb|Editing the grades offline]]
|}

When the teacher has completed their grading offline, they can then upload the spreadsheet, confirm the changes and the grades and comments will be transferred over into Moodle's gradebook:

{|
|[[File:uploadgradingworksheet.png|thumb|Uploading the grading worksheet]]
|[[File:confirmchanges.png|thumb|Confirming the changes]]
|}

;Feedback files
:This allows markers to upload files with feedback when marking. These files may be the marked up student assignments, documents with comments, a completed marking guide, or spoken audio feedback. It enables the Feedback Files column in the assignment grading screen (accessed from the Submissions link in Assignment navigation). To upload feedback files, click the Grade button top right and then upload either with drag and drop or using the [[File picker]]. Alternatively, click the three dots next to a specific student in the grading screen, click Grade and upload in the same way.
{|
|[[File:45feedbackfiles.png|thumb|center|Uploading feedback files]]
|}
'''Uploading multiple feedback files''' is also possible:
#Download the students' assignments using the "Download all submissions" link.
#Extract the folder offline and add your comments to the student's submissions. Keep the names the same.
#Select the students' submissions and zip them into a new folder. Important: Don't just edit them inside their original folder and re-zip this; it will not work. The folder name does not matter as long as the feedback files have the same names as before.
#Upload this newly zipped folder.
#You will be presented with a confirmation screen displaying your feedback files. (If you zip files from a Mac, make sure to remove the folder _MACOSX)

{|
|[[File:multiplezip1.png|thumb|Confirmation screen displaying the feedback files to be uploaded]]
|[[File:multiplezip2.png|thumb|Screen confirming uploaded feedback]]
|}

;Comment inline
:This usefully allows you to comment directly on an 'online text' type submission.

==Submission settings==
;Require students click submit button
:If this is set to 'No' students can make changes to their submission at any time. (If you want to stop them changing work once you are ready to grade, click the Submissions link; locate the student and From the Status column, click the the three dots icon and select 'Prevent submission changes'.)
:If set to 'Yes', students can upload draft versions of the assignment until such time as they are ready to submit. Clicking the submit button tells the teacher they have finished drafting and want the work to be graded. They can no longer edit it and must ask the teacher to revert to draft status if they need to change it again. To do that, click the Submissions link, locate the student and from the Status column, click the three dots icon and select 'Revert the submission to draft'. To do this in bulk, select the relevant students and from the Status menu at the top of the grading screen, select your chosen action.

{|
|[[File:preventsubmissionchanges45.png|thumb|Prevent submission changes]]
|[[File:revertdraft.png|thumb|Status at top of screen for bulk select]]
|}

;Require that students accept the Submission statement
:An administrator can define a "Submission statement" (see below) i.e. a statement where students promise the work is their own and which they must agree to before submitting their work. If the administrator has given teachers the option of using a submission statement or not, then it will be available in the assignment settings screen. If the administrator has forced the statement throughout the site, a teacher will not have this option in the settings but a student will see the statement when accessing their assignment. '''Note:''' The admin can set different submission statements for individual or group submissions.
{{New features}}
;Allowed attempts
: The maximum number of attempts that can be made. Once this number is reached, the submission can no longer be reopened.

;Grant attempts
: If 'Allowed attempts' is set to unlimited or more than 1, you can specify how to grant further attempts - Manually (via the Submissions page or Grader page), Automatically, or Automatically until pass.

==Groups submission settings==
These settings allow students to collaborate on a single assignment, e.g. working in the same online area or uploading, editing and reuploading an MS Powerpoint in the common assignment area.

When grading, the teacher may choose to give a common grade and feedback to all students in the group or to give individual grades and feedback to each member.

;Require group to make submission
:Students not in a group can still submit assignments unless this is forced in ''Site administration > Plugins > Assignment > Assignment settings''. Moodle will then display a message ''You're not a member of any group; please contact your teacher'' , and the student will not be able to submit the assignment.
;Require all group members submit
:This setting will only appear if the teacher has ticked the "Require students click submit button" earlier. The assignment will not be classed as "submitted" until all members of the group have made a contribution. When one student has submitted, the other members of the group will be able to see who still has to submit.
;Grouping for student groups
:If a particular grouping is selected here, then the gradebook will display any other groups and non-grouped students in the "default group", while naming the group(s) that are in the chosen grouping. If "none" is selected, then the gradebook will display the names of all groups and put any non-grouped students in the "default group". See this [https://moodle.org/mod/forum/discuss.php?d=216399#p942913 forum post on grouping for student groups] for examples of how this might be used.

==Notifications==
(Note that if you are using group mode then course teachers need to be members of the group in order to receive submission and late submission notifications.)

{{New features}}
Learners receive the following assignment notifications (via their preferred notification format):
* Assignment due in 7 days
* Upcoming assignment due (48 hours before the due date)
* Assignment overdue.

==Grade==
*See [[Grade points]] and [[Advanced grading methods]] for more information on the settings here.
*Setting a passing grade may be connected with [[Activity completion]] and [[Restrict access]] such that a student will not be able to access a follow up activity until they have passed this assignment.

===Anonymous submissions===
This hides students' names when grading and instead shows randomly generated Participant numbers.

With Anonymous submissions, students cannot see the final grade until all of the students' names have been revealed. Rubrics will also be hidden from students' view until the names are revealed. To reveal student names after you are finished grading, look under ''Assignment settings > Reveal student identities''. Feedback comments will appear whether or not student names are hidden or revealed. Note that this level of anonymity might not suit the privacy requirements of your organisation. See MDL-35390 for more details.

Users with the capability [[Capabilities/mod/assign:viewblinddetails|View student identities when Anonymous submissions are enabled]] (by default managers only) can view student identities and participant numbers.

Users with the capability [[Capabilities/moodle/site:viewanonymousevents|View anonymous events in reports]] (by default managers only) can view student submissions to assignments with Anonymous submissions (in Moodle 3.9 onwards).

===Marking (grading) workflow===
This lets you keep grades and feedback hidden until you are ready to release them to students. It is also useful if you want to show your progress in grading, or co-ordinate multiple markers/graders.

{|
|[[File:26markingworkflow.png|thumb|Marking workflow state in the individual grading screen]]
|[[File:26quickgradingworkflow.png|thumb|Dropdown to select marking workflow state when quick grading]]
|}
The phases are:

* Not marked (the marker has not yet started)
*In marking (the marker has started but not yet finished)
*Marking completed (the marker has finished but might need to go back for checking/corrections)
*In review (the marking is now with the teacher in charge for quality checking)
*Ready for release (the teacher in charge is satisfied with the marking but wait before giving students access to the marking)
*Released (the student can access the grades/feedback)

;Marking allocation
:Marking allocation can be used if marking workflow is set to Yes. Teachers can then be selected to grade or review submitted work of specific students.

{|
|[[File:marking45.png|thumb|Allocated markers on the grading screen]]
|}

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

*[[Capabilities/mod/assign:exportownsubmission|Export own submission]]
*[[Capabilities/mod/assign:grade|Grade assignment]]
*[[Capabilities/mod/assign:submit|Submit assignment]]
*[[Capabilities/mod/assign:view|View assignment]]

Role permissions for the activity can be changed from the gear icon Actions menu.

==Site administration settings==
Administrators can access assignment configuration options by expanding ''Administration > Site administration > Plugins > Activity modules > Assignment''.

===Assignment settings===
Here, the administrator can set defaults for certain settings. They may also make certain settings 'Advanced' which means a course teacher has to click the 'Show more' link to see them, or they may 'lock' settings which means a course teacher cannot alter that setting.

If the site contains courses with over 100 participants, the number of assignments listed on the assignment grading page may be limited using the Maximum assignments per page (assign | maxperpage) setting. This removes 'All' from the 'Assignments per page' setting.

;Submission statement
:Here is where the administrator can enter text which will appear when students are about to submit an assignment. There are three options:

{|
|[[File:submission37.png|thumb|Admin view of Submission statement set up screens - click to enlarge]]
|[[File:44submissionstatement.png|thumb|Student view when about to submit - click to enlarge]]
|}

If it is left as the default "No", then teachers will have the choice within their own assignments to force this or not.

The submission statement may be shown in different languages. See [[Multi-language content filter]] for how to do this.

Note for sites using languages other than English: There is currently a bug affecting the default assignment submission statement - it doesn't display in a user's language (MDL-54731). A workaround is to enter the submission statement in the required language (using the multi-lang filter if multiple languages are required) in the 'Submission statement' (submissionstatement) field then save the changes.

===Submission plugins===
Here the administrator can enable, disable or change the order and default settings for any submission plugins.
;Submission comments
:Note that if submission comments are enabled here AND comments enabled globally in ''Site Administration > Advanced features'') then students will be able to send a message to their teacher when submitting their assignment. If either of those settings is disabled, then the submission comments link will not appear.

===Feedback plugins===
====Manage assignment feedback plugins====
Here the administrator can enable, disable or change the order and default settings for any feedback plugins.
;Annotate PDF
:This is the place to upload stamps for teachers to use when annotating student PDFs.

===== Check Ghostscript=====
You can also check the ghostscript path from here:
{|
|[[File:Selection_116.png|thumb|Ghostscript not installed or incorrectly installed]]
|[[File:Selection_115.png|thumb|Ghostscript correctly installed]]
|}

If the default stamps are deleted by accident, they can be found in mod/assign/feedback/editpdf/pix and re-uploaded.

[[de:Aufgabe konfigurieren]]
[[fr:Ajouter/modifier un devoir]]
[[ja:課題を追加/編集する]]
[[es:Configuraciones de tarea]]
[[it:Impostazioni Compito]]

Assignment settings

2025-08-04T13:35:50Z

Tsala: /* Submission settings */ Allowed attempts (MDL-80743)

{{Assignment}}
This page explores in more detail the settings for the [[Assignment activity]] once you have added it to your course and also covers the Site administration settings.

Note that if you want to edit an existing assignment, click the Edit link to its right and choose the action you wish to take, e.g. 'Edit settings'.

==General==
*In the Description, give a general explanation of the assignment. Check the box if you want this description to display on the course page.
*In Additional files, you can add files which may be of help to the students as they do their assignment, such as example submissions or answer templates.

*In Activity instructions, explain in greater detail what students must do. This is displayed when they edit and submit their assignment.

==Availability==

;Allow submissions from
:This stops students from submitting before the shown date, but it doesn't hide the assignment and any included instructions or materials.
;Due date
:Submissions are still allowed after this date but will be marked as late. Disable it by unticking the checkbox. Assignments without a due date will appear on the dashboard with 'No Due Date' displayed.
;Cut-off date
:After this date, the submit button will be hidden, and students will not be able to submit.
;Remind me to grade by.
:A date needs to be entered here for the assignment to display on the teacher's [[Timeline block]] and in the [[Calendar]]. It will show when at least one student has submitted.

;Time limit
:An assignment may have a time limit, similar to a the Quiz activity. However, the time limit does not prevent learners from submitting after the time has passed. They can still submit but their submission is marked as submitted after the time limit. The time limit feature must be enabled by the admin from ''Site administration > Plugins > Assignment settings > Enable timed assignments.''

==Submission types==

Here you can decide how you wish students to submit their work to you.

Note: If Submission comments are enabled in ''Administration>Plugins>Activity modules>Assignment>Submission plugins'', students will be able to add a note to their teacher on submitting work. If Anonymous submissions are enabled, student comments display in the gradebook as from "Participant 01 etc" to avoid revealing identities.

;Online text
:Students type their responses directly in Moodle using a text editor (such as the [[Atto editor]] which automatically saves text at regular intervals.)

It's possible to set a word limit on an online text assignment. Students get a warning if they try to exceed the word limit. Numbers are counted as words and abbreviations such as ''I'm'' or ''they're'' are counted as single words.

;File submissions
:Students can upload one or more files of any type the teacher can open. The teacher can annotate uploaded PDFs, docx and odt files within the browser, and on saving, the annotated file is made available to the student. (Check with your admin that [https://en.wikipedia.org/wiki/Ghostscript Ghostscript] and a [[Document converters|document converter]] are enabled, if you can't annotate uploaded files.)

[[File:404annotateassignment.png|center]]

Comments may be collapsed to make it easier to read the original text:

[[File:collapsedcommentexample.png]]

;Maximum submission size
:The maximum upload size refers to each file a student uploads. It cannot be larger than the limit in the Course settings.
;Accepted file types
:The teacher can specify the types of file the students may upload to the assignment. A file type selector appears upon clicking 'Choose', offering a choice of different file types. (See the video [https://youtu.be/vN1DlHeZkw4 File type selection] for more information.) Leaving the field blank will allow all file types.

If the file types have been restricted, then when students attempt to submit the assignment, they will see a message telling them which files are accepted:
[[File:studentfiletyperestrictions.png|thumb|500px|center|Student view of specified files]]

==Feedback types==
;Feedback comments
:With this enabled, markers can leave comments for each submission (which appear on the assignment grading screen.) Audio and video comments may also be left, using the icon in the text editor.

'''Annotate PDF''' appears if this setting is enabled by the Site administrator in the ''Manage assignment feedback plugins'' section of Site admin and will allow the teacher to annotate using comments, stamps and other features.

;Offline grading worksheet
:This is useful if you wish to download the grading list and edit it in a program such as MS Excel.
{|
|[[File:excelgrades.png|thumb|Editing the grades offline]]
|}

When the teacher has completed their grading offline, they can then upload the spreadsheet, confirm the changes and the grades and comments will be transferred over into Moodle's gradebook:

{|
|[[File:uploadgradingworksheet.png|thumb|Uploading the grading worksheet]]
|[[File:confirmchanges.png|thumb|Confirming the changes]]
|}

;Feedback files
:This allows markers to upload files with feedback when marking. These files may be the marked up student assignments, documents with comments, a completed marking guide, or spoken audio feedback. It enables the Feedback Files column in the assignment grading screen (accessed from the Submissions link in Assignment navigation). To upload feedback files, click the Grade button top right and then upload either with drag and drop or using the [[File picker]]. Alternatively, click the three dots next to a specific student in the grading screen, click Grade and upload in the same way.
{|
|[[File:45feedbackfiles.png|thumb|center|Uploading feedback files]]
|}
'''Uploading multiple feedback files''' is also possible:
#Download the students' assignments using the "Download all submissions" link.
#Extract the folder offline and add your comments to the student's submissions. Keep the names the same.
#Select the students' submissions and zip them into a new folder. Important: Don't just edit them inside their original folder and re-zip this; it will not work. The folder name does not matter as long as the feedback files have the same names as before.
#Upload this newly zipped folder.
#You will be presented with a confirmation screen displaying your feedback files. (If you zip files from a Mac, make sure to remove the folder _MACOSX)

{|
|[[File:multiplezip1.png|thumb|Confirmation screen displaying the feedback files to be uploaded]]
|[[File:multiplezip2.png|thumb|Screen confirming uploaded feedback]]
|}

;Comment inline
:This usefully allows you to comment directly on an 'online text' type submission.

==Submission settings==
;Require students click submit button
:If this is set to 'No' students can make changes to their submission at any time. (If you want to stop them changing work once you are ready to grade, click the Submissions link; locate the student and From the Status column, click the the three dots icon and select 'Prevent submission changes'.)
:If set to 'Yes', students can upload draft versions of the assignment until such time as they are ready to submit. Clicking the submit button tells the teacher they have finished drafting and want the work to be graded. They can no longer edit it and must ask the teacher to revert to draft status if they need to change it again. To do that, click the Submissions link, locate the student and from the Status column, click the three dots icon and select 'Revert the submission to draft'. To do this in bulk, select the relevant students and from the Status menu at the top of the grading screen, select your chosen action.

{|
|[[File:preventsubmissionchanges45.png|thumb|Prevent submission changes]]
|[[File:revertdraft.png|thumb|Status at top of screen for bulk select]]
|}

;Require that students accept the Submission statement
:An administrator can define a "Submission statement" (see below) i.e. a statement where students promise the work is their own and which they must agree to before submitting their work. If the administrator has given teachers the option of using a submission statement or not, then it will be available in the assignment settings screen. If the administrator has forced the statement throughout the site, a teacher will not have this option in the settings but a student will see the statement when accessing their assignment. '''Note:''' The admin can set different submission statements for individual or group submissions.
{{New features}}
;Allowed attempts
: The maximum number of attempts that can be made. Once this number is reached, the submission can no longer be reopened. If set to unlimited, another setting appears, '''Grant attempts''' (new in Moodle 4.5) with options Manually (via the Submissions page or Grader page), Automatically, and Automatically until pass.

==Groups submission settings==
These settings allow students to collaborate on a single assignment, e.g. working in the same online area or uploading, editing and reuploading an MS Powerpoint in the common assignment area.

When grading, the teacher may choose to give a common grade and feedback to all students in the group or to give individual grades and feedback to each member.

;Require group to make submission
:Students not in a group can still submit assignments unless this is forced in ''Site administration > Plugins > Assignment > Assignment settings''. Moodle will then display a message ''You're not a member of any group; please contact your teacher'' , and the student will not be able to submit the assignment.
;Require all group members submit
:This setting will only appear if the teacher has ticked the "Require students click submit button" earlier. The assignment will not be classed as "submitted" until all members of the group have made a contribution. When one student has submitted, the other members of the group will be able to see who still has to submit.
;Grouping for student groups
:If a particular grouping is selected here, then the gradebook will display any other groups and non-grouped students in the "default group", while naming the group(s) that are in the chosen grouping. If "none" is selected, then the gradebook will display the names of all groups and put any non-grouped students in the "default group". See this [https://moodle.org/mod/forum/discuss.php?d=216399#p942913 forum post on grouping for student groups] for examples of how this might be used.

==Notifications==
(Note that if you are using group mode then course teachers need to be members of the group in order to receive submission and late submission notifications.)

{{New features}}
Learners receive the following assignment notifications (via their preferred notification format):
* Assignment due in 7 days
* Upcoming assignment due (48 hours before the due date)
* Assignment overdue.

==Grade==
*See [[Grade points]] and [[Advanced grading methods]] for more information on the settings here.
*Setting a passing grade may be connected with [[Activity completion]] and [[Restrict access]] such that a student will not be able to access a follow up activity until they have passed this assignment.

===Anonymous submissions===
This hides students' names when grading and instead shows randomly generated Participant numbers.

With Anonymous submissions, students cannot see the final grade until all of the students' names have been revealed. Rubrics will also be hidden from students' view until the names are revealed. To reveal student names after you are finished grading, look under ''Assignment settings > Reveal student identities''. Feedback comments will appear whether or not student names are hidden or revealed. Note that this level of anonymity might not suit the privacy requirements of your organisation. See MDL-35390 for more details.

Users with the capability [[Capabilities/mod/assign:viewblinddetails|View student identities when Anonymous submissions are enabled]] (by default managers only) can view student identities and participant numbers.

Users with the capability [[Capabilities/moodle/site:viewanonymousevents|View anonymous events in reports]] (by default managers only) can view student submissions to assignments with Anonymous submissions (in Moodle 3.9 onwards).

===Marking (grading) workflow===
This lets you keep grades and feedback hidden until you are ready to release them to students. It is also useful if you want to show your progress in grading, or co-ordinate multiple markers/graders.

{|
|[[File:26markingworkflow.png|thumb|Marking workflow state in the individual grading screen]]
|[[File:26quickgradingworkflow.png|thumb|Dropdown to select marking workflow state when quick grading]]
|}
The phases are:

* Not marked (the marker has not yet started)
*In marking (the marker has started but not yet finished)
*Marking completed (the marker has finished but might need to go back for checking/corrections)
*In review (the marking is now with the teacher in charge for quality checking)
*Ready for release (the teacher in charge is satisfied with the marking but wait before giving students access to the marking)
*Released (the student can access the grades/feedback)

;Marking allocation
:Marking allocation can be used if marking workflow is set to Yes. Teachers can then be selected to grade or review submitted work of specific students.

{|
|[[File:marking45.png|thumb|Allocated markers on the grading screen]]
|}

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

*[[Capabilities/mod/assign:exportownsubmission|Export own submission]]
*[[Capabilities/mod/assign:grade|Grade assignment]]
*[[Capabilities/mod/assign:submit|Submit assignment]]
*[[Capabilities/mod/assign:view|View assignment]]

Role permissions for the activity can be changed from the gear icon Actions menu.

==Site administration settings==
Administrators can access assignment configuration options by expanding ''Administration > Site administration > Plugins > Activity modules > Assignment''.

===Assignment settings===
Here, the administrator can set defaults for certain settings. They may also make certain settings 'Advanced' which means a course teacher has to click the 'Show more' link to see them, or they may 'lock' settings which means a course teacher cannot alter that setting.

If the site contains courses with over 100 participants, the number of assignments listed on the assignment grading page may be limited using the Maximum assignments per page (assign | maxperpage) setting. This removes 'All' from the 'Assignments per page' setting.

;Submission statement
:Here is where the administrator can enter text which will appear when students are about to submit an assignment. There are three options:

{|
|[[File:submission37.png|thumb|Admin view of Submission statement set up screens - click to enlarge]]
|[[File:44submissionstatement.png|thumb|Student view when about to submit - click to enlarge]]
|}

If it is left as the default "No", then teachers will have the choice within their own assignments to force this or not.

The submission statement may be shown in different languages. See [[Multi-language content filter]] for how to do this.

Note for sites using languages other than English: There is currently a bug affecting the default assignment submission statement - it doesn't display in a user's language (MDL-54731). A workaround is to enter the submission statement in the required language (using the multi-lang filter if multiple languages are required) in the 'Submission statement' (submissionstatement) field then save the changes.

===Submission plugins===
Here the administrator can enable, disable or change the order and default settings for any submission plugins.
;Submission comments
:Note that if submission comments are enabled here AND comments enabled globally in ''Site Administration > Advanced features'') then students will be able to send a message to their teacher when submitting their assignment. If either of those settings is disabled, then the submission comments link will not appear.

===Feedback plugins===
====Manage assignment feedback plugins====
Here the administrator can enable, disable or change the order and default settings for any feedback plugins.
;Annotate PDF
:This is the place to upload stamps for teachers to use when annotating student PDFs.

===== Check Ghostscript=====
You can also check the ghostscript path from here:
{|
|[[File:Selection_116.png|thumb|Ghostscript not installed or incorrectly installed]]
|[[File:Selection_115.png|thumb|Ghostscript correctly installed]]
|}

If the default stamps are deleted by accident, they can be found in mod/assign/feedback/editpdf/pix and re-uploaded.

[[de:Aufgabe konfigurieren]]
[[fr:Ajouter/modifier un devoir]]
[[ja:課題を追加/編集する]]
[[es:Configuraciones de tarea]]
[[it:Impostazioni Compito]]

Grader report

2025-08-04T12:39:37Z

Tsala: /* Viewing and editing grades */

{{Grades}}
All the grades for each student in a course can be found in the course gradebook, or 'Grader report', accessed from the Course navigation.

The following screencast gives a general overview of the Gradebook.

{{MediaPlayer | url = https://youtu.be/pirrXF0py1A?si=PhoLFNwzOYDTJj1g | desc = Overview of the gradebook}}

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

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

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

==Hiding settings globally==

Admin settings hide parts of the user interface:

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

==Display==

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

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

From the three dots next to a category name you can select to
*show grades only
*show grade totals
*show grades and totals.

[[File:categorydots.png|200px|center]]

Collapse columns by clicking the three dots next to a grade item. Collapsed columns show with a + sign. Click the + to expand them again one at a time.
From the Collapsed columns link on the right, quickly see and search how many columns are collapsed.

[[File:collapsedcolumnssearch.png|250px|center]]

The three dots next to a grade item also allows you to:
* switch to Single view.
* change the order (ascending/descending).

[[File:gradeitemthreedots.png|300px|center]]

===Scrolling through the gradebook===

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

[[File:scrolling28a.png|thumb|500px|center|Scrolling in all directions]]

===Searching and filtering the Grader report===

*If you change the course settings Group mode to Visible groups or Separate groups a drop-down menu will appear in the gradebook to allow you to filter your students by groups.
*You can search easily by starting to type the first few letters of the name of the person (or email or ID number or other user identity item) or group you wish to find.

[[File:Graderreportsearch.png|thumb|400px|center]]

===Records per page===
At the bottom of the Grader report, you can select to show 20, 100 or All students on the page.

If you change the setting, it is remembered and applied to the Grader report in all your other courses. If there are more than 5000 students, then All will show 5000, with pagination to show the rest.

==Viewing and editing grades==

=== Viewing Assignment feedback ===

*If you have a given feedback to a learner in an assignment, an asterisk icon will display. Click the three dots in that column to view the feedback in a modal window.
[[File:feedback12.png|center]]

===Altering the grades===
You can click "Turn editing on" at the top right to enter grades directly in the grader report. When you are done, click 'Save changes'. From the cell actions menu (...) you can also follow the link 'Edit grade' to set the grade, its written feedback and a number of other attributes.

Note: If you enter grades directly in the grader report, they are then shown with an overridden icon (box with pencil) to indicate grades which have been manually changed.

===Altering the grades using Single view===
The single view interface allows you to enter grades in bulk for a specific grade item or a specific user. To change a specific grade or all grades, click on the Override checkbox by the specific grade row or use the Override All action to check every row. If you wish to override all grades with a set grade, select Bulk insert grades from the Actions menu and enter the grade that you wish to insert. You can select whether to fill the grade for just empty grades or for all grades from the dropdown list.
Click on Save and you will now see in the Grader Report that all grades the specific item/user have been overridden with the grade/grades that you entered.

Tip: You can move between grades in Single view using Ctrl+arrow keys.

===Hiding columns or individual grades===
Clicking the three dots next to a grade item will give you the option to hide or lock that item (along with options to edit it and view the grade analysis).

'''Note that visibility of quiz grades is controlled by the quiz settings''' (in the Review options section).

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

==Gradebook capabilities==

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

==Extending the gradebook==

The Gradebook can be extended in three main ways:

# [https://moodle.org/plugins/browse.php?list=category&id=9 Grade reports]
# Grade import plugins
# [https://moodle.org/plugins/browse.php?list=category&id=10 Grade export plugins]

==See also==
* [https://mediateca.educa.madrid.org/documentos/a66szhkshwqljco9 el Libro de calificaciones] - manual en español por Jesús Baños Sancho.
* Join the discussions about gradebook plugins in the [https://moodle.org/mod/forum/view.php?id=2122 Gradebook forum].

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

Recently accessed items block

2025-08-04T09:17:10Z

Tsala: screenshot and text update (MDL-85872)

{{Blocks}}
The Recently accessed items block appears by default in new sites on the [[Dashboard]] to display the activities and resources which an enrolled user has most recently accessed, allowing them to quickly find where they were previously on the site.

[[File:500recentlyaccesseditemsblock.png|frame|none|link=|alt=|Recently accessed items block showing links to 3 activities and a button 'Show more items'.]]

[[es:Bloque Ítems accedidos recientemente]]
[[de:Zuletzt genutzte Objekte]]

File:500recentlyaccesseditemsblock.png

2025-08-04T09:11:52Z

Tsala:

admin/setting/blocksettingaccessreview

2025-07-29T06:57:50Z

Tsala: redirect

#REDIRECT [[Accessibility Toolkit]]

Managing tags

2025-06-26T09:11:33Z

Tsala: /* Tag areas */

{{Tags}}Tags can be managed by a site administrator or manager (or any other user with the capability [[Capabilities/moodle/tag:manage|moodle/tag:manage]]) in ''Site administration > Appearance > Manage tags''.

==Tag collections==

Tag collections are a way to separate out tags by the type of objects the tags are attached to, or sets of tags for different areas.

For example, a collection of standard tags can be used to tag courses, with user interests and blog post tags kept in a separate collection. When a user clicks on a tag, the tag page displays only items with that tag in the same collection including the same types of objects.

Tags can be automatically added to a collection according to the area tagged or can be added manually as standard tags.

Clicking on the name of a tag collection then displays the list of tags, together with information on their creators, how many times they are used, when they were last modified, which tags have been flagged as inappropriate and which tags are marked as standard.

[[File:managestandardtags.png|thumb|center|600px|Accessing and managing tags]]

Standard tags are tags which are added by a site administrator and are available for others to use. Standard tags are never deleted during clean-up tasks even when there are no tagged items.

===Adding a new collection===

A new collection may be added by clicking the 'Add tag collection' link and giving the new collection a name:

[[File:NewTagAreasDB.png|thumb|center|600px|A new tag collection]]

Tag areas may then be selected for this collection, by clicking the pencil icon of a particular tag area in the Tag collection column, and changing it from 'Default collection' to the chosen, new collection:

[[File:tagareaselect.png|center]]

==Tag areas==

Areas in which tags may be used may be enabled or disabled as required. For example, if you don't intend to use course tags on your site, the courses tag area can be disabled so that the Tags section doesn't appear on the edit settings page for each course. If you have turned off Blogs at the system level, then you would usually turn off blog tagging too.

Available tag areas are:

* Courses
* Activities and resources
* Blog posts
* External blog posts
* User interests
* Questions
* Book chapters
* Forum posts
* Glossary entries
* Wiki pages
* Database entries

==Managing a tag collection==

*Tags which are flagged as inappropriate are indicated in red (colour may vary with non-standard theme).
*Tags may be renamed (inline, by clicking on the pencil icon next to them), marked as standard or reset. Tags may also be deleted individually or in bulk.
*Tags may be filtered by adding a term to the search box:

[[File:tagsfiltering.png|thumb|600px|center|Tag search results]]

===Combining tags===

Tags with similar names may be combined by an administrator or manager by selecting them and then, from the bottom of the screen, clicking the 'Combine selected tags' button. A pop up will appear asking which name you want to keep, and clicking 'Continue' will then combine the tags:

[[File:combinetags.png]]

[[cs:tag/manage]]
[[es:Gestión de marcas (tags)]]
[[eu:Etiketak kudeatu]]
[[fr:Gérer les tags]]
[[de:Schlagwörter verwalten]]

Grade items

2025-05-25T14:44:43Z

Tsala: /* Advanced grade item options */ options removed in MDL-78967

{{Managing grades}}
A grade item is a unit (typically an activity) where course participants are assessed through a grade or mark.
As such, a grade item is a container for grades and a set of settings applied to these grades. The settings affect the calculation and display of the grades in the gradebook reports and [[Grade export|exports]].

'''Grade items''' may refer to course activities (e.g. a quiz, an assignment etc.), [[Outcomes]] or manual grades.
== Grade items and gradebook ==
The three building blocks of the Gradebook are:
#The grade item
#The [[Grade categories|grade category]]
#The [[Grades|grade]]
Grade items are represented by columns in the [[grader report]].

Within a category, a [[Grades|grade]] summary is also a grade item itself. Summary grade items for a category can show up in reports, and can be used in the calculation of the grade for the parent category.
== Activity-based grade items ==
[[Image:editingradeitem.png|right|thumb|Editing a grade item]]
A number of activities such as [[Assignment]], [[Workshop]], [[Lesson]], [[Quiz]] and others communicate their grades to the gradebook. The generated grade item can later be changed directly from Course administration>Grades, but this will then freeze it in the activity itself; so, a teacher who has edited an assignment grade in the gradebook will not be able to change it from the assignment, unless they unlock it in the gradebook.

Here is a list of the settings that can be edited for an activity-based grade item:
*'''Item name''': The name given to this item, for example the assignment name
*'''Item info''': General information about the grade item. Optional.
*'''Grade to pass''': Specify the minimum grade a student must achieve to be considered to have passed this item. This must be in real grades, not a percentage. Once this is done, grades will be highlighted in red for fail and green for pass in the gradebook. (The Grade to pass may also be specified from activity set up pages.) NB - if your grade type (see below) is a scale then the grade to pass is your lowest grade that counts as a pass. For example, with the grade scale: '''Fail, Accept, Merit, Distinction''' the lowest grade that counts as a "'''pass'''" is "'''Accept'''" therefore the Grade to Pass is set to 2, as it is the second item in the list that goes from negative to positive.
*'''Grade type''': There are 4 grade types:
#None - No grading possible
#Value - A numerical value with a maximum and minimum
#Scale - An item in a list - see [[Scales]]
#Text - Feedback only
Only value and scale grade types may be aggregated. The grade type for an activity-based grade item is set on the activity settings page.
*'''Overall decimal points''': This specifies the number of decimal points to display for each grade. It has no effect on grade calculations, which are made with an accuracy of 5 decimal places.
*'''Multiplicator''': Factor by which all grade for this grade item will be multiplied, with a maximum value of the maximum grade. For example, if the multiplicator is 2 and the maximum grade is 100, then all grades less than 50 are doubled, and all grades 50 and above are changed to 100.
*'''Offset''': Number that will be added to every grade for this grade item, '''after''' the Multiplicator is applied. (Can be a negative number.)
*'''Hidden''': Whether this grade item should be hidden from students.
*'''Hidden until''': An optional date after which the grade item will no longer be hidden (i.e. a grades release date). Note that 'Hidden' and 'Hidden until' can currently both be ticked. This problem is reported as MDL-59646.
*'''Locked''': Whether or not to lock this grade item. A locked grade item doesn't accept changes to its settings or grades from its related module.
*'''Locked after''': A date after which the locking will be effective, usually after the grades release date.

== Outcome items ==
An outcome item is in most respects the same thing as a grade item. The main difference between the two is that the purpose of an outcome item is to rate students on a particular [[Outcomes|outcome/competency/goal]], whereas grade items are used for grading students, usually with the intention of aggregating the results as a measure of the student's performance in the course activities.

An outcome item is always linked with an [[Outcome|outcome]], which itself is linked to a [[Scales|scale]]. The scale may represent a quantitative measure, its values being arranged from lowest to highest; or it may represent a qualitative measure, in which the order of the scale values is irrelevant. The first type can be aggregated, but the second type shouldn't (we wouldn't want to fail a student because her favourite colour is "blue"!).

An outcome item may optionally be linked to an activity. This activity may or may not appear in the gradebook (for example, a wiki is usually not graded, so does not appear). Linking an outcome item with an activity creates a grade item with the icon of the linked activity, but there is no other way to see which activity it is linked with. For this reason, it is a good idea to include the activity name in the name of the outcome item (e.g. Wiki 1: Participation).

These can either be generated by the creation of a new activity module (by selecting [[Outcomes]] in the module creation form), or manually created like manual grade items. A grade outcome item uses a course outcome as its grading type, so such an outcome must be made available at the course level before a grade outcome item can be manually created.

The settings of the grade outcome item edit form are identical to those of manual grade items, with the addition of two settings:
*'''Outcome''': The course outcome represented by this item
*'''Linked activity''': The optional activity module to which this item will be linked
== Manual grade items ==
[[File:editingmanualgrades.png|right|thumb|Editing a manual grade item]]
These grade items are created manually from ''Course administration > Gradebook setup''. The "Add grade item" button is clicked, and the form appears. Several options are available here;
*'''Item name''': The display name of your grade item
*'''ID Number''': An arbitrary string of characters used to refer to this grade item in Formulas. If set, it must be unique.
*'''Grade type''': The type of grade: None (no grading possible), Value (a numerical value), Scale (an item in a list) or Text (arbitrary text).
*'''Scale''': Which scale to use for grading: available only when the Scale grade type is selected.
*'''Maximum grade''': The maximum grade that can be given (for scales: the number of items in the scale - 1)
*'''Minimum grade''': The minimum grade that can be given (for scales: 0)
Manual grade items are recognised in the Grader report by their icon like a pencil:

[[File:manualgradeitem2.png]]

Note that this icon is not clickable; to edit the manual grade item you have to click the edit icon just below it.
==Grade item settings==
===Site defaults===
Grade item settings, accessed from ''Administration > Grades > Grade item settings,'' are the various settings that the administrator is able to edit for the grader report used by teachers. These settings will change what items are displayed for each grade. As administrator, you would turn on or off various settings and the teacher would input the actual data.
[[Image:newgradeitemsettings.png|thumb|center|Grade item settings screen]]
===Grade display type===
This is the type of grade that is to be shown for each individual grade. Different organisations use different grade types so you can select the one that best meets your needs.

*[[Grade letters|Letter]]- Grade in the form of a letter representing a range of percentages.
*Percentage - Grade from 0 - 100% indicating the total points received divided by maximum possible amount times 100.
* Real - Actual grade or scale values, from minimum to maximum range. Default from 0-100 but may be arbitrary.

You can also choose to display two grade types, with the second in brackets.

*Letter (percentage) e.g. A (80)
*Letter (real) e.g. A (8)
*Percentage (letter) e.g. 55 (C)
*Percentage (real) e.g. 55 (5.5)

===Overall decimal points===
This setting is for display purposes only. Grade calculations are made with an accuracy of 5 decimal places and grade letters, if used, are assigned accordingly.

If rounding of grades in [[grade calculations]] is required, the round(number, count) function may be used.

[[ca:grade/edit/tree/item]]
[[de:Bewertungsaspekte]]
[[es:Ítems de calificación]]
[[fr:Éléments de note]]
[[ja:評定項目]]

MoodleDocs:Overview

2025-04-16T11:47:29Z

Tsala: redirect

#REDIRECT [[:en:MoodleDocs:Overview]]

Awards

2025-04-16T11:46:46Z

Tsala: redirect

#REDIRECT [[:en:Awards]]

Creating SCORM Content

2025-04-16T11:44:14Z

Tsala: redirecting to latest version

{{SCORM}}
The up-to-date list of tools for creating SCORM content is available in the latest Moodle Docs wiki: [[:en:Creating SCORM Content]]

[[de:Autorenwerkzeuge]]
[[es:Creando contenido SCORM]]

MediaWiki:Noarticletext

2025-04-16T11:43:30Z

Tsala:

{{Main page}}
This page does not exist. You can [[:en:{{NAMESPACE}}:{{PAGENAME}}|check whether it exists in the documentation for the latest stable version of Moodle]] or [[Special:Search/{{PAGENAME}}|search for this page title]] in other pages.

You are also welcome to [{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|action=edit}} create it] yourself :-)

==See also==

*[[MoodleDocs:Guidelines for contributors]]

Talk:Using question bank

2025-04-15T06:33:00Z

Tsala: reply

Do we really need this page, or can all the great content be added to [[Question bank]]? --[[User:Helen Foster|Helen Foster]] 00:45, 31 January 2012 (WST)

:I'd always say where possible to have one page that does the job of two as long as it isn't over long - we could combine them and I will take a look at improving the new one single page?--[[User:Mary Cooch|Mary Cooch]] 02:14, 31 January 2012 (WST)

::Good plan, thanks Mary :-) --[[User:Helen Foster|Helen Foster]] 04:17, 31 January 2012 (WST)

Can we now delete this old page?
No other page links to it.
And the "Question bank" page seems quite complete. [[User:German Valero|German Valero]] ([[User talk:German Valero|talk]])

:German, thanks for your comment. I have added a redirect to [[Using question bank]]. --[[User:Helen Foster|Helen Foster]] ([[User talk:Helen Foster|talk]]) 06:32, 15 April 2025 (UTC)

Using question bank

2025-04-15T06:31:23Z

Tsala: redirect

#redirect [[Question bank]]

MediaWiki:MoodleDocsVersionLinks

2025-04-04T10:37:39Z

Tsala:

4.5 docs: /405/en/{{FULLPAGENAMEE}}
5.0 docs: /500/en/{{FULLPAGENAMEE}}
4.4 docs: /404/en/{{FULLPAGENAMEE}}
4.1 docs: /401/en/{{FULLPAGENAMEE}}

Template:New features

2025-03-20T15:29:30Z

Tsala:

[[:Category:New features|New feature in '''Moodle 5.0'''!]]
<includeonly>[[Category:New features]]</includeonly>
<noinclude>This template will categorize articles that include it into [[:Category:New features]].</noinclude>

MoodleDocs:Overview

2025-03-20T15:28:50Z

Tsala: /* English */ 5.0

==English==
[https://docs.moodle.org/500/en/ 5.0 EN documentation] 
[https://docs.moodle.org/405/en/ 4.5 EN documentation] 
[https://docs.moodle.org/404/en/ 4.4 EN documentation] 
[https://docs.moodle.org/403/en/ 4.3 EN documentation] 
For earlier versions, see [[MoodleDocs: Docs for unsupported versions|Docs for unsupported versions]].

Also: 
[https://moodledev.io/ Developer documentation]

==Català (Catalan)==

[https://docs.moodle.org/2x/ca/ 2.x CA documentation] 

==Deutsch (German)==
[https://docs.moodle.org/405/de/ 4.5 DE documentation] 
[https://docs.moodle.org/404/de/ 4.4 DE documentation] 
[https://docs.moodle.org/403/de/ 4.3 DE documentation] 

==Español (Spanish)==

[https://docs.moodle.org/all/es/ ES documentation]

==Euskara (Basque)==

[https://docs.moodle.org/all/eu/ EU documentation]

==Français (French)==

[https://docs.moodle.org/4x/fr/ 4.x FR documentation] 
[https://docs.moodle.org/3x/fr/ 3.x FR documentation] 

==Hrvatski (Croatian)==

[https://docs.moodle.org/all/hr/ HR documentation]

==Íslenska (Icelandic)==

[https://docs.moodle.org/all/is/ IS documentation]

==Italiano (Italian)==

[https://docs.moodle.org/35/it/ 3.5 IT documentation]

==日本語 (Japanese)==

[https://docs.moodle.org/3x/ja/ 3.x JA documentation] 

==Polski (Polish)==

[https://docs.moodle.org/2x/pl/ 2.x PL documentation]

==Português Brasileiro (Brazilan Portuguese)==

[https://docs.moodle.org/all/pt_br PT_BR documentation]

==Suomi (Finnish)==

[https://docs.moodle.org/3x/fi/ 3.x FI documentation] 

==中文 (Chinese)==

[https://docs.moodle.org/all/zh/ ZH documentation]

==See also==

* [[MoodleDocs: Docs for unsupported versions|Docs for unsupported versions]]

MoodleDocs:Read-only archives

2025-03-18T07:37:05Z

Tsala: Changed redirect target from MoodleDocs:MoodleDocs: Docs for unsupported versions to MoodleDocs:Docs for unsupported versions

#REDIRECT [[MoodleDocs:Docs for unsupported versions]]

feedback module

2025-03-18T07:36:10Z

Tsala: Changed redirect target from Feedback module to Feedback activity

#REDIRECT [[Feedback activity]]

enrol/meta/edit

2025-03-18T07:35:53Z