MoodleDocs - User contributions [en]

Grade items

2008-10-22T20:04:51Z

Linkupnick: Undo revision 45684 by Linkupnick (Talk)

{{Grades}}

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

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

A grade item is a unit of measurement by which participants in a course are graded (i.e. 'marked'). As such, a grade item is a container for grades and a set of settings applied to these grades. The settings affect the calculation and display of the grades in the gradebook reports and [[Grade_export|exports]].

Grade items are represented by columns in the [[Grader_report | grader report]].

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

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

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

*'''Item info''': General information about the grade item. Optional.
*'''Grade to pass''': Specify the minimum grade a student must achieve to be considered to have passed this item. This must be in real grades, not a percentage. Once this is done, grades will be highlighted in red for fail and green for pass in the gradebook. It doesn't work for scales, as it is yet to be fully implemented in Moodle 1.9. It is planned for use in [[Development:Course completion|course completion]] in Moodle 2.0.
*'''Grade display type''': See the [[Grade_item_settings#Grade_display_type | Grade display type doc]]
*'''Overall decimal points''': This specifies the number of decimal points to display for each grade. It has no effect on grade calculations, which are made with an accuracy of 5 decimal places.
*'''Multiplicator''': Factor by which all grades for this grade item will be multiplied, with a maximum value of the maximum grade. For example, if the multiplicator is 2 and the maximum grade is 100, then all grades less than 50 are doubled, and all grades 50 and above are changed to 100.
*'''Offset''': Number that will be added to every grade for this grade item, after the Multiplicator is applied. (Can be a negative number.)
*'''Hidden''': Whether this grade item should be hidden from students.
*'''Hidden until''': An optional date after which the grade item will no longer be hidden (i.e. a grades release date)
*'''Locked''': Whether or not to lock this grade item. A locked grade item doesn't accept changes to its settings or grades from its related module.
*'''Locked after''': A date after which the locking will be effective, usually after the grades release date.

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

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

The settings of the grade outcome item edit form are identical to those of manual grade items, with the addition of two settings:

*'''Outcome''': The course outcome represented by this item
*'''Linked activity''': The optional activity module to which this item will be linked

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

*'''Item name''': The display name of your grade item
*'''ID Number''': An arbitrary string of characters used to refer to this grade item in Formulas. If set, it must be unique.
*'''Grade type''': The type of grade: None (no grading possible), Value (a numerical value), Scale (an item in a list) or Text (arbitrary text).
*'''Scale''': Which scale to use for grading: available only when the Scale grade type is selected.
*'''Maximum grade''': The maximum grade that can be given (for scales: the number of items in the scale - 1)
*'''Minimum grade''': The minimum grade that can be given (for scales: 0)

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

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

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

Grade items

2008-10-22T20:04:19Z

Linkupnick: /* Introduction */

{{Grades}}

== Introduction ==
The three building blocks of the Gradebook in OurVLE are

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

A grade item is a unit of measurement by which participants in a course are graded (i.e. 'marked'). As such, a grade item is a container for grades and a set of settings applied to these grades. The settings affect the calculation and display of the grades in the gradebook reports and [[Grade_export|exports]].

Grade items are represented by columns in the [[Grader_report | grader report]].

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

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

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

*'''Item info''': General information about the grade item. Optional.
*'''Grade to pass''': Specify the minimum grade a student must achieve to be considered to have passed this item. This must be in real grades, not a percentage. Once this is done, grades will be highlighted in red for fail and green for pass in the gradebook. It doesn't work for scales, as it is yet to be fully implemented in Moodle 1.9. It is planned for use in [[Development:Course completion|course completion]] in Moodle 2.0.
*'''Grade display type''': See the [[Grade_item_settings#Grade_display_type | Grade display type doc]]
*'''Overall decimal points''': This specifies the number of decimal points to display for each grade. It has no effect on grade calculations, which are made with an accuracy of 5 decimal places.
*'''Multiplicator''': Factor by which all grades for this grade item will be multiplied, with a maximum value of the maximum grade. For example, if the multiplicator is 2 and the maximum grade is 100, then all grades less than 50 are doubled, and all grades 50 and above are changed to 100.
*'''Offset''': Number that will be added to every grade for this grade item, after the Multiplicator is applied. (Can be a negative number.)
*'''Hidden''': Whether this grade item should be hidden from students.
*'''Hidden until''': An optional date after which the grade item will no longer be hidden (i.e. a grades release date)
*'''Locked''': Whether or not to lock this grade item. A locked grade item doesn't accept changes to its settings or grades from its related module.
*'''Locked after''': A date after which the locking will be effective, usually after the grades release date.

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

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

The settings of the grade outcome item edit form are identical to those of manual grade items, with the addition of two settings:

*'''Outcome''': The course outcome represented by this item
*'''Linked activity''': The optional activity module to which this item will be linked

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

*'''Item name''': The display name of your grade item
*'''ID Number''': An arbitrary string of characters used to refer to this grade item in Formulas. If set, it must be unique.
*'''Grade type''': The type of grade: None (no grading possible), Value (a numerical value), Scale (an item in a list) or Text (arbitrary text).
*'''Scale''': Which scale to use for grading: available only when the Scale grade type is selected.
*'''Maximum grade''': The maximum grade that can be given (for scales: the number of items in the scale - 1)
*'''Minimum grade''': The minimum grade that can be given (for scales: 0)

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

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

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

Roles and capabilities

2008-10-15T15:48:31Z

Linkupnick: /* Definitions */

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

==Definitions==
;Role
:An identifier of the user's status. The status depends upon permissions given for one or more capabilities in a context.
::For example Teacher and Student are standard user roles. The identifier indicates they probably have different capabilities in some contexts.
:When Moodle is first installed, a number of [[Standard roles]] are created automatically.
;Capability
:A description of a particular Moodle feature. A list of many capabilities can be seen in the [https://docs.moodle.org/en/Category:Capabilities capability category index page].
::For example [[Capabilities/moodle/blog:create|moodle/blog:create]](writing blog entries) or "Backup course" are two capabilities. Note the "<nowiki>mod/blog:create</nowiki>" notation is a common to identify a capability.
;Permission
:A setting for a capability. Can be any one of four: not set/inherit, allow, prevent or prohibit.
;Context
:A "space" in Moodle.
::For example: a course, activity module or block can each be a context.
::Some contexts can contain multiple contexts in their space, For example, a course can contain a lesson, assignment, forum and quiz modules, plus blocks.

==See also==

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

[[Category:Roles]]

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

Roles and capabilities

2008-10-15T15:47:08Z

Linkupnick: /* Definitions */

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

==Definitions==
;Role
:An identifier of the user's status. The status depends upon permissions given for one or more capabilities in a context.
::For example Teacher and Student are standard user roles. The identifier indicates they probably have different capabilities in some contexts.
;Capability
:A description of a particular Moodle feature. A list of many capabilities can be seen in the [https://docs.moodle.org/en/Category:Capabilities capability category index page].
::For example [[Capabilities/moodle/blog:create|moodle/blog:create]](writing blog entries) or "Backup course" are two capabilities. Note the "<nowiki>mod/blog:create</nowiki>" notation is a common to identify a capability.
;Permission
:A setting for a capability. Can be any one of four: not set/inherit, allow, prevent or prohibit.
;Context
:A "space" in Moodle.
::For example: a course, activity module or block can each be a context.
::Some contexts can contain multiple contexts in their space, For example, a course can contain a lesson, assignment, forum and quiz modules, plus blocks.

==See also==

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

[[Category:Roles]]

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

HTML editor

2008-10-09T22:32:01Z

Linkupnick: /* Inserting images */

Moodle has developed a standard toolbar that serves as an HTML interface. Many of the icons on the tool bar can be found on most text editing (word processing) programs. This page will cover some of the icons/tools which may not be as familiar to a new user of Moodle.

For example, you can cut/copy and paste text from other applications into this editor and formatting will be preserved. There is the usual [[Image:Ed paste.gif]] clipboard icon which is for pasting text that has been copied or cut. Or use the usual short cut keys of Control+C and Control+V .

==HTML editor toolbar features==
[[Image:Course Lesson Page Content Toolbar.GIF|frame|center|HTML editor toolbar in a Lesson page, other modules will look similar.]]

__TOC__

===Font and background colours===
There are two icons to change the [[Image:Ed color fg.gif]] font and the [[Image:Ed color bg.gif]] colour behind text. Clicking on the icon will bring up a color pallet. Note the HTML color code is displayed.
[[Image:HTML toolbar Color pallet.JPG|center]]

===Anchor===
[[Image:Ed anchor.gif]] An HTML anchor identifies text within a page which can be referenced by a link. To use the Anchor, highlight the word, then click on the Anchor icon. Give the anchor a name. Anywhere on the page, highlight the word you would like to link to the Anchor. Use the Link icon and the pull down menu to find the correct anchor.
[[Image:HTML toolbar anchor tool.JPG]]

===Inserting links===
[[Image:Ed link.gif|left|]] An HTML link creates a path to external, internal or the current page. The icon saves writing code. One method is to copy the address bar from the location you want, click on the link icon,then paste it URL. Another method is to press the Browse button. This will take you to the [[Files]] area of the course. From here it is possible to select an existing file or to upload a new file and link to it.

'''To make a new link'''
*Type the text that you want to be a link
***For example: "Link to course file in demo.moodle.org"
*Select the text
***For example select "course file" by highlighting it with your mouse.
*Click the [[Image:Ed link.gif]] link button in the toolbar
*Type (or paste, or browse to) the URL you want to link to
***For example we used browsed and clicked on the file to get our entry
*Type in some text which will appear when the mouse rolls over it
***For example: "Course file in demo moodle."
*Target - What kind of window should be called up
***[[Image:HTML editor insert link target menu.jpg]]
*Anchors - A pull down list allows you to select an [[HTML_editor#Anchor|anchor]] you created on the page
*Click OK

[[Image:HTML toolbar Hyperlink.JPG|center]]

*After the above steps the student will see:
**[[Image:HTML toolbar Insert Link result1.jpg|frame|center|This result]]

====TIPs - inserting links====
*This process does '''NOT''' work inside the wiki module where you need to use the Wiki link system (square brackets containing the label and the link separated by a vertical line character)
*A course file has a URL address that can be found via the browse button

===Inserting images===
[[Image:Ed_image.gif]] Moodle allows you to upload pictures into a course or site folder, then insert that image into the content area. It is also possible to use an existing image located outside of your Moodle site.

You can include images in the content area by using the [[Image:Ed_image.gif]] button. This will bring up an insert image edit screen to assist you in inserting an picture. More detailed instructions for [[Insert image|inserting an image can be found here]]. Moodle recognizes JPG, GIF and PNG as image files.
[[Image:HTML Insert Image tool pop-up.JPG|thumb|center|300px|[[Insert image| Insert image page link]] in Moodle Documentation]]

===Inserting tables===
* [[Image:Insert table.gif]] To add layout to your texts, you can use the "Insert Tables" button in the toolbar.

[[Image:HTML toolbar table settings.jpg|center]]
*Most table editing tools are only visible if you click the '''Enlarge Editor''' button.

===Inserting smilies (emoticons)===

The smiley icon [[Image:Smiley.gif]] will allow you to add a small icon (for example [[Image:Cool.gif]] ) in your text. A dialog will pop up that allows you to select from a table of smiley icons. Alternatively, you can just type the corresponding code straight into your text and it will be converted later when your text is displayed.
[[Image:HTML toolbar Smiley icon selections.JPG|center]]

===Special characters===
The special characters [[Image:special characters button.gif]] button, allows you to enter special characters from a table.
[[Image:HTML_toolbar_Special_character_selections.JPG|center]]

===Toggle to HTML Code editing===

The [[Image: Ed html.gif]] button changes the display window to raw HTML code. This can be useful for those of you that know how to use it (or want to learn!). Most of the buttons do not work in this view, including many of the hotkeys.

[[Image:HTML editor HTML code example.png|thumb|center|400px|Example of HTML code for content area in a forum post ]]

===Enlarge editor===
The [[Image:Fullscreen maximize.gif]] button will expand the HTML editor area.

===Clean Word button===
The clean Word [[Image:Ed wordclean.gif]] button removes some Word formatting from your pasted text so that the page is smaller, less complex and thus loads faster. The [http://www.microsoft.com/downloads/details.aspx?FamilyID=209ADBEE-3FBD-482C-83B0-96FB79B74DED&displaylang=EN Microsoft Office HTML Filter 2.0] removes all Word code from HTML file far more effectively. This filter is already built into office in Microsoft Office XP onwards.

==Shortcut keys==
Here are some common editing short cut or hot keys which will within the HTML editor in WYSIWYG view. Different operating systems and browsers may not support all these keys. The most universal hot keys are in''' bold'''.
{| border="0" cellpadding="2" cellspacing="0" style="text-align:left"
! width="70"|Keys
! width="300"|Action
! width="10"|
! width="70"|Keys
! width="300"|Action

|-
| '''Ctrl-C'''
| Copy
|
| '''Ctrl-V'''
| Paste

|-
| '''Ctrl-X'''
| Cut
|
| '''Ctrl-F'''
| Find text

|-
| Ctrl-H
| Find and replace
|
| *
| *

|-
| '''Ctrl-Z'''
| Undo
|
| '''Ctrl-Y'''
| Redo

|-
| '''Ctrl-B'''
| Make text bold
|
| '''Ctrl-I'''
| Make text italic

|-
| '''Ctrl-U'''
| Underline text
|
| '''Ctrl-S'''
| Strikethrough text

|-
| Ctrl-H
| Change text format (headings etc.)
|
| Ctrl-1
| to Ctrl-6 Change heading level

|-
| Ctrl-,
| Subscript
|
| Ctrl-.
| Superscript

|-
| Ctrl-O
| Change the font
|
| Ctrl-0
| Clean Word HTML

|-
| Ctrl-L
| Justify left
|
| Ctrl-E
| Center

|-
| Ctrl-J
| Justify full
|
| Ctrl-/
| Text runs left to right

|-
| Ctrl-<nowiki>|</nowiki>
| Text runs right to left
|
| Ctrl-;
| Decrease indent

|-
| Ctrl-'
| Increase indent
|
| Ctrl-G
| Change text colour

|-
| Ctrl-K
| Change background colour
|
| Ctrl-P
| Change the font size

|-
| Ctrl-`
| Switch to HTML source code view
|
| Ctrl-M
| Toggle fullscreen editor mode

|-
| Ctrl-Alt-O
| Insert ordered list
|
| Ctrl-Alt-U
| Insert unordered list

|-
| Ctrl-Alt-R
| Insert horizontal rule
|
| Ctrl-Alt-A
| Create anchor

|-
| Ctrl-Alt-L
| Create link
|
| Ctrl-Alt-D
| Unlink

|-
| Ctrl-Alt-N
| Turn off autolinking
|
| Ctrl-Alt-I
| Insert image

|-
| Ctrl-Alt-T
| Insert table
|
| Ctrl-Alt-S
| Insert emoticon

|-
| Ctrl-Alt-C
| Insert special character
|
| Ctrl-=
| Change text language for screen readers, or specify language for the Multilang filter

|}

==Tips and Tricks==
*[[Themes|Theme]] settings can control the default fonts in the HTML editor. It is possible to have individual themes for a context (for example, a course may have its own theme).

*When you choose many functions a new small window will open. Unfortunately it can often open BEHIND the window you are in so you may miss that anything has happened. You can check new windows with [Alt]+[Tab].

*The HTML editor does not work in all browsers. If you are using a Mac OS X and for some reason it does not appear, try using Firefox instead of Safari as a browser.

*Can not make HTML give you the text style you want? Use an image or even an animated gif file.

==See also==

*[[HTML editor FAQ]]
*[[Page content]] - for more assistance on using some of above editing icons
*[[Insert image]] - examples and instructions for inserting and editing images
*[[HTML in Moodle]]
*[[HTML editor settings]] - change the look of the HTML toolbar

Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=64354 Question about insert image function in HTML editor] including methods of enabling students to insert images using the HTML editor
*[http://moodle.org/mod/forum/discuss.php?d=66805 Need to display english special phonetic symbols for ESL students]
*[http://moodle.org/mod/forum/discuss.php?d=83115 tables in HTML editor]

[[Category:HTML editor]]

[[fr:Éditeur HTML]]
[[ja:HTMLエディタ]]
[[pl:Edytor_HTML]]

HTML editor

2008-10-09T22:31:32Z

Linkupnick: /* Inserting images */

Moodle has developed a standard toolbar that serves as an HTML interface. Many of the icons on the tool bar can be found on most text editing (word processing) programs. This page will cover some of the icons/tools which may not be as familiar to a new user of Moodle.

For example, you can cut/copy and paste text from other applications into this editor and formatting will be preserved. There is the usual [[Image:Ed paste.gif]] clipboard icon which is for pasting text that has been copied or cut. Or use the usual short cut keys of Control+C and Control+V .

==HTML editor toolbar features==
[[Image:Course Lesson Page Content Toolbar.GIF|frame|center|HTML editor toolbar in a Lesson page, other modules will look similar.]]

__TOC__

===Font and background colours===
There are two icons to change the [[Image:Ed color fg.gif]] font and the [[Image:Ed color bg.gif]] colour behind text. Clicking on the icon will bring up a color pallet. Note the HTML color code is displayed.
[[Image:HTML toolbar Color pallet.JPG|center]]

===Anchor===
[[Image:Ed anchor.gif]] An HTML anchor identifies text within a page which can be referenced by a link. To use the Anchor, highlight the word, then click on the Anchor icon. Give the anchor a name. Anywhere on the page, highlight the word you would like to link to the Anchor. Use the Link icon and the pull down menu to find the correct anchor.
[[Image:HTML toolbar anchor tool.JPG]]

===Inserting links===
[[Image:Ed link.gif|left|]] An HTML link creates a path to external, internal or the current page. The icon saves writing code. One method is to copy the address bar from the location you want, click on the link icon,then paste it URL. Another method is to press the Browse button. This will take you to the [[Files]] area of the course. From here it is possible to select an existing file or to upload a new file and link to it.

'''To make a new link'''
*Type the text that you want to be a link
***For example: "Link to course file in demo.moodle.org"
*Select the text
***For example select "course file" by highlighting it with your mouse.
*Click the [[Image:Ed link.gif]] link button in the toolbar
*Type (or paste, or browse to) the URL you want to link to
***For example we used browsed and clicked on the file to get our entry
*Type in some text which will appear when the mouse rolls over it
***For example: "Course file in demo moodle."
*Target - What kind of window should be called up
***[[Image:HTML editor insert link target menu.jpg]]
*Anchors - A pull down list allows you to select an [[HTML_editor#Anchor|anchor]] you created on the page
*Click OK

[[Image:HTML toolbar Hyperlink.JPG|center]]

*After the above steps the student will see:
**[[Image:HTML toolbar Insert Link result1.jpg|frame|center|This result]]

====TIPs - inserting links====
*This process does '''NOT''' work inside the wiki module where you need to use the Wiki link system (square brackets containing the label and the link separated by a vertical line character)
*A course file has a URL address that can be found via the browse button

===Inserting images===
[[Image:Ed_image.gif]] Moodle allows you to upload pictures into a course or site folder, then insert that image into the content area. It is also possible to use an existing image located outside of your Moodle site.

You can include images in the content area by using the [[Image:Ed_image.gif]] button. This will bring up an insert image edit screen to assist you in inserting an picture. More detailed instructions for [[Insert image|inserting an image can be found here]]. Moodle recognizes JPG, GIF and PNG as image files.
[[Image:HTML Insert Image tool pop-up.JPG|thumb|center|300px|[[Insert image| Insert image page link]] in OurVLE Documentation]]

===Inserting tables===
* [[Image:Insert table.gif]] To add layout to your texts, you can use the "Insert Tables" button in the toolbar.

[[Image:HTML toolbar table settings.jpg|center]]
*Most table editing tools are only visible if you click the '''Enlarge Editor''' button.

===Inserting smilies (emoticons)===

The smiley icon [[Image:Smiley.gif]] will allow you to add a small icon (for example [[Image:Cool.gif]] ) in your text. A dialog will pop up that allows you to select from a table of smiley icons. Alternatively, you can just type the corresponding code straight into your text and it will be converted later when your text is displayed.
[[Image:HTML toolbar Smiley icon selections.JPG|center]]

===Special characters===
The special characters [[Image:special characters button.gif]] button, allows you to enter special characters from a table.
[[Image:HTML_toolbar_Special_character_selections.JPG|center]]

===Toggle to HTML Code editing===

The [[Image: Ed html.gif]] button changes the display window to raw HTML code. This can be useful for those of you that know how to use it (or want to learn!). Most of the buttons do not work in this view, including many of the hotkeys.

[[Image:HTML editor HTML code example.png|thumb|center|400px|Example of HTML code for content area in a forum post ]]

===Enlarge editor===
The [[Image:Fullscreen maximize.gif]] button will expand the HTML editor area.

===Clean Word button===
The clean Word [[Image:Ed wordclean.gif]] button removes some Word formatting from your pasted text so that the page is smaller, less complex and thus loads faster. The [http://www.microsoft.com/downloads/details.aspx?FamilyID=209ADBEE-3FBD-482C-83B0-96FB79B74DED&displaylang=EN Microsoft Office HTML Filter 2.0] removes all Word code from HTML file far more effectively. This filter is already built into office in Microsoft Office XP onwards.

==Shortcut keys==
Here are some common editing short cut or hot keys which will within the HTML editor in WYSIWYG view. Different operating systems and browsers may not support all these keys. The most universal hot keys are in''' bold'''.
{| border="0" cellpadding="2" cellspacing="0" style="text-align:left"
! width="70"|Keys
! width="300"|Action
! width="10"|
! width="70"|Keys
! width="300"|Action

|-
| '''Ctrl-C'''
| Copy
|
| '''Ctrl-V'''
| Paste

|-
| '''Ctrl-X'''
| Cut
|
| '''Ctrl-F'''
| Find text

|-
| Ctrl-H
| Find and replace
|
| *
| *

|-
| '''Ctrl-Z'''
| Undo
|
| '''Ctrl-Y'''
| Redo

|-
| '''Ctrl-B'''
| Make text bold
|
| '''Ctrl-I'''
| Make text italic

|-
| '''Ctrl-U'''
| Underline text
|
| '''Ctrl-S'''
| Strikethrough text

|-
| Ctrl-H
| Change text format (headings etc.)
|
| Ctrl-1
| to Ctrl-6 Change heading level

|-
| Ctrl-,
| Subscript
|
| Ctrl-.
| Superscript

|-
| Ctrl-O
| Change the font
|
| Ctrl-0
| Clean Word HTML

|-
| Ctrl-L
| Justify left
|
| Ctrl-E
| Center

|-
| Ctrl-J
| Justify full
|
| Ctrl-/
| Text runs left to right

|-
| Ctrl-<nowiki>|</nowiki>
| Text runs right to left
|
| Ctrl-;
| Decrease indent

|-
| Ctrl-'
| Increase indent
|
| Ctrl-G
| Change text colour

|-
| Ctrl-K
| Change background colour
|
| Ctrl-P
| Change the font size

|-
| Ctrl-`
| Switch to HTML source code view
|
| Ctrl-M
| Toggle fullscreen editor mode

|-
| Ctrl-Alt-O
| Insert ordered list
|
| Ctrl-Alt-U
| Insert unordered list

|-
| Ctrl-Alt-R
| Insert horizontal rule
|
| Ctrl-Alt-A
| Create anchor

|-
| Ctrl-Alt-L
| Create link
|
| Ctrl-Alt-D
| Unlink

|-
| Ctrl-Alt-N
| Turn off autolinking
|
| Ctrl-Alt-I
| Insert image

|-
| Ctrl-Alt-T
| Insert table
|
| Ctrl-Alt-S
| Insert emoticon

|-
| Ctrl-Alt-C
| Insert special character
|
| Ctrl-=
| Change text language for screen readers, or specify language for the Multilang filter

|}

==Tips and Tricks==
*[[Themes|Theme]] settings can control the default fonts in the HTML editor. It is possible to have individual themes for a context (for example, a course may have its own theme).

*When you choose many functions a new small window will open. Unfortunately it can often open BEHIND the window you are in so you may miss that anything has happened. You can check new windows with [Alt]+[Tab].

*The HTML editor does not work in all browsers. If you are using a Mac OS X and for some reason it does not appear, try using Firefox instead of Safari as a browser.

*Can not make HTML give you the text style you want? Use an image or even an animated gif file.

==See also==

*[[HTML editor FAQ]]
*[[Page content]] - for more assistance on using some of above editing icons
*[[Insert image]] - examples and instructions for inserting and editing images
*[[HTML in Moodle]]
*[[HTML editor settings]] - change the look of the HTML toolbar

Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=64354 Question about insert image function in HTML editor] including methods of enabling students to insert images using the HTML editor
*[http://moodle.org/mod/forum/discuss.php?d=66805 Need to display english special phonetic symbols for ESL students]
*[http://moodle.org/mod/forum/discuss.php?d=83115 tables in HTML editor]

[[Category:HTML editor]]

[[fr:Éditeur HTML]]
[[ja:HTMLエディタ]]
[[pl:Edytor_HTML]]