MoodleDocs - Contribucions de l'usuari [ca]

Gradebook course settings

2009-09-06T19:44:48Z

Mixik: link to CS translation added

{{Grades}}Course settings determine how the gradebook appears for all participants in the course.

To change the course settings:

#Choose "Course settings" from the gradebook dropdown menu.
#Change the settings as required.
#Click the "Save changes" button.

Note: Individual teachers may override the aggregation position setting for their own grader report view via their [[Grade preferences|"My report preferences"]] tab.

===Show rank===

The show rank setting determines whether the position of a grade item in relation to the rest of the class is shown.

===Show percentage===

The show percentage setting (in Moodle 1.9.3 onwards) determines whether the percentage value of each grade item is shown.

==Default course settings==
[[Image:Gradebook course settings.png|thumb|left|Gradebook course settings]]
The default course settings are set by an administrator in the following locations:
* Grade display type and overall decimal points - ''Administration > Grades > [[Grade item settings]]''
* Default aggregation position - ''Administration > Grades > [[General grade settings|General settings]]''
* Overview report setting - ''Administration > Grades > [[Gradebook report settings|Report settings]] > Overview report''
* User report settings - ''Administration > Grades > [[Gradebook report settings|Report settings]] > User report''

[[Category:Course]]

[[ca:grade/edit/settings/index]]
[[cs:Nastavení hodnocení v kurzu]]

User report

2009-09-06T13:06:01Z

Mixik: link to CS translation added

{{Grades}}The user report shows the currently logged in user's grades in the current course. It includes:

#A breakdown of the grades for each assessment (grade item) in the course.
#The optional teacher-given feedback for each grade.
#The overall grade for the course (called course total). This total is the same as that shown on the [[Overview report|overview report]].

The user report may also include:

#The position of each grade item in relation to the rest of the class (rank).
#A percentage value relative to the minimum-maximum grade for each assessment.

[[Image:User report.png|thumb|left|User report in Moodle 1.9.5]]
Teachers can choose whether to show or hide rank and percentages (in Moodle 1.9.3 onwards) in the [[Gradebook course settings]].

Teachers and administrators may use the "Select all or one user" dropdown menu at the top right of the page to view individual user reports. When all users are selected, the report can be printed, and only one student should appear on each page (browser-dependent behaviour).

In Moodle 1.9.5 onwards, category nesting is shown with contrasting colours, which makes it a lot clearer, especially when lots of categories are in use. A range column has also been added.

==See also==

*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]

[[ca:grade/report/user/index]]
[[cs:Známky uživatele]]
[[fr:Rapport de l'utilisateur]]

Overview report

2009-09-06T10:18:52Z

Mixik: link to CS translation added

{{Grades}}The overview report lists all the courses a student is enrolled in together with the total grade for each course.

Students can access their overview report from within any course by following the grades link in the course administration block, then selecting "Overview report" from the "Choose an action" dropdown menu at the top left of the page.

The overview report is not relevant for teachers or non-editing teachers. For new Moodle 1.9.5 installs the [[Capabilities/gradereport/overview:view|view overview report]] capability is not set for the default teacher and non-editing teacher roles. For administrators upgrading to Moodle 1.9.5, [[Simplifying the gradebook by changing permissions]] provides details of how to make this change for teachers and non-editing teachers.

[[ca:grade/report/overview/index]]
[[cs:Výsledné známky ze všech kurzů]]
[[eu:Txosten_orokorra]]
[[fr:Rapport d'ensemble]]

Import course data

2008-11-06T13:30:55Z

Mixik: links to Czech version added

{{Course admin}}Course data may be imported from any other course for which the teacher has editing rights.
However, using the Import Course Data feature, will not import user data, such as forum posts and discussions; it will only import the structure of such activities.

# Select the Import option from the [[Course administration block]].
# Next, select the course you wish to import from and click the ''Use this course'' button.
# You will be presented with a check box list from which you can select the type of activities or resources you wish to import.
# Finally, click ''Continue'' when done to import that data.

NB: Selecting forums, for example, will import all forums from that course in Moodle 1.6. Since Moodle 1.7, you can import individual items within a module type.

Groups can also be imported as a batch from a file.

Backups, especially since 1.6, offer other creative ways to bring in course material from other courses. See [[Course_backup]] or the backup link on the index.

[[Image:Import.jpg]]

[[Category:Teacher]]

[[cs:Importovat data]]
[[fr:Importation]]

Metacourse

2008-10-16T13:19:57Z

Mixik: link to Czech version added

A '''meta course''' is just like any other course except that it automatically enrolls participants from other "child" courses. Meta courses inherit their enrollments, (and other role assignments(*), from these other course(s) instead of having students added manually. This feature can populate many meta courses from one course with normal enrollments or one meta course from many courses with normal enrollments.

For example (Scenario 2, below), a normal course can be used as the central enrolment point for a programme of study composed of several meta courses. Each time a student enrols in (or unenrols from) this course, they are automatically enrolled/unenrolled from any meta course(s) associated with it, which would contain the programme's teaching activities.

Please note that meta course enrolments do not preserve groups and enrolment does not happen immediately, but occurs next time the [[Cron|cronjob]] runs.

(*)Note: By default all role assignments from child courses are synchronised to meta courses. However, the "Roles that are not synchronised to metacourses" setting in ''Administration > Users > Permissions > [[User policies]]'' enables administrators to exclude particular roles.

==Creating a metacourse==

To create a meta course, set "Is this a meta course?" to yes in the [[Course settings|course settings]]. After saving the course settings, you will see a list of child courses to choose from. The students from any that you choose will be added to the meta course automatically.

In Moodle 1.5 and 1.6, if a meta course is chosen, the [[Students|students]] page changes from listing/searching for students to listing/searching for courses. In Moodle 1.7 onwards, "Child courses" appears in the teacher's administration block.

Note: It is not possible to add individual students to a meta course, as meta course enrolment is controlled by child course enrolment only.

==Meta course examples==
Meta courses may be used in a variety of ways:

===Scenario 1===
* X is a meta course with Course 1 through 4 as normal courses with standard student enrollments. Students enrolling on these courses are automatically enrolled onto Meta course X.

[[Image:Metacourses1_en.jpg|Standard Meta course usage|center]]

For example, a math teacher or department has 2 algebra and 2 geometry courses. The teacher or department wants course for each of these subjects. But they also want a generic space where they can post things for all of the students in all of their courses, perhaps including compulsory work for all students. By making algebra 1 & 2 and geometry 1 & 2 as each as part of a Math meta course, they achieve this goal.

===Scenario 2===
* Meta courses 1-4 are linked to Y which is a normal course. Students enrolling on Course Y are automatically enrolled on Meta courses 1-4. This would be used, for example, when all five courses are intended to have exactly the same students.

[[Image:Metacourses2_en.jpg|Upsidedown Meta course Usage|center]]

In both diagrams you can see students being enrolled normally into standard courses and then the entire student list of a course being added to the Meta course.

===Scenario 3===
* One or more meta courses are used as a library of resources and activities. For example, the English department has collected material useful in writing papers. Teachers can direct or embed a link to a specific reference about citations, or how to select a topic for a paper or suggested reading compiled by students.

===Scenario 4===
* The meta course feature can also be used "in reverse." Say you have a Diploma program that involves courses D1, D2, D3, and D4. In this case, you would create a "Diploma" course as a normal course (non-meta course). You would then designate programs D1 through D4 as meta courses (plus completing the student enrollment task under Course Administration). When a student enrolls in "Diploma", he or she will be automatically enrolled in courses D1 through D4.

==Re-linking a Metacourse==
When restoring a metacourse with the option "deleting the course first", you will notice that the enrollments that were used by the course previously are now gone. In order to re-link the child course, navigate to the new course and select the link "Child Courses" from the "Administration" block on the main course page and re-link the course to its parent.

==See also==
*[[Related courses block]] - contributed code that shows meta or child course relationships

Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=48901 Metacourses?]
*[http://moodle.org/mod/forum/discuss.php?d=54389 Metacourses and Roles in 1.7]
*[http://moodle.org/mod/forum/discuss.php?d=39438 Best reference for describing a metacourse]
*[http://moodle.org/mod/forum/discuss.php?d=89741 Assign student in course]

[[Category:Teacher]]
[[Category:Enrolment]]

[[cs:Metakurzy]]
[[de:Metakurse]]
[[es:Metacourses]]
[[fr:Méta-cours]]
[[ja:メタコース]]
[[ru:Метакурсы]]

Quiz settings

2008-09-29T21:36:25Z

Mixik: link to Czech version added

{{Quizzes}}

Creating a new quiz is a two-step process. In the first step you [[Teacher_documentation#Activity_modules|create]] the quiz activity and set its options which specify the rules for interacting with the quiz. In a second step you will then [[mod/quiz/edit|edit the quiz]] to add questions to it. This page describes the options you can set for the quiz activity, the page [[mod/quiz/edit|Editing a quiz]] describes how to set up the questions for the quiz.

'''Quiz options'''
There is a large number of options and your administrator should already have chosen the default values for most of them so that you will not have to modify them for the type of quiz that you use most often. The administrator may also have classified some of the settings as 'advanced' which means that they will be hidden from the set-up screen by default. This can help to keep the screen simpler. You can turn on the display of these advanced options by clicking on the '''Show advanced settings''' button. They will then remain visible until you click on '''Hide advanced settings'''.

==General section==
;Name
This is the standard name field that every activity has. The name will be used for the link text on the course page and also on the [[mod/quiz/index|quiz index screen]].

;Introduction
:Write an introduction for the quiz. Be sure to include any special instructions for taking the quiz like the number of attempts allowed or scoring rules. This introduction will be shown to the student already on the [[mod/quiz/view|quiz introduction screen]] that they reach after clicking on the quiz name on the course page. So they can see this description before they click on the "Attempt quiz" link and thus before the quiz timer is started (if used).

==Timing section==
;Open the quiz
:You can specify times when the quiz is accessible for people to make attempts. Before the opening time the quiz will be unavailable to students. They will be able to view the quiz introduction but will not be able to view the questions.

;Close the quiz
:After the closing time, the students will not be able to start new attempts. Answers that the student submits after the quiz closing date will be saved but they will not be marked.

: Even after the quiz has closed students will still be able to see the quiz description and review their attempts. What exactly they will see depends on the settings you choose under [[Adding/updating_a_quiz#Students_may_review_section|Students may review]].

;Time limit
:By default, quizzes do not have a time limit, which allows students as much time as they need to complete the quiz. If you do specify a time limit, several things are done to try and ensure that quizzes are completed within that time:

# Javascript support in the browser becomes mandatory - this allows the timer to work correctly.
# A floating timer window is shown with a countdown
# When the timer has run out, the quiz is submitted automatically with whatever answers have been filled in so far
# If a student manages to cheat and spends more than 60 seconds over the allotted time then the quiz is automatically graded zero

Note: Particular students may be given unlimited time to attempt a quiz which has a time limit set by allowing the capability [[Capabilities/mod/quiz:ignoretimelimits|mod/quiz:ignoretimelimits]].

==Display section==
;Questions per page
:For longer quizzes it makes sense to stretch the quiz over several pages by limiting the number of questions per page. When adding questions to the quiz, page breaks will automatically be inserted according to the setting you choose here. However, you will also be able to move page breaks around by hand later on the editing page.
:'''Note that changing this setting has no effect on questions you have already added to the quiz'''. The setting will only apply to questions you add subsequently. To change the page breaks in an existing quiz, you need to go to the quiz editing screen, tick the 'Show page breaks' checkbox, then use the repaginate control.

;Shuffle questions
:If you enable this option, then the order of questions in the quiz will be randomly shuffled each time a student starts a new attempt at the quiz. This is '''not''' related to the use of [[Editing_a_quiz#Adding_random_questions|Random Questions]], this is only about the displayed order of questions. The intention is to make it a little harder for students to copy from each other.

;Shuffle answers
:If you enable this option, then the order of answers within each question will be randomly shuffled each time a student attempts this quiz. Of course, this only applies to questions that have multiple answers displayed, such as Multiple Choice or Matching Questions. The intention is simply to make it a little harder for students to copy from each other. This option is '''not''' related to the use of [[Editing_a_quiz#Adding_random_questions|Random Questions]].

:'''Note:''' Any matching and multiple choice questions in your quiz also have their own 'shuffle' setting. The options for these questions will shuffle '''only''' if the shuffle options for the quiz ''and'' the question are both turned on.

==Attempts section==
;Attempts allowed
:Students may be allowed to have multiple attempts at a quiz. This can help make the process of taking the quiz more of an educational activity rather than simply an assessment. If the quiz is randomized then the student will get a new version for each attempt. This is useful for practice purposes.

;Each attempt builds on the last
:If multiple attempts are allowed and this setting is set to Yes, then each new attempt contains the results of the previous attempt. This allows the student on the new attempt to concentrate on just those questions that were answered incorrectly on the previous attempt. If this option is chosen then each attempt by a particular student uses the same questions in the same order, independent of randomization settings. To show a fresh quiz on every attempt, select No for this setting.

;Adaptive mode

:Adaptive questions allow students to have multiple attempts at the question before moving on to the next question. The adaptive question can adapt itself to the student's answer, for example by giving some hints before asking the student to try again. These kinds of questions are new to Moodle and will be described more on the page [[Adaptive questions]].

:If you choose Yes for this option then the student will be allowed multiple responses to a question even within the same attempt at the quiz. So for example if the student's response is marked as incorrect the student will be allowed to try again immediately. However, depending on the '''Apply penalties''' setting, a penalty will usually be subtracted from the student's score for each wrong response.

:In adaptive mode an additional Submit button is shown for each question. If the student presses this button then the response to that particular question is submitted to be scored and the mark achieved is displayed to the student. If the question is an adaptive question then it is displayed in its new state that takes the student's answer into account and will in many cases ask the student for another input. In the simplest adaptive questions this new state may differ only in the feedback text and will prompt the student to try again; in a more sophisticated adaptive question also the question text and even the interaction elements can change.

==Grades section==
;Grading method
:When multiple attempts are allowed, there are different ways you can use the grades to calculate the student's final grade for the quiz.
* Highest grade - the final grade is the highest (best) grade in any attempt
* Average grade - the final grade is the average (simple mean) grade of all attempts
* First grade - the final grade is the grade earned on the first attempt (other attempts are ignored)
* Last grade - the final grade is the grade earned on the most recent attempt only

;Apply penalties
:If a quiz is run in adaptive mode then a student is allowed to try again after a wrong response. In this case you may want to impose a penalty for each wrong response to be subtracted from the final mark for the question. The amount of penalty is chosen individually for each question when setting up or editing the question.

:This setting has no effect unless the quiz is run in adaptive mode.

;Decimal points
:This option determines how many digits will be shown after the decimal point when the grade is displayed. A setting of 0 for example means that the grades are displayed as integers. This setting is only used for the display of grades, not for the display or marking of answers.

==Students may review section==
:This section controls what information students will be shown when they review their past attempts at this quiz at various stages. In Moodle 1.8, there is a matrix of 5 review choices for each of 3 time of review conditions.

:Students may review (see) their own '''Responses''', the '''Scores''' for their responses, the '''Feedback''' from the teacher (if any) or the correct '''Answers''' or a '''General feedback'''. For each of these items you can choose whether the student should be able to see them immediately after the attempt, later but while the quiz is still open or after the quiz is closed.
:*'''Immediately after the attempt''' means within 2 minutes of the student clicking "submit all and finish".
:*'''Later, while the quiz is still open''' means after 2 minutes, but before the close date (if the quiz does not have a close date, this phase never ends).
:*'''After the quiz is closed''' means what it says (you never get here for quizzes without a close date).

:Currently, the "Answers" shown to students work differently depending on the question type in a particular quiz. If the question type used is 'matching' then students get to see which of their responses are in fact correct answers. If the question type used is 'short answer' then students see their responses plus all correct answers to all questions.

==Security section==
;Show quiz in a "secure" window
:The "secure" window tries to provide a little more security for quizzes (making copying and cheating more difficult) by restricting some of the things that students can do with their browsers.

:What happens is that:

# Javascript is made a requirement.
# The quiz appears in a new fullscreen window.
# Some mouse actions on the text are prevented.
# Some keyboard commands are prevented.

:NOTE: This security is NOT watertight. Do NOT rely on these protections as your sole strategy. It is impossible to implement complete protection of quizzes in a web environment so please do not rely on this option if you are really worried about students cheating. Other strategies you can try are to create really large databases of questions from which you randomly choose questions, or even better, rethink your overall assessment to put more value on constructive forms of activity such as forum discussions, glossary building, wiki writing, workshops, assignments etc.

;Require password

:This field is optional.

:If you specify a password in here then participants must enter the same password before they are allowed to make an attempt on the quiz. This is useful to give only a selected group of students access to the quiz.

;Require network address
:This field is optional.

:You can restrict access for a quiz to particular subnets on the LAN or Internet by specifying a comma-separated list of partial or full IP address numbers. This is especially useful for a proctored (invigilated) quiz, where you want to be sure that only people in a certain room are able to access the quiz. For example: 192.168. , 231.54.211.0/20, 231.3.56.211

:There are three types of numbers you can use (you can not use text based domain names like example.com):

# Full IP addresses, such as 192.168.10.1 which will match a single computer (or proxy).
# Partial addresses, such as 192.168 which will match anything starting with those numbers.
# CIDR notation, such as 231.54.211.0/20 which allows you to specify more detailed subnets.

:Spaces are ignored.

==Common Module settings==
;Group mode
:Here you can choose whether the quiz should be organized by group. This only has an effect on the review screens of the teachers where it determines which groups of students they see.

;Visible to students
:Determines whether the quiz will be visible to students. If you are still in the process of setting up the quiz then it is highly advisable to leave this set to 'Hide'. Otherwise students might view or even attempt the quiz before it is tested and ready. This setting is common to all activities and can also be toggled by clicking on the eye icon behind the activity's name on the course page.

==Overall feedback==
Overall feedback is shown to a student after they have completed an attempt at the quiz. The text that is shown can depend on the grade the student got.

For example, if you entered:

:Grade boundary: 100%
:Feedback: "Well done"
:Grade boundary: 40%
:Feedback: "Please study this week's work again"
:Grade boundary: 0%

Then students who score between 100% and 40% will see the "Well done" message, and those who score between 39.99% and 0% will see "Please study this week's work again". That is, the grade boundaries define ranges of grades, and each feedback string is displayed to scores within the appropriate range.

Grade boundaries can be specified either as a percentage, for example "31.41%", or as a number, for example "7". If your quiz is out of 10 marks, a grade boundary of 7 means 7/10 or better.

Note that the maximum and minimum grade boundaries (100% and 0%) are set automatically.

You can set as many or as few grade boundaries as you wish. The form allows you up to 5 ranges at first, but you can add more by clicking the "Add 3 fields to form" button underneath.

==See also==

*[[Quiz permissions]]
*[http://www.youtube.com/watch?v=rFnoNNrTx3c How to create a quiz video]
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=75101 Can the default maximum time limit be extended?] forum discussion

[[cs:Přidání/úprava testu]]
[[de:Test anlegen]]
[[fr:Ajouter/modifier un test]]

Grade items

2008-09-24T10:12:50Z

Mixik: link to Czech translation added

{{Grades}}

== Introduction ==
The three building blocks of the Gradebook in Moodle 1.9 are

#The [[Grade_categories|grade category]]
#The grade item
#The [[Grades|grade]]

A grade item is a unit of measurement by which participants in a course are graded (i.e. 'marked'). 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 are represented by columns in the [[Grader_report | grader report]].

Grade items may refer to course activities (e.g. a quiz, an assignment etc.), [[Outcomes]] or even manual grades. Following is an overview of each type.

== Activity-based grade items ==
[[Image:Edit grade item.png|right|thumb|Editing a grade item]]
Modules that include a form of grading use the [[Development:Grades#API_for_communication_with_modules.2Fblocks|Gradebook API]] to generate a matching grade item, and to communicate their grades to the gradebook. The generated grade item can later be edited from within the gradebook interface (Course -> Grades -> Edit Categories and items -> Edit (hand icon) grade item), as seen in the screenshot to the right, but several of its settings will be 'frozen', only changeable from the activity module's interface. These are listed and explained below in the manual grade items section.

Here is a list of the settings that can be edited for an activity-based grade item:

*'''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. It doesn't work for scales, as it is yet to be fully implemented in Moodle 1.9. It is planned for use in [[Development:Course completion|course completion]] in Moodle 2.0.
*'''Grade display type''': See the [[Grade_item_settings#Grade_display_type | Grade display type doc]]
*'''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 grades for this grade item will be multiplied.
*'''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)
*'''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.

== Grade outcome items ==
[[Image:grade_outcome_item.png|right|thumb|Editing a grade outcome item]]
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.

Grade outcome items can optionally be linked with an activity module. This is done automatically when a grade outcome item is generated by the creation of an activity module in which outcomes were selected. In this scenario, a grade category is also created and named after the activity module, and the grade item and grade outcome items are created as children of that category.

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 ==
[[Image:manual_item.png|right|thumb|Editing a manual grade item]]
These grade items are created manually through the "Edit Categories and Items" page. The "Add grade item" button is clicked, and the form appears. Several options are available here which are normally automatically filled out by the activity module creating an activity-based grade item:

*'''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)

Conversely, two of the settings found in the form for activity-based grade items are absent from this form:
*Multiplicator
*Offset

==See also==
*[[Grade item settings]] - for administrators

[[ca:grade/edit/tree/item]]
[[cs:Položky hodnocení]]
[[fr:Eléments d'évaluation]]

Grades

2008-09-21T08:30:39Z

Mixik: link to Czech translation added

{{Grades}}'''Note:''' This page, together with the pages listed in the block on the right, describe the gradebook in Moodle 1.9 onwards. For documentation on the gradebook in Moodle prior to 1.9, see [[Grades pre-1.9]].

==Introduction==

The concepts of ''grades'' and of ''gradebook'' have been completely revisited in Moodle 1.9. Although these words are used in earlier versions, important differences are documented here in order to avoid misconceptions.

The two central ideas of grading in Moodle 1.9 are:

#'''Grades''' are scores attributed to participants in a Moodle course
#The '''gradebook''' is a repository of these grades: modules push their grades to it, but the gradebook doesn't push anything back to the modules

The three building blocks of the Gradebook in Moodle 1.9 are

*The [[Grade_categories|grade category]]
*The [[Grade_items|grade item]]
*The grade (see above)

As an overview:
*A grade category groups grade items together, and has settings for affecting these grade items
*A grade item stores a grade for each course participant, and has settings for affecting these grades
*A grade has settings for affecting how it is displayed to the users, as well as [[Grade locking|locking]] and [[Grade hiding|hiding]] functions.

Grades can be [[Grade_calculations|calculated]], [[Grade_categories#Aggregation|aggregated]] and [[Grader_report#Display|displayed]] in a variety of ways, the many settings having been designed to suit the needs of a great variety of organisations.

Many activities in Moodle, such as [[Assignment module|assignments]], [[Forum module|forums]] and [[Quiz module|quizzes]] may be given grades. Grades may have numerical values, or words/phrases from a [[Scales|scale or rating system]].

Grades can also be used as [[Outcomes|outcomes]] and as arbitrary text attributed to each participant in a course.

==Grades pushed by modules==
When activity modules produce grades, they use the [[Development:Grades#API_for_communication_with_modules.2Fblocks|gradebook public API]] to push (or send) their grades to the gradebook. These grades are then stored in database tables that are independent of the modules. The grades are still kept in the module database tables, and the gradebook will never access or modify these original grades.

The gradebook, however, provides administrators and teachers with tools for changing the ways in which grades are calculated, aggregated and displayed, as well as [[grade/edit/tree/grade|means to change the grades manually]] (a manual edit of a grade automatically locks the grade in the gradebook, so that the module which originally created the grade can no longer update that grade in the gradebook until the grade is unlocked).

==Settings affecting grades==
Being the smallest unit in the gradebook, the grade is affected by many settings at different levels. Here is a list of these levels, in hierarchical order:

*[[General_grade_settings|Site-wide general settings]]
*[[Grade_category_settings|Site-wide grade category settings]]
*[[Grade_item_settings|Site-wide grade item settings]]
*[[Gradebook_report_settings|Gradebook report settings]]
*[[Gradebook_course_settings|Course settings]]
*[[Grade_categories|Category settings]]
*[[Grade_items|Grade item settings]]
*[[grade/edit/tree/grade|Grade settings]]

==Outcomes==

[[Outcomes]] are specific descriptions of what a student is expected to be able to do or understand at the completion of an activity or course. An activity might have more than one outcome, and each may have a grade against it (usually on a [[Scales|scale]]).

==Gradebook reports==

The gradebook includes a variety of reports, available via the grades link in each [[Administration block|course administration block]]:

* [[Grader report]] - The main teacher view of a course gradebook. The "[[Grade preferences|My report preferences]]" tab in the grader report enables teachers to change how the grader report is displayed.
* [[Outcomes report]]
* [[Overview report]]
* [[User report]]

==Grades organisation==

Teachers may organise grades into [[Grade categories|grade categories]], [[Grade import|import]] and/or [[Grade export|export]] grades, and make [[Grade calculations|grade calculations]].

Symbols to represent ranges of grades may be set as [[Grade letters|grade letters]].

Administrators may control the appearance of the gradebook site-wide by adjusting settings available via the grades link in the site administration block:

*[[General grade settings]]
*[[Grade category settings]]
*[[Grade item settings]]
*[[Gradebook report settings]]

==External links==
*[http://www.youtube.com/watch?v=YeUy-_kbvqQ Basic Moodle Gradebook howto video]
*[http://moodle.org/mod/forum/view.php?id=2122 Gradebook forum] (Moodle.org)

[[ca:Qualificacions]]
[[cs:Známky]]
[[eu:Kalifikazioak]]
[[fr:Notes]]

Grader report

2008-09-21T08:28:51Z

Mixik: link to Czech translation added

{{Grades}}The grader report page is the main teacher view of the new gradebook in Moodle 1.9. For versions prior to 1.9, look [[Grades_pre-1.9 | here]].

=Basics=
The gradebook 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|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 how ever 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 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.

=Display=
==Layout==
[[Image:gradebook_normal_mode.png|right|thumb|Grader report in non-editing mode]]
Along the top are several rows: first the course, then the category, then the actual column (e.g. an essay or a category total). When you start off, every essay, quiz etc is in the '''uncategorised''' category, which is named after the course by default, but can be changed if needed.

You can add a row showing the range of possible scores by going to [[Grade_preferences|My report preferences]] and selecting '''Show ranges'''.

There are three ways that the categories can be displayed

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

Each section has a small icon immediately to the right of its name. Clicking this will cycle through these display modes for that category. + goes to grades only view, o goes to full view and - goes to collapsed view.

===Other layout options===
The defaults for these options can be set at site level by going to Administration->Grades->[[Gradebook_report_settings|Report settings]]->Grader report.

*You can add a row showing the range of possible scores by going to [[Grade_preferences|My report preferences]] and selecting '''Show ranges'''.

==Highlighting rows and columns==
When your gradebook starts to grow, it can be hard to keep track of which student and which assignment a cell refers to. Highlighting solves that.
* Clicking on empty space in the cell that contains the students name will toggle the highlighting of that entire row
* Clicking on empty space in the cell at the top of each column will toggle highlighting of the entire column
(Note: this requires Javascript to be enabled in your browser.)

==Highlighting scores that are either adequate or unacceptable in red and green==
Turn editing on and click on the edit icon in the controls cell at the top of the column. You can then (maybe need to click 'show advanced') see the option to enter a 'grade to pass'. Once set, any grades falling above this will be highlighted in green and any below will be highlighted in red.

==Categorising the grades==
The 'Choose an action...' drop down on the upper left will let you switch to other views
* '''Edit categories and items''' will allow you to set up your assessments in different categories e.g. 'classwork', 'homework' etc.

Each category will then have its own '''Category total''' column.

=Editing=
[[Image:gradebook_edit_mode.png|right|thumb|Grader report in editing mode]]
Note: Editing anything in the gradebook refers to editing the grades '''only''' and none of the available operations bear any relationship to editing the main course page i.e. the appearance of your course page cannot be influenced by anything you do in the gradebook. The "Turn editing on" button functions separately to the main course one, so editing can be on in the gradebook, but simultaneously off when you switch back to course view. This is because editing grades and editing the course page are separate capabilities and a role e.g. 'non-editing teacher' may only have one or the other.

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

Alternatively, you can click on "[[Grade_preferences|My report preferences]]"' and choose "Quick grading" and "Quick feedback" to make the report appear with editable boxes containing each grade, so you can change many at once.

Quick feedback is switched off by default, but you can easily switch it on or off using the "Show Quick Feedback" link above the grader report, when editing is on. Alternatively you can switch it on and off in the page "[[Grade_preferences|My report preferences]]".

==Calculating totals==
Rather than a simple average or sum, Moodle can perform very complex calculations to produce the totals for each category and for the whole course. e.g. you want to take an average of 3 items from one category, double it, then add it to the average of another category.

You can do this using calculations. Either turn on editing, then click '''Show calculations''', or go to '''[[Grade_preferences|My report preferences]]''', choose '''show calculations''', then save and turn editing on. You will then see a small calculator icon next to each total column which, when you click on it, will take you to the page [[Edit grade calculation]] where there are instructions.

To choose how the grades are aggregated for the totals within categories, you can turn editing on and click on the little editing icon for the category. You can then choose to have means, medians, modes etc. leave out empty grades and other settings.

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

==Recalculating==
If you change any part of an assesment 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.

==See also==
*[[Edit grade calculation]]
*[[Grade preferences]]
*[http://www.youtube.com/watch?v=EB58W3KePBc Video showing the basic gradebook setup and use]
*[http://www.youtube.com/watch?v=jWPUEqdhI4A Video showing how to change the display of grades in the gradebook]
*[http://www.youtube.com/watch?v=5hrLNbifiGQ Video explaining the different gradebook reports]
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=87844 What happens in the 1.9 gradebook when students are unenrolled from a course] forum discussion

[[ca:grade/report/grader/index]]
[[cs:Celkový přehled]]
[[fr:Rapport de l'évaluateur]]

Grade categories

2008-09-09T08:42:41Z

Mixik: link to czech version added

{{Grades}}
[[Image:Edit grade category.png|thumb|Editing a grade category]]Grades can be organised into grade categories.
A grade category has its own aggregated grade which is calculated from its grade items. There is no limit to the level of nesting of categories (a category may belong to another category). However, each grade item may belong to only one category. Also, all grade items and categories belong to at least one, permanent category: [[Edit_categories_and_items#Top_category|the course category]].

==Adding a grade category==
To add a grade category:
# Select "Categories and items" from the gradebook dropdown menu.
# Click the "Add category" button near the bottom of the page.
# Give the grade category a meaningful name.
# Select grade category settings as appropriate. Advanced settings may be made available by clicking the "Show advanced" button.
# Click the "Save changes" button.

==Editing a grade category==
To edit a grade category:
# Select "Categories and items" from the gradebook dropdown menu.
# Click the edit icon opposite the grade category you wish to edit.
# After editing the grade category, click the "Save changes" button.

==Settings==
=== Aggregation ===
See [[Category aggregation]] for a detailed explanation.

=== Aggregate only non-empty grades ===
Non-existent grades are either treated as minimal grades or not included in the aggregation. For example, an assignment graded between 0 and 100 for which only half the students have been graded will either count the non-graded submissions as 0 (option switched off) or will ignore them (option switched on).

Important: An empty grade is simply a missing gradebook entry, and could mean different things. For example, it could be a participant who hasn't yet submitted an assignment, an assignment submission not yet graded by the teacher, or a grade that has been manually deleted by the gradebook administrator. Caution in interpreting these "empty grades" is thus advised.

=== Aggregate including sub-categories ===
The aggregation is usually done only with immediate children, it is also possible to aggregate grades in all subcategories excluding other aggregated grades.

=== Drop the lowest ===
If set, this option will drop the X lowest grades, X being the selected value for this option.

=== Aggregation view ===
Each category can be displayed in three ways: Full mode (aggregated column and grade item columns), the aggregated column only, or the grade items alone.

==See also==

*[[Grade items]]
*[[Edit categories and items]]
*[[Grade category settings]] - for administrators
*[http://www.youtube.com/watch?v=sUslTuZPu6A Video showing the effects of the grade category settings]
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=91632 Grade categories and weights 1.8 to 1.9?] forum discussion

[[ca:grade/edit/tree/category]]
[[fr:Catégories d'évaluation]]
[[cs:Kategorie známek]]

Assignment permissions

2007-12-09T12:35:20Z

Mixik: Czech link updated

{{Assignments}}
{{Moodle 1.7}}Roles and capabilities in Moodle 1.7 onwards enable possibilities such as students being given permission to grade assignments. The following capabilities are related to assignments:

*[[Capabilities/mod/assignment:grade|mod/assignment:grade]]
*[[Capabilities/mod/assignment:submit|mod/assignment:submit]]
*[[Capabilities/mod/assignment:view|mod/assignment:view]]

[[Category:Assignment]]
[[Category:Roles]]

[[cs:Pravomoci modulu Úkol]]
[[fr:Permissions des devoirs]]

Allow role overrides

2007-12-09T11:24:46Z

Mixik: Czech link

{{Roles}}Location: ''Administration > Users > Permissions > Define roles''

This page is for setting which roles can be overridden by each role.

The page only applies to roles which have the capability to override role (in other words, the capability [[Capabilities/moodle/role:override|moodle/role:override]] is set to allow). By default, only administrators have this capability. All the boxes in the Administrator row are checked by default, meaning that admins can set role overrides for all other roles.

==Enabling teachers to set role overrides==

[[Image:Administration Block Site Roles AllowRoleOverrides.JPG|thumb|Allow role overrides in Moodle 1.8]]
To enable teachers to set role overrides, you need to first allow the capability to override roles and then set which role(s) teachers can override.

#Access ''Administration > Users > Permissions > Define roles''.
#Edit the teacher role and change the capability [[Capabilities/moodle/role:override|moodle/role:override]] to allow.
#Click the button "Save changes".
#Click the tab "Allow role overrides" (in ''Administration > Users > Permissions > Define roles'')
#Check the appropriate box(s) in the teacher row to set which role(s) teachers can override. Most likely it will just be the student role (you don't want teachers to be able to override admins), so check the box where the teacher row intersects with the student column.
#Click the button "Save changes".

==See also==
*[[Override roles]]
*[[Capabilities/moodle/role:override]]

[[cs:Povolit přenastavení rolí]]
[[fr:Autoriser la définition de dérogations aux rôles]]
[[ja:ロールのオーバーライド許可]]

Allow role assignments

2007-12-09T10:37:02Z

Mixik: Czech link

{{Roles}}
{{Moodle 1.7}}

Location: ''Administration > Users > Permissions > Define roles''

The Allow role assignments page is for setting which roles each role can assign other users to. These roles are also available in the "Switch role to..." drop-down menu for users with the [[Capabilities/moodle/role:switchroles|moodle/role:switchroles]] capability.

==Default role assignments==

*Administrator - may assign all other roles
*Course creator - may assign teacher, non-editing teacher, student and guest
*Teacher - may assign non-editing teacher, student and guest

==Enabling teachers to assign other teachers==
[[Image:allow role assignments.png|thumb|Allow role assignments]]
By default, teachers can only assign other users the roles of non-editing teachers, students and guests. If you want teachers to be able to assign other teachers in their course, you can allow the role assignment:

#Click on Permissions in the Site Administration block, then Define roles.
#Click the Allow role assignments tab.
#Click the checkbox where the teacher row and column intersect.
#Click the "Save changes" button.

==See also==

*[[Capabilities/moodle/role:assign]]

[[Category:Administrator]]
[[Category:Roles]]

[[cs:Povolit přidělování rolí]]
[[fr:Autoriser les attributions de rôles]]
[[ja:ロールの割り当て許可]]

Override permissions

2007-12-09T10:16:54Z

Mixik: Czech link

{{Roles}}
[[Image:Override permissions.png|thumb|left|Override permissions in Moodle 1.9]]
Overrides are specific permissions designed to override a role in a specific context, allowing you to "tweak" your permissions as required. Overriding does not create a new role. It modifies an existing role and affects all users assigned to that role in the context.

For example, users with the Student role can normally start new discussions in forums. Suppose there is a particular forum in which you want to restrict this capability. Within the forum, set an override that PREVENTS the capability for Students to "Start new discussions."

If you want to prevent only a few selected students from starting discussions in the forum, you cannot do it by overriding the Student role, since doing so would affect all Students. You need a new role. Unfortunately, you (as a teacher) cannot create one. Only the administrator can create new roles. The best solution is to ask the administrator to create a copy of the Student role. Then, within the forum, override the copied role as described in the paragraph above. Finally, assign the selected students to this role within the forum.

Overrides can also be used to "open up" areas of your site and courses to give users extra permissions where it makes sense. For example, you may want to experiment giving Students the ability to grade some assignments.

The interface for overriding permissions is similar to the one for defining roles, except sometimes only relevant capabilities are shown, and you will also see some capabilities highlighted to show you what the permission for that role would be WITHOUT any override active (i.e. when your override is set to NOT SET).

Note: Prior to Moodle 1.9, the override permissions page was named "Override roles".

==Enabling teachers to override permissions==

By default, only administrators are able to override permissions. You can enable teachers to do so as follows:
#Access ''Administration > Users > Permissions > Define roles''
#Edit the teacher role and change the capability [[Capabilities/moodle/role:override|moodle/role:override]] to allow
#Click the button "Save changes"
#Click the tab "Allow role overrides" (in ''Administration > Users > Permissions > Define roles'')
#Check the appropriate box to allow a teacher to override the student role
#Click the button "Save changes"

If preferred, a new role for overriding permissions may be created and selected teachers assigned to it.

[[cs:Přenastavení oprávnění]]
[[es:Anular_roles]]
[[fr:Définir des dérogations aux rôles]]
[[ja:ロールのオーバーライド]]
[[ru:Переопределение ролей]]

Assign roles

2007-12-09T08:48:56Z

Mixik: Czech link

{{Roles}}

==Locations that assign roles==

[[Image:Assign roles.png|thumb|Assign roles in Moodle 1.9]]
Assigning roles is done for/in a particular context. A site and course are examples of two different contexts. While the process is similar for each context, the approach to role assignment page may be different. Here are several contexts and ways to find the assign roles.

*System context: ''Administration > Users > Permissions > Assign global roles'' (this context is named "site" in Moodle 1.7)
*Site context: ''Administration > Front Page > Front Page roles'' (from Moodle 1.8 onwards)
*Course category context: Assign roles link in course categories page
*Course context: Assign roles link in course administration block
*Module context: Roles tab in editing activity page
*Block context: Assign roles link in course block (editing on)
*User context: Roles tab in user profile page

{{Moodle 1.9}}In Moodle 1.9 onwards, the assign roles page lists the names of users assigned to each role (unless there are more than 10 users, in which case this is stated).

==Contexts==

By assigning a role to a user in a certain context, you grant them the permissions contained in that role for the current context and all lower contexts.

The list of contexts in hierarchical order is as follows:

*System (no parent)
*Site (parent = system) - Moodle 1.8 onwards
*Course category (parent = system)
*Course (parent = category or system)
*Module (parent = course or system/site(1.8 onwards))
*Block (parent = course or system/site(1.8 onwards))
*User (parent = system)

Inheritance will kick in if a role is assigned at a higher level. For example if a user is assigned a Teacher role in a particular course category then the user will have this role in ALL courses within the category.

Roles will only work if the role assignment is made in the correct context. For example, a Teacher role should be assigned in the course or course category context, a Forum moderator for a particular forum should be assigned in the module context.

The [[Inspector role]] is an example of a role assigned in the system context. The [[Forum moderator role]] is an example of a role assigned in the module context. The [[Parent role]] is an example of a role assigned in the user context.

==Assigning a role==

[[Image:Roles Assign Student.JPG|thumb|Assigning users the role of student i.e. enrolling them on the course]]"Student", "Teacher", "Course Creator" are some of the predefined roles that come with Moodle. The site administrator may have created additional roles.
To assign a role:
#Choose the type of role you wish to assign. For example, if we wanted to assign a Student role to Martin, we'd choose "Student" from the list of roles.
#Once you have chosen a role, two lists appear: a list of users who currently have that role (Student Demo in the example), and a list of users who don't. We can select Martin in the second list, and use the left-facing arrow button to add Martin to the list of Students. Multiple users may be selected by holding down the Apple or Ctrl key whilst clicking on the users' names.

Removing someone from a role is done by moving the user from the left column to the right.

==Hidden assignments==

To hide which role a user is assigned to, click the Hidden assignments check box before assigning the role to the user. This feature is useful for example if you don't want everyone with teacher rights listed in the course description.

Note: The role assignment is not hidden from admins or teachers i.e. users with the [[Capabilities/moodle/role:viewhiddenassigns|viewhiddenassigns capability]].

==Enabling teachers to assign the role of teacher==

By default, teachers are only allowed to assign the roles of non-editing teacher, student and guest. To enable teachers to assign the role of teacher:

#Access ''Administration > Users > Permissions > Define roles''.
#Click the tab "Allow role assignments".
#Click the checkbox where the teacher row and column intersect.
#Click the "Save changes" button.

==Beware of assignments that don't make sense==

There are many role assignments that do not make sense as the underlying functionality does not exist. Just because you give someone the "right" to do something does not guarantee that the interface or facility actually exists within the context that you have assigned that right. For example, you can assign a user the right to create new categories at the Category context, however there is no interface within Moodle to do that (category creation is only available at the site level).

==Multiple assignments==

A significant part of the roles infrastructure is the ability to assign a user into multiple roles (at the same time). The capabilities of each role are merged to produce the effective set of capabilities. In particular it is perfectly possible for a user to be both a Teacher and Student in the same course. This differs from the behavior of Moodle prior to the introduction of roles. You should be careful to ensure that if you change a user's role that you remove them from any other roles as required as this will no longer be done automatically.

==Global roles==

Roles assigned in the site (1.7) or system context (1.8 onwards) are called global roles and apply across the entire site, including the front page. For example, a user assigned the global role of Teacher will have this role in every course on the site.

In many sites only admins and course creators will be assigned global roles.

The [[Demo teacher role|Demo teacher]] Restricted user role is an example of a global role.

==Front page roles==

You can assign roles and set up role overrides for your front page in exactly the same way as for a course.

To enable users to engage in front page activities, you need to either assign all users the front page role of student or set up authenticated user overrides. For example, if you want users to be able to view forum discussions and reply to posts, you can override the authenticated user role and allow these permissions.

==See also==
*[[Manage roles]] - for administrators
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=59900 Discrepancies between Assign Roles lists and Participants list] and [http://moodle.org/mod/forum/discuss.php?d=66782 What happens if a user has multiple roles in a course?] forum discussions

[[Category:Teacher]]
[[Category:Roles]]

[[cs:Přidělení rolí]]
[[es:Asignar_roles]]
[[fr:Attribuer des rôles]]
[[ja:ロールの割り当て]]
[[ru:Назначение ролей]]

Rols i permisos

2007-12-09T08:47:50Z

Mixik: Czech link

{{Roles}}
{{Moodle 1.7}}Roles and capabilities in Moodle 1.7 onwards provides great flexibility in managing how users interact. Prior to Moodle 1.7, there were only six roles possible: guest, student, non-editing teacher, editing teacher, course creator, and administrator. Whilst these roles may still be used, it's now possible to create additional roles, and to change what a given role can do in a particular activity.

==Definitions==
;Role
:An identifier of the user's status in some context, for example Teacher, Student and Forum moderator
;Capability
:A description of a particular Moodle feature, for example [[Capabilities/moodle/blog:create|moodle/blog:create]]
;Permission
:A setting for a capability
;Context
:A "space" in Moodle, such as courses, activity modules or blocks

==Permissions==

Permissions are settings for specific capabilities. There are four values:

;Not Set (formerly Inherit)
:This is the default value for all permissions when a new role is created. It means "use whatever setting the user already has". To determine what permission the user already has, Moodle searches upward through the nested contexts, looking for an explicit value (Allow, Prevent, Prohibit) for this capability. For example, if a role is assigned to a user in a course context, and some capability has a value of 'Not set,' then the actual permission will be whatever the user has at the category level, or (failing to find an explicit permission at the category level) at the site level. Note that the search terminates when an explicit permission is found. If no explicit permission is found, then the value in the current context becomes Prevent.

;Allow
:By choosing this you are granting permission for this capability to people who are assigned this role. This permission applies for the context that this role gets assigned plus all "lower" contexts. For example, if this role is a student role assigned to a course, then students will be able to "start new discussions" in all forums in that course, unless some forum contains an override or a new assignment with a Prevent or Prohibit value for this capability.

;Prevent
:By choosing this you are removing permission for this capability, even if the users with this role were allowed that permission in a higher context.

;Prohibit
:This is rarely needed, but occasionally you might want to completely deny permissions to a role in a way that can NOT be overridden at any lower context. An example of when you might need this is when an admin wants to prohibit one person from starting new discussions in any forum on the whole site. In this case they can create a role with that capability set to "Prohibit" and then assign it to that user in the site context.

==See also==
*[[Development:Roles]]
*[[:Category:Capabilities]]
*Using Moodle [http://moodle.org/mod/forum/view.php?id=6826 Roles and Capabilities forum]
*[[Upgrading to Moodle 1.7]]
*[[Upgrading to Moodle 1.8]]

[[Category:Roles]]

[[cs:Role]]
[[es:Roles y capacidades]]
[[eu:Rolak]]
[[fr:Rôles et capacités]]
[[ja:ロールおよびケイパビリティ]]
[[ru:Роли и возможности]]

Paràmetres de la tasca

2007-12-08T18:26:00Z

Mixik: /* Due date -- Disable checkbox correction no. 2 */

{{Assignments}}
==Assignment name==

Give your assignment a name (e.g. “Report on Topic Content”). The name entered here will be the name that learners see in the course content area. Learners will click on this name to view the details of the assignment and, if applicable, submit their work.

==Description==

The description of the assignment, which should include precise instructions for students regarding the subject of the assignment, the form, in which it should be submitted, the grading criteria etc.

Use this area to describe the assignment and explain what learners are expected to do to complete this task. The assignment description can be as brief or as expansive as you feel is necessary to meet the needs of your learners. However, it is to your benefit to provide as much detail and information as possible, especially at the start of the course while you are still establishing procedures. Generally, the more information you are able to provide here the fewer questions and problems your learners will have completing the task.

The assignment description field can also be used to provide information or resources related to the assignment. An instructor, for example, could provide some literature, a video clip, an image, or a link to a webpage, and then ask the learners to use these materials in completing the task. (Alternatively, the instructor could post these items using the Resource Module and refer students to them in the assignment details. See the section titled Resource Module for more information.)

Finally, if you are adding rich content, tables, etc. to your description, it is best to expand the HTML editor into full screen mode so you can make your webpage document look nice when participants view it.

==Grade==

The grade for the assignment is specified here. Choosing a number will become the maximum grade for this assignment. Apart from the numbers, one of the descriptive grades which have been defined for this course can also be picked.

If you will not be giving a grade for the assignment, choose No Grade.

==Available from==

Setting this date prevents students from submitting their assignments before this date.

The Available from date setting allows an instructor to set a day and time at which learners can begin submitting the assignment. This setting does not, however, hide the activity from the learners. Instead, the learner will see the activity, be able to view the instructions and use any materials you have include in the description, but the learner will not be able to submit or complete the assignment until the Available from date.

To activate the Available from date, make sure that the “Disable” checkbox is not marked. Then, use the drop down menus to choose the day, month and year. You can also set a time with the last two fields on the line. Note: the time is based on a 24 hour clock or “military time,” so 14:00 refers to 2:00 p.m.

If you do not wish to use the Available from option, just check the “Disable” checkbox by clicking on it; the rest of the field will turn gray and the date will be ignored.

==Due date==

And this prevents students from submitting their assignments after this date.

The Due date field works in much the same way as the Available from field with a few small differences. Unchecking the “Disable” checkbox activates the Due date option and you have the same ability to select a day, month, year, and time. If the checkbox is checked, then the due date will be not be applied.

As with the Available from setting, the Due date defines when learners are able to submit their assignment. However, with the Due date settings, you also have the Prevent late submissions option (below the date and time fields). Setting Prevent late submissions to Yes will prevent learners from being able to submit this assignment after the Due date. If you set Prevent late submissions to No, then learners can submit the assignment as long as the assignment is visible or accessible to them.

Both the Available from and Due dates are displayed for learners in the assignment details, but the Due date is also marked in the course Calendar as a visible reminder for participants. Furthermore, the indicator on the calendar will actually link learners directly to the activity!

Your use of the Available from and Due date settings will probably be dependent on the overall structure of your course. If you are facilitating an open ended course or a course with rolling enrollment, then you might find it easier to not apply the Available from and Due date settings (uncheck the boxes). This arrangement will allow the learners to access the assignments according to their own schedule and progress within the course. Alternatively, if you are working within a more structured format or adhering to a timeline, the Available from and Due date settings are useful for keeping learners on schedule. Using the Available from setting will make it possible for learners to preview upcoming activities, while at the same time, prevent them from finishing the course in the first week and not returning for additional activities or information. Likewise, the Due dates help keep the learners from lagging too far behind and decrease the likelihood that the learner will become overwhelmed by having to complete several weeks worth of work at once.

==Prevent late submissions==

Set to "No", assignments submitted after the due date will be marked as late, but students will still be able to submit them. Set to "Yes", assignment submission will be blocked after the due date.

==Settings for specific assignment types (1.7 onwards)==

Each assignment type, except offline assignment, has further settings which are detailed on the relevant assignment type pages:
*[[Upload a single file assignment|Upload a single file]]
*[[Online text assignment|Online text]]
*[[Advanced uploading of files assignment|Advanced uploading of files]]

==Assignment type (pre-1.7)==

With the Assignment type setting (pre-1.7), you choose the type of assignment which defines how learners will complete the assignment and turn it in to the instructor. Assignments can be set up as offline activity, online text, or upload a single file.

;Upload
:A student can upload a single file. This could be a Word document, spreadsheet or anything digital. Multiple files could be zipped and then submitted.After learners upload their files in this arrangement, the instructor will be able to open the submission and then use the Moodle interface to assign a grade and offer comments as feedback.

:In addition to using this activity to collect work from learners, some instructors and learners use this module as a tool for transferring projects from one location to another. For example, if an instructor offered learners an assignment of this form, the learner could upload a file he was working on at school and then, once home, retrieve it from the assignment screen to continue his work. With the right settings (offered on the next screen), the learner can then submit the new file from home to use at school again.

;Online Text
:This assignment type asks users to compose and edit text, using the normal editing tools. The online text assignment can be set up to allow learners to compose, revise and edit over time or such that the learner only has one opportunity to enter his or her response. Furthermore, with the online assignment, instructors can grade the work online and even edit and/or provide comments within the learner’s work.

:The online text assignment is ideal for journaling and composition work.

;Offline assignment
:This is useful when the assignment is performed outside of Moodle. It could be something elsewhere on the web or face-to-face. Students can see a description of the assignment, but can't upload files. Grading works normally, and students will get notification of their grades.

:The offline activity has a number of different applications. In general, the offline activity is designed for activities completed outside of the online environment. Additionally, if you are using the Moodle gradebook, the offline activity gives you the capability to add gradebook entries for assignments completed outside of Moodle or for non-graded activities within Moodle.

:Specifically, an instructor in a hybrid or blended environment (combination of face-to-face and online instruction) may use the offline activity type of assignment to assign a project that the learner will physically present to the instructor at a face-to-face session. This arrangement allows the instructor to communicate the project expectations online while creating an entry for the project in the Moodle gradebook.

:In another example, consider the instructor who gives reading assignments or assigns problems for practice. These activities wouldn’t necessarily be turned in for a grade, but the instructor needs a tool for communicating the assignment details. The offline assignment, with its unique icon, could be used as a consistent visual cue for the learners; learners would come to know that they can always look for the assignment icon to see what work they need to complete.

:Finally, the offline assignment, as mentioned previously, is a tool for making entries in the Moodle gradebook. Perhaps an instructor wants to assign a grade for contributions to a class wiki; however, the wiki itself is an ungraded activity. The instructor could use an offline assignment to create an entry for the wiki contribution grade in the Moodle gradebook. In this example, however, the instructor may choose to hide the actual listing of the assignment in the Moodle course since it is primarily being used for the purpose of making a gradebook entry.

To complete the settings specific to the assignment type, click Next to proceed to the [[mod/assignment/details|assignment details]] page.

== Common module settings ==

=== Group mode ===
The [[Groups|group mode]] can be one of three levels: no groups, separate groups or visible groups.

=== Visible ===
Choose whether to Show or Hide the assignment

==Tips and tricks==
*Copy an assignment by backing up the course and selecting just the assignment, with or without students and their data. Restore the backup. Move and or edit the assignment.

==See also==

*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=64755 How do I make assignments worth more than 100 points?] forum discussion

[[cs:Přidání/úprava úkolu]]
[[fr:Ajouter/modifier un devoir]]

Usuari:Daniel Miksik

2007-12-08T18:06:31Z

Mixik:

* Moodle [http://www.phil.muni.cz/elf/index.php?lang=en_utf8 administrator]
* Moodler — contributing partly to the [https://docs.moodle.org/cs/Hlavní_strana Czech Moodle Documentation]

Paràmetres de la tasca

2007-12-08T17:48:33Z

Mixik: /* Available from -- "Disable" checkbox correction */

{{Assignments}}
==Assignment name==

Give your assignment a name (e.g. “Report on Topic Content”). The name entered here will be the name that learners see in the course content area. Learners will click on this name to view the details of the assignment and, if applicable, submit their work.

==Description==

The description of the assignment, which should include precise instructions for students regarding the subject of the assignment, the form, in which it should be submitted, the grading criteria etc.

Use this area to describe the assignment and explain what learners are expected to do to complete this task. The assignment description can be as brief or as expansive as you feel is necessary to meet the needs of your learners. However, it is to your benefit to provide as much detail and information as possible, especially at the start of the course while you are still establishing procedures. Generally, the more information you are able to provide here the fewer questions and problems your learners will have completing the task.

The assignment description field can also be used to provide information or resources related to the assignment. An instructor, for example, could provide some literature, a video clip, an image, or a link to a webpage, and then ask the learners to use these materials in completing the task. (Alternatively, the instructor could post these items using the Resource Module and refer students to them in the assignment details. See the section titled Resource Module for more information.)

Finally, if you are adding rich content, tables, etc. to your description, it is best to expand the HTML editor into full screen mode so you can make your webpage document look nice when participants view it.

==Grade==

The grade for the assignment is specified here. Choosing a number will become the maximum grade for this assignment. Apart from the numbers, one of the descriptive grades which have been defined for this course can also be picked.

If you will not be giving a grade for the assignment, choose No Grade.

==Available from==

Setting this date prevents students from submitting their assignments before this date.

The Available from date setting allows an instructor to set a day and time at which learners can begin submitting the assignment. This setting does not, however, hide the activity from the learners. Instead, the learner will see the activity, be able to view the instructions and use any materials you have include in the description, but the learner will not be able to submit or complete the assignment until the Available from date.

To activate the Available from date, make sure that the “Disable” checkbox is not marked. Then, use the drop down menus to choose the day, month and year. You can also set a time with the last two fields on the line. Note: the time is based on a 24 hour clock or “military time,” so 14:00 refers to 2:00 p.m.

If you do not wish to use the Available from option, just check the “Disable” checkbox by clicking on it; the rest of the field will turn gray and the date will be ignored.

==Due date==

And this prevents students from submitting their assignments after this date.

The Due date field works in much the same way as the Available from field with a few small differences. The checkbox activates the Due date option and you have the same ability to select a day, month, year, and time. If the checkbox is empty, then the due date will be not be applied.

As with the Available from setting, the Due date defines when learners are able to submit their assignment. However, with the Due date settings, you also have the Prevent late submissions option (below the date and time fields). Setting Prevent late submissions to Yes will prevent learners from being able to submit this assignment after the Due date. If you set Prevent late submissions to No, then learners can submit the assignment as long as the assignment is visible or accessible to them.

Both the Available from and Due dates are displayed for learners in the assignment details, but the Due date is also marked in the course Calendar as a visible reminder for participants. Furthermore, the indicator on the calendar will actually link learners directly to the activity!

Your use of the Available from and Due date settings will probably be dependent on the overall structure of your course. If you are facilitating an open ended course or a course with rolling enrollment, then you might find it easier to not apply the Available from and Due date settings (uncheck the boxes). This arrangement will allow the learners to access the assignments according to their own schedule and progress within the course. Alternatively, if you are working within a more structured format or adhering to a timeline, the Available from and Due date settings are useful for keeping learners on schedule. Using the Available from setting will make it possible for learners to preview upcoming activities, while at the same time, prevent them from finishing the course in the first week and not returning for additional activities or information. Likewise, the Due dates help keep the learners from lagging too far behind and decrease the likelihood that the learner will become overwhelmed by having to complete several weeks worth of work at once.

==Prevent late submissions==

Set to "No", assignments submitted after the due date will be marked as late, but students will still be able to submit them. Set to "Yes", assignment submission will be blocked after the due date.

==Settings for specific assignment types (1.7 onwards)==

Each assignment type, except offline assignment, has further settings which are detailed on the relevant assignment type pages:
*[[Upload a single file assignment|Upload a single file]]
*[[Online text assignment|Online text]]
*[[Advanced uploading of files assignment|Advanced uploading of files]]

==Assignment type (pre-1.7)==

With the Assignment type setting (pre-1.7), you choose the type of assignment which defines how learners will complete the assignment and turn it in to the instructor. Assignments can be set up as offline activity, online text, or upload a single file.

;Upload
:A student can upload a single file. This could be a Word document, spreadsheet or anything digital. Multiple files could be zipped and then submitted.After learners upload their files in this arrangement, the instructor will be able to open the submission and then use the Moodle interface to assign a grade and offer comments as feedback.

:In addition to using this activity to collect work from learners, some instructors and learners use this module as a tool for transferring projects from one location to another. For example, if an instructor offered learners an assignment of this form, the learner could upload a file he was working on at school and then, once home, retrieve it from the assignment screen to continue his work. With the right settings (offered on the next screen), the learner can then submit the new file from home to use at school again.

;Online Text
:This assignment type asks users to compose and edit text, using the normal editing tools. The online text assignment can be set up to allow learners to compose, revise and edit over time or such that the learner only has one opportunity to enter his or her response. Furthermore, with the online assignment, instructors can grade the work online and even edit and/or provide comments within the learner’s work.

:The online text assignment is ideal for journaling and composition work.

;Offline assignment
:This is useful when the assignment is performed outside of Moodle. It could be something elsewhere on the web or face-to-face. Students can see a description of the assignment, but can't upload files. Grading works normally, and students will get notification of their grades.

:The offline activity has a number of different applications. In general, the offline activity is designed for activities completed outside of the online environment. Additionally, if you are using the Moodle gradebook, the offline activity gives you the capability to add gradebook entries for assignments completed outside of Moodle or for non-graded activities within Moodle.

:Specifically, an instructor in a hybrid or blended environment (combination of face-to-face and online instruction) may use the offline activity type of assignment to assign a project that the learner will physically present to the instructor at a face-to-face session. This arrangement allows the instructor to communicate the project expectations online while creating an entry for the project in the Moodle gradebook.

:In another example, consider the instructor who gives reading assignments or assigns problems for practice. These activities wouldn’t necessarily be turned in for a grade, but the instructor needs a tool for communicating the assignment details. The offline assignment, with its unique icon, could be used as a consistent visual cue for the learners; learners would come to know that they can always look for the assignment icon to see what work they need to complete.

:Finally, the offline assignment, as mentioned previously, is a tool for making entries in the Moodle gradebook. Perhaps an instructor wants to assign a grade for contributions to a class wiki; however, the wiki itself is an ungraded activity. The instructor could use an offline assignment to create an entry for the wiki contribution grade in the Moodle gradebook. In this example, however, the instructor may choose to hide the actual listing of the assignment in the Moodle course since it is primarily being used for the purpose of making a gradebook entry.

To complete the settings specific to the assignment type, click Next to proceed to the [[mod/assignment/details|assignment details]] page.

== Common module settings ==

=== Group mode ===
The [[Groups|group mode]] can be one of three levels: no groups, separate groups or visible groups.

=== Visible ===
Choose whether to Show or Hide the assignment

==Tips and tricks==
*Copy an assignment by backing up the course and selecting just the assignment, with or without students and their data. Restore the backup. Move and or edit the assignment.

==See also==

*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=64755 How do I make assignments worth more than 100 points?] forum discussion

[[cs:Přidání/úprava úkolu]]
[[fr:Ajouter/modifier un devoir]]

Moodle in education

2007-11-01T01:47:16Z

Mixik: /* Czech added to "In other languages" */

==Getting started==
If you are a new user and would like a list of all teacher documentation articles, please see [[:Category:Teacher]].

We are assuming that your site administrator has set up Moodle, you are a user with teacher privileges and the administrator has assigned you to a new, blank course. Don't forget, [http://demo.moodle.org/ demo.moodle.org] will let you play an hour at a time for free.

You will need to be [[Log in | logged into]] the course as a user who has been assigned [[Teacher|a role as a teacher]] (with editing rights) on that course to use most of the features below. We have some tips if you are having [[Can not log in | trouble logging in]].

Now onto the real details. You will find the [[Course homepage|course homepage]] is broken down into [[Course sections|course sections]]. A course is created by [[Adding resources and activities|adding resources and activities]]. When writing text in Moodle you have a range of [[Formatting options]], including using [[HTML editor|HTML in Moodle]]. There are different ways to enroll [[Students]] and assign them to one or more [[Groups]] in a course.

The example below shows a new course set up with topic sections, edit is on. There are a few of Moodle's many [[:Category:Block|blocks]] on the right and left sides of the topics, such as "Latest News" or "[[Administration block|Administration]]". The teacher is ready to add resources and activities or a few new blocks to their brand new course.
[[Image:Course edit on new 2.jpg|thumb|center|500px|Getting started image - a new course]]

==Editing course section==
[[Image:Turn_edit_on_Student_on_buttons.JPG]] 
To add or alter activities or resources a teacher will need to [[Turn editing on|turn editing on]] and off with a button on the course homepage. The student view/change roles option allows the teacher to get a general idea of what students will see. There is also an "editing on" link in the [[Administration block|administration block]]. The turn editing option toggles between on and off, and when on, shows a variety of editing icons next to all editable objects in the course. Here are some common editing icons, for more details about them [[Adding/editing_a_course#Editing_a_course|go to adding/editing a course]]. To ADD items you must use the appropriate drop-downs for them.

{| border="1" cellpadding="2" cellspacing="0"
!width="30"|Icon
!width="120"|Effect
!width="30"|Icon
!width="120"|Effect
!width="30"|Icon
!width="120"|Effect
!width="30"|Icon
!width="140"|Effect
|-
|[[Image:Edit.gif]]|| Edit item ||[[Image:Open.gif]]* || Close/Hide item||[[Image:Delete.gif]]** || Delete/Remove ||[[Image:Move.gif]] ||Move (up/down)
|-
||[[Image:All.gif]] ||See all weeks/topics||[[Image:Closed.gif]]* || Open/Show Item ||[[Image:Right.gif]] || Indent/shift right ||[[Image:Movehere.gif]] || Move here
|-
||[[Image:One.gif]] || See one week/topic||[[Image:Help.gif]] ||Help || || ||[[Image:Marker.gif]] ||Make Current (highlight) week/topic
|}
 
'''<nowiki>*</nowiki>''' (Note that the open eye indicates that the resource is visible, while clicking it changes it to be invisible (to students), and vice versa with the closed eye. '''<nowiki>**</nowiki>''' Note that the X deletes resources and activities (with a warning) whereas it only removes blocks (which can be added at any time later)

==Activity modules==
[[Image:Activity dropdown 1 8.JPG|frame|right|Add an activity drop-down menu - Moodle 1.8.2 ]] There are a number of robust interactive learning [[:Category:Modules|activity modules]] that you may [[Adding_resources_and_activities | add to your course]].

Communication and collaboration may take place using live [[Chats]] or asynchronous discussion [[Forums]] for conversational activities. You can also use [[Choices]] to gain group feedback. Adding [[Wikis]] to your courses is an excellent way to allow students to work together on a collaboratively-authored project.

Work can be uploaded and submitted by students and scored by teachers using [[Assignments]] or [[Workshops]]. Workshops such as these have several assessment options, including instructor-assessment, self-assessment, and even peer-assessment. Online [[Quizzes]] offer several options for automatic and manual scoring. You can even integrate your Hot Potato quizzes by adding a [[Hotpot]] activity.

[[Lessons]] and [[SCORM]] activities deliver content and offer ways of individualizing your presentation based upon a student's choices. [[Glossaries]] of keywords can be set up by the instructor, and can be configured to allow students to edit, add, or rate entries.

[[Surveys]] and [[Database module|Databases]] are also very powerful additions to any course.

If all of that isn't enough for you then you can also add [[:Category:Modules (non-standard)|non-standard modules]] that are not part of the official Moodle release!

==Resources==

[[Image:Resource pulldown menu .JPG 1 8.JPG|frame|left|Add a resource drop-down menu]]

Moodle supports a range of different [[Resources|resource types]] that allow you to include almost any kind of digital content into your courses. These can be added by using the [[Adding_resources_and_activities | add a resource]] dropdown box when editing is turned on.

A [[Text page]] is a simple page written using plain text. Text pages aren't pretty, but they're a good place to put some information or instructions. If you are after more options for your new page then you should be thinking about adding a [[Web page]] and making use of Moodle's WYSIWYG editor.

Of course the resource may already exist in electronic form so you may want to [[File or website link|link to an uploaded file or external website]] or simply display the complete contents of a [[Directory|directory]] in your course files and let your users pick the file themselves. If you have an [[IMS content package]] then this can be easily added to your course.

All resources may be organized, structured, and [[Label|labeled]] for usability.

==Blocks==
[[Image:Block add dropdown list teacher 1 8.JPG |thumb|150px|right|Add Block drop-down menu]]
Each course homepage generally contains [[Blocks_%28teacher%29|blocks]] on the left and right with the centre column containing the course content. Blocks may be added, hidden, deleted, and moved up, down and left/right when editing is turned on. Examples of blocks can be seen in the Getting Started image above. [[Latest News block|"Latest News"]], "[[Blogs]]", [[Upcoming Events block|"Upcoming Events"]], and [[Recent Activity block|"Recent Activity"]] are a few examples.

A wide range of [[Blocks_%28teacher%29#Block_types|over 16 different block types]] can provide additional information or functionality to the learner by the teacher. The standard blocks that come with Moodle are shown on the right. There are also many [[:Category:Block (non-standard)|non-standard blocks]] developed by Moodlers that an administrator can add to this list.

A teacher with editing rights will also have a course [[Administration_block|administration block]]. This block has sub menus for course: backup/restore, enrollments, format, reports, grades, activity logs, files and other useful tools.

==General advice==

* Subscribe yourself to all of the [[forum]]s in your course so that you can keep in touch with your class activity.
* Encourage all of the students to fill out their [[Edit profile|user profile]] (including photos) and read them all - this will help provide some context to their later writings and help you to respond in ways that are tailored to their own needs.
* Keep notes to yourself in the private "Teacher's Forum" (under Administration). This is especially useful when team teaching.
* Use the [[Logs]] link (under Administration) to get access to complete, raw logs. In there you'll see a link to a popup window that updates every sixty seconds and shows the last hour of activity. This is useful to keep open on your desktop all day so you can feel in touch with what's going on in the course.
* Use many reports. [[Reports]] in the Administration block, [[Recent_activity|Activity Reports]] (next to each name in the list of all people, or from any user profile page). These provide a great way to see what any particular person has been up to in the course.
* Respond quickly to students. Don't leave it for later - do it right away. Not only is it easy to become overwhelmed with the volume that can be generated, but it's a crucial part of building and maintaining a community feel in your course.
*Don't be afraid to experiment: feel free to poke around and change things. It's hard to break anything in a Moodle course, and even if you do it's usually easy to fix it.
* Use the [[Navigation bar|navigation bar]] at the top of each page - this should help remind you where you are and prevent getting lost

== See also ==
*[[Blogs]] - blogs in Moodle
*[[Teaching with Moodle]] - inspiring links
*[[http://moodle.org/mod/forum/discuss.php?d=66854 Moodle and elearning intro]] - Written by Martin Langhoff
*[[Teaching do's and don'ts]] - hints
*[[Moodle manuals]] - a list of links to manuals and books
*[[Using Moodle book]] - a real book you can reprint!
*[[Teaching FAQ]] - common questions
*[http://moodle.tokem.fi/mod/book/view.php?id=5116&chapterid=256 Example of a course teaching checklist],
*One example of a site specific [[http://moodle.tokem.fi/mod/book/view.php?id=5116 Teacher's Moodle Manual]], done in Moodle with the book module
*[[Tips and tricks]]
*[[Student FAQ]] - students have questions about technology?
*[[Trainer]] - links that might be useful to Trainers

[[Category:Teacher]]
[[cs:Rukověť učitele]]
[[es:Documentación para Profesores]]
[[eu:Irakasleentzako dokumentazioa]]
[[fr:Documentation enseignant]]
[[it:Documentazione per Docenti]]
[[nl:Documentatie voor leraren]]
[[fi:Opettajan opas]]
[[ru:Учителям]]
[[zh:教师文档]]
[[ja:教師ドキュメント]]

Course sections

2007-09-27T22:38:25Z

Mixik: /* Topics format -- fixing an outdated link to Moodle Feature Demo course */

Courses can be divided into sections to organize resources and activities for students. Each section can have a description and can contain many activities and resources as the teacher desires.
==Course section settings==

[[Image:Course_section_formats_1.JPG|frame|left|format pulldown list]]There are several different section formats available in a course. Selecting and changing formats is done in the administration block under the [[Course_settings]] menu, with the format pulldown field.

The example on the left shows the section format choices in Version 1.6.

Earlier versions have fewer selections.

===Weekly format===
[[Image:Weekly section.jpg|thumb|400px|center|''' Example of Weekly outline, edit off''']]
Choosing '''weeks''' from the format selection menu, will automatically fill in the dates, starting with whatever date you specify as your first day for the course, and incrementing each week by seven days thereafter. So if you start your course on Wednesday, each week will run from Wednesday to Tuesday. You may wish to start the week on Sunday or Monday prior to the actual first day of class, so that weeks will reflect the actual work/study week of your lesson (if applicable).
 

===Topics format===
[[Image:Topic sections.jpg|thumb|400px|center|''' Example of topic outline, edit off''']]
Formatting course sections with '''topics''' lends itself to rolling enrollment, or courses whose duration changes often, or where sequence is less important (though these are only suggestions). Often teachers will think about their course in terms of "modules" so topics work well - one topic per module.

Remember that it is possible to have many activities and resources in any given section such as you might see in the Moodle Feature Demo course that can be found [http://demo.moodle.org/course/view.php?id=2 here].
 

==Editing sections==
[[Image:Section_icons_editmode.JPG]] Here is a topic section "1" as seen by the teacher in edit mode. The topic does not have a title but does have a course called "New Lesson Topic 1". For help with understanding the icons go to [[Adding/editing_a_course#Editing_A_Course]].

In edit mode, sections can be moved, hidden from students, highlighted or turned on, plus given titles and descriptions. Also in edit mode it is possible to do many things to a sections [[Activities block|activity]] or [[Resources|resource]].

=== Hiding sections ===
Note that sections can be easily hidden using the eyeball icon. There is a course setting that specifies whether or not these hidden sections are entirely invisible to student/participants, or just show as a horizontal block that says it is unavailable. Such sections will always be full available (greyed out though) to teacher/administrators of the course.

There are also non-standard addin modules such as [[activity locking]] which will reveal an activity or a section only when the student has completed other activities.

A small hack: If you want to have a super-short course that is JUST the top with no section blocks, note that you must have at least one section. The solution is to have one, then make it invisible, and in your settings full hide hidden blocks. Now you have a "one main area" course.

==See also==

*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=16865 Removing topics/blocks from courses] forum discussion

[[Category:Teacher]]

[[es:Secciones del curso]]
[[fr:Sections_de_cours]]
[[ja:コースセクション]]

Moodle in education

2007-09-27T11:17:18Z

Mixik: /* Blocks -- fixing a typo */

==Getting started==
If you are a new user and would like a list of all teacher documentation articles, please see [[:Category:Teacher]].

We are assuming that your site administrator has set up Moodle, you are a user with teacher privileges and the administrator has assigned you to a new, blank course. Don't forget, [http://demo.moodle.org/ demo.moodle.org] will let you play an hour at a time for free.

You will need to be [[Log in | logged into]] the course as a user who has been assigned [[Teacher|a role as a teacher]] (with editing rights) on that course to use most of the features below. We have some tips if you are having [[Can not log in | trouble logging in]].

Now onto the real details. You will find the [[Course homepage|course homepage]] is broken down into [[Course sections|course sections]]. A course is created by [[Adding resources and activities|adding resources and activities]]. When writing text in Moodle you have a range of [[Formatting options]], including using [[HTML editor|HTML in Moodle]]. There are different ways to enroll [[Students]] and assign them to one or more [[Groups]] in a course.

The example below shows a new course set up with topic sections, edit is on. There are a few of Moodle's many [[:Category:Block|blocks]] on the right and left sides of the topics, such as "Latest News" or "[[Administration block|Administration]]". The teacher is already to add resources and activities or a few new blocks to their brand new course.
[[Image:Course edit on new 2.jpg|thumb|center|500px|Getting started image - a new course]]

==Editing course section==
[[Image:Turn_edit_on_Student_on_buttons.JPG]] 
To add or alter activities or resources a teacher will need to [[Turn editing on|turn editing on]] and off with a button on the course homepage. The student view/change roles option allows the teacher to get a general idea of what students will see. There is also an "editing on" link in the [[Administration block|administration block]]. The turn editing option toggles between on and off, and when on, shows a variety of editing icons next to all editable objects in the course. Here are some common editing icons, for more details about them [[Adding/editing_a_course#Editing_a_course|go to adding/editing a course]]. To ADD items you must use the appropriate drop-downs for them.

{| border="1" cellpadding="2" cellspacing="0"
!width="30"|Icon
!width="120"|Effect
!width="30"|Icon
!width="120"|Effect
!width="30"|Icon
!width="120"|Effect
!width="30"|Icon
!width="140"|Effect
|-
|[[Image:Edit.gif]]|| Edit item ||[[Image:Open.gif]]* || Close/Hide item||[[Image:Delete.gif]]* || Delete/Remove ||[[Image:Move.gif]] ||Move (up/down)
|-
||[[Image:All.gif]] ||See all weeks/topics||[[Image:Closed.gif]]* || Open/Show Item ||[[Image:Right.gif]] || Indent/shift right ||[[Image:Movehere.gif]] || Move here
|-
||[[Image:One.gif]] || See one week/topic||[[Image:Help.gif]] ||Help || || ||[[Image:Marker.gif]] ||Make Current (highlight) week/topic
|}
 
*(Note that the open eye indicates that the resource is visible, while clicking it changes it to be invisible (to students), and vice versa with the closed eye. Note that the X deletes resources and activities (with a warning) whereas it only removes blocks (which can be added at any time later)

==Activity modules==

[[Image:Activity_dropdown.JPG|frame|right|Add an activity drop-down menu]]
There are a number of robust interactive learning [[:Category:Modules|activity modules]] that you may [[Adding_resources_and_activities | add to your course]].

Communication and collaboration may take place using [[Chats]] and [[Forums]] for conversational activities and [[Choices]] to gain group feedback. Adding [[Wikis]] to your courses is an excellent way to allow students to work together on a project.

Work can be submitted by students and marked by teachers using [[Assignments]] or [[Workshops]]. The [[Quizzes]] offer several options for automatic scoring. You can even integrate your Hot Potato quizzes by adding a [[Hotpot]] activity.

[[Lessons]] and [[SCORM]] activities deliver content and offer ways of individualizing your presentation based upon a student's choices. Key words can be added to [[Glossaries]] by yourself or, if you allow it, your students.

[[Surveys]] and [[Database module|Databases]] are also very powerful additions to any course.

If all of that isn't enough for you then you can also add [[:Category:Modules (non-standard)|non-standard modules]] that are not part of the official Moodle release!

==Resources==

[[Image:Resource_pulldown_menu.JPG|frame|left|Add a resource drop-down menu]]

Moodle supports a range of different [[Resources|resource types]] that allow you to include almost any kind of digital content into your courses. These can be added by using the [[Adding_resources_and_activities | add a resource]] dropdown box when editing is turned on.

A [[Text page]] is a simple page written using plain text. Text pages aren't pretty, but they're a good place to put some information or instructions. If you are after more options for your new page then you should be thinking about adding a [[Web page]] and making use of Moodle's WYSIWYG editor.

Of course the resource may already exist in electronic form so you may want to [[File or website link|link to an uploaded file or external website]] or simply display the complete contents of a [[Directory|directory]] in your course files and let your users pick the file themselves. If you have an [[IMS content package]] then this can be easily added to your course.

Use a [[Label|label]] to embed instructions or information in the course section.

==Blocks==
[[Image:Block_add_dropdown_list2.JPG |thumb|150px|right|Add Block drop-down menu]]
Each course homepage generally contains [[Blocks_%28teacher%29|blocks]] on the left and right with the centre column containing the course content. Blocks may be added, hidden, deleted, and moved up, down and left/right when editing is turned on. Examples of blocks can be seen in the Getting Started image above. [[Latest News block|"Latest News"]], "[[Blogs]]", [[Upcoming Events block|"Upcoming Events"]], and [[Recent Activity block|"Recent Activity"]] are a few examples.

A wide range of [[Blocks_%28teacher%29#Block_types|over 16 different block types]] can provide additional information or functionality to the learner by the teacher. The standard blocks that come with Moodle are shown on the right. There are also many [[:Category:Block (non-standard)|non-standard blocks]] developed by Moodlers that an administrator can add to this list.

A teacher with editing rights will also have a course [[Administration_block|administration block]]. This block has sub menus for course: backup/restore, enrollments, format, reports, grades, activity logs, files and other useful tools.

==General advice==

* Subscribe yourself to all of the [[forum]]s in your course so that you can keep in touch with your class activity.
* Encourage all of the students to fill out their [[Edit profile|user profile]] (including photos) and read them all - this will help provide some context to their later writings and help you to respond in ways that are tailored to their own needs.
* Keep notes to yourself in the private "Teacher's Forum" (under Administration). This is especially useful when team teaching.
* Use the [[Logs]] link (under Administration) to get access to complete, raw logs. In there you'll see a link to a popup window that updates every sixty seconds and shows the last hour of activity. This is useful to keep open on your desktop all day so you can feel in touch with what's going on in the course.
* Use many reports. [[Reports]] in the Administration block, [[Recent_activity|Activity Reports]] (next to each name in the list of all people, or from any user profile page). These provide a great way to see what any particular person has been up to in the course.
* Respond quickly to students. Don't leave it for later - do it right away. Not only is it easy to become overwhelmed with the volume that can be generated, but it's a crucial part of building and maintaining a community feel in your course.
*Don't be afraid to experiment: feel free to poke around and change things. It's hard to break anything in a Moodle course, and even if you do it's usually easy to fix it.
* Use the [[Navigation bar|navigation bar]] at the top of each page - this should help remind you where you are and prevent getting lost

== See also ==
*[[Blogs]] - blogs in Moodle
*[[Teaching with Moodle]] - inspiring links
*[[http://moodle.org/mod/forum/discuss.php?d=66854 Moodle and elearning intro]] - Written by Martin Langhoff
*[[Teaching do's and don'ts]] - hints
*[[Moodle manuals]] - a list of links to manuals and books
*[[Using Moodle book]] - a real book you can reprint!
*[[Teaching FAQ]] - common questions
*[http://moodle.tokem.fi/mod/book/view.php?id=5116&chapterid=256 Example of a course teaching checklist],
*One example of a site specific [[http://moodle.tokem.fi/mod/book/view.php?id=5116 Teacher's Moodle Manual]], done in Moodle with the book module
*[[Tips and tricks]]
*[[Student FAQ]] - students have questions about technology?
*[[Trainer]] - links that might be useful to Trainers

[[Category:Teacher]]
[[es:Documentación para Profesores]]
[[eu:Irakasleentzako dokumentazioa]]
[[fr:Documentation enseignant]]
[[it:Documentazione per Docenti]]
[[nl:Documentatie voor leraren]]
[[fi:Opettajan opas]]
[[ru:Учителям]]
[[zh:教师文档]]
[[ja:教師ドキュメント]]

Installing Moodle

2006-11-06T13:32:11Z

Mixik: link to cs version added

'''Firstly don't panic! :-)'''

This guide explains how to install Moodle for the first time. For some of these steps it goes into a lot of detail to try and cover the majority of possible web server setups, so this page may look long and complicated. Don't panic, once you know how to do it you can install Moodle in minutes!

If you have problems please read this page carefully - most common issues are answered in here. If you still have trouble, you can seek help from the Moodle community via [http://moodle.org/course/view.php?id=5 moodle.org Using Moodle].

Another option is to contact a [http://moodle.com/hosting/ Moodle Partner providing Moodle hosting] who can completely maintain Moodle for you, so that you can ignore all this and get straight into educating!

==Requirements==

Moodle is primarily developed in Linux using [[Apache]], [[MySQL]] and [[PHP]] (also sometimes known as the LAMP platform), but is also regularly tested with PostgreSQL and on Windows XP, Mac OS X and Netware 6 operating systems.

The requirements for Moodle are as follows:

* Web server software. Most people use [[Apache]], but Moodle should work fine under any web server that supports [[PHP]], such as [[IIS]] on Windows platforms. PHP does impose requirements on versions of web servers, however these are complex and the general advice is to use the newest version possible of your chosen web server.
* PHP scripting language (version 4.1.0 or later). PHP 5 (version 5.1.0 or later) is supported as of Moodle 1.4. (Please note that there have been issues installing Moodle with [http://www.php-accelerator.co.uk PHP-Accelerator]). From Moodle version 1.6, the minimum version of PHP will be 4.3.0 (or 5.1.0).
* a working database server: [[MySQL]] or [[PostgreSQL]] are completely supported and recommended for use with Moodle. MySQL is ''the'' choice for many people because it is very popular, but there are some [[Arguments in favour of PostgreSQL|arguments in favour of PostgreSQL]], especially if you are planning a large deployment. The minimum version of MySql required for Moodle 1.5 is 3.23. Moodle 1.6 requires MySQL 4.1.16 (4.1.12 if you use latin languages only). The minimum version of PostgreSQL is 7.4 and it is widely used with 8.0 and 8.1.
* That the PHP setting "safe mode" be OFF in the php configuration files (php.ini) and in the apache configuration file (generally httpd.config).

Most web hosts support all of this by default. If you are signed up with one of the few webhosts that does not support these features ask them why, and consider taking your business elsewhere.

If you want to run Moodle on your own computer and all this looks a bit daunting, then please see our guide: [[Installing Apache, MySQL and PHP]]. It provides some step-by-step instructions to install all this on most popular platforms.

Additional requirements:

PHP Extensions:
* [http://www.boutell.com/gd/ GD library] and the [http://www.freetype.org/ FreeType 2] library on Linux/Unix boxes to be able to look at the dynamic graphs that the logs pages make.
* mbstring - is required for multi-byte string handling. (iconv is also recommended for Moodle 1.6)
* the mysql extension is required if you are using the MySql database. Note that in some Linux distributions (notably Red Hat) this is an optional installation.
* the pgsql extension is required if you are using the PostgreSQL database.
* the zlib extension is required for zip/unzip functionality
* other PHP extensions may be required to support optional Moodle functionality, especially external authentication and/or enrolment (e.g., LDAP extension)

== Download and copy files into place ==

There are two ways to get Moodle, as a compressed package or via CVS. There are two types of compressed packages on the [http://download.moodle.org/ download page: http://download.moodle.org/], the standard distribution with Moodle only files and the [[Complete install packages|complete install]], which contains programs to operate Moodle in a web environment. Helpful instructions for using [http://moodle.cvs.sourceforge.net/moodle/moodle/ CVS] are at [[CVS_for_Administrators]].

After downloading and unpacking the archive, or checking out the files via CVS, you will be left with a directory called "moodle", containing a number of files and folders.

You can either place the whole folder in your web server documents directory, in which case the site will be located at '''<nowiki>http://yourwebserver.com/moodle</nowiki>''', or you can copy all the contents straight into the main web server documents directory, in which case the site will be simply '''<nowiki>http://yourwebserver.com</nowiki>'''.

If you are downloading Moodle to your local computer and then uploading it to your web site, it is usually better to upload the whole archive as one file, and then do the unpacking on the server. Even web hosting interfaces like Cpanel allow you to uncompress archives in the "File Manager".

== Site structure ==

You can safely skip this section, but here is a quick summary of the contents of the Moodle folder, to help get you oriented:

:''config.php'' - contains basic settings. This file does not come with Moodle - you will create it.
:''install.php'' - the script you will run to create config.php
:''version.php'' - defines the current version of Moodle code
:''index.php'' - the front page of the site
:''admin/'' - code to administrate the whole server
:''auth/'' - plugin modules to authenticate users
:''blocks/'' - plugin modules for the little side blocks on many pages
:''calendar/'' - all the code for managing and displaying calendars
:''course/'' - code to display and manage courses
:''doc/'' - help documentation for Moodle (eg this page)
:''files/'' - code to display and manage uploaded files
:''lang/'' - texts in different languages, one directory per language
:''lib/'' - libraries of core Moodle code
:''login/'' - code to handle login and account creation
:''mod/'' - all the main Moodle course modules are in here
:''pix/'' - generic site graphics
:''theme/'' - theme packs/skins to change the look of the site.
:''user/'' - code to display and manage users

== Run the installer script to create config.php ==

To run the installer script (install.php), just try to access your Moodle main URL using a web browser, or access '''<nowiki>http://yourserver/install.php</nowiki>''' directly.

(The Installer will try to set a session cookie. If you get a popup warning in your browser make sure you accept that cookie!)

Moodle will detect that configuration is necessary and will lead you through some screens to help you create a new configuration file called '''config.php'''. At the end of the process Moodle will try and write the file into the right location, otherwise you can press a button to download it from the installer and then upload '''config.php''' into the main Moodle directory on the server.

Along the way the installer will test your server environment and give you suggestions about how to fix any problems. For most common issues these suggestions should be sufficient, but if you get stuck, look below for more information about some of common things that might be holding you up.

=== Check web server settings ===

Firstly, make sure that your web server is set up to use index.php as a default page (perhaps in addition to index.html, default.htm and so on). In Apache, this is done using a DirectoryIndex parameter in your httpd.conf file. Mine usually looks like this:

'''DirectoryIndex''' index.php index.html index.htm

Just make sure index.php is in the list (and preferably towards the start of the list, for efficiency).

Secondly, '''if you are using Apache 2''', then you should turn on the ''AcceptPathInfo'' variable, which allows scripts to be passed arguments like <nowiki>http://server/file.php/arg1/arg2</nowiki>. This is essential to allow relative links between your resources, and also provides a performance boost for people using your Moodle web site. You can turn this on by adding these lines to your httpd.conf file.

'''AcceptPathInfo''' on

Thirdly, Moodle requires a number of PHP settings to be active for it to work. '''On most servers these will already be the default settings'''. However, some PHP servers (and some of the more recent PHP versions) may have things set differently. These are defined in PHP's configuration file (usually called '''php.ini'''):

magic_quotes_gpc = 1 (preferred but not necessary)
magic_quotes_runtime = 0 (necessary)
file_uploads = 1
session.auto_start = 0
session.bug_compat_warn = 0

If you don't have access to '''httpd.conf''' or '''php.ini''' on your server, or you have Moodle on a server with other applications that require different settings, then don't worry, you can often still OVERRIDE the default settings.

To do this, you need to create a file called '''.htaccess''' in Moodle's main directory that contains lines like the following. This only works on Apache servers and only when Overrides have been allowed in the main configuration.

DirectoryIndex index.php index.html index.htm

<IfDefine APACHE2>
'''AcceptPathInfo''' on
</IfDefine>

php_flag magic_quotes_gpc 1
php_flag magic_quotes_runtime 0
php_flag file_uploads 1
php_flag session.auto_start 0
php_flag session.bug_compat_warn 0

You can also do things like define the maximum size for uploaded files:

LimitRequestBody 0
php_value upload_max_filesize 2M
php_value post_max_size 2M

The easiest thing to do is just copy the sample file from lib/htaccess and edit it to suit your needs. It contains further instructions. For example, in a Unix shell:

cp lib/htaccess .htaccess

=== Creating a database ===

You need to create an empty database (eg "''moodle''") in your database system along with a special user (eg "moodleuser") that has access to that database (and that database only). You could use the "root" user if you wanted to for a test server, but this is not recommended for a production system: if hackers manage to discover the password then your whole database system would be at risk, rather than just one database.

::Bear in mind that currently (as of 1.5.x) Moodle doesn't work with MySQL 5.x's new "STRICT_TRANS_TABLES" setting. So if you are using MySQL 5.x, edit MySQL's configuration file (called "my.ini" in Windows and "my.cnf" on Unix/Linux) and comment out that option (or simply delete it). You have to restart MySQL after changing this setting.

If you are using a webhost, they will probably have a control panel web interface for you to create your database.

The '''Cpanel''' system is one of the most popular of these. To create a database in Cpanel,

# Click on the "'''MySQL Databases'''" icon.
# Type "moodle" in the database field and click "'''Add Database'''".
# Type a username and password (not one you use elsewhere) in the respective fields and click "'''Add User'''".
# Now use the "'''Add User to Database'''" button to give this new user account "'''ALL'''" rights to the new database.
# Note that the username and database names may be prefixed by your Cpanel account name. When entering this information into the Moodle installer - use the full names.

If you have access to Unix command lines then you can do the same sort of thing by typing commands.

Here are some example Unix command lines for MySQL (the red part is for Moodle 1.6 and later, leave it out for Moodle 1.5.x or earlier):

# mysql -u root -p
> CREATE DATABASE moodle DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci;
> GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,INDEX,ALTER ON moodle.*
TO moodleuser@localhost IDENTIFIED BY 'yourpassword';
> quit
# mysqladmin -p reload

If you are using MySQL 4.0.2 or later, you need to specify CREATE TEMPORARY TABLES as well in the GRANT statement:

> GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,CREATE TEMPORARY TABLES,
DROP,INDEX,ALTER ON moodle.*
TO moodleuser@localhost IDENTIFIED BY 'yourpassword';

And some example command lines for PostgreSQL:

# su - postgres
> psql -c "create user moodleuser createdb;" template1
> psql -c "create database moodle with encoding 'unicode';" -U moodleuser template1
> psql -c "alter user moodleuser nocreatedb;" template1
> psql -c "alter user moodleuser with encrypted password 'yourpassword';" template1
> su - root
# /etc/init.d/postgresql reload

=== Creating a data directory ===

Moodle will also need some space on your server's hard disk to store uploaded files, such as course documents and user pictures.

The Moodle installer tries hard to create this directory for you but if it fails then you will have to create a directory for this purpose manually.

For security, it's best that this directory is NOT accessible directly via the web. The easiest way to do this is to simply locate it OUTSIDE the web directory, but if you must have it in the web directory then protect it by creating a file in the data directory called .htaccess, containing this line:

deny from all

To make sure that Moodle can save uploaded files in this directory, check that the web server software (eg Apache) has permission to read, write and execute in this directory.

On Unix machines, this means setting the owner of the directory to be something like "nobody" or "apache", and then giving that user read, write and execute permissions.

To do this you could use:
chown -R nobody:nobody moodledata

Remember by default, mysql won't accept moodle data directories created under ROOT.

On Cpanel systems you can use the "File Manager" to find the folder, click on it, then choose "Change Permissions". On many shared hosting servers, you will probably need to restrict all file access to your "group" (to prevent other webhost customers from looking at or changing your files), but provide full read/write access to everyone else (which will allow the web server to access your files).

Speak to your server administrator if you are having trouble setting this up securely. In particular it will not be possible to create a usable data directory on sites that use a PHP feature known as "Safe Mode."

== Go to the admin page to continue configuration ==

Once the basic config.php has been correctly created in the previous step, trying to access the front page of your site will take you the "admin" page for the rest of the configuration.

The first time you access this admin page, you will be presented with a GPL "shrinkwrap" agreement with which you must agree before you can continue with the setup.

Now Moodle will start setting up your database and creating tables to store data. Firstly, the main database tables are created. You should see a number of SQL statements followed by status messages (in green or red) that look like this:

{| border=1
|<nowiki>CREATE TABLE course ( id int(10) unsigned NOT NULL auto_increment, category int(10) unsigned NOT NULL default '0', password varchar(50) NOT NULL default '', fullname varchar(254) NOT NULL default '', shortname varchar(15) NOT NULL default '', summary text NOT NULL, format tinyint(4) NOT NULL default '1', teacher varchar(100) NOT NULL default 'Teacher', startdate int(10) unsigned NOT NULL default '0', enddate int(10) unsigned NOT NULL default '0', timemodified int(10) unsigned NOT NULL default '0', PRIMARY KEY (id)) TYPE=MyISAM</nowiki>

SUCCESS
|}

...and so on, followed by: Main databases set up successfully.

If you don't see these, then there must have been some problem with the database or the configuration settings you defined in config.php. Check that PHP isn't in a restricted "Safe Mode" (commercial web hosts sometimes have safe mode turned on). You can check PHP variables by creating a little file containing '''<?php phpinfo() ?>''' and looking at it through a browser. Check all these and try this page again.

Scroll down the very bottom of the page and press the "Continue" link.

You should now see a form where you can define more configuration variables for your installation, such as the default language, SMTP hosts and so on. Don't worry too much about getting everything right just now - you can always come back and edit these later on using the admin interface. The defaults are designed to be useful and secure for most sites. Scroll down to the bottom and click "Save changes".

If (and only if) you find yourself getting stuck on this page, unable to continue, then your server probably has what I call the "buggy referrer" problem. This is easy to fix: just turn off the "secureforms" setting, then try to continue again.

Next you will see more pages that print lots of status messages as they set up all the tables required by the various Moodle module. As before, they should all be green.

Scroll down the very bottom of the page and press the "Continue" link.

The next page is a form where you can define parameters for your Moodle site and the front page, such as the name, format, description and so on. Fill this out (you can always come back and change these later) and then press "Save changes".

Finally, you will then be asked to create a top-level administration user for future access to the admin pages. Fill out the details with your own name, email etc and then click "Save changes". Not all the fields are required, but if you miss any important fields you'll be re-prompted for them.

'''Make sure you remember the username and password you chose for the administration user account, as they will be necessary to access the administration page in future.'''

(If for any reason your install is interrupted, or there is a system error of some kind that prevents you from logging in using the admin account, you can usually log in using the default username of "'''admin'''", with password "'''admin'''".)

Once successful, you will be returned to the home page of your new site! Note the administration links that appear down the left hand side of the page (these items also appear on a separate Admin page) - these items are only visible to you because you are logged in as the admin user. All your further administration of Moodle can now be done using this menu, such as:

* creating and deleting courses
* creating and editing user accounts
* administering teacher accounts
* changing site-wide settings like themes etc

But you are not done installing yet! There is one very important thing still to do (see the next section on cron).

== Set up cron ==

Please refer to the [[Cron|cron instructions]].

== Create a new course ==

Now that Moodle is running properly, you can try creating a new course to play with.

Select "Create a new course" from the Admin page (or the admin links on the home page).

Fill out the form, paying special attention to the course format. You don't have to worry about the details too much at this stage, as everything can be changed later by the teacher. Note that the yellow help icons are everywhere to provide contextual help on any aspect.

Press "Save changes", and you will be taken to a new form where you can assign teachers to the course. You can only add existing user accounts from this form - if you want to create a new teacher account then either ask the teacher to create one for themselves (see the login page), or create one for them using the "Add a new user" on the Admin page.

Once done, the course is ready to customise, and is accessible via the "Courses" link on the home page.

==See also==

* [[Installation FAQ]]
* [[Installing Apache, MySQL and PHP]] - Open source programs that can run Moodle on the web or on a desktop
* [[Upgrading Moodle]]
* [[Windows installation| How to install Moodle on a Windows operating system]]
* [[RedHat Linux installation|Step by Step Installation Guide for RedHat]] operating system
* [[Debian GNU/Linux installation|Step by Step Installation Guide for Debian GNU/Linux]] operating system
* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=42688 Selecting a webhost for Moodle] forum discussion
* [[masquerading]] - Running Moodle behind a masquerading/NAT firewall

[[Category:Core]]
[[Category:Administrator]]
[[Category:Installation]]

[[cs:Instalace]]
[[es:Instalación de moodle]]
[[fr:Installation de Moodle]]
[[nl:Installatiegids]]
[[ja:Moodleのインストール]]
[[zh:安装Moodlezh:]]

Mòdul Base de Dades

2006-09-24T22:06:02Z

Mixik:

{{Databases}}
{{Moodle 1.6}}

The '''Database module''' allows the teacher and/or students to build, display and search a bank of record entries about any conceivable topic. The format and structure of these entries can be almost unlimited, including images, files, URLs, numbers and text amongst other things. You may be familiar with similar technology from building Microsoft Access or Filemaker databases.

:'''''Note:''' Please don't confuse this [[Adding resources and activities | activity type]] with Moodle's underlying SQL database, which stores all of the information used in Moodle courses and is only of interest to Moodle [[Administrator documentation | Administrators]].''

== How to use the database module ==
* The first task is to [[Adding/editing_a_database|add the database]]. You will be asked to give it a name, provide some text explaining its intended purpose to users and set a few other options.
* Next you define the kind of [[Fields]] that define the information you wish to collect. For example a database of famous paintings may have a [[picture field]] called ''painting'', for uploading an image file showing the painting, and two [[text fields]] called ''artist'' and ''title'' for the name of the artist and the painting.
* It is then optional to edit the [[Templates|database templates]] to alter the way in which the database displays entries.
* Note that if you later edit the fields in the databases you must use the [[Reset template button]], or manually edit the template, to ensure the new fields are added to the display
* Finally the [[Teacher]] and/or [[Students]] can start entering data and (optionally) commenting on and grading other submissions. These entries can be [[viewed alone]], [[viewed as a list]] or [[searched and sorted]].

== Example databases ==

Moodle.org has three good examples of the database module in action:

* [http://moodle.org/mod/data/view.php?id=6140 Moodle Buzz], a database of the titles, authors and web links to news articles mentioning Moodle
* [http://moodle.org/mod/data/view.php?d=26 Themes], a database with screenshots, download links and user comments about Moodle [[Themes|themes]]
* [http://moodle.org/mod/data/view.php?d=13 Modules and plugins], a database containing a variety of web links (download, documentation, discussion) and info (maintainer, module type, requirements) about the modular components of Moodle, including those created by third parties.

== Creative uses ==

You could use the database module to:

* allow collaboration on building a collection of web links/books/journal references related to a particular subject
* display student created photos/posters/websites/poems for peer comment and review
* gather comments and votes on a shortlist of potential logos/mascot names/project ideas
* provide a [http://moodle.org/mod/forum/discuss.php?d=52699 student file storage area]

== See also ==

* [[Glossary module]], which performs a similar though more specialised, text-based role and is also available for previous versions of Moodle.
* [http://treadwell.cce.cornell.edu/moodle_doc/database_moodle/index.html a screencast introducing the Database Module and walking through creating a database]
[[Category:Teacher]]
[[category:Modules]]
[[fr:Base de données]]
[[cs:Modul Databáze]]

Installations 1000 plus

2006-08-29T17:25:34Z

Mixik: Added: Czech Republic heading; Faculty of Arts, Masaryk Uni

{{Template:Large Installations}}

==Australia==

*Monte Sant' Angelo Mercy College - [http://montenet.monte.nsw.edu.au MonteNet] is used as our colleges student intranet and e-learning portal. Currently running 1.6dev with a few extra custom features thrown in.

*Monte Sant' Angelo Mercy College - [http://compass.monte.nsw.edu.au Compass] takes moodle and uses it for a purpose that is a little outside the square. Compass is used as the staff intranet. Each course is refered to as a "Space" and is used by each departmentr to store meating minutes, agendas and teaching documentation. Communications tools such as forums allow to facilitate better teacher communication and the events are used to keep the teachers events online and targeted (e.g. year 9 teachers all know when excursions are on, all english teachers know when reports are due, etc).

==Belgium==

* KSGWL, Wetteren, Oost-Vlaanderen, 5,000+ 100 courses over 5 moodle installations. Moodle runs on a single server, dual 240 2gig RAM. We do our own hosting at school. Currently we have 800 active users.

==Croatia (Hrvatska)==

*Faculty of philosophy in Zagreb - [http://omega.ffzg.hr Omega sustav ucenja na daljinu] is used as our faculty-wide e-learning system. Currently running 1.6 dev with more than 2200 users and 150+ courses.

==Czech Republic==

*Faculty of Arts, Masaryk University, Brno - [http://www.phil.muni.cz/elf/ ELF], 16,000+ users total, 4,000+ active users in Spring Term 2006, 600+ courses; using Moodle from April 2003.

==Finland==

*Tampere Polytechnic or Tampereen ammattikorkeakoulu ([http://www.tamk.fi www.tamk.fi]), is a around 5000 student college or "a university of applied sciences" located at Tampere, Finland. Our moodle installation hosts around 2500 active students.

*Lahti Polytechnic or Lahden ammattikorkeakoulu is also a "university of applied sciences", located at Lahti, Finland. We have about 5400 students, and a Moodle installation called [http://reppu.lamk.fi Reppu] (Finnish word for "backpack"). We are approaching the 5000 active users mark.

==Netherlands==

* We are a 5000 people school, one server, 9 locations and using Moodle for almost three years now: https://studiewijzerplus.nl Every schoolyear we start again with counting the number of users and the automatic counter (thanks Penny!) is now pointing at 3103

== Russia ==
*Moscow State Institute of International Relations (University) - distance education programme [http://www.globalcompetence.ru Management of Global Processes]

==Spain==
*[http://www.cicei.com CICEI] - Center of Innovation for the Information Society. We have a production [http://cursos.cicei.com Moodle server] having currently 1,042 users in 72 courses covering a wide range of applications (as of February 6, 2006).

==Switzerland==

*[http://moodle.fri-tic.ch/ Centre fri-tic] - Center for ICT Integration of Canton de Fribourg. Currently running 1 moodle for teachers and students from k-12 to High school, with more than 2000 users and about 130 courses. The [http://www.fri-tic.ch/ Centre fri-tic] is also hosting 9 other moodle installations for specific schools.

==United Kingdom==

* [http://moodle.altoncollege.ac.uk/ Alton College] - a Beacon sixth form college with over 2,500 active users.

* [http://egglescliffe.org.uk/ Egglescliffe School and Sixth Form] - a specialist arts school with over 2,000 active moodlers and 345 courses whose usage was the basis of this [http://education.guardian.co.uk/elearning/story/0,,1583832,00.html Guardian article]

* [http://learn.gold.ac.uk Goldsmiths College, London] - over 2,500 active users. See also this [http://www.alt.ac.uk/altc2004/timetable/abstract.php?abstract_id=270 presentation at a 2004 conference].

* [http://www.thanet.ac.uk/ Thanet College] - a "medium sized general FE college", using Moodle as documented in [http://ferl.becta.org.uk/display.cfm?resID=13423 this Ferl case study]

* [http://www.westnotts.ac.uk West Nottingahmshire College] - an FE college in the East Midlands.

* [http://www.lifeintheuk.org Prepare: Life in the United Kingdom Test] - a free website dedicated to Life in the UK Test.

==United States of America==
*[http://www.glyphdoctors.com Glyphdoctors] is a site with over 1200 registered users (as of Feb. 2006) on a shared server host, [http://www.opensourcehost.com Open Source Host]. It will offer online courses in Egyptology and Egyptian hieroglyphs to the general public. Currently, there is one free public course available and a course in Egyptian hieroglyphs under beta testing with a small number of students.

*[http://cs1.mcm.edu/moodle McMurry University]has one Moodle instance, begun as a pilot project in June, 2005. McMurry is a small (1400 FTE) undergraduate-only institution affiliated with the United Methodist church. Currently the instance supports 1700 users (650 active), some 32 instructors, and approximately 50 active courses.

* [http://ahshornets.org Aiken High School]has over 2000 registered users in grades 9 - 12 (Feb. 2006).

* [http://academies.culver.org/moodle The Culver Academies] has over 1000 registered users in grades 9 - 12. The school has been using Moodle in the classroom since the 2002-2003 school year. Administratively we have a Moodle "course" for faculty-only announcements and materials.

[[Category:Administrator]]

{{Template:Large Installations}}

Quiz reports

2006-05-04T17:38:29Z

Mixik: /* Overview */ sorting by two columns added, see http://moodle.org/mod/forum/discuss.php?d=44985

{{Quizzes}}

The quiz '''Results''' tab includes several sub tabs, one for each report. How many tabs you see depends on which [http://moodle.org/mod/data/view.php?d=13&perpage=10&search=Quiz+report&sort=46&order=ASC report plugins] your Moodle administrator has installed. There will be at least the following:

==Overview==

This contains the list of quiz attempts arranged in four columns:

# '''First name / Surname'''
# '''Started on''' - that contains the information about the exact time the test was started
# '''Time taken''' - the amount of time it took a given student to do the test
# '''Grade/x''' - the number of points students scored; 'x' is the maximum number of points students could score

The default view lists only the students who attempted the test. You can, however, change the display settings checking either of the two boxes (followed by clicking Go):

# '''Show students with no attempts''' - the list will include all the course students no matter if they did the test or not
# '''Show mark details''' - this extends the list with as many columns as there are questions in the test; each column is headed by 'n' (where 'n' stands for the question number)

With the Select all / Deselect all options you can check / uncheck all the names in the list, and, with selected, delete.

To sort the results by two columns, first click on the column heading you want to be the '''''second''''' key, and then click on the column heading you want to be the '''''primary''''' key.

==Regrade==

That tab will recalculate the quiz grades. This may become necessary if you have changed one of the questions or the grade possible for the quiz or a question.

==Manual grading==
{{Moodle 1.6}}
Manual grading has so far been implemented for essay questions only

==Item analysis==

This table presents processed quiz data in a way suitable for anayzing and judging the performance of each question for the function of assessment. The statistical parameters used are calculated as explained by classical test theory (ref. 1)

* '''Facility Index (% Correct)'''

This is a measure of how easy or difficult is a question for quiz-takers. It is calculated as:
FI = (Xaverage) / Xmax
where Xaverage is the mean credit obtained by all users attempting the item,
and Xmax is the maximum credit achievable for that item.
If questions can be distributed dicotomically into correct / uncorrect categories, this parameter coincides with the percentage of users that answer the question correctly.

* '''Standard Deviation (SD)'''

This parameter measures the spread of answers in the response population. If all users answers the same, then SD=0. SD is calculated as the statistical stadard deviation for the sample of fractional scores (achieved/maximum) at each particular question.

* '''Discrimination Index (DI)'''

This provides a rough indicator of the performance of each item to separate proficient vs. less-proficient users. This parameter is calculated by first dividing learners into thirds based on the overall score in the quiz. Then the average score at the analyzed item is calculated for the groups of top and bottom performers, and the average scored substracted. The matematical expression is:
DI = (Xtop - Xbottom)/ N
where Xtop is the sum of the fractional credit (achieved/maximum) obtained at this item by the 1/3 of users having tha highest grades in the whole quiz (i.e. number of correct responses in this group),
and Xbottom) is the analog sum for users with the lower 1/3 grades for the whole quiz.

This parameter can take values between +1 and -1. If the index goes below 0.0 it means that more of the weaker learners got the item right than the stronger learners. Such items should be discarded as worthless. In fact, they reduce the accuracy of the overall score for the quiz.

* '''Discrimination Coefficient (DC)'''

This is another measure of the separating power of the item to distinguish proficient from weak learners.
The discrimination coefficient is a correlation coefficient between scores at the item and at the whole quiz. Here it is calculated as:
DC = Sum(xy)/ (N * sx * sy)
where Sun(xy) is the sum of the products of deviations for item scores and overall quiz scores,
N is the number of responses given to this question
sx is the standard deviation of fractional scores for this question and,
sy is the standard deviation of scores at the quiz as a whole.

Again, this parameter can take values between +1 and -1. Positive values indicate items that do discriminate proficient learners, whereas negative indices mark items that are answered best by those with lowest grades. Items with negative DC are answered incorrectly by the seasoned learners and thus they are actually a penalty against the most proficient learners. Those items should be avoided.
The advantage of Discrimination Coefficient vs. Discrimitation Index is that the former uses information from the whole population of learners, not just the extreme upper and lower thirds. Thus, this parameter may be more sensitive to detect item performance.

==See also==

*[[Detailed responses report plugin]]

[[Category:Teacher]]
[[Category:Quiz]]