MoodleDocs - User contributions [en]

Database export

2007-10-25T13:31:32Z

Lmagnus:

The [[Database_templates#List_template|list template]] can be used to export your database as a CSV file in the following way. It is assumed that you have a database with N fields, and that in this example the fields are named field1, field2 ... until fieldN.

== Header ==

In the header create a comma separated list of the field names

<pre>
field1,field2,...,fieldN
</pre>

== Repeated entry ==

In the repeated entry create a comma separated list of the field tags

<pre>
[[field1]],[[field2]],...,[[fieldN]]
</pre>

Save the template!

== Export ==

To export, simply select the View List tab and all your data will be in the CSV format. By default only 10 records are displayed, but this can be increased. Copy and paste to your required tool.

[[Category:Database]]

Database export

2007-10-25T13:22:15Z

Lmagnus:

The [[Database_templates#List_template|list template]] can be used to export your database in the following way. It is assumed that you have a database with N fields, and that in this example the fields are named field1, field2 ... until fieldN.

== Header ==

In the header create a comma separated list of the field names

<pre>
field1,field2,...,fieldN
</pre>

== Repeated entry ==

In the repeated entry create a comma separated list of the field tags

<pre>
[[field1]],[[field2]],...,[[fieldN]]
</pre>

Save the template!

== Export ==

To export, simply select the View List tab and all your data will be in the CSV format. By default only 10 records are displayed, but this can be increased. Copy and paste to your required tool.

[[Category:Database]]

Database export

2007-10-25T13:18:28Z

Lmagnus:

Database export

2007-10-25T13:14:51Z

Lmagnus:

The list template can be used to export your database in the following way. It is assumed that you have a database with N fields, and that in this example the fields are named field1, field2 ... until fieldN.

== Header ==

In the header create a comma separated list of the field names

<pre>
field1,field2,...,fieldN
</pre>

== Repeated entry ==

In the repeated entry create a comma separated list of the field tags

<pre>
[[field1]],[[field2]],...,[[fieldN]]
</pre>

Save the template!

== Export ==

To export, simply select the View List tab and all your data will be in the CSV format. By default only 10 records are displayed, but this can be increased. Copy and paste to your required tool.

Database templates

2007-10-25T13:00:56Z

Lmagnus: Database export hack

{{Databases}}
Templates for the [[Database module]] allow you to control the visual layout of information when listing, viewing or editing database entries. It is a similar to the technique used to ''mail merge'' letters in word proccessors such as Open Office Writer or Microsoft Word.

== Tag usage ==

The content of each [[Database fields|field]] you create for your database and a few special tags (listed below) can be inserted into the output template by the use of tags. To use the tags found on the left side, use the HTML viewer, place your cursor in the text area of your target edit and then click on the tag you want to place. Or simply type the appropriate name within the required symbols like <nowiki>##this## or [[this]]</nowiki>.

* ##Edit## creates a clickable icon link that allows you to edit the current entry (only appears if you have the rights to do this)
* ##More## creates a link to the single view, which may contain more detailed info
* ##MoreURL## creates just the URL for the above link, useful for creating your own links. Please note that there is no any space between 'More' and 'URL'. You can click on the link icon and type ##MoreURL## into URL field or in source view type: <a href="##moreurl##"><nowiki>[[fieldname]]</nowiki></a>
* ##Delete## creates a link that lets you delete the current entry (only appears if you have the rights to do this)
* ##Approve## create a link that lets you approve the current database entry (only appears if you have the rights to do this)
* ##Comments## creates a link to the view/edit comments page, the link text is the current number of comments (only appears if comments are turned on)
* ##User## creates a link to the user page of the user who submitted the entry, link text is their name

Here's a video demonstrating tag usage:
http://video.google.com/videoplay?docid=7026851446099005477

== List template ==

This template allows you to control the fields used and their layout when viewing multiple entries at once (e.g. search results). It is possible that this view may simply provide an overview with more detailed information available by clicking on an entry to access the single view of the entry.

The list template can also be used as a way to [[Database export|export your database]] as a CSV file

== Single template ==

This is used to display a single entry at a time and so has more space for display and can use, for example, larger versions of images or optionally provide more information than shown in the list view.

== Add template ==

This template creates the interface form used when adding or editing database entries. Saving a template will overwrite whatever template you have already saved. The ability to create (and import and export) named templates for re-use is planned but not yet functional. Currently you can
copy and paste your template for reuse elsewhere.

== RSS template ==

Lets you control the content of the [[RSS]] feed for database entries.

== CSS template ==

If any of the [[HTML]] in your other templates requires [[CSS]] to provide visual style you can specify it here.

== Javascript template ==

You can use javascript to manipulate the way elements are displayed in either the List, Single or Add templates. Basically you need to enclose the part you want to manipulate in some named html element. The naming is essential as it allows you to identify the element for manipulation.

Lets say, for example, you have a field in your database that stores a persons name and when you display the names in the List View you want to count the times a name matches some criteria and display the result.

Your database will contain a field which we will call "name". In your List template you will be able to display the contents of that field by using the <nowiki>[[name]]</nowiki> construct at the place where you want that information displayed. For example in the ''Repeated entry'' on the list template you will have

<pre>
<table>
<tr>
<td>Name: [[name]]</td>
</tr>
<table>
</pre>

You now need to modify that entry to ensure that the part you want to manipulate is a named element.

<pre>
<table>
<tr>
<td name="named">Name: [[name]]</td>
</tr>
<table>
</pre>

The footer of your list view can then contain another named element to display the result.

<pre>
<div name="result"></div>
</pre>

Your javascript template can now look as follows

<pre>
var cnt = 0;
var re = /foo|Foo/;

function init(){
var namedElements = document.getElementsByName("named");
for (i=0; i < namedElements.length; i++) {
if(re.test(namedElements[i].innerHTML)) cnt++;
}
var namedResult = document.getElementsByName("result");
namedResult[0].innerHTML = cnt;
}

window.onload = init;
</pre>

This will display a table of names as is usual in the list view. Now at the bottom there will also be the count of the names that matched foo or Foo.

== Reset templates button ==

When you first create a database the templates will be pre-filled with appropriate HTML. If you later add fields then you can press the ''reset templates'' button and it will add HTML for the new fields in a similar fashion. If you have edited any of the templates in the meantime then your changes will be lost. It is recommended that you finalize the database fields before changing the template code.

==See also==

Some Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=55338 Look of the database module]
*[http://moodle.org/mod/forum/discuss.php?d=74243 How can I list database information horizontally instead of vertically?]
*[http://moodle.org/mod/forum/discuss.php?d=61179 For those who want the display of Moodle Site's Modules and plugins]

[[fr:Modèles]]
[[ru:Шаблоны]]

Database templates

2007-10-25T11:07:04Z

Lmagnus: /* Javascript template */

{{Databases}}
Templates for the [[Database module]] allow you to control the visual layout of information when listing, viewing or editing database entries. It is a similar to the technique used to ''mail merge'' letters in word proccessors such as Open Office Writer or Microsoft Word.

== Tag usage ==

The content of each [[Database fields|field]] you create for your database and a few special tags (listed below) can be inserted into the output template by the use of tags. To use the tags found on the left side, use the HTML viewer, place your cursor in the text area of your target edit and then click on the tag you want to place. Or simply type the appropriate name within the required symbols like <nowiki>##this## or [[this]]</nowiki>.

* ##Edit## creates a clickable icon link that allows you to edit the current entry (only appears if you have the rights to do this)
* ##More## creates a link to the single view, which may contain more detailed info
* ##MoreURL## creates just the URL for the above link, useful for creating your own links. Please note that there is no any space between 'More' and 'URL'. You can click on the link icon and type ##MoreURL## into URL field or in source view type: <a href="##moreurl##"><nowiki>[[fieldname]]</nowiki></a>
* ##Delete## creates a link that lets you delete the current entry (only appears if you have the rights to do this)
* ##Approve## create a link that lets you approve the current database entry (only appears if you have the rights to do this)
* ##Comments## creates a link to the view/edit comments page, the link text is the current number of comments (only appears if comments are turned on)
* ##User## creates a link to the user page of the user who submitted the entry, link text is their name

Here's a video demonstrating tag usage:
http://video.google.com/videoplay?docid=7026851446099005477

== List template ==

This template allows you to control the fields used and their layout when viewing multiple entries at once (e.g. search results). It is possible that this view may simply provide an overview with more detailed information available by clicking on an entry to access the single view of the entry.

== Single template ==

This is used to display a single entry at a time and so has more space for display and can use, for example, larger versions of images or optionally provide more information than shown in the list view.

== Add template ==

This template creates the interface form used when adding or editing database entries. Saving a template will overwrite whatever template you have already saved. The ability to create (and import and export) named templates for re-use is planned but not yet functional. Currently you can
copy and paste your template for reuse elsewhere.

== RSS template ==

Lets you control the content of the [[RSS]] feed for database entries.

== CSS template ==

If any of the [[HTML]] in your other templates requires [[CSS]] to provide visual style you can specify it here.

== Javascript template ==

You can use javascript to manipulate the way elements are displayed in either the List, Single or Add templates. Basically you need to enclose the part you want to manipulate in some named html element. The naming is essential as it allows you to identify the element for manipulation.

Lets say, for example, you have a field in your database that stores a persons name and when you display the names in the List View you want to count the times a name matches some criteria and display the result.

Your database will contain a field which we will call "name". In your List template you will be able to display the contents of that field by using the <nowiki>[[name]]</nowiki> construct at the place where you want that information displayed. For example in the ''Repeated entry'' on the list template you will have

<pre>
<table>
<tr>
<td>Name: [[name]]</td>
</tr>
<table>
</pre>

You now need to modify that entry to ensure that the part you want to manipulate is a named element.

<pre>
<table>
<tr>
<td name="named">Name: [[name]]</td>
</tr>
<table>
</pre>

The footer of your list view can then contain another named element to display the result.

<pre>
<div name="result"></div>
</pre>

Your javascript template can now look as follows

<pre>
var cnt = 0;
var re = /foo|Foo/;

function init(){
var namedElements = document.getElementsByName("named");
for (i=0; i < namedElements.length; i++) {
if(re.test(namedElements[i].innerHTML)) cnt++;
}
var namedResult = document.getElementsByName("result");
namedResult[0].innerHTML = cnt;
}

window.onload = init;
</pre>

This will display a table of names as is usual in the list view. Now at the bottom there will also be the count of the names that matched foo or Foo.

== Reset templates button ==

When you first create a database the templates will be pre-filled with appropriate HTML. If you later add fields then you can press the ''reset templates'' button and it will add HTML for the new fields in a similar fashion. If you have edited any of the templates in the meantime then your changes will be lost. It is recommended that you finalize the database fields before changing the template code.

==See also==

Some Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=55338 Look of the database module]
*[http://moodle.org/mod/forum/discuss.php?d=74243 How can I list database information horizontally instead of vertically?]
*[http://moodle.org/mod/forum/discuss.php?d=61179 For those who want the display of Moodle Site's Modules and plugins]

[[fr:Modèles]]
[[ru:Шаблоны]]

Database templates

2007-10-25T11:05:04Z

Lmagnus: /* Javascript template */

{{Databases}}
Templates for the [[Database module]] allow you to control the visual layout of information when listing, viewing or editing database entries. It is a similar to the technique used to ''mail merge'' letters in word proccessors such as Open Office Writer or Microsoft Word.

== Tag usage ==

The content of each [[Database fields|field]] you create for your database and a few special tags (listed below) can be inserted into the output template by the use of tags. To use the tags found on the left side, use the HTML viewer, place your cursor in the text area of your target edit and then click on the tag you want to place. Or simply type the appropriate name within the required symbols like <nowiki>##this## or [[this]]</nowiki>.

* ##Edit## creates a clickable icon link that allows you to edit the current entry (only appears if you have the rights to do this)
* ##More## creates a link to the single view, which may contain more detailed info
* ##MoreURL## creates just the URL for the above link, useful for creating your own links. Please note that there is no any space between 'More' and 'URL'. You can click on the link icon and type ##MoreURL## into URL field or in source view type: <a href="##moreurl##"><nowiki>[[fieldname]]</nowiki></a>
* ##Delete## creates a link that lets you delete the current entry (only appears if you have the rights to do this)
* ##Approve## create a link that lets you approve the current database entry (only appears if you have the rights to do this)
* ##Comments## creates a link to the view/edit comments page, the link text is the current number of comments (only appears if comments are turned on)
* ##User## creates a link to the user page of the user who submitted the entry, link text is their name

Here's a video demonstrating tag usage:
http://video.google.com/videoplay?docid=7026851446099005477

== List template ==

This template allows you to control the fields used and their layout when viewing multiple entries at once (e.g. search results). It is possible that this view may simply provide an overview with more detailed information available by clicking on an entry to access the single view of the entry.

== Single template ==

This is used to display a single entry at a time and so has more space for display and can use, for example, larger versions of images or optionally provide more information than shown in the list view.

== Add template ==

This template creates the interface form used when adding or editing database entries. Saving a template will overwrite whatever template you have already saved. The ability to create (and import and export) named templates for re-use is planned but not yet functional. Currently you can
copy and paste your template for reuse elsewhere.

== RSS template ==

Lets you control the content of the [[RSS]] feed for database entries.

== CSS template ==

If any of the [[HTML]] in your other templates requires [[CSS]] to provide visual style you can specify it here.

== Javascript template ==

You can use javascript to manipulate the way elements are displayed in either the List, Single or Add templates. Basically you need to enclose the part you want to manipulate in some named html element. The naming is essential as it allows you to identify the element for manipulation.

Lets say, for example, you have a field in your database that stores a persons name and when you display the names in the List View you want to count the times a name matches some criteria and display the result.

Your database will contain a field which we will call "name". In your List template you will be able to display the contents of that field by using the <nowiki>[[name]]</nowiki> construct at the place where you want that information displayed. For example in the ''Repeated entry'' on the list template you will have

<pre>
<table>
<tr>
<td>Name: [[name]]</td>
</tr>
<table>
</pre>

You now need to modify that entry to ensure that the part you want to manipulate is a named element.

<pre>
<table>
<tr>
<td name="named">Name: [[name]]</td>
</tr>
<table>
</pre>

The footer of your list view can then contain another named element to display the result.

<pre>
<div name="result"></div>
</pre>

Your javascript template can now look as follows

<pre>
var cnt = 0;
var re = /foo|Foo/;

function init(){
var namedElements = document.getElementsByName("named");
for (i=0; i < namedElements.length; i++) {
if(re.test(namedElements[i].innerHTML.match)) cnt++;
}
var namedResult = document.getElementsByName("result");
namedResult[0].innerHTML = cnt;
}

window.onload = init;
</pre>

This will display a table of names as is usual in the list view. Now at the bottom there will also be the count of the names that matched foo or Foo.

== Reset templates button ==

When you first create a database the templates will be pre-filled with appropriate HTML. If you later add fields then you can press the ''reset templates'' button and it will add HTML for the new fields in a similar fashion. If you have edited any of the templates in the meantime then your changes will be lost. It is recommended that you finalize the database fields before changing the template code.

==See also==

Some Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=55338 Look of the database module]
*[http://moodle.org/mod/forum/discuss.php?d=74243 How can I list database information horizontally instead of vertically?]
*[http://moodle.org/mod/forum/discuss.php?d=61179 For those who want the display of Moodle Site's Modules and plugins]

[[fr:Modèles]]
[[ru:Шаблоны]]

Database templates

2007-10-25T10:57:18Z

Lmagnus: /* Javascript template */

{{Databases}}
Templates for the [[Database module]] allow you to control the visual layout of information when listing, viewing or editing database entries. It is a similar to the technique used to ''mail merge'' letters in word proccessors such as Open Office Writer or Microsoft Word.

== Tag usage ==

The content of each [[Database fields|field]] you create for your database and a few special tags (listed below) can be inserted into the output template by the use of tags. To use the tags found on the left side, use the HTML viewer, place your cursor in the text area of your target edit and then click on the tag you want to place. Or simply type the appropriate name within the required symbols like <nowiki>##this## or [[this]]</nowiki>.

* ##Edit## creates a clickable icon link that allows you to edit the current entry (only appears if you have the rights to do this)
* ##More## creates a link to the single view, which may contain more detailed info
* ##MoreURL## creates just the URL for the above link, useful for creating your own links. Please note that there is no any space between 'More' and 'URL'. You can click on the link icon and type ##MoreURL## into URL field or in source view type: <a href="##moreurl##"><nowiki>[[fieldname]]</nowiki></a>
* ##Delete## creates a link that lets you delete the current entry (only appears if you have the rights to do this)
* ##Approve## create a link that lets you approve the current database entry (only appears if you have the rights to do this)
* ##Comments## creates a link to the view/edit comments page, the link text is the current number of comments (only appears if comments are turned on)
* ##User## creates a link to the user page of the user who submitted the entry, link text is their name

Here's a video demonstrating tag usage:
http://video.google.com/videoplay?docid=7026851446099005477

== List template ==

This template allows you to control the fields used and their layout when viewing multiple entries at once (e.g. search results). It is possible that this view may simply provide an overview with more detailed information available by clicking on an entry to access the single view of the entry.

== Single template ==

This is used to display a single entry at a time and so has more space for display and can use, for example, larger versions of images or optionally provide more information than shown in the list view.

== Add template ==

This template creates the interface form used when adding or editing database entries. Saving a template will overwrite whatever template you have already saved. The ability to create (and import and export) named templates for re-use is planned but not yet functional. Currently you can
copy and paste your template for reuse elsewhere.

== RSS template ==

Lets you control the content of the [[RSS]] feed for database entries.

== CSS template ==

If any of the [[HTML]] in your other templates requires [[CSS]] to provide visual style you can specify it here.

== Javascript template ==

You can use javascript to manipulate the way elements are displayed in either the List, Single or Add templates. Basically you need to enclose the part you want to manipulate in some named html element. The naming is essential as it allows you to identify the element for manipulation.

Lets say, for example, you have a field in your database that stores a persons name and when you display the names in the List View you want count the time a name matches some criteria and display the result.

Your database will contain a field which we will call "name". In your List template you will be able to display the contents of that field by using the <nowiki>[[name]]</nowiki> construct at the place where you want that information displayed. For example in the ''Repeated entry'' on the list template you will have

<pre>
<table>
<tr>
<td>Name: [[name]]</td>
</tr>
<table>
</pre>

You now need to modify that entry to enclose the part you want to manipulate in a named element.

<pre>
<table>
<tr>
<td name="named">Name: [[name]]</td>
</tr>
<table>
</pre>

The footer of your list view can then contain

<pre>
<div name="result"></div>
</pre>

Your javascript template can now look as follows

<pre>
var cnt = 0;
var re = /foo|Foo/;

function init(){
var namedElements = document.getElementsByName("named");
for (i=0; i < namedElements.length; i++) {
if(re.test(namedElements[i].innerHTML.match)) cnt++;
}
var namedResult = document.getElementsByName("result");
namedResult[0].innerHTML = cnt;
}

window.onload = init;
</pre>

This will display a table of names and at the bottom will be the count of the names that matched foo or Foo.

== Reset templates button ==

When you first create a database the templates will be pre-filled with appropriate HTML. If you later add fields then you can press the ''reset templates'' button and it will add HTML for the new fields in a similar fashion. If you have edited any of the templates in the meantime then your changes will be lost. It is recommended that you finalize the database fields before changing the template code.

==See also==

Some Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=55338 Look of the database module]
*[http://moodle.org/mod/forum/discuss.php?d=74243 How can I list database information horizontally instead of vertically?]
*[http://moodle.org/mod/forum/discuss.php?d=61179 For those who want the display of Moodle Site's Modules and plugins]

[[fr:Modèles]]
[[ru:Шаблоны]]

Database templates

2007-10-25T10:55:12Z

Lmagnus:

{{Databases}}
Templates for the [[Database module]] allow you to control the visual layout of information when listing, viewing or editing database entries. It is a similar to the technique used to ''mail merge'' letters in word proccessors such as Open Office Writer or Microsoft Word.

== Tag usage ==

The content of each [[Database fields|field]] you create for your database and a few special tags (listed below) can be inserted into the output template by the use of tags. To use the tags found on the left side, use the HTML viewer, place your cursor in the text area of your target edit and then click on the tag you want to place. Or simply type the appropriate name within the required symbols like <nowiki>##this## or [[this]]</nowiki>.

* ##Edit## creates a clickable icon link that allows you to edit the current entry (only appears if you have the rights to do this)
* ##More## creates a link to the single view, which may contain more detailed info
* ##MoreURL## creates just the URL for the above link, useful for creating your own links. Please note that there is no any space between 'More' and 'URL'. You can click on the link icon and type ##MoreURL## into URL field or in source view type: <a href="##moreurl##"><nowiki>[[fieldname]]</nowiki></a>
* ##Delete## creates a link that lets you delete the current entry (only appears if you have the rights to do this)
* ##Approve## create a link that lets you approve the current database entry (only appears if you have the rights to do this)
* ##Comments## creates a link to the view/edit comments page, the link text is the current number of comments (only appears if comments are turned on)
* ##User## creates a link to the user page of the user who submitted the entry, link text is their name

Here's a video demonstrating tag usage:
http://video.google.com/videoplay?docid=7026851446099005477

== List template ==

This template allows you to control the fields used and their layout when viewing multiple entries at once (e.g. search results). It is possible that this view may simply provide an overview with more detailed information available by clicking on an entry to access the single view of the entry.

== Single template ==

This is used to display a single entry at a time and so has more space for display and can use, for example, larger versions of images or optionally provide more information than shown in the list view.

== Add template ==

This template creates the interface form used when adding or editing database entries. Saving a template will overwrite whatever template you have already saved. The ability to create (and import and export) named templates for re-use is planned but not yet functional. Currently you can
copy and paste your template for reuse elsewhere.

== RSS template ==

Lets you control the content of the [[RSS]] feed for database entries.

== CSS template ==

If any of the [[HTML]] in your other templates requires [[CSS]] to provide visual style you can specify it here.

== Javascript template ==

You can use javascript to manipulate the way elements are displayed in either the List, Single or Add templates. Basically you need to enclose the part you want to manipulate in some named html element. The naming is essential as it allows you to identify the element for manipulation.

Lets say, for example, you have a field in your database that stores a persons name and when you display the names in the List View you want count the time a name matches some criteria and display the result.

Your database will contain a field which we will call "name". In your List template you will be able to display the contents of that field by using the <nowiki>[[name]]</nowiki> construct at the place where you want that information displayed. For example in the ''Repeated entry'' on the list template you will have

<pre>
<table>
<tr>
<td>Name: [[name]]</td>
</tr>
<table>
</pre>

You now need to modify that entry to enclose the part you want to manipulate in a named element.

<pre>
<table>
<tr>
<td name="named">Name: [[name]]</td>
</tr>
<table>
</pre>

The footer of your list view can then contain

<pre>
<div name="result"></div>
</pre>

Your javascript template can now look as follows

<pre>
var cnt = 0;
var re = /foo|Foo/;

function init(){
var namedElements = document.getElementsByName("named");
for (i=0; i < namedElements.length; i++) {
if(namedElements[i].innerHTML.match(re)) cnt++;
}
var namedResult = document.getElementsByName("result");
namedResult[0].innerHTML = cnt;
}

window.onload = init;
</pre>

This will display a table of names and at the bottom will be the count of the names that matched foo or Foo.

== Reset templates button ==

When you first create a database the templates will be pre-filled with appropriate HTML. If you later add fields then you can press the ''reset templates'' button and it will add HTML for the new fields in a similar fashion. If you have edited any of the templates in the meantime then your changes will be lost. It is recommended that you finalize the database fields before changing the template code.

==See also==

Some Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=55338 Look of the database module]
*[http://moodle.org/mod/forum/discuss.php?d=74243 How can I list database information horizontally instead of vertically?]
*[http://moodle.org/mod/forum/discuss.php?d=61179 For those who want the display of Moodle Site's Modules and plugins]

[[fr:Modèles]]
[[ru:Шаблоны]]

Database templates

2007-10-25T10:46:45Z

Lmagnus:

{{Databases}}
Templates for the [[Database module]] allow you to control the visual layout of information when listing, viewing or editing database entries. It is a similar to the technique used to ''mail merge'' letters in word proccessors such as Open Office Writer or Microsoft Word.

== Tag usage ==

The content of each [[Database fields|field]] you create for your database and a few special tags (listed below) can be inserted into the output template by the use of tags. To use the tags found on the left side, use the HTML viewer, place your cursor in the text area of your target edit and then click on the tag you want to place. Or simply type the appropriate name within the required symbols like <nowiki>##this## or [[this]]</nowiki>.

* ##Edit## creates a clickable icon link that allows you to edit the current entry (only appears if you have the rights to do this)
* ##More## creates a link to the single view, which may contain more detailed info
* ##MoreURL## creates just the URL for the above link, useful for creating your own links. Please note that there is no any space between 'More' and 'URL'. You can click on the link icon and type ##MoreURL## into URL field or in source view type: <a href="##moreurl##"><nowiki>[[fieldname]]</nowiki></a>
* ##Delete## creates a link that lets you delete the current entry (only appears if you have the rights to do this)
* ##Approve## create a link that lets you approve the current database entry (only appears if you have the rights to do this)
* ##Comments## creates a link to the view/edit comments page, the link text is the current number of comments (only appears if comments are turned on)
* ##User## creates a link to the user page of the user who submitted the entry, link text is their name

Here's a video demonstrating tag usage:
http://video.google.com/videoplay?docid=7026851446099005477

== List template ==

This template allows you to control the fields used and their layout when viewing multiple entries at once (e.g. search results). It is possible that this view may simply provide an overview with more detailed information available by clicking on an entry to access the single view of the entry.

== Single template ==

This is used to display a single entry at a time and so has more space for display and can use, for example, larger versions of images or optionally provide more information than shown in the list view.

== Add template ==

This template creates the interface form used when adding or editing database entries. Saving a template will overwrite whatever template you have already saved. The ability to create (and import and export) named templates for re-use is planned but not yet functional. Currently you can
copy and paste your template for reuse elsewhere.

== RSS template ==

Lets you control the content of the [[RSS]] feed for database entries.

== CSS template ==

If any of the [[HTML]] in your other templates requires [[CSS]] to provide visual style you can specify it here.

== Javascript template ==

You can use javascript to manipulate the way elements are displayed in either the List, Single or Add templates. Basically you need to enclose the part you want to manipulate in some named html element. The naming is essential as it allows you to identify the element for manipulation.

Lets say, for example, you have a field in your database that stores a persons name and when you display the names in the List View you want count the time a name matches some criteria and display the result.

Your database will contain a field which we will call "name". In your List template you will be able to display the contents of that field by using the <nowiki>[[name]]</nowiki> construct at the place where you want that information displayed. For example in the ''Repeated entry'' on the list template you will have

<pre>
<table>
<tr>
<td>Name: [[name]]</td>
</tr>
<table>
</pre>

You now need to modify that entry to enclose the part you want to manipulate in a named element.

<pre>
<table>
<tr>
<td name="named">Name: [[name]]</td>
</tr>
<table>
</pre>

The footer of your list view can then contain

<pre>
<div name="result"></div>
</pre>

Your javascript template can now look as follows

<pre>
var cnt = 0;
var re = /foo|Foo/;

function init(){
var namedElements = document.getElementsByName("named");
for (i=0; i < namedElements; i++) {
if(namedElements[i].innerHTML.match(re)) cnt++;
}
var namedResult = document.getElementsByName("result");
namedResult[0].innerHTML = cnt;
}

window.onload = init;
</pre>

This will display a table of names and at the bottom will be the count of the names that matched foo or Foo.

== Reset templates button ==

When you first create a database the templates will be pre-filled with appropriate HTML. If you later add fields then you can press the ''reset templates'' button and it will add HTML for the new fields in a similar fashion. If you have edited any of the templates in the meantime then your changes will be lost. It is recommended that you finalize the database fields before changing the template code.

==See also==

Some Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=55338 Look of the database module]
*[http://moodle.org/mod/forum/discuss.php?d=74243 How can I list database information horizontally instead of vertically?]
*[http://moodle.org/mod/forum/discuss.php?d=61179 For those who want the display of Moodle Site's Modules and plugins]

[[fr:Modèles]]
[[ru:Шаблоны]]

Installation FAQ

2007-10-24T10:18:26Z

Lmagnus: /* Any text I add with an apostrophe (') or a quote (") causes errors or comes up with a slash added */

{{FAQ}}

==PHP - is it installed and what version do I have?==

Make a new file on your web site called ''info.php'', containing the following text, and call it from your browser:

<?PHP phpinfo() ?>

If nothing happens then you don't have PHP installed or your webserver is not configured to handle .php files properly. See the installation docs for some information about where to download it for your computer. See the [[phpinfo]] page for details about the content of this page.

== System information needed for Installation Forum ==
When posting questions to the installation forum, try to provide as much background information as possible about your moodle system. Use this template to copy and paste into your post:
* Server Operating System name (version also if possible):
* Browser name (version also if possible):
* Moodle version:
* Moodle install type? (New/Upgrade):
* Moodle config.php attached?(Y/N):
* Phpinfo attached? (Y/N):

For the last two items, try to include the following in your post as an attachment:
* A copy of your phpinfo output as shown in your browser (see the instructions above for an explanation of how to obtain this).
* A copy of the Moodle configuration file. This is located in the directory moodle and is named config.php

Copy and paste both of these into a single text file (using vi, Notepad, etc) and attach this to your post.

If you cannot provide your phpinfo, try to copy & paste and complete these in your post:
* Webserver (e.g. Apache/IIS) version:
* Database server (e.g. MySQL, PostgreSQL) version:
* PHP version:

For installation on web hosting accounts: contact your support desk who should be able to tell you this information.

: '''Security Warning''': Make sure you edit any files and delete any passwords before posting onto the forum.

==What & where are Moodle's configuration settings stored?==
Configuration settings are stored in the config.php file stored in your moodle folder. This file is created during the installation process. If there is a problem and the installation cannot create the file, you can try creating it manually from the [[Configuration file]] docs. Please remember that manually editing the file is not recommended and may lead to blank pages, especially if there are additional spaces and/or lines after the final php closing tag "?>".

==Running a health check==
Moodle contains a script that will help identify common php and webserver configuration problems as well as configuration problems. It is a good idea to run this script to check if you are having post-installation problems. Use your browser to run this file:

http://www.mymoodle.com/moodle/admin/health.php

Change the above line if you have installed moodle in the webroot instead of a folder inside the webroot.

==Downloading previous releases of Moodle==
* '''Generic Packages''': If your server does not meet the [[Installing_Moodle#Requirements | requirements]] for the current version of Moodle, you can download previous releases by using wget, lynx or curl with this URL:
<nowiki>http://download.moodle.org/stable[version_number]</nowiki>
:For example: to download Moodle version 1.5, use http://download.moodle.org/stable15. You'll see a directory tree with the files displayed. Click on the one you want and download as normal - if you require the latest update of the version, scroll to the end of the list and download the "moodle-latest" file, or alternatively use these URLs for zip or tgz downloads:
<nowiki>http://download.moodle.org/stable[version_number]/moodle-latest-[version_number].zip</nowiki>
<nowiki>http://download.moodle.org/stable[version_number]/moodle-latest-[version_number].tgz</nowiki>

:Changes made in the version in the last month are listed in the "CHANGES" file in the directory listing. The files you download contain Moodle code and are not the Windows or Mac packages - so you need to have a webserver, a database server and PHP already installed. The earliest version available is Moodle 1.3.
* '''Windows Packages''': To download previous releases of the Moodle packages for Windows, use this URL:
<nowiki>http://download.moodle.org/windows/MoodleWindowsInstaller-latest-[version_number].zip</nowiki>
* '''Mac Packages''': To download previous releases of the Mac pacakges, use either of these URLs (depending on whether you need the Intel or PPC package):
<nowiki>http://download.moodle.org/macosx/Moodle4Mac-Intel-[version_number].dmg</nowiki>
<nowiki>http://download.moodle.org/macosx/Moodle4Mac-PPC-[version_number}.dmg</nowiki>
* '''Using CVS''': You can also use CVS to download older releases and incremental releases of the Moodle generic packages, e.g. Moodle 1.5.4 - see the [[CVS_for_Administrators | CVS documentation]].

== How to enable and check PHP error logs==
PHP can be set up to log errors in a variety of different ways: two of these involve the use of the php.ini file and the ini_set command.
* '''Using the php.ini file''': The log settings are contained in the php.ini file stored on the server. If you don't know where that is, edit your Moodle ''config.php'' and add the following as the second line

phpinfo();

:then reload the web page. Look for the entry '''Configuration File (php.ini) Path'''.

:When you have located php.ini open it in your favorite text editor. Find the '''Error handling and logging''' section of the php.ini file. Make sure that both '''display_errors = On''', '''display_startup_errors = On''' and '''log_errors = On''' are present and uncommented. Check the value of '''error_log''' - this tells you the location of the file errors are logged to. If it is commented out then errors will be sent to the web server error log file. Remember, if you make any changes to this file you will need to restart the web server (or just reboot the server).

* '''Using ini_set commands''': If you are using Moodle 1.7 or higher, the previous steps are not enough. In those versions error logging parameters are dependant on certain administrative settings that you specify in the debugging section. The problem is that if you can't access the administrative pages, you can't set the debugging options. So the only way to modify them is by adding the following lines to your config.php file, just before the last line (the one containing a single'?>' only):

ini_set ('display_errors', 'on');
ini_set ('log_errors', 'on');
ini_set ('display_startup_errors', 'on');
ini_set ('error_reporting', E_ALL);

:This will enable the same settings specified above even if Moodle sets them otherwise.
:'''Important''': Remember to put them just before the last line of config.php.

==Any text I add with an apostrophe (') or a quote (") causes errors or comes up with a slash added==

Problems caused by apostrophes are caused by incorrect "magic quotes" settings. Moodle requires the following settings in the php.ini file (which are usually the default):

magic_quotes_gpc = On
magic_quotes_runtime = Off

Please see [[Installing Moodle]] for more details.

If you are using [[Debian_GNU/Linux_installation|Debian]] then the problem might be in the version of PHP that you have installed. Have a look at this [http://tracker.moodle.org/browse/MDL-9691 bug report ] to see if it matches your situation.

==Email copies are not being sent from my forums==

You ''must'' set up cron properly if you want Moodle to send out automatic email from forums, assignments etc. This same process also performs a number of clean-up tasks such as deleting old unconfirmed users, unenrolling old students and so on.

Basically, you need to set up a process to regularly call the script <code><nowiki>http://yoursite/admin/cron.php</nowiki></code>. Please refer to the [[Cron|cron instructions]].

'''Tip:''' Try the default setting in Moodle variables page. Leave the smtphost blank. This will be acceptable for the majority of users.

'''Tip:''' Make sure that allowuseremailcharset in Administration > Configuration > Variables > Mail is set to No. Setting this to Yes might cause this problem in some versions of Moodle.

==Error: database connection failed==

If you get errors like "database connection failed" or "could not connect to the database you specified", here are some possible reasons and some possible solutions.

* Your '''database server''' isn't installed or running. To check this for MySQL try typing the following command line
$telnet database_host_name 3306
:You should get a cryptic response which includes the version number of the MySQL server.
* If you are attempting to run '''two instances of Moodle on different ports''', use the ip address of the host (not localhost) in the $CFG->dbhost setting, e.g. $CFG->dbhost = 127.0.0.1:3308.
* You don't have the '''PHP mysql or postgresql extensions''' installed (please refer to FAQ re. whether PHP is installed).
* You haven't created a '''Moodle database and assigned a user''' with the correct privileges to access it.
* The '''Moodle database settings''' are incorrect. The database name, database user or database user password in your Moodle configuration file ''config.php'' are incorrect. Use phpMyAdmin to set up and check your MySQL installation.
* Check that there are '''no apostrophes or non-alphabetic letters''' in your MySQL username or password.
* You are using MySQL version 4.1 or higher but the PHP MySQL extension is pre-4.1 (check in your phpinfo output). In this case the '''default password hashing algorithm''' is incompatible with that available in the PHP mysql extension versions 4.x.x. Use these MySQL commands to change the passwords to the old format:

mysql>SET PASSWORD FOR 'root'@'localhost' = OLD_PASSWORD('password');
mysql>SET PASSWORD FOR 'moodleuser'@'localhost' = OLD_PASSWORD('password');

:Also, consider upgrading your PHP MySQL extension. See [http://dev.mysql.com/doc/mysql/en/old-client.html this MySQL document] for further information on how to deal with this problem.
* You are using Fedora core 3 or some other Linux system with '''SELinux installed''' and enabled. See the following URL for information on how to disable SELinux: http://fedora.redhat.com/projects/selinux/ If you don't want to disable SELinux, you have to allow httpd process to create network connections:

setsebool httpd_can_network_connect true

* Mac OSX users -- if you are running MySQL on a Mac OSX, try changing '''$CFG->dbhost''' from 'localhost' to '127.0.0.1'
'''See also''': MySQL page on [http://dev.mysql.com/doc/refman/5.0/en/common-errors.html common errors] which lists several possible scenarios for connection failure, with advice on how to fix the problems.

==I can't log in - I just stay stuck on the login screen==

The most common cause for this is that your own computer (not your Moodle server) has a firewall that is stripping referrer information from the browser. Here are some instructions for fixing [http://service1.symantec.com/SUPPORT/nip.nsf/46f26a2d6dafb0a788256bc7005c3fa3/b9b47ad7eddd343b88256c6b006a85a8?OpenDocument&src=bar_sch_nam Norton firewall products].

The server admin can also fix this for everyone by changing the ''secureforms'' variable to 'No' in the security section of Administration >> Configuration >> [[admin/config|Variables]].

Another possible cause of this problem is that sessions are not configured properly on the server. You can test this by calling the script <nowiki>http://yourserver/moodle/lib/session-test.php</nowiki>.

If you are still having problems, read the [[Can_not_log_in | Cannot log in]] page.

==I can't log in with message "Please verify that the current setting of session.save_path is correct" ==

This error occurs when PHP is having problems saving its session files. You may also see these other error messages displayed on the screen or in your log files:

Warning: Unknown: open(some-path/sessions/sess_acbf942a7399db3489ffa910e35d5242, O_RDWR)
failed: Permission denied (13) in Unknown on line 0

Warning: Unknown(): open(some-path/sessions/sess_acbf942a7399db3489ffa910e35d5242, O_RDWR)
failed: No space left on device (28) in Unknown on line 0

Warning: Unknown: Failed to write session data (files). Please verify that the current
setting of session.save_path is correct (some-path/sessions) in Unknown on line 0

To temporarily bypass these errors, '''use database sessions''' by editing your [[Configuration_file | moodle configuration file]] and adding this line:

$CFG->dbsessions = true;

Database sessions may overload your mysql database and are not ideal in a shared hosting environment, so if this solves the problem, you can start fixing the problem as follows:
* Check '''access rights'''. The session.save_path should be accessible by the apache user. Try this command:

chown -R apache:apache some-path/sessions

:This assumes that 'apache' is the name of the user your webserver runs under - it could also be 'nobody'.
* Check the '''permissions''' to the directory that PHP is trying to save to (session.save_path = some-path/sessions). Set the permissions initially to 0777 (everyone read, write, execute) with this command:

chmod -R 0777 some-path/sessions

:If this fixes the problem, reduce the permissions (700 is recommended).

'''See also''': Session problems can be specific to your server environment. As an example, see [http://moodle.org/mod/forum/discuss.php?d=55925#254596 this forum discussion] about session problems with Lycos hosting.

==I log in but the login link doesn't change. I am logged in and can navigate freely.==

Make sure the URL in your <code>$CFG->wwwroot</code> setting is exactly the same as the one you are actually using to access the site.

==I keep getting this error: A server error that affects your login session was detected.==

Please refer to the Using Moodle forum discussion [http://moodle.org/mod/forum/discuss.php?d=73716 A server error that affects your login session was detected. Please login again or restart your browser.].

==I keep getting this error: Failed opening required '/web/moodle/lib/setup.php'==

In your ''config.php'', the setting that you use for the dirroot variable must be the complete path from the root of your server's hard drive.

Sometimes people only use the path from their home directory, or relative to the root of the web server directory.

==My pages show fatal errors such as : Parse error, call to undefined function: get_string()==

If you see errors like:

Parse error: parse error, unexpected T_VARIABLE in /path/to/moodle/config.php on line 94
Fatal error: Call to undefined function: get_string() in /path/to/moodle/mod/resource/lib.php
on line 11

then you have probably left out a semi-colon or closing quote from a line in ''config.php'' (previous to line 94).

Another possibility is that you edited ''config.php'' in a program like Word and saved it as a HTML web page, instead of using a plain text editor like Notepad.

Another thing to check, particularly if you are using 3rd party modules or plugins, is whether any of the php scripts use short open tags (<? ?>) instead of proper ones (<?php ?>). Short tags are bad for various reasons, so first contact the author of that extension to tell them about the problem. Then either replace short tags with conventional ones, or set this line in php.ini:

short_open_tag = On

You should never find short tags in core moodle code. If you do, please file a bug in the bug tracker.

==Serious Error! Could not set up the site!==

Please refer to the Using Moodle forum discussion [http://moodle.org/mod/forum/discuss.php?d=32071 Serious Error! Could not set up the site!].

==Uploaded files give "File not found"==

For example: Not Found: The requested URL /moodle/file.php/2/myfile.jpg was not found on this server.

Your web server needs to be configured to allow the part of the URL after a script name to be passed directly to the script. This is usually enabled in Apache 1, but is usually disabled by default in Apache 2. To turn it on, add this line to your ''httpd.conf'', or to a ''.htaccess'' file in your local directory (see [[Installing Moodle]] for more details):

'''AcceptPathInfo''' on

Note, this will ONLY work for Apache versions 2.x.

If you are not using Apache 2 and you still have this problem (unlikely) then you can switch Moodle to use an alternative method. The disadvantages are a slight loss of performance for your users and you won't be able to use relative links within HTML resources.

To use this alternative method, you should change the ''slasharguments'' variable in the Operating System section of Administration >> Configuration >> [[admin/config|Variables]]. You should now be able to access your uploaded files.

==When I go to the admin page, I get told to make dirroot blank!==

If you see errors like this:

Please fix your settings in config.php:
You have: $CFG->dirroot = "/home/users/fred/public_html/moodle";
but it should be: $CFG->dirroot = "";

then you have encountered a small bug that occurs on some servers. The problem is with the error-checking mechanism, not with your actual path. To fix it, find this line (line 66) in the file ''admin/index.php'':

if ($dirroot != $CFG->dirroot) {

and change it to this:

if (!empty($dirroot) and $dirroot != $CFG->dirroot) {

==When trying to add a resource I receive error messages==

Assuming you are using Apache, then it's quite likely that your setting in ''config.php'' for <code>$CFG->wwwroot</code> is different from the actual URL you are using to access the site. Also try turning off the ''secureforms'' variable in the security section of Administration >> Configuration >> [[admin/config|Variables]].

==Why are all my pages blank?==

Check the dirroot variable in ''config.php''. You must use complete, absolute pathnames e.g.

$CFG->dirroot = "d:\inetpub\sites\www.yoursite.com\web\moodle";

Another reason might be that PHP has not been configured to support MySQL. This is common on Redhat and OpenBSD installations. In this case, an error is generated, but since error displays are often disabled by default, all that is seen on the browser is a blank screen. To enable PHP error displays, set these lines in your ''php.ini'' file and reload the web page.

display_errors = On
display_startup_errors = On

To determine if MySQL support is your problem, insert this as the second line in your ''config.php'' file

phpinfo();

then reload the web page. Examine the output closely to see if MySQL is supported. If not look for a package you are missing.

== Why is a particular page blank or incomplete? ==

*'''Check your web server log files!!'''
:If a particular page is blank or incomplete (it doesn't display the footer), before you do anything else [[Installation_FAQ#How_to_enable_and_check_PHP_error_logs | check your error logs]]. Having established that PHP error logging is working, reproduce the error. Immediately check the error log file right at the end. Hopefully you will see a PHP error message at or very near the end of the file. This may solve your problem directly or makes it a lot easier to diagnose the problem in the Moodle forums.

*If you are '''upgrading to a new version of Moodle''', check that you do not have an old version of a non-standard block or module installed. Remove any such blocks or modules installed remove them using the admin settings page and start the install process again. However, do also make sure that you have included all required optional plugins that were required by your courses.

*If you '''do not see any blocks listed''', turn editing on and remove any blocks that you have added to that page and try reloading.

==Installation hangs when setting-up database tables==
*Sometimes the installation will hang when setting up tables. This will be an abrupt hang with half the page displayed in the browser and/or other outputs removed, e.g. the “Scroll to continue” link is displayed but no “Continue” button is there. If this is the case, it is usually a mysql error and not a php error. Check that there is no limit placed on your mysql database, e.g. a "questions" limit.

*If the install is on a webhost, adding the following line to the .htaccess file in the moodle directory has been known to solve the problem.
AddType x-mapp-php5 .php

*Try also renaming the .htaccess file so that it is disabled.

*You may also want to look and see if you've customized any of your code. Look at the last successful table, and then look at the block, mod, or other code that is referenced by that table. For example, if your install hangs and continues to say that the forum tables were successful as the last message, look at /mod/forum/ for any custom code. If you have customized code, backup those files and replace with the correct files. You can then restart the install by renaming config.php or reinstalling your database from the backup. If your install is successful, you can make your code changes back into the stock Moodle code.

*It may also be that the "memory_limit" in your php.ini is set too low. Please check your php.ini file and allocate the recommended amount (see [https://docs.moodle.org/en/Installing_Moodle#Requirements Moodle requirements]). For Moodle version 1.8 and above at least 40MB is recommended.

*A work-around to this problem is to setup a working Moodle system on your local PC or server using the [http://download.moodle.org Moodle Packages]. Once you have a running Moodle, [https://docs.moodle.org/en/Upgrading_Moodle#Backup_important_data backup the database] and import to your webhost. Then backup the Moodle code itself (the "moodle" directory on your PC) and copy this to your webhost using (for example) FTP. Finally, edit the moodle/config.php file for the new settings that have to be changed for the webhost.

*To avoid this problem when upgrading, prefer to upgrade incrementally. For example: upgrade from 1.6.* to 1.7.* and then to 1.8.* rather than straight from 1.6.* to 1.8.*

'''Note''': When upgrading an existing database, the installation may appear to hang at the roles generation phase. This process can take a very long time - so please be patient.

==Why can't I upload a new image into my profile?==

If you don't see anything on your user profile pages to let you upload user images then it's usually because GD is not enabled on your server. GD is a library that allows image processing.

1. Make sure '''GD has been included in your PHP installation'''. You can check this by going into Administration >> Configuration >> [[Variables]] and looking for the gdversion setting. This setting is chosen automatically every time you visit that page. If it shows GD version 1 or version 2 then everything should be fine. Save that configuration page and go back to your user profile.

2. If Moodle thinks GD is not installed, then you will need to '''install the GD library'''.
*On Unix you may need to re-compile PHP with arguments something like this:

./configure --with-apxs=/usr/local/apache/bin/apxs --with-xml --with-gd
--with-jpeg-dir=/usr/local --with-png-dir=/usr --with-ttf --enable-gd-native-ttf
--enable-magic-quotes --with-mysql --enable-sockets --enable-track-vars
--enable-versioning --with-zlib

* On Windows this is usually a matter of "turning on" the extension in PHP by editing your php.ini file. To do this remove the semicolon for the php_gd2.dll extension - check that this file is actually present in your php extensions folder first (search your php.ini for extension_dir to determine where this points to on your hard disk). You should then have a line that looks like this:
extension=php_gd2.dll

:Windows users should see the [[Installing AMP|installation instructions]] for further help.

3. Remember to '''restart your webserver''' (if possible) and re-visit the Moodle configuration page after making any changes to PHP so it can pick up the correct version of GD.

'''See also''': Using Moodle forum discussion [http://moodle.org/mod/forum/discuss.php?d=44271 Profile pictures] for additional information.

==Why do I keep getting error messages about "headers already sent"?==

If you see errors like this:

Warning: Cannot add header information - headers already sent by
(output started at /webs/moodle/config.php:87) in /webs/moodle/lib/moodlelib.php
on line 1322

Warning: Cannot add header information - headers already sent by
(output started at /webs/moodle/config.php:87) in /webs/moodle/lib/moodlelib.php
on line 1323

Warning: Cannot add header information - headers already sent by
(output started at /webs/moodle/config.php:87) in /webs/moodle/login/index.php
on line 54

you have blank lines or spaces after the final <code>?></code> in your ''config.php'' file. Sometimes text editors add these - for example Notepad on Windows - so you may have to try a different text editor to remove these spaces or blank lines completely.

== Why doesn't my Moodle site display the time and date correctly? ==

Each language requires a specific language code (called a '''locale''' code) to allow dates to be displayed correctly. The language packs contain default standard codes, but sometimes these don't work on Windows servers.

You can find the correct locale codes for Windows on these two pages: [http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vclib/html/_crt_language_strings.asp Language codes] and [http://msdn.microsoft.com/library/default.asp?url=/library/en-us/vclib/html/_crt_country_strings.asp Country/region] codes (e.g. "esp_esp" for spanish)

These new locale codes can be entered on the Administration >> Configuration >> [[admin/config|Variables]] page, where they override the ones in the currently chosen language pack.

==I receive this error "500:Internal Server Error"==
You'll get this error message if there is a syntax error in your .htaccess or httpd.conf files. You will also see this error if your server does not support .htaccess files, especially if it is running PHPsuexec. Also, you may have a directive in your .htaccess or httpd.conf files which are not compatible with your web server version.

==How do I uninstall Moodle?==
'''Moodle package installation''': If you have downloaded a Moodle package, simply uninstall using your system commands. On Windows PCs, you should access the Control Panel -> Add/Remove Programs. Select the package name and click Change or Remove Programs.

'''Webhost/manual installation''': If you have installed Moodle manually or have installed onto a webhost, follow these steps:
*Delete the moodle database using this mysql command (or delete using your mysql client, e.g. PHPMyAdmin):
<pre>sql>DROP DATABASE moodle;</pre>
:In the above example replace 'moodle' with the name of the moodle database you created when installing.
*Delete the moodledata directory. If you, or your users, have uploaded materials into this directory take a copy of these before deleting this directory.
*Delete the moodle directory itself. This will delete all of the moodle PHP script files.

==How do I upgrade Moodle? Do I just overwrite the files?==
Do not overwrite files, it may cause strange errors. You should read the [[Upgrade]] documentation before proceeding.

==Migrating Moodle to a new site or server==
Migrating Moodle means that you have to move the current installation to a new server, and so may have to change IP addresses or DNS entries. To do this you will need to change the $CFG->wwwroot value in the config.php on the new server. You will also have to change any absolute links stored in the database backup file (before restoring the file on the new server) either using the admin/replace.php script, your text editor or another "search and replace" tool, e.g. sed. For more details see the [[Moodle_migration | Moodle Migration]] page.

==Fatal error allowed memory size exhausted. How do I increase my php memory limit?==
You will sometimes see an error message something like this:
Fatal error: Allowed memory size of 67108864 bytes exhausted
(tried to allocate xx bytes) in /var/www/moodle/yyyy.php
This error means that the php memory_limit value is not enough for the php script. The memory_limit value is the "allowed memory size" - 64M in the example above (67108864 bytes / 1024 = 65536 KB. 65536 KB / 1024 = 64 MB). You will need to increase the php memory_limit value until this message is not shown anymore. There are two methods of doing this.
*On a hosted installation, add the following line to your .htaccess file (or create one in the moodle directory if it does not already exist):
php_value memory_limit <value>M
Example: php_value memory_limit 40M
*If you have your own server with shell access, edit your php.ini file (make sure it's the correct one by checking in your phpinfo output) as follows:
memory_limit <value>M
Example: memory_limit 40M
Remember that you need to restart your web server to make changes to php.ini effective. An alternative is to disable the memory_limit by using the command ''memory_limit 0''.

----
==Why does my new installation display correctly on the server, but when I view it from a different machine, styles and images are missing?==
In the installation instructions, one of the suggested settings for 'webroot' is 'localhost'. This is fine if all you want to do is some local testing of your new Moodle installation. If, however, you want to view your new installation from another machine on the same local area network, or view your site on the internet, you will have to change this setting:
*For local testing, 'localhost' is fine for the webroot.
*If you want to test your site from other machines on the same local area network (LAN), then you will have to use the private ip address of the serving machine, (e.g. 192.168.1.2/moodle) or the network name of the serving computer (e.g. network_name_of_serving_machine/moodle) as the web root. Depening on your LAN setup, it may be better to use the network name of the computer rather than its (private) ip address, because the ip address can and will change from time to time. If you don't want to use the network name, then you will have to speak to your network administrator and have them assign a permanent ip address to the serving machine.
*Finally, if you want to test your new installation across the internet, you will have to use either a domain name or a permanent (public) ip address/moodle as your web root.

[[Category:FAQ]]
[[Category:Installation]]

[[es:FAQ Instalación]]
[[fr:FAQ d'installation]]
[[nl:Installatie FAQ]]
[[ja:インストールFAQ]]
[[ru:Установка FAQ]]

Installation FAQ

2007-10-24T10:18:08Z

Lmagnus: Debian issues

Category:Files

2006-07-18T11:51:34Z

Lmagnus:

An index of pages about the [[Files | files]] option of the [[Administration block | administration block]]

Files

2006-07-18T11:43:37Z

Lmagnus:

{{Course admin}}

This option in the administration block is only available to course teachers and site admins. It allows teachers to upload files such as PDFs, Multimedia, Word documents, PowerPoint presentations and so on into your course. In fact it allows you to upload any digital content for inclusion in an activity, resource, course section or a direct download.

Following the Files link in the administration block lets you see a list of uploaded course files arranged under four headings: file name, file size, the last time a given file was modified, and the action you can do with a given file (or folder). Using the box on the left below the file list, you can move the files you choose (by ticking a box on the left to the file name) to another folder, delete them completely or create a zip archive. There are two more actions you can undertake: 'Make a folder' and 'Upload a file' - both are posited on the right-hand side of the screen under the list.

Whilst uploading is restricted to one file at a time you can upload a zip containing many files. Once uploaded Moodle will recognise the file as a zip and show on unzip link. You can then follow the unzip link which will extract the file(s) within.

To preview any file you have uploaded just click on its name. Your web browser will take care of either displaying it or downloading it to your computer.

HTML and text files can be edited in-place online. Other files will need to be edited on your local computer and uploaded again. if you upload a file with the same name as an existing file it will automatically be overwritten.

When viewing the course files in a new course you will notice there are already directories present. These are for storing course data and any course backup zip files.

You can also create a directory and display the whole contents of that directory using the setting in the add resource drop down in a course section.

==Moodle Sub-directories==
There are two sub-directories that are used by Moodle for storing data, namely the [[backupdata]] and [[moddata]] directories

[[Category:Teacher]]
[[Category:Lesson]]
[[Category:Files]]

Glossary settings

2006-07-18T11:39:17Z

Lmagnus: /* Attachment */

{{Glossaries}}

Adding a new entry, you have to fill in two fields. Others are obligatory.
==Concept (mandatory) ==

Here you should insert the word/concept, the definition of which you wish to create.

==Definition (mandatory) ==

As its name suggests, this field should contain the definition of the word/concept.

==Keywords==

Each entry in the glossary can have an associated list of keywords (or aliases). Enter each alias on a new line (not separated by commas). The aliased words and phrases can be used as alternative ways to refer to the entry. For example, if you are using the glossary auto-linking filter then the aliases will be used (as well as the main name of the entry) when deciding what words to link to this entry.

[[Image:Glossary_5.png|frame|left|just fill in the form to create the new glossary entry]]
<br style="clear:both;">

==Categories==

The default setting is 'Not categorised'. However, if you do add new categories, they will display here giving the possibility of choice.

==Enabling automatic linking in a entry==

Turning this feature on will allow the entry 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.

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.

To be able to turn on this feature, auto linking must be enabled at glossary level.

==Case sensitive matching==

This setting specifies whether matching exact upper and lower case is necessary when performing automatic linking to these entries.

For example, if this is turned on, then a word like "html" in a forum posting will NOT be linked to a glossary entry called "HTML".

==Whole words matching==

If automatic linking is enabled, then turning this setting on will force only whole words to be linked.

For example, a glossary entry named "construct" will not create a link inside the word "constructivism".

==Attachment==
You can choose to add an attachment file to the entry. This is useful if you are creating a photo gallery.

To delete the attachment you need to go to the [[Files | files]] option of the [[Administration block | administration block]] and look in the directory called moddata and the sub-directory called glossary. The file for each entry will be stored in each individual sub-directory.

[[Category:Teacher]]
[[Category:Glossary]]

Glossary settings

2006-07-18T11:37:52Z

Lmagnus: /* Attachment: (optional) */

{{Glossaries}}

Adding a new entry, you have to fill in two fields. Others are obligatory.
==Concept (mandatory) ==

Here you should insert the word/concept, the definition of which you wish to create.

==Definition (mandatory) ==

As its name suggests, this field should contain the definition of the word/concept.

==Keywords==

Each entry in the glossary can have an associated list of keywords (or aliases). Enter each alias on a new line (not separated by commas). The aliased words and phrases can be used as alternative ways to refer to the entry. For example, if you are using the glossary auto-linking filter then the aliases will be used (as well as the main name of the entry) when deciding what words to link to this entry.

[[Image:Glossary_5.png|frame|left|just fill in the form to create the new glossary entry]]
<br style="clear:both;">

==Categories==

The default setting is 'Not categorised'. However, if you do add new categories, they will display here giving the possibility of choice.

==Enabling automatic linking in a entry==

Turning this feature on will allow the entry 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.

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.

To be able to turn on this feature, auto linking must be enabled at glossary level.

==Case sensitive matching==

This setting specifies whether matching exact upper and lower case is necessary when performing automatic linking to these entries.

For example, if this is turned on, then a word like "html" in a forum posting will NOT be linked to a glossary entry called "HTML".

==Whole words matching==

If automatic linking is enabled, then turning this setting on will force only whole words to be linked.

For example, a glossary entry named "construct" will not create a link inside the word "constructivism".

==Attachment==
You can choose to add an attachment file to the entry. This is useful if you are creating a photo gallery.

To delete the attachment you need to go to the [[Files | files]] option of the administration block and look in the directory called moddata and the sub-directory called glossary. The file for each entry will be stored in each individual sub-directory.

[[Category:Teacher]]
[[Category:Glossary]]

Glossary settings

2006-07-18T11:37:29Z

Lmagnus: /* Attachment: (optional) */

{{Glossaries}}

Adding a new entry, you have to fill in two fields. Others are obligatory.
==Concept (mandatory) ==

Here you should insert the word/concept, the definition of which you wish to create.

==Definition (mandatory) ==

As its name suggests, this field should contain the definition of the word/concept.

==Keywords==

Each entry in the glossary can have an associated list of keywords (or aliases). Enter each alias on a new line (not separated by commas). The aliased words and phrases can be used as alternative ways to refer to the entry. For example, if you are using the glossary auto-linking filter then the aliases will be used (as well as the main name of the entry) when deciding what words to link to this entry.

[[Image:Glossary_5.png|frame|left|just fill in the form to create the new glossary entry]]
<br style="clear:both;">

==Categories==

The default setting is 'Not categorised'. However, if you do add new categories, they will display here giving the possibility of choice.

==Enabling automatic linking in a entry==

Turning this feature on will allow the entry 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.

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.

To be able to turn on this feature, auto linking must be enabled at glossary level.

==Case sensitive matching==

This setting specifies whether matching exact upper and lower case is necessary when performing automatic linking to these entries.

For example, if this is turned on, then a word like "html" in a forum posting will NOT be linked to a glossary entry called "HTML".

==Whole words matching==

If automatic linking is enabled, then turning this setting on will force only whole words to be linked.

For example, a glossary entry named "construct" will not create a link inside the word "constructivism".

==Attachment: (optional)==
You can choose to add an attachment file to the entry. This is useful if you are creating a photo gallery.

To delete the attachment you need to go to the [[Files | files]] option of the administration block and look in the directory called moddata and the sub-directory called glossary. The file for each entry will be stored in each individual sub-directory.

[[Category:Teacher]]
[[Category:Glossary]]

Glossary settings

2006-07-18T11:34:04Z

Lmagnus:

{{Glossaries}}

Adding a new entry, you have to fill in two fields. Others are obligatory.
==Concept (mandatory) ==

Here you should insert the word/concept, the definition of which you wish to create.

==Definition (mandatory) ==

As its name suggests, this field should contain the definition of the word/concept.

==Keywords==

Each entry in the glossary can have an associated list of keywords (or aliases). Enter each alias on a new line (not separated by commas). The aliased words and phrases can be used as alternative ways to refer to the entry. For example, if you are using the glossary auto-linking filter then the aliases will be used (as well as the main name of the entry) when deciding what words to link to this entry.

[[Image:Glossary_5.png|frame|left|just fill in the form to create the new glossary entry]]
<br style="clear:both;">

==Categories==

The default setting is 'Not categorised'. However, if you do add new categories, they will display here giving the possibility of choice.

==Enabling automatic linking in a entry==

Turning this feature on will allow the entry 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.

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.

To be able to turn on this feature, auto linking must be enabled at glossary level.

==Case sensitive matching==

This setting specifies whether matching exact upper and lower case is necessary when performing automatic linking to these entries.

For example, if this is turned on, then a word like "html" in a forum posting will NOT be linked to a glossary entry called "HTML".

==Whole words matching==

If automatic linking is enabled, then turning this setting on will force only whole words to be linked.

For example, a glossary entry named "construct" will not create a link inside the word "constructivism".

==Attachment: (optional)==
You can choose to add an attachment file to the entry. This is useful if you are creating a photo gallery.

To delete the attachment you need to go to the files module and look in the directory called moddata and the sub-directory called glossary. The files for each entry will be stored in each individual sub-directory.

[[Category:Teacher]]
[[Category:Glossary]]

Glossary settings

2006-07-18T11:23:21Z

Lmagnus:

Moodle in education

2006-07-17T10:52:50Z

Lmagnus: /* See also */

__NOTOC__

==Getting started==

This article is for teachers wanting an overview of the Moodle features that will be used in the day to day running of a course.

If you would like a list of all the documents that are for teachers in this wiki have a look at the [[:Category:Teacher | teacher category]].

We are assuming that your site administrator has set up Moodle and given you a new, blank course to start with. You will need to be [[Log in | logged into]] the course using an account that has been assigned [[Teacher|teacher status]] (with editing rights) on that course to use most of the features below. We have some tips if you are having [[Can not log in | trouble logging in]].

Now onto the real details. You will find the [[Course homepage|course homepage]] is broken down into [[Course sections]]. A course is created by [[Adding resources and activities|adding resources and activities]]. When writing text in Moodle you have a range of [[Formatting options]] including using [[HTML in Moodle]]

==Editing A Course==

To add or alter activities or resources you will need to [[Turn editing on|turn editing on]]. You can do this by pressing the button at the top right of the course homepage or following the turn editing on link in the administration block. You can turn editing off again by pressing the button or the admin block link again (now renamed turn editing off)

When editing is on you will see the following icons:

:[[Image:Edit.gif]] - the edit icon lets you alter/update whatever resource or activity it is next to by taking you to it's setup page.

:[[Image:Help.gif]] - the help icon will pop-up a relevant help window.

:[[Image:Open.gif]] - the open-eye icon means an item is visible to students. Clicking it will make the item invisible to participants and change the icon to the closed eye.

:[[Image:Closed.gif]] - the closed-eye icon means an item is hidden from students. Clicking it will make the item visible to participants and change the icon to the open eye.

:[[Image:Right.gif]] - the left icon is used to outdent course elements. There is also a right icon for indenting items.

:[[Image:Move.gif]] - the move icon allows course elements to be moved up or down throughout the course.

:[[Image:Movehere.gif]] - the move here icon appears when moving a course element. It appears only after you've clicked the move icon, and indicates the destination of the item you're moving.

:[[Image:Delete.gif]] - the delete icon will permanently delete something from the course after you confirm a warning on a second page.

:[[Image:Marker.gif]] - the marker icon allows you to make a section current.

:[[Image:One.gif]] - the one icon hides all other sections of the course, showing only this one.

:[[Image:All.gif]] - the all icon redisplays all sections in a course.

If you are running version 1.6 or above you will see a '''Student View''' toggle button at the top right of the course homepage. This allows you to see the course almost exactly as your students will see it.

==Activity modules==

There are a number of interactive learning [[Modules (teacher)|activity modules]] that you may [[Adding_resources_and_activities | add to your course]].

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

Work can be submitted by students and marked by teachers using [[Assignments]] or [[Workshops]]. Automatic marking can be achieved by using [[Quizzes]]. You can even integrate your Hot Potato quizzes by adding a [[Hotpot]] activity.

Content may be delivered and supported using [[Lessons]] and [[SCORM]] activities. Key words can be added to [[Glossaries]] by yourself or, if you allow it, your students.

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

If all of that isn't enough for you then you can also [[Non-standard modules|add other modules]] that are not part of the official Moodle release!

==Resources==

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

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

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

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

==Blocks==

Each course homepage generally contains blocks on the left and right with the centre column containing the course content. Blocks may be added, hidden, deleted, and moved up, down and left/right when editing is turned on.

A [[Blocks (teacher)|wide range of blocks]] exist that provide additional information or functionality to the learner or teacher. These are included with the standard Moodle package but a range of [[Non-standard blocks]] exist which an administrator can add.

===Administration Block===

All of the links in the administration block are only available to teachers of the course. Students will receive their own version of the block which will display a link to their own gradebook and, if enabled, their own course logs.

Features in the administration block allow teachers to manage [[Students | student]] and [[Teachers | teacher]] enrollments and their [[Groups | groups]], view the course [[Grades | gradebook]], create custom [[Scales | grading scales]] and access the Teacher forum. The teacher forum is a private forum only available to teachers of that course. It can be used to discuss the course content, the direction the course could take or even to attach files to that can be shared among the course teachers.

You can change the way students (and other teachers) access and view your course by exploring the [[Settings]] option in the [[Administration | administration block]].

There are lots of possible ways to set up a course using blocks, but teachers may be particularly interested in [[Settings#Format | course formats]] which change how the course is presented to the learner. The weekly format is suitable for courses that have a clear start date and activities are presented in weekly blocks. Topic formatted courses are actually presented in a similar way but with the dates removed so activities can belong to general or specific areas of study. The social format doesn't use much content at all and is based around just one forum which is displayed on the main course page.

In the course homepage there is a white square icon on the top right of a [[Course_sections | section]] which can be used to expand and collapse sections. You can also use the lightbulb icon to mark a topic as current.

Another much used feature of the adminstration block is the [[Files]] link. From here you can upload any digital content for inclusion in an activity, resource, course section or for a direct download. These files can be moved, renamed, edited directly on the server (if they are HTML or text) or deleted. You can also create a directory and display the whole contents of that directory to course students using the add resource drop down in any course section.
Of course if your content resides out on the web then you don't need to upload the files at all - you can link directly to them from inside the course using the link to file or website option.

==General Advice==

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

== See also ==
*[[Teaching with Moodle]]
*[[Teaching do's and don'ts]]
*[[Teaching FAQ]]
*[[Tips and tricks]]
*[[Student FAQ]]
*[[Presentations]]
*[[Moodle manuals]]
*[[Using Moodle book]]
*[https://docs.moodle.org/en/Category:Lesson Lesson Module Basics]

For an index of teacher topics go [[:Category:Teacher | here]]:

[[Category:Teacher]]
[[es:Documentación para Profesores]]
[[fr:Documentation enseignant]]
[[nl:Documentatie voor leraren]]

Moodle in education

2006-07-17T10:47:07Z

Lmagnus: /* Getting started */

__NOTOC__

==Getting started==

This article is for teachers wanting an overview of the Moodle features that will be used in the day to day running of a course.

If you would like a list of all the documents that are for teachers in this wiki have a look at the [[:Category:Teacher | teacher category]].

We are assuming that your site administrator has set up Moodle and given you a new, blank course to start with. You will need to be [[Log in | logged into]] the course using an account that has been assigned [[Teacher|teacher status]] (with editing rights) on that course to use most of the features below. We have some tips if you are having [[Can not log in | trouble logging in]].

Now onto the real details. You will find the [[Course homepage|course homepage]] is broken down into [[Course sections]]. A course is created by [[Adding resources and activities|adding resources and activities]]. When writing text in Moodle you have a range of [[Formatting options]] including using [[HTML in Moodle]]

==Editing A Course==

To add or alter activities or resources you will need to [[Turn editing on|turn editing on]]. You can do this by pressing the button at the top right of the course homepage or following the turn editing on link in the administration block. You can turn editing off again by pressing the button or the admin block link again (now renamed turn editing off)

When editing is on you will see the following icons:

:[[Image:Edit.gif]] - the edit icon lets you alter/update whatever resource or activity it is next to by taking you to it's setup page.

:[[Image:Help.gif]] - the help icon will pop-up a relevant help window.

:[[Image:Open.gif]] - the open-eye icon means an item is visible to students. Clicking it will make the item invisible to participants and change the icon to the closed eye.

:[[Image:Closed.gif]] - the closed-eye icon means an item is hidden from students. Clicking it will make the item visible to participants and change the icon to the open eye.

:[[Image:Right.gif]] - the left icon is used to outdent course elements. There is also a right icon for indenting items.

:[[Image:Move.gif]] - the move icon allows course elements to be moved up or down throughout the course.

:[[Image:Movehere.gif]] - the move here icon appears when moving a course element. It appears only after you've clicked the move icon, and indicates the destination of the item you're moving.

:[[Image:Delete.gif]] - the delete icon will permanently delete something from the course after you confirm a warning on a second page.

:[[Image:Marker.gif]] - the marker icon allows you to make a section current.

:[[Image:One.gif]] - the one icon hides all other sections of the course, showing only this one.

:[[Image:All.gif]] - the all icon redisplays all sections in a course.

If you are running version 1.6 or above you will see a '''Student View''' toggle button at the top right of the course homepage. This allows you to see the course almost exactly as your students will see it.

==Activity modules==

There are a number of interactive learning [[Modules (teacher)|activity modules]] that you may [[Adding_resources_and_activities | add to your course]].

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

Work can be submitted by students and marked by teachers using [[Assignments]] or [[Workshops]]. Automatic marking can be achieved by using [[Quizzes]]. You can even integrate your Hot Potato quizzes by adding a [[Hotpot]] activity.

Content may be delivered and supported using [[Lessons]] and [[SCORM]] activities. Key words can be added to [[Glossaries]] by yourself or, if you allow it, your students.

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

If all of that isn't enough for you then you can also [[Non-standard modules|add other modules]] that are not part of the official Moodle release!

==Resources==

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

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

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

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

==Blocks==

Each course homepage generally contains blocks on the left and right with the centre column containing the course content. Blocks may be added, hidden, deleted, and moved up, down and left/right when editing is turned on.

A [[Blocks (teacher)|wide range of blocks]] exist that provide additional information or functionality to the learner or teacher. These are included with the standard Moodle package but a range of [[Non-standard blocks]] exist which an administrator can add.

===Administration Block===

All of the links in the administration block are only available to teachers of the course. Students will receive their own version of the block which will display a link to their own gradebook and, if enabled, their own course logs.

Features in the administration block allow teachers to manage [[Students | student]] and [[Teachers | teacher]] enrollments and their [[Groups | groups]], view the course [[Grades | gradebook]], create custom [[Scales | grading scales]] and access the Teacher forum. The teacher forum is a private forum only available to teachers of that course. It can be used to discuss the course content, the direction the course could take or even to attach files to that can be shared among the course teachers.

You can change the way students (and other teachers) access and view your course by exploring the [[Settings]] option in the [[Administration | administration block]].

There are lots of possible ways to set up a course using blocks, but teachers may be particularly interested in [[Settings#Format | course formats]] which change how the course is presented to the learner. The weekly format is suitable for courses that have a clear start date and activities are presented in weekly blocks. Topic formatted courses are actually presented in a similar way but with the dates removed so activities can belong to general or specific areas of study. The social format doesn't use much content at all and is based around just one forum which is displayed on the main course page.

In the course homepage there is a white square icon on the top right of a [[Course_sections | section]] which can be used to expand and collapse sections. You can also use the lightbulb icon to mark a topic as current.

Another much used feature of the adminstration block is the [[Files]] link. From here you can upload any digital content for inclusion in an activity, resource, course section or for a direct download. These files can be moved, renamed, edited directly on the server (if they are HTML or text) or deleted. You can also create a directory and display the whole contents of that directory to course students using the add resource drop down in any course section.
Of course if your content resides out on the web then you don't need to upload the files at all - you can link directly to them from inside the course using the link to file or website option.

==General Advice==

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

== See also ==
*[[Teaching with Moodle]]
*[[Teaching do's and don'ts]]
*[[Teaching FAQ]]
*[[Tips and tricks]]
*[[Student FAQ]]
*[[Presentations]]
*[[Moodle manuals]]
*[[Using Moodle book]]
*[https://docs.moodle.org/en/Category:Lesson Lesson Module Basics]

For an index of teacher topics go here:

[[Category:Teacher]]
[[es:Documentación para Profesores]]
[[fr:Documentation enseignant]]
[[nl:Documentatie voor leraren]]

User:Lindsay Magnus

2006-07-17T10:43:02Z

Lmagnus:

Moodler at the [http://www.hmo.ac.za Hermanus Magnetic Observatory].

Sandbox

2006-07-17T10:41:19Z

Lmagnus:

So any logged in user can change this page - interesting
[[Image:Example.jpg]]

kk

Nice. But where can I create a new page?

: Type the title for your new page in the Search box to your left and hit '''Go'''. If the page doesn't exist you'll be give the option to create it by clicking on the 'this exact title' link.

----
Nobody has tried to edit this sandbox since
*This is a great sandbox for what is called MoodleDocs, the collaborative documation Wiki for Moodle.org website. There is a similar Wiki that is part of Moodle.

* If you are looking for a Moodle Sanbox, I would recommend that you (collective group of individuals) go to download.moodle [http://download.moodle.org/ click here] and put the latest stable version of Moodle on your desktop, laptop or what have you. I did this back in Jan 06, I loaded the complete package (not the standard) onto a Win XP Pro desktop (this has PHP, Apache and MySQL). Went so well, I did another one at home.

Another tip: At the home page of http://moodle.org/, look for Free Support, then the first item is '''WELCOME! Are you new? Confused? Please start here'''! Good advice.

Chris--11 April 2006 reedited on --[[User:chris collman 2|chris collman 2]] 05:57, 9 May 2006 (WST)

-----
[[Wikipedia:Página de desambiguación|página de desambiguación]]

'''''Möge die Macht bei Euch sein!''''' --[[User:Art Lader|Art Lader]] 09:15, 21 February 2006 (WST)

I am trying the ''sandbox'' out. I am trying to learn about Moodle so I can be the administrator for our district.--[[User:Maginitt|Maginitt]] 23:16, 8 February 2006 (WST)
[[Create your own course]]

Hello world!

I don't get the math to show up with @@ $$ $ or math tags
<math> $$y={2+x} /over {3-a}$$</math>

hi

We live in such an exciting era, being able to play with such fun toys.--[[User:Lyndall Owbridge|Lyndall Owbridge]] 15:56, 18 February 2006 (WST)
[[Image:Example.jpg]].

I hope to learn enough about moodle to set it up for our district.

Portada
Bienvenido a Moodle Docs, la documentación para Moodle en la que todo el mundo puede colaborar. En esta versión en Castellano, oficialmente lanzada el 15 de febrero de 2006, estamos actualmente trabajando en 357 artículos, añadiendo nuevas páginas cada día.
¿Le gustaría ver Moodle Docs en otro idioma? Si es así, por favor lea la información sobre cómo comenzar con Moodle Docs en otro idioma.
Es muy sencillo editar páginas - practica en la Zona de Pruebas!

is this all you have to do '''this text is now bold?'''

Quiero crear una universidad magnifica donde todos sean bienvenidos y nunca sea necesario pagar. La idea de una institución que ofrezca la formación suprema, la mejor en el mundo, y usando la mejor tecnología para proporcionar a todos los que quieran aprender un baluarte de la misma calidad que el '''Ivy League''' sin pagar. Quizas en una escuela tan maravillosa pueda aprender el español mejor que ahora. (Nota: Lo ha traducido del ''spanglish'' un español)

So, this is cool, but it isn't getting me discernibly closer to my goal of seeing if this is really something the average faculty member can and will use to create high quality college courses. I do understand that social constructionism looks at education from the viewpoint of the learner but, without wanting to sound ungracious, I am not finding it easy to get up to speed with Moodle.

I think there needs to be something like a Moodle for Idiots right up front. Maybe I'll provide this once I learn enough to have something to teach!

I agree. This is not easy. I've spent all night going around this site and I still don't have a clue how to use it.
<nowiki>Insert non-formatted text here</nowiki><math>Insert formula here</math>

Meow ;)
© by Bat

==Capitalizing links==

Links like [[sandbox]] might be automatically capitalized? At least on Wikipedia they are. [[User:Samuli Karevaara|Samuli Karevaara]] 14:56, 24 May 2006 (WST) Okay, here they are not. A setting somewhere? So far links have to be entered like [[Philosophy|philosophy]], ok...

:Hi Samuli, you're right about a wiki setting to not automatically capitalize page titles e.g. for [[MoodleDocs:Link pages|link pages]]. --[[User:Helen Foster|Helen Foster]] 16:18, 24 May 2006 (WST)

Are we talking about capitalising the displayed text, or automatically linking <nowiki>[[word]]</nowiki> to the page called ''Word'' (i.e. lowercase link text, capitalised page title? The latter would be nice if it's possible. I assume that many of Wikipedia's articles are about people or places that are proper nouns and are therefore always capitalised. --[[User:David Scotson|David Scotson]] 18:13, 24 May 2006 (WST)

:Actually it was decided not to force capitalized links (see [http://meta.wikimedia.org/wiki/LocalSettings.php#Force_Capital_Links LocalSettings.php Force Capital Links]). It would be too much work to change it now ;-) --[[User:Helen Foster|Helen Foster]] 06:14, 30 May 2006 (WST)

==Linking to a category==

I am having lots of fun, but would like to link directly to a category like this [[:Category:Teacher | teacher]].

To do this you need to have <code><nowiki>[[:Category:Teacher | teacher]]</nowiki></code> which is different to <code><nowiki>[[Category:Teacher | teacher]]</nowiki></code>. The second will put the current page in the teacher category. [[User:Lindsay Magnus|Lindsay Magnus]] 18:41, 17 July 2006 (WST)

Help:Editing

2006-07-17T10:39:39Z

Lmagnus: /* Categories */

{{Help}}

Every wiki page has an "edit" tab at the top plus edit links at the side. These links lets you do exactly what they say i.e. edit the page you're looking at. Please try it in the [[Sandbox|sandbox]]!

=== Show preview ===
This lets you see what the page will look like after your edit, before you actually save. We all make mistakes; this feature lets you catch them immediately. Using Show preview before saving also lets you try format changes and other edits without cluttering up the page history, and has a number of other advantages. Don't forget to save your edits after previewing, though!

=== Edit summary ===
Before saving the page, it's considered good practice to enter a very brief summary of your changes in the summary box below the edit-box.

== Formatting ==

Most '''formatting''' is usually done with Wiki markup - you don't have to learn HTML!

=== Bold and italics ===
'''Bolding''' and ''italicizing'' is done by surrounding a word or phrase with multiple apostrophes (<tt>'</tt>):

:<code><nowiki>''italics''</nowiki></code> appears as ''italics''. (2 apostrophes on both sides)
:<code><nowiki>'''bold'''</nowiki></code> appears as '''bold'''. (3 apostrophes on both sides)
:<code><nowiki>'''''bolded italics'''''</nowiki></code> appears as '''''bolded italics'''''. (5 apostrophes on both sides)

=== Headings and subheadings ===
Headings and subheadings are an easy way to improve the organization of an article.

Headings can be created like this:
:<code><nowiki>==Top level heading==</nowiki></code> (2 equals signs)
:<code><nowiki>===Subheading===</nowiki></code> (3 equals signs)
:<code><nowiki>====Another level down====</nowiki></code> (4 equals signs)

If an article has at least four headings, a table of contents will automatically be generated.

=== Indentations ===
The simplest way of indenting is to place a colon (<code>:</code>) at the beginning of a line. The more colons you put, the further indented the text will be. A newline marks the end of the indented paragraph e.g.
:<code>This is aligned all the way to the left.</code>
:<code><nowiki>:</nowiki>This is indented slightly.</code>
:<code><nowiki>::</nowiki>This is indented more.</code>
is shown as
:This is aligned all the way to the left.
::This is indented slightly.
:::This is indented more.

=== Lists ===
{| border="1" cellpadding="2" cellspacing="0"
|-
!What it looks like
!What you type
|-
|
* ''Unordered lists'' are easy to do:
** start every line with a star
*** more stars means deeper levels
*A newline
*in a list
marks the end of the list.

|<pre><nowiki>* Unordered Lists are easy to do:
** start every line with a star
*** more stars means deeper levels
*A newline
*in a list
marks the end of the list.
</nowiki></pre>
|-
|
# Numbered lists are also good
## very organized
## easy to follow
#A newline
#in a list
marks the end of the list.
|<pre><nowiki># Numbered lists are also good
## very organized
## easy to follow
#A newline
#in a list
marks the end of the list.
</nowiki></pre>
|}

=== Preserving formatting ===

{| border="1" cellpadding="2" cellspacing="0"
|-
!What it looks like
!What you type
|-
|
Leading spaces are another way to preserve formatting.

Putting a space at the beginning of each line
stops the text from being reformatted.
|<pre><nowiki>Leading spaces are another way to preserve formatting.

Putting a space at the beginning of each line
stops the text from being reformatted.
</nowiki></pre>
|}

== Links ==

=== Wiki links ===
To make a wiki link, simply put the word in double square brackets, like this: <code><nowiki>[[Sandbox]]</nowiki></code>

If you want to use words other than the article title as the text of the link, you can do so by adding the pipe "|" divider followed by the alternative name.

For example, if you wanted to make a link to the [[Sandbox]], but wanted it to say "my text" you would write it as: <code><nowiki>[[Sandbox|my text]]</nowiki>...</code> It would appear as: [[Sandbox|my text]]... but would link to the sandbox.

=== External links ===

The easiest way to make an external link is to simply type in the full URL for the page you want to link to e.g. http://moodle.com.

To make the link display something other than the URL, use one square bracket at each end. If you want to make a link to moodle.com, type <code><nowiki>[http://moodle.com/]</nowiki></code>
This will display the link as a number in brackets, like this: [http://moodle.com/].

If you want the link to appear with text that you specify, add an alternative title after the address separated by a '''space''' (''not'' a pipe). So if you want the link to appear as [http://moodle.com Moodle], just type <code><nowiki>[http://moodle.com Moodle] </nowiki></code>.

===Categories===

To put a page in a category, just type <code><nowiki>[[Category:]]</nowiki></code>, and put the name of the category between the colon and the brackets.

To link directly to a category use <code><nowiki>[[:Category:Teacher | teacher]]</nowiki></code>, this will show as [[:Category:Teacher | teacher]], note the preceding ":", which is different to <code><nowiki>[[Category:Teacher | teacher]]</nowiki></code>. The second will put the current page in the teacher category as mentioned above.

===Inter-language links===

Simply type <code><nowiki>[[es:Corresponding page title in Spanish]]</nowiki></code> in the English Moodle Docs, or <code><nowiki>[[en:Corresponding page title in English]]</nowiki></code> in the [[:es:Portada|Spanish Moodle Docs]], at the bottom of the page, below the category link. Inter-language links will appear automatically in the "In other languages" block.

===User-page links===

Talk page contributions may be signed and dated by typing four tildes <nowiki>~~~~</nowiki>. This will appear as [[User:Helen Foster|Helen Foster]] 06:35, 19 February 2006 (WST), for example.

==External links==
*[http://meta.wikimedia.org/wiki/Help:Editing MediaWiki Help:Editing]
*[http://meta.wikimedia.org/wiki/Help:HTML_in_wikitext Help:HTML in wikitext]
*[http://diberri.dyndns.org/html2wiki.html HTML to MediaWiki converter]
*[http://wikipedia.mozdev.org/ Firefox Wikipedia extension] - The Wikipedia extension makes editing of wiki pages easier by adding a new toolbar to your browser and by providing new menu items in the context menu (right mouse key).

[[Category:MoodleDocs]]

[[es:Ayuda:Cómo se edita una página]]
[[nl:Meehelpen]]