Talk:Teacher role

For a forum discussion of what led me to rewrite this page, see the forum message thread here: How to assign a teacher to a course --Stephen Winters (talk) 19:47, 15 April 2014 (WST)

Documentation discussion

Hi again Stephen and thanks for this. I thought I would add a few tweaks here below (ignore my English and your US spelling - both or either are fine!) and ask you what you thought before anything gets copied over to the main page. I have tried to keep the extra information you added while making some parts briefer with links to other pages where the information is already present. The main thing is to make it clearer for new Moodlers, as you rightly pointed out.--Mary Cooch (talk) 02:21, 19 April 2014 (WST)

Teacher role

Teachers can do almost anything within a course, including adding or changing the activities and grading students. By default, teachers can also assign a Non-editing teacher role and a Student role to other users. (To allow teachers to enrol other teachers, see Assign roles

By default users are not assigned the role of Teacher throughout the site, but are only assigned (enrolled) as a teacher to a single class at a time. The same applies to students. Teachers can only teach in the courses they have been enrolled in. (If you really need your teacher to access all courses, see #13 of Roles FAQ

Enrolling a user as a teacher in a course

1. As a manager or administrator, go to Administration > Course administration > Users > Enrolled users
2. Click the 'Enrol users' button at the top right or bottom left of the page
3. From the 'Assign roles' dropdown choose the teacher role
4. Select enrolment options as appropriate
5. Browse or search for the user
6. Click the Enrol button opposite the user. The user will indent in the list and the enrol button will disappear, indicating that the user is enrolled.
7. When you have finished, click the 'Finish enrolling users' button (or simply close the enrol users box)

The user will then appear in the list of enrolled users and will no longer be available in the search list.

For more information on manually enrolling teachers, see Manual enrolment

Changing Teacher Permissions

Note: if you need to modify the Teacher role significantly, it is advisable to create a new role rather than editing the default teacher role. See Creating custom roles

If you really need to change the default Teacher role, go to Administration>Site administration>Users>Permissions>Define roles. In the right pane you will see Manage Roles with a list of user roles. To the right of the teacher description, click on the edit icon.

From the Editing role 'Teacher' page you can change what a teacher can or cannot do by checking or unchecking the Allow check-boxes under Capability/Permission. Be careful what you allow a teacher to do here. Consider the security vulnerabilities of giving a teacher an inappropriate permission. Only give the teacher permissions that are necessary or appropriate. To the right of many of the Allow check boxes are colored triangles the notify you of possible security warnings for each choice. Use those warnings to help you decide which permissions you will or won't give to your teachers.

Enrolling teachers category or site-wide

Under some conditions (such as for homeschool parents) you may want to assign a user the role of teacher within a category or for your whole site, instead of manually enrolling them into every course. Only modify the default Teacher role if you are certain you need to. It is preferable to create a new role and assign it to the category or site context. To understand the idea of roles in category and sites contexts, see Assign roles and to assign a teacher to a category, see Category enrolments.

Comments on Mary's revision

Mary, you were kind enough to leave my writing in tact as we discussed it. Consequently, I don't want to mess up your revisions, so I've copied your revised text below here so that I can comment on it while leaving your version in tact. Since we don't seem to be using bold in the document, I'll put my comments and suggested revisions in bold text, so they are both easier to see.--Stephen Winters (talk) 11:09, 19 April 2014 (WST)

Teacher role

Teachers can do almost anything within a course, including adding or changing the activities and grading students. By default, teachers can also assign a Non-editing teacher role and a Student role to other users. (To allow teachers to enrol other teachers, see Assign roles

My only question here is whether or not teachers can edit the roles (change what they can do) or not.) If so, perhaps mention that, if not, fine. Otherwise this section is fine.

By default users are not assigned the role of Teacher throughout the site, but are only assigned (enrolled) as a teacher to a single class at a time. The same applies to students. Teachers can only teach in the courses in which they have been enrolled. (If you really need your teacher to access all courses, see #13 of Roles FAQ This section OK. S.W.

Enrolling a user as a teacher in a course

Mary, thank you for putting this section in number points. I should have done that. S.W.

1. As a manager or administrator, while in the chosen course, go to Administration > Course administration > Users > Enrolled users
2. Click the 'Enrol users' button at the top right or bottom left of the page
3. From the 'Assign roles' dropdown choose the teacher role
4. Select enrolment options as appropriate
5. Browse or search for the user
6. Click the Enrol button opposite the user. The user will indent in the list and the enrol button will disappear, indicating that the user is enrolled.
7. When you have finished, click the 'Finish enrolling users' button (or simply close the enrol users box)

The user will then appear in the list of enrolled users and will no longer be available in the search list.

For more information on manually enrolling teachers, see Manual enrolment

This Section OK. S.W.

Changing Teacher Permissions

Note: if you need to modify the Teacher role significantly, it is advisable to create a new role rather than editing the default teacher role. See Creating custom roles Mary, I like the way you added this sentence, good idea. S.W.

If you really need to change the default Teacher role, go to Administration>Site administration>Users>Permissions>Define roles. In the right pane you will see Manage Roles with a list of user roles. To the right of the teacher description, click on the edit icon.

From the Editing role 'Teacher' page you can change what a teacher can or cannot do by checking or unchecking the Allow check-boxes under Capability/Permission. Be careful what you allow a teacher to do here. Consider the security vulnerabilities of giving a teacher an inappropriate permission. Only give the teacher permissions that are necessary or appropriate. To the right of many of the Allow check boxes are colored triangles the notify you of possible security warnings for each choice. Use those warnings to help you decide which permissions you will or won't give to your teachers. This above section OK. and Down to here, everything, as noted looks good. S.W.

Enrolling teachers category or site-wide

Under some conditions (such as for homeschool parents) you may want to assign a user the role of teacher within a category or for your whole site, instead of manually enrolling them into every course. Only modify the default Teacher role if you are certain you need to. It is preferable to create a new role and assign it to the category or site context. To understand the idea of roles in category and sites contexts, see Assign roles and to assign a teacher to a category, see Category enrolments.

Mary, to me, this last section is missing some necessary parts. And I'm not comfortable with just cutting out the whole rest of it from here down. I understand the concept of keeping the documentation for each specific function on it's own page, and linking to it. It makes it a lot easier to keep each section updated because it's not duplicated at various sections in other parts of the docs. I understand all of that. But here is another viewpoint. Make it easy for the reader. When a reader, such as myself, has to flip here and there, back and forth, trying to trace out and understand what I'm supposed to do to make something work, it gets very confusing, at least for me.

When I compare what I wrote about assigning "Role Archetype" in this section, it seems to me a lot easier for the reader to understand what the different choices are and what to do. (Of course it could be written better I'm sure).

Now, where's the balance? How to make it easy for the reader and easy to maintain? Anyway, that's my two cents worth.

Anyway, I'm not in the mindset to think any more about this right now, so will sign off.

Best Wishes, Stephen