MoodleDocs - User contributions [en]

Question bank

2020-06-20T17:34:31Z

Jprovasnik: added additional link

{{Managing questions}}
This feature allows a teacher to create, preview, and edit questions in a database of question categories. The categories can be limited to being used on the site, course or quiz level. The questions in a category can be added to a [[Quiz module|Quiz]] or to a [[Lesson module|lesson activity]] via an export process. The teacher enters the question bank by creating or editing a quiz activity or via ''Course administration > Question bank''

==Select a category==
Questions are organised into categories. Initially each course has only one category called "Default". It is good practice to create more categories to organize your questions. This not only makes it easier to find questions, but makes the use of random questions and matching question easier. You can create a hierarchy of categories because you can create subcategories inside parent categories. To add or edit categories click on the "[[Question categories|Categories]]" tab.

The question editing screen shows the questions from the currently selected category. You choose this category from the '''Category:''' drop-down menu. Using the tick box below that menu you determine whether to also show the questions from all subcategories.

===Categories are shared in contexts===

There are separate question category trees in each different 'context' in which questions are shared. The contexts available to you depend on whether you access the question bank from an activity or from a course and depend on the permissions assigned you for access to questions. See [[Question contexts]] for more information on these contexts.

==Add a new question==
# Click the ''Questions'' tab to access the Question Bank page, if not there already.
# From the '''Category''' drop-down menu, select a category you want to add a question to.
# The page will change to show the questions already in that category
# Select the question type you want to create from the '''Create new question''' drop-down menu.
# Fill in the form for the question type you are creating. Each [[Question types|question type]] has its own form and has its own options.
# Click ''Save Changes'' at the bottom of the form.

==Edit, duplicate, preview, delete, move and tag==
[[File:NewQuestionEditIcons1.png]]

Each question in the question bank has four icons which allow you to tag, edit, quickly duplicate, preview and delete the question. (The question may not be deleted if it is already in use elsewhere.) To duplicate a question, click the duplicate icon (second from the left) and a copy of the question editing screen will appear. You can either edit this new copy or simply scroll down and click "Save changes."To move a question into a different category or subcategory, click into the box on its left; scroll down to "With Selected..." and choose "Move to.."

{{New features}}
A new tag icon allows you to tag questions directly from the question bank. You can then search and filter by tagged questions.

[[File:FilterByTag.png]]

==Tips and tricks==
*Put the answer into the question name so you can quickly see the answers when students are asking for answers. This is especially useful if you're dealing with large sets of questions! (No option yet for viewing category or answer of question in the list of questions.)
*Export questions in GIFT or Moodle XML formats, then import them into a Lesson. (Future versions of Moodle will make Question bank available to both Lesson and Quiz activities.)
*Remember that while some of the same question types can be found in both the Quiz and Lesson modules, they can be very different. Scoring and grading each student's choice is more robust in a Quiz. On the other hand, each Lesson question answer also has a [[Jumps|jump]] associated it.
*Use GIFT or other export modes to print questions and answers in a category. Hint, clever use of word processor macros, using search and replace, can tidy up a GIFT file for printing.
*The question title is useful in sorting and making notes. For example, "ZZ remove 2010-3 Why did the Moodler cross", will put this question at the bottom of the list. Or where you want a 'the' questions in a category to appear in a specific order, use letters or numbers, knowing that AA will come first, AB will be second in the list.
*Do a copy and paste from a PDF file into the question content area. Reduces "other" hidden code which Word, Open Office and other programs can insert.

==Sharing and Managing Question banks==

Be default, teachers can manage only the questions in the context of the courses they are in. You can set up a role to allow teachers to share and manager questions on a larger scale.

You can also use this role to create a special system-wide "Question bank Manager" instead of giving admin level or site-wide Manager access to a person managing the Questions.

See:

*[[How to let teachers share questions between courses]]
*[[How to minimize the question bank when doing backup/restore]]
*Quiz Question Bank: Quiz level vs Course level - Forum Discussion: https://moodle.org/mod/forum/discuss.php?d=405646

[[de:Fragensammlung]]
[[es:Banco de Preguntas]]
[[eu:Galdera-bankua]]
[[fr:Questions]]
[[ja:問題バンク]]

Checklist module

2020-04-09T15:43:15Z

Jprovasnik: added comments about soring

{{Infobox plugin
|type = Activity module, block and grade export
|entry = http://moodle.org/plugins/view.php?plugin=mod_checklist, https://moodle.org/plugins/view.php?plugin=block_checklist and https://moodle.org/plugins/view.php?plugin=gradeexport_checklist
|tracker = http://tracker.moodle.org/browse/CONTRIB/component/10608
|discussion = http://moodle.org/mod/forum/discuss.php?d=144764
|maintainer = [[User:David Smith 2|Davo Smith]]
|float = right
}}

[[Image:checklist_module_overview.png|thumb|Checklist Module]]The '''Checklist Module''' is an add-on that allows a teacher to create a checklist for their students to work through. It is contributed by [http://moodle.org/user/view.php?id=201866&course=1 David Smith].
The students should tick off each item on the list, as they complete it and the resulting progress of the class can be monitored by the teacher. The student is also rewarded with a progress bar that shows how far through the checklist they have managed to get.

Other features include:
* Indenting items, to show a hierarchy of importance
* Optional items (which can be hidden in the class progress report and contribute to a secondary 'all items' progress bar)
* Student checklist items (so that students can add their own items to keep track of)
* Dates on checklist items
* Choice of colours

There is a short [http://www.youtube.com/watch?v=wIpGuW_-sVg overview video] available on YouTube.

==Installation==
# Unzip the contents of file you downloaded to a temporary folder.
# Upload the files to the your moodle server, placing the 'mod/checklist' files in the '[moodlefolder]/mod/checklist' folder, (optionally) the 'blocks/checklist' files in the '[moodlefolder]/blocks/checklist' folder and (optionally) the 'grade/export/checklist' files into the '[moodlefolder]/grade/export/checklist' folder.
# Log in as administrator and click on 'Notifications' in the admin area to update the Moodle database, ready to use this plugin.

==Adding a checklist block==
# Click 'Turn editing on', in a course view.
# Under 'blocks', choose 'Checklist'
# Click on the 'Edit' icon in the new block to set the checklist to display and (optionally) which group of users to display.

==Exporting checklist progress (Excel)==
# In a course, click 'Grades'
# From the dropdown menu, choose 'Export => Checklist Export'
# Choose the checklist you want to export and click 'Export Excel'
If you want to change the user information that is included in the export ('First name', 'Surname', etc.), then edit the file 'grade/export/checklist/columns.php' - instructions can be found inside the file itself.

==Usage==
Click on 'Add an activity' and choose 'Checklist'.
Enter all the usual information.
You can optionally allow students to add their own, private items to the list (this will not affect the overall progress, but may help students to keep note of anything extra they need to do).

You can then add items to the list.
Click on the 'tick' to toggle an item between required, optional and heading
Click on the 'edit' icon to change the text.
Click on the 'indent' icons to change the level of indent.
Click on the 'move' icons to move the item up/down one place.
Click on the 'delete' icon to delete the item.
Click on the '+' icon to insert a new item immediately below the current item.

Click on 'Preview', to get some idea of how this will look to students.
Click on 'Results', to see a chart of how the students are currently progressing through the checklist.

Students can now log in, click on the checklist, tick any items they have completed and then click 'Save' to update the database.
If you have allowed them to do so, they can click on 'Start Adding Items', then click on the green '+' icons to insert their own, private items to the list.

If you allow a checklist to be updated by teachers (either exclusively, or in addition to students), it can be updated by doing the following:
# Click 'Results'
# Click on the little 'Magnifying glass' icon, beside the student's name
# Choose Yes / No for each item
# Click 'Save'
# (Optional) Click 'Add comments', enter/update/delete a comment against each item, Click 'Save'
# Click 'View all Progress' to go back to the view with all the students shown.

===Checklist Overview Sort Order===

The sorting for the block in 'overview' mode is as follows:
* Started, but incomplete checklists (ordered from least complete, to most complete), then
* Unstarted checklists (0%), then
* Completed checklists (100%)

A maximum of 20 checklists are shown and the ordering of checklists that have the same completion % is undefined (for MySQL it is likely to be the order they were created, for other DB systems, it may not be). As the overview works across multiple courses, there is no simple way to order the checklists with identical completion % in the same order that they would appear within a course.

===Normal items, optional items and headings in a checklist===

The checklist module fully supports headings:
# On the edit page, click on the 'tick' mark on the left to convert an item into an 'optional' item,
# Click again to convert it into a heading.

* Optional items are ones that contribute to the 'all items' progress bar, but not the 'required items' progress bar;
* Optional items don't contribute to the gradebook score, nor do they help the student to 'complete' the checklist.

==Automatic updating==

On the settings screen you can allow the checklist to import modules from the current course (or just the section the checklist is in). This will list the names of the resources / activities in the course and automatically tick them off, when they are 'completed' (note there will be a delay of up to 60 seconds between an activity being completed and the checklist updating, unless you are willing to make a few Moodle core code modifications).

Activities are considered complete, based on either the course logs being updated (e.g. resource viewed, forum posted to, etc.), a certain grade being achieved (Moodle 1.9 & assignment / quiz / forum only) or the Completion criteria being met (Moodle 2.0+ only).

==Adding labels to the checklist==
Labels are not included in checklists by default, as they would be confusing for most people.

However, if you do want labels to appear, you should only need to change a couple of lines of code.

Open up mod/checklist/locallib.php, find line 262 ( https://github.com/davosmith/moodle-checklist/blob/master/locallib.php#l262 ), which should look like:
if ($mods->get_cm($cmid)->modname == 'label') {
continue; // Ignore any labels
}
Just delete these 3 lines (or add '//', without quotes, to the start of each line) and labels should appear in the checklist.

[[es:Módulo lista de cotejo]]

Parent role

2020-04-01T22:44:49Z

Jprovasnik: added a link to a forum discussion

{{Roles}}
The role of '''Parent''' may be used to provide parents/mentors/tutors with permission to view certain information, such as activity reports, grades, blog entries and forum posts, about their children/mentees/tutees.

The Parent role may also be allowed to agree to policies on behalf of their underage child. See the section on agreeing to policies on behalf of the child.

===Creating a new role===

#As an administrator, go to ''Site administration > Users > Permissions > Define roles'' and click the "Add a new role" button.
#For archetype role choose "No role."
#Give the role a short name (such as "Parent", but it can be anything appropriate, such as tutor/mentor)
#Give the role a custom full name (such as "Parent", but it can be anything appropriate, such as tutor/mentor)
#Under Context types where this role may be assigned check the '''user''' context.
#Under the heading of '''Course'''
#Change [[Capabilities/moodle/user:viewdetails|moodle/user:viewdetails]] to ''allow'' - to access the student's profile
#Under the heading of '''Users'''
#Change [[Capabilities/moodle/user:viewdetails|moodle/user:viewalldetails]] to ''allow'' - to view all aspects of the student's profile
#Change any/all of the following capabilities to ''allow''
#*[[Capabilities/moodle/user:readuserblogs|moodle/user:readuserblogs]] - to read the student's blog entries
#*[[Capabilities/moodle/user:readuserposts|moodle/user:readuserposts]] - to read the student's forum posts
#*[[Capabilities/moodle/user:viewuseractivitiesreport|moodle/user:viewuseractivitiesreport]] - to view the student's activity reports and grades
#*[[Capabilities/moodle/user:editprofile|moodle/user:editprofile]] - to edit the student's profile
#*[[Capabilities/tool/policy:acceptbehalf]] for accepting policies on behalf of the student.
#Click the "Create this role" button.

{|
| [[File:CustomRole05.png|thumb|Setting up the parent role]]
| [[File:CustomRole06.png|thumb|Assigning capabilities to the parent role]]
| [[File:CustomRole07.png|thumb|Saving changes to the parent role]]
|}

Some permissions may already be set to "Allow", or the permissions granted here may not be the ones required for that Role. This set of Permissions mean that this Role allows anyone assigned to a Parent Role, then linked to the Student Role, to edit the profile or read the blogs of that Student - not everyone's profile or blogs.

==Assigning the parent to the student==

*Access the child's full profile page, via '''Site administration ► Users ► Accounts ► Browse list of users'''
*Click the child's name to view the profile.
*In the Administration section, click Preferences
*In the Roles section, click Assign roles relative to this user
*Choose the role to assign i.e. Parent by clicking on the word.
*Select the parent in the potential users list and use the Add button to add it to the existing users list.

{|
| [[File:Parentroleassignroles.png|thumb|500px|"Assign roles relative to this user"]]
| [[File:choosingparent.png|thumb|500px|Assigning the parent to the student]]
|}

At this point you can return to the "Assign roles in user:" page and you should see that the parent name is now in the "Users with Role" column.

:'''NOTE:'''The same parent may be assigned to several students, siblings or otherwise.

===Agreeing to policies on behalf of the child===
If the parent has been given the [[Capabilities/tool/policy:acceptbehalf]] then they can click on the child's profile, click the Policies and agreements link and agree to the policies there:

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

===Adding the Mentees Block===
This block needs to be added so parents can see links to their child's profile.

* On the Front Page, turn editing on.
*Go to the '''Add Blocks''' block and select the [[Mentees block]] and when it appears, click on the Configuration icon.
*Edit the configuration settings to suit the needs of the site. When complete, save the changes and return to the Front Page.

{|
| [[File:addmenteesblock.png|thumb|Accessing the Add Blocks]]
| [[File:configuringmenteesblock.png|thumb|Setting the configuration values]]
|}

===How a parent sees their child's activities===

*Once the mentees block has been added, a parent/mentor sees the link to any children/mentees they are responsible for.
*They click on a name and will be taken to the profile page of that user.
*They then select from "Course profiles" - the name of a course the user is enrolled in.
*Grades may then be viewed by clicking in the Reports section
*Forum posts or similar may also be viewed from the user's profile in the Miscellaneous section.
{|
| [[File:MOParentRole01a.png|thumb|Click the name of a course in the profile]]
| [[File:MOParentRole02.png|thumb|Only '''then''' choose an item, for example grades]]
| [[File:MOParentRole03.png|thumb|The course grades are now visible]]
|}

*To view activity in another course, the parent needs to click back to the user's main profile and then select another course link.

==See also==
*[http://www.youtube.com/watch?v=Gk_TRi_N00o The Parent role in Moodle 2.0 video]
*[[Create_custom_roles|Create a custom role]]
*[https://moodle.org/mod/forum/discuss.php?d=389146#p1568758 Forum discussion regarding limitations to the mentor role]

[[eu:Guraso_rola]]
[[fr:Rôle Parent]]
[[ja:親ロール]]
[[de:Eltern-Rolle]]
[[es:Rol paterno]]

User policies

2020-03-27T21:43:55Z

Jprovasnik: /* Gravatar default image URL */

{{Roles}}
==User policies==
The following settings may be changed by an administrator in ''User policies'' in the Site administration.

===Role for visitors===
Users who are not logged in to the site will be treated as if they have the role specified here, granted to them at the site context. The role of Guest is the default and the recommended setting for standard Moodle sites. The user will still be required to login to participate in an activity.

===Role for guest===
This option specifies the role that will automatically be assigned to the guest user. This role is also temporarily assigned to non enrolled users when they enter a course that allows guests without password.

(If you wish to deny guest access to a site altogether, the guest login button should be set to hide in ''Manage authentication'' in the Site administration.)

===Default role for all users===

It is recommended that the default role for all users is set to [[Authenticated user]]. To set it to a custom role, the custom role must be assignable in the system context and have role archetype set to none.

Note: It is not recommended that the default role for all users is set to student.

===Auto-login guest===

If not set, then visitors must click the "Login as a guest" button before entering a course which allows [[Guest|guest access]].

Note: If auto-login guest is set, the guest login button also needs to be set to show in ''Manage authentication'' in the Site administration, even though visitors won't necessarily use it.

===Hide user fields===
The following user fields appear on users' profile pages. Certain user fields are also listed on the course participants page. You can increase student privacy by hiding selected user fields.

Description, city/town, country, web page, ICQ number, Skype ID, Yahoo ID, AIM ID, MSN ID, last access, My courses and first access and groups

*User fields on users' profile pages are hidden from all users with the capability [[Capabilities/moodle/user:viewhiddendetails|moodle/user:viewhiddendetails]] not set.
*User fields on the course participants page are hidden from all users with the capability [[Capabilities/moodle/course:viewhiddenuserfields|moodle/course:viewhiddenuserfields]] not set.

===Show user identity===

Any of the following fields may be shown to users with the capability [[Capabilities/moodle/site:viewuseridentity|moodle/site:viewuseridentity]] when searching for users and displaying lists of users.

*ID number
*Email address
*Phone number
*Mobile phone
*Department
*Institution
*City/town (new in 3.4)
*Country (new in 3.4)

This setting is useful for sites with large number of users, where the likelihood of users with the same name is high.

Locations where user identity fields are shown are as follows:

*User selectors ([[Assign roles]] in some places, [[Groups|groups]], forum subscribers)
*[[Browse list of users]]
*[[Participants]]
*[[Gradebook|Grader report]]
*[[Quiz reports]]
*[[Using SCORM|SCORM reports]]
*[[Using Assignment|Assignment submissions]]
*[[Using Course completion|Course completion report]]
*[[Using Activity completion|Activity completion report]]

Tip: Select only one or two fields that are mandatory at your institution. Do not select more than two fields otherwise tables become very wide.

===Full name format===

See [[Additional name fields]] for details, also about the alternative full name format.

===Maximum users per page===

You can choose here the maximum number of users to be displayed when searching in courses, groups, cohorts etc. The default is 100 but if your Moodle site is very large you can increase the number here.

===Enable Gravatar===

[http://gravatar.com/ Gravatar] (an abbreviation for globally recognized avatar) is a service for providing globally unique avatars.

If a user has not uploaded a user picture, Moodle will check whether the user's email address has an associated gravatar and if so, will use the gravatar as the user's picture.

* [http://www.youtube.com/watch?v=Z4b7tJedlMA Use your Gravatar in Moodle 2.2 screencast]

===Gravatar default image URL===

In Moodle 2.3.3 onwards, if gravatars are enabled, an alternative default user picture may be specified. The options are:

* A gravatar default image - by entering a code such as ''mm'' or ''identicon'' - See https://en.gravatar.com/site/implement/images/ for codes of other gravatar default images.
* A specified image - by entering the image URL

If the field is left empty then the theme's default user picture is used.

==Unsupported role assignments==

Unsupported role assignments are role assignments in contexts that make no sense for that role, such as the course creator role in the course or activity context, or the teacher role in the user context.

Prior to Moodle 2.0, there was no 'Context types where this role may be assigned' setting in the edit role form, and so any role could be assigned in any context. Upon upgrading a site from 1.9, any role assignments in contexts that make no sense for that role are listed as unsupported role assignments.

In general, it is safe to delete all unsupported role assignments. In doing so, the worst that can happen is for a user to be unassigned a custom role; no other data loss will occur.

[[Category:Site administration]]

[[de:Einstellungen für Rollen]]
[[fr:Réglages des rôles]]
[[ja:ユーザポリシー]]
[[es:Políticas para el usuario]]

Capabilities/moodle/course:reset

2020-02-06T21:17:05Z

Jprovasnik:

{{Capabilities}}
*This allows a user to [[Reset course|reset a course]]
*This allows a user to reset an individual activity within a course
*This capability is allowed for the default roles of manager and teacher

[[Category:Capabilities|Reset]]
[[Category:Backup]]
[[es:Capabilities/moodle/course:reset]]

Capabilities/enrol/manual:unenrolself

2020-02-06T21:10:10Z

Jprovasnik:

{{Capabilities}}
*This allows a user to manually unenrol themselves from a course in which they were previously manually enrolled via ''Administration > Course administration > Unenrol me from this course''
*This capability adds an "Unenroll me from course” link in the Administration block of the course
*This capability is not set for any of the default roles
*To allow students to unenrol themselves from courses which they were previously manually enrolled in, the capability must be set to "allow" for the student role via ''Administration > Site Administration > Users > Permissions > Define roles.''

==See also==

*[[Manual enrolment]]

[[Category:Capabilities|Enrol]]
[[Category:Enrolment]]
[[de:Capabilities/enrol/manual:unenrolself]]

Capabilities/enrol/manual:enrol

2020-02-06T21:04:43Z

Jprovasnik:

{{Capabilities}}
*This allows a user to enrol other users into a course manually via ''Settings > Course administration > Users > Enrolled users''
*The default roles of manager and teacher have this capability set to allow.
*This allows users to see the “Enroll Users” button on the course [[Participants]] page

==See also==

*[[Manual enrolment]]

[[Category:Capabilities|Enrol]]
[[Category:Course]]
[[Category:Enrolment]]
[[de:Capabilities/enrol/manual:enrol]]

Capabilities/mod/hvp:getcachedassets

2020-02-06T13:28:07Z

Jprovasnik: Created page with "{{Capabilities}} *This allows a user to cache Interactive_Content_-_H5P_activity H5P assets, required for viewing H5P activities *This capability is allowed for the defaul..."

{{Capabilities}}
*This allows a user to cache [[Interactive_Content_-_H5P_activity]] H5P assets, required for viewing H5P activities
*This capability is allowed for the default roles of teacher and student
*This capability must also be added for the authenticated user role

[[Category:Audio]]
[[Category:Video]]
[[Category:Language teaching]]
[[Category:Mathematics]]

[[es:Actividad Contenido Interactivo - H5P]]
[[fr:H5P]]

Capabilities/moodle/restore:restoresection

2020-02-06T13:06:31Z

Jprovasnik:

{{Capabilities}}
*This allows a user to [[Course restore|restore course sections]]
*This capability is allowed for the default roles of manager and teacher
*This capability is required in order to use the Sharing Cart plugin

[[Category:Capabilities|Backup]]
[[Category:Backup]]

[[es:Capabilities/moodle/restore:restoresection]]

Capabilities/moodle/restore:restorecourse

2020-02-06T13:06:27Z

Jprovasnik:

{{Capabilities}}
*This allows a user to [[Course restore|restore a course]]
*This capability is allowed for the default roles of manager and teacher
*This capability is required in order to use the Sharing Cart plugin

[[Category:Capabilities|Backup]]
[[Category:Backup]]

[[es:Capabilities/moodle/restore:restorecourse]]

Capabilities/moodle/restore:restoreactivity

2020-02-06T13:06:24Z

Jprovasnik:

{{Capabilities}}
*This allows a user to [[Activity restore|restore an activity from a backup]]
*This capability is allowed for the default roles of manager and teacher
*This capability is required in order to use the Sharing Cart plugin

[[Category:Capabilities|Backup]]
[[Category:Backup]]

[[es:Capabilities/moodle/restore:restoreactivity]]

URL resource settings

2019-08-12T20:17:10Z

Jprovasnik: /* URL variables */

{{URL}}
==Adding a URL resource to your course==

# Turn editing on.
#From the the "Add an activity or resource" link (or, if not present, the "Add a resource" drop down menu),choose URL. All settings may expanded by clicking the "Expand all/Collapse all" link top right.

==General==
*Give your URL a name and type (or copy/paste) the URL into the External URL box. If you need to search for the correct URL, click the Choose a link button. When you find and select your link,it will be automatically pasted into the box.
*Give the URL a description if you wish, and tick the box to display that description on the course page if needed.
[[File:31URL.png|thumb|400px|center|Adding a URL]]

==Appearance==
For '''Display''' you have the following options. If you don't see an option, ask the administrator to enable it in ''Site administration >Plugins <Activity modules >URL.'' You can also have 'in frame' or 'New window' but these must be enabled by the administrator.

* ''Automatic'' - Make the best guess at what should happen (probably what is wanted 99% of the time).
* ''Embed'' - Show the Moodle page with heading, blocks and footer. Show the title/description of the item and display the file directly in the page as well
* ''Open'' - No Moodle heading, blocks, footer or description - just show the file in the web browser (e.g. shows image, PDF, flash animation, taking up the whole browser window)
* ''In pop-up'' - Same as 'Open', but opens a new browser window to show this file (without the Moodle heading, blocks, etc) - this browser window also does not have all the menus in it. If you select this one, then you can specify the pop-up width and height.

==URL variables==

This section allows you to pass internal information as part of the URL.

This is useful if the URL is actually an interactive web page that takes parameters, and you want to pass something like the name of the current user, for example.

Another use is to create stable links that updates in each iteration of the course, for example:

if you want to link to the student's user report, then you add the base URL to the External URL field, and then in the URL variables section, add 'id' to the first field and select 'id' from under the site heading, and then save changes. The result is a URL that always points to the student's user report.

Example 1: https:// moodlesite.com/report/outline/user.php?id=00000&course=0000 is the path to a user's course outline report.
https:// moodlesite.com/report/outline/user.php is the base URL
?id=00000 is the first added parameter, so type id in the parameter box and in the dropdown select id under user
&course=0000 is the second added parameter, so type course in the parameter box and in the dropdown select id under course

Example 2: https:// moodlesite.com/grade/report/user/index.php?id=00000&userid=0000 is the path to a user's course user report
https:// moodlesite.com/grade/report/user/index.php is the base URL
?id=00000 is the first added parameter, so type id in the parameter box and in the dropdown select id under course
&userid=0000 is the second added parameter, so type userid in the parameter box and in the dropdown select id under user

A further use includes displaying all forums in a site, by using the base URL then adding add 'id' to the first field and selecting 'id' from under the site heading. Another use makes use of mailto:email@address. URL variables could then include the subject parameter followed by the 'Site full name'. E.g. if you wanted to email a teacher who taught multiple courses, if a student clicked the URL then the email would automatically fill the subject field, which would help the teacher to identify which course the student was in.

==Common module settings==
See [[Common module settings]]
==Restrict access/Activity completion==
(These settings are collapsed by default)

These settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.

==Drag and Drop a URL==
Alternatively, if an administrator has enabled the experimental feature drag and drop upload of text/links in ''Settings > Site administration > Development > Experimental > [[Experimental settings]]'', a link can be dragged into a section of the course and given a name, as shown in the images below.

{|
| [[File:dragURL.png|thumb|Adding a URL using drag and drop]]
|}

==URL module capabilities==

* [[Capabilities/mod/url:view|View URL resource]]
* [[Capabilities/mod/url:addinstance|Add a new URL resource]]

==Site administration settings==

The URL module has additional settings which may be changed by an administrator in ''Administration > Site administration > Plugins > Activity modules > URL''.

===Frame height===

Here you can specify the height of the top frame (containing the navigation) if you choose the "in frame" display option. Note:If your theme has a large header then the height should be increased to prevent horizontal and vertical scrollbars.

===Password===

Here you can add a password that will connect your users to a secure site. [http://moodle.org/mod/forum/discuss.php?d=189842#p826416 See this forum post] for more details.

===Include role names in parameters===

===Available display options===

This setting allows you to add different ways the resource may be displayed on the course page. There are a number of defaults but you can add or change them here. Other display options are:
* ''In frame'' - show the Moodle heading and the file description, with the file displayed in a resizeable area below
* ''New window'' - very much like 'in pop-up', but the new window is a full browser window, with menus and address bar, etc.
[[File:Display.gif]]

===Default values for activity settings===

Here you can set the defaults for this resource.

===See also===
Form discussions:
* [https://moodle.org/mod/forum/discuss.php?d=389552#p1570270 URL Resource - adding a URL Variable]

[[de:Link/URL konfigurieren]]
[[fr:Paramètres de l'URL]]
[[es:Configuraciones del recurso URL]]

URL resource settings

2019-08-12T20:15:20Z

Jprovasnik: /* URL variables */

{{URL}}
==Adding a URL resource to your course==

# Turn editing on.
#From the the "Add an activity or resource" link (or, if not present, the "Add a resource" drop down menu),choose URL. All settings may expanded by clicking the "Expand all/Collapse all" link top right.

==General==
*Give your URL a name and type (or copy/paste) the URL into the External URL box. If you need to search for the correct URL, click the Choose a link button. When you find and select your link,it will be automatically pasted into the box.
*Give the URL a description if you wish, and tick the box to display that description on the course page if needed.
[[File:31URL.png|thumb|400px|center|Adding a URL]]

==Appearance==
For '''Display''' you have the following options. If you don't see an option, ask the administrator to enable it in ''Site administration >Plugins <Activity modules >URL.'' You can also have 'in frame' or 'New window' but these must be enabled by the administrator.

* ''Automatic'' - Make the best guess at what should happen (probably what is wanted 99% of the time).
* ''Embed'' - Show the Moodle page with heading, blocks and footer. Show the title/description of the item and display the file directly in the page as well
* ''Open'' - No Moodle heading, blocks, footer or description - just show the file in the web browser (e.g. shows image, PDF, flash animation, taking up the whole browser window)
* ''In pop-up'' - Same as 'Open', but opens a new browser window to show this file (without the Moodle heading, blocks, etc) - this browser window also does not have all the menus in it. If you select this one, then you can specify the pop-up width and height.

==URL variables==

This section allows you to pass internal information as part of the URL.

This is useful if the URL is actually an interactive web page that takes parameters, and you want to pass something like the name of the current user, for example.

Another use is to create stable links that updates in each iteration of the course, for example:

if you want to link to the student's user report, then you add the base URL to the External URL field, and then in the URL variables section, add 'id' to the first field and select 'id' from under the site heading, and then save changes. The result is a URL that always points to the student's user report.

Example 1: https://moodlesite.com/report/outline/user.php?id=00000&course=0000 is the path to a user's course outline report.
https://moodlesite.com/report/outline/user.php is the base URL
?id=00000 is the first added parameter, so type id in the parameter box and in the dropdown select id under user
&course=0000 is the second added parameter, so type course in the parameter box and in the dropdown select id under course

Example 2: https://moodlesite.com/grade/report/user/index.php?id=00000&userid=0000 is the path to a user's course user report
https://moodlesite.com/grade/report/user/index.php is the base URL
?id=00000 is the first added parameter, so type id in the parameter box and in the dropdown select id under course
&userid=0000 is the second added parameter, so type userid in the parameter box and in the dropdown select id under user

A further use includes displaying all forums in a site, by using the base URL then adding add 'id' to the first field and selecting 'id' from under the site heading. Another use makes use of mailto:email@address. URL variables could then include the subject parameter followed by the 'Site full name'. E.g. if you wanted to email a teacher who taught multiple courses, if a student clicked the URL then the email would automatically fill the subject field, which would help the teacher to identify which course the student was in.

==Common module settings==
See [[Common module settings]]
==Restrict access/Activity completion==
(These settings are collapsed by default)

These settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.

==Drag and Drop a URL==
Alternatively, if an administrator has enabled the experimental feature drag and drop upload of text/links in ''Settings > Site administration > Development > Experimental > [[Experimental settings]]'', a link can be dragged into a section of the course and given a name, as shown in the images below.

{|
| [[File:dragURL.png|thumb|Adding a URL using drag and drop]]
|}

==URL module capabilities==

* [[Capabilities/mod/url:view|View URL resource]]
* [[Capabilities/mod/url:addinstance|Add a new URL resource]]

==Site administration settings==

The URL module has additional settings which may be changed by an administrator in ''Administration > Site administration > Plugins > Activity modules > URL''.

===Frame height===

Here you can specify the height of the top frame (containing the navigation) if you choose the "in frame" display option. Note:If your theme has a large header then the height should be increased to prevent horizontal and vertical scrollbars.

===Password===

Here you can add a password that will connect your users to a secure site. [http://moodle.org/mod/forum/discuss.php?d=189842#p826416 See this forum post] for more details.

===Include role names in parameters===

===Available display options===

This setting allows you to add different ways the resource may be displayed on the course page. There are a number of defaults but you can add or change them here. Other display options are:
* ''In frame'' - show the Moodle heading and the file description, with the file displayed in a resizeable area below
* ''New window'' - very much like 'in pop-up', but the new window is a full browser window, with menus and address bar, etc.
[[File:Display.gif]]

===Default values for activity settings===

Here you can set the defaults for this resource.

===See also===
Form discussions:
* [https://moodle.org/mod/forum/discuss.php?d=389552#p1570270 URL Resource - adding a URL Variable]

[[de:Link/URL konfigurieren]]
[[fr:Paramètres de l'URL]]
[[es:Configuraciones del recurso URL]]

URL resource settings

2019-08-12T20:03:23Z

Jprovasnik: /* See also */

{{URL}}
==Adding a URL resource to your course==

# Turn editing on.
#From the the "Add an activity or resource" link (or, if not present, the "Add a resource" drop down menu),choose URL. All settings may expanded by clicking the "Expand all/Collapse all" link top right.

==General==
*Give your URL a name and type (or copy/paste) the URL into the External URL box. If you need to search for the correct URL, click the Choose a link button. When you find and select your link,it will be automatically pasted into the box.
*Give the URL a description if you wish, and tick the box to display that description on the course page if needed.
[[File:31URL.png|thumb|400px|center|Adding a URL]]

==Appearance==
For '''Display''' you have the following options. If you don't see an option, ask the administrator to enable it in ''Site administration >Plugins <Activity modules >URL.'' You can also have 'in frame' or 'New window' but these must be enabled by the administrator.

* ''Automatic'' - Make the best guess at what should happen (probably what is wanted 99% of the time).
* ''Embed'' - Show the Moodle page with heading, blocks and footer. Show the title/description of the item and display the file directly in the page as well
* ''Open'' - No Moodle heading, blocks, footer or description - just show the file in the web browser (e.g. shows image, PDF, flash animation, taking up the whole browser window)
* ''In pop-up'' - Same as 'Open', but opens a new browser window to show this file (without the Moodle heading, blocks, etc) - this browser window also does not have all the menus in it. If you select this one, then you can specify the pop-up width and height.

==URL variables==

This section allows you to pass internal information as part of the URL.

This is useful if the URL is actually an interactive web page that takes parameters, and you want to pass something like the name of the current user, for example.

Another use is to create stable links that updates in each iteration of the course, for example:

if you want to link to the student's user report, then you add the base URL to the External URL field, and then in the URL variables section, add 'id' to the first field and select 'id' from under the site heading, and then save changes. The result is a URL that always points to the student's user report.

A further use includes displaying all forums in a site, by using the base URL then adding add 'id' to the first field and selecting 'id' from under the site heading. Another use makes use of mailto:email@address. URL variables could then include the subject parameter followed by the 'Site full name'. E.g. if you wanted to email a teacher who taught multiple courses, if a student clicked the URL then the email would automatically fill the subject field, which would help the teacher to identify which course the student was in.

==Common module settings==
See [[Common module settings]]
==Restrict access/Activity completion==
(These settings are collapsed by default)

These settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.

==Drag and Drop a URL==
Alternatively, if an administrator has enabled the experimental feature drag and drop upload of text/links in ''Settings > Site administration > Development > Experimental > [[Experimental settings]]'', a link can be dragged into a section of the course and given a name, as shown in the images below.

{|
| [[File:dragURL.png|thumb|Adding a URL using drag and drop]]
|}

==URL module capabilities==

* [[Capabilities/mod/url:view|View URL resource]]
* [[Capabilities/mod/url:addinstance|Add a new URL resource]]

==Site administration settings==

The URL module has additional settings which may be changed by an administrator in ''Administration > Site administration > Plugins > Activity modules > URL''.

===Frame height===

Here you can specify the height of the top frame (containing the navigation) if you choose the "in frame" display option. Note:If your theme has a large header then the height should be increased to prevent horizontal and vertical scrollbars.

===Password===

Here you can add a password that will connect your users to a secure site. [http://moodle.org/mod/forum/discuss.php?d=189842#p826416 See this forum post] for more details.

===Include role names in parameters===

===Available display options===

This setting allows you to add different ways the resource may be displayed on the course page. There are a number of defaults but you can add or change them here. Other display options are:
* ''In frame'' - show the Moodle heading and the file description, with the file displayed in a resizeable area below
* ''New window'' - very much like 'in pop-up', but the new window is a full browser window, with menus and address bar, etc.
[[File:Display.gif]]

===Default values for activity settings===

Here you can set the defaults for this resource.

===See also===
Form discussions:
* [https://moodle.org/mod/forum/discuss.php?d=389552#p1570270 URL Resource - adding a URL Variable]

[[de:Link/URL konfigurieren]]
[[fr:Paramètres de l'URL]]
[[es:Configuraciones del recurso URL]]

URL resource settings

2019-08-12T20:03:06Z

Jprovasnik:

{{URL}}
==Adding a URL resource to your course==

# Turn editing on.
#From the the "Add an activity or resource" link (or, if not present, the "Add a resource" drop down menu),choose URL. All settings may expanded by clicking the "Expand all/Collapse all" link top right.

==General==
*Give your URL a name and type (or copy/paste) the URL into the External URL box. If you need to search for the correct URL, click the Choose a link button. When you find and select your link,it will be automatically pasted into the box.
*Give the URL a description if you wish, and tick the box to display that description on the course page if needed.
[[File:31URL.png|thumb|400px|center|Adding a URL]]

==Appearance==
For '''Display''' you have the following options. If you don't see an option, ask the administrator to enable it in ''Site administration >Plugins <Activity modules >URL.'' You can also have 'in frame' or 'New window' but these must be enabled by the administrator.

* ''Automatic'' - Make the best guess at what should happen (probably what is wanted 99% of the time).
* ''Embed'' - Show the Moodle page with heading, blocks and footer. Show the title/description of the item and display the file directly in the page as well
* ''Open'' - No Moodle heading, blocks, footer or description - just show the file in the web browser (e.g. shows image, PDF, flash animation, taking up the whole browser window)
* ''In pop-up'' - Same as 'Open', but opens a new browser window to show this file (without the Moodle heading, blocks, etc) - this browser window also does not have all the menus in it. If you select this one, then you can specify the pop-up width and height.

==URL variables==

This section allows you to pass internal information as part of the URL.

This is useful if the URL is actually an interactive web page that takes parameters, and you want to pass something like the name of the current user, for example.

Another use is to create stable links that updates in each iteration of the course, for example:

if you want to link to the student's user report, then you add the base URL to the External URL field, and then in the URL variables section, add 'id' to the first field and select 'id' from under the site heading, and then save changes. The result is a URL that always points to the student's user report.

A further use includes displaying all forums in a site, by using the base URL then adding add 'id' to the first field and selecting 'id' from under the site heading. Another use makes use of mailto:email@address. URL variables could then include the subject parameter followed by the 'Site full name'. E.g. if you wanted to email a teacher who taught multiple courses, if a student clicked the URL then the email would automatically fill the subject field, which would help the teacher to identify which course the student was in.

==Common module settings==
See [[Common module settings]]
==Restrict access/Activity completion==
(These settings are collapsed by default)

These settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.

==Drag and Drop a URL==
Alternatively, if an administrator has enabled the experimental feature drag and drop upload of text/links in ''Settings > Site administration > Development > Experimental > [[Experimental settings]]'', a link can be dragged into a section of the course and given a name, as shown in the images below.

{|
| [[File:dragURL.png|thumb|Adding a URL using drag and drop]]
|}

==URL module capabilities==

* [[Capabilities/mod/url:view|View URL resource]]
* [[Capabilities/mod/url:addinstance|Add a new URL resource]]

==Site administration settings==

The URL module has additional settings which may be changed by an administrator in ''Administration > Site administration > Plugins > Activity modules > URL''.

===Frame height===

Here you can specify the height of the top frame (containing the navigation) if you choose the "in frame" display option. Note:If your theme has a large header then the height should be increased to prevent horizontal and vertical scrollbars.

===Password===

Here you can add a password that will connect your users to a secure site. [http://moodle.org/mod/forum/discuss.php?d=189842#p826416 See this forum post] for more details.

===Include role names in parameters===

===Available display options===

This setting allows you to add different ways the resource may be displayed on the course page. There are a number of defaults but you can add or change them here. Other display options are:
* ''In frame'' - show the Moodle heading and the file description, with the file displayed in a resizeable area below
* ''New window'' - very much like 'in pop-up', but the new window is a full browser window, with menus and address bar, etc.
[[File:Display.gif]]

===Default values for activity settings===

Here you can set the defaults for this resource.

===See also===
Form discussions:
* [https://moodle.org/mod/forum/discuss.php?d=389552#p1570270 URL Resource - adding a URL Variable]
* [https://moodle.org/mod/forum/discuss.php?d=245696 Labels] for inserting links into

[[de:Link/URL konfigurieren]]
[[fr:Paramètres de l'URL]]
[[es:Configuraciones del recurso URL]]

Reset course

2019-05-11T21:38:57Z

Jprovasnik: /* Gradebook Reset Options */

{{Reusing activities}}
== Overview ==

This allows you to empty a course of user data, while retaining the activities and other settings. Please be warned when choosing items you will delete your chosen user data from this course forever!

You can select which user data to remove at a granular level under the categories of General, Roles, Gradebook, Groups and Activity data.

Note: Only users with the [[Capabilities/moodle/course:reset|reset course capability]] (by default managers and teachers) can reset a course.

== How to Reset - step by step ==

# Log in and go to the course area you want to reset
# Resetting a given activity is irreversible, so ensure that you have taken a Backup of your area including the user data - this is a snapshot and can be reinstated if necessary
# In your area's Administration block, click on Reset
# Click any Show Advanced button to show all options for that category
# Make your selections based on the options (see below for more on these)
# Click the Reset button
# Return to your area and check that things are as you want them.

== General Reset Options ==
(Before you reset)
You will need to make sure that you back up the information that you have within your course before you reset. When you back up the course make sure that you back it up with the user information. That way you will have a back up data on the ones that have taken your course before you reset it for another group or department.

===Course start date===

You can set a new Course Start Date for the freshly reset course, delete all Calendar events, comments, course AND activity completion data and user notes attached to the course. Note that course logs are not deleted (See MDL-43274)

''NOTE: If you set a new course start date, then all course dates will be shifted by the same amount.
''

== Role Reset Options ==

These Role Reset options allow you to unenrol all users with a particular role within a course (e.g students) as well as remove all role overrides and role assignment specific to the course. This does not affect user role assignments outside the context of the course.

== Gradebook Reset Options ==

The Gradebook reset options allow you to delete all gradebook items and categories and/or delete all recorded grades within the course.
There are two options for gradebook reset:

'''Delete all grades''' - Removes all manually added grade items within the course together with grades and data on overridden, excluded, hidden and locked grades. ''Please note: activity grade items are not removed in this option.''

'''Delete all items and categories''' - Remove all categories and related manually added grade items together with grades and data on overridden, excluded, hidden and locked grades. ''Please note: activity grade items are not removed in this option; activity Maximum Grade values are not removed in this option; however, activity Grade to Pass values are reset to 0.''

Note that these grades are still recorded against a user's account.

== Group Reset Options ==

The Group reset options provides you with the ability to delete all groups created in the course and/or remove all users from any groups within the course.

You can also delete all groupings created in the course and/or remove all users from any groupings within the course.

== Activity Reset Options ==

Depending on the activities used within a course, you will be provided with the option to remove the user data associated with these learning objects. This includes responses to Choices, Quiz attempts, Feedback Responses, Forum posts (from selected Forum types), Glossary entries etc.

For [[Quiz]] you can:
:remove all attempts
:remove user overrides and group overrides

For [[Workshop]] you can:
:delete all submissions
:delete all assessments
:switch to the setup phase

For [[Wiki]] you can:
:delete pages
:remove tags and comments

You can also specify a new course start date.

[[es:Reiniciar curso]]
[[fr:Réinitialisation]]
[[ja:コースのリセット]]

Reengagement activity

2018-03-13T01:37:46Z

Jprovasnik: /* Email place holders */

{{Infobox plugin
|type = Activity module
|entry = https://moodle.org/plugins/mod_reengagement
|tracker = https://github.com/catalyst/moodle-mod_reengagement/issues
|maintainer = [https://www.catalyst.net.nz Catalyst IT]
|float = right
}}

==About the Reengagement activity==
The Reengagement activity is developed by the Moodle Partner Catalyst IT and provides a way for you to remind students to return to the course and complete activities. You can also use this plugin to selectively release timed content in a course.

==Adding a Reengagement activity==
A Reengagement activity can be added to a course in the same way as any other activity:

# Turn editing on
# Click 'Add an activity or resource'
# Select Re-engagement

===Set Reengagement details===
====Access Restrictions====
The Email delay can be based on the user enrolment date or a previous activity completion. If you want to use the enrolment date then don't set up any access restrictions on this Re-engagement; each user's timer will start after they enrol in the course. If you want the delay to be based on a previous activity completion you should set that activity as an access restriction to this Reengagment activity; each user's timer will start after they complete the dependencies.

==== Email User setting ====
Set "Email User" to "After Delay" and set the "Email delay" period. The e-mail delay is the when the e-mail reminder will be sent based on the previous event (enrolment or activity completion)

==== Target Activity ====
Set "Target Activity" - this is the activity that you want to remind the user they must complete - if this activity is flagged as complete within the course then no e-mail reminder will be sent.

===Timed release===
If you want to release a quiz within your course to individual users after a set period (eg 1 week after assignment completion) you use the "Activity completion" settings within the course.
# set the Reengagement duration to the time period you want eg 1 week
# set access restrictions to the reengagement to allow access after assignment is complete (or no access restrictions means start timer after enrolment)
# set access restrictions to the quiz so that it is available only after the re-engagement is complete.

===Email place holders===
When configuring the e-mails sent from the plugin there are limited place holders you can use. If need to use them properly wrap them with "percentage" (%) symbols. Available substitutions are given below

* %courseshortname%
* %coursefullname%
* %courseid%
* %userfirstname%
* %userlastname%
* %userid%
* %usercity%
* %userinstitution%
* %userdepartment%

Permissions
"receive notification" was removed from the codebase in github (3/2018)
"Start Reengagement" is given to students and controls which users in the course will be listed in the re engagement activity.

Discussion: https://moodle.org/mod/forum/discuss.php?d=337782