MoodleDocs - User contributions [en]

Installing Moodle

2010-08-11T12:07:54Z

Daddydoos: /* See also */

{{Template:Installing Moodle}}
'''Firstly, don't panic!''' [[Image:F1 35px.png]]

This guide explains how to install Moodle for the first time. There are links to other pages that go into more detail and try to cover the majority of possible web server setups.

Secondly, you may want to consider reviewing [[Finding and Selecting A Web Host]] to consider whether you really want to install Moodle yourself. If you decide to move forward with an installation, please read all the installation documentation carefully. Thirdly, if you still have a problem for which you can't find the answer, please see the Using Moodle [http://moodle.org/mod/forum/view.php?id=28 Installation problems forum] where there are many people who can help you.

== Requirements ==

Moodle is primarily developed in Linux using [[Apache]], [[MySQL]] and [[PHP]] (also sometimes known as the LAMP platform). It is also regularly tested with Windows XP/2000/2003 (WAMP), Solaris 10 (Sparc and x64), Mac OS X and Netware 6 operating systems. Support for PostgreSQL, Oracle and Microsoft SQL Server is also available.

The requirements for Moodle are as follows:

=== Hardware ===
* Disk space: 160MB free (min). You will require more free space to store your teaching materials.
* Memory: 256MB (min), 1GB (recommended). The general rule of thumb is that Moodle can support 50 ''concurrent'' users for every 1GB of RAM, but this will vary depending on your specific hardware and software combination.
** This includes hosting limits of PHP or MySQL on a hosting service.
** The capacity can limit the number of users your Moodle site can handle. See [[User site capacities]]

=== Software ===
* Web server software. Most sites use [[Apache]] as the web server software. Moodle should work fine under any web server that supports [[PHP]], such as [[IIS]] on Windows platforms.
* PHP scripting language. (Please note that there have been issues installing Moodle with [http://www.php-accelerator.co.uk PHP-Accelerator]). There are currently two versions (or branches) of PHP available: PHP4 and PHP5. See the PHP Moodle version requirements here [[PHP settings by Moodle version]].

If you want to run Moodle on your own computer, please see [[Installing Apache, MySQL and PHP]] for step-by-step instructions for installation on most popular platforms.

== Download and copy files into place ==

There are two ways to get Moodle, either as a compressed package from http://download.moodle.org/ or via [[CVS for Administrators|CVS]].

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

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

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

If you're interested, [[Moodle site moodle directory]] gives a quick summary of the contents of the Moodle folder, to help get you oriented.

== Install a theme ==
To install a [[Themes|theme]]:
# Unzip the .zip file to an empty local directory.
# Upload folder to your web server to the /moodle/theme/[Theme Name]. (Replace [Theme Name] with the name of the theme you have downloaded.) Ensure the new theme folder and its contents are readable by the webserver. Change Read and Write permissions (CHMOD) for the files and folder to 755 - Owner read/write/execute, Group read/execute, Everyone read/execute. Incorrect permissions may prevent display of the newly installed theme.
# Choose your new theme from within Moodle via ''Administration > Appearance > Themes > Theme selector'' (version 1.7+) or ''Administration > Configuration > Themes'' (older versions).

== Setting-up your web server ==
You need to create a blank '''database''' for Moodle to use and finally create a '''directory''' on your hard disk for Moodle to save your materials and other files you upload into your courses before you can start the installation process.

=== Create empty database ===

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

For more help with this see [[Create Moodle site database]].

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

The '''[http://www.cpanel.com/ cPanel]''' system is one of the most popular of these.
To create a database using cPanel:

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

=== Create the data directory ===

Moodle will also need some space on your server's hard disk to store uploaded files, such as course documents and user pictures. The Moodle installer tries hard to create the '''moodledata''' directory for you but if it fails then you will have to create a directory for this purpose manually.

<table style=background-color:lightCyan border=1 cellpadding=5 cellspacing=0 ><tr><td>
'''Security warning''': For security purposes, it is '''CRITICAL''' that this directory is '''NOT''' accessible directly via the web. The easiest way to do this is to simply locate it OUTSIDE the web site root directory (it is the folder that the main part of your URL -that is, the part up to the first single / - points to; for example, in <nowiki>http://your.domain.com/moodle/admin/cron.php</nowiki>, it is <nowiki>http://your.domain.com/</nowiki>).

'''If you don't protect the data directory from direct web access, anybody will be able to impersonate any user of your Moodle site (including the admin user!!!), and all of your course materials will be available to the web at large.'''
</table>

See [[Creating Moodle site data directory]] for more information about security in creating a data directory in CPanel in webhosts.

=== Troubleshooting ===

If you run into problems when installing Moodle you might have to tweak some of the settings for your Apache server or your PHP installation.

* [[Installing Moodle/httpd.conf setup]]
* [[Installing Moodle/Creating custom php.ini files]] for details.
* '''Alternative to ''php.ini'' and ''httpd.conf'' files''': If you do not have access to your php.ini or httpd.conf files on you web host, see [[Create .htaccess file]].
* Warning: as noted at http://moodle.org/mod/forum/discuss.php?d=124441&parent=550026 some Moodle installers such as Ubuntu populate an Apache conf.d file with php directives. Before trying to change any php directives make sure that no php directives are set in any apache conf file, including files in /atc/apache2/conf.d or similar directory.

== Start Moodle install ==
There are two basic ways to install Moodle: Most Moodlers are used to the installer script but with Moodle 2.0 you may install it from the command line.

=== Install with installer script ===

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

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

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

Along the way the installer will test your server environment and give you suggestions about how to fix any problems. For most common issues these suggestions should be sufficient, but if you get stuck, check in the Installation Forum for more help.

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

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

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

Now Moodle will start setting up your database and creating tables to store data. First, the main database tables are created. You should see a number of SQL statements followed by status messages. You should see SUCCESS next to each one until you see "Main databases set up successfully."

:''Tip:'' If you don't see these, then there must have been some problem with the database or the configuration settings you defined in config.php. Please see [[Install Moodle with installer script]] for more details and issues.

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

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

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

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

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

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

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

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

Once successful, you will be sent to the home page of your new site! Please note the [[Site administration block]] on the left with links. These items are only visible to you because you are logged in as the admin user. All your further administration of Moodle can now be done using this block.

=== Installing Moodle using command line ===
{{Moodle 2.0}}

[[Installing Moodle using command line]] is recommended only for experienced server administrators. Please note you have to execute the installation script as the same user used for apache. Command line installation is not compatible with Windows platforms.

$cd /var/www/html/moodle/admin/cli

More information about the options can be found using
$sudo -u wwwrun /usr/bin/php install.php --help

==Last tasks==

=== Set up cron ===

Moodle's background tasks (e.g. sending out forum emails and performing course backups) are performed by a script which you can set to execute at specific times of the day. This is known as a cron script. Please refer to the [[Cron|Cron instructions]].

=== Set up backups ===

Please refer to the [[Backup settings| backup instructions]].

=== Send a test email ===

Create a [[Manual_accounts|test user]] with a valid email address and [[message|send them a message]]. Do they receive an email copy of the message? If not then your email server and/or Moodle email settings may be misconfigured (see [[Email_processing|Email Processing]] for details.

===Create a new course===

Congratulations on setting up your Moodle site! You can now [[Adding/editing a course|create a new course]] and have a play ;-)

== See also ==
* [[Complete install packages]]
* Using Moodle [http://moodle.org/mod/forum/view.php?id=28 Installation problems forum]
* [[Installing Apache, MySQL and PHP]]
* [[Upgrading Moodle]]
* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=42688 Selecting a web host for Moodle] forum discussion
* [[masquerading|Masquerading]] - Running Moodle behind a masquerading/NAT firewall
* [http://ic.eflclasses.org/tutorials/settingupmoodleonhostingwitholdcpanel.swf Tutorial on choosing a host and setting up moodle via the old cpanel]
* [[Installation FAQ]]
* [[Finding and Selecting A Web Host]]
* [[experimental:Getting Help Installing and Managing Moodle]]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client]]
* [[Installing Moodle on Windows Vista]]
* [[Step-by-step Installation Guide for Ubuntu]]
* [[RedHat Linux installation]]

[[es:Instalaci%C3%B3n_de_moodle]]
[[de:Installation von Moodle]]
[[ja:Moodleのインストール]]
{{Review}}

Installing Moodle

2010-08-11T08:39:53Z

Daddydoos: /* Create the data directory */

{{Template:Installing Moodle}}
'''Firstly, don't panic!''' [[Image:F1 35px.png]]

This guide explains how to install Moodle for the first time. There are links to other pages that go into more detail and try to cover the majority of possible web server setups.

Secondly, you may want to consider reviewing [[Finding and Selecting A Web Host]] to consider whether you really want to install Moodle yourself. If you decide to move forward with an installation, please read all the installation documentation carefully. Thirdly, if you still have a problem for which you can't find the answer, please see the Using Moodle [http://moodle.org/mod/forum/view.php?id=28 Installation problems forum] where there are many people who can help you.

== Requirements ==

Moodle is primarily developed in Linux using [[Apache]], [[MySQL]] and [[PHP]] (also sometimes known as the LAMP platform). It is also regularly tested with Windows XP/2000/2003 (WAMP), Solaris 10 (Sparc and x64), Mac OS X and Netware 6 operating systems. Support for PostgreSQL, Oracle and Microsoft SQL Server is also available.

The requirements for Moodle are as follows:

=== Hardware ===
* Disk space: 160MB free (min). You will require more free space to store your teaching materials.
* Memory: 256MB (min), 1GB (recommended). The general rule of thumb is that Moodle can support 50 ''concurrent'' users for every 1GB of RAM, but this will vary depending on your specific hardware and software combination.
** This includes hosting limits of PHP or MySQL on a hosting service.
** The capacity can limit the number of users your Moodle site can handle. See [[User site capacities]]

=== Software ===
* Web server software. Most sites use [[Apache]] as the web server software. Moodle should work fine under any web server that supports [[PHP]], such as [[IIS]] on Windows platforms.
* PHP scripting language. (Please note that there have been issues installing Moodle with [http://www.php-accelerator.co.uk PHP-Accelerator]). There are currently two versions (or branches) of PHP available: PHP4 and PHP5. See the PHP Moodle version requirements here [[PHP settings by Moodle version]].

If you want to run Moodle on your own computer, please see [[Installing Apache, MySQL and PHP]] for step-by-step instructions for installation on most popular platforms.

== Download and copy files into place ==

There are two ways to get Moodle, either as a compressed package from http://download.moodle.org/ or via [[CVS for Administrators|CVS]].

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

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

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

If you're interested, [[Moodle site moodle directory]] gives a quick summary of the contents of the Moodle folder, to help get you oriented.

== Install a theme ==
To install a [[Themes|theme]]:
# Unzip the .zip file to an empty local directory.
# Upload folder to your web server to the /moodle/theme/[Theme Name]. (Replace [Theme Name] with the name of the theme you have downloaded.) Ensure the new theme folder and its contents are readable by the webserver. Change Read and Write permissions (CHMOD) for the files and folder to 755 - Owner read/write/execute, Group read/execute, Everyone read/execute. Incorrect permissions may prevent display of the newly installed theme.
# Choose your new theme from within Moodle via ''Administration > Appearance > Themes > Theme selector'' (version 1.7+) or ''Administration > Configuration > Themes'' (older versions).

== Setting-up your web server ==
You need to create a blank '''database''' for Moodle to use and finally create a '''directory''' on your hard disk for Moodle to save your materials and other files you upload into your courses before you can start the installation process.

=== Create empty database ===

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

For more help with this see [[Create Moodle site database]].

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

The '''[http://www.cpanel.com/ cPanel]''' system is one of the most popular of these.
To create a database using cPanel:

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

=== Create the data directory ===

Moodle will also need some space on your server's hard disk to store uploaded files, such as course documents and user pictures. The Moodle installer tries hard to create the '''moodledata''' directory for you but if it fails then you will have to create a directory for this purpose manually.

<table style=background-color:lightCyan border=1 cellpadding=5 cellspacing=0 ><tr><td>
'''Security warning''': For security purposes, it is '''CRITICAL''' that this directory is '''NOT''' accessible directly via the web. The easiest way to do this is to simply locate it OUTSIDE the web site root directory (it is the folder that the main part of your URL -that is, the part up to the first single / - points to; for example, in <nowiki>http://your.domain.com/moodle/admin/cron.php</nowiki>, it is <nowiki>http://your.domain.com/</nowiki>).

'''If you don't protect the data directory from direct web access, anybody will be able to impersonate any user of your Moodle site (including the admin user!!!), and all of your course materials will be available to the web at large.'''
</table>

See [[Creating Moodle site data directory]] for more information about security in creating a data directory in CPanel in webhosts.

=== Troubleshooting ===

If you run into problems when installing Moodle you might have to tweak some of the settings for your Apache server or your PHP installation.

* [[Installing Moodle/httpd.conf setup]]
* [[Installing Moodle/Creating custom php.ini files]] for details.
* '''Alternative to ''php.ini'' and ''httpd.conf'' files''': If you do not have access to your php.ini or httpd.conf files on you web host, see [[Create .htaccess file]].
* Warning: as noted at http://moodle.org/mod/forum/discuss.php?d=124441&parent=550026 some Moodle installers such as Ubuntu populate an Apache conf.d file with php directives. Before trying to change any php directives make sure that no php directives are set in any apache conf file, including files in /atc/apache2/conf.d or similar directory.

== Start Moodle install ==
There are two basic ways to install Moodle: Most Moodlers are used to the installer script but with Moodle 2.0 you may install it from the command line.

=== Install with installer script ===

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

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

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

Along the way the installer will test your server environment and give you suggestions about how to fix any problems. For most common issues these suggestions should be sufficient, but if you get stuck, check in the Installation Forum for more help.

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

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

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

Now Moodle will start setting up your database and creating tables to store data. First, the main database tables are created. You should see a number of SQL statements followed by status messages. You should see SUCCESS next to each one until you see "Main databases set up successfully."

:''Tip:'' If you don't see these, then there must have been some problem with the database or the configuration settings you defined in config.php. Please see [[Install Moodle with installer script]] for more details and issues.

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

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

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

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

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

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

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

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

Once successful, you will be sent to the home page of your new site! Please note the [[Site administration block]] on the left with links. These items are only visible to you because you are logged in as the admin user. All your further administration of Moodle can now be done using this block.

=== Installing Moodle using command line ===
{{Moodle 2.0}}

[[Installing Moodle using command line]] is recommended only for experienced server administrators. Please note you have to execute the installation script as the same user used for apache. Command line installation is not compatible with Windows platforms.

$cd /var/www/html/moodle/admin/cli

More information about the options can be found using
$sudo -u wwwrun /usr/bin/php install.php --help

==Last tasks==

=== Set up cron ===

Moodle's background tasks (e.g. sending out forum emails and performing course backups) are performed by a script which you can set to execute at specific times of the day. This is known as a cron script. Please refer to the [[Cron|Cron instructions]].

=== Set up backups ===

Please refer to the [[Backup settings| backup instructions]].

=== Send a test email ===

Create a [[Manual_accounts|test user]] with a valid email address and [[message|send them a message]]. Do they receive an email copy of the message? If not then your email server and/or Moodle email settings may be misconfigured (see [[Email_processing|Email Processing]] for details.

===Create a new course===

Congratulations on setting up your Moodle site! You can now [[Adding/editing a course|create a new course]] and have a play ;-)

== See also ==
* [[Complete install packages]]
* Using Moodle [http://moodle.org/mod/forum/view.php?id=28 Installation problems forum]
* [[Installing Apache, MySQL and PHP]]
* [[Upgrading Moodle]]
* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=42688 Selecting a web host for Moodle] forum discussion
* [[masquerading|Masquerading]] - Running Moodle behind a masquerading/NAT firewall
* [http://ic.eflclasses.org/tutorials/settingupmoodleonhostingwitholdcpanel.swf Tutorial on choosing a host and setting up moodle via the old cpanel]
* [[Installation FAQ]]
* [[Finding and Selecting A Web Host]]
* [[experimental:Getting Help Installing and Managing Moodle]]

[[es:Instalaci%C3%B3n_de_moodle]]
[[de:Installation von Moodle]]
[[ja:Moodleのインストール]]
{{Review}}

Installing Moodle

2010-08-11T08:38:51Z

Daddydoos: /* Last tasks */

{{Template:Installing Moodle}}
'''Firstly, don't panic!''' [[Image:F1 35px.png]]

This guide explains how to install Moodle for the first time. There are links to other pages that go into more detail and try to cover the majority of possible web server setups.

Secondly, you may want to consider reviewing [[Finding and Selecting A Web Host]] to consider whether you really want to install Moodle yourself. If you decide to move forward with an installation, please read all the installation documentation carefully. Thirdly, if you still have a problem for which you can't find the answer, please see the Using Moodle [http://moodle.org/mod/forum/view.php?id=28 Installation problems forum] where there are many people who can help you.

== Requirements ==

Moodle is primarily developed in Linux using [[Apache]], [[MySQL]] and [[PHP]] (also sometimes known as the LAMP platform). It is also regularly tested with Windows XP/2000/2003 (WAMP), Solaris 10 (Sparc and x64), Mac OS X and Netware 6 operating systems. Support for PostgreSQL, Oracle and Microsoft SQL Server is also available.

The requirements for Moodle are as follows:

=== Hardware ===
* Disk space: 160MB free (min). You will require more free space to store your teaching materials.
* Memory: 256MB (min), 1GB (recommended). The general rule of thumb is that Moodle can support 50 ''concurrent'' users for every 1GB of RAM, but this will vary depending on your specific hardware and software combination.
** This includes hosting limits of PHP or MySQL on a hosting service.
** The capacity can limit the number of users your Moodle site can handle. See [[User site capacities]]

=== Software ===
* Web server software. Most sites use [[Apache]] as the web server software. Moodle should work fine under any web server that supports [[PHP]], such as [[IIS]] on Windows platforms.
* PHP scripting language. (Please note that there have been issues installing Moodle with [http://www.php-accelerator.co.uk PHP-Accelerator]). There are currently two versions (or branches) of PHP available: PHP4 and PHP5. See the PHP Moodle version requirements here [[PHP settings by Moodle version]].

If you want to run Moodle on your own computer, please see [[Installing Apache, MySQL and PHP]] for step-by-step instructions for installation on most popular platforms.

== Download and copy files into place ==

There are two ways to get Moodle, either as a compressed package from http://download.moodle.org/ or via [[CVS for Administrators|CVS]].

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

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

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

If you're interested, [[Moodle site moodle directory]] gives a quick summary of the contents of the Moodle folder, to help get you oriented.

== Install a theme ==
To install a [[Themes|theme]]:
# Unzip the .zip file to an empty local directory.
# Upload folder to your web server to the /moodle/theme/[Theme Name]. (Replace [Theme Name] with the name of the theme you have downloaded.) Ensure the new theme folder and its contents are readable by the webserver. Change Read and Write permissions (CHMOD) for the files and folder to 755 - Owner read/write/execute, Group read/execute, Everyone read/execute. Incorrect permissions may prevent display of the newly installed theme.
# Choose your new theme from within Moodle via ''Administration > Appearance > Themes > Theme selector'' (version 1.7+) or ''Administration > Configuration > Themes'' (older versions).

== Setting-up your web server ==
You need to create a blank '''database''' for Moodle to use and finally create a '''directory''' on your hard disk for Moodle to save your materials and other files you upload into your courses before you can start the installation process.

=== Create empty database ===

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

For more help with this see [[Create Moodle site database]].

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

The '''[http://www.cpanel.com/ cPanel]''' system is one of the most popular of these.
To create a database using cPanel:

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

=== Create the data directory ===

Moodle will also need some space on your server's hard disk to store uploaded files, such as course documents and user pictures. The Moodle installer tries hard to create the '''moodledata''' directory for you but if it fails then you will have to create a directory for this purpose manually.

<table style=background-color:lightCyan border=1 cellpadding=5 cellspacing=0 ><tr><td>
'''Security warning''': For security purposes, it is '''CRITICAL''' that this directory is '''NOT''' accessible directly via the web. The easiest way to do this is to simply locate it OUTSIDE the web site root directory (it is the folder that the main part of your URL -that is, the part up to the first single / - points to; for example, in <nowiki>http://your.domain.com/moodle/admin/cron.php</nowiki>, it is <nowiki>http://your.domain.com/</nowiki>).

'''If you don't protect the data directory from direct web access, anybody will be able to impersonate any user of your Moodle site (including the admin user!!!), and all of your course materials will be available to the web at large.'''
</table>

See [[Creating Moodle site data directory]] for more information about security in creating a data directory in CPanel in webhosts.

=== Troubleshooting ===

If you run into problems when installing Moodle you might have to tweak some of the settings for your Apache server or your PHP installation.

* [[Installing Moodle/httpd.conf setup]]
* [[Installing Moodle/Creating custom php.ini files]] for details.
* '''Alternative to ''php.ini'' and ''httpd.conf'' files''': If you do not have access to your php.ini or httpd.conf files on you web host, see [[Create .htaccess file]].
* Warning: as noted at http://moodle.org/mod/forum/discuss.php?d=124441&parent=550026 some Moodle installers such as Ubuntu populate an Apache conf.d file with php directives. Before trying to change any php directives make sure that no php directives are set in any apache conf file, including files in /atc/apache2/conf.d or similar directory.

== Start Moodle install ==
There are two basic ways to install Moodle: Most Moodlers are used to the installer script but with Moodle 2.0 you may install it from the command line.

=== Install with installer script ===

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

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

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

Along the way the installer will test your server environment and give you suggestions about how to fix any problems. For most common issues these suggestions should be sufficient, but if you get stuck, check in the Installation Forum for more help.

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

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

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

Now Moodle will start setting up your database and creating tables to store data. First, the main database tables are created. You should see a number of SQL statements followed by status messages. You should see SUCCESS next to each one until you see "Main databases set up successfully."

:''Tip:'' If you don't see these, then there must have been some problem with the database or the configuration settings you defined in config.php. Please see [[Install Moodle with installer script]] for more details and issues.

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

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

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

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

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

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

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

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

Once successful, you will be sent to the home page of your new site! Please note the [[Site administration block]] on the left with links. These items are only visible to you because you are logged in as the admin user. All your further administration of Moodle can now be done using this block.

=== Installing Moodle using command line ===
{{Moodle 2.0}}

[[Installing Moodle using command line]] is recommended only for experienced server administrators. Please note you have to execute the installation script as the same user used for apache. Command line installation is not compatible with Windows platforms.

$cd /var/www/html/moodle/admin/cli

More information about the options can be found using
$sudo -u wwwrun /usr/bin/php install.php --help

==Last tasks==

=== Set up cron ===

Moodle's background tasks (e.g. sending out forum emails and performing course backups) are performed by a script which you can set to execute at specific times of the day. This is known as a cron script. Please refer to the [[Cron|Cron instructions]].

=== Set up backups ===

Please refer to the [[Backup settings| backup instructions]].

=== Send a test email ===

Create a [[Manual_accounts|test user]] with a valid email address and [[message|send them a message]]. Do they receive an email copy of the message? If not then your email server and/or Moodle email settings may be misconfigured (see [[Email_processing|Email Processing]] for details.

===Create a new course===

Congratulations on setting up your Moodle site! You can now [[Adding/editing a course|create a new course]] and have a play ;-)

== See also ==
* [[Complete install packages]]
* Using Moodle [http://moodle.org/mod/forum/view.php?id=28 Installation problems forum]
* [[Installing Apache, MySQL and PHP]]
* [[Upgrading Moodle]]
* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=42688 Selecting a web host for Moodle] forum discussion
* [[masquerading|Masquerading]] - Running Moodle behind a masquerading/NAT firewall
* [http://ic.eflclasses.org/tutorials/settingupmoodleonhostingwitholdcpanel.swf Tutorial on choosing a host and setting up moodle via the old cpanel]
* [[Installation FAQ]]
* [[Finding and Selecting A Web Host]]
* [[experimental:Getting Help Installing and Managing Moodle]]

[[es:Instalaci%C3%B3n_de_moodle]]
[[de:Installation von Moodle]]
[[ja:Moodleのインストール]]
{{Review}}

2010-06-14T16:04:44Z

Daddydoos: /* Configuring Virtual Directory Properties */

== What is WebDAV? ==

WebDAV access allows users which can edit course files to do so from a convenient WebDAV "Web Folder"/Mountpoint which acts like a local drive.

=== Configuring WebDAV in Moodle ===
To set up WebDAV access in your Moodle installation:

* In Admin->Server->WebDAV Set webdavenable to Yes.
* The 'moodle/site:webdav' capability controls who can connect - by default the "Course Creator" role has it. Assign the role at the system level for users to be able to connect.
* If you want to restrict WebDAVaccess so it is only accessible from the local LAN, use the webdavsubnet setting.

(This feature will be available after v1.9)

''Note:'' For the WebDAV feature to work, the PHP setting magic_quotes_gpc '''must''' be ''off''.

== Configuring WebDAV on Microsoft Windows Server 2003 R2 (Service Pack 2), IIS V6.0 ==

=== Configure IIS ===

Configuring a new virtual directory in IIS is a two-step process:

#Create a new virtual directory using the Virtual Directory wizard
#Configure the access permissions on the new virtual directory

==== Create New Virtual Directory ====
#Open IIS and right-click on your Moodle website. Select '''New -> Virtual Directory'''... from the pop-up menu. [[Image:New_virtual_directory.png|200 px|Menu option required for creating new virtual directory]]
#Select '''New -> Virtual directory...''' from the pop-up menu. The '''Create New Virtual Directory Wizard''' is displayed. [[Image:Wizard_intro.png|200 px|IIS Virtual Directory Creation Wizard]]
#Call the new virtual directory '''Moodledata'''. [[Image:Name_directory.png|200 px|alt text]]
#Specify the path to the Moodledata directory. [[Image:Choose_path.png|200 px|Choosing path to folder on server]]
#Ensure the new virtual directory has '''Read''', '''Write''' and '''Browse''' permissions. [[Image:Directory_permissions.png|200 px|Specifying directory permissions]]
#Press the Finish button to create the new virtual directory.

==== Configuring Virtual Directory Properties ====

#Right-click on the new virtual directory and select Properties from the pop-up menu. [[Image:Check_properties.png|200 px|Checking new virtual directory properties]]
#Ensure that '''Read''', '''Write''', '''Directory browsing''', and '''Log visits''' are checked. Ensure '''Index this resource''' is unchecked. [[Image:Properties_view.png|200 px|Virtual directory properties correctly configured]]
#Click on the '''Directory Security''' tab and press the '''Authentication and access control''' Edit... button [[Image:Authentication_tab.png|200 px|Directory Security authentication and access control]]
#Authenticated access configuration will depend on your needs. Basic access will require you to uncheck '''Enable anonymous access''' and check '''Basic authentication (password is sent in clear text)'''. You may get a warning about security: [[Image:Authentication_warn.png|200 px|Directory security warning]]
#Your new virtual directory is ready for testing. [[Image:Final_view.png|200 px|New virtual directory ready for use]]

=== Testing WebDAV on Windows XP ===

''Note:'' Internet Explorer 8.0 no longer supports web folders. See [http://blogs.msdn.com/b/askie/archive/2009/03/20/open-as-web-folder-not-in-the-internet-explorer-8-file-open-dialog.aspx this blog post from David Conner] for details. You will need to map a network drive instead.

== See Also ==
* [[WebDAV Connect]]
* Some discussions at [http://moodle.org/course/view.php?id=5 Using Moodle]:
** [http://moodle.org/mod/forum/discuss.php?d=41217 WebDAV extension for Moodle] discussion from 2006
** [http://moodle.org/mod/forum/discuss.php?d=89123 WebDAV for Moodledata] discussion from 2008
** [http://moodle.org/mod/forum/discuss.php?d=134984 WebDAV for "Course Files" in 2.0] discussion from 2009

[[Category: Administrator]]

Teaching-wise, I'm a maths and science tutor from leafy Worcestershire in the UK, and when not tutoring I run the popular [http://www.yourmathstutor.info YourMathsTutor] website.

Moodle-wise, I'm a VLE specialist, currently dashing around the UK training teachers and lecturers, mainly on behalf of Moodle Partner [http://www.synergy-learning.com Synergy Learning].

I'm also author of [http://www.packtpub.com/moodle-course-conversion/book Moodle Course Conversion: Beginner's Guide], which was the first of Packt Publishing's popular Beginner's Guides book series, and [http://www.packtpub.com/moodle-1-9-math/book Moodle 1.9 Math], dedicated to teaching mathematics with Moodle.

For more details (and ordering information) please visit the Moodle Course Conversion and Moodle 1.9 Math pages on the Packt Publishing website.

User:Ian Wild

2010-06-14T13:53:35Z

Daddydoos:

Teaching-wise, I'm a maths and science tutor from leafy Worcestershire in the UK, and when not tutoring I run the popular [http://www.yourmathstutor.info YourMathsTutor] website.

Moodle-wise, I'm a VLE specialist, currently dashing around the UK training teachers and lecturers, mainly on behalf of Moodle Partner [http://www.synergy-learning.com Synergy Learning].

I'm also author of [https://www.packtpub.com/moodle-course-conversion/book Moodle Course Conversion: Beginner's Guide], which was the first of Packt Publishing's popular Beginner's Guides book series, and [https://www.packtpub.com/moodle-1-9-math/book Moodle 1.9 Math], dedicated to teaching mathematics with Moodle.

For more details (and ordering information) please visit the Moodle Course Conversion and Moodle 1.9 Math pages on the Packt Publishing website.

User:Ian Wild

2010-06-14T13:45:40Z

Daddydoos: New page: Teaching-wise, I'm a maths and science tutor from leafy Worcestershire in the UK, and when not tutoring I run the popular YourMathsTutor website. Moodle-wise, I'm a VLE specialist, curre...

Teaching-wise, I'm a maths and science tutor from leafy Worcestershire in the UK, and when not tutoring I run the popular YourMathsTutor website.

Moodle-wise, I'm a VLE specialist, currently dashing around the UK training teachers and lecturers, mainly on behalf of Moodle Partner Synergy Learning.

I'm also author of "Moodle Course Conversion: Beginner's Guide", which was the first of Packt Publishing's popular Beginner's Guides book series, and "Moodle 1.9 Math", dedicated to teaching mathematics with Moodle.

For more details (and ordering information) please visit the Moodle Course Conversion and Moodle 1.9 Math pages on the Packt Publishing website.

Mathematics

2009-07-26T16:44:15Z

Daddydoos: /* Java Tools for Building Applets for Interactive Demonstration */

==Equation Construction and Display==
===Tools===
There are a variety of tools that are available for the purpose of constructing equations, providing text expressions that can be converted to equations, and displaying equations.

The most common text expression syntax is LaTeX or a derivative with probably the most common form of display being a conversion of the equation to an image file. However, is demonstrated with ASCIIMathML simple text expressions can now be be converted to MathML on the fly.

Some tools for creating and displaying equations on-line that may be of interest to those teaching mathematics are:
* [[ASCIIMathML]], which both converts equations into MathML on the fly and provides a text expression syntax more easily mastered than Tex, though the filter will convert TeX expressions as well. [http://sourceforge.net/project/showfiles.php?group_id=106148 The ASCIIMathML 2.0.2 zip] provides all the files necessary for setting ASCIIMathML up as a Moodle filter as well creating run-time graphs with ASCIIsvg. An on-line calculator is also included. Just recently an ASCIIMathML export format for DragMath was added to version 0.7.2, [https://docs.moodle.org/en/DragMath_equation_editor available here], so that you have access to both a GUI and text expression syntax for creating and displaying equations. Quick and GIFless. [http://math.chapman.edu/~jipsen/asciencepad/asciencepad.html ASciencePad is also available] and consists of htmlarea enhanced with the ASCIIMathML functionality.
* [http://moodle.org/mod/data/view.php?d=13&rid=916 Tim Hunt's Moodle MathTran Module] converts Tex into images on the fly. You can also use [http://www.mathtran.org/wiki/index.php/TeX_image mathtran_img.js] on a page by page basis.
* The [[TeX filter]], which allows [http://www.tug.org/begin.html TeX markup] to be inserted anywhere (e.g. quiz questions, discussion messages, text resources)
* The [[jsMath]] filter, which does a similar job but using [[Javascript]] on the user's computer
* [[Calculated question type]]
* [[DragMath equation editor]], a WYSIWYG equation editor that integrates easily with the Moodle HTML editor.
* [[WIRIS]], is a plugin that easily integrates with the HTML editor several math tools
** WYSIWYG equation editor. Based on MathML
** Advanced calculator. Integrals, derivatives, limits, ploting in 2D and 3D,...
* MathType, a commercial product created by DSI (the folk who also offer MathPlayer, a plugin many IE users employ). Bob Mathews recently posted [http://moodle.org/mod/forum/discuss.php?d=93728&parent=549428] that info on MathType can be found at http://www.dessci.com/en/support/mathtype/workswith/moodle.htm
Mathematics teachers may also be interested to follow the work of [http://maths.york.ac.uk York University Maths department], who are working on [http://maths.york.ac.uk/serving_maths/ some projects] to augment Moodle, particularly its [[Quiz module]] for online assessment, for example by integrating a system which is able to mark algebraic and trigonometric answers to open-ended questions.

===Accessibility Display Matrix===

{{Expand-section|date=August 2008}}

■ Feature Key appears below the matrix.

{| border="1" cellpadding="2" cellspacing="0"
!Notation
!Tex/LaTex
!ASCIIMath
!MathML
|-
|Ease of Use
|Plain text system. Knowledge of LaTeX notation required. Being a plain text system, LaTeX notation is straightforward to create and edit.
|Plain text system. Easy to learn. Notation simple. Being a plain text system, ASCIIMath is very easy to create and edit.
|XML-based. Not easy to create and edit: an editor is required.
|-
|Conversion to Braille
|Output directly to Braille display via screen reader (fn 2)
|ASCIIMath notation is converted to MathML or LaTeX. Please refer to those formats for details.
|Converted to suitable textual format and Brailled using screen reader (fn 3)
|-
|Transmission via TTS
|Notation spoken "as-is" via screen reader (fn 2)
|ASCIIMath notation is converted to MathML or LaTeX. Please refer to those formats for details.
|Converted to suitable textual format and spoken using screen reader. Note that MathPlayer add-on for IE has TTS functionality built-in (fn 3).
|-
|}

'''fn1.'''
MathPlayer claims to do math-to-speech by parsing the MathML, not by parsing TeX. See http://www.dessci.com/en/products/mathplayer/tech/accessibility.htm where it is stated:

All of these examples were written in Microsoft Word and MathType and exported to MathML using MathType’s “MathPage” technology. MathPage technology was added to MathType in version 5.0. No special work is needed to author the expressions to make them accessible. Any product that exports MathML will produce pages that MathPlayer can speak.

For a larger real life example, see this page. Also, MSN Encarta uses MathML on many of their web pages that contain math, so much of their Math should be accessible using MathPlayer.

'''fn2. '''
The alt attribute of the rendered graphic is spoken and/or Braillled. As LaTeX is a plain text notation, the notation can be spoken and Brailled by the screen reader directly. This does, of course, assume an understanding of LaTeX notation on the part of the screen reader user.

'''fn3. '''
In the case of Internet Explorer, screen readers require the MathPlayer plugin to be installed before MathML is rendered (IE does not include native MathML support). By using MSAA, the screen reader can obtain a textual version of the math notation from MathPlayer, which it can then TTS and Braille. Note that MathPlayer also contains built-in TTS functionality (employing MS SAPI) which can be used to speak the math notation without having to employ a screen reader. See [http://www.dessci.com/en/products/mathplayer/tech/accessibility.htm] for further details. At time of writing, screen reader support for Firefox is via MSAA and a special custom, Firefox-specific IAccessible2 interface (to reveal text attributes and character positions). Math notation is spoken via a screen reader which interrogates these interfaces.

==Using Java for Curriculum==
===Java Tools for Building Applets for Interactive Demonstration===
These tools can be integrated in or used with Moodle Resources
* Java Sketchpad, http://www.dynamicgeometry.com/JavaSketchpad/About_JavaSketchpad.html, is an applet developed by Key Curriculum Press. The applet has been the focus of quite a bit of discussion and demonstrations and discussions are widely available. An introductory article from the Journal of Online Mathematics can be found here: http://mathdl.maa.org/mathDL/4/?nodeId=508&pa=content&sa=viewDocument. Usage focuses largely on Geometry
* CabriJava, http://www-cabri.imag.fr/cabrijava/, an applet offered by the University of Cabri, also focuses on interactive geometry. Quite a number of examples employing CabriJava can be found here: http://www.mathsnet.net/cabri/index.html.
* Descartes, http://descartes.cnice.mec.es/, is an applet developed under the auspices of the Spanish Ministerio de Educacion Politica Social y Diporte. An English introduction can be found here at http://descartes.cnice.mec.es/ingles/index.html. The Ministery has produced an extensive Mathematics curriculum using Descartes, which is available in English and can be freely downloaded and used. Much of what is available is still only in Spanish so anyone interested in doing translation work please post to the Moodle Math Tools forum.

===Additional Curricular Use of Applets===
*Euclid's Elements - http://aleph0.clarku.edu/~djoyce/java/elements/elements.html
*Tutorials employing applets (applets can be downloaded and used in Moodle) http://www.analyzemath.com/

===Applet Tools===
*Graphing - http://www.langara.bc.ca/mathstats/resource/GraphExplorer/
*Geometry Construction - http://www.cs.rice.edu/~jwarren/grace/
*GeoGebra - http://www.geogebra.org/

===Java Applet Collections===
* http://cs.jsu.edu/mcis/faculty/leathrum/Mathlets/
* http://www.walter-fendt.de/m14e/

* Probability and Statistics
**http://www.mste.uiuc.edu/pavel/java/dilemma/
**http://lstat.kuleuven.be/java/
**http://www.math.csusb.edu/faculty/stanton/m262/

*http://www.mste.uiuc.edu/murphy/JavaOverview/default.html
*Math and Physics - http://www.falstad.com/mathphysics.html
*Curves - http://www-groups.dcs.st-and.ac.uk/~history/Java/index.html
*Chaos and Fractals - http://math.bu.edu/DYSYS/applets/index.html
*For sale, but extensive - http://www.cut-the-knot.org/Curriculum/index.shtml

==Mathematics Assessment==

Assessment is a key driver for mathematics. There are a number of ways of getting students to answer mathematical questions through Moodle.
* WebWork, see http://webwork.maa.org/wiki/Main_Page http://webwork.math.rochester.edu/docs/docs/, and http://webwork.maa.org/moodle/ is an independent web application for assessing student Math progress, and there is a Moodle Module for interfacing WebWork to Moodle that can be found here: http://moodle.org/mod/data/view.php?d=13&rid=332, though the resources on the WeBWork wiki are probably more current as the code in the Moodle CVS has not been updated for some time.
* STACK provides very mathematical questions for the Moodle quiz module. These are supported by the CAS Maxima. The home page for STACK can be found on http://stack.bham.ac.uk/

==See also==
* [[Mathematics tools FAQ]]
Using Moodle forum discussions:
* [http://moodle.org/mod/forum/discuss.php?d=46009 Best practices for teaching Math(s) in Moodle]
* [http://moodle.org/mod/forum/discuss.php?d=61993 How do you deal with the challenge of writing equations?]
* [http://moodle.org/mod/forum/discuss.php?d=62002 How do you deal with the challenge of drawing graphs and diagrams?]
* [http://moodle.org/mod/forum/discuss.php?d=62014 How do you deal with the challenge of interactive exercises and simulations?]
* [http://moodle.org/mod/forum/discuss.php?d=95950 How can I have a student enter a fraction as an answer?]
* [http://moodle.org/mod/forum/discuss.php?d=127867 What are the components of an exemplary high school Moodle course?]

[[Category:Mathematics]]

Moodle manuals

2008-10-27T23:47:23Z

Daddydoos: /* English */

__NOTOC__
This page contains some links to manuals, tutorials and other multimedia documentation produced by moodlers all over the world. Please feel free to submit your contribution by adding a link to this page or sending the file to [mailto:docs@moodle.org docs@moodle.org].

==Teacher manuals==

===English===
*[http://download.moodle.org/download.php/docs/en/moodle_1.4.3_for_teachers_and_trainers.pdf Moodle 1.4.3 For Teachers and Trainers] - by '''Bryan Williams''' (PDF, 2.4MB)
*[http://download.moodle.org/download.php/docs/en/using-your-moodle.pdf Using Your Moodle (1.4.3)] by [[User:Darren_Smith Darren Smith]] (PDF, 2MB, Published Jan 2005)
*[http://download.moodle.org/download.php/docs/en/teacher-manual.pdf Moodle 1.4 Teacher Manual] - by '''Matt Riordan''' (PDF, 3.5MB)
*[http://www.staff.sbc.edu/tmarcais/classfiles/moodle/Moodle1.5.3.pdf Moodle 1.5.3 Teacher Manual] - Original Documentation by '''Matt Riordan''', updated to version 1.5.3 by '''Tom Marcais''' (PDF, 9.1MB)
*[http://www.packtpub.com/moodle-course-conversion/book Moodle Course Conversion: Beginner's Guide] - by '''Ian Wild''', [http://www.packtpub.com/ Packt Publishing], November 2008, Print 264 pages £24.99, PDF version £16.99
*[http://www.packtpub.com/moodle/book Moodle E-Learning Course Development] - by William Rice, [http://www.packtpub.com/ Packt Publishing], May 2006, 250 pages, €33.29/$35.99
*[http://moodle.fct.unl.pt/mod/resource/view.php?id=24107 A Visual Introduction to Moodle - for teachers and page creators] - by '''João Fernandes''' (PDF, 4MB), 43 pages, [http://creativecommons.org/licenses/by-nc-sa/2.5/ Creative Commons Non-Comercial Share Alike 2.5 License]
*[http://moodle.tokem.fi/mod/book/index.php?id=1 Illustrated on-line Beginner, Student and Teacher manuals for Moodle 1.5.4, 1.6.4, 1.8.3 and 1.9.2] (including some third-party tools and Flash demos as well as a concise Hot Potatoes manual) by '''Paul Nijbakker''', eLearning Centre of Kemi-Tornio University of Applied Sciences.
*[http://moodle.sbc.edu/mod/resource/view.php?id=8088 Moodle Upgrading from 1.5.3 to 1.8, Changes for Teachers] - by '''Tom Marcais''' (PDF, 3.5MB)
*[http://moodle.sbc.edu/mod/resource/view.php?id=8087 Moodle 1.8 Teacher Manual] - by '''Tom Marcais''' (based in part on documentation by '''Matt Riordan''') (PDF, 10.6MB)
*[http://moodle.de/mod/resource/view.php?id=2092 Moodle Teacher Handbook (Moodle 1.9)] - by '''Renate Jirmann and Ralf Hilgenstock''', 163 pages, 30,- € plus mailing expenses, customized versions and online licence available
*[http://www.oreilly.com/catalog/9780596529185/ Using Moodle, Second Edition] - by '''Jason Cole''' and '''Helen Foster''', 282 pages, $27,99 for the PDF version, each chapter available as a PDF for $3,99 a piece
*[http://www.schoolanywhere.co.uk/moodle_book.php Teacher's Beginners Guide to Using Moodle] - by '''SchoolAnywhere''' , 24 pages, FREE for the PDF version
*[http://www.howtomoodle.com/index.php/moodle-manuals Course Creator Reference Manual 1.8] - by '''Ray Lawrence''' Print 191 pages £15
*[http://www.howtomoodle.com/index.php/moodle-manuals Administrator Reference Manual 1.8] - by '''Ray Lawrence''' Print 69 pages £12
*[http://www.elearning.org.nz MoodleBites online training] - by '''HRDNZ''' 8 week teachers course NZ$199 (free introduction to Moodle available)

===Other Languages===
*[http://www.sfm.pt/e-learning/manual-moodle.php Moodle 1.9 Manual para professores (Português)] - por '''SFM''', Pequenos manuais visuais ou manual completo com 17 MB)
*[http://www.e-lisa-academy.at/dl/MoodleHandbuchLehrerInnen-1.9.pdf Kostenloses Moodle 1.9 Anwenderhandbuch] - in deutscher Sprache (2.6 MB/PDF) und zum Ausdrucken. Erstellt von Kathrin Lind, Florian und Peter Sereinigg im Auftrag von [http://http://www.e-lisa-academy.at/ e-LISA academy]
*[http://www.lakapps.lk/websvn/filedetails.php?repname=Lakapps&path=%2FMoodle%2FTamil%2FMoodle_Teacher_Manual_TA.pdf Moodle 1.8+ Teacher Manual (Tamil - Sri Lanka)] - by '''Kengatharaiyer Sarveswaran''' ,LAKapps project, University of Moratuwa, Sri Lanka. (PDF, 1.54MB)
*[http://www.lakapps.lk/websvn/filedetails.php?repname=Lakapps&path=%2FMoodle%2FSinhala%2FMoodle_Teacher_Manual_SI.pdf Moodle 1.8+ Teacher Manual (Sinhala)] - by '''Sulochana Sooriyaarachchi''' ,LAKapps project, University of Moratuwa, Sri Lanka. (PDF, 2.79MB)
*[http://download.moodle.org/download.php/docs/nl/teacher-manual-1.5-nl.pdf Moodle 1.5 Teacher Manual (Dutch)] - (PDF, 3MB)
*[http://download.moodle.org/download.php/docs/it/teacher-manual-it.pdf Moodle 1.3 Teacher Manual (Italian)] - (PDF, 3.1MB)
*[http://download.moodle.org/download.php/docs/fr/teacher-manual-fr.pdf Moodle 1.3 Teacher Manual (French)] - (PDF, 5MB)
*[http://download.moodle.org/download.php/docs/es/teacher-manual-es.pdf Moodle Teacher Manual (Spanish)] - by '''Enrique Castro Lopez''' (PDF, 5.4MB)
*[http://www.lasalle.es/descargas/ManualMoodle2006.zip Moodle 1.5 Teacher Manual (Spanish)] - by '''Jesús Martín''' (PDF, 5.2MB)
*[http://moodle.de/file.php/1/Moodle_Trainer_18_public.pdf Moodle 1.8 Trainerhandbuch (German) Inhaltsverzeichnis/Content] - von Renate Jirmann und Ralf Hilgenstock 30,- € (gedruckt 155 Seiten)
*[http://moodle.de//mod/resource/view.php?id=1294 moodle @ work (German) Praxisberichte /Use Cases Inhaltsverzeichnis/Content] 12,50 €(gedruckt 150 Seiten)
*[http://moodle.de/mod/resource/view.php?id=1645 moodle- Praxisbuch (German) Info] - von Fredi Gertsch, Addison&Wesley 540 pages, 44,95 €
*[http://file024r.mylivepage.com/chunk24/390895/255/Arb_MOODLE.pdf Moodle Teacher Manual (Arabic)] - by '''Jamil Itmazi''' (PDF, 6.4MB) استعمال موودل للمعلمين باللغة العربية من إعداد: د.جميل إطميزي
*[http://moodle.fct.unl.pt/mod/resource/view.php?id=24107 Uma introdução visual ao Moodle - pa] - by '''João Fernandes''' ra professores e criadores de páginas (PDF, 4MB), 43 pages, [http://creativecommons.org/licenses/by-nc-sa/2.5/ Creative Commons Non-Comercial Share Alike 2.5 License]
*[http://www.open.hr/request.php?5 Moodle 1.6 Teacher Manual (Croatian)] - by '''Ivana Bosnić''' (PDF, 3MB)
*[http://www.moodle.si/moodle/mod/wiki/view.php?id=22 Moodle 1.6 Teacher Manual (Slovenian)] - by '''Alja Sulčič''' and '''Viktorija Sulčič''', Center for e-learning, Faculty of management Koper, Slovenia (Wiki version, requires free site registration)
*[http://195.148.254.152/moodle/mod/book/index.php?id=1 Moodle opiskelijan ja opettajan opas 1.5.4 ja 1.6.4] '''Sanna Saukkoriipi''', Kemi-Tornion ammattikorkeakoulun eOppimiskeskus.
*[http://moodle.de German DVD] 8 Stunden Anleitungsvideos- von '''Ralf Hilgenstock'''
*[http://aulavirtual2.educa.madrid.org/mod/resource/view.php?inpopup=true&id=5659 Moodle versión 1.8 Manual de consulta para el profesorado (Spanish)] - '''Jesús Baños Sancho''' (16.5MB)

==Administration manuals==
*[http://www.howtomoodle.com/index.php/moodle-manuals Administrator Reference Manual 1.8] - by '''Ray Lawrence''' Print 69 pages £12
*[http://moodle.de//mod/resource/view.php?id=1191 Handbuch Installation und Administration (German) Inhaltsverzeichnis/Content] - von André Krüger, Urs Hunkler, Ralf Hilgenstock 30,- € (gedruckt 110 Seiten)
*[http://moodle.org/file.php/16/moddata/forum/160/234243/Install_Moodle.pdf Moodle Administrator Manual (Arabic)] - by '''Jamil Itmazi''' (PDF, 0.3MB) تنزيل موودل باللغة العربية من إعداد: د.جميل إطميزي

==Student manuals==
*[http://www.lakapps.lk/websvn/filedetails.php?repname=Lakapps&path=%2FMoodle%2FTamil%2FMoodle_Student_Manual_TA.pdf Moodle 1.8+ Student Manual (Tamil - Sri Lanka)] - by '''Kengatharaiyer Sarveswaran ,LAKapps project, University of Moratuwa, Sri Lanka.''' (PDF, 700KB)
*[http://www.lakapps.lk/websvn/filedetails.php?repname=Lakapps&path=%2FMoodle%2FSinhala%2FMoodle_Student_Manual_SI.pdf Moodle 1.8+ Student Manual (Sinhala)] - by '''Sulochana Sooriyaarachchi ,LAKapps project, University of Moratuwa, Sri Lanka.''' (PDF, 2 MB)
*[http://download.moodle.org/download.php/docs/es/user_manual_es.pdf Moodle User Manual (Spanish)] - by '''Enrique Castro''' (PDF, 3.1MB)
*[http://moodle.de//file.php?file=/1/Bestellblatt.pdf Teilnehmerhandbuch (German) Info und Bestellformular] - von Ralf Hilgenstock und Renate Jirmann (gedruckt 63 Seiten)
*[http://jamildepalestina.mylivepage.com/file/?fileid=882 Moodle Student Manual (Arabic)] - by '''Jamil Itmazi''' (PDF, 3 MB) استعمال موودل للطلاب باللغة العربية من إعداد: د.جميل إطميزي
*[http://moodle.tokem.fi/mod/book/index.php?id=1 Illustrated on-line Beginner, Student and Teacher manuals for Moodle 1.5.4, 1.6.4, 1.8.3 and 1.9.2] (including descriptions of some contrib tools) in English and Finnish by '''Paul Nijbakker''' and '''Sanna Saukkoriipi''', eLearning Centre of Kemi-Tornio University of Applied Sciences.

==See also==
*[[Moodle presentations]]
[[Category:Teacher]]

[[es:Manuales de Moodle]]

Template:Expand-section

2008-08-14T15:03:29Z

Daddydoos:

'''Note:''' This section is a work in progress. Please use the page comments for any recommendations/suggestions for improvement. ''({{{date}}})''

<noinclude>[[fr:Modèle:Travail en cours]]</noinclude>

Mathematics

2008-08-13T10:48:35Z

Daddydoos: /* Accessibility Display Matrix */

==Equation Construction and Display==
===Tools===
There are a variety of tools that are available for the purpose of constructing equations, providing text expressions that can be converted to equations, and displaying equations.

The most common text expression syntax is LaTeX or a derivative with probably the most common form of display being a conversion of the equation to an image file. However, is demonstrated with ASCIIMathML simple text expressions can now be be converted to MathML on the fly.

Some tools for creating and displaying equations on-line that may be of interest to those teaching mathematics are:
* [[ASCIIMathML]], which both converts equations into MathML on the fly and provides a text expression syntax more easily mastered than Tex, though the filter will convert TeX expressions as well. [http://sourceforge.net/project/showfiles.php?group_id=106148 The ASCIIMathML 2.0.2 zip] provides all the files necessary for setting ASCIIMathML up as a Moodle filter as well creating run-time graphs with ASCIIsvg. An on-line calculator is also included. Just recently an ASCIIMathML export format for DragMath was added to version 0.7.2, [https://docs.moodle.org/en/DragMath_equation_editor available here], so that you have access to both a GUI and text expression syntax for creating and displaying equations. Quick and GIFless. [http://math.chapman.edu/~jipsen/asciencepad/asciencepad.html ASciencePad is also available] and consists of htmlarea enhanced with the ASCIIMathML functionality.
* [http://moodle.org/mod/data/view.php?d=13&rid=916 Tim Hunt's Moodle MathTran Module] converts Tex into images on the fly. You can also use [http://www.mathtran.org/wiki/index.php/TeX_image mathtran_img.js] on a page by page basis.
* The [[TeX filter]], which allows [http://www.tug.org/begin.html TeX markup] to be inserted anywhere (e.g. quiz questions, discussion messages, text resources)
* The [[jsMath]] filter, which does a similar job but using [[Javascript]] on the user's computer
* [[Calculated question type]]
* [[DragMath equation editor]], a WYSIWYG equation editor that integrates easily with the Moodle HTML editor.
* WIRIS, http://www.wiris.com/, is a commercial product that has a free component and a Moodle plugin: http://moodle.org/mod/data/view.php?d=13&rid=927

Mathematics teachers may also be interested to follow the work of [http://maths.york.ac.uk York University Maths department], who are working on [http://maths.york.ac.uk/serving_maths/ some projects] to augment Moodle, particularly its [[Quiz module]] for online assessment, for example by integrating a system which is able to mark algebraic and trigonometric answers to open-ended questions.

===Accessibility Display Matrix===

{{Expand-section|date=August 2008}}

■ Feature Key appears below the matrix.

{| border="1" cellpadding="2" cellspacing="0"
!Notation
!Tex/LaTex
!ASCIIMath
!MathML
|-
|Ease of Use
|Plain text system. Knowledge of LaTeX notation required. Being a plain text system, LaTeX notation is straightforward to create and edit.
|Plain text system. Easy to learn. Notation simple. Being a plain text system, ASCIIMath is very easy to create and edit.
|XML-based. Not easy to create and edit: an editor is required.
|-
|Conversion to Braille
|Output directly to Braille display via screen reader (fn 2)
|ASCIIMath notation is converted to MathML or LaTeX. Please refer to those formats for details.
|Converted to suitable textual format and Brailled using screen reader (fn 3)
|-
|Transmission via TTS
|Notation spoken "as-is" via screen reader (fn 2)
|ASCIIMath notation is converted to MathML or LaTeX. Please refer to those formats for details.
|Converted to suitable textual format and spoken using screen reader. Note that MathPlayer add-on for IE has TTS functionality built-in (fn 3).
|-
|}

'''fn1.'''
MathPlayer claims to do math-to-speech by parsing the MathML, not by parsing TeX. See http://www.dessci.com/en/products/mathplayer/tech/accessibility.htm where it is stated:

All of these examples were written in Microsoft Word and MathType and exported to MathML using MathType’s “MathPage” technology. MathPage technology was added to MathType in version 5.0. No special work is needed to author the expressions to make them accessible. Any product that exports MathML will produce pages that MathPlayer can speak.

For a larger real life example, see this page. Also, MSN Encarta uses MathML on many of their web pages that contain math, so much of their Math should be accessible using MathPlayer.

'''fn2. '''
The alt attribute of the rendered graphic is spoken and/or Braillled. As LaTeX is a plain text notation, the notation can be spoken and Brailled by the screen reader directly. This does, of course, assume an understanding of LaTeX notation on the part of the screen reader user.

'''fn3. '''
In the case of Internet Explorer, screen readers require the MathPlayer plugin to be installed before MathML is rendered (IE does not include native MathML support). By using MSAA, the screen reader can obtain a textual version of the math notation from MathPlayer, which it can then TTS and Braille. Note that MathPlayer also contains built-in TTS functionality (employing MS SAPI) which can be used to speak the math notation without having to employ a screen reader. See [http://www.dessci.com/en/products/mathplayer/tech/accessibility.htm] for further details. At time of writing, screen reader support for Firefox is via MSAA and a special custom, Firefox-specific IAccessible2 interface (to reveal text attributes and character positions). Math notation is spoken via a screen reader which interrogates these interfaces.

==Using Java for Curriculum==
===Java Tools for Building Applets for Interactive Demonstration===
These tools can be integrated in or used with Moodle Resources
* Java Sketchpad, http://www.dynamicgeometry.com/JavaSketchpad/About_JavaSketchpad.html, is an applet developed by Key Curriculum Press. The applet has been the focus of quite a bit of discussion and demonstrations and discussions are widely available. An introductory article from the Journal of Online Mathematics can be found here: http://mathdl.maa.org/mathDL/4/?nodeId=508&pa=content&sa=viewDocument. Usage focuses largely on Geometry
* CabriJava, http://www-cabri.imag.fr/cabrijava/, an applet offered by the University of Cabri, also focuses on interactive geometry. Quite a number of examples employing CabriJava can be found here: http://www.mathsnet.net/cabri/index.html.
* Descartes, http://descartes.cnice.mec.es/, is an applet developed under the auspices of the Spanish Ministerio de Educacion Politica Social y Diporte. An English introduction can be found here at http://w3.cnice.mec.es/Descartes/Ingles/index.html. The Ministery has produced an extensive Mathematics curriculum using Descartes, which is available in English and can be freely downloaded and used. Much of what is available is still only in Spanish so anyone interested in doing translation work please post to the Moodle Math Tools forum.

===Additional Curricular Use of Applets===
*Euclid's Elements - http://aleph0.clarku.edu/~djoyce/java/elements/elements.html
*Tutorials employing applets (applets can be downloaded and used in Moodle) http://www.analyzemath.com/

===Applet Tools===
*Graphing - http://www.langara.bc.ca/mathstats/resource/GraphExplorer/
*Geometry Construction - http://www.cs.rice.edu/~jwarren/grace/
*GeoGebra - http://www.geogebra.org/

===Java Applet Collections===
* http://cs.jsu.edu/mcis/faculty/leathrum/Mathlets/
* http://www.walter-fendt.de/m14e/

* Probability and Statistics
**http://www.mste.uiuc.edu/pavel/java/dilemma/
**http://lstat.kuleuven.be/java/
**http://www.math.csusb.edu/faculty/stanton/m262/

*http://www.mste.uiuc.edu/murphy/JavaOverview/default.html
*Math and Physics - http://www.falstad.com/mathphysics.html
*Curves - http://www-groups.dcs.st-and.ac.uk/~history/Java/index.html
*Chaos and Fractals - http://math.bu.edu/DYSYS/applets/index.html
*For sale, but extensive - http://www.cut-the-knot.org/Curriculum/index.shtml

==Mathematics Assessment==

Assessment is a key driver for mathematics. There are a number of ways of getting students to answer mathematical questions through Moodle.
* WebWork, see http://webwork.maa.org/wiki/Main_Page http://webwork.math.rochester.edu/docs/docs/, and http://webwork.maa.org/moodle/ is an independent web application for assessing student Math progress, and there is a Moodle Module for interfacing WebWork to Moodle that can be found here: http://moodle.org/mod/data/view.php?d=13&rid=332, though the resources on the WeBWork wiki are probably more current as the code in the Moodle CVS has not been updated for some time.
* STACK provides very mathematical questions for the Moodle quiz module. These are supported by the CAS Maxima. The home page for STACK can be found on http://stack.bham.ac.uk/

==See also==
* [[Mathematics tools FAQ]]
Using Moodle forum discussions:
* [http://moodle.org/mod/forum/discuss.php?d=46009 Best practices for teaching Math(s) in Moodle]
* [http://moodle.org/mod/forum/discuss.php?d=61993 How do you deal with the challenge of writing equations?]
* [http://moodle.org/mod/forum/discuss.php?d=62002 How do you deal with the challenge of drawing graphs and diagrams?]
* [http://moodle.org/mod/forum/discuss.php?d=62014 How do you deal with the challenge of interactive exercises and simulations?]
* [http://moodle.org/mod/forum/discuss.php?d=95950 How can I have a student enter a fraction as an answer?]

[[Category:Mathematics]]