MoodleDocs - User contributions [en]

Adding/editing an assignment

2009-07-21T23:11:25Z

Meredith25: Added assignment/groups info

{{Assignments}}
An Assignment is an activity that a teacher can select by a pull down menu in a course topic or week section. This page is about the Assignment settings, also found with the Update Assignment button.

==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 ===
When course group mode is turned on, the [[Groups|group mode]] can be one of three levels: no groups, separate groups or visible groups.

;No groups
:There are no groups and all students submit their assignments in one Assignment area

;Separate groups
:Students submit their assignments within a separate Group based submission area and teachers/trainers can sort submissions by Group or view All Participants.

;Visible groups
:All students submits their assignment within a single Assignment area but may choose which Group to associate their submission with before uploading. Teachers/trainers can sort submissions by Group or view All Participants.

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

=== ID number ===
Setting an ID number provides a way of identifying the assignment for grade calculation purposes. If the activity is not included in any grade calculation then the ID number field can be left blank.

==Tips and tricks==
*Want to use an Assignment activity again? Copy the assignment by backing up the course and selecting just the assignment, with or without students and their data. Restore the backup to the same course or to a new course. Move the copied assignment and or edit it.
*Want to use an Assignment activity in another course you teach? Use the import function in the course administration block.

==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

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

Wiki administration

2009-07-21T01:45:42Z

Meredith25: Edit to page flags section, added bulk of content to revert mass changes and added check links section

{{Wiki}}The Administration drop-down menu gives you tools that keep your wiki running smoothly. As you and your class generate the wiki, pages may become orphaned or you may need to manage a student's contributions.

==Set page flags==
Flags are properties that may be assigned to a wiki page that allow you to change the type or behaviour of the page. Page flags available include:

* TXT - flags that the page contains text.
* BIN - flag to indicate the page contains binary
* OFF - disables a page
* HTM - Allows HTML for this page (the general Wiki setting precedes this flag).
* RO - Indicates the page is read only
* WR - Indicates the page is writeable/editable

Using the tickboxes select the required Page flags for each page contained within the wiki.

==Remove pages==
The wiki engine automatically tracks pages that aren't linked from anywhere else (they were created and then the link was deleted) and empty pages. This tool allows you to remove these orphaned wiki pages, which can't be reached through the ordinary wiki interface.

==Strip pages==
While the wiki engine tracks changes, it stores old versions in the database. To declutter the data, you may occasionally want to delete all the old versions and just keep the new one.

==Revert mass changes==
The Revert mass changes tool allows users with appropriate access rights to roll back all changes made to the wiki by a specific user. The following options are available to restrict the revert process to only the effected pages:

===Author field pattern===
Enter the author's IP address or host name in this field. The user's IP address can be found within the Logs report.
Within how many hours from the last change

Specify the number of hours from the last time a page edit was submitted, to be included in the revert process e.g 24, 48 72 etc. This allows you to set a 'set back to' day for restoring a wiki.

===How to operate===

You must choose one of the following options to specify how the revert process should operate based on the specified author's edits:

* (Revert) Only if it was the last change
* Version diving, also delete changes made after - Revert to a previous version and delete all subsequent changes made to that page by the specified author)
* Version diving, but only purge the affected one - Revert to a previous version but only delete the version that the author edited)

===Delete how many last versions===

Specify the number of page versions that should be deleted in the revert process.

==Check links==

This tool checks all http:// links within a specified wiki page for availability/connectivity and resaves the wiki page with the dead links marked for quick review.

[[Category:Teacher]]
[[Category:Wiki]]

[[fr:Administration wiki]]
[[de:Wiki verwalten]]

Wiki standard index pages

2009-07-21T01:41:43Z

Meredith25: Edited site map sectfion, added updated, orphaned and wanted page sections

{{Wiki}}
Wiki has a set of standard pages which contain several indexes. These can be helpful to students and teachers. There is a dropdown menu which shows these different pages.
[[Image:Wiki ChooseWikiLinks pulldown.JPG]]

==Sitemap==
The Sitemap displays a list of all pages within the wiki including the nested or subpage relationship between all pages.

==Page index==
An alphabetical list of page links

== Updated pages ==
The Updated pages index shows a list all pages within your wiki and the date and time they were last edited.

==Orphaned pages==
The Orphaned pages index shows a list all pages within your wiki that have had all links to them subsequently deleted. A check for Orphaned pages should be completed regularly so pages do not 'get lost' within a wiki.

==Wanted pages==
The Wanted pages index shows a list all pages within your wiki that a user has requested be created.

==Export pages==
There are 3 ways to export the wiki, with an option to maintain the wiki links for each. The exported material does not maintain a live link to the wiki, but is a snapshot which can be updated by repeating the operation.
*Downloadable zip archive
**creates a series of individual html files that can be saved on a local drive.
*Module Directory:MoodleGraphics-Lesson
**Creates a directory and places current wiki HTML page files in it. This directory is part of the course files. Thus it can be linked to in the course.
*Module backupdata
**places current wiki HTML page files in the course backup folder. This needs users to be included in the backup otherwise you get a blank wiki.

==See also==
[[Category:Teacher]]
[[Category:Wiki]]

[[de:Wiki Seitenindex]]

Adding Feedback questions

2009-07-21T01:35:06Z

Meredith25:

{{Feedback}}

After setting a new Feedback you design it by '''adding questions'''. Select the type of question from the drop down list in the top left corner then click the ''Add question to activity'' button.
[[Image:Feedbackeditquestionstab.gif]]

== Standard options ==

The following apply to all or most question types.

=== Position ===

This number controls the order of the questions. Position 1 is the question nearest the top of the page, so when you create or edit a question, you can choose from the dropdown of available positions (which will vary depending on how many other questions there are). You can also rearrange questions by clicking the position up and down arrows on the main add questions screen.

=== Required ===

These questions are required to be answered and will prompt the user if they are left unaswered. These questions are highlighted with a red star for users, and have a yellow exclamation point beside them when editing Feedback questions.

== Available question types ==

===Captcha===
An test to make sure a real person is filling in the form and not an automatic spamming program of some sort. Asks a person to write out some distorted text which is displayed on screen. You normally won't need this unless you find you are getting spammed a lot.

=== Multiple choice - multiple answers ===

This will give you a series of options with a checkbox next to each one. The respondent can check as many as they want and there is currently no way to specify a limit to how many they can choose which is lower than the total.

=== Multiple choice - single answer allowed (dropdownlist) ===

This will give you a dropdown list from which only one answer can be selected

=== Dropdownlist (rated) ===

This is similar to the dropdownlist option, except that each option has a numerical value associated with it. This means that if asking a question like:

'''How much do you enjoy being in class?'''
* I love it
* I like it
* It's OK
* I don't like it
* I hate it
it's not possible to (easily) get out an "average" score - particularly if you're asking the same question before and after an event or course. If the Dropdownlist (rated) option is used, then numerical values are associated with each option, allowing an average or other measurements of any responses. The above question might look like:

'''How much do you enjoy being in class?'''
* [5] I love it
* [4] I like it
* [3] It's OK
* [2] I don't like it
* [1] I hate it
which might allow for an average (e.g. "4.5 this term, up from 3.9 last term") to be calculated.

=== Label ===

Similarly to a standard Moodle label, this allows you to add abritrary text between questions allowing for extra explanation or to divide the Feedback into sections.

=== Numeric answer (added in Moodle 1.7) ===
Here, you ask a question which must have a number as an answer and specify the acceptable range e.g. "How many arms would you like, if more than 2 were possible? (please specify 0-10)" with a range of 0-10 set in the options. It helps if you specify the acceptable range in the question text.

=== Picture ===

This question type allows you make a question where users must choose from a range of images as their answer. For example: "Which of these flags is known as the Union Jack?". You write your question and CTRL-Click to choose the images you want. Currently, there seems to be only the option to use flags that are provided with the module. Can other images be used? [[User:Matt Gibson|Matt Gibson]] 04:32, 19 March 2008 (CDT)

=== Multiple choice - single answer ===

This will give you a series of radio buttons, which starts on 'Not selected' and then has your options afterwards. Only one can be chosen and 'Not selected' is a valid answer if the question is not set to 'required'.

=== Radiobutton (rated) ===

This is the same as the Multiple choice one above, but you can allocate a numerical value to each of the answers as well, which makes things a little more quantitative if you intend to analyse the results statistically.

=== Longer Text Answer ===

This option is for creating a text box (you specify how big it will appear in rows and columns) which people can write a long answer into.

=== Short Text Answer ===

This option lets you specify a single line answer, with an input box which is a set number of characters long (you choose). You also specify the maximum number of characters you will accept, so that the answer is not too long and/or does not run over the length of the box on screen.

==See also==
[[Feedback_templates|Feedback Templates]]

[[Category:Feedback]]
[[Category:Teacher]]

Feedback templates

2009-07-21T01:31:57Z

Meredith25: add category

==Overview==
Within the Feedback Module you can create and re-use sets of Feedback questions using the Template tool.

The Templates tab provides the following template features:

==Use a template==

Previously saved Templates will be listed in this area and can be selected using the dropdown menu.

After selecting a Template, Moodle will display a preview of the Feedback questions contained within the Template and confirm Are you sure you want to use this template?

You will also be required to select one of two options:

;Delete old items
:Remove any questions/text types previously added to the Feedback Activity you are viewing before importing items from the selected Template

;Append new items
:Add items stored within the selected template to the current Feedback activity, to any existing questions/text types.

Once you have made your selection click Save changes to copy across the Feedback items or press Cancel to exit from the template copy process.

== Save these questions as a new template ==

After creating a new Feedback activity and populating it with questions, you can save it as a Template for re-use by yourself or others.

When saving a new Template enter a descriptive title in the Name field and choose whether you wish to make this Template available for use by others via the Public tickbox . A Public template may be viewed and re-used by users with appropriate access rights such as administrators and teacher/trainers. When a Public template is used as a basis for a new Feedback, the activity settings and questions within it may be edited by the teacher/trainer, however the original Template remains unchanged.

== Delete Template... ==

To remove a Template you have created or have appropriate permissions to edit, from your Moodle site, use the Delete template... link and click the delete icon next to the corresponding template name.

==Export Questions==

The Export Questions tool allows you to save the questions/text types within your Feedback Activity in .xml format. Clicking the Export questions link will prompt you to Save or Open this file.

==Import Questions==

Where you have previously exported and saved questions from a Feedback activity in .xml format, you can reimport them into a new Feedback activity. The Import questions tool is particularly useful where you need to import questions from a different instance of Moodle and the Template tool is not applicable. After clicking on the Import questions link you will be prompted to select one of the following options:

;Delete old items
:The current questions and all your user's responses will be deleted within the current Feedback activity

;Append new items
:All old questions and the assigned values will be preserved within the current Feedback activity and the imported questions will be added to the existing questions.

Use the Choose a file button to navigate to the course Files area and upload and/or select the relevant .xml file. Once selected use the Import from this file button to import the questions or use Cancel to return to the Templates general tab.

[[Category:Feedback]]

Feedback templates

2009-07-21T01:31:10Z

Meredith25: Formatting updates

Feedback templates

2009-07-21T01:29:35Z

Meredith25: Created page! Will need redirection from mod/ page

==Overview==
Within the Feedback Module you can create and re-use sets of Feedback questions using the Template tool.

The Templates tab provides the following template features:

==Use a template==

Previously saved Templates will be listed in this area and can be selected using the dropdown menu.

After selecting a Template, Moodle will display a preview of the Feedback questions contained within the Template and confirm Are you sure you want to use this template?

You will also be required to select one of two options:

;Delete old items
:Remove any questions/text types previously added to the Feedback Activity you are viewing before importing items from the selected Template

;Append new items
:Add items stored within the selected template to the current Feedback activity, to any existing questions/text types.

Once you have made your selection click Save changes to copy across the Feedback items or press Cancel to exit from the template copy process.

== Save these questions as a new template ==

After creating a new Feedback activity and populating it with questions, you can save it as a Template for re-use by yourself or others.

When saving a new Template enter a descriptive title in the Name field and choose whether you wish to make this Template available for use by others via the Public tickbox . A Public template may be viewed and re-used by users with appropriate access rights such as administrators and teacher/trainers. When a Public template is used as a basis for a new Feedback, the activity settings and questions within it may be edited by the teacher/trainer, however the original Template remains unchanged.

== Delete Template... ==

To remove a Template you have created or have appropriate permissions to edit, from your Moodle site, use the Delete template... link and click the delete icon ( Delete ) next to the corresponding template name.

==Export Questions==

The Export Questions tool allows you to save the questions/text types within your Feedback Activity in .xml format. Clicking the Export questions link will prompt you to Save or Open this file.

==Import Questions==

Where you have previously exported and saved questions from a Feedback activity in .xml format, you can reimport them into a new Feedback activity. The Import questions tool is particularly useful where you need to import questions from a different instance of Moodle and the Template tool is not applicable. After clicking on the Import questions link you will be prompted to select one of the following options:

;Delete old items
:The current questions and all your user's responses will be deleted within the current Feedback activity

;Append new items
:All old questions and the assigned values will be preserved within the current Feedback activity and the imported questions will be added to the existing questions.

Use the Choose a file button to navigate to the course Files area and upload and/or select the relevant .xml file. Once selected use the Import from this file button to import the questions or use Cancel to return to the Templates general tab.

Certificate module

2009-07-21T00:31:32Z

Meredith25: /* See also */ adding new add/edit and view pages

The '''Certificate module''' creates PDF certificates/diplomas for students of the course and is completely customizable. You can add borders, watermarks, seals and even show grade information. A contributed module, it was originally created by Hugo Salgado, July, 2004, updated by David T. Cannon, July, 2005 to use FPDF and include printing grades, updated and currently maintained by [http://moodle.org/user/view.php?id=3239&course=5 Chardelle Busch] to include backup/restore, types, reporting, emailing, unicode support, etc.

There are different certificate modules for 1.6 and 1.7. They are not compatible. These instructions were written for 1.6. Chardelle Busch has made sure Certificate is updated for
every version through 1.9. The 1.9 version has a few more printing features and has expanded the number of activities upon which the teacher can set conditions for issuing a certificate to a student.

==Certificate companions==
===Certificate Site-wide Report===
As of February 2008, there is a '''Certificate Site-wide Report''' which can be added in Moodle 1.9, as a supplement. This is an add-on to the certificate module--if installed, you will have an option when creating a certificate to send that certificate's info to the report. An optional block is included that provides a link to the report. Students will see a list of all received certificates. Administrators (or those who have the capability of viewing site reports) will see a link on the Certificate Report page to view/download a report of all students' received certificates. To install: Place the certificates folder in your root (main) moodle folder and upload to your server. Place the my_certificates block folder under your moodle/blocks folder, upload to your server and click on the Administration>>Notifications link to install.

===Certificate Verification Block===
A companion to the Certificate module for Moodle 1.9. This is a block with a form for entering a given certificate code for verification. The verification page shows the student name, course name, date received and grade (if a grade is printed on the certificate). The certificate code can be printed on a certificate.

This feature is useful when a Registrar, supervisor or administrator wishes to verify that the printed certificate is valid for that student. To install: Place the verify_certificate block folder under your moodle/blocks folder, upload to your server and click on the Administration>>Notifications link to install.

==Installing==
#Download and Unpack the Certificate zip file in a temporary area,
#Copy the "certificate" folder to your moodle mod folder located for example at yourhost\moodle\mod . This will include folders db, lang and all the subfolders located under pics.
#Note: It is not necessary to move the lang file into the Moodle lang folder, the certificate lang folder can stay in the mod/certificate folder.
#Go to your Moodle, and click on the Notifications link in the administation block. Moodle knows something has been added and it will proceed to install the certificate module.

See also: [[Installing_contributed_modules_or_plugins]] in MoodleDocs.

==Settings==
Help buttons give more information about each setting.

==Tips & Tricks==
===Certificate icon location===
If you are using your own theme you have to put the icon.gif inside a folder called certificate and put in your mod folder image. For example, if your theme uses custom icons, you must put a certificate folder with the certificate icon.gif in it under your theme/pix/mod folder.

===Lesson dependency trick 1===

The best trick to enable a conditional certificate is to upgrade to Moodle 1.9 and use the new Certificate version. The 1.9 Certificate allows the teacher to set a dependency on different activities.

Many Moodlers issue a certificate upon successful completion of a course. For those who use Questions in a Lesson to determine if a student can receive a certificate, here is one way to hide the certificate until the student passes. At the end of a lesson we will provide the student an option to select a link that will print a hidden certificate activity. The only non standard Moodle feature this uses is the Certificate module itself. [[Adding/editing_a_lesson#Dependent_on |Lesson dependency]] is available from 1.6 onward.

*Create a Certificate activity. Hide it.
*Create a lesson. We will call it "Certificate Qualification". This is the lesson that needs to be passed to get a certificate. We might add questions to this lesson as a means to automatically determine that student qualifies for a certificate.
*Create another lesson. We will call it "Certificate Gateway". In lesson settings make it [[Adding/editing_a_lesson#Dependent_on |dependent]] upon the "Certificate Qualification". For example we might say a student must answer 80% of the questions correctly. Still in lesson setting go to the [[Adding/editing_a_lesson#Link_to_activity |link to activity setting]] and link it to Certificate.

Student view of the above example. The student will see a course with 2 lessons. If they try to enter the Certificate Gateway Lesson, first, they will be told that they must pass the Certificate Qualification Lesson with a score of 80% or higher. When the student takes the Certificate Qualification Lesson and only scores 70%, they will not be able to take the Certificate Gateway Lesson. The only way they can get to the certificate is to qualify to take the Certificate Gateway Lesson.

'''Important Note''': For this trick to work you must have Show Grades set to Yes in the Course settings page or this trick won't work (and you'll get very frustrated wondering why :) )

==Customizing==

NOTE: Before doing any changes to code:

1. Try it on a local testing install first, if possible.
2. In Administration>>Server set debugging to maximum (to show any coding error messages).
3. After each change to the code (for example, after adding a new string to the certificate lang file), go to your course page and click on a certificate to test.

'''A Custom Type:'''

You can create your own custom certificate type to choose when adding a certificate to a course. This is a good idea so you won't lose your changes when upgrading.

1. Choose the certificate/type folder with the size/orientation you desire, copy and paste it and give it a new name, e.g. 'mycertificate'.

2. Open the certificate/lang/en_utf8/certificate.php file and add the name of your new type, e.g.:

$string['typemycertificate'] = 'My Certificate';

Now, when you add a certificate to a course, you can choose your new type.

'''Adding Images:'''

To add your own image, place it in the appropriate mod/certificate/pix folder and upload it to your site. NOTE: Images must be in either jpeg or PNG 8 formats only! Your image will now appear in the dropdown corresponding to its folder.

'''Getting Print Quality Images and/or to modify the location:'''
If you place images of the same size and resolution as those in the certificate/pix/seals or certificate/pix/signatures folders they should fit in the existing places on the model certificates. This is an easy way to add your custom logo or signature files. However if you use a print quality (e.g. 300 dpi) image for either, it will show up as an enormous image on your certificate. You can move the location of the image by changing the numbers in the two lines of code shown below (the first for "seals" or logos; the second for the "signature" image). The first number in each line dictates the X (left/right) position on the page. The second number dictates the Y (up/down) position on the page. The numbers determine the upper left portion of the image; a larger number moves the image right or down. If you add a second set of numbers to each line (fill in where the paired apostrophes are after 425 or 440) you can control the size of the image. So the 3rd number in the set of four indicates the horizontal size while the 4th number in the set determines the vertical size. You will need to add the second set of numbers if you want to use print quality images.

In the certificate/type/’type your are using’/certificate.php file look for the following lines:

<code php>print_seal($certificate->printseal, $orientation, 590, 425, '', '');

print_signature($certificate->printsignature, $orientation, 130, 440, '', '');</code>

'''Changing Printed Text:'''

There are different lang strings in the certificate/lang/en_utf8/certificate.php file for each certificate type, so be sure to change the correct one for the type you are using (or create your own custom type--see above). For example, if you want to customize the text for the landscape type, you can change these lines in the above mentioned lang file:

Default:

$string['titlelandscape'] = 'CERTIFICATE of ACHIEVEMENT'; 
$string['introlandscape'] = 'This is to certify that'; 
$string['statementlandscape'] = 'has completed the course';

Customized:

$string['statementlandscape'] = 'has successfully passed the final exam';

'''Adding a New Line of Text:'''

1. Open the certificate/lang/en_utf8/certificate.php file and add your new lang string giving it a unique name, e.g.:
$string['mynewtext'] = 'This is what I want to print on the certificate';

2. Open the file for your certificate type, e.g. certificate/type/landscape/certificate.php. At the bottom of the page below '// Add Text' is the code that prints--you guessed it--text on the certificate. Find the current line below which you would like your new text to be printed. For example, if you want your text to print below the course name, find the line:

cert_printtext(170, 330, 'C', 'Helvetica', '', 20, utf8_decode($classname));

3. Add a new line below that to print your new text using the name you gave your new lang string like this:

cert_printtext(170, 350, 'C', 'Helvetica', '', 20, utf8_decode(get_string('mynewtext', 'certificate')));

4. You can adjust the placement over from the left by increasing or decreasing the '170' number.
You can adjust the placement down on the page by increasing or decreasing the '350' number.
Changing 'C' to 'L' or 'R' will print on the left or right side.
For different fonts, see the moodle/lib/fpdf font folder for non-unicode types, and the moodle/lib/tcpdf/fonts folder for unicode types, for available fonts. (NOTE: for unicode certificates, using more than one font is NOT recommended since the entire font gets embedded in the certificate--increasing the certificate file size.)
In the '' after the font name, you can add 'B' for bold, 'I' for italic, or 'U' for underline.
Changing the '10' number will change the font size.

'''Printing Info from a Profile Field:'''

You can easily add additional personal student information to print on a certificate.

1. Choose one of the user profile fields for your info, good choices are: ID Number, Institution or Department.

2. Same as step 2 from 'Adding a New Line of Text' above.

3. Add a new line below that to print your info like this:

cert_printtext(170, 350, 'C', 'Times', '', 10, utf8_decode($USER->idnumber));

Or, change idnumber to institution, or department.

4. Same as step 4 from 'Adding a New Line of Text' above.

==See also==
* [[mod/certificate/mod|Add/Edit Certificate]]
* [[mod/certificate/view|Viewing a Certificate]]

The links below will lead to the current download areas

* Moodle.org link [http://moodle.org/mod/data/view.php?d=13&rid=683 Certificate at Modules and plugins]
* Moodle.org link [http://promoodle.com/index.php?option=com_docman&task=cat_view&gid=16&Itemid=67 Certificate Sitewide Reports at Modules and plugins]
* Moodle.org link [http://promoodle.com/index.php?option=com_docman&task=cat_view&gid=16&Itemid=67 Certificate Validation Block at Modules and plugins]

* Using Moodle [http://moodle.org/mod/forum/view.php?id=7163 Certificate module] forum
* [[Activity_Locking]] - a conditional dependency add-in
* [[Development:Certificate Module|Development of the certificate module]]
* [http://tracker.moodle.org/browse/CONTRIB-334 Patch to enable linking] to [[Face-to-face module|Face-to-Face]] contributed module.

[[Category:Contributed code]]

[[es:Certificate]]

Certificate module

2009-07-21T00:29:37Z

Meredith25: /* See also */

The '''Certificate module''' creates PDF certificates/diplomas for students of the course and is completely customizable. You can add borders, watermarks, seals and even show grade information. A contributed module, it was originally created by Hugo Salgado, July, 2004, updated by David T. Cannon, July, 2005 to use FPDF and include printing grades, updated and currently maintained by [http://moodle.org/user/view.php?id=3239&course=5 Chardelle Busch] to include backup/restore, types, reporting, emailing, unicode support, etc.

There are different certificate modules for 1.6 and 1.7. They are not compatible. These instructions were written for 1.6. Chardelle Busch has made sure Certificate is updated for
every version through 1.9. The 1.9 version has a few more printing features and has expanded the number of activities upon which the teacher can set conditions for issuing a certificate to a student.

==Certificate companions==
===Certificate Site-wide Report===
As of February 2008, there is a '''Certificate Site-wide Report''' which can be added in Moodle 1.9, as a supplement. This is an add-on to the certificate module--if installed, you will have an option when creating a certificate to send that certificate's info to the report. An optional block is included that provides a link to the report. Students will see a list of all received certificates. Administrators (or those who have the capability of viewing site reports) will see a link on the Certificate Report page to view/download a report of all students' received certificates. To install: Place the certificates folder in your root (main) moodle folder and upload to your server. Place the my_certificates block folder under your moodle/blocks folder, upload to your server and click on the Administration>>Notifications link to install.

===Certificate Verification Block===
A companion to the Certificate module for Moodle 1.9. This is a block with a form for entering a given certificate code for verification. The verification page shows the student name, course name, date received and grade (if a grade is printed on the certificate). The certificate code can be printed on a certificate.

This feature is useful when a Registrar, supervisor or administrator wishes to verify that the printed certificate is valid for that student. To install: Place the verify_certificate block folder under your moodle/blocks folder, upload to your server and click on the Administration>>Notifications link to install.

==Installing==
#Download and Unpack the Certificate zip file in a temporary area,
#Copy the "certificate" folder to your moodle mod folder located for example at yourhost\moodle\mod . This will include folders db, lang and all the subfolders located under pics.
#Note: It is not necessary to move the lang file into the Moodle lang folder, the certificate lang folder can stay in the mod/certificate folder.
#Go to your Moodle, and click on the Notifications link in the administation block. Moodle knows something has been added and it will proceed to install the certificate module.

See also: [[Installing_contributed_modules_or_plugins]] in MoodleDocs.

==Settings==
Help buttons give more information about each setting.

==Tips & Tricks==
===Certificate icon location===
If you are using your own theme you have to put the icon.gif inside a folder called certificate and put in your mod folder image. For example, if your theme uses custom icons, you must put a certificate folder with the certificate icon.gif in it under your theme/pix/mod folder.

===Lesson dependency trick 1===

The best trick to enable a conditional certificate is to upgrade to Moodle 1.9 and use the new Certificate version. The 1.9 Certificate allows the teacher to set a dependency on different activities.

Many Moodlers issue a certificate upon successful completion of a course. For those who use Questions in a Lesson to determine if a student can receive a certificate, here is one way to hide the certificate until the student passes. At the end of a lesson we will provide the student an option to select a link that will print a hidden certificate activity. The only non standard Moodle feature this uses is the Certificate module itself. [[Adding/editing_a_lesson#Dependent_on |Lesson dependency]] is available from 1.6 onward.

*Create a Certificate activity. Hide it.
*Create a lesson. We will call it "Certificate Qualification". This is the lesson that needs to be passed to get a certificate. We might add questions to this lesson as a means to automatically determine that student qualifies for a certificate.
*Create another lesson. We will call it "Certificate Gateway". In lesson settings make it [[Adding/editing_a_lesson#Dependent_on |dependent]] upon the "Certificate Qualification". For example we might say a student must answer 80% of the questions correctly. Still in lesson setting go to the [[Adding/editing_a_lesson#Link_to_activity |link to activity setting]] and link it to Certificate.

Student view of the above example. The student will see a course with 2 lessons. If they try to enter the Certificate Gateway Lesson, first, they will be told that they must pass the Certificate Qualification Lesson with a score of 80% or higher. When the student takes the Certificate Qualification Lesson and only scores 70%, they will not be able to take the Certificate Gateway Lesson. The only way they can get to the certificate is to qualify to take the Certificate Gateway Lesson.

'''Important Note''': For this trick to work you must have Show Grades set to Yes in the Course settings page or this trick won't work (and you'll get very frustrated wondering why :) )

==Customizing==

NOTE: Before doing any changes to code:

1. Try it on a local testing install first, if possible.
2. In Administration>>Server set debugging to maximum (to show any coding error messages).
3. After each change to the code (for example, after adding a new string to the certificate lang file), go to your course page and click on a certificate to test.

'''A Custom Type:'''

You can create your own custom certificate type to choose when adding a certificate to a course. This is a good idea so you won't lose your changes when upgrading.

1. Choose the certificate/type folder with the size/orientation you desire, copy and paste it and give it a new name, e.g. 'mycertificate'.

2. Open the certificate/lang/en_utf8/certificate.php file and add the name of your new type, e.g.:

$string['typemycertificate'] = 'My Certificate';

Now, when you add a certificate to a course, you can choose your new type.

'''Adding Images:'''

To add your own image, place it in the appropriate mod/certificate/pix folder and upload it to your site. NOTE: Images must be in either jpeg or PNG 8 formats only! Your image will now appear in the dropdown corresponding to its folder.

'''Getting Print Quality Images and/or to modify the location:'''
If you place images of the same size and resolution as those in the certificate/pix/seals or certificate/pix/signatures folders they should fit in the existing places on the model certificates. This is an easy way to add your custom logo or signature files. However if you use a print quality (e.g. 300 dpi) image for either, it will show up as an enormous image on your certificate. You can move the location of the image by changing the numbers in the two lines of code shown below (the first for "seals" or logos; the second for the "signature" image). The first number in each line dictates the X (left/right) position on the page. The second number dictates the Y (up/down) position on the page. The numbers determine the upper left portion of the image; a larger number moves the image right or down. If you add a second set of numbers to each line (fill in where the paired apostrophes are after 425 or 440) you can control the size of the image. So the 3rd number in the set of four indicates the horizontal size while the 4th number in the set determines the vertical size. You will need to add the second set of numbers if you want to use print quality images.

In the certificate/type/’type your are using’/certificate.php file look for the following lines:

<code php>print_seal($certificate->printseal, $orientation, 590, 425, '', '');

print_signature($certificate->printsignature, $orientation, 130, 440, '', '');</code>

'''Changing Printed Text:'''

There are different lang strings in the certificate/lang/en_utf8/certificate.php file for each certificate type, so be sure to change the correct one for the type you are using (or create your own custom type--see above). For example, if you want to customize the text for the landscape type, you can change these lines in the above mentioned lang file:

Default:

$string['titlelandscape'] = 'CERTIFICATE of ACHIEVEMENT'; 
$string['introlandscape'] = 'This is to certify that'; 
$string['statementlandscape'] = 'has completed the course';

Customized:

$string['statementlandscape'] = 'has successfully passed the final exam';

'''Adding a New Line of Text:'''

1. Open the certificate/lang/en_utf8/certificate.php file and add your new lang string giving it a unique name, e.g.:
$string['mynewtext'] = 'This is what I want to print on the certificate';

2. Open the file for your certificate type, e.g. certificate/type/landscape/certificate.php. At the bottom of the page below '// Add Text' is the code that prints--you guessed it--text on the certificate. Find the current line below which you would like your new text to be printed. For example, if you want your text to print below the course name, find the line:

cert_printtext(170, 330, 'C', 'Helvetica', '', 20, utf8_decode($classname));

3. Add a new line below that to print your new text using the name you gave your new lang string like this:

cert_printtext(170, 350, 'C', 'Helvetica', '', 20, utf8_decode(get_string('mynewtext', 'certificate')));

4. You can adjust the placement over from the left by increasing or decreasing the '170' number.
You can adjust the placement down on the page by increasing or decreasing the '350' number.
Changing 'C' to 'L' or 'R' will print on the left or right side.
For different fonts, see the moodle/lib/fpdf font folder for non-unicode types, and the moodle/lib/tcpdf/fonts folder for unicode types, for available fonts. (NOTE: for unicode certificates, using more than one font is NOT recommended since the entire font gets embedded in the certificate--increasing the certificate file size.)
In the '' after the font name, you can add 'B' for bold, 'I' for italic, or 'U' for underline.
Changing the '10' number will change the font size.

'''Printing Info from a Profile Field:'''

You can easily add additional personal student information to print on a certificate.

1. Choose one of the user profile fields for your info, good choices are: ID Number, Institution or Department.

2. Same as step 2 from 'Adding a New Line of Text' above.

3. Add a new line below that to print your info like this:

cert_printtext(170, 350, 'C', 'Times', '', 10, utf8_decode($USER->idnumber));

Or, change idnumber to institution, or department.

4. Same as step 4 from 'Adding a New Line of Text' above.

==See also==
The links below will lead to the current download areas

* Moodle.org link [http://moodle.org/mod/data/view.php?d=13&rid=683 Certificate at Modules and plugins]
* Moodle.org link [http://promoodle.com/index.php?option=com_docman&task=cat_view&gid=16&Itemid=67 Certificate Sitewide Reports at Modules and plugins]
* Moodle.org link [http://promoodle.com/index.php?option=com_docman&task=cat_view&gid=16&Itemid=67 Certificate Validation Block at Modules and plugins]

* Using Moodle [http://moodle.org/mod/forum/view.php?id=7163 Certificate module] forum
* [[Activity_Locking]] - a conditional dependency add-in
* [[Development:Certificate Module|Development of the certificate module]]
* [http://tracker.moodle.org/browse/CONTRIB-334 Patch to enable linking] to [[Face-to-face module|Face-to-Face]] contributed module.

[[Category:Contributed code]]

[[es:Certificate]]

Certificate module

2009-07-21T00:29:17Z

Meredith25:

The '''Certificate module''' creates PDF certificates/diplomas for students of the course and is completely customizable. You can add borders, watermarks, seals and even show grade information. A contributed module, it was originally created by Hugo Salgado, July, 2004, updated by David T. Cannon, July, 2005 to use FPDF and include printing grades, updated and currently maintained by [http://moodle.org/user/view.php?id=3239&course=5 Chardelle Busch] to include backup/restore, types, reporting, emailing, unicode support, etc.

There are different certificate modules for 1.6 and 1.7. They are not compatible. These instructions were written for 1.6. Chardelle Busch has made sure Certificate is updated for
every version through 1.9. The 1.9 version has a few more printing features and has expanded the number of activities upon which the teacher can set conditions for issuing a certificate to a student.

==Certificate companions==
===Certificate Site-wide Report===
As of February 2008, there is a '''Certificate Site-wide Report''' which can be added in Moodle 1.9, as a supplement. This is an add-on to the certificate module--if installed, you will have an option when creating a certificate to send that certificate's info to the report. An optional block is included that provides a link to the report. Students will see a list of all received certificates. Administrators (or those who have the capability of viewing site reports) will see a link on the Certificate Report page to view/download a report of all students' received certificates. To install: Place the certificates folder in your root (main) moodle folder and upload to your server. Place the my_certificates block folder under your moodle/blocks folder, upload to your server and click on the Administration>>Notifications link to install.

===Certificate Verification Block===
A companion to the Certificate module for Moodle 1.9. This is a block with a form for entering a given certificate code for verification. The verification page shows the student name, course name, date received and grade (if a grade is printed on the certificate). The certificate code can be printed on a certificate.

This feature is useful when a Registrar, supervisor or administrator wishes to verify that the printed certificate is valid for that student. To install: Place the verify_certificate block folder under your moodle/blocks folder, upload to your server and click on the Administration>>Notifications link to install.

==Installing==
#Download and Unpack the Certificate zip file in a temporary area,
#Copy the "certificate" folder to your moodle mod folder located for example at yourhost\moodle\mod . This will include folders db, lang and all the subfolders located under pics.
#Note: It is not necessary to move the lang file into the Moodle lang folder, the certificate lang folder can stay in the mod/certificate folder.
#Go to your Moodle, and click on the Notifications link in the administation block. Moodle knows something has been added and it will proceed to install the certificate module.

See also: [[Installing_contributed_modules_or_plugins]] in MoodleDocs.

==Settings==
Help buttons give more information about each setting.

==Tips & Tricks==
===Certificate icon location===
If you are using your own theme you have to put the icon.gif inside a folder called certificate and put in your mod folder image. For example, if your theme uses custom icons, you must put a certificate folder with the certificate icon.gif in it under your theme/pix/mod folder.

===Lesson dependency trick 1===

The best trick to enable a conditional certificate is to upgrade to Moodle 1.9 and use the new Certificate version. The 1.9 Certificate allows the teacher to set a dependency on different activities.

Many Moodlers issue a certificate upon successful completion of a course. For those who use Questions in a Lesson to determine if a student can receive a certificate, here is one way to hide the certificate until the student passes. At the end of a lesson we will provide the student an option to select a link that will print a hidden certificate activity. The only non standard Moodle feature this uses is the Certificate module itself. [[Adding/editing_a_lesson#Dependent_on |Lesson dependency]] is available from 1.6 onward.

*Create a Certificate activity. Hide it.
*Create a lesson. We will call it "Certificate Qualification". This is the lesson that needs to be passed to get a certificate. We might add questions to this lesson as a means to automatically determine that student qualifies for a certificate.
*Create another lesson. We will call it "Certificate Gateway". In lesson settings make it [[Adding/editing_a_lesson#Dependent_on |dependent]] upon the "Certificate Qualification". For example we might say a student must answer 80% of the questions correctly. Still in lesson setting go to the [[Adding/editing_a_lesson#Link_to_activity |link to activity setting]] and link it to Certificate.

Student view of the above example. The student will see a course with 2 lessons. If they try to enter the Certificate Gateway Lesson, first, they will be told that they must pass the Certificate Qualification Lesson with a score of 80% or higher. When the student takes the Certificate Qualification Lesson and only scores 70%, they will not be able to take the Certificate Gateway Lesson. The only way they can get to the certificate is to qualify to take the Certificate Gateway Lesson.

'''Important Note''': For this trick to work you must have Show Grades set to Yes in the Course settings page or this trick won't work (and you'll get very frustrated wondering why :) )

==Customizing==

NOTE: Before doing any changes to code:

1. Try it on a local testing install first, if possible.
2. In Administration>>Server set debugging to maximum (to show any coding error messages).
3. After each change to the code (for example, after adding a new string to the certificate lang file), go to your course page and click on a certificate to test.

'''A Custom Type:'''

You can create your own custom certificate type to choose when adding a certificate to a course. This is a good idea so you won't lose your changes when upgrading.

1. Choose the certificate/type folder with the size/orientation you desire, copy and paste it and give it a new name, e.g. 'mycertificate'.

2. Open the certificate/lang/en_utf8/certificate.php file and add the name of your new type, e.g.:

$string['typemycertificate'] = 'My Certificate';

Now, when you add a certificate to a course, you can choose your new type.

'''Adding Images:'''

To add your own image, place it in the appropriate mod/certificate/pix folder and upload it to your site. NOTE: Images must be in either jpeg or PNG 8 formats only! Your image will now appear in the dropdown corresponding to its folder.

'''Getting Print Quality Images and/or to modify the location:'''
If you place images of the same size and resolution as those in the certificate/pix/seals or certificate/pix/signatures folders they should fit in the existing places on the model certificates. This is an easy way to add your custom logo or signature files. However if you use a print quality (e.g. 300 dpi) image for either, it will show up as an enormous image on your certificate. You can move the location of the image by changing the numbers in the two lines of code shown below (the first for "seals" or logos; the second for the "signature" image). The first number in each line dictates the X (left/right) position on the page. The second number dictates the Y (up/down) position on the page. The numbers determine the upper left portion of the image; a larger number moves the image right or down. If you add a second set of numbers to each line (fill in where the paired apostrophes are after 425 or 440) you can control the size of the image. So the 3rd number in the set of four indicates the horizontal size while the 4th number in the set determines the vertical size. You will need to add the second set of numbers if you want to use print quality images.

In the certificate/type/’type your are using’/certificate.php file look for the following lines:

<code php>print_seal($certificate->printseal, $orientation, 590, 425, '', '');

print_signature($certificate->printsignature, $orientation, 130, 440, '', '');</code>

'''Changing Printed Text:'''

There are different lang strings in the certificate/lang/en_utf8/certificate.php file for each certificate type, so be sure to change the correct one for the type you are using (or create your own custom type--see above). For example, if you want to customize the text for the landscape type, you can change these lines in the above mentioned lang file:

Default:

$string['titlelandscape'] = 'CERTIFICATE of ACHIEVEMENT'; 
$string['introlandscape'] = 'This is to certify that'; 
$string['statementlandscape'] = 'has completed the course';

Customized:

$string['statementlandscape'] = 'has successfully passed the final exam';

'''Adding a New Line of Text:'''

1. Open the certificate/lang/en_utf8/certificate.php file and add your new lang string giving it a unique name, e.g.:
$string['mynewtext'] = 'This is what I want to print on the certificate';

2. Open the file for your certificate type, e.g. certificate/type/landscape/certificate.php. At the bottom of the page below '// Add Text' is the code that prints--you guessed it--text on the certificate. Find the current line below which you would like your new text to be printed. For example, if you want your text to print below the course name, find the line:

cert_printtext(170, 330, 'C', 'Helvetica', '', 20, utf8_decode($classname));

3. Add a new line below that to print your new text using the name you gave your new lang string like this:

cert_printtext(170, 350, 'C', 'Helvetica', '', 20, utf8_decode(get_string('mynewtext', 'certificate')));

4. You can adjust the placement over from the left by increasing or decreasing the '170' number.
You can adjust the placement down on the page by increasing or decreasing the '350' number.
Changing 'C' to 'L' or 'R' will print on the left or right side.
For different fonts, see the moodle/lib/fpdf font folder for non-unicode types, and the moodle/lib/tcpdf/fonts folder for unicode types, for available fonts. (NOTE: for unicode certificates, using more than one font is NOT recommended since the entire font gets embedded in the certificate--increasing the certificate file size.)
In the '' after the font name, you can add 'B' for bold, 'I' for italic, or 'U' for underline.
Changing the '10' number will change the font size.

'''Printing Info from a Profile Field:'''

You can easily add additional personal student information to print on a certificate.

1. Choose one of the user profile fields for your info, good choices are: ID Number, Institution or Department.

2. Same as step 2 from 'Adding a New Line of Text' above.

3. Add a new line below that to print your info like this:

cert_printtext(170, 350, 'C', 'Times', '', 10, utf8_decode($USER->idnumber));

Or, change idnumber to institution, or department.

4. Same as step 4 from 'Adding a New Line of Text' above.

==See also==
The links below will lead to the current download areas

* Moodle.org link [http://moodle.org/mod/data/view.php?d=13&rid=683 Certificate at Modules and plugins]
* Moodle.org link [http://promoodle.com/index.php?option=com_docman&task=cat_view&gid=16&Itemid=67 Certificate Sitewide Reports at Modules and plugins]
* Moodle.org link [http://promoodle.com/index.php?option=com_docman&task=cat_view&gid=16&Itemid=67 Certificate Validation Block at Modules and plugins]

* Using Moodle [http://moodle.org/mod/forum/view.php?id=7163 Certificate module] forum
* [[Activity_Locking]] - a conditional dependency add-in
* [[Development:Certificate Module|Development of the certificate module]]
* [http://tracker.moodle.org/browse/CONTRIB-334 Patch to enable linking] to [[Face-to-face module|Face-to-Face]] contributed module.

[[Category:Contributed code]]
[[Category:Certificate]]
[[es:Certificate]]

mod/certificate/view

2009-07-21T00:28:14Z

Meredith25: Created page! Will need to be moved from mod/ page

=== Viewing a Certificate ===

To generate a Certificate or review a Certificate that has already been issued to you, click on the name of the Certificate on the course page and then on the Get your certificate or Review your certificate button. You will be prompted to open or save the PDF file to your local computer.

For users with teacher or administrator access you can review a report of all issued certificates within a course by clicking on the View issued certificates link.

mod/certificate/mod

2009-07-21T00:25:55Z

Meredith25: Created page! Will need to be moved from mod/ page

=Add/Edit Certificate=

To create a new Certificate select Certificate from the Activities list when viewing a course in Editing On mode. You can customise your Certificate using the following settings:

== General Settings ==

===Certificate Name===
The Certificate Name will appear on the course page and will typically signal to users the purpose or type of Certificate being issued.

===Introduction===
This text will be displayed to users when they open the Certificate activity. An Introduction should be descriptive and indicate to the user the circumstances or requirements surrounding the award of the Certificate.

==Issue Options==

===Email Teachers===

If the Email Teachers option is set to Yes then all users with a Teacher/Trainer role within the course will receive an autogenerated email whenever a student receives a Certificate.

===Email Others===
If there are users within a course that do not have Teacher/Trainer access rights but should be notified when a user receives a Certificate you can enter thier email address in this field. When entering multiple addresses, they should be separated with a comma.

===Delivery===

The Delivery option allows you to choose how students view/receive their Certificate. There are three options:

;Open in Browser
:Opens the Certificate in a new browser window.

;Force Download
:Opens the browser file download window. (Note: Internet Explorer does not currently support the open option from the download window. The save option must be chosen first.)

;Email Certificate
:Choosing this option sends the Certificate to the student as an email attachment (PDF).

===Save Certificates===

By activating the Save Certificates option a copy of each student's Certificate is saved in the course files moddata folder. A link to each student's saved Certificate will also be displayed in the teacher View Issued Certificates report.

==Locking Options==

===Required course grade===

Choose the minimum required percentage course grade (the average grade of all graded activities in the course) that the student must achieve to receive the Certificate. Any activities that are graded using points will be converted to a percentage for calculating the required grade.

===Minimum required minutes in course===

If a Certificate is issued to users based on course participation you can use this option to set the minimum amount of time, in minutes, that a student must be logged into the course before they will be able to receive their Certificate.

===Dependent activities===

If you wish for a Certificate to be issued upon completion of a selection of different course activities, you will need to add them to the Dependent activities area.

Use the Linked Activity dropdown menu and Add another linked activity option button as required to choose the course activities and their respective minimum required percentage grades that must be achieved to receive the certificate. Any activities that are graded using points will be converted to a percentage for calculating the required grade.

You can also choose to lock the certificate based on completion of a Survey, Questionnaire or Feedback activity. For these activities, leave the grade field set to No.

==Text Options==

===Print Date===

Via the Print Date option, you can choose whether to include the date the Certificate was issued to the user, or the course end date, on the Certificate.

===Date Format===

If the Print Date is set to Date Received or the Course End Date, the format of the date can be configured.

===Print Code===

A user unique 10-digit code of random letters and numbers can be printed on the Certificate. This number can then be verified by comparing it to the code number displayed in the teacher View Issued Certificates report.

===Print Grade===

You can choose to print either the total course grade, or the grade of a selected course activity of a user on the Certificate. The grade items are listed in the dropdown menu in the order in which they appear in the Gradebook.

Please note: Once a user has received their Certificate, their grade on the Certificate will not change even if their course grade changes.

===Grade Format===

There are three available formats if you choose to print a grade on the Certificate:

;Percentage Grade
:Prints the grade as a percentage.

;Points Grade
:Prints the point value of the grade.

;Letter Grade
:Prints the percentage grade as a letter.

===Print Outcome===

You can choose any course Outcome name and result on the Certificate. For example 'Assignment Outcome: Proficient'

===Print Credit Hours===

Where a Credit system is in place within a course, the total Credit Hours a user has received may be included on the issued Certificate.

===Print Teacher Name(s)===

If you wish to include the course Teacher name on the Certificate, select Yes under Print Teacher Name(s) and ensure the required staff have been assigned Teacher/Trainer roles at the Certificate Module level.

===Custom Text===
Additional text may be added to the Certificate via the Custom Text field. By default, this text is placed in the lower left of the Certificate.
You can use the text box to enter html, insert links and insert an image,

The following html tags are available:

* and 
* , and 
* < img > (src and width (or height) are mandatory)
* < a > (href is mandatory)
* possible attributes are - colour: hex colour code and face: arial, times, courier, helvetica, symbol

==Design Options==

===Certificate Type===

This is where you determine the layout of the Certificate. There are four default Certificate Types:

;Landscape
:Prints the PDF Certificate on A4 size paper with landscape orientation.

;Landscape Letter
:Prints the Certificate on letter size paper with landscape orientation.

;Portrait
:Prints the Certificate on A4 size paper with portrait orientation.

;Portrait Letter
:Prints the issued Certificate on letter size paper with portrait orientation.

===Border Image===

The Border Image option allows you to choose a border image from the installed options. Select the border image that you want around the Certificate edges or select No border. By default there are two different border images each in 4 different colors. Additional borders can be installed at the database level if required.

===Border Lines===

Instead of a Border Image you can opt for a simple three line Border Line around the edge of the Certificate. By default there are four colour options available. Additional border line colours can be installed at the database level if required.

===Watermark Image===

A Watermark file can be placed in the background of a Certificate. A Watermark could be a specific logo, seal, crest etc. By default two Watermark Images are included, a sample school crest and a Fleur de lis however additional Watermark Images can be installed at the database level if required.

===Signature Image===

This option allows you to print a digital signature or print a line for a written signature, on the Certificate. By default a single sample signature image and a line image are available, however additional signatures can be added as required by your technology providers. By default the Signature Image is placed in the lower left of the Certificate.

===Seal or Logo Image===
This option allows you to select a seal or logo to print on the Certificate from a repository of options. By default four seal images and an example logo image are available. Logos and seals are, by default, placed in the lower right corner of the Certificate. Additional seals and logos may be installed at the database level by your technology providers.

==Common Module Settings==

===Group mode===

A Certificate activity can have the following three Group options:

;No groups
:The issue of the Certificate will not groups based

;Separate groups
:Each group can only see their own Certificate activity but others are invisible

;Visible groups
:Each group can see their own Certificate as well as see the Certificate activity of other groups.

===Visible===
If you choose Show, then students in the course will be able to see this Certificate activity and attempt to generate a Certificate. If you choose Hide, then only users with teacher or administrative permissions in the course or Certificate activity will be able to see it.

When you have create your Certificate select the Save and return to course or Save and display button or click Cancel to return to the course page.

Reset course

2009-07-21T00:01:58Z

Meredith25: Added reset option sections and headings

{{Course admin}}
{{Moodle 1.6}}

== Overview ==

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

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

== General Reset Options ==

You can set a new Course Start Date for the freshly reset course, delete all Calendar events, delete course log report data and delete all user notes attached to the course.

== Role Reset Options ==

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

== Gradebook Reset Options ==

The Gradebook reset options allow you to delete all gradebook items and categories and/or delete all recorded grades within the course. Note that these grades are still recorded against a user's account.

== Group Reset Options ==

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

== Activity Reset Options ==

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

{{Moodle 1.8}}You can remove all attempts from all quizzes.

You can also specify a new course start date.

==See also==

* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=50298 New School Year - old classes] forum discussion
*[[Roll courses forward]]
*Tracker issue [http://tracker.moodle.org/browse/MDL-7028 MDL-7028] - Course Reset fixing - meta
*[[Development:Implementing_Reset_course_functionality_in_a_module|How to implement Reset course functionality in your module]] (for developers).
[[Category:Backup]]

[[ca:Reiniciar curs]]
[[es:Reiniciar curso]]
[[fr:Réinitialisation]]
[[ja:コースのリセット]]
[[nl:course/reset]]
[[de:Kurs zurücksetzen]]

User policies

2009-07-20T23:40:12Z

Meredith25: Added 3 sections

Location: ''Administration > Users > Permissions > User policies'' (in Moodle 1.7 onwards)

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

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

==Default role for all users==

The default role for all users should normally be set to [[Authenticated user]]. If it is set to Student then the result is that all students are enrolled on all courses.

Note: The default role for all users should ''never'' be set to [[Guest]], except in Moodle 1.7, as this version does not have an authenticated user role.

== Default role for users in a course ==

Users who enrol in a course will be automatically assigned the role specified here.

==Auto-login guest==

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

Note: If auto-login guest is set, the guest login button also needs to be set to show (via ''Administration > Users > [[Authentication]]''), even though visitors won't necessarily use it.

==Roles that are not synchronised to metacourses==

[[Metacourses]] combine enrolments from multiple courses. You will probably want users to have the same role in the metacourse as in the normal courses. If not, select the roles which should not be synchronised.

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

Description, city/town, country, web page, ICQ number, Skype ID, Yahoo ID, AIM ID, MSN ID, last access, My courses (in Moodle 1.9.4 onwards) and first access and groups (in Moodle 1.9.5 onwards)

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

==Allow users without the assign roles capability to switch roles==

The [[Capabilities/moodle/role:assign|moodle/role:assign]] capability requirement for users to switch roles may be removed in Moodle 1.9.5 onwards.

==See also==

*[[Front Page settings]] for setting the default front page role in Moodle 1.9 onwards

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

[[fr:Règles Utilisateurs]]
[[ja:ユーザポリシー]]

User profile fields

2009-07-20T23:37:16Z

Meredith25: Added Common settings section and section headings

{{Moodle 1.8}}Location: ''Administration > Users > Accounts > User profile fields''

==Overview==
In Moodle 1.8 onwards, administrators are able to create new user profile categories and fields. Profile fields may be a menu of choices, text area, text input or a checkbox (in Moodle 1.9.3 onwards) and may be required or not.

New profile fields will appear on each user’s profile page unless "Who is this field visible to?" is set to "Not visible" in which case only the administrator can see the field. From Moodle 1.9 the fields can also be displayed on the signup page if "Display on signup page?" is set to "Yes" (although note that they will never be displayed if set to "Not visible").

You can set the order in which your custom profile fields appear under the associated profile category using the up/down arrows on the User profiles fields page.

To Create a new profile field, select the profile field format you require from the dropdown list.

== Common Settings ==

All new fields must be given a unique Short Name and a Name (this is displayed on the profile page). You may also choose to enter a Description for the field for your own reference.

There are also a number of configuration options common to all custom profile field types:

;Is this field required?
:This option specifies whether this is a mandatory or optional field for user accounts.

;Is this field locked?
:This option determines whether once information is populated in this field, it cannot be edited by the user.

;Should the data be unique?
:If you need the information populated in your field to be unique across the system (such as an ID number) select Yes to this option and the profile page update will perform a validation check on the data entered.

;Display on signup page?
:Depending on the authentication method in use on your Moodle site, you may have some users creating their own accounts. If you would like this custom field to appear on the registration or signup page, select Yes.

;Who is this field visible to?
:Each custom field can be given one of three visibility settings:

:* Visible to everyone
:* Not visible
:* Visible to user

:The Not visible setting would typically be set by an administrator who wants to hold private data on the users. The Visible to user setting would normally be selected for a field that holds sensitive information, while the Visible to everyone setting can be used for any type of information.

== Specific Settings ==

There are also a few field type Specific Settings requiring configuration around default value and size.

'''Important'''

If the site administrator bulk [[Upload users|uploads user data]] via .csv file, it is essential to use the correct convention to represent the new profile field. The convention is ''profile_field_shortname''

Replace 'shortname' with the actual short name used for the new profile field eg. dob. So the field should read something like profile_field_dob.

Also, you will need to visit Site Administration > Users > Accounts > User Profile Fields > Create new Profile Field before attempting to upload a file using it. Creating an upload file first with custom profile fields without creating the User Profile Fields first in Site Administration will result in the error profile_field_shortname is not a valid field name.

Furthermore, keep in mind that the shortname must be all lower case to avoid errors when uploading users via a .csv file. This currently is not enforced when creating the shortname. See MDL-17344 for more information.

==Examples of use==

*'''House System'''

Many schools have a 'House' system where students and staff are assigned to a given House. For example, a school has eight houses, named after its founders: Adderton, Coolock, Gorry, Loretto, McAuley, Mercedes, Tighe and Whitty. The site administrator can add a user profile field that offers a 'Menu of choices' to the user. A default value can also be selected. If the administrator decides to bulk upload House data for users via a .csv file, it is important to represent the above array of values as 1,2,3,4,5,6,7,8 in the file. That is to state, if a user belongs to Adderton House, the value '1' should be entered for the 'House' user profile field in the given record.

*'''U.S. States'''

This can be used to improve ambiguous postal addresses by including (for example) the State.

*[[Birthday block]] (contributed code)

==See also==

*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=106997 How can I show ID Number in the user profile form?] forum discussion

[[Category:Administrator]]

[[fr:Champs du profil]]

View profile

2009-07-20T23:12:09Z

Meredith25: Formatting updates

Location: Administration > Browse list of Users > View or Edit

== Overview ==

For users with appropriate access rights within the Browse list of users area, clicking on the name of user will take you to a tab based summary view of a user's profile information. The user profile page gathers together all the known information about a particular user including detailed reports and logs regarding the activity of that user.

You may also see a link for each course you or the user belongs to. If you are viewing your profile or are an administrator clicking on these links keeps you on the user's profile but alters the breadcrumb menu so you can quickly jump to that course.

== Change Password and Messages ==

Depending on your access rights there may also be buttons at the bottom of the view profile page:

;Change password
:This takes you to a form for changing your/another user's password.

;Messages
:This opens the Messaging pop-up. It only shows when viewing your profile.

;Send message
:This takes you to the Messaging pop-up and opens a messaging session with the user whose profile you were using. It only shows when viewing someone else's profile and if messaging is switched on by the administrator.

== Login As ==

The Login as tool allows users with appropriate access rights to log in as another user and view the site as this user would. This is particularly useful for troubleshooting any access problems or for checking configuration options.

To Login as another user navigate to their profile view and click the Login as button. When you will be advised You are logged in as [person] press the Continue button.

The site will display your logged in status as [Your name] You are logged in as [Other user name] (Logout). To return to your own login click your name or select Logout to log out of the site entirely.

It is important to note that the system Logs still record any action you undertake when loggedin as another user, under your account.

== Profile Tab ==

The Profile tab displays the general information regarding a user and reflects the profile details a standard (e.g. student) can access. If the user has entered in any additional information within their profile (such as MSN ID, phone number etc), this will be displayed on this page/tab.

The Profile tab also provides those users with appropriate access rights the Loginas and Send Message buttons.

== Edit Profile ==

The Edit Profile tab provides administrators etc with ability to update any (non-locked) profile information previously entered against the user. This includes the option to change or reset a user's password. It is recommended the Force password change option is used when resetting a password for a user.

== Forum Posts ==

The Forum Posts tab lists all Forum Posts (replies) and Discussions (threads) created by the user.

== Blog ==

The Blog tab within the Profile view lists all Blog entries created by the user.

== Notes ==

The Notes tab provides users with appropriate access rights with the ability to create Notes about specific users. A note's status determines who can see the

* Personal - The note will be visible only to you (as the admin/teacher)
* Course - The note will be visible to other teachers in this course
* Site - The note will be visible to other teachers in all courses

Please note, the Notes area can also be accessed via the Participants page within a course

== Activity reports ==

The Activity reports tab provides all access to all reporting data for an individual user. This includes the following reports:

=== Outline report ===

The Outline report is a general summary of those non-course areas of the site the user has viewed/visited.

===Complete Report===

The Complete Report shows all of those areas of the site the user has viewed/visited and what action (if any) they have undertaken within these areas.

===Today's logs===

The Today's logs report lists all areas of the site the user has visited in the last 24 hours and any information available regarding their activity within that area (such as viewing a specific assignment activity or accessing a particular course). A hourly hit counter bar graph is also provided for comparative reporting across a single day.

===All logs===

The All logs report lists all areas of the site the user has visited since their account was created and any information available regarding their activity within that area. Depending on the amount of data available a hit counter bar graph is also provided for comparative reporting across a day, week, fortnight or month.

===Statistics===

The Statistics report gives comparative reporting across (weekly) periods of Views (accesses) and Posts (updates) for a user.

=== Grade ===

The Grade report gives a grade summary of all courses and graded items the user has participated in since their account was created.

=== Roles ===

The Roles tab gives a summary of all Roles currently assigned to the user and the ability to create new overrides or assign new roles at the user context

==See also==

* [[Update profile]]
*The capability [[Capabilities/moodle/user:viewdetails|moodle/user:viewdetails]]

[[cs:Profil uživatele]]
[[de:Nutzerprofil ansehen]]
[[eu:Informazio_pertsonala]]
[[fr:Voir le profil]]

View profile

2009-07-20T23:09:42Z

Meredith25: Added loginas info

Location: Administration > Browse list of Users > View or Edit

== Overview ==

For users with appropriate access rights within the Browse list of users area, clicking on the name of user will take you to a tab based summary view of a user's profile information. The user profile page gathers together all the known information about a particular user including detailed reports and logs regarding the activity of that user.

You may also see a link for each course you or the user belongs to. If you are viewing your profile or are an administrator clicking on these links keeps you on the user's profile but alters the breadcrumb menu so you can quickly jump to that course.

== Change Password, Messages and Loginas ==

Depending on your access rights there may also be buttons at the bottom of the view profile page:

;Change password
:This takes you to a form for changing your password.

;Messages
:This opens the Messaging pop-up. It only shows when viewing your profile.

;Send message
:This takes you to the Messaging pop-up and opens a messaging session with the user whose profile you were using. It only shows when viewing someone else's profile and if messaging is switched on by the administrator.

:Login as
:The Login as tool allows users with appropriate access rights to log in as another user and view the site as this user would. This is particularly useful for troubleshooting any access problems or for checking configuration options.

To Login as another user navigate to their profile view and click the Login as button. When you will be advised You are logged in as [person] press the Continue button.

The site will display your logged in status as [Your name] You are logged in as [Other user name] (Logout). To return to your own login click your name or select Logout to log out of the site entirely.

It is important to note that the system Logs still record any action you undertake when loggedin as another user, under your account.

== Profile Tab ==

The Profile tab displays the general information regarding a user and reflects the profile details a standard (e.g. student) can access. If the user has entered in any additional information within their profile (such as MSN ID, phone number etc), this will be displayed on this page/tab.

The Profile tab also provides those users with appropriate access rights the Loginas and Send Message buttons.

== Edit Profile ==

The Edit Profile tab provides administrators etc with ability to update any (non-locked) profile information previously entered against the user. This includes the option to change or reset a user's password. It is recommended the Force password change option is used when resetting a password for a user.

== Forum Posts ==

The Forum Posts tab lists all Forum Posts (replies) and Discussions (threads) created by the user.

== Blog ==

The Blog tab within the Profile view lists all Blog entries created by the user.

== Notes ==

The Notes tab provides users with appropriate access rights with the ability to create Notes about specific users. A note's status determines who can see the

* Personal - The note will be visible only to you (as the admin/teacher)
* Course - The note will be visible to other teachers in this course
* Site - The note will be visible to other teachers in all courses

Please note, the Notes area can also be accessed via the Participants page within a course

== Activity reports ==

The Activity reports tab provides all access to all reporting data for an individual user. This includes the following reports:

=== Outline report ===

The Outline report is a general summary of those non-course areas of the site the user has viewed/visited.

===Complete Report===

The Complete Report shows all of those areas of the site the user has viewed/visited and what action (if any) they have undertaken within these areas.

===Today's logs===

The Today's logs report lists all areas of the site the user has visited in the last 24 hours and any information available regarding their activity within that area (such as viewing a specific assignment activity or accessing a particular course). A hourly hit counter bar graph is also provided for comparative reporting across a single day.

===All logs===

The All logs report lists all areas of the site the user has visited since their account was created and any information available regarding their activity within that area. Depending on the amount of data available a hit counter bar graph is also provided for comparative reporting across a day, week, fortnight or month.

===Statistics===

The Statistics report gives comparative reporting across (weekly) periods of Views (accesses) and Posts (updates) for a user.

=== Grade ===

The Grade report gives a grade summary of all courses and graded items the user has participated in since their account was created.

=== Roles ===

The Roles tab gives a summary of all Roles currently assigned to the user and the ability to create new overrides or assign new roles at the user context

==See also==

* [[Update profile]]
*The capability [[Capabilities/moodle/user:viewdetails|moodle/user:viewdetails]]

[[cs:Profil uživatele]]
[[de:Nutzerprofil ansehen]]
[[eu:Informazio_pertsonala]]
[[fr:Voir le profil]]

View profile

2009-07-20T23:06:20Z

Meredith25:

Location: Administration > Browse list of Users > View or Edit

== Overview ==

For users with appropriate access rights within the Browse list of users area, clicking on the name of user will take you to a tab based summary view of a user's profile information. The user profile page gathers together all the known information about a particular user including detailed reports and logs regarding the activity of that user.

You may also see a link for each course you or the user belongs to. If you are viewing your profile or are an administrator clicking on these links keeps you on the user's profile but alters the breadcrumb menu so you can quickly jump to that course.

== Change Password and Messages ==

Depending on your access rights there may also be buttons at the bottom of the view profile page:

;Change password
:This takes you to a form for changing your password.

;Messages
:This opens the Messaging pop-up. It only shows when viewing your profile.

;Send message
:This takes you to the Messaging pop-up and opens a messaging session with the user whose profile you were using. It only shows when viewing someone else's profile and if messaging is switched on by the administrator.

== Profile Tab ==

The Profile tab displays the general information regarding a user and reflects the profile details a standard (e.g. student) can access. If the user has entered in any additional information within their profile (such as MSN ID, phone number etc), this will be displayed on this page/tab.

The Profile tab also provides those users with appropriate access rights the Loginas and Send Message buttons.

== Edit Profile ==

The Edit Profile tab provides administrators etc with ability to update any (non-locked) profile information previously entered against the user. This includes the option to change or reset a user's password. It is recommended the Force password change option is used when resetting a password for a user.

== Forum Posts ==

The Forum Posts tab lists all Forum Posts (replies) and Discussions (threads) created by the user.

== Blog ==

The Blog tab within the Profile view lists all Blog entries created by the user.

== Notes ==

The Notes tab provides users with appropriate access rights with the ability to create Notes about specific users. A note's status determines who can see the

* Personal - The note will be visible only to you (as the admin/teacher)
* Course - The note will be visible to other teachers in this course
* Site - The note will be visible to other teachers in all courses

Please note, the Notes area can also be accessed via the Participants page within a course

== Activity reports ==

The Activity reports tab provides all access to all reporting data for an individual user. This includes the following reports:

=== Outline report ===

The Outline report is a general summary of those non-course areas of the site the user has viewed/visited.

===Complete Report===

The Complete Report shows all of those areas of the site the user has viewed/visited and what action (if any) they have undertaken within these areas.

===Today's logs===

The Today's logs report lists all areas of the site the user has visited in the last 24 hours and any information available regarding their activity within that area (such as viewing a specific assignment activity or accessing a particular course). A hourly hit counter bar graph is also provided for comparative reporting across a single day.

===All logs===

The All logs report lists all areas of the site the user has visited since their account was created and any information available regarding their activity within that area. Depending on the amount of data available a hit counter bar graph is also provided for comparative reporting across a day, week, fortnight or month.

===Statistics===

The Statistics report gives comparative reporting across (weekly) periods of Views (accesses) and Posts (updates) for a user.

=== Grade ===

The Grade report gives a grade summary of all courses and graded items the user has participated in since their account was created.

=== Roles ===

The Roles tab gives a summary of all Roles currently assigned to the user and the ability to create new overrides or assign new roles at the user context

==See also==

* [[Update profile]]
*The capability [[Capabilities/moodle/user:viewdetails|moodle/user:viewdetails]]

[[cs:Profil uživatele]]
[[de:Nutzerprofil ansehen]]
[[eu:Informazio_pertsonala]]
[[fr:Voir le profil]]

View profile

2009-07-20T23:05:54Z

Meredith25: Added info on each tab available in admin view

Location: Administration > Browse list of Users > View or Edit

== Overview ==

For users with appropriate access rights within the Browse list of users area, clicking on the name of user will take you to a tab based summary view of a user's profile information. The user profile page gathers together all the known information about a particular user including detailed reports and logs regarding the activity of that user.

You may also see a link for each course you or the user belongs to. If you are viewing your profile or are an administrator clicking on these links keeps you on the user's profile but alters the breadcrumb menu so you can quickly jump to that course.

== Change Password and Messages ==

Depending on your access rights there may also be buttons at the bottom of the view profile page:

;Change password
:This takes you to a form for changing your password.

;Messages
:This opens the Messaging pop-up. It only shows when viewing your profile.

;Send message
:This takes you to the Messaging pop-up and opens a messaging session with the user whose profile you were using. It only shows when viewing someone else's profile and if messaging is switched on by the administrator.

== Profile Tab ==

The Profile tab displays the general information regarding a user and reflects the profile details a standard (e.g. student) can access. If the user has entered in any additional information within their profile (such as MSN ID, phone number etc), this will be displayed on this page/tab.

The Profile tab also provides those users with appropriate access rights the Loginas and Send Message buttons.

== Edit Profile ==

The Edit Profile tab provides administrators etc with ability to update any (non-locked) profile information previously entered against the user. This includes the option to change or reset a user's password. It is recommended the Force password change option is used when resetting a password for a user.

== Forum Posts ==

The Forum Posts tab lists all Forum Posts (replies) and Discussions (threads) created by the user.

== Blog ==

The Blog tab within the Profile view lists all Blog entries created by the user.

== Notes ==

The Notes tab provides users with appropriate access rights with the ability to create Notes about specific users. A note's status determines who can see the

* Personal - The note will be visible only to you (as the admin/teacher)
* Course - The note will be visible to other teachers in this course
* Site - The note will be visible to other teachers in all courses

Please note, the Notes area can also be accessed via the Participants page within a course

== Activity reports ==

The Activity reports tab provides all access to all reporting data for an individual user. This includes the following reports:

=== Outline report ===

The Outline report is a general summary of those non-course areas of the site the user has viewed/visited.

===Complete Report===

The Complete Report shows all of those areas of the site the user has viewed/visited and what action (if any) they have undertaken within these areas.

===Today's logs===

The Today's logs report lists all areas of the site the user has visited in the last 24 hours and any information available regarding their activity within that area (such as viewing a specific assignment activity or accessing a particular course). A hourly hit counter bar graph is also provided for comparative reporting across a single day.

===All logs===

The All logs report lists all areas of the site the user has visited since their account was created and any information available regarding their activity within that area. Depending on the amount of data available a hit counter bar graph is also provided for comparative reporting across a day, week, fortnight or month.

====Statistics===

The Statistics report gives comparative reporting across (weekly) periods of Views (accesses) and Posts (updates) for a user.

=== Grade ===

The Grade report gives a grade summary of all courses and graded items the user has participated in since their account was created.

=== Roles ===

The Roles tab gives a summary of all Roles currently assigned to the user and the ability to create new overrides or assign new roles at the user context

==See also==

* [[Update profile]]
*The capability [[Capabilities/moodle/user:viewdetails|moodle/user:viewdetails]]

[[cs:Profil uživatele]]
[[de:Nutzerprofil ansehen]]
[[eu:Informazio_pertsonala]]
[[fr:Voir le profil]]

Update profile

2009-07-20T22:45:39Z

Meredith25: /* Custom Profile Categories */

Location: ''Administration > Users > Accounts > Add a new user'' or ''Browse list of users'', or by choosing the ''Edit profile'' tab from one's own profile.

==Updating Your Profile ==
{{Moodle 1.8}}
The fields are divided into 3 sections - General, Picture & Optional which are all explained below. Note that some settings are 'advanced', so you may need to click the 'Show Advanced' button on the right to see all the settings. The advanced settings are indicated below.

Remember to click 'Update profile' when you have finished.

=== General ===

The first section contains fields that must be completed:

'''First name & Surname'''

These are self-explanatory. These names will identify you everywhere in your Moodle courses.

'''Email address'''

The email address should be an address that you check regularly. It is used for acknowledgements and announcements from Moodle, including messages from Forums that you are subscribed to. It is also the address that is displayed to other users of Moodle, depending on your 'Email display' setting (below).

'''Email display'''

This controls the visibility of your email address to others. The three settings are self-explanatory but please note 'Hide my email address from everyone' only hides it from students. Teaching staff and other staff with editing access will always be able to see your email address.

'''Email activated'''

You can either enable or disable emails being sent to an address. Note that if this is disabled, you will not receive any email whatsoever from the site. This is not recommend, as you may miss important course-related messages.

'''Email format (advanced)'''

There are two formats: "Pretty HTML format" (messages will be formatted) and "Plain text format" (plain text with no formatting).

'''Email digest type (advanced)'''

This setting determines how you receive any posts from Forums to which you are subscribed, allowing you to receive messages individually or on a daily basis.

'''Forum auto-subscribe (advanced)'''

This setting lets you decide if you want email copies of posts that are added to forums. If you set this to subscribe, the system will automatically email you copies of new posts in forums that you post in, unless you manually override it when posting.

'''Forum tracking (advanced)'''

Enabling forum tracking means highlighting the posts you have not read yet, which should improve your forum navigation.

'''When editing text (advanced)'''

This can usually be left on "Use HTML editor (some browsers only)". This allows for text formatting options, but requires newer browsers. If you find your browser is not letting you edit text, change this setting to "Use standard web forms".

'''AJAX and JavaScript (advanced)'''

This determines whether the Moodle interface will use advanced navigation features such as drag-and-drop, that require AJAX and JavaScript to function. These features can cause problems on some browsers so you might prefer to turn them off.

'''Screen Reader (advanced)'''

If you use a screen reader, this setting should be set to 'Yes'. (A screen reader is a form of 'assistive technology' used by blind and partially-sighted users to interpret what is displayed on the screen).

'''City/town & Country'''

Add your location.

'''Timezone'''

This field is used to convert time-related messages on the system (such as assignment deadlines) from the local timezone (the time in London) to the correct time in whichever zone you have selected.

'''Preferred language and theme (advanced)'''

You can view Moodle in several different languages and colour themes, which you can select via these two options. Note: changing the preferred language only affects the Moodle interface, not the course content!

'''Description'''

In this field you can enter some text about yourself, be it information about your studies, hobbies, qualifications or anything else.

=== Picture ===

This section is optional and allows you to choose your own profile picture. Your current picture is shown, if you have already chosen one.

'''New picture'''

The Browse button allows you to choose a new picture for your profile. Your picture is uploaded when you choose the 'Update Profile' at the bottom of the page.

Your picture will be resized by Moodle when you upload it - to 100 pixels by 100 pixels for the larger view (e.g. in your profile) and 35 pixels by 35 pixels for the smaller view (e.g. on the Forums). If the picture you upload is not square, Moodle will automatically chop the edges off to make it square.

=== Optional ===

There are several optional fields (all advanced) allowing you to add further details to your profile such as contact details and your website.

===Custom Profile Categories===
If any custom user profile categories and fields have been created on your Moodle site, they will be listed at the bottom of the Add User/Edit User page. [[user/profile/index|Admin / Accounts/ User profile fields]]

==Adding a new user==

The add a new user page allows you to manually create a new user account. If you create a test account, you can use a made-up email address.

The required field must be entered before the user will be accepted by Moodle. The required fields in a standard Moodle install are: Username, New password, Surname, Email address, City/town, Select a country.

Validity checks on the required field are performed. For example, usernames can only contain alphabetical letters or numbers. As a result using the underscore character '_' is not permitted; however, using a period is permitted. So a username of joe_smith would not be allowed but joe.smith is permissible. The email address should be in the format of a valid email (for example, joe.smith@myisp.com). If password complexity requirements are enabled by the site administrator, they new password field is also checked to ensure it complies with those requirements. See [[admin/setting/sitepolicies#Password_policy|Password policy]] for more information.

Other fields that are part of a user's profile can also be filled out when the user is created. Some of the profile fields can be revealed by pressing the "Show Advanced" button.

The new user information is saved by pressing the "Update user" button near the bottom of the form.

Note: You can always create new accounts manually, regardless of which [[Authentication|authentication method]] you are using.

==Updating a user profile==

Users with the capability [[Capabilities/moodle/user:update|moodle/user:update]] are able to update another user's profile i.e. in addition to being able to edit the profile, all settings (username, password, authentication method, force new password etc.) may be changed.

==Account disabling==

An account may be disabled by setting the authentication method to "[[No login]]". The account email may not be used to create another account.

[[Category:Administrator]]

[[fr:Modifier le profil]]
[[de:Nutzerprofil aktualisieren]]

Update profile

2009-07-20T22:40:56Z

Meredith25: Added Custom Profile Categories section

Location: ''Administration > Users > Accounts > Add a new user'' or ''Browse list of users'', or by choosing the ''Edit profile'' tab from one's own profile.

==Updating Your Profile ==
{{Moodle 1.8}}
The fields are divided into 3 sections - General, Picture & Optional which are all explained below. Note that some settings are 'advanced', so you may need to click the 'Show Advanced' button on the right to see all the settings. The advanced settings are indicated below.

Remember to click 'Update profile' when you have finished.

=== General ===

The first section contains fields that must be completed:

'''First name & Surname'''

These are self-explanatory. These names will identify you everywhere in your Moodle courses.

'''Email address'''

The email address should be an address that you check regularly. It is used for acknowledgements and announcements from Moodle, including messages from Forums that you are subscribed to. It is also the address that is displayed to other users of Moodle, depending on your 'Email display' setting (below).

'''Email display'''

This controls the visibility of your email address to others. The three settings are self-explanatory but please note 'Hide my email address from everyone' only hides it from students. Teaching staff and other staff with editing access will always be able to see your email address.

'''Email activated'''

You can either enable or disable emails being sent to an address. Note that if this is disabled, you will not receive any email whatsoever from the site. This is not recommend, as you may miss important course-related messages.

'''Email format (advanced)'''

There are two formats: "Pretty HTML format" (messages will be formatted) and "Plain text format" (plain text with no formatting).

'''Email digest type (advanced)'''

This setting determines how you receive any posts from Forums to which you are subscribed, allowing you to receive messages individually or on a daily basis.

'''Forum auto-subscribe (advanced)'''

This setting lets you decide if you want email copies of posts that are added to forums. If you set this to subscribe, the system will automatically email you copies of new posts in forums that you post in, unless you manually override it when posting.

'''Forum tracking (advanced)'''

Enabling forum tracking means highlighting the posts you have not read yet, which should improve your forum navigation.

'''When editing text (advanced)'''

This can usually be left on "Use HTML editor (some browsers only)". This allows for text formatting options, but requires newer browsers. If you find your browser is not letting you edit text, change this setting to "Use standard web forms".

'''AJAX and JavaScript (advanced)'''

This determines whether the Moodle interface will use advanced navigation features such as drag-and-drop, that require AJAX and JavaScript to function. These features can cause problems on some browsers so you might prefer to turn them off.

'''Screen Reader (advanced)'''

If you use a screen reader, this setting should be set to 'Yes'. (A screen reader is a form of 'assistive technology' used by blind and partially-sighted users to interpret what is displayed on the screen).

'''City/town & Country'''

Add your location.

'''Timezone'''

This field is used to convert time-related messages on the system (such as assignment deadlines) from the local timezone (the time in London) to the correct time in whichever zone you have selected.

'''Preferred language and theme (advanced)'''

You can view Moodle in several different languages and colour themes, which you can select via these two options. Note: changing the preferred language only affects the Moodle interface, not the course content!

'''Description'''

In this field you can enter some text about yourself, be it information about your studies, hobbies, qualifications or anything else.

=== Picture ===

This section is optional and allows you to choose your own profile picture. Your current picture is shown, if you have already chosen one.

'''New picture'''

The Browse button allows you to choose a new picture for your profile. Your picture is uploaded when you choose the 'Update Profile' at the bottom of the page.

Your picture will be resized by Moodle when you upload it - to 100 pixels by 100 pixels for the larger view (e.g. in your profile) and 35 pixels by 35 pixels for the smaller view (e.g. on the Forums). If the picture you upload is not square, Moodle will automatically chop the edges off to make it square.

=== Optional ===

There are several optional fields (all advanced) allowing you to add further details to your profile such as contact details and your website.

===Custom Profile Categories===
If any custom user profile categories and fields have been created on your Moodle site, they will be listed at the bottom of the Add User/Edit User page. (Admin / Accounts/ User profile fields)

==Adding a new user==

The add a new user page allows you to manually create a new user account. If you create a test account, you can use a made-up email address.

The required field must be entered before the user will be accepted by Moodle. The required fields in a standard Moodle install are: Username, New password, Surname, Email address, City/town, Select a country.

Validity checks on the required field are performed. For example, usernames can only contain alphabetical letters or numbers. As a result using the underscore character '_' is not permitted; however, using a period is permitted. So a username of joe_smith would not be allowed but joe.smith is permissible. The email address should be in the format of a valid email (for example, joe.smith@myisp.com). If password complexity requirements are enabled by the site administrator, they new password field is also checked to ensure it complies with those requirements. See [[admin/setting/sitepolicies#Password_policy|Password policy]] for more information.

Other fields that are part of a user's profile can also be filled out when the user is created. Some of the profile fields can be revealed by pressing the "Show Advanced" button.

The new user information is saved by pressing the "Update user" button near the bottom of the form.

Note: You can always create new accounts manually, regardless of which [[Authentication|authentication method]] you are using.

==Updating a user profile==

Users with the capability [[Capabilities/moodle/user:update|moodle/user:update]] are able to update another user's profile i.e. in addition to being able to edit the profile, all settings (username, password, authentication method, force new password etc.) may be changed.

==Account disabling==

An account may be disabled by setting the authentication method to "[[No login]]". The account email may not be used to create another account.

[[Category:Administrator]]

[[fr:Modifier le profil]]
[[de:Nutzerprofil aktualisieren]]

Browse list of users

2009-07-20T22:32:48Z

Meredith25: Added Table Sorting and Filters sections and added section headings

Location: ''Administration > Users > Accounts > Browse list of users''

== Overview ==

The browse list of users page provides a list of all user accounts.
[[Image:Administration Block Site User Accounts Browse.png|thumb|center|Example of Browse user list]]

Site Administrators can search for a particular user, using their name or email address as the search term, and then [[Update profile|edit their profile]]. Editing a user's profile is a way to reset the user's passwords when they are unable to log in. Another reason for needing to edit a user’s profile is to disable their email address if the site is receiving lots of undelivered mail.

*In some versions of Moodle, if you are using email-based self-registration and a user has a problem confirming their account, you can confirm their account for them by clicking the confirm link opposite their name. (It is possible to send emails using the [[Bulk user actions]] screen in 1.9)

== Search Users ==

There are a number of ways to search for a particular user or group of users within the Browse list of users area.

=== Table Sorting ===

All of the columns in the browse list may be sorted in alphabetical (or numerical) order either ascending or descending, by clicking on the column heading. Your first column click sorts the user data A-Z, the second click sorts the data Z-A.

===Filters===
You can search for users, using particular criteria or Filters. These criteria can be configured to display data as per the following limits:

* contains
* doesn't contain
* is equal to
* starts with
* ends with
* is empty

For example, if you wished to search for all users with John in their First Name or Last Name you would enter 'John' in the Full name filter and select the 'contains' limit.

Clicking the Show Advanced button will provide you with additional search Filters and data limits. The Filters under the Advanced area will also include any custom user profile fields that have been created within your Moodle installation

After applying a Filter to a user search, click the Add Filter button to run the user search. All Filters applied to the search are listed above the search results. You can add or remove (using the corresponding tickbox) Filters to your search criteria as required. These filters are saved within a single Moodle session.

==See also==

*[[Update profile]]

[[Category:Administrator]]

[[fr:Liste des utilisateurs]]

mod/feedback/import

2009-07-15T05:13:41Z

Meredith25: New page: Where you have previously exported and saved questions from a Feedback activity in .xml format, you can reimport them into a new Feedback activity. The Import questions tool is particularl...

Where you have previously exported and saved questions from a Feedback activity in .xml format, you can reimport them into a new Feedback activity. The Import questions tool is particularly useful where you need to import questions from a different instance of Moodle and the Template tool is not applicable. After clicking on the Import questions link you will be prompted to select one of the following options:

* Delete old items - The current questions and all your user's responses will be deleted within the current Feedback activity
* Append new items - All old questions and the assigned values will be preserved within the current Feedback activity and the imported questions will be added to the existing questions.

Use the Choose a file button to navigate to the course Files area and upload and/or select the relevant .xml file. Once selected use the Import from this file button to import the questions or use Cancel to return to the Templates general tab.

mod/feedback/use templ

2009-07-15T00:26:03Z

Meredith25: New page: {{Feedback}} After selecting a Template, Moodle will display a preview of the Feedback questions contained within the Template and confirm 'Are you sure you want to use this template?' Y...

{{Feedback}}

After selecting a Template, Moodle will display a preview of the Feedback questions contained within the Template and confirm 'Are you sure you want to use this template?'

You will also be required to select one of two options:

* 'Delete old items' - remove any questions/text types previously added to the Feedback Activity you are viewing before importing items from the selected Template
* 'Append new items' - add items stored within the selected template to the current Feedback activity, to any existing questions/text types.

Once you have made your selection click Save changes to copy across the Feedback items or press Cancel to exit from the template copy process.

[[Category:Feedback]]

Viewing Feedback responses

2009-07-14T22:41:23Z

Meredith25:

{{Feedback}}

Users with appropriate access rights can view Feedback activity responses either in summary or Analysis format or view individual responses.

== Analysis ==

Within the Analysis tab you will be able to view a list of all responses submitted for each of the questions within a Feedback activity. The total number of Submitted answers and Questions are provided within this page, as is a link to export this data to Excel for detailed Analysis. Where (optional) questions have not be answered by a user, a dash ( - ) is displayed.

== Show responses ==

Within the Show responses tab you can view the responses submitted by each user. These responses show all answers to all questions within the Feedback activity for an individual user. Individual responses may be Deleted if required.

Because Feedback activities can be updated during the course of response collection, responses are divided into Anonymous and non Anonymous entries. Anonymous entries are identified by a sequentially numbered ID number.

[[Category:Feedback]]
[[Category:Teacher]]

Viewing Feedback responses

2009-07-14T22:41:11Z

Meredith25:

{{Feedback}}

Users with appropriate access rights can view Feedback activity responses either in summary or Analysis format or view individual responses.

== Analysis ==

Within the Analysis tab you will be able to view a list of all responses submitted for each of the questions within a Feedback activity. The total number of Submitted answers and Questions are provided within this page, as is a link to export this data to Excel for detailed Analysis. Where (optional) questions have not be answered by a user, a dash ( - ) is displayed.

==
Show responses ==

Within the Show responses tab you can view the responses submitted by each user. These responses show all answers to all questions within the Feedback activity for an individual user. Individual responses may be Deleted if required.

Because Feedback activities can be updated during the course of response collection, responses are divided into Anonymous and non Anonymous entries. Anonymous entries are identified by a sequentially numbered ID number.

[[Category:Feedback]]
[[Category:Teacher]]

Viewing Feedback responses

2009-07-14T22:40:18Z

Meredith25:

{{Feedback}}

Users with appropriate access rights can view Feedback activity responses either in summary or Analysis format or view individual responses.

Within the Analysis tab you will be able to view a list of all responses submitted for each of the questions within a Feedback activity. The total number of Submitted answers and Questions are provided within this page, as is a link to export this data to Excel for detailed Analysis. Where (optional) questions have not be answered by a user, a dash ( - ) is displayed.

Within the Show responses tab you can view the responses submitted by each user. These responses show all answers to all questions within the Feedback activity for an individual user. Individual responses may be Deleted if required.

Because Feedback activities can be updated during the course of response collection, responses are divided into Anonymous and non Anonymous entries. Anonymous entries are identified by a sequentially numbered ID number.

[[Category:Feedback]]
[[Category:Teacher]]

mod/feedback/show entries

2009-07-14T22:10:11Z

Meredith25:

Users with appropriate access rights can view Feedback activity responses either in summary or Analysis format or view individual responses.

Within the Show responses tab you can view the responses submitted by each user. These responses show all answers to all questions within the Feedback activity for an individual user. Individual responses may be Deleted if required.

Because Feedback activities can be updated during the course of response collection, responses are divided into Anonymous and non Anonymous entries. Anonymous entries are identified by a sequentially numbered ID number.

[[Category:Feedback]]

Viewing Feedback responses

2009-07-14T22:09:53Z

Meredith25:

Viewing Feedback responses

2009-07-14T22:09:07Z

Meredith25:

{{stub}}
{{Feedback}}

Users with appropriate access rights can view Feedback activity responses either in summary or Analysis format or view individual responses.

Within the Analysis tab you will be able to view a list of all responses submitted for each of the questions within a Feedback activity. The total number of Submitted answers and Questions are provided within this page, as is a link to export this data to Excel for detailed Analysis. Where (optional) questions have not be answered by a user, a dash ( - ) is displayed.

[[Category:Feedback]]
[[Category:Teacher]]

mod/feedback/show entries

2009-07-14T22:08:36Z

Meredith25: New page: Users with appropriate access rights can view Feedback activity responses either in summary or Analysis format or view individual responses. Within the Show responses tab you can view the...

mod/feedback/view

2009-07-14T22:05:56Z

Meredith25: New page: As an administrator or teacher/trainer when you enter a Feedback Activity you will be taken to the general Feedback editing and review area. The tabbed based interface will provide you wit...

As an administrator or teacher/trainer when you enter a Feedback Activity you will be taken to the general Feedback editing and review area. The tabbed based interface will provide you with the option to (add, view and) Edit Questions, create Feedback Templates, view collated responses (Analysis) and Show (individual) responses. You can also update the configuration settings of the activity using the Update this Feedback button.

The Overview tab displays the Description of the Feedback activity and the page or text (where entered) users see once they have submitted their response.

When a student enters a Feedback Activity they simply see the Description text and a link to answer the Feedback questions.

Viewing Feedback responses

2009-07-13T21:55:02Z

Meredith25:

{{stub}}
{{Feedback}}

You can view responses both anonymously or not.

[[Category:Feedback]]
[[Category:Teacher]]