MoodleDocs - User contributions [en]

Adding/editing a glossary

2010-04-14T07:54:19Z

Petr.sudicky:

{{Glossaries}}
==Adding a glossary==
[[Image:adding glossary.png|thumb|Adding a glossary]]
To add a glossary:
#Click the "Turn editing on" button.
#Select Glossary from the "Add an activity" dropdown menu.
#On the Adding a new glossary page give your new glossary a descriptive name.
#Describe the purpose of the glossary, provide instructions or background information, links etc. in the Description area.
#Select the general and grade options and the common module settings (see below).
#Click the "Save changes" button at the bottom of the page.
__TOC__

==General options==

===Entries shown per page===

This sets the number of words and definitions that students will see when they view the glossary list. If you have a large number of automatically-linked entries you should set this number lower to prevent long loading times.

===Is this glossary global?===

Administrators can make a global glossary, with entries linking throughout the whole Moodle site. Any course may contain a global glossary, though the best practice is to place a global glossary on the site front page.

===Glossary type===

Here you can decide whether the glossary will be main or secondary. The glossary system allows you to export entries from any secondary glossary to the main one of the course. In order to do this, you should specify which glossary is the main one. You can only have one main glossary per course.

Note: Prior to Moodle 1.7, only Teachers could edit the main glossary. From Moodle 1.7 onwards, a [[Override roles|role override]] can be used to change glossary permissions.

===Students can add entries===

Prior to Moodle 1.7, you can specify whether a student may add, edit or delete their own entries. Entries exported to a main glossary can be updated or deleted by teachers only, so this setting only applies to secondary glossaries. (A teacher can edit or delete any entry at any time.)

Note: From Moodle 1.7 onwards, this option has been replaced with a role override and preventing the capability [[Capabilities/mod/glossary:write|mod/glossary:write]].

===Duplicated entries allowed===

This allows the entry of more than one definition for a given word.

===Allow comments on entries===

Students and teachers can leave comments on glossary definitions. The comments are available through a link at the bottom of the definition.

===Allow print view===

This provides a printer-friendly version link for students. (Teachers are always provided with a printer-friendly version link.)

===Automatically link glossary entries===

If site-wide glossary auto-linking is enabled by an administrator (see [[Filters]] for further details), then turning this on allows individual entries in this glossary to be automatically linked whenever the concept words and phrases appear throughout the rest of the same course. This includes forum postings, internal resources, week summaries and so on.

Note: Enabling linking for the glossary does not automatically turn on linking for each entry - linking needs to be set for each entry individually. If you do not want particular text to be linked (in a forum posting, say) then you should add <nolink> and </nolink> tags around the text. Note that category names are also linked.

===Approved by default===

That allows the teacher to define what happens to new entries added by students. They can be automatically made available to everyone, otherwise the teacher will have to approve each one.

===Display format===

That specifies the way that each entry will be shown within the glossary. The default formats are:

* Simple, dictionary style - This looks like a conventional dictionary with separate entries. No authors are displayed and attachments are shown as links.
* Continuous without author - That shows the entries one after other without any kind of separation but the editing icons.
* Full with author - A forum-like display format showing author's data. Attachments are shown as links.
* Full without author - A forum-like display format that does not show author's data. Attachments are shown as links.
* Encyclopedia - Like 'Full with author' but attached images are shown inline.
* Entry list - This lists the concepts as links.
* FAQ - Useful for displaying lists of frequently asked questions. It automatically appends the words QUESTION and ANSWER in the concept and definition respectively.

The table below summarises the different display formats.
<table style="text-align: center;" border="1" cellpadding="2" cellspacing="0">
<tr>
<th style="text-align: left; width: 15em;">Format</th>
<th style="width: 4em;">Entry</th>
<th style="width: 4em;">Author</th>
<th style="width: 4em;">Date</th>

<th style="width: 4em;">Definition</th>
<th style="width: 4em;">Images</th>
<th style="width: 4em;">Attachments</th>
</tr>
<tr>
<td style="text-align: left;">Entry list</td>
<td>x</td>

<td>- </td>
<td>-</td>
<td>x*</td>
<td>x*</td>
<td>link*</td>
</tr>

<tr>
<td style="text-align: left;">Simple Dictionary</td>
<td>x</td>
<td>-</td>
<td>-</td>
<td>x</td>

<td>x</td>
<td>link</td>
</tr>
<tr>
<td style="text-align: left;">Continuous</td>
<td>x</td>
<td>-</td>

<td>-</td>
<td>x</td>
<td>x</td>
<td>link</td>
</tr>
<tr>
<td style="text-align: left;">FAQ</td>

<td>x</td>
<td>-</td>
<td>x</td>
<td>x</td>
<td>x</td>
<td>link</td>

</tr>
<tr>
<td style="text-align: left;">Full without Author</td>
<td>x</td>
<td>-</td>
<td>x</td>
<td>x</td>

<td>x</td>
<td>link</td>
</tr>
<tr>
<td style="text-align: left;">Full with Author</td>
<td>x</td>
<td>x</td>

<td>x</td>
<td>x</td>
<td>x</td>
<td>link</td>
</tr>
<tr>
<td style="text-align: left;">Encyclopedia</td>

<td>x</td>
<td>x</td>
<td>x</td>
<td>x</td>
<td>x</td>
<td>x**</td>

</tr>
</table>
<p>* Will be shown in a pop-up window.</p>
<p>* * Attached images are shown inline.</p>

===Browsing options in alphabet display===

You can customize the way a user can browse a glossary. Browsing and searching are always available, but you can define three more options:
* Show "Special" link - Enable or disable browsing by special characters like @, #, etc.
* Show alphabet - Enable or disable browsing by alphabetic letters.
* Show "All" link - Enable or disable browsing of all entries at once.

===Edit always===
If you want entries to be always editable, set this to Yes.

==Grade options==

===Allow entries to be rated===

You can grade entries yourself or allow students to grade entries as well. Select "Only teachers" or "Everyone" from the users menu. Then select a grading scale. You can also restrict when entries can be graded to a specific date range.

==Common module settings==

===Group mode===

Another location to set the group mode for the activity. If group mode is forced in the course settings then this setting will be ignored.

===Visible to students===

You can also decide on whether or not the glossary will be seen by the students. You can hide the activity from students by selecting 'Hide'. It is useful if you don't want to make the activity available immediately.

==See also==

*[http://www.youtube.com/watch?v=1b2FHIrK5S8 Video showing how to create a glossary]

[[cs:Přidání/úprava_slovníku]]
[[de:Glossar_anlegen]]
[[fr:Ajouter/Éditer un glossaire]]
[[ja:用語集を追加/編集する]]

Import glossary entries

2010-03-18T11:06:17Z

Petr.sudicky:

{{Glossaries}}
==Importing entries==

To import glossary entries via an XML file:

#Follow the "Import entries" link at the top right of the main glossary page.
#Browse for the exported entries XML file on your computer.
#Select the destination for the new entries, either the current glossary or a new one.
#If you want to import category information, click the checkbox.
#Click the "Save changes" button. You'll then see a report of the entries and categories added to the glossary. If you enabled duplicate entries when you created the glossary, the import process will add all of the new definitions. Otherwise, it will not allow you to import any duplicate entries.

== Troubleshooting ==

Possible causes of problems importing entries:
* If there are mistakes in the XML file such as the <entries> tag being missing or the <info> tag being in the wrong place. May happen if you have constructed the XML file manually or with some sort of tool like mailmerge in Word and your template is wrong.
* If there are top bit set characters in the text of the entities like concepts, definitions or keywords. Replace things like & with &amp;
* If there are tabs or spaces between entries. Not sure if spaces cause problems but best to remove any between the end of one tag and start of the next. e.g. Search and replace > < with >< via a text editor.
* In most cases the import is halted if any of these errors occur.
* Duplicates in the entries which clash with entries already when merging a glossary is usually not a problem.
* Warnings like <code>Warning: exec() has been disabled for security reasons in /moodle/lib/uploadlib.php on line 603</code> may not be the problem when importing but may distract one from dealing with problems with the format of the XML file.
* HTML and XHTML tags written within CONCEPT or DEFINITION elements will fail on import, showing "Array" instead of the desired content. To remedy this, try writing the (X)HTML tags within <![CDATA[ ]]> markup.
* If the glossary entries contain images, image paths will need amending in order for the images to be displayed when the file is imported. A search and replace in the XML file before importing is one option, another is to use the [[Search and replace]] feature within Moodle.

==Restoring a course backup==

An alternative method of importing glossary entries is to restore a Moodle course backup file containing a glossary. This method includes categories, images and attachments within glossary entries and if you also select users then the authors of entries are also imported if they were originally included in the backup.

== Importing from Excel ==
* [http://www.irpens.co.uk/moodle/MoodleExcelToGlossary.xls David Fountain's Excel macro] An Excel workbook with macros to create an XML file.
* [http://moodle.org/mod/forum/discuss.php?d=91224&parent=489666 Yasu Imao's Moodle glossaryXMLconverter_html 4] A JavaScript based converter, works directly in your browser.
:(Both above methods are detailed [http://moodle.org/mod/forum/discuss.php?d=79120#p536148 in this discussion].)

* [http://moodle.org/mod/forum/discuss.php?d=123277 Importing into Moodle] contains an explanation of how to manually create an XML file from an Excel spreadsheet.

== Importing glossaries in WebCT format ==

See this [http://moodle.org/mod/forum/discuss.php?d=10570 Using Moodle forum discussion]

== See also ==

* [http://moodle.org/mod/glossary/view.php?id=851 Glossary of common terms] with entries download link for importing to other Moodle sites
* [[Import and export FAQ]]
* [[XML FAQ]]

* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=142346 Backup a glossary] forum discussion

[[cs:Import slovníkových položek]]
[[de:Glossareinträge_importieren]]
[[fr:Importer/exporter un glossaire]]

Course sections

2010-03-02T10:02:45Z

Petr.sudicky:

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

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

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

Earlier versions have fewer selections.

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

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

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

==Editing sections==
The top most section may act as a header and usually contains the [[News forum]]. Like other sections, it has an HTML editor.

Below is an example of a topic section "1" as seen by the teacher in edit mode. The topic does not have a title but does have a course called "New Lesson Topic 1". For help with understanding the icons go to [[Adding/editing_a_course#Editing_A_Course|editing a course]].

[[Image:Section edit mu1.jpg|frame|Section seen by teacher with edit turned on, showing edit icons|center]]

In edit mode, sections can be moved, hidden from students, highlighted or turned on (section edit icons) , plus given titles in the section description area. Also in edit mode it is possible to move [[Activity modules|activity]] or [[Resources|resource]] in the course, plus delete, hide or edit their settings by using the activity edit icons.

Here is an example of a section description being edited with the HTML editor.

[[Image:Section header edit.jpg|frame|center|Section description in edit mode <br>From [http://demo.moodle.org demo.moodle.org] '''Features Demo''', the header description for it's sections]]

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

There are also contributed modules such as [[Activity Locking]] which will reveal an activity or a section only when the student has completed other activities, that will show their controls in edit mode.

===Tips & Tricks===
*If you want to have a super-short course that is JUST the top with no section blocks, note that you must have at least one section under course settings. The solution is to have the number of weeks/topics set to 1 and make Hidden sections "..completely invisible" under course settings. Finally, in edit mode hide section 1. Now you have a "one main area" course.

==See also==
*[[Course_homepage#Standard_view_of_a_blank_course|Parts of a course home page]]
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=16865 Removing topics/blocks from courses] forum discussion
* [[Project_Course_Format|Project Course Format: a contributed section format for project-based learning.]]

[[Category:Teacher]]

[[cs:Uspořádání kurzu]]
[[de:Kursabschnitte]]
[[es:Secciones del curso]]
[[fr:Sections_de_cours]]
[[ja:コースセクション]]

Course sections

2010-03-02T10:01:35Z

Petr.sudicky:

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

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

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

Earlier versions have fewer selections.

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

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

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

==Editing sections==
The top most section may act as a header and usually contains the [[News forum]]. Like other sections, it has an HTML editor.

Below is an example of a topic section "1" as seen by the teacher in edit mode. The topic does not have a title but does have a course called "New Lesson Topic 1". For help with understanding the icons go to [[Adding/editing_a_course#Editing_A_Course|editing a course]].

[[Image:Section edit mu1.jpg|frame|Section seen by teacher with edit turned on, showing edit icons|center]]

In edit mode, sections can be moved, hidden from students, highlighted or turned on (section edit icons) , plus given titles in the section description area. Also in edit mode it is possible to move [[Activity modules|activity]] or [[Resources|resource]] in the course, plus delete, hide or edit their settings by using the activity edit icons.

Here is an example of a section description being edited with the HTML editor.

[[Image:Section header edit.jpg|frame|center|Section description in edit mode <br>From [http://demo.moodle.org demo.moodle.org] '''Features Demo''', the header description for it's sections]]

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

There are also contributed modules such as [[Activity Locking]] which will reveal an activity or a section only when the student has completed other activities, that will show their controls in edit mode.

===Tips & Tricks===
*If you want to have a super-short course that is JUST the top with no section blocks, note that you must have at least one section under course settings. The solution is to have the number of weeks/topics set to 1 and make Hidden sections "..completely invisible" under course settings. Finally, in edit mode hide section 1. Now you have a "one main area" course.

==See also==
*[[Course_homepage#Standard_view_of_a_blank_course|Parts of a course home page]]
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=16865 Removing topics/blocks from courses] forum discussion
* [[Project_Course_Format|Project Course Format: a contributed section format for project-based learning.]]

[[Category:Teacher]]

[[es:Secciones del curso]]
[[fr:Sections_de_cours]]
[[ja:コースセクション]]
[[de:Kursabschnitte]]
[[cs:Uspořádání kurzu]]

HiddenText filter

2010-03-02T08:25:31Z

Petr.sudicky:

[[Image:HiddenText logo.gif|right]]
Using filter "HiddenText" teachers will be able to provide "hints" to students where the information is initially hidden but can easily be revealed by student in any time when he need.

== Installing ==

# Download filter from [http://moodle.org/mod/data/view.php?d=13&rid=1101 download page]
# Copy folder ''hiddentext'' into directory ''filter'' of your Moodle instalation.
# Copy language file into your "lang" directory.
# Enable it from "Administration/Modules/Filters".

== Using ==

# Create your content.
# Enclose every part which you want initially hide between:
#* '''<nowiki><span filter="hiddentext"></nowiki>'''hidden_content_here'''<nowiki></span></nowiki>''' or
#* '''<nowiki><div filter="hiddentext"></nowiki>'''hidden_multiline_content_here'''<nowiki></div></nowiki>'''
# Use ''span'' tag if you want hide path of text inside paragraph and ''div'' if text can take more than one line.
# If you use ''HTMLeditor'' you can type ''span'' and ''div'' tags inside square brackets straight in text without switching to HTML mode:
#* '''[span filter="hiddentext"]'''hidden_content_here'''[/span]'''
# Test it.

== How it works ==

* After page loaded any content between tags hides. In this place will be dislpayed picture with eye.
* When student will click on eye icon hidden text will be displayed.

== Additional information ==

You can use two optional parameters: ''class'' and ''desc'' (description):
* '''class''' - lets you change style of hidden text
* '''desc''' - lets you change description which displayed after eye icon. If ''desc'' absent in ''div'' tag will be used description from lang file. If description absent in ''span'' tag will be displayed only eye icon.

You available following styles: ''hinline'', ''htext'', ''hcode'' and styles which you add themselves in css of your theme or already there are!

Don't like embedded styles? You can change them in yuidomcollapse.css and send to me... ;-)

== Examples ==

=== Simple SPAN ===

<nowiki>This text is <span filter="hiddentext">very, very, very</span> long.</nowiki>

Will initially displayed as:

[[Image:HiddenText_example_11.png]]

After click:

[[Image:HiddenText_example_12.png]]

=== SPAN with description ===

<nowiki>The American holiday of Thanksgiving is celebrated
on the <span filter="hiddentext" desc="What?">fourth</span> Thursday of November.</nowiki>

Will initially displayed as:

[[Image:HiddenText_example_21.png]]

After click:

[[Image:HiddenText_example_22.png]]

=== DIV with class and description ===

<nowiki>Mention capitals of following countries: Canada, Italy, Japan
<div filter="hiddentext" class="htext" desc="Answer here">Canada - Ottawa
Italy - Rome
Japan - Tokyo</div></nowiki>

Will initially displayed as:

[[Image:HiddenText_example_31.png]]

After click:

[[Image:HiddenText_example_32.png]]

== See also ==

* [http://moodle.org/mod/data/view.php?d=13&rid=1101 Download page]
* [http://moodle.org/mod/forum/view.php?id=1510 Forum about Filters]
* [http://www.elearning-factory.de/moodle/course/view.php?id=28 Support page on German] (thanks to Andy Tagliani)

[[Category:Administrator]]
[[Category:Teacher]]
[[Category:Filter]]

[[cs:Filtr Skrytý text]]
[[ru:Фильтр HiddenText]]