MoodleDocs - User contributions [en]

Windows installation using XAMPP

2008-08-31T11:27:55Z

Ray: /* Troubleshooting */

XAMPP is built for tests or perhaps for a small company using it on an internal network. It is not meant for online access via the web on a production server. This page describes some of the ways to customize XAMPP.

==Introduction==

Note: This guide uses XAMPP 1.5.1

In this guide to installing Moodle on a computer using the Windows XP operating system there are a series of steps you will need to take which are explained step-by-step below. In overview the process is as follows:

The first steps are to obtain the Moodle files themselves and the [[Common_acronyms#N_to_Z|XAMPP]] software package which installs the environment (PHP, Apache and MySql) Moodle requires to run on you computer. When these have been downloaded you will need to install XAMPP on you computer in much the same way as any other Windows program. The steps detail a recommended change to one of the installed components before explaining how to launch XAMPP and create the database required by Moodle (the database you create will be referred to later when installing Moodle).

Having set up the environment you must then place the Moodle files downloaded earlier into the correct location so that they can be accessed for the purposes of initiating the installation process (now) and later to run Moodle. (The installation and use of Moodle is conducted entirely from you web browser e.g. Internet Explorer, Firefox).

'''Note: These guidelines are not intended for the [[Complete install packages for Windows]] from download.Moodle.org - although the troubleshooting part may help if you encounter problems.'''

==Preparation==

===Get Moodle===

*Download the Generic version of Moodle you wish to install from [http://download.moodle.org/ Moodle.org].

[[Image: 14a.gif]].

===Get XAMPP===

*Download XAMPP for Windows from [http://www.apachefriends.org/en/xampp.html Apachefriends.org]. This example assumes that you have downloaded the “Installer” package.

[[image:Xampp1.png]]

===Allow yourself some time===
*Say 45 minutes.

==Installing XAMPP==

*Run the installer, eventually you will be presented with an option about where to install the package.

[[image:Xampp2.gif]]

*In this example we are installing the package at c:\apachefriends\151 – that’s because it suits what our needs, you can choose you own location by specifying any suitable alternative folder.

*Continue with the installation, this will take a while!

[[image:Xampp3.gif]]

*Eventually you will be presented with the option to install Apache, MySQL, Filezilla as a service.

[[image:Xampp4.gif]]

*It’s probably best to choose “No” for now. You can always enable these as services later.

*Next you’ll be asked if you want to start the XAMPP Control Panel.

[[image:Xampp5.gif]]

*Click the “No” button.

===Launch XAMPP Control Panel ===

*On your Desktop, locate the XAMPP icon and double click to launch the Control Panel.

*When the XAMPP Control Panel has launched, click the “Start” buttons for Apache and MySQL.

[[image:Xampp6.gif]]

*If all is well you will see something like this.
'''If Apache fails to run i.e. the "Running" text with the green background keeps disappearing) and you are using Skype - please review "Troubleshooting" at the end of these instructions.'''

[[image:Xampp31.gif]]

==Create the database==

*To create a database for your Moodle “site” we will use the phpMyAdmin utility included with XAMPP.

*To access this launch the web browser of your choice (Firefox is used in this example), type http://localhost in the address bar.

[[image:Xampp8.gif]]

*The XAMPP default page is displayed, click the link for your preferred language – we will be using English.

[[image:Xampp9.gif]]

*From the menu on the left, click on “phpMyAdmin”

[[image:Xampp10.gif]]

*When phpMy Admin has launched in your browser window, enter the name of your database in the “Create new database” field. In this example we are naming our database “moodle153”.

[[image:Xampp11.gif]]

* From the "Collation" drop down list select "utf8_unicode_ci"

*Click the “Create” button to create the database.

[[image:Xampp12.gif]]

The new database should be present in the dropdown list when the page has refreshed.

[[image:Xampp13.gif]]

==Extract the downloaded Moodle files to the correct location.==

*Locate the file downloaded from Moodle.org and either copy or cut the file to the Windows clipboard.

*Open the XAMPP Control Panel and click on the “Explore” button.

[[image:Xampp15.gif]]

*A Windows Explorer view similar to the one below will be displayed.

[[image:Xampp16.gif]]

*Open the “htdocs” folder.

[[image:Xampp17.gif]]

[[image:Xampp18.gif]]

*Paste the file cut/copied earlier into this folder.

*Extract the Moodle files from the file downloaded earlier. A default folder named “moodle” is created with the Moodle files within.

[[image:Xampp19.gif]]

===Windows Vista===
*If you are running Windows Vista, you will need to manually create your moodledata folder and assign it permissions.

*First, go to the "htdocs" folder and create a new folder called "moodledata".
[[image:Vista_moodle_1.jpg]]

*Second, right click and select "Properties".

[[image:Vista_moodle_2.jpg]]

*In the box that pops up, select the "Security" tab.

[[image:Vista_moodle_3.jpg]]

*Click on the "Edit" button.

[[image:Vista_moodle_4.jpg]]

*Another box will pop up. Select "Users" and give them "Modify" and "Write" permissions, along with whatever existed already.

[[image:Vista_moodle_5.jpg]]

==Start the installation==

*In your web browser, type the path to the folder containing the Moodle files in te address bar – in this example it’s <nowiki>http://localhost/moodle</nowiki>.

[[image:Xampp23.gif]]

*The initial install page is displayed.

[[image:Xampp24.gif]]

*Choose your preferred language (English is used in this example) and click the “Next” button.

*A diagnostic report is displayed – hopefully it will look like this, if not you may need to address some issues.

[[image:Xampp25.gif]]

*Click the “Next” button to continue.

*The paths for your Moodle installation are shown – accept these or amend as desired.

[[image:Xampp26.gif]]

*Click the “Next” button to continue.

*In this screen we enter the database settings. The fields are populated with some suggested values.

[[image:Xampp27.gif]]

*In this example the database created is “moodle153”. The “root” user will be used without a password.

*DO NOT USE THE “ROOT” USER WITHOUT A PASSWORD FOR PRODUCTION INSTALLATIONS AS THIS CREATES A SECURITY VULNERABILITY

[[image:Xampp28.gif]]

*When the fields have been populated, click the “Next” button to continue.

*Provided the Moodle folder is writable a message confirming the configuration has been completed will be displayed.

[[image:Xampp29.gif]]

*Click the “ Continue” button to proceed.

The Moodle copyright / licence notices are displayed.

[[image:Xampp30.gif]]

*Click the “Yes” button to continue, then follow the instructions on the following screens.

==Troubleshooting==
===Bitnami===
*If you have previously created a Moodle install with the [http://bitnami.org Bitnami] installer you may find that Apache will not start. This is because Bitnami installs a service for Apache and MySQL. To disable these go to Control Panel > Administrative tools > Service to locate and disable these services.
===Skype===
*If XAMPP does not work when you launch your browser and you have [http://www.skype.com Skype] enabled it may be necessary to change the port settings in Skype.

* Locate "Options..." in Skype.

[[Image: Skype1.gif]]

* Locate the "Connection" options.

[[Image: Skype2.gif]]

* Remove the tick / check from the Checkbox.

[[Image: Skype3.gif]]

* Click the "Save" button.

* You may need to re-start your computer for this to take effect.

===Still having problems but do not have Skype installed?===
* Check for another program which may be using port 80. IIS is commonly found to be the culprit.

====Moodle Networking does not work====
You may need to enable curl. Instructions at this link [http://www.tildemark.com/programming/php/enable-curl-with-xampp-on-windows-xp.html Enable curl in XAMPP on XP]

==See also==
*Return to [[Windows installation]]
*[[Installing AMP]]
*[[Complete install packages|Complete install packages for Windows]]

[[sk:Moodle Windows Inštalácia pomocou XAMPP]]

[[Category:Administrator]]
[[Category:Installation]]

Assignment module FAQ

2008-08-17T09:46:29Z

Ray: /* How can a selected outcome be removed from an assignment? */

{{stub}}{{Assignments}}==Why can't I edit grades for assignment submissions?==

If you edit assignment [[Grades|grades]] directly in the gradebook in Moodle 1.9, an "overridden" flag is set, meaning that the grade can no longer be edited from the [[Assignment submissions|assignment submissions]] page.

If required, the flag can be removed by turning editing on in the [[Grader report|grader report]], then clicking the [[Grade editing|edit grade]] icon, unchecking the overridden box and saving the changes.

==How can a selected outcome be removed from an assignment?==

To remove previously selected outcomes (which appear greyed out on the update assignment page):
[[Image:Edit categories and items showing outcome link.png|left|thumb|Deleting the test outcome from the upload file assignment]]
#Follow the Grades link Administration block in the course.
#Select edit categories and items from the gradebook dropdown menu at the top-left of the page.
#Locate the assignment for which the outcome is to be removed. The outcome is listed directly below it.
#Click the delete icon opposite the outcome.

==See also==

* Using Moodle [http://moodle.org/mod/forum/view.php?f=117 Assignment module forum]

[[Category:FAQ]]

Capabilities/moodle/role:safeoverride

2008-08-16T14:50:39Z

Ray:

{{Moodle 1.9}}* This allows a user to override capabilities that do not have major [[Risks|risks]] attached to them. Higher risk capabilities are locked (greyed out) on the [[Override permissions|override permissions]] page.[[Image:Safe override permissions.png|thumb|Overriding permissions with higher risk capabilities locked]]
* This capability is included in Moodle 1.9.3 onwards. It is not set for any of the default roles.

==Capabilities classified as "safe"==

'''Gradebook'''

Import grades from CSV gradeimport/csv:view

Publish import grades from XML gradeimport/xml:publish

Import grades from XML gradeimport/xml:view

'''Course'''

Edit and manage entries moodle/blog:manageentries

View blog entries moodle/blog:view

Manage any calendar entries moodle/calendar:manageentries

Manage group calendar entries moodle/calendar:managegroupentries

Manage own calendar entries moodle/calendar:manageownentries

Hide/show activities moodle/course:activityvisibility

Send a message to many people moodle/course:bulkmessaging

Manage groups moodle/course:managegroups

Manage scales moodle/course:managescales

Control section visibility moodle/course:sectionvisibility

Set current section moodle/course:setcurrentsection

Enable/disable email address moodle/course:useremail

View courses moodle/course:view

View hidden activities moodle/course:viewhiddenactivities

View hidden courses moodle/course:viewhiddencourses

View hidden sections moodle/course:viewhiddensections

View participants moodle/course:viewparticipants

View scales moodle/course:viewscales

Hide/show courses moodle/course:visibility

Lock grades or items moodle/grade:lock

Manage letter grades moodle/grade:manageletters

Manage grade outcomes moodle/grade:manageoutcomes

Unlock grades or items moodle/grade:unlock

View own grades moodle/grade:view

Manage notes moodle/notes:manage

View notes moodle/notes:view

Add new questions moodle/question:add

Edit all questions moodle/question:editall

Edit your own questions moodle/question:editmine

Edit question categories moodle/question:managecategory

Move all questions moodle/question:moveall

Move your own questions moodle/question:movemine

Use all questions moodle/question:useall

Use your own questions moodle/question:usemine

View all questions moodle/question:viewall

View your own questions moodle/question:viewmine

Override safe permissions for others moodle/role:safeoverride

Switch to other roles moodle/role:switchroles

Unassign own roles moodle/role:unassignself

View hidden role assignments moodle/role:viewhiddenassigns

Access all groups moodle/site:accessallgroups

Always see full names of users moodle/site:viewfullnames

View user profiles moodle/user:viewdetails

'''Assignment'''

Grade assignment mod/assignment:grade

Submit assignment mod/assignment:submit

View assignment mod/assignment:view

'''Chat'''

Talk in a chat mod/chat:chat

Delete chat logs mod/chat:deletelog

Read chat logs mod/chat:readlog

'''Choice'''

Record a choice mod/choice:choose

Delete responses mod/choice:deleteresponses

Download responses mod/choice:downloadresponses

Read responses mod/choice:readresponses

'''Database'''

Approve unapproved entries mod/data:approve

Write comments mod/data:comment

Manage comments mod/data:managecomments

Manage entries mod/data:manageentries

Rate entries mod/data:rate

View presets from all users mod/data:viewalluserpresets

View entries mod/data:viewentry

View ratings mod/data:viewrating

Write entries mod/data:writeentry

'''Forum'''

Add news mod/forum:addnews

Create attachments mod/forum:createattachment

Delete any posts (anytime) mod/forum:deleteanypost

Delete own posts (within deadline) mod/forum:deleteownpost

Edit any post mod/forum:editanypost

Initial subscription mod/forum:initialsubscriptions

Manage subscriptions mod/forum:managesubscriptions

Move discussions mod/forum:movediscussions

Rate posts mod/forum:rate

Reply to news mod/forum:replynews

Reply to posts mod/forum:replypost

Split discussions mod/forum:splitdiscussions

Start new discussions mod/forum:startdiscussion

Throttling applies mod/forum:throttlingapplies

View any ratings mod/forum:viewanyrating

View discussions mod/forum:viewdiscussion

View hidden timed posts mod/forum:viewhiddentimedposts

Always see Q and A posts mod/forum:viewqandawithoutposting

View ratings mod/forum:viewrating

View subscribers mod/forum:viewsubscribers

'''Glossary'''

Approve unapproved entries mod/glossary:approve

Create comments mod/glossary:comment

Export entries mod/glossary:export

Import entries mod/glossary:import

Manage categories mod/glossary:managecategories

Manage comments mod/glossary:managecomments

Manage entries mod/glossary:manageentries

Rate entries mod/glossary:rate

View ratings mod/glossary:viewrating

Create new entries mod/glossary:write

'''Hot Potatoes Quiz'''

Attempt a quiz mod/hotpot:attempt

Delete quiz attempts mod/hotpot:deleteattempt

Modify grades mod/hotpot:grade

View reports mod/hotpot:viewreport

'''LAMS'''

Manage LAMS activities mod/lams:manage

Participate in LAMS activities mod/lams:participate

'''Lesson'''

Manage a lesson activity mod/lesson:manage

'''Quiz'''

Attempt quizzes mod/quiz:attempt

Delete quiz attempts mod/quiz:deleteattempts

Get email confirmation when submitting mod/quiz:emailconfirmsubmission

Get email notification of submissions mod/quiz:emailnotifysubmission

Grade quizzes manually mod/quiz:grade

Ignores time limit on quizzes mod/quiz:ignoretimelimits

Manage quizzes mod/quiz:manage

Preview quizzes mod/quiz:preview

View quiz information mod/quiz:view

View quiz reports mod/quiz:viewreports

'''SCORM/AICC'''

Save tracks mod/scorm:savetrack

Skip overview mod/scorm:skipview

View reports mod/scorm:viewreport

View scores mod/scorm:viewscores

'''Survey'''

Download responses mod/survey:download

Respond to survey mod/survey:participate

View responses mod/survey:readresponses

'''Wiki'''

Manage wiki settings mod/wiki:manage

Override locked pages mod/wiki:overridelock

Edit wiki pages mod/wiki:participate

'''Workshop'''

Manage settings mod/workshop:manage

Participate in workshop mod/workshop:participate

'''RSS Client'''

Create private RSS feedsblock/rss_client:createprivatefeeds

Create shared RSS feedsblock/rss_client:createsharedfeeds

Manage any RSS feedsblock/rss_client:manageanyfeeds

Manage own RSS feedsblock/rss_client:manageownfeeds

'''Block'''

View block moodle/block:view

==See also==

*[[Override permissions]]
*[[Allow role overrides]]
*The capability [[Capabilities/moodle/role:override|moodle/role:override]]

Capabilities/moodle/role:safeoverride

2008-08-16T14:48:32Z

Ray:

{{Moodle 1.9}}* This allows a user to override capabilities that do not have major [[Risks|risks]] attached to them. Higher risk capabilities are locked (greyed out) on the [[Override permissions|override permissions]] page.[[Image:Safe override permissions.png|thumb|Overriding permissions with higher risk capabilities locked]]
* This capability is included in Moodle 1.9.3 onwards. It is not set for any of the default roles.

==Capabilities classified as "safe"==

'''Gradebook'''

Import grades from CSV gradeimport/csv:view

Publish import grades from XML gradeimport/xml:publish

Import grades from XML gradeimport/xml:view

'''Course'''

Edit and manage entries moodle/blog:manageentries

View blog entries moodle/blog:view

Manage any calendar entries moodle/calendar:manageentries

Manage group calendar entries moodle/calendar:managegroupentries

Manage own calendar entries moodle/calendar:manageownentries

Hide/show activities moodle/course:activityvisibility

Send a message to many people moodle/course:bulkmessaging

Manage groups moodle/course:managegroups

Manage scales moodle/course:managescales

Control section visibility moodle/course:sectionvisibility

Set current section moodle/course:setcurrentsection

Enable/disable email address moodle/course:useremail

View courses moodle/course:view

View hidden activities moodle/course:viewhiddenactivities

View hidden courses moodle/course:viewhiddencourses

View hidden sections moodle/course:viewhiddensections

View participants moodle/course:viewparticipants

View scales moodle/course:viewscales

Hide/show courses moodle/course:visibility

Lock grades or items moodle/grade:lock

Manage letter grades moodle/grade:manageletters

Manage grade outcomes moodle/grade:manageoutcomes

Unlock grades or items moodle/grade:unlock

View own grades moodle/grade:view

Manage notes moodle/notes:manage

View notes moodle/notes:view

Add new questions moodle/question:add

Edit all questions moodle/question:editall

Edit your own questions moodle/question:editmine

Edit question categories moodle/question:managecategory

Move all questions moodle/question:moveall

Move your own questions moodle/question:movemine

Use all questions moodle/question:useall

Use your own questions moodle/question:usemine

View all questions moodle/question:viewall

View your own questions moodle/question:viewmine

Override safe permissions for others moodle/role:safeoverride

Switch to other roles moodle/role:switchroles

Unassign own roles moodle/role:unassignself

View hidden role assignments moodle/role:viewhiddenassigns

Access all groups moodle/site:accessallgroups

Always see full names of users moodle/site:viewfullnames

View user profiles moodle/user:viewdetails

'''Assignment'''

Grade assignment mod/assignment:grade

Submit assignment mod/assignment:submit

View assignment mod/assignment:view

'''Chat'''

Talk in a chat mod/chat:chat

Delete chat logs mod/chat:deletelog

Read chat logs mod/chat:readlog

'''Choice'''

Record a choice mod/choice:choose

Delete responses mod/choice:deleteresponses

Download responses mod/choice:downloadresponses

Read responses mod/choice:readresponses

'''Database'''

Approve unapproved entries mod/data:approve

Write comments mod/data:comment

Manage comments mod/data:managecomments

Manage entries mod/data:manageentries

Rate entries mod/data:rate

View presets from all users mod/data:viewalluserpresets

View entries mod/data:viewentry

View ratings mod/data:viewrating

Write entries mod/data:writeentry

'''Forum'''

Add news mod/forum:addnews

Create attachments mod/forum:createattachment

Delete any posts (anytime) mod/forum:deleteanypost

Delete own posts (within deadline) mod/forum:deleteownpost

Edit any post mod/forum:editanypost

Initial subscription mod/forum:initialsubscriptions

Manage subscriptions mod/forum:managesubscriptions

Move discussions mod/forum:movediscussions

Rate posts mod/forum:rate

Reply to news mod/forum:replynews

Reply to posts mod/forum:replypost

Split discussions mod/forum:splitdiscussions

Start new discussions mod/forum:startdiscussion

Throttling applies mod/forum:throttlingapplies

View any ratings mod/forum:viewanyrating

View discussions mod/forum:viewdiscussion

View hidden timed posts mod/forum:viewhiddentimedposts

Always see Q and A posts mod/forum:viewqandawithoutposting

View ratings mod/forum:viewrating

View subscribers mod/forum:viewsubscribers

'''Glossary'''

Approve unapproved entries mod/glossary:approve

Create comments mod/glossary:comment

Export entries mod/glossary:export

Import entries mod/glossary:import

Manage categories mod/glossary:managecategories

Manage comments mod/glossary:managecomments

Manage entries mod/glossary:manageentries

Rate entries mod/glossary:rate

View ratings mod/glossary:viewrating

Create new entries mod/glossary:write

'''Hot Potatoes Quiz'''

Attempt a quiz mod/hotpot:attempt

Delete quiz attempts mod/hotpot:deleteattempt

modify grades mod/hotpot:grade

View reports mod/hotpot:viewreport

'''LAMS'''

Manage LAMS activities mod/lams:manage

Participate in LAMS activities mod/lams:participate

'''Lesson'''

Manage a lesson activity mod/lesson:manage

'''Quiz'''

Attempt quizzes mod/quiz:attempt

Delete quiz attempts mod/quiz:deleteattempts

Get email confirmation when submitting mod/quiz:emailconfirmsubmission

Get email notification of submissions mod/quiz:emailnotifysubmission

Grade quizzes manually mod/quiz:grade

Ignores time limit on quizzes mod/quiz:ignoretimelimits

Manage quizzes mod/quiz:manage

Preview quizzes mod/quiz:preview

View quiz information mod/quiz:view

View quiz reports mod/quiz:viewreports

'''SCORM/AICC'''

Save tracks mod/scorm:savetrack

Skip overview mod/scorm:skipview

View reports mod/scorm:viewreport

View scores mod/scorm:viewscores

'''Survey'''

Download responses mod/survey:download

Respond to survey mod/survey:participate

View responses mod/survey:readresponses

'''Wiki'''

Manage wiki settings mod/wiki:manage

Override locked pages mod/wiki:overridelock

Edit wiki pages mod/wiki:participate

'''Workshop'''

Manage settings mod/workshop:manage

Participate in workshop mod/workshop:participate

'''RSS Client'''

Create private RSS feedsblock/rss_client:createprivatefeeds

Create shared RSS feedsblock/rss_client:createsharedfeeds

Manage any RSS feedsblock/rss_client:manageanyfeeds

Manage own RSS feedsblock/rss_client:manageownfeeds

'''Block'''

View block moodle/block:view

==See also==

*[[Override permissions]]
*[[Allow role overrides]]

Capabilities/moodle/role:safeoverride

2008-08-16T14:39:32Z

Ray: /* See also */

Capabilities/moodle/role:safeoverride

2008-08-16T14:38:42Z

Ray: /* See also */

{{Moodle 1.9}}* This allows a user to override capabilities that do not have major [[Risks|risks]] attached to them. Higher risk capabilities are locked (greyed out) on the [[Override permissions|override permissions]] page.[[Image:Safe override permissions.png|thumb|Overriding permissions with higher risk capabilities locked]]
* This capability is included in Moodle 1.9.3 onwards. It is not set for any of the default roles.

==See also==

*[[Override permissions]]
*[[Allow role overrides]]
*The capability [[Capabilities/moodle/role:override|moodle/role:override]]

[[Category:Capabilities|Role]]
[[Category:Roles]]

[[[Capabilities classified as "safe"]]]
'''Gradebook'''
Import grades from CSV gradeimport/csv:view

Publish import grades from XML gradeimport/xml:publish

Import grades from XML gradeimport/xml:view

'''Course'''

Edit and manage entriesmoodle/blog:manageentries

View blog entriesmoodle/blog:view

Manage any calendar entriesmoodle/calendar:manageentries

Manage group calendar entriesmoodle/calendar:managegroupentries

Manage own calendar entriesmoodle/calendar:manageownentries

Hide/show activitiesmoodle/course:activityvisibility

Send a message to many peoplemoodle/course:bulkmessaging

Manage groupsmoodle/course:managegroups

Manage scalesmoodle/course:managescales

Control section visibilitymoodle/course:sectionvisibility

Set current sectionmoodle/course:setcurrentsection

Enable/disable email addressmoodle/course:useremail

View coursesmoodle/course:view

View hidden activitiesmoodle/course:viewhiddenactivities

View hidden coursesmoodle/course:viewhiddencourses

View hidden sectionsmoodle/course:viewhiddensections

View participantsmoodle/course:viewparticipants

View scalesmoodle/course:viewscales

Hide/show coursesmoodle/course:visibility

Lock grades or itemsmoodle/grade:lock

Manage letter gradesmoodle/grade:manageletters

Manage grade outcomesmoodle/grade:manageoutcomes

Unlock grades or itemsmoodle/grade:unlock

View own gradesmoodle/grade:view

Manage notesmoodle/notes:manage

View notesmoodle/notes:view

Add new questionsmoodle/question:add

Edit all questionsmoodle/question:editall

Edit your own questionsmoodle/question:editmine

Edit question categoriesmoodle/question:managecategory

Move all questionsmoodle/question:moveall

Move your own questionsmoodle/question:movemine

Use all questionsmoodle/question:useall

Use your own questionsmoodle/question:usemine

View all questionsmoodle/question:viewall

View your own questionsmoodle/question:viewmine

Override safe permissions for othersmoodle/role:safeoverride

Switch to other rolesmoodle/role:switchroles

Unassign own rolesmoodle/role:unassignself

View hidden role assignmentsmoodle/role:viewhiddenassigns

Access all groupsmoodle/site:accessallgroups

Always see full names of usersmoodle/site:viewfullnames

View user profilesmoodle/user:viewdetails

'''Assignment'''

Grade assignmentmod/assignment:grade

Submit assignmentmod/assignment:submit

View assignmentmod/assignment:view

'''Chat'''

Talk in a chatmod/chat:chat

Delete chat logsmod/chat:deletelog

Read chat logsmod/chat:readlog

'''Choice'''

Record a choicemod/choice:choose

Delete responsesmod/choice:deleteresponses

Download responsesmod/choice:downloadresponses

Read responsesmod/choice:readresponses

'''Database'''

Approve unapproved entriesmod/data:approve

Write commentsmod/data:comment

Manage commentsmod/data:managecomments

Manage entriesmod/data:manageentries

Rate entriesmod/data:rate

View presets from all usersmod/data:viewalluserpresets

View entriesmod/data:viewentry

View ratingsmod/data:viewrating

Write entriesmod/data:writeentry

'''Forum'''

Add newsmod/forum:addnews

Create attachmentsmod/forum:createattachment

Delete any posts (anytime)mod/forum:deleteanypost

Delete own posts (within deadline)mod/forum:deleteownpost

Edit any postmod/forum:editanypost

Initial subscriptionmod/forum:initialsubscriptions

Manage subscriptionsmod/forum:managesubscriptions

Move discussionsmod/forum:movediscussions

Rate postsmod/forum:rate

Reply to newsmod/forum:replynews

Reply to postsmod/forum:replypost

Split discussionsmod/forum:splitdiscussions

Start new discussionsmod/forum:startdiscussion

Throttling appliesmod/forum:throttlingapplies

View any ratingsmod/forum:viewanyrating

View discussionsmod/forum:viewdiscussion

View hidden timed postsmod/forum:viewhiddentimedposts

Always see Q and A postsmod/forum:viewqandawithoutposting

View ratingsmod/forum:viewrating

View subscribersmod/forum:viewsubscribers

'''Glossary'''

Approve unapproved entriesmod/glossary:approve

Create commentsmod/glossary:comment

Export entriesmod/glossary:export

Import entriesmod/glossary:import

Manage categoriesmod/glossary:managecategories

Manage commentsmod/glossary:managecomments

Manage entriesmod/glossary:manageentries

Rate entriesmod/glossary:rate

View ratingsmod/glossary:viewrating

Create new entriesmod/glossary:write

'''Hot Potatoes Quiz'''

Attempt a quizmod/hotpot:attempt

Delete quiz attemptsmod/hotpot:deleteattempt

Modify gradesmod/hotpot:grade

View reportsmod/hotpot:viewreport

'''LAMS'''

Manage LAMS activitiesmod/lams:manage

Participate in LAMS activitiesmod/lams:participate

'''Lesson'''

Manage a lesson activitymod/lesson:manage

'''Quiz'''

Attempt quizzesmod/quiz:attempt

Delete quiz attemptsmod/quiz:deleteattempts

Get email confirmation when submittingmod/quiz:emailconfirmsubmission

Get email notification of submissionsmod/quiz:emailnotifysubmission

Grade quizzes manuallymod/quiz:grade

Ignores time limit on quizzesmod/quiz:ignoretimelimits

Manage quizzesmod/quiz:manage

Preview quizzesmod/quiz:preview

View quiz informationmod/quiz:view

View quiz reportsmod/quiz:viewreports

'''SCORM/AICC'''

Save tracksmod/scorm:savetrack

Skip overviewmod/scorm:skipview

View reportsmod/scorm:viewreport

View scoresmod/scorm:viewscores

'''Survey'''

Download responsesmod/survey:download

Respond to surveymod/survey:participate

View responsesmod/survey:readresponses

'''Wiki'''

Manage wiki settingsmod/wiki:manage

Override locked pagesmod/wiki:overridelock

Edit wiki pagesmod/wiki:participate

'''Workshop'''

Manage settingsmod/workshop:manage

Participate in workshopmod/workshop:participate

'''RSS Client'''

Create private RSS feedsblock/rss_client:createprivatefeeds

Create shared RSS feedsblock/rss_client:createsharedfeeds

Manage any RSS feedsblock/rss_client:manageanyfeeds

Manage own RSS feedsblock/rss_client:manageownfeeds

'''Block'''

View blockmoodle/block:view

Page content

2008-06-17T07:48:38Z

Ray: /* Anchor */

[[Image:Course_Lesson_Page_Content2.gif|frame|left|Ver 1.5.3]]
<br><br><br><br><br>
The page content is the typical place a student sees in a lesson to receive information-content.

Moodle is very robust when it comes to placing content before a student. It has both an HTML source code and a friendly WYSIWYG interface with standard icons for different editing functions.
<br><br>
== Tool Bar ==

[[Image:Course Lesson Page Content Toolbar.GIF|frame|left|Toolbar in Ver 1.5 to 1.8]]

<br><br><br><br><br><br> The toolbar should be familiar to users of word processors. The toolbar creates HTML code for the user. It is possible to see or reveal the code on the page with the icon that looks like <>. [[HTML_editor|More help with HTML can be found here]].

=== Text Editing ===
<nowiki>
Brief review of text editing features
Fonts, Centering, etc
Special Characters
Colors
Paragraph
Clean Word HTML
</nowiki>

=== Image Insertion ===
[[Image:Ed_image.gif]] The Image Icon will assist you in creating HTML code. The Image Icon on the tool bar brings up this popup window. We should mention here that JPG, GIF and PNG files are recognized Moodle images file types.

[[Image:Course Lesson Page Content InsertImage Popup1.GIF|frame|right|Version 1.5.3]] These folders and files can also be found in the administration block under [[Files|files]].
#The basic steps are to locate the file
##Using the File Browser Window for previously uploaded files, OR
##Upload a file
###Locate and click on the location the file will go to in the File Browser Window
###Use Browse button to locate file (local machine)
###Use Update button to place file in File Browser Window,
#click on file in File Browser Window to place file in "Insert URL"
#Enter Alternative Text
#Optional Use Layout, spacing and size parameters
*Best practice is to put all of a single activities images in a folder such as "Lesson Example"
**It is possible to zip a local folder with images and upload it to a course lesson. See files [[Files|Click here for more information on files]].
**Remember to use the Refresh feature on your browser if the image does not appear to change in the Moodle Lesson.

When you browse for a local course image file its URL will be inserted like:

<nowiki> http://www.yourMoodle.net/moodle/file.php/5/courseFolder2/pic1.jpg</nowiki>
where /5/ is the numerical ID of your course. This will work fine IF nothing is changed. But '''if you change your domain name, your moodle folder name, the image link won't work. If you backup and restore the course as a new copy or on another server, the link won't work.'''

If you shorten the URL to:
# /moodle/file.php/5/courseFolder2/pic1.jpg it will work even if your domain is changed, but not if restored as new course.
# '''courseFolder2/pic1.jpg''' it will work even if your course file is backuped and restored as a new course, even on another server.

'''Site file folder linking''': (on Moodle 1.8.2 at least)
The URL to files there always contain /1/ like http://www.yourMoodle.net/moodle/file.php/1/siteFolder2/test.jpg
Anyone with the URL can access files there. Files in course file folders are only accessable by people logged in an belonging to the course.

A link like: /moodle/file.php/1/siteFolder2/test.jpg will work, and should even work if the site is mirrored on another server (AND the moodle folder name is not changed).

Links that '''don't work''' are
../1/siteFolder2/test.jpg and
/file.php/1/siteFolder2/test.jpg

===Multimedia insertion===
Linking a URLs to text is one way to point to multimedia resources and the appropriate multimedia player installed as a [[Multimedia plugin]]. Please refer to the specific type of media in MoodleDos for more detailed information about linking.

===Embed a Flash (captivate) File in a Lesson===

It is possible to embed your captivate simulations in the lesson page.

Go to your file space and copy the url of your swf file onto your clipboard. Go back to your lesson page and add the following to the code-view editor.

<iframe src="''paste_url_here''" frameborder="0" scrolling="0" width="400" height="550"></iframe>

That should do it.

=== Links & Anchors ===
====The Link (chain icon)====
[[Image:Ed link.gif|frame|left|]]

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

There are three fields when the Link icon is used.
[[Image:HTML Link Insert1.JPG]]
##URL the web based address. Note a course file has a URL address via the browse button
##Title - what appears when the mouse rolls over the link
##Target - What kind of window should be called up.
##Anchors - A pull down list allows you to select an anchor.

====Anchor ====
[[Image:Ed anchor.gif|frame|left|]]

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

=== Tables ===
Add, edit, adjust

== Path ==
What is that line at the bottom of Page Content show?

== Content examples ==
Description of question or branch page contents
===Creative examples===

*Add an icon to a title bar, such as a course or site catagory
**Insert the image into the brief description, toggle HTML source code, copy the code for the image and paste it in the title bar.
**It is possible to adjust the size via the width and height parameters, the alternative text and title parameters in the code are not needed.
**Example of code
<nowiki><img width="25" vspace="0" hspace="0" height="25" border="0" src="http://demo.moodle.org/file.php/4/f1.jpg"</nowiki> <br>
inserted before text in course title gives this
[[Image:HTML Link Insert title example1.JPG|thumb|center|Example Course Title Bar with icon]]

== See Also ==
*[[Flash]] inserting them in content of questions or branch pages
*[http://moodle.org/help.php?file=index.html Index of Help Files] - Scroll down to "Reading and Writing"

*[[Files]] - Uploading, creating, moving, deleting course files and folders
[[Category:Lesson]]

Filters

2008-05-25T03:05:50Z

Ray: /* Standard filters */

Location: ''Administration > Modules > Manage filters''

Filters allow for the automatic transformation of entered text into different, often more complex forms. For example the titles of [[Resources|resources]] can automatically become hyperlinks that take you to the relevant resource, URLs pointing to [[mp3]] files can become [[Flash]] controls embedded in the web page that let you pause and rewind the audio. The possibilities are endless and there are a number of standard filters included with Moodle and many more specialized filters available from the Moodle.org [http://moodle.org/mod/data/view.php?id=6009 Modules and plugins database].

==Enabling filters==
[[Image:filters admin.png|thumb|Filters administration in Moodle 1.8]]
To enable a filter:
#Access Administration > Modules > Filters.
#On the filters administration page, click the eye icon opposite the filter you want to enable, so that it changes to an open eye.
#Use the up/down arrow icons to arrange the filters in the order in which they should be applied.

Certain filters have additional settings, which can be accessed via the links in the settings column.

==Common settings==

Note: Prior to Moodle 1.9, common filter settings can be found in ''Administration > Appearance > Filter settings''.

===Text cache lifetime===

Text filters can take a lot of processor power to analyze. If you have a large number of courses, the filters may slow your system. The text cache lifetime determines how often the filters run. If you set them to run too frequently, your system may
slow down. If you set them to run too infrequently, analyzing new content will take too long and users will notice. You should experiment to find the correct amount of time for your server.

===Filter uploaded files===

This setting enables uploaded files (HTML and text only) to be processed by the filters system. You can choose to have none, only HTML or all files filtered.

===Filter match once per page===

This setting effects the glossary, activity and resource linking filters. If set to yes, only the first match on the complete page will be converted to a link. All others will be ignored.

===Filter match once per text===

This setting effects the glossary, activity and resource linking filters. If set to yes, only the first match in a discrete block of text will be converted to a link. All others in that text block will be ignored.

===Filter all strings===

If checked, headings and titles can be displayed in different languages using the [[Multi language content|multi-language filter]].

==Standard filters==

Filters included in the standard download are:

*Activity Names Auto-linking - This scans text for activity titles that exist in the same course and creates a link.
*[[Algebra filter|Algebra]] - This filter will convert algebra code into GIF images. It requires the tex filter to be installed ([[#TeX notation|see below]]). Note also that your system must also include the following Perl module: HTML::Entities.pm
*Database auto-linking - As the name suggests, this filter enables automatic linking of [[Database module]] entries.
*Email Protection - This filter scans the text for any email addresses. Where found they are changed (obfuscated) to reduce the chance of being added to a spammers list. However, as this filter is switched off by default, the site administrator may wish to enable this filter before importing user's email addresses.
*Glossary auto-linking - As the name suggests, this filter enables automatic linking of [[Glossary module]] entries. In addition to this filter, individual glossary entries should have the "This entry should be automatically linked" box checked.
*[[Multi language content]] - This filter enables resources to be created in multiple languages. It looks for <span lang="xx" class="multilang">...</span> tags which indicate that a text contains multiple languages. Then it selects and outputs the best language for the current user. The language of the resource will change when the user changes their selected Moodle language. Please note: going to the past, the multilang filter supported the <lang> tag. Then, officially, we changed it to the standard HTML <span> tag and the <lang> solution is now deprecated.
*[[Multimedia plugins]]
*Resource Names Auto-linking - The titles of [[Resources]] can automatically become hyperlinks that take you to the relevant resource within the same course.
*[[TeX filter|TeX notation]]
*Tidy - This filter checks whether HTML code is XHTML compliant, tidying where necessary. To make this filter work you need to have PHP compiled with the libtidy option; see http://www.php.net/tidy. The Using Moodle discussion [http://moodle.org/mod/forum/discuss.php?d=28418 Tidy Filter for Moodle 1.5] contains more details.
*Wiki Page Auto-linking
*[[Word censorship]] - This filter "blacks out" words found on a list.

==Non-standard filters==

Filters are one of Moodle's pluggable resources and may be added or removed simply by using a file manager to add or remove them from the ''/filters'' directory. Moodle detects those that are present and makes them available to use.

* [[Jmol filter|Jmol]] - for interactive 3D viewing of molecular structures
* [[Code Syntax Highlighting]] - for more readable excerpts of programming languages including [[PHP]], [[HTML]], [[CSS]], and XML amongst many others
* [[HiddenText filter|HiddenText]] - for teachers who want to provide "hints" to students where the information is initially hidden but can easily be revealed by student in any time when he need.

==See also==

*[[Filters used on the Moodle.org forums]]
*[[Development:Filters]]
*[http://youtube.com/watch?v=rL1FVNewG7I Video demonstrating the set-up and use of filters in Moodle]
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=76206 Filter Demo's now online] forum discussion

[[Category:Filter]]

[[es:Filtros (Administrador)]]
[[fr:Filtres (administrateur)]]
[[ja:フィルタ (管理者)]]

Moodle manuals

2008-05-17T16:48:32Z

Ray: /* Administration manuals */

__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/docs/moodle_1.4.3_for_teachers_and_trainers.pdf Moodle 1.4.3 For Teachers and Trainers] - by '''Bryan Williams''' (PDF, 2.4MB)
*[http://moodle.org/other/Using-Your-Moodle.pdf Using Your Moodle (1.4.3)] by [https://docs.moodle.org/en/User:Darren_Smith Darren Smith] (PDF, 2MB, Published Jan 2005)
*[http://download.moodle.org/docs/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/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 and 1.8.3] (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

===Other Languages===
*[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/docs/teacher-manual-1.5-nl.pdf Moodle 1.5 Teacher Manual (Dutch)] - (PDF, 3MB)
*[http://download.moodle.org/docs/teacher-manual-it.pdf Moodle 1.3 Teacher Manual (Italian)] - (PDF, 3.1MB)
*[http://download.moodle.org/docs/teacher-manual-fr.pdf Moodle 1.3 Teacher Manual (French)] - (PDF, 5MB)
*[http://download.moodle.org/docs/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/docs/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 and 1.8.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]]

Moodle manuals

2008-05-17T16:46:38Z

Ray: /* 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/docs/moodle_1.4.3_for_teachers_and_trainers.pdf Moodle 1.4.3 For Teachers and Trainers] - by '''Bryan Williams''' (PDF, 2.4MB)
*[http://moodle.org/other/Using-Your-Moodle.pdf Using Your Moodle (1.4.3)] by [https://docs.moodle.org/en/User:Darren_Smith Darren Smith] (PDF, 2MB, Published Jan 2005)
*[http://download.moodle.org/docs/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/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 and 1.8.3] (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

===Other Languages===
*[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/docs/teacher-manual-1.5-nl.pdf Moodle 1.5 Teacher Manual (Dutch)] - (PDF, 3MB)
*[http://download.moodle.org/docs/teacher-manual-it.pdf Moodle 1.3 Teacher Manual (Italian)] - (PDF, 3.1MB)
*[http://download.moodle.org/docs/teacher-manual-fr.pdf Moodle 1.3 Teacher Manual (French)] - (PDF, 5MB)
*[http://download.moodle.org/docs/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.lulu.com/content/1893731 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/docs/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 and 1.8.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]]

Moodle manuals

2008-05-16T15:59:00Z

Ray: /* 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://www.lulu.com/content/1930255 Course Creator Reference Manual 1.8] - by '''Ray Lawrence''' Print 191 pages £15
*[http://www.lulu.com/content/1893731 Administrator Reference Manual 1.8] - by '''Ray Lawrence''' Print 69 pages £12
*[http://download.moodle.org/docs/moodle_1.4.3_for_teachers_and_trainers.pdf Moodle 1.4.3 For Teachers and Trainers] - by '''Bryan Williams''' (PDF, 2.4MB)
*[http://moodle.org/other/Using-Your-Moodle.pdf Using Your Moodle (1.4.3)] by [https://docs.moodle.org/en/User:Darren_Smith Darren Smith] (PDF, 2MB, Published Jan 2005)
*[http://download.moodle.org/docs/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/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 and 1.8.3] (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

===Other Languages===
*[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/docs/teacher-manual-1.5-nl.pdf Moodle 1.5 Teacher Manual (Dutch)] - (PDF, 3MB)
*[http://download.moodle.org/docs/teacher-manual-it.pdf Moodle 1.3 Teacher Manual (Italian)] - (PDF, 3.1MB)
*[http://download.moodle.org/docs/teacher-manual-fr.pdf Moodle 1.3 Teacher Manual (French)] - (PDF, 5MB)
*[http://download.moodle.org/docs/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.lulu.com/content/1893731 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/docs/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 and 1.8.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]]

Moodle manuals

2008-05-16T15:56:32Z

Ray: /* Administration manuals */

__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://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://download.moodle.org/docs/moodle_1.4.3_for_teachers_and_trainers.pdf Moodle 1.4.3 For Teachers and Trainers] - by '''Bryan Williams''' (PDF, 2.4MB)
*[http://moodle.org/other/Using-Your-Moodle.pdf Using Your Moodle (1.4.3)] by [https://docs.moodle.org/en/User:Darren_Smith Darren Smith] (PDF, 2MB, Published Jan 2005)
*[http://download.moodle.org/docs/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/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 and 1.8.3] (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

===Other Languages===
*[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/docs/teacher-manual-1.5-nl.pdf Moodle 1.5 Teacher Manual (Dutch)] - (PDF, 3MB)
*[http://download.moodle.org/docs/teacher-manual-it.pdf Moodle 1.3 Teacher Manual (Italian)] - (PDF, 3.1MB)
*[http://download.moodle.org/docs/teacher-manual-fr.pdf Moodle 1.3 Teacher Manual (French)] - (PDF, 5MB)
*[http://download.moodle.org/docs/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.lulu.com/content/1893731 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/docs/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 and 1.8.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]]

Development:Conditional activities

2008-05-15T15:24:23Z

Ray: /* This activity will be available when ... */

This is a developer's page for Moodle Version 2.0, describing an evolving specification. UNDER CONSTRUCTION!

Conditional activities allow the course editor to hide certain activities until conditions on other activities have been met.

For example, a student will not see Assignment B until they have scored 80% or higher on Quiz A.

==Objectives==

# We want to know when activities are finished (for each user independently)
# We want to have this calculated automatically, but also manually if required.
# We want other some activities to be hidden until other activities are done.
# We want to "chain" these things into learning paths.
# We want the course page to remain fast.
# We want conditional activities to be optional.

[[User:sam marshall|sam marshall]] For us and no doubt other places, the 'activity completion' part of the system is still useful even if we are not using conditional activities for a course. We would then want a reporting interface so that tutors can see which tracked activities their students have/haven't completed. (And for course staff, obviously they would be able to see all students on the course in the same manner.)

==Overview==

There are two main approaches to this. For the discussion below let's use A to mean a source activity, and B and C to mean two activities that are only available when A is done.

Approach 1: The one used by activity locking is to place the UI to choose the conditions in B, so that it specifies the passing grades etc that are needed for A so that B is unlocked. This has advantages in that B can specify a different passing grade that C (both on the same A).

Approach 2: This places the logic in A, so that it defines when it is "done" any way it likes and B can just say "I'm available when A is done". The advantages here are that A can define "done" in any way it likes, and the configuration can be more subtle if the module wants it.

The approach described below actually combines BOTH these approaches so it should please everyone and allow the maximum flexibility.

==Interfaces==

===Site settings===

Admins can turn Conditional Activities on/off for the whole site.

===Course settings===

Teachers can choose between three states for a course:
# Conditional Activities off
# Conditional Activities Manual
# Conditional Activities Auto

===Course page===

For teachers
* Each activity will have an icon indicating the status, and clicking on it takes you to the activity settings (see below). These are also available as a tab from the main activity pages.

For students
* Colour icons (checkboxes) in red/orange/green down the side of the course format indicate the status of each activity
* In manual mode, these can be clicked on to toggle the status as required (so that students can manually keep track of what they've done).
* In auto mode, these icons are fixed

[[User:sam marshall|sam marshall]] Be very careful with colours. You mustn't use colour as only way of displaying information (accessibility). I'd suggest something like: For manual mode, use straightforward checkbox as above; For auto mode, use an icon as described but make these look different as well as different colour (I'd suggest grey crosshatching for unavailable, white (hollow w/black outline) for available but not done, green tick inside box for done-pass, red cross inside box for done-fail) and of course include alt text

[[User:sam marshall|sam marshall]] 'Manual' and 'Auto' modes maybe needs rethinking. I think this should be actually be a choice of 'disable system' (why? well, anyway), 'enable system', and 'enable system plus student progress'. These are equiv to off, auto, and auto+manual. The reason for this is that if you specify conditions for something you always want it to be 'auto' obviously. But, anything you didn't specify conditions for, it could be 'manual' (i.e. you want students to track progress on some things that are not trackable automatically, e.g. 'go and read this web link' (a link) or 'go and read the book we sent you' (a label)

[[User:sam marshall|sam marshall]] If this approach is adopted (or anyway for standard manual), it needs a way to turn off progress support per-activity, this could be in course_modules or whatever. For example you don't want to include a 'progress' box on something like a generic course forum that is available for the life of the course, or a course resources page that's similar, or a page about how to contact student support. We do this because in editing mode, our checkboxes include a tiny little eye icon next to them so you can hide them where they aren't needed. Maybe also appropriate to set defaults i.e. labels default to not having progress.

[[User:sam marshall|sam marshall]] At the OU we use an option that controls who sees the checkbox. Remember course:participate? YES IT'S THAT AGAIN. Not that it is really really desperately needed or anything. Ahem. But anyhow, we have a specific permission for who the progress system applies to, and this is checked with doanything=false. You might need something similar.

===Activity settings===

When the teacher is editing the activity settings for each activity, they see two parts to the page:

====This activity will be available when ...====

The UI here is standard for all modules. (Settings are stored in the '''course_modules_avail''' table.) It shows all the other activities in the course, and beside each of them are menus to choose from:
* Grade >= X (<, <=, >= and >)
* Viewed
* Completed (as defined by that activity)

[[User:sam marshall|sam marshall]] Should also include date as a condition. Would be stored in course_modules_avail
[[User:ray| Ray Lawrence]] Absolute dates or relative to the course start date?

[[User:sam marshall|sam marshall]] Maybe consider also an option for whether the activity is visible before it is available, greyed out with a 'This activity will be available when...' note, or not displayed at all.

====This activity will be completed when ...====

This UI shows optional settings for this activity to define when it thinks it is finished. (Settings are stored in '''course_modules_done''' table):
* Grade >= X (<, <=, >= and >)
* Viewed
* Something else (interface defined by module)

==Tables==

===course_modules_completion===
This table records the status of each user completing each activity module. It represents current state and is used to make the display of course pages very fast. It is updated whenever grades or modules change etc. See also [[Development:Course_completion]] for course completion which is a separate system.

* id
* courseid - just here for speed
* cmid - FK to course_modules
* userid
* status - hide / not done / in progress / done fail / done pass
* timemodified

===course_modules_avail===
Records settings for availability
* id
* cmid - the activity that is defining the condition
* cmsourceid - the activity we are checking
* gradesign - <, >, <=, => etc
* gradecutoff
* views - boolean
* modulespecific - boolean

[[User:sam marshall|sam marshall]] I think modulespecific is difficult to handle here because it probably needs to be set per module (i.e. typically in the module settings page and stored in the module's main table). Suggest moving to the _done table.

[[User:sam marshall|sam marshall]] Eloy suggested we should only store conditions in one place (as opposed to the A/B above) but I see the possible need for several e.g. a quiz, you want one activity that shows if you get > 80% and another one that shows only if you get <80%. However I think this could still be simplified - how about putting the 'grade' stuff ONLY in this 'avail' table (so your choice for avail is basically always 'require the activity to think it's done, however it likes' but then you can additionally require a grade as well). So done = completed regardless of grade or anything else, but avail could be conditional on grade.

===course_modules_done===
Records settings for whether something is done
* id
* cmid
* gradesign - <, >, <=, => etc
* gradecutoff
* views - boolean

==Process==

Coming soon

==Issues to think about==

* How do we cope with circular references?
* We should remove conditions when activities are deleted - how does that affect things downstream?

==sam's picture==

This diagram shows sam's idea of how it should look/work, which is not quite the same as the original description above. It definitely isn't intended to be final in any way as features might need to be removed (or added or changed) etc. - I just did a diagram to illustrate my thinking.

[[Image:conditional.png|Possible interface diagram]]

==See also==
*Take a look at the [http://moodle.org/mod/forum/view.php?f=678 Conditional activities forum] at [http://moodle.org http://moodle.org].
*[[Activity_Locking]], a MoodleDoc page with table and descriptions of different conditional activity modules
*[[Score Lock]] a MoodleDoc page for another conditional activity module for 1.6
*[http://moodle.org/mod/forum/discuss.php?d=35488 forum discussion about Stuart Mayor's Conditional Activities], including Moodle 1.6 version
*[http://moodle.org/mod/forum/discuss.php?d=36697 Conditional activities at CICEI], running demo included as student, teacher and designer.
*[[Adding/editing_a_lesson#Dependent_on]] MoodleDoc page . The lesson activity settings in V 1.6 has a specialized dependency setting. Entering the lesson can be made dependent on the % (lesson questions) correct, time spent or completion of one other specific lesson.

*Tracker reference(s) for conditional development _____________

[[Category:Developer|Conditional activities]]

File:Admin18single.jpg

2008-05-01T12:58:47Z

Ray:

File:Cc18single.jpg

2008-05-01T12:58:10Z

Ray:

Moodle manuals

2008-04-26T18:19:15Z

Ray: /* Administration manuals */

__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://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://download.moodle.org/docs/moodle_1.4.3_for_teachers_and_trainers.pdf Moodle 1.4.3 For Teachers and Trainers] - by '''Bryan Williams''' (PDF, 2.4MB)
*[http://moodle.org/other/Using-Your-Moodle.pdf Using Your Moodle (1.4.3)] by [https://docs.moodle.org/en/User:Darren_Smith Darren Smith] (PDF, 2MB, Published Jan 2005)
*[http://download.moodle.org/docs/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/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 and 1.8.3] (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

===Other Languages===
*[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/docs/teacher-manual-1.5-nl.pdf Moodle 1.5 Teacher Manual (Dutch)] - (PDF, 3MB)
*[http://download.moodle.org/docs/teacher-manual-it.pdf Moodle 1.3 Teacher Manual (Italian)] - (PDF, 3.1MB)
*[http://download.moodle.org/docs/teacher-manual-fr.pdf Moodle 1.3 Teacher Manual (French)] - (PDF, 5MB)
*[http://download.moodle.org/docs/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/docs/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 and 1.8.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]]

Moodle manuals

2008-04-26T18:18:54Z

Ray: /* 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://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://download.moodle.org/docs/moodle_1.4.3_for_teachers_and_trainers.pdf Moodle 1.4.3 For Teachers and Trainers] - by '''Bryan Williams''' (PDF, 2.4MB)
*[http://moodle.org/other/Using-Your-Moodle.pdf Using Your Moodle (1.4.3)] by [https://docs.moodle.org/en/User:Darren_Smith Darren Smith] (PDF, 2MB, Published Jan 2005)
*[http://download.moodle.org/docs/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/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 and 1.8.3] (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

===Other Languages===
*[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/docs/teacher-manual-1.5-nl.pdf Moodle 1.5 Teacher Manual (Dutch)] - (PDF, 3MB)
*[http://download.moodle.org/docs/teacher-manual-it.pdf Moodle 1.3 Teacher Manual (Italian)] - (PDF, 3.1MB)
*[http://download.moodle.org/docs/teacher-manual-fr.pdf Moodle 1.3 Teacher Manual (French)] - (PDF, 5MB)
*[http://download.moodle.org/docs/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 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/docs/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 and 1.8.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]]

Moodle manuals

2008-04-26T13:18:10Z

Ray: /* Administration manuals */

__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://www.howtomoodle.com Course Creator Reference Manual 1.8] - by '''Ray Lawrence''' Print 191 pages £15
*[http://www.howtomoodle.com Administrator Reference Manual 1.8] - by '''Ray Lawrence''' Print 69 pages £12
*[http://download.moodle.org/docs/moodle_1.4.3_for_teachers_and_trainers.pdf Moodle 1.4.3 For Teachers and Trainers] - by '''Bryan Williams''' (PDF, 2.4MB)
*[http://moodle.org/other/Using-Your-Moodle.pdf Using Your Moodle (1.4.3)] by [https://docs.moodle.org/en/User:Darren_Smith Darren Smith] (PDF, 2MB, Published Jan 2005)
*[http://download.moodle.org/docs/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/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 and 1.8.3] (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

===Other Languages===
*[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/docs/teacher-manual-1.5-nl.pdf Moodle 1.5 Teacher Manual (Dutch)] - (PDF, 3MB)
*[http://download.moodle.org/docs/teacher-manual-it.pdf Moodle 1.3 Teacher Manual (Italian)] - (PDF, 3.1MB)
*[http://download.moodle.org/docs/teacher-manual-fr.pdf Moodle 1.3 Teacher Manual (French)] - (PDF, 5MB)
*[http://download.moodle.org/docs/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 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/docs/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 and 1.8.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]]

Moodle manuals

2008-04-26T13:17:39Z

Ray: /* Teacher manuals */

__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://www.howtomoodle.com Course Creator Reference Manual 1.8] - by '''Ray Lawrence''' Print 191 pages £15
*[http://www.howtomoodle.com Administrator Reference Manual 1.8] - by '''Ray Lawrence''' Print 69 pages £12
*[http://download.moodle.org/docs/moodle_1.4.3_for_teachers_and_trainers.pdf Moodle 1.4.3 For Teachers and Trainers] - by '''Bryan Williams''' (PDF, 2.4MB)
*[http://moodle.org/other/Using-Your-Moodle.pdf Using Your Moodle (1.4.3)] by [https://docs.moodle.org/en/User:Darren_Smith Darren Smith] (PDF, 2MB, Published Jan 2005)
*[http://download.moodle.org/docs/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/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 and 1.8.3] (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

===Other Languages===
*[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/docs/teacher-manual-1.5-nl.pdf Moodle 1.5 Teacher Manual (Dutch)] - (PDF, 3MB)
*[http://download.moodle.org/docs/teacher-manual-it.pdf Moodle 1.3 Teacher Manual (Italian)] - (PDF, 3.1MB)
*[http://download.moodle.org/docs/teacher-manual-fr.pdf Moodle 1.3 Teacher Manual (French)] - (PDF, 5MB)
*[http://download.moodle.org/docs/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/content/view/180/368/ 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/docs/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 and 1.8.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]]

Creating a custom theme

2008-04-06T10:31:08Z

Ray: /* Advanced theming */

A '''theme''' is what defines the way the Moodle engine displays all of your Moodle powered pages. Themes are easy to create and allow you to personalize Moodle for your class, school, or school district. Themes consist of a Cascading Style Sheet (CSS) file and a few images. The simplest way to create a custom theme for your school is to modify the CSS and images of an existing theme. This tutorial will walk you through creating a custom theme based on the default Moodle theme which comes with version 1.9 of Moodle. Note that some additional color schemes are already included, and one of those may already fit your needs; be sure to check.

==Requirements==
In order to edit your theme, you'll need to have all of the following:
*An installation of Moodle 1.9 or greater
*Access to the server where Moodle is hosted (talk to your network administrator)
*(If your access is over FTP or SSH) A transfer program, such as the free program [http://filezilla-project.org/ FileZilla]
*A text editor (Windows comes with one by default, but others like [http://notepad-plus.sourceforge.net/ Notepad++] or [http://barebones.com/products/textwrangler/ TextWrangler] (Mac) make editing much easier)

==Get your new Theme setup==

First, login to your Moodle server, and navigate to the "theme" directory inside the main Moodle directory. Copy the folder named "standard" to an appropriate name for your new theme (avoid spaces or capital letters, e.g. "schoolname"). This will appear as the name of your theme inside the Moodle configuration.

If you do not have direct access to the server (e.g. you are working from your own computer) use your file transfer program to download a copy of this folder to your desktop and rename it there.

==Start from scratch or use a parent theme?==

You can now start to alter the features of the theme you have just copied, or choose to set it to use another theme as the parent, in which case your theme will use the parent theme's styles as a base, plus any changes you make. This is better than copying the entire folder of that theme and changing it, as sometimes the developers will make changes to the original theme to keep up with new Moodle features. These changes will not be included if you take the whole folder and alter it, but using another theme as a parent means that that original theme will be unchanged and will be updated when you update the rest of Moodle, avoiding messy surprises.

Use code like this this in /theme/yourtheme/config.php

$THEME->sheets = array('user_styles');
$THEME->standardsheets = array('styles_layout');
$THEME->parent = 'custom_corners'; // put the name of the theme folder you want to use as parent here.
$THEME->parentsheets = array('user_styles');

you then lose all .css files except user_styles.css, which should be empty, where you start to add css as described below.

==Get your colors==
In order to configure your theme, you'll need to know what colors you want to use. You should make a note of which colors you want to use, a full list of universally supported colors is available at [http://www.w3schools.com/css/css_colornames.asp]. Keep in mind that CSS is an exact language - ''DarkGrey'' will work while ''Dark Grey'' will not.

Here's a diagram what you'll need to choose colors for:
[[Image:Basic_CSS_Property_Diagram.gif|frame|center|Diagram of the Moodle CSS properties.]]

Best practices for choosing a color scheme is to make your background a light color, your text a dark color, and your link colors something in-between the two. No two colors should ever be the same or a near match. You should also avoid high-contrast colors such as a red background with blue text, which can be incredibly hard to read.

==Style the new theme==
Now that you have copied the default theme, and chosen the colors for your new theme, it's time to start styling the new page. Open up the 'styles_color.css' file inside the folder you created in the first step inside your text editor. If you wish to use the editor built into Windows, you may access this program by visiting '''Start > All Programs > Accessories > Notepad'''.

The following will need to be updated inside of the opened file.

===The Regular Link color===
Near the top of the file you will see a line which says ''a:visited {''. On the next line you should find the text ''<nowiki>color:#0000FF;</nowiki>''. Erase everything after the colon, but before the semi-colon and replace it with the name of your new background color. The line should now appear as ''<nowiki>color:</nowiki>'''YourNewColor''';''

===The Hovered Link color===
Eight lines down from where you made your last change you will see a line which reads ''a:hover {''. You'll also see ''color:#FF0000;'' on the next line. Like in the last step, change everything after the colon and before the semi-colon to your new color.

===The Page Background color===
Scroll to where you see a line which says ''<nowiki>body {</nowiki>''. On the next line you should find the text ''<nowiki>background-color:#FAFAFA;</nowiki>''. Erase everything after the colon, but before the semi-colon and replace it with the name of your new background color. The line should now appear as ''<nowiki>background-color:</nowiki>'''YourNewColor''';''

Now look for the line which reads ''.sideblock .content {'' about 1/3 of the way down the page. Two lines below it is a line which reads ''background-color:#FCFCFC;''. Change everything after the colon and before the semi-colon to the same background color. If you want the sidebar boxes to stand out more, you may wish to change this color to something of the same color, but lighter.

===The Text color===
On the line below where you changed your last value you will find the regular font color. As with the previous step, replace the ''#000'' with your new color. The line should now read ''<nowiki>color:</nowiki>'''YourNewColor''';''

Remember that while it may be appealing to you to use one of your school colors as the text color, it will probably make it hard for students to read. If you're going to change this from the default black you should chose a very dark shade to replace it with.

At this point you should save this file and close it.

==Advanced theming==

The hardest part is knowing what CSS to change in order to alter the appearance of a particular element.

Install [http://www.mozilla-europe.org/en/products/firefox/ Firefox], with the [https://addons.mozilla.org/en-US/firefox/addon/60 web developer extension]. You can now press Shift + CTRL-Y and click something on the page to see what CSS rules apply to it. By putting the same rules into you user_styles.css file with new values, you can change the appearance of that element. CTRL-F will give you information about an elements other properties like ancestors and children.

==Adding a Logo==
To add a logo to your page, you'll need to get your current logo in a GIF format with a height of no larger than 100 px. If someone from your organization is able to provide this, skip the next section. If not, the following will help you to resize your logo.

===Resizing Your Logo===
Your logo needs to be in a GIF format with a height of no more than 100 pixels. The simplest way to create this file is to use the web service located at [http://www.picresize.com]. Upload your original logo using the upload field and choose Continue. Scroll to Step 2. In the field labelled ''Height (Optional)'' input '''100''' and chose ''Pixels'' from the drop-down box to the right of it. Scroll to the bottom of the page and change the select box labelled ''Save As'' to read ''GIF''. Choose ''Resize Pic!''. Save the result to your hard drive.

===Copying the Logo===
Copy the 100px logo into the "pix" folder inside your theme folder. Rename it to ''logo.gif''.

===Adding the Logo===
Back in the main folder for your theme open the file named "header.html" inside of your text editor. You will now need to look for the first ocurrance of the following: ''<nowiki><h1 class="headermain"></nowiki>''[[Image:Adding_Logo.gif|frame|right|Your logo will appear in this location.]] Immediately after this code, add the following (assuming you followed the exact instructions for copying and renaming your logo): ''<nowiki><img src="<?php echo $CFG->themewww .'/'. current_theme() ?>/pix/logo.gif" alt="" /></nowiki>''
This will place a logo on the front school page. If you want a logo on all pages, including teacher pages, repeat this step for the second ocurrance of ''<nowiki><h1 class="headermain"></nowiki>'' as well.

==Finished==
If you used a file transfer program to copy the entire folder as detailed in Step One, you should copy the entire folder back into the "theme" folder of your Moodle server. Additionally, change Read and Write permissions (CHMOD) for the files and folder to 755 - Owner read/write/execute, Group read/execute, Everyone read/execute. (In most file transfer programs you can right-click on the folder and choose Properties to do this. In some cases you may need to ask your server administrator to do this for you.)

You can now use your Administrator panel to change your site to the new theme. Choose your new theme from within Moodle via ''Administration > Appearance > Themes > Theme selector''.

[[Image:Cusomized_Theme.gif|frame|center|Your new theme!]]

Because of the thousands of HTML elements in Moodle it's impossible to account for every possible change you may want to make to your theme. If you are interested in making more advanced changes, it's recommended you download the [http://www.getfirefox.com Firefox] web browser and install the [http://www.getfirebug.com/ Firebug] addon to see the HTML structure of Moodle pages. If you do not know CSS, the [http://www.w3schools.com/css/default.asp CSS Page] on W3Schools may be a good starting point.

==See also==

*[[Custom corners theme]]
*[[Chameleon theme]]

[[Category:Themes]]

Roles FAQ

2008-03-29T13:21:23Z

Ray: /* Where are permissions inherited from? */

{{Roles}}

==What is the definition of a...==

;Role
:An identifier of the user's status in some context, for example Teacher, Student and Forum moderator
;Capability
:A description of a particular Moodle feature, for example [[Capabilities/moodle/blog:create|moodle/blog:create]]
;Permission
:A setting for a capability - inherit, allow, prevent or prohibit
;Context
:A "space" in Moodle, such as courses, activity modules or blocks

==Why isn't my role change taking effect?==

In Moodle 1.7.x and 1.8.x, role assignments and overrides do not take effect immediately. They are delayed until the next time the user logs in. Starting with Moodle 1.9, explicit role assignments and overrides take effect immediately. However role assignments resulting from changes to certain user policies (for example, changing the default front page role) may be delayed until the next login.

If you are testing a new role, [[Manage_roles#Testing_a_new_role | here are some suggestions]].

Also, please check the context in which the role is assigned. Certain capabilities e.g. [[Capabilities/moodle/user:update|moodle/user:update]] may only be applied in the system context, so assigning a role in the course context will result in the role change not taking effect.

==Why are participants being added automatically when a new course is created?==

If a user is assigned a system role or a role in the course category context then the user has this role in ALL courses in that context. Thus users who are students or teachers at the category level appear as course participants in all courses in that category.

Please check ''Administration > Users > Permissions > Assign system roles'' and also the Assign roles link in course categories page and unassign users as necessary.

==Why are all students enrolled in all courses?==

Either
*Users are assigned the role of student in the site/system context rather than the course context (see FAQ above)
Or
*The default role for all users in ''Administration > Users > Permissions > User policies'' is set to Student rather than Authenticated user (Moodle 1.8 onwards).

==Why are there differences in the users listed as course participants and users assigned roles in a course?==

Users assigned roles in a higher context, for example users assigned the role of teacher in a course category context, may appear as course participants. The discussion [http://moodle.org/mod/forum/discuss.php?d=59900 Discrepancies between Assign Roles lists and Participants list] contains a longer explanation.

==How can I prevent administrators being listed as course participants?==

Ensure that administrators are not assigned another role in addition to their admin role.

==Why are hidden assignments still visible?==

Hidden assignments are not hidden from admins or teachers i.e. users with the [[Capabilities/moodle/role:viewhiddenassigns|viewhiddenassigns capability]].

==Where are permissions inherited from?==

Permissions are inherited from a role assigned in a higher-level context which has permissions set to allow for particular capabilities. If permission is "Not set" in any context and not allowed in any higher context (in particular, if you are creating or editing a role at the site level), then a user will have no permission for that capability.

For example, the Student role has permission not set for the change site configuration capability. The permission is never allowed in any context so users assigned the role of Student cannot change the site configuration.

==What is my role here?==

This is a frequently asked question, but an improper one. The correct question is "What are my ''permissions'' here?" In any given context, you often have two or more roles. In addition, one or more role overrides may be in effect. Your permissions in a given context are a result of "adding" the individual permissions from these roles and overrides according to certain rules. As Tim Hunt writes in [http://moodle.org/mod/forum/discuss.php?d=90140 this discussion], the rules "normally do what you expect." However when permissions conflict, the results can be surprising, and it pays to understand the [[rules for adding permissions]].

==How do I debug a roles-related problem?==

If you're having a problem that you suspect is related to roles, consider using [[The rolesdebug.php roles debugging script | the rolesdebug.php roles debugging script]]. You can download it from the [http://moodle.org/mod/data/view.php?d=13&rid=1204 Modules and plugins database]. The script gives you a spatial view of your role assignments and overrides in a given context, and analyzes your permissions there. To interpret the output requires a basic understanding of roles and capabilities. If you are a complete roles novice, run the script and post the output to the [http://moodle.org/mod/forum/view.php?id=6826 Roles and Capabilities Forum].

==Are there any differences in Roles in Moodle 1.7 and 1.8?==

In addition to many Roles fixes and refinements (see the list of [http://tracker.moodle.org/secure/IssueNavigator.jspa?mode=hide&requestId=10221 Roles improvements] in the Tracker), in Moodle 1.8 the ''system'' context is separated from the ''front page'' context. Roles may be assigned in the front page context via ''Administration > Front Page > Front Page roles''.

A "Duplicate role" button has been added in Moodle 1.8, which makes creating new roles based on predefined roles much quicker.

==How do I change the name for "teacher" in the course description?==

Either
* Edit the role of Teacher via ''Administration > Users > Permissions > Define roles'' and rename it. The new name will apply site-wide.
Or
* Create a duplicate teacher role with an alternative name and assign users the duplicate teacher role as appropriate in the course context. In ''Administration > Appearance > Course manager'' select the alternative name for teacher that you wish to be displayed in the course description.
Or
* One more way to do it in 1.8 is to create new "dummy" roles (no capabilities) with those names and assign them to teachers along with the real roles. In the course manager settings you can choose which roles display on the front page under each course. (The feature request [http://tracker.moodle.org/browse/MDL-9182 Ability to assign or display custom title for role of person in course] contains this further method.)

{{Moodle 1.9}}From Moodle 1.9 onwards, names for different roles in a course may be changed in the [[Course settings|course settings]].

==How do I enable teachers to set role overrides?==

#Access ''Administration > Users > Permissions > Define roles''.
#Edit the teacher role and change the capability [[Capabilities/moodle/role:override|moodle/role:override]] to allow.
#Click the button "Save changes".
#Click the tab "Allow role overrides" (in ''Administration > Users > Permissions > Define roles'').
#Check the appropriate box to allow a teacher to override the student role.
#Click the button "Save changes".

==How do I enable teachers to assign other teachers in a course?==

This is disabled by default but it can be switched on by modifying the teacher's role. In ''Administration > Users > Permissions > Define roles'' select the "Allow role assignments" tab and tick the checkbox where Teacher and Teacher intersect.

==Why doesn't "Switch role to.." within a course seem to work properly for a course creator?==

This feature is intended for teachers so that they can see how their course appears for students. It doesn't work reliably outside the course.

Further information about this feature can be found in [[Switch roles]] and the paragraph on testing a new role in [[Manage roles]].

==Are there any example roles?==

Yes, as follows:

*[[Inspector role|Inspector]] - for providing external inspectors with permission to view all courses (without being required to enrol)
*[[Parent role|Parent]] - for providing parents/mentors/tutors with permission to view certain information about their children/mentees/tutees
*[[Demo teacher role|Demo teacher]] - for providing a demonstration teacher account with a password which can't be changed
*[[Forum moderator role]] - for providing a user with permission in a particular forum to edit or delete forum posts, split discussions and move discussions to other forums
*[[Keyholder role]] - for setting the person named as holding a course [[Enrolment key|enrolment key]]
*[[Calendar editor role|Calendar editor]] - for providing a user with permission to add site events to the calendar
*[[Blogger role]] - for limiting blogging to specific users only

==Logged-in users can't read the site news. What can I do?==

#Access ''Site Administration > Front Page > Front Page roles''
#Follow the "Override roles" link
#Click on "Authenticated User"
#Scroll down to '''Forum'''
#Change the capability [[Capabilities/mod/forum:viewdiscussion|mod/forum:viewdiscussion]] to ''allow''
#Click the "Save changes" button at the bottom of the page

==How do I enable logged-in users to participate in front page activities?==

Either:
#Access ''Site Administration > Front Page > Front Page roles''
#Follow the "Override roles" link
#Click on "Authenticated User"
#Change capabilities to ''allow'' for all required activities e.g. record a choice, reply to posts
#Click the "Save changes" button at the bottom of the page

Note that for this to work, you need to make the default role for all users "authenticated user". This is the default for new versions of Moodle. In older versions, the default setting is guest, so if you have recently upgraded, you may have to change this setting. You can change the setting via ''Site Administration > Permissions > User Policies''.

Or:
#Access ''Site Administration > Front Page > Front Page roles''
#Click on Student
#Select all users in the potential users list, and use the left-facing arrow button to add them to the existing users list

{{Moodle 1.9}}Or, in Moodle 1.9 onwards:
#Access ''Site Administration > Front Page > Front Page settings''
#Set the default front page role to student.

[[Category:FAQ]]

[[es:FAQ_roles]]
[[fr:FAQ des rôles]]
[[ja:ロールFAQ]]
[[ru:FAQ по ролям]]

How permissions are calculated

2008-03-29T12:27:47Z

Ray: /* Only use prohibit in special roles */

{{Roles}}
One of the most frequently asked question is: ''What permissions does a user have in a given context?'' This article will document the main function in Moodle that is used to answer the question. The function is ''has_capability()''. It can be found in ''lib/accesslib.php''. The function implements the rules for "summing" permissions from multiple roles and overrides. Given a user, a capability, and a context, the function returns ''true'' if the user is allowed to perform the action controlled by the capability in the given context, and ''false'' otherwise.

This article is written for non-programmers as well as programmers. It describes ''what'' the function does, not ''how''. The ''how'' is complicated. The ''what'' turns out to be surprisingly simple!

Notice that the function ''does not'' attempt to answer the Big Question posed in the first sentence of this article. Instead, it answers the little question "Can some user do ''CAP'' here?" where ''CAP'' is a specific capability. Moodle never calculates a user's complete set of permissions. It would be very costly to do so, and also wasteful, since most of the permissions would never be tested. Instead, Moodle calculates permissions lazily, i.e., on demand. Moodle does not cache calculated permissions, but recalculates them every time they need to be tested. This is why role assignments and overrides no longer have delayed effects, as they did in Moodle 1.7 and 1.8.

==The calculation==

The function is called as follows:

has_capability(CAP,CONTEXT,USER);

where
*CAP is the capability being tested (e.g., mod/quiz:attempt)
*CONTEXT can be System context or some context nested arbitrarily deeply within System. Internally, the function uses Unix-style paths to represent contexts (e.g., /1/3/4/150), but such details do not concern us here
*USER is the user.

The function returns a true/false result

* ''true'' means the user should be allowed to perform the action
* ''false'' means the user should be prevented from perfoming the action

===Data used by the function===

Suppose USER is about to attempt a quiz (''CAP = mod/quiz:attempt'') in a Module context nested four levels deep within System.

System
|
Category A
|
Subcategory B
|
Course
|
Quiz <--- the user is here

The quiz module will call ''has_capability()'' to see if the user should be allowed to perform this action.

The function considers the following permissions data:

* ''Role definitions'' (these are in the System context)
* ''Role assignments'' which have been made in any of the five contexts
* ''Role overrides'' which may occur in any of the contexts except System (there is no concept of override in System).

Note that there may be multiple assignments and/or overrides in any single context.

Whether or not the user can attempt the quiz is a function of the permissions data, as well as the location of the data in the context chain.

''has_capability()'' considers all roles and overrides that impact USER in CONTEXT, but it ignores capabilities other than CAP. This simplification lets us view each role or override as a ''single permission'' having one of the following values

N - Not set
A - Allow
P - Prevent
X - Prohibit

We use the following notation: for a role ''R1'' with permission ''P'', we write ''R1(P)''.

===An example===

In the quiz example, suppose that the user has four roles (''R1'', ''R2'', ''R3'', and ''R4'') and each of the roles has been assigned and overridden as follows:

0 System <---- define R1(A), R2(N), R3(N), R4(P)
| assign R1
|
1 Category A <-------------- overide R1(N) and R4(N)
|
|
2 Subcategory B <---- assign R2 and R3
|
|
3 Course <-------------- override R2(X) and R3(A)
|
|
4 Quiz <---- assign R4 and R1

Note that ''R1'' has been assigned in two different contexts. This is an unusual practice (it is probably someone's error), but since it is legal, we have to consider the possibility that it can happen. In fact this entire example has been contrived to explore the edge cases of the algorithm. In practice, the calculation of permissions is trivial and the function calculates the result you would expect based on common sense and simple mental analysis (for further discussion of this, see [[#A note about the algorithm|A note about the algorithm]] near the end of this article.

===Representing the data in tabular form===

We will set up a table to hold the permission data. The table has
*one column for each role assignment, listed in order of increasing assignment depth. Columns are labeled with the role names.
*one row for each context level, listed in order of increasing context depth. Rows are labeled with the context level.

In the quiz example, ''R1'' is assigned in the System context, so it becomes the first column. ''R2'' and ''R3'' are assigned in the second highest context, so they become the next two columns (it doesn't matter which one goes first). ''R4'' and ''R1'' are assigned in the lowest context, so we list them last (again, it doesn't matter which one goes first). Here is our table with the rows and columns labeled:

R1 R2 R3 R4 R1
+------------------------
0 |
1 |
2 |
3 |
4 |

We add vertical lines to group role assignments made in the same context.

R1 R2 R3 R4 R1
+-----+---------+--------
0 | | |
1 | | |
2 | | |
3 | | |
4 | | |

The table is now ready to have the permission data added. In the first row, put the permission from the role definitions.

R1 R2 R3 R4 R1
+-----+---------+--------
0 | A | N N | P A
1 | | |
2 | | |
3 | | |
4 | | |

The remaining data come from overrides. We place the value from each override in
*the column corresponding to the role being overridden
*the row corresponding the level at which the override is made.

To illustrate, let's add just one of the overrides:

R1 R2 R3 R4 R1
+-----+---------+--------
0 | A | N N | P A
1 | | |
2 | | |
3 | | X |
4 | | |

The X represents the override to role R2 made in the course context. Let's add the rest of the overrides:

R1 R2 R3 R4 R1
+-----+---------+--------
0 | A | N N | P A
1 | N | | N N
2 | | |
3 | | X A |
4 | | |

The table is now fully populated, and we are ready to calculate the permission.

===The algorithm===

The algorithm follows a path through the table indicated by nodes and arrows in the diagram below and stops as soon as it has a conclusive result.

[[Image:Algorithm_path_through_permission_table.png|Algorithm path through permissions data]]

# If there is an X anywhere in the table, STOP. The calculated permission is ''X''
# Go to the START node
# If there is no next node, STOP. The calculated permission is ''P''
# Otherwise, follow the arrow to the next node
#Add the permissions in the node using the numerical equivalents: N = 0, A = +1, P = -1
#* If the sum is positive, STOP. The calculated permission is ''A''
#* If the sum is negative, STOP. The calculated permission is ''P''
#* If the sum is zero, GO TO step 3

Notice that the algorithm stops when either (1) a conclusive result is obtained, or (2) the algorithm reaches the last node without a conclusive result.

===Applying the algorithm to our example===

If we execute the algorithm with the quiz data, we stop at step 1 with a calculated permission of X. That was too easy, so let's change the X to a P and see what happens:

R1 R2 R3 R4 R1
+-----+---------+--------
0 | A | A P | P A
1 | N | | N N
2 | | |
3 | | P A |
4 | | |

Run the algorithm:

*There is No X in the table
*Go to the START node
*Go to the next node
*N + N = 0
*the sum is zero; go to the next node
*A + P = 0
*the sum is zero; go to the next node
*P + A = 0
*the sum is zero; go to the next node
*A + P = 0
*the sum is zero; go to the next node
*N = 0
*the sum is zero; go to the next node
*A = +1
*the sum is positive; STOP. The calculated permission is ''A''

If the calculated permission is ''A'', ''has_capability()'' returns ''true'', and the user is allowed to perform the action.

Had the calculated permission been ''P'' or ''X'', ''has_capability()'' would not immediately return ''false''. Rather, it would test if the user has ''moodle/site:doanything = Allow'' (since this permission trumps all others). The function does this by calling itself:

final result = has_capability(moodle/site:doanything,CONTEXT, USER);

==A note about the algorithm==

Earlier, we said that the algorithm "calculates the result you would expect." But what do we expect? Intuition tells us that permissions closer to the user should carry more weight than more distant permissions. That's why we set up the table the way we did and why the algorithm walks the table in the order that it does. The last column of the table represents the role assignment(s) closest to the user. The second-to-last column represents the role assignent(s) that are next in terms of distance from the user, and so-on. That's why the algorithm considers the columns from right-to-left. Within a column, the algorithm searches upward in order to give higher weight to overrides that are closer to the user. Once again, this matches our intuition about overrides. If there are no overrides in a column (or the overrides are all Not set), the permission in the role definition is used.

==Getting the result you expect==

The calculation is more likely to give "the result you would expect" if you keep your permissions as simple as possible. Therefore, we recommend the following 'rules' for defining and overriding roles. If you understand the description of the calculation above, you should understand why they make sense.

===When defining roles===

... use Allow (A) for things you want the role to be able to do, and use Not set (N) for things you don't care about (which should include most things).

===When overriding permissions===

... leave the permission for every capability as Inherit (N) apart from the few you want to change. For those, use Allow (A) for things you want to allow, and Prevent (P) for things you want to prevent.

===Only use prohibit in special roles===

Prohibit exists to cover extreme scenarios such as the following: Suppose you have a naughty student who is posting inappropriate content in your Moodle site. You need to be able to remove their ability to contribute to public discussions until they have promised not to do it again, but during that time, you cannot completely block them from the resources, quizzes, etc. because they must keep up with their studying. Therefore, you need a way to block their access to specific capabilities e.g. mod/forum:replypost in a way that cannot be overridden. You can do this by creating a special 'Naughty student' role defined with the required permission(s) set to prohibit. Then when you are having problems with a user, you can temporarily assign them this role, either at site level or at course level.

==A practical example==

Suppose that a user, who is assigned the role of Course creator in category B, creates a course (becoming Teacher in the course) and then creates a Lesson within the course. The user is about to edit the lesson (editing lessons is controlled by capability ''mod/lesson:edit''). Here is the permission data:

0 System <---- define Auth user(N), Creator(N), Teacher(A)
| assign Auth user
|
1 Category A
|
|
2 Subcategory B <---- assign Creator
|
|
3 Course <---- assign Teacher
|
|
4 Lesson <---- user attempts to edit lesson

We set up the table and populate it with permission data.

AuthUser Creator Teacher
+----------+--------+--------
0 | N | N | A
1 | | |
2 | | |
3 | | |
4 | | |

Since there are no overrides, the table only has data in the first row. The algorithm quickly calculates a permission of ''A'' and returns true. The user is allowed to edit the Lesson!

Now suppose Teacher is overridden in the Lesson context with ''mod/lesson:edit = P''. Then the table changes

AuthUser Creator Teacher
+----------+--------+--------
0 | N | N | A
1 | | |
2 | | |
3 | | |
4 | | | P

and clearly the user is no longer allowed to edit the Lesson.

But suppose the administrator (or whoever is making the overrides) decided instead to override the ''Creator role'', setting ''mod/lesson:edit = Prevent'' in the Categoy B context:

AuthUser Creator Teacher
+----------+--------+--------
0 | N | N | A
1 | | |
2 | | P |
3 | | |
4 | | |

Much to everyone's surprise, the user is still allowed to edit the Lesson! If you understood this article, you shouldn't be surprised, and you should be able to explain what happened.

==See also==

*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=90140 Logged in: what role am I?] and [http://moodle.org/mod/forum/discuss.php?d=66782 What happens if a user has multiple roles in a course?] forum discussions.

There is a script called rolesdebug.php that you can use to create tables like the ones in this article. It is very useful for debugging roles-related problems. See [[The rolesdebug.php roles debugging script]].

[[Category:Roles]]

[[fr:Comment les permissions sont calculées ?]]

How permissions are calculated

2008-03-29T12:22:59Z

Ray: /* When overriding roles */

{{Roles}}
One of the most frequently asked question is: ''What permissions does a user have in a given context?'' This article will document the main function in Moodle that is used to answer the question. The function is ''has_capability()''. It can be found in ''lib/accesslib.php''. The function implements the rules for "summing" permissions from multiple roles and overrides. Given a user, a capability, and a context, the function returns ''true'' if the user is allowed to perform the action controlled by the capability in the given context, and ''false'' otherwise.

This article is written for non-programmers as well as programmers. It describes ''what'' the function does, not ''how''. The ''how'' is complicated. The ''what'' turns out to be surprisingly simple!

Notice that the function ''does not'' attempt to answer the Big Question posed in the first sentence of this article. Instead, it answers the little question "Can some user do ''CAP'' here?" where ''CAP'' is a specific capability. Moodle never calculates a user's complete set of permissions. It would be very costly to do so, and also wasteful, since most of the permissions would never be tested. Instead, Moodle calculates permissions lazily, i.e., on demand. Moodle does not cache calculated permissions, but recalculates them every time they need to be tested. This is why role assignments and overrides no longer have delayed effects, as they did in Moodle 1.7 and 1.8.

==The calculation==

The function is called as follows:

has_capability(CAP,CONTEXT,USER);

where
*CAP is the capability being tested (e.g., mod/quiz:attempt)
*CONTEXT can be System context or some context nested arbitrarily deeply within System. Internally, the function uses Unix-style paths to represent contexts (e.g., /1/3/4/150), but such details do not concern us here
*USER is the user.

The function returns a true/false result

* ''true'' means the user should be allowed to perform the action
* ''false'' means the user should be prevented from perfoming the action

===Data used by the function===

Suppose USER is about to attempt a quiz (''CAP = mod/quiz:attempt'') in a Module context nested four levels deep within System.

System
|
Category A
|
Subcategory B
|
Course
|
Quiz <--- the user is here

The quiz module will call ''has_capability()'' to see if the user should be allowed to perform this action.

The function considers the following permissions data:

* ''Role definitions'' (these are in the System context)
* ''Role assignments'' which have been made in any of the five contexts
* ''Role overrides'' which may occur in any of the contexts except System (there is no concept of override in System).

Note that there may be multiple assignments and/or overrides in any single context.

Whether or not the user can attempt the quiz is a function of the permissions data, as well as the location of the data in the context chain.

''has_capability()'' considers all roles and overrides that impact USER in CONTEXT, but it ignores capabilities other than CAP. This simplification lets us view each role or override as a ''single permission'' having one of the following values

N - Not set
A - Allow
P - Prevent
X - Prohibit

We use the following notation: for a role ''R1'' with permission ''P'', we write ''R1(P)''.

===An example===

In the quiz example, suppose that the user has four roles (''R1'', ''R2'', ''R3'', and ''R4'') and each of the roles has been assigned and overridden as follows:

0 System <---- define R1(A), R2(N), R3(N), R4(P)
| assign R1
|
1 Category A <-------------- overide R1(N) and R4(N)
|
|
2 Subcategory B <---- assign R2 and R3
|
|
3 Course <-------------- override R2(X) and R3(A)
|
|
4 Quiz <---- assign R4 and R1

Note that ''R1'' has been assigned in two different contexts. This is an unusual practice (it is probably someone's error), but since it is legal, we have to consider the possibility that it can happen. In fact this entire example has been contrived to explore the edge cases of the algorithm. In practice, the calculation of permissions is trivial and the function calculates the result you would expect based on common sense and simple mental analysis (for further discussion of this, see [[#A note about the algorithm|A note about the algorithm]] near the end of this article.

===Representing the data in tabular form===

We will set up a table to hold the permission data. The table has
*one column for each role assignment, listed in order of increasing assignment depth. Columns are labeled with the role names.
*one row for each context level, listed in order of increasing context depth. Rows are labeled with the context level.

In the quiz example, ''R1'' is assigned in the System context, so it becomes the first column. ''R2'' and ''R3'' are assigned in the second highest context, so they become the next two columns (it doesn't matter which one goes first). ''R4'' and ''R1'' are assigned in the lowest context, so we list them last (again, it doesn't matter which one goes first). Here is our table with the rows and columns labeled:

R1 R2 R3 R4 R1
+------------------------
0 |
1 |
2 |
3 |
4 |

We add vertical lines to group role assignments made in the same context.

R1 R2 R3 R4 R1
+-----+---------+--------
0 | | |
1 | | |
2 | | |
3 | | |
4 | | |

The table is now ready to have the permission data added. In the first row, put the permission from the role definitions.

R1 R2 R3 R4 R1
+-----+---------+--------
0 | A | N N | P A
1 | | |
2 | | |
3 | | |
4 | | |

The remaining data come from overrides. We place the value from each override in
*the column corresponding to the role being overridden
*the row corresponding the level at which the override is made.

To illustrate, let's add just one of the overrides:

R1 R2 R3 R4 R1
+-----+---------+--------
0 | A | N N | P A
1 | | |
2 | | |
3 | | X |
4 | | |

The X represents the override to role R2 made in the course context. Let's add the rest of the overrides:

R1 R2 R3 R4 R1
+-----+---------+--------
0 | A | N N | P A
1 | N | | N N
2 | | |
3 | | X A |
4 | | |

The table is now fully populated, and we are ready to calculate the permission.

===The algorithm===

The algorithm follows a path through the table indicated by nodes and arrows in the diagram below and stops as soon as it has a conclusive result.

[[Image:Algorithm_path_through_permission_table.png|Algorithm path through permissions data]]

# If there is an X anywhere in the table, STOP. The calculated permission is ''X''
# Go to the START node
# If there is no next node, STOP. The calculated permission is ''P''
# Otherwise, follow the arrow to the next node
#Add the permissions in the node using the numerical equivalents: N = 0, A = +1, P = -1
#* If the sum is positive, STOP. The calculated permission is ''A''
#* If the sum is negative, STOP. The calculated permission is ''P''
#* If the sum is zero, GO TO step 3

Notice that the algorithm stops when either (1) a conclusive result is obtained, or (2) the algorithm reaches the last node without a conclusive result.

===Applying the algorithm to our example===

If we execute the algorithm with the quiz data, we stop at step 1 with a calculated permission of X. That was too easy, so let's change the X to a P and see what happens:

R1 R2 R3 R4 R1
+-----+---------+--------
0 | A | A P | P A
1 | N | | N N
2 | | |
3 | | P A |
4 | | |

Run the algorithm:

*There is No X in the table
*Go to the START node
*Go to the next node
*N + N = 0
*the sum is zero; go to the next node
*A + P = 0
*the sum is zero; go to the next node
*P + A = 0
*the sum is zero; go to the next node
*A + P = 0
*the sum is zero; go to the next node
*N = 0
*the sum is zero; go to the next node
*A = +1
*the sum is positive; STOP. The calculated permission is ''A''

If the calculated permission is ''A'', ''has_capability()'' returns ''true'', and the user is allowed to perform the action.

Had the calculated permission been ''P'' or ''X'', ''has_capability()'' would not immediately return ''false''. Rather, it would test if the user has ''moodle/site:doanything = Allow'' (since this permission trumps all others). The function does this by calling itself:

final result = has_capability(moodle/site:doanything,CONTEXT, USER);

==A note about the algorithm==

Earlier, we said that the algorithm "calculates the result you would expect." But what do we expect? Intuition tells us that permissions closer to the user should carry more weight than more distant permissions. That's why we set up the table the way we did and why the algorithm walks the table in the order that it does. The last column of the table represents the role assignment(s) closest to the user. The second-to-last column represents the role assignent(s) that are next in terms of distance from the user, and so-on. That's why the algorithm considers the columns from right-to-left. Within a column, the algorithm searches upward in order to give higher weight to overrides that are closer to the user. Once again, this matches our intuition about overrides. If there are no overrides in a column (or the overrides are all Not set), the permission in the role definition is used.

==Getting the result you expect==

The calculation is more likely to give "the result you would expect" if you keep your permissions as simple as possible. Therefore, we recommend the following 'rules' for defining and overriding roles. If you understand the description of the calculation above, you should understand why they make sense.

===When defining roles===

... use Allow (A) for things you want the role to be able to do, and use Not set (N) for things you don't care about (which should include most things).

===When overriding permissions===

... leave the permission for every capability as Inherit (N) apart from the few you want to change. For those, use Allow (A) for things you want to allow, and Prevent (P) for things you want to prevent.

===Only use prohibit in special roles===

Prohibit only exists to cover the following scenario: Suppose you have a naughty student who is posting inappropriate content in your Moodle site. You need to be able to remove their ability to contribute to public discussions until they have promised not to do it again, but during that time, you cannot completely block them from the resources, quizzes, etc. because they must keep up with their studying. Therefore, you need a way to block their access to capabilities like mod/forum:post in a way that cannot be overridden. You can do this by creating a special 'Naughty student' role defined with these permission set to prohibit. Then when you are having problems with a user, you can temporarily assign them this role, either at site level or at course level. Normally, this is the only way you have to use prohibit.

==A practical example==

Suppose that a user, who is assigned the role of Course creator in category B, creates a course (becoming Teacher in the course) and then creates a Lesson within the course. The user is about to edit the lesson (editing lessons is controlled by capability ''mod/lesson:edit''). Here is the permission data:

0 System <---- define Auth user(N), Creator(N), Teacher(A)
| assign Auth user
|
1 Category A
|
|
2 Subcategory B <---- assign Creator
|
|
3 Course <---- assign Teacher
|
|
4 Lesson <---- user attempts to edit lesson

We set up the table and populate it with permission data.

AuthUser Creator Teacher
+----------+--------+--------
0 | N | N | A
1 | | |
2 | | |
3 | | |
4 | | |

Since there are no overrides, the table only has data in the first row. The algorithm quickly calculates a permission of ''A'' and returns true. The user is allowed to edit the Lesson!

Now suppose Teacher is overridden in the Lesson context with ''mod/lesson:edit = P''. Then the table changes

AuthUser Creator Teacher
+----------+--------+--------
0 | N | N | A
1 | | |
2 | | |
3 | | |
4 | | | P

and clearly the user is no longer allowed to edit the Lesson.

But suppose the administrator (or whoever is making the overrides) decided instead to override the ''Creator role'', setting ''mod/lesson:edit = Prevent'' in the Categoy B context:

AuthUser Creator Teacher
+----------+--------+--------
0 | N | N | A
1 | | |
2 | | P |
3 | | |
4 | | |

Much to everyone's surprise, the user is still allowed to edit the Lesson! If you understood this article, you shouldn't be surprised, and you should be able to explain what happened.

==See also==

*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=90140 Logged in: what role am I?] and [http://moodle.org/mod/forum/discuss.php?d=66782 What happens if a user has multiple roles in a course?] forum discussions.

There is a script called rolesdebug.php that you can use to create tables like the ones in this article. It is very useful for debugging roles-related problems. See [[The rolesdebug.php roles debugging script]].

[[Category:Roles]]

[[fr:Comment les permissions sont calculées ?]]

Moodle manuals

2008-03-12T10:15:00Z

Ray: /* Administration manuals */

__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://www.howtomoodle.com/content/view/180/368/ Course Creator Reference Manual 1.8] - by '''Ray Lawrence''' Print 191 pages £15
*[http://www.howtomoodle.com/content/view/180/368/ Administrator Reference Manual 1.8] - by '''Ray Lawrence''' Print 69 pages £12
*[http://download.moodle.org/docs/moodle_1.4.3_for_teachers_and_trainers.pdf Moodle 1.4.3 For Teachers and Trainers] - by '''Bryan Williams''' (PDF, 2.4MB)
*[http://moodle.org/other/Using-Your-Moodle.pdf Using Your Moodle (1.4.3)] by [https://docs.moodle.org/en/User:Darren_Smith Darren Smith] (PDF, 2MB, Published Jan 2005)
*[http://download.moodle.org/docs/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/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 and 1.8.3] (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

===Other Languages===
*[http://www.lakapps.lk/software/Moodle/Tamil/Moodle_TA_20080131_Tea.pdf Moodle 1.8+ Teacher Manual (Tamil - Sri Lanka)] - by '''Kengatharaiyer Sarveswaran''' , University of Moratuwa, Sri Lanka. (PDF, 1.54MB)
*[http://www.lakapps.lk/software/Moodle/Sinhala/Moodle_SI_20080131_Tea.pdf Moodle 1.8+ Teacher Manual (Sinhala)] - by '''Sulochana Sooriyaarachchi''' , University of Moratuwa, Sri Lanka. (PDF, 2.79MB)
*[http://download.moodle.org/docs/teacher-manual-1.5-nl.pdf Moodle 1.5 Teacher Manual (Dutch)] - (PDF, 3MB)
*[http://download.moodle.org/docs/teacher-manual-it.pdf Moodle 1.3 Teacher Manual (Italian)] - (PDF, 3.1MB)
*[http://download.moodle.org/docs/teacher-manual-fr.pdf Moodle 1.3 Teacher Manual (French)] - (PDF, 5MB)
*[http://download.moodle.org/docs/teacher-manual-es.pdf Moodle Teacher Manual (Spanish)] - by '''Enrique Castro''' (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/content/view/180/368/ 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://download.moodle.org/docs/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 and 1.8.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]]

Moodle manuals

2008-03-03T15:54:49Z

Ray: /* 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://www.howtomoodle.com/content/view/180/368/ Course Creator Reference Manual 1.8] - by '''Ray Lawrence''' Print 191 pages £15
*[http://www.howtomoodle.com/content/view/180/368/ Administrator Reference Manual 1.8] - by '''Ray Lawrence''' Print 69 pages £12
*[http://download.moodle.org/docs/moodle_1.4.3_for_teachers_and_trainers.pdf Moodle 1.4.3 For Teachers and Trainers] - by '''Bryan Williams''' (PDF, 2.4MB)
*[http://moodle.org/other/Using-Your-Moodle.pdf Using Your Moodle (1.4.3)] by [https://docs.moodle.org/en/User:Darren_Smith Darren Smith] (PDF, 2MB, Published Jan 2005)
*[http://download.moodle.org/docs/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/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 and 1.8.3] (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

===Other Languages===
*[http://www.lakapps.lk/software/Moodle/Tamil/Moodle_TA_20080131_Tea.pdf Moodle 1.8+ Teacher Manual (Tamil - Sri Lanka)] - by '''Kengatharaiyer Sarveswaran''' , University of Moratuwa, Sri Lanka. (PDF, 1.54MB)
*[http://www.lakapps.lk/software/Moodle/Sinhala/Moodle_SI_20080131_Tea.pdf Moodle 1.8+ Teacher Manual (Sinhala)] - by '''Sulochana Sooriyaarachchi''' , University of Moratuwa, Sri Lanka. (PDF, 2.79MB)
*[http://download.moodle.org/docs/teacher-manual-1.5-nl.pdf Moodle 1.5 Teacher Manual (Dutch)] - (PDF, 3MB)
*[http://download.moodle.org/docs/teacher-manual-it.pdf Moodle 1.3 Teacher Manual (Italian)] - (PDF, 3.1MB)
*[http://download.moodle.org/docs/teacher-manual-fr.pdf Moodle 1.3 Teacher Manual (French)] - (PDF, 5MB)
*[http://download.moodle.org/docs/teacher-manual-es.pdf Moodle Teacher Manual (Spanish)] - by '''Enrique Castro''' (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://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://download.moodle.org/docs/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 and 1.8.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]]

Database fields

2008-02-10T14:37:43Z

Ray: /* Checkbox */

{{Databases}}

A '''field''' is a named unit of information. Each entry in a [[Database module|database]] can have multiple fields of multiple types e.g. a text field called 'favourite color' which allows you to type in your favourite shade, or a menu called 'state' that lets you choose one from a list of the 50 that make up the United States of America. By combining several fields with appropriate names and types you should be able to capture all the relevant information about the items in your database.

== Field name and description ==

All fields ask you for a name and a description when you create them. Field names must be unique and they should be short and sensible.

== Field types ==

=== Checkbox ===

Allows one or more checkboxes. Each line in the options box is a different checkbox. The text entered is what will be the case if the checkbox is checked e.g. 'valid' for something that can be valid or not. This word will appear beside the checkbox on entry, and then by itself when viewing if the box has been checked. If you wish to ensure that the user actively selects one of the options you can use [[Database_fields#Radio buttons|radio buttons]] instead

Multiple checkboxes could be used, for example, in a movie database that has Horror, Comedy, Western etc. checkboxes for different film genres, and you would be able to check more than one in the case of Horror-Comedies or Comedy-Westerns. The [[Database_fields#Menu (multi-select)|menu (multi-select)]] field also achieves this, but clicking multiple checkboxes is usually a more obvious interface.

=== Date ===

Allows users to enter a date by picking a day, month and year from a drop down list.

=== File ===

Asks users to upload a file from their computer. If it is an image file then the picture field may be a better choice.

=== Menu ===

The text entered in the ''options'' area will be presented as a drop-down list for the user to choose from. Each line become a different option.

=== Menu (Multi-select) ===

The text entered in the ''options'' area will be presented as a list for the user to choose from and each line become a different option. By holding down control or shift as they click, users will be able to select multiple options. This is a fairly advanced computer skill so it may be wise to use multiple checkboxes instead.

=== Number ===

Asks the user to enter a number. The number must be an integer, though it can be negative ( e.g. ...,-2,-1,0,1,2,3,...). If you enter anything else but numbers and a leading minus sign the number will be truncated or converted to zero e.g. "3.14" becomes "3", "1,000,000" becomes "1" and "six" becomes "0".

=== Picture ===

The user can upload an image file from their computer.

=== Radio buttons ===

Allows the user to choose one from a range of options. If the user doesn't select any of these options then they will be prompted to do so and can only submit the entry when one option is chosen.

If you only have two options and they are opposites (true/false, yes/no) then you could simply use a single checkbox instead. However checkboxes default to their unchecked status and so people could submit without actively selecting one of the options. This may not always be appropriate.

=== Text ===

Users can enter text up to 60 characters in length. For longer text, or for text that requires formatting such as headers and bullet points, you can use a textarea field.

=== Textarea ===

Allows users to enter a long piece of text including formatting similar to that found when creating forum posts.
Max number of characters in text area = ?

=== URL ===

Ask the user to enter a URL. If you select ''autolink'' then the URL becomes a clickable link. If you also enter a ''forced name for the link'' then that text will be used for the hyperlink. For example in a database of authors you may wish people to enter the author's website. If you enter the text 'homepage' as a forced name then clicking on text "homepage" will take you to the entered URL.

=== Latitude/longitude ===
{{Moodle 1.7}}
Users can enter a geographic location, by specifying the location's latitude and longitude. For example, [http://moodle.com/hq/ Moodle HQ] is at latitude -31.9545, longitude 115.877. When viewing the record, links are automatically generated linking to geographic data services such as [http://earth.google.com Google Earth], [http://www.openstreetmap.org/ OpenStreetMap], [http://www.geabios.com/ GeaBios],[http://www.mapstars.com/extern/deltaworks-holland Mapstars] and more. (The teacher can choose which of those links appear, if any.)

[[Category:Teacher]]
[[Category:Database]]

[[ru:Поля]]
[[fr:Champs]]
[[ja:データベースフィールド]]

Database fields

2008-02-10T14:37:14Z

Ray: /* Checkbox */

{{Databases}}

A '''field''' is a named unit of information. Each entry in a [[Database module|database]] can have multiple fields of multiple types e.g. a text field called 'favourite color' which allows you to type in your favourite shade, or a menu called 'state' that lets you choose one from a list of the 50 that make up the United States of America. By combining several fields with appropriate names and types you should be able to capture all the relevant information about the items in your database.

== Field name and description ==

All fields ask you for a name and a description when you create them. Field names must be unique and they should be short and sensible.

== Field types ==

=== Checkbox ===

Allows one or more checkboxes. Each line in the options box is a different checkbox. The text entered is what will be the case if the checkbox is checked e.g. 'valid' for something that can be valid or not. This word will appear beside the checkbox on entry, and then by itself when viewing if the box has been checked. If you wish to ensure that the user actively selects one of the options you can use [[Database_fields#Radio buttons|radio buttons]] instead

Multiple checboxes could be used, for example, in a movie database that has Horror, Comedy, Western etc. checkboxes for different film genres, and you would be able to check more than one in the case of Horror-Comedies or Comedy-Westerns. The [[Database_fields#Menu (multi-select)|menu (multi-select)]] field also achieves this, but clicking multiple checkboxes is usually a more obvious interface.

=== Date ===

Allows users to enter a date by picking a day, month and year from a drop down list.

=== File ===

Asks users to upload a file from their computer. If it is an image file then the picture field may be a better choice.

=== Menu ===

The text entered in the ''options'' area will be presented as a drop-down list for the user to choose from. Each line become a different option.

=== Menu (Multi-select) ===

The text entered in the ''options'' area will be presented as a list for the user to choose from and each line become a different option. By holding down control or shift as they click, users will be able to select multiple options. This is a fairly advanced computer skill so it may be wise to use multiple checkboxes instead.

=== Number ===

Asks the user to enter a number. The number must be an integer, though it can be negative ( e.g. ...,-2,-1,0,1,2,3,...). If you enter anything else but numbers and a leading minus sign the number will be truncated or converted to zero e.g. "3.14" becomes "3", "1,000,000" becomes "1" and "six" becomes "0".

=== Picture ===

The user can upload an image file from their computer.

=== Radio buttons ===

Allows the user to choose one from a range of options. If the user doesn't select any of these options then they will be prompted to do so and can only submit the entry when one option is chosen.

If you only have two options and they are opposites (true/false, yes/no) then you could simply use a single checkbox instead. However checkboxes default to their unchecked status and so people could submit without actively selecting one of the options. This may not always be appropriate.

=== Text ===

Users can enter text up to 60 characters in length. For longer text, or for text that requires formatting such as headers and bullet points, you can use a textarea field.

=== Textarea ===

Allows users to enter a long piece of text including formatting similar to that found when creating forum posts.
Max number of characters in text area = ?

=== URL ===

Ask the user to enter a URL. If you select ''autolink'' then the URL becomes a clickable link. If you also enter a ''forced name for the link'' then that text will be used for the hyperlink. For example in a database of authors you may wish people to enter the author's website. If you enter the text 'homepage' as a forced name then clicking on text "homepage" will take you to the entered URL.

=== Latitude/longitude ===
{{Moodle 1.7}}
Users can enter a geographic location, by specifying the location's latitude and longitude. For example, [http://moodle.com/hq/ Moodle HQ] is at latitude -31.9545, longitude 115.877. When viewing the record, links are automatically generated linking to geographic data services such as [http://earth.google.com Google Earth], [http://www.openstreetmap.org/ OpenStreetMap], [http://www.geabios.com/ GeaBios],[http://www.mapstars.com/extern/deltaworks-holland Mapstars] and more. (The teacher can choose which of those links appear, if any.)

[[Category:Teacher]]
[[Category:Database]]

[[ru:Поля]]
[[fr:Champs]]
[[ja:データベースフィールド]]

2.3:error/admin/cronerrorpassword

2007-11-01T22:28:16Z

Ray:

If this page is displayed you have atempted to force cron from your browser but have not appended the password set in Cron Password for remote access in Site Policies > Security e.g. http://site.example.com/admin/cron.php?password=opensesame

error/admin/cronerrorpassword

2007-11-01T22:28:16Z

Ray:

File:Cover2.gif

2007-10-27T12:17:08Z

Ray:

File:Cover.gif

2007-10-27T12:01:54Z

Ray:

Moodle manuals

2007-10-23T19:18:55Z

Ray: /* 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://www.howtomoodle.com/component/option,com_wrapper/Itemid,362/ Course Creator Guide 1.8] - by '''Ray Lawrence''' Print 157 pages £15
*[http://www.howtomoodle.com/component/option,com_wrapper/Itemid,362/ Administrator Guide 1.8] - by '''Ray Lawrence''' Print 66 pages £12
*[http://download.moodle.org/docs/moodle_1.4.3_for_teachers_and_trainers.pdf Moodle 1.4.3 For Teachers and Trainers] - by '''Bryan Williams''' (PDF, 2.4MB)
*[http://moodle.org/other/Using-Your-Moodle.pdf Using Your Moodle (1.4.3)] by [https://docs.moodle.org/en/User:Darren_Smith Darren Smith] (PDF, 2MB, Published Jan 2005)
*[http://download.moodle.org/docs/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/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 and 1.8.2] (including some third-party tools and Flash demos) 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)

===Other Languages===
*[http://download.moodle.org/docs/teacher-manual-1.5-nl.pdf Moodle 1.5 Teacher Manual (Dutch)] - (PDF, 3MB)
*[http://download.moodle.org/docs/teacher-manual-it.pdf Moodle 1.3 Teacher Manual (Italian)] - (PDF, 3.1MB)
*[http://download.moodle.org/docs/teacher-manual-fr.pdf Moodle 1.3 Teacher Manual (French)] - (PDF, 5MB)
*[http://download.moodle.org/docs/teacher-manual-es.pdf Moodle Teacher Manual (Spanish)] - by '''Enrique Castro''' (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://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://download.moodle.org/docs/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 and 1.8.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]]

Theme settings

2007-09-23T23:44:39Z

Ray: /* Hide activity type crumb */

{{Themes}}
Location: ''Administration > Appearance > Themes > Theme settings''

== Theme settings ==

*''themelist'' - This lists the themes available for course and user themes. Leave this blank to allow any valid theme to be used. If you want to shorten the theme menu, you may specify a comma-separated list of names, though don't use spaces (e.g. standard,orangewhite).

*''allowuserthemes'' - If you enable this, then users will be allowed to set their own themes. User themes override site themes but not course themes.

*''allowcoursethemes'' - If you enable this, then teachers will be able to set their own course themes. Course themes override all other theme choices (site, user, or session themes)..

*''allowuserstohideblocks''- Allows users to display and hide blocks

*''showblocksonmodulepage'' -If activity module allows blocks, this will enable a pulldown list.

*''allowcategorythemes'' - If you enable this, then themes can be set at the category level (from Moodle 1.9 onwards).

== Theme types ==

==== Site themes ====
Site themes may be previewed and chosen via Administration >> Configuration >> [[Themes]].

==== User themes ====
If the option ''allowuserthemes'' is enabled, each user may select their preferred theme on the [[user/edit|Edit profile]] page. All Moodle pages will be displayed in the user's theme, apart from courses where a course theme has been set.

==== Course themes ====
If the option ''allowcoursethemes'' is enabled, each editing teacher may select their course theme via the Force theme option on the [[course/edit|Course settings]] page. The course will always be displayed in the theme specified in the course setting, with user and the site themes being overwritten.

==== Session themes ====
Moodle offers an additional way to set a theme - the '''session theme'''. This is set with the URL and lasts until you log out. When you next login, the site/course/user themes are active again. This option is great for theme testing and works perfectly when you want to enable different themes for different situations.

For example you can offer a special link for PDA users and integrate the session theme ''orangewhitepda'' in that link. Nobody needs to change any settings, you just click on that link. The session theme is called by the URL parameter <code>&theme=orangewhitepda</code>. The whole URL without the session theme could look like <code><nowiki>http://mymoodlesite.org/course/view.php?id=18</nowiki></code> and with the parameter for the PDA theme like <code><nowiki>"http://mymoodlesite.org/course/view.php?id=18&theme=orangewhitepda"</nowiki></code>.

In a standard Moodle installation, session themes are not active. To activate them the administrator must add the parameter <code>$CFG->allowthemechangeonurl = true;</code> to the Moodle ''config.php'' file in the Moodle base directory.

== Theme overview ==

{| style="border:1px dashed #ddd"
|- style="vertical-align:top;text-align:left"
!Theme type
! style="background:#eee"|Overwrites
!Display
! style="background:#eee"|Setting type
|- style="vertical-align:top"
|Site
|style="background:#eee"| -
|all pages*
|style="background:#eee"|saved in theme profile
|- style="vertical-align:top"
|User
|style="background:#eee"|Site theme
|all pages*
|style="background:#eee"|saved in user profile
|- style="vertical-align:top"
|Course
|style="background:#eee"|Site, user and session themes
|one course
|style="background:#eee"|saved in course profile
|- style="vertical-align:top"
|Session
|style="background:#eee"|Site and user themes
|all pages*
|style="background:#eee"|temporary until logout
|}
(* except courses with the course theme set)

==Hide activity type navigation==
{{Moodle 1.9}}
From Moodle 1.9 onwards, the activity type (e.g. Quizzes) crumb in the navigation bar may be hidden from students or all users.

[[Category:Themes]]

[[es:Configuración de temas]]
[[fr:Configuration des thèmes]]

Theme settings

2007-09-23T23:44:10Z

Ray: /* Hide activity type crumb */

{{Themes}}
Location: ''Administration > Appearance > Themes > Theme settings''

== Theme settings ==

*''themelist'' - This lists the themes available for course and user themes. Leave this blank to allow any valid theme to be used. If you want to shorten the theme menu, you may specify a comma-separated list of names, though don't use spaces (e.g. standard,orangewhite).

*''allowuserthemes'' - If you enable this, then users will be allowed to set their own themes. User themes override site themes but not course themes.

*''allowcoursethemes'' - If you enable this, then teachers will be able to set their own course themes. Course themes override all other theme choices (site, user, or session themes)..

*''allowuserstohideblocks''- Allows users to display and hide blocks

*''showblocksonmodulepage'' -If activity module allows blocks, this will enable a pulldown list.

*''allowcategorythemes'' - If you enable this, then themes can be set at the category level (from Moodle 1.9 onwards).

== Theme types ==

==== Site themes ====
Site themes may be previewed and chosen via Administration >> Configuration >> [[Themes]].

==== User themes ====
If the option ''allowuserthemes'' is enabled, each user may select their preferred theme on the [[user/edit|Edit profile]] page. All Moodle pages will be displayed in the user's theme, apart from courses where a course theme has been set.

==== Course themes ====
If the option ''allowcoursethemes'' is enabled, each editing teacher may select their course theme via the Force theme option on the [[course/edit|Course settings]] page. The course will always be displayed in the theme specified in the course setting, with user and the site themes being overwritten.

==== Session themes ====
Moodle offers an additional way to set a theme - the '''session theme'''. This is set with the URL and lasts until you log out. When you next login, the site/course/user themes are active again. This option is great for theme testing and works perfectly when you want to enable different themes for different situations.

For example you can offer a special link for PDA users and integrate the session theme ''orangewhitepda'' in that link. Nobody needs to change any settings, you just click on that link. The session theme is called by the URL parameter <code>&theme=orangewhitepda</code>. The whole URL without the session theme could look like <code><nowiki>http://mymoodlesite.org/course/view.php?id=18</nowiki></code> and with the parameter for the PDA theme like <code><nowiki>"http://mymoodlesite.org/course/view.php?id=18&theme=orangewhitepda"</nowiki></code>.

In a standard Moodle installation, session themes are not active. To activate them the administrator must add the parameter <code>$CFG->allowthemechangeonurl = true;</code> to the Moodle ''config.php'' file in the Moodle base directory.

== Theme overview ==

{| style="border:1px dashed #ddd"
|- style="vertical-align:top;text-align:left"
!Theme type
! style="background:#eee"|Overwrites
!Display
! style="background:#eee"|Setting type
|- style="vertical-align:top"
|Site
|style="background:#eee"| -
|all pages*
|style="background:#eee"|saved in theme profile
|- style="vertical-align:top"
|User
|style="background:#eee"|Site theme
|all pages*
|style="background:#eee"|saved in user profile
|- style="vertical-align:top"
|Course
|style="background:#eee"|Site, user and session themes
|one course
|style="background:#eee"|saved in course profile
|- style="vertical-align:top"
|Session
|style="background:#eee"|Site and user themes
|all pages*
|style="background:#eee"|temporary until logout
|}
(* except courses with the course theme set)

==Hide activity type crumb==
{{Moodle 1.9}}
From Moodle 1.9 onwards, the activity type (e.g. Quizzes) crumb in the navigation bar may be hidden from students or all users.

[[Category:Themes]]

[[es:Configuración de temas]]
[[fr:Configuration des thèmes]]

Talk:Language editing

2007-08-18T18:35:56Z

Ray: /* Ability to edit language files in non-standard locations */

==Double brackets==

It seems to me there should be a mention somewhere of why sometimes you might see double brackets <nowiki>[[like this]]</nowiki>, but I'm not quite sure what the most appropriate place might be.--[[User:Hatshepsut|Hatshepsut]] 10:48, 9 February 2006 (WST)

:Yes, you're right. The information could also be added to [[Administration FAQ]]. --[[User:Helen Foster|Helen Foster]] 17:10, 6 July 2006 (WST)

==Ability to edit language files in non-standard locations==
TODO: Ability to edit language files in non-standard locations...
Yes, that would be nice, since more and more 3rd-party modules carry their own language files in their folders, and the translation system does not yet apply to them.

[[User:Joseph Rézeau|Joseph Rézeau]]

==Correct paths?==

"# From Moodle 1.9 onwards, only users with the capability moodle/site:langeditmaster may modify the master language packages (i.e. those being saved in moodledata/lang/). It is prevented from all roles by default. It is expected that only language maintainers will manually allow this to themselves.
# From Moodle 1.9 onwards, only users with the capability moodle/site:langeditlocal may customize the site translation (i.e. files being saved in moodledata/lang_local/)."

I've just tried this out on a test 1.9 install. Should the reference to "moodledata/lang" be "moodle/lang"?

[[User: Ray Lawrence| Ray Lawrence]]

Windows installation using XAMPP

2007-08-14T20:49:48Z

Ray: /* Create the database */

XAMPP is built for tests or perhaps for a small company using it on an internal network. It is not meant for online access via the web on a production server. This page describes some of the ways to customize XAMPP.

==Introduction==

Note: This guide uses XAMPP 1.5.1

In this guide to installing Moodle on a computer using the Windows XP operating system there are a series of steps you will need to take which are explained step-by-step below. In overview the process is as follows:

The first steps are to obtain the Moodle files themselves and the [[Common_acronyms#N_to_Z|XAMPP]] software package which installs the environment (PHP, Apache and MySql) Moodle requires to run on you computer. When these have been downloaded you will need to install XAMPP on you computer in much the same way as any other Windows program. The steps detail a recommended change to one of the installed components before explaining how to launch XAMPP and create the database required by Moodle (the database you create will be referred to later when installing Moodle).

Having set up the environment you must then place the Moodle files downloaded earlier into the correct location so that they can be accessed for the purposes of initiating the installation process (now) and later to run Moodle. (The installation and use of Moodle is conducted entirely from you web browser e.g. Internet Explorer, Firefox).

'''Note: These guidelines are not intended for the [[Complete install packages]] from Downloads at Moodle.org - although the troubleshooting part may help if you encounter problems.'''

==Preparation==

===Get Moodle!===

*Download the version of Moodle you wish to install from [http://download.moodle.org/ Moodle.org]

[[Image: 14a.gif]].

===Get XAMPP!===

*Download XAMPP for Windows from [http://www.apachefriends.org/en/xampp.html Apachefriends.org]. This example assumes that you have downloaded the “Installer” package.

[[image:Xampp1.png]]

===Allow yourself some time===
*Say 45 minutes.

==Installing XAMPP==

*Run the installer, eventually you will be presented with an option about where to install the package.

[[image:Xampp2.gif]]

*In this example we are installing the package at c:\apachefriends\151 – that’s because it suits what our needs, you can choose you own location by specifying any suitable alternative folder.

*Continue with the installation, this will take a while!

[[image:Xampp3.gif]]

*Eventually you will be presented with the option to install Apache, MySQL, Filezilla as a service.

[[image:Xampp4.gif]]

*It’s probably best to choose “No” for now. You can always enable these as services later.

*Next you’ll be asked if you want to start the XAMPP Control Panel.

[[image:Xampp5.gif]]

*Click the “No” button.

===Launch XAMPP Control Panel ===

*On your Desktop, locate the XAMPP icon and double click to launch the Control Panel.

*When the XAMPP Control Panel has launched, click the “Start” buttons for Apache and MySQL.

[[image:Xampp6.gif]]

*If all is well you will see something like this.
'''If Apache fails to run i.e. the "Running" text with the green background keeps disappearing) and you are using Skype - please review "Troubleshooting" at the end of these instructions.'''

[[image:Xampp31.gif]]

==Create the database==

*To create a database for your Moodle “site” we will use the phpMyAdmin utility included with XAMPP.

*To access this launch the web browser of your choice (Firefox is used in this example), type http://localhost in the address bar.

[[image:Xampp8.gif]]

*The XAMPP default page is displayed, click the link for your preferred language – we will be using English.

[[image:Xampp9.gif]]

*From the menu on the left, click on “phpMyAdmin”

[[image:Xampp10.gif]]

*When phpMy Admin has launched in your browser window, enter the name of your database in the “Create new database” field. In this example we are naming our database “moodle153”.

[[image:Xampp11.gif]]

* From the "Collation" drop down list select "utf8_unicode_ci"

*Click the “Create” button to create the database.

[[image:Xampp12.gif]]

The new database should be present in the dropdown list when the page has refreshed.

[[image:Xampp13.gif]]

==Extract the downloaded Moodle files to the correct location.==

*Locate the file downloaded from Moodle.org and either copy or cut the file to the Windows clipboard.

*Open the XAMPP Control Panel and click on the “Explore” button.

[[image:Xampp15.gif]]

*A Windows Explorer view similar to the one below will be displayed.

[[image:Xampp16.gif]]

*Open the “htdocs” folder.

[[image:Xampp17.gif]]

[[image:Xampp18.gif]]

*Paste the file cut/copied earlier into this folder.

*Extract the Moodle files from the file downloaded earlier. A default folder named “moodle” is created with the Moodle files within.

[[image:Xampp19.gif]]

==Start the installation==

*In your web browser, type the path to the folder containing the Moodle files in te address bar – in this example it’s <nowiki>http://localhost/moodle</nowiki>.

[[image:Xampp23.gif]]

*The initial install page is displayed.

[[image:Xampp24.gif]]

*Choose your preferred language (English is used in this example) and click the “Next” button.

*A diagnostic report is displayed – hopefully it will look like this, if not you may need to address some issues.

[[image:Xampp25.gif]]

*Click the “Next” button to continue.

*The paths for your Moodle installation are shown – accept these or amend as desired.

[[image:Xampp26.gif]]

*Click the “Next” button to continue.

*In this screen we enter the database settings. The fields are populated with some suggested values.

[[image:Xampp27.gif]]

*In this example the database created is “moodle153”. The “root” user will be used without a password.

*DO NOT USE THE “ROOT” USER WITHOUT A PASSWORD FOR PRODUCTION INSTALLATIONS AS THIS CREATES A SECURITY VULNERABILITY

[[image:Xampp28.gif]]

*When the fields have been populated, click the “Next” button to continue.

*Provided the Moodle folder is writable a message confirming the configuration has been completed will be displayed.

[[image:Xampp29.gif]]

*Click the “ Continue” button to proceed.

The Moodle copyright / licence notices are displayed.

[[image:Xampp30.gif]]

*Click the “Yes” button to continue, then follow the instructions on the following screens.

==Troubleshooting==
===Skype===
*If XAMPP does not work when you launch your browser and you have [http://www.skype.com Skype] enabled it may be necessary to change the port settings in Skype.

* Locate "Options..." in Skype.

[[Image: Skype1.gif]]

* Locate the "Connection" options.

[[Image: Skype2.gif]]

* Remove the tick / check from the Checkbox.

[[Image: Skype3.gif]]

* Click the "Save" button.

* You may need to re-start your computer for this to take effect.

===Still having problems but do not have Skype installed?===
* Check for another program which may be using port 80. IIS is commonly found to be the culprit.

====Moodle Networking does not work====
You may need to enable curl. Instructions at this link [http://www.tildemark.com/programming/php/enable-curl-with-xampp-on-windows-xp.html Enable curl in XAMPP on XP]

==See also==
*Return to [[Windows installation]]
*[[Installing AMP]]

[[Category:Administrator]]
[[Category:Installation]]

Capabilities/mod/forum:viewqandawithoutposting

2007-07-15T11:58:49Z

Ray:

*This allows a user to view Q and A forum posts without first posting
(By default a Q and A forum requires students to post once before viewing other students' postings. After the initial posting, students can view and respond to others' postings. This feature allows equal initial posting opportunity among all students, thus encouraging original and independent thinking.)

It generally takes students 10 seconds to work out that if they post an answer they can see the other replies and that if they delete their initial reply they are reverted to the "first post status". Options:

* Monitor the forum activity for deletions
* Override the capability of students to be able to delete their own posts ;-)

[[Category:Capabilities|Forum]]
[[Category:Forum]]

Developer conference April 2007

2007-04-26T00:28:48Z

Ray: /* Moodle 1.8 */

[[Developer conferences]] > April 2007 conference notes

The conference time was at 11am GMT, Friday 20th April. We had 32 participants and we covered everything in just over two hours! I think most people got something useful out of it.

==Moodle 1.8==

Some things that need to be taken into account for all new development:

* [[Accessibility|Accessibility Compliance]] and XHTML Strict 1.0
:These two are closely related. Accessibility is important so that as many people as possible can participate in Moodle courses, and also because there are now legislative requriements in many coutries. Ensuring that your pages validate as XHTML1.0 Strict is a very good start, and all new code in Moodle should validate. Martin D recommended two firefox plugins that are a big help are [https://addons.mozilla.org/en-US/firefox/addon/1843 Firebug] and [https://addons.mozilla.org/en-US/firefox/addon/249 HTML Validator]. Nick F recommended the [https://addons.mozilla.org/en-US/firefox/addon/402 Fangs screenreader emulator].

* [[Development:lib/formslib.php|Forms Library]]
:Also part of the accessibility work, but also makes forms easier for developers to create, and more consistent and usable for users (thanks to Jamie Pratt). All new forms in Moodle should use forms lib.

Tim H asked whether the 2 month delay in releasing Moodle 1.8 was to be expected with future releases. Martin D replied that he hoped not, and that the delay was due to the time taken to implement accessibility improvements and to ensure that 1.8 was a very strong release.

==Moodle 1.9==

* [[Development:Events]]
:This is the biggest new architectural feature planned for 1.9. It is a way to allow different parts of Moodle to communicate with each other, without becoming too closely coupled. Martin L commented that the Events API was cool. He added that they had had some discussion at Catalyst based on their experience of events-driven Elg and advised that events should be queue-able and that the code needed to cope with events being lost.

* [[Development:Grades]]
:The big new user-visible feature planned for 1.9 - a centralised gradebook. The first use of the Events architecture. Please see the discussion [http://moodle.org/mod/forum/discuss.php?d=69223 Gradebook for 1.9 - your input wanted]. Jenny G asked whether the gradebook could be used to track progress through a course (read resources etc). Martin D replied explaining that there will be an overall grade for a course and a course setting for course completed which could be based in resources visited.

* [[Dfwiki|Nwiki]]
:More development has been done improving the API, using forms lib etc. to make the code match Moodle coding standards. Ludo said that he was looking for a decision regarding whether Nwiki will be added to the core code. Martin D answered that the database upgrade is big and scary, so when we do it, we must be sure the new database structure is right, and will not need significant changes for a long time afterwards. He requested for more developers to download Nwiki from contrib and try it and suggested that once Nwiki is XHTML strict, to have a discussion in the general developer forum. (Later, Ludo suggested talking about it in [[NWiki roadmap]].) Martin D pointed out that there is another wiki - the OU wiki written by Sam Marshall which is very simple and very well written but doesn't migrate from the old wiki. He said that we need to decide together what to go for and what we can support/build on. Pablo Casadro pointed out that Nwiki is compliant with OKI http://www.okiproject.org/.

* [http://www.dimdim.com/ DimDim]
:Online voice-conferencing software with a Flash interface, a bit like Elluminate, which we used for the meeting, but this one is open source. Currently beta quality, but already Moodle integration - the DimDim module (modified Chat module) - exists. It may be tried at http://test.moodle.com. (We nearly used it for the meeting, but it was not quite stable enough.) It has screen sharing, upload pdf, share audio, and is developing rapidly, so watch this space.

* [[Development:Plan to Improve Flexibility of Question Category Sharing and Permissions|Question sharing / permissions changes]]
:Jamie P described his plans. Please see the discussions [http://moodle.org/mod/forum/discuss.php?d=67006#p301658 Plan for the conversion of the question bank into an activity module]) and [http://moodle.org/mod/forum/discuss.php?d=63728#p301732 student question creation module].

===Moodle 1.9 release plans===
We are aiming for a beta release at the end of May. That means all work on new features must be finished by then. Then about a month's bug fixing will hopefully be enough, and we can release mid July. All developers, please try to stick to the end of May deadline. (Note for the future: Moodle 2.0 will definitely require PHP 5.)

==Other items of interest==

* [[Student_projects|Google Summer of Code projects]]
:Martin D welcomed the 10 SoC students to Moodle development, and briefly went through the wide range of projects that are planned.
* [http://moodle.org/mod/forum/discuss.php?d=69643 OU wiki]
:Just a simple wiki, not designed to replace the core Moodle one, but should be available as a contrib module in a couple of months, for anyone who is interested.
* OU offline Moodle
:Project that OU (In particular Chris) is doing with Intel. Not clear how useful it is, but an interesting idea. Expect a forum post in the next few days.
* [http://www.openqa.org/selenium/ Selenium] testing
:Al (OU) is working on a way of using Selenum to test Moodle. Focussing on the quiz at first. Expect a forum post in the next week or so.
* [[Development:Open_protocol_for_accessing_question_engines|Opaque]]
:Tim is working on this, and has just got it working with OpenMark. A way of linking questions from other systems such as the OU's [http://www.open.ac.uk/openmarkexamples/ OpenMark] or Chris Sangwin's [http://www.stack.bham.ac.uk/ STACK] into Moodle. It will be a contrib question type.
* The OU's Open Content Initiative - http://openlearn.open.ac.uk/ - has won a platinum award, the top honour, at the IMS Global Learning Consortium Learning Impact Awards 2007. Well done Jenny G!
* AJAX course format
:The AJAX course format works, though not in all browsers. Martin D asked for any volunteers to be a Moodle JavaScript guru.
*TinyMCE
:Martin D asked for any volunteers to look into replacing the current HTML editor with TinyMCE. Please see the discussion [http://moodle.org/mod/forum/discuss.php?d=69177 tinymce editor with iManager image plugin for moodle 1.6].

[[Category:Developer]]

CVS for Administrators

2007-04-08T15:45:28Z

Ray: /* From a Windows computer */

The [http://moodle.cvs.sourceforge.net/moodle/moodle/ CVS archive] contains all the source code for Moodle. You can use a CVS program to extract versions ranging from the most stable release to the most cutting-edge development version. CVS can be an extremely convenient way of maintaining a Moodle server.

[[Image:Cvstree.png|CVS tree]]

Developers may have selective write access to the Moodle CVS archive using their Sourceforge username and password (see [[CVS for Developers]] for details about how to do this). However, most people only need read-only access, so they can just connect anonymously as described below. There can however currently be a delay of up to 5 hours between the time a developer commits changes to developer CVS and the time it becomes available on anonymous CVS. The CVS date found on the /admin page is updated manually.

===From a Unix computer===

To connect and login for the first time to the CVS server, you can use this command:

cvs -d:pserver:anonymous@moodle.cvs.sourceforge.net:/cvsroot/moodle login

There is no password - when asked for one, just hit Enter.

To checkout (download) the entire Moodle code for the first time, use this command to get the latest STABLE version:

cvs -z3 -d:pserver:anonymous@moodle.cvs.sourceforge.net:/cvsroot/moodle co -r MOODLE_18_STABLE moodle

Or the latest development version:

cvs -z3 -d:pserver:anonymous@moodle.cvs.sourceforge.net:/cvsroot/moodle co moodle

Or the modules in Contrib

cvs -z3 -d:pserver:anonymous@moodle.cvs.sourceforge.net:/cvsroot/moodle co contrib

Later, to update your local copy of Moodle to the current version in CVS you just need to go into your local Moodle directory and type:

cvs update -dP

To update your local copy of Moodle to a new version (e.g. from 1.7+ to 1.8), go into your local Moodle directory and type:

cvs update -dP -r MOODLE_18_STABLE

===From a Windows computer===

To get started with a fresh copy of Moodle, follow the following steps:

# Get TortoiseCVS from [http://www.tortoisecvs.org/ tortoisecvs.org] and install it, then reboot.
# Find or create a new folder somewhere where you want Moodle to be downloaded to.
# Right-mouse-click that folder and choose "CVS Checkout" from the menu. You should see a dialog box. [[Image:CVS moodle settings for tortoise CVS.jpg|thumb|Tortoise CVS Screen capture]]
# Copy this text into the CVSROOT field: <code>:pserver:anonymous@moodle.cvs.sourceforge.net:/cvsroot/moodle</code>
# Under the "Module" field, type "moodle" to get moodle. (Other options here include"contrib" to get the contrib directory of hacks and addons, or "mysql" to get the optional MySQL Admin module).
#* For the latest STABLE version, click on the "Revision" tab and then check the radio button labelled "Choose branch or tag". From the drop-down menu select MOODLE_18_STABLE.
#* If you don't see the very latest version in the long drop-down list under Branch or tag name, click the Update List button next to it and wait for the list to be updated.
#* For the latest UNSTABLE development version, the radio-button "Use HEAD branch" in the Revision tab should be checked.
# Press the button: "OK" and everything should be downloaded.

Later, to update your local copy of Moodle to the current version in CVS, just right-mouse-click the folder and choose "CVS Update".

Note that the enclosing moodle folder is self-contained - you can move it anywhere you like or even rename it.

===From a Mac OS X computer===
You will find some information about CVS and Mac OS X in the documentation for the complete installation package Moodle4Mac. Please read [[Complete_Install_Packages_for_Mac_OS_X#How_To_Update_Your_Moodle4Mac | How To Update Your Moodle4Mac]].

==See also==

*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=26731&parent=125858 Using cvs] forum posting
*[[Development:Setting up Eclipse]] for step by step instructions for setting up the [http://www.eclipse.org/ Eclipse IDE] for Moodle development, which including how to do the necessary CVS operations.

[[Category:Administrator]]

Windows installation using XAMPP

2007-02-27T15:27:09Z

Ray: /* Change PHP version */

*Return to [[Windows installation]]

== Windows installation using XAMPP ==
===Introduction===

Note: This guide uses XAMPP 1.5.1

In this guide to installing Moodle on a computer using the Windows XP operating system there are a series of steps you will need to take which are explained step-by-step below. In overview the process is as follows:

The first steps are to obtain the Moodle files themselves and the software package (XAMPP) which installs the environment (PHP, Apache and MySql) Moodle requires to run on you computer. When these have been downloaded you will need to install XAMPP on you computer in much the same way as any other Windows program. The steps detail a recommended change to one of the installed components before explaining how to launch XAMPP and create the database required by Moodle (the database you create will be referred to later when installing Moodle).

Having set up the environment you must then place the Moodle files downloaded earlier into the correct location so that they can be accessed for the purposes of initiating the installation process (now) and later to run Moodle. (The installation and use of Moodle is conducted entirely from you web browser e.g. Internet Explorer, Firefox).

'''Note: These guidelines are not intended for the Complete Install Package from Downloads at Moodle.org - although the troubleshooting part may help if you encounter problems.'''

===Preparation===

====Get Moodle!====

*Download the version of Moodle you wish to install from [http://download.moodle.org/ Moodle.org]

[[Image: 14a.gif]].

====Get XAMPP!====

*Download XAMPP for Windows from [http://www.apachefriends.org/en/xampp.html Apachefriends.org]. This example assumes that you have downloaded the “Installer” package.

[[image:Xampp1.png]]

====Allow yourself some time====
*Say 45 minutes.

===Installing XAMPP===

*Run the installer, eventually you will be presented with an option about where to install the package.

[[image:Xampp2.gif]]

*In this example we are installing the package at c:\apachefriends\151 – that’s because it suits what our needs, you can choose you own location by specifying any suitable alternative folder.

*Continue with the installation, this will take a while!

[[image:Xampp3.gif]]

*Eventually you will be presented with the option to install Apache, MySQL, Filezilla as a service.

[[image:Xampp4.gif]]

*It’s probably best to choose “No” for now. You can always enable these as services later.

*Next you’ll be asked if you want to start the XAMPP Control Panel.

[[image:Xampp5.gif]]

*Click the “No” button.

===Launch XAMPP Control Panel ===

*On your Desktop, locate the XAMPP icon and double click to launch the Control Panel.

*When the XAMPP Control Panel has launched, click the “Start” buttons for Apache and MySQL.

[[image:Xampp6.gif]]

*If all is well you will see something like this.
'''If Apache fails to run i.e. the "Running" text with the green background keeps disappearing) and you are using Skype - please review "Troubleshooting" at the end of these instructions.'''

[[image:Xampp31.gif]]

===Create the database===

*To create a database for your Moodle “site” we will use the phpMyAdmin utility included with XAMPP.

*To access this launch the web browser of your choice (Firefox is used in this example), type http://localhost in the address bar.

[[image:Xampp8.gif]]

*The XAMPP default page is displayed, click the link for your preferred language – we will be using English.

[[image:Xampp9.gif]]

*From the menu on the left, click on “phpMyAdmin”

[[image:Xampp10.gif]]

*When phpMy Admin has launched in your browser window, enter the name of your database in the “Create new database” field. In this example we are naming our database “moodle153”.

[[image:Xampp11.gif]]

*Click the “Create” button to create the database.

[[image:Xampp12.gif]]

The new database should be present in the dropdown list when the page has refreshed.

[[image:Xampp13.gif]]

===Extract the downloaded Moodle files to the correct location.===

*Locate the file downloaded from Moodle.org and either copy or cut the file to the Windows clipboard.

*Open the XAMPP Control Panel and click on the “Explore” button.

[[image:Xampp15.gif]]

*A Windows Explorer view similar to the one below will be displayed.

[[image:Xampp16.gif]]

*Open the “htdocs” folder.

[[image:Xampp17.gif]]

[[image:Xampp18.gif]]

*Paste the file cut/copied earlier into this folder.

*Extract the Moodle files from the file downloaded earlier. A default folder named “moodle” is created with the Moodle files within.

[[image:Xampp19.gif]]

===Start the installation===

*In your web browser, type the path to the folder containing the Moodle files in te address bar – in this example it’s <nowiki>http://localhost/moodle</nowiki>.

[[image:Xampp23.gif]]

*The initial install page is displayed.

[[image:Xampp24.gif]]

*Choose your preferred language (English is used in this example) and click the “Next” button.

*A diagnostic report is displayed – hopefully it will look like this, if not you may need to address some issues.

[[image:Xampp25.gif]]

*Click the “Next” button to continue.

*The paths for your Moodle installation are shown – accept these or amend as desired.

[[image:Xampp26.gif]]

*Click the “Next” button to continue.

*In this screen we enter the database settings. The fields are populated with some suggested values.

[[image:Xampp27.gif]]

*In this example the database created is “moodle153”. The “root” user will be used without a password.

*DO NOT USE THE “ROOT” USER WITHOUT A PASSWORD FOR PRODUCTION INSTALLATIONS AS THIS CREATES A SECURITY VULNERABILITY

[[image:Xampp28.gif]]

*When the fields have been populated, click the “Next” button to continue.

*Provided the Moodle folder is writable a message confirming the configuration has been completed will be displayed.

[[image:Xampp29.gif]]

*Click the “ Continue” button to proceed.

The Moodle copyright / licence notices are displayed.

[[image:Xampp30.gif]]

*Click the “Yes” button to continue, then follow the instructions on the following screens.

===Troubleshooting===
====Skype====
*If XAMPP does not work when you launch your browser and you have [http://www.skype.com Skype] enabled it may be necessary to change the port settings in Skype.

* Locate "Options..." in Skype.

[[Image: Skype1.gif]]

* Locate the "Connection" options.

[[Image: Skype2.gif]]

* Remove the tick / check from the Checkbox.

[[Image: Skype3.gif]]

* Click the "Save" button.

* You may need to re-start your computer for this to take effect.

====Still having problems but do not have Skype installed?====
* Check for another program which may be using port 80. IIS is commonly found to be the culprit.

====Moodle Networking does not work====
You may need to enable curl. Instructions at this link [http://www.tildemark.com/programming/php/enable-curl-with-xampp-on-windows-xp.html Enable curl in XAMPP on XP]

[[Category:Administrator]]
[[Category:Installation]]

Windows installation using XAMPP

2007-02-27T15:26:21Z

Ray: /* Troubleshooting */

*Return to [[Windows installation]]

== Windows installation using XAMPP ==
===Introduction===

Note: This guide uses XAMPP 1.5.1

In this guide to installing Moodle on a computer using the Windows XP operating system there are a series of steps you will need to take which are explained step-by-step below. In overview the process is as follows:

The first steps are to obtain the Moodle files themselves and the software package (XAMPP) which installs the environment (PHP, Apache and MySql) Moodle requires to run on you computer. When these have been downloaded you will need to install XAMPP on you computer in much the same way as any other Windows program. The steps detail a recommended change to one of the installed components before explaining how to launch XAMPP and create the database required by Moodle (the database you create will be referred to later when installing Moodle).

Having set up the environment you must then place the Moodle files downloaded earlier into the correct location so that they can be accessed for the purposes of initiating the installation process (now) and later to run Moodle. (The installation and use of Moodle is conducted entirely from you web browser e.g. Internet Explorer, Firefox).

'''Note: These guidelines are not intended for the Complete Install Package from Downloads at Moodle.org - although the troubleshooting part may help if you encounter problems.'''

===Preparation===

====Get Moodle!====

*Download the version of Moodle you wish to install from [http://download.moodle.org/ Moodle.org]

[[Image: 14a.gif]].

====Get XAMPP!====

*Download XAMPP for Windows from [http://www.apachefriends.org/en/xampp.html Apachefriends.org]. This example assumes that you have downloaded the “Installer” package.

[[image:Xampp1.png]]

====Allow yourself some time====
*Say 45 minutes.

===Installing XAMPP===

*Run the installer, eventually you will be presented with an option about where to install the package.

[[image:Xampp2.gif]]

*In this example we are installing the package at c:\apachefriends\151 – that’s because it suits what our needs, you can choose you own location by specifying any suitable alternative folder.

*Continue with the installation, this will take a while!

[[image:Xampp3.gif]]

*Eventually you will be presented with the option to install Apache, MySQL, Filezilla as a service.

[[image:Xampp4.gif]]

*It’s probably best to choose “No” for now. You can always enable these as services later.

*Next you’ll be asked if you want to start the XAMPP Control Panel.

[[image:Xampp5.gif]]

*Click the “No” button.

===Change PHP version===

*It's often a good idea to switch to PHP version 4.x before installing Moodle to lessen the chances of any incompatibilities with more recent versions. Currently Moodle requires PHP version 4.3 (or higher).

To roll back to an earlier version of PHP as follows:

*From the “Start” menu locate the program group for apachefriends > xampp

[[image:Xampp20.gif]]

*Select “php switch”

[[image:Xampp21.gif]]

*Follow the instructions in the window.

[[image:Xampp22.gif]]

===Launch XAMPP Control Panel ===

*On your Desktop, locate the XAMPP icon and double click to launch the Control Panel.

*When the XAMPP Control Panel has launched, click the “Start” buttons for Apache and MySQL.

[[image:Xampp6.gif]]

*If all is well you will see something like this.
'''If Apache fails to run i.e. the "Running" text with the green background keeps disappearing) and you are using Skype - please review "Troubleshooting" at the end of these instructions.'''

[[image:Xampp31.gif]]

===Create the database===

*To create a database for your Moodle “site” we will use the phpMyAdmin utility included with XAMPP.

*To access this launch the web browser of your choice (Firefox is used in this example), type http://localhost in the address bar.

[[image:Xampp8.gif]]

*The XAMPP default page is displayed, click the link for your preferred language – we will be using English.

[[image:Xampp9.gif]]

*From the menu on the left, click on “phpMyAdmin”

[[image:Xampp10.gif]]

*When phpMy Admin has launched in your browser window, enter the name of your database in the “Create new database” field. In this example we are naming our database “moodle153”.

[[image:Xampp11.gif]]

*Click the “Create” button to create the database.

[[image:Xampp12.gif]]

The new database should be present in the dropdown list when the page has refreshed.

[[image:Xampp13.gif]]

===Extract the downloaded Moodle files to the correct location.===

*Locate the file downloaded from Moodle.org and either copy or cut the file to the Windows clipboard.

*Open the XAMPP Control Panel and click on the “Explore” button.

[[image:Xampp15.gif]]

*A Windows Explorer view similar to the one below will be displayed.

[[image:Xampp16.gif]]

*Open the “htdocs” folder.

[[image:Xampp17.gif]]

[[image:Xampp18.gif]]

*Paste the file cut/copied earlier into this folder.

*Extract the Moodle files from the file downloaded earlier. A default folder named “moodle” is created with the Moodle files within.

[[image:Xampp19.gif]]

===Start the installation===

*In your web browser, type the path to the folder containing the Moodle files in te address bar – in this example it’s <nowiki>http://localhost/moodle</nowiki>.

[[image:Xampp23.gif]]

*The initial install page is displayed.

[[image:Xampp24.gif]]

*Choose your preferred language (English is used in this example) and click the “Next” button.

*A diagnostic report is displayed – hopefully it will look like this, if not you may need to address some issues.

[[image:Xampp25.gif]]

*Click the “Next” button to continue.

*The paths for your Moodle installation are shown – accept these or amend as desired.

[[image:Xampp26.gif]]

*Click the “Next” button to continue.

*In this screen we enter the database settings. The fields are populated with some suggested values.

[[image:Xampp27.gif]]

*In this example the database created is “moodle153”. The “root” user will be used without a password.

*DO NOT USE THE “ROOT” USER WITHOUT A PASSWORD FOR PRODUCTION INSTALLATIONS AS THIS CREATES A SECURITY VULNERABILITY

[[image:Xampp28.gif]]

*When the fields have been populated, click the “Next” button to continue.

*Provided the Moodle folder is writable a message confirming the configuration has been completed will be displayed.

[[image:Xampp29.gif]]

*Click the “ Continue” button to proceed.

The Moodle copyright / licence notices are displayed.

[[image:Xampp30.gif]]

*Click the “Yes” button to continue, then follow the instructions on the following screens.

===Troubleshooting===
====Skype====
*If XAMPP does not work when you launch your browser and you have [http://www.skype.com Skype] enabled it may be necessary to change the port settings in Skype.

* Locate "Options..." in Skype.

[[Image: Skype1.gif]]

* Locate the "Connection" options.

[[Image: Skype2.gif]]

* Remove the tick / check from the Checkbox.

[[Image: Skype3.gif]]

* Click the "Save" button.

* You may need to re-start your computer for this to take effect.

====Still having problems but do not have Skype installed?====
* Check for another program which may be using port 80. IIS is commonly found to be the culprit.

====Moodle Networking does not work====
You may need to enable curl. Instructions at this link [http://www.tildemark.com/programming/php/enable-curl-with-xampp-on-windows-xp.html Enable curl in XAMPP on XP]

[[Category:Administrator]]
[[Category:Installation]]

Windows installation using XAMPP

2007-02-27T15:25:39Z

Ray: /* Moodle Networking does not work */

*Return to [[Windows installation]]

== Windows installation using XAMPP ==
===Introduction===

Note: This guide uses XAMPP 1.5.1

In this guide to installing Moodle on a computer using the Windows XP operating system there are a series of steps you will need to take which are explained step-by-step below. In overview the process is as follows:

The first steps are to obtain the Moodle files themselves and the software package (XAMPP) which installs the environment (PHP, Apache and MySql) Moodle requires to run on you computer. When these have been downloaded you will need to install XAMPP on you computer in much the same way as any other Windows program. The steps detail a recommended change to one of the installed components before explaining how to launch XAMPP and create the database required by Moodle (the database you create will be referred to later when installing Moodle).

Having set up the environment you must then place the Moodle files downloaded earlier into the correct location so that they can be accessed for the purposes of initiating the installation process (now) and later to run Moodle. (The installation and use of Moodle is conducted entirely from you web browser e.g. Internet Explorer, Firefox).

'''Note: These guidelines are not intended for the Complete Install Package from Downloads at Moodle.org - although the troubleshooting part may help if you encounter problems.'''

===Preparation===

====Get Moodle!====

*Download the version of Moodle you wish to install from [http://download.moodle.org/ Moodle.org]

[[Image: 14a.gif]].

====Get XAMPP!====

*Download XAMPP for Windows from [http://www.apachefriends.org/en/xampp.html Apachefriends.org]. This example assumes that you have downloaded the “Installer” package.

[[image:Xampp1.png]]

====Allow yourself some time====
*Say 45 minutes.

===Installing XAMPP===

*Run the installer, eventually you will be presented with an option about where to install the package.

[[image:Xampp2.gif]]

*In this example we are installing the package at c:\apachefriends\151 – that’s because it suits what our needs, you can choose you own location by specifying any suitable alternative folder.

*Continue with the installation, this will take a while!

[[image:Xampp3.gif]]

*Eventually you will be presented with the option to install Apache, MySQL, Filezilla as a service.

[[image:Xampp4.gif]]

*It’s probably best to choose “No” for now. You can always enable these as services later.

*Next you’ll be asked if you want to start the XAMPP Control Panel.

[[image:Xampp5.gif]]

*Click the “No” button.

===Change PHP version===

*It's often a good idea to switch to PHP version 4.x before installing Moodle to lessen the chances of any incompatibilities with more recent versions. Currently Moodle requires PHP version 4.3 (or higher).

To roll back to an earlier version of PHP as follows:

*From the “Start” menu locate the program group for apachefriends > xampp

[[image:Xampp20.gif]]

*Select “php switch”

[[image:Xampp21.gif]]

*Follow the instructions in the window.

[[image:Xampp22.gif]]

===Launch XAMPP Control Panel ===

*On your Desktop, locate the XAMPP icon and double click to launch the Control Panel.

*When the XAMPP Control Panel has launched, click the “Start” buttons for Apache and MySQL.

[[image:Xampp6.gif]]

*If all is well you will see something like this.
'''If Apache fails to run i.e. the "Running" text with the green background keeps disappearing) and you are using Skype - please review "Troubleshooting" at the end of these instructions.'''

[[image:Xampp31.gif]]

===Create the database===

*To create a database for your Moodle “site” we will use the phpMyAdmin utility included with XAMPP.

*To access this launch the web browser of your choice (Firefox is used in this example), type http://localhost in the address bar.

[[image:Xampp8.gif]]

*The XAMPP default page is displayed, click the link for your preferred language – we will be using English.

[[image:Xampp9.gif]]

*From the menu on the left, click on “phpMyAdmin”

[[image:Xampp10.gif]]

*When phpMy Admin has launched in your browser window, enter the name of your database in the “Create new database” field. In this example we are naming our database “moodle153”.

[[image:Xampp11.gif]]

*Click the “Create” button to create the database.

[[image:Xampp12.gif]]

The new database should be present in the dropdown list when the page has refreshed.

[[image:Xampp13.gif]]

===Extract the downloaded Moodle files to the correct location.===

*Locate the file downloaded from Moodle.org and either copy or cut the file to the Windows clipboard.

*Open the XAMPP Control Panel and click on the “Explore” button.

[[image:Xampp15.gif]]

*A Windows Explorer view similar to the one below will be displayed.

[[image:Xampp16.gif]]

*Open the “htdocs” folder.

[[image:Xampp17.gif]]

[[image:Xampp18.gif]]

*Paste the file cut/copied earlier into this folder.

*Extract the Moodle files from the file downloaded earlier. A default folder named “moodle” is created with the Moodle files within.

[[image:Xampp19.gif]]

===Start the installation===

*In your web browser, type the path to the folder containing the Moodle files in te address bar – in this example it’s <nowiki>http://localhost/moodle</nowiki>.

[[image:Xampp23.gif]]

*The initial install page is displayed.

[[image:Xampp24.gif]]

*Choose your preferred language (English is used in this example) and click the “Next” button.

*A diagnostic report is displayed – hopefully it will look like this, if not you may need to address some issues.

[[image:Xampp25.gif]]

*Click the “Next” button to continue.

*The paths for your Moodle installation are shown – accept these or amend as desired.

[[image:Xampp26.gif]]

*Click the “Next” button to continue.

*In this screen we enter the database settings. The fields are populated with some suggested values.

[[image:Xampp27.gif]]

*In this example the database created is “moodle153”. The “root” user will be used without a password.

*DO NOT USE THE “ROOT” USER WITHOUT A PASSWORD FOR PRODUCTION INSTALLATIONS AS THIS CREATES A SECURITY VULNERABILITY

[[image:Xampp28.gif]]

*When the fields have been populated, click the “Next” button to continue.

*Provided the Moodle folder is writable a message confirming the configuration has been completed will be displayed.

[[image:Xampp29.gif]]

*Click the “ Continue” button to proceed.

The Moodle copyright / licence notices are displayed.

[[image:Xampp30.gif]]

*Click the “Yes” button to continue, then follow the instructions on the following screens.

===Troubleshooting===
====Skype====
*If XAMPP does not work when you launch your browser and you have [http://www.skype.com Skype] enabled it may be necessary to change the port settings in Skype.

* Locate "Options..." in Skype.

[[Image: Skype1.gif]]

* Locate the "Connection" options.

[[Image: Skype2.gif]]

* Remove the tick / check from the Checkbox.

[[Image: Skype3.gif]]

* Click the "Save" button.

* You may need to re-start your computer for this to take effect.

====Still having problems but do not have Skype installed?====
* Check for another program which may be using port 80. IIS is commonly found to be the culprit.

[[Category:Administrator]]
[[Category:Installation]]

Windows installation using XAMPP

2007-02-27T15:25:07Z

Ray: /* Skype */

*Return to [[Windows installation]]

== Windows installation using XAMPP ==
===Introduction===

Note: This guide uses XAMPP 1.5.1

In this guide to installing Moodle on a computer using the Windows XP operating system there are a series of steps you will need to take which are explained step-by-step below. In overview the process is as follows:

The first steps are to obtain the Moodle files themselves and the software package (XAMPP) which installs the environment (PHP, Apache and MySql) Moodle requires to run on you computer. When these have been downloaded you will need to install XAMPP on you computer in much the same way as any other Windows program. The steps detail a recommended change to one of the installed components before explaining how to launch XAMPP and create the database required by Moodle (the database you create will be referred to later when installing Moodle).

Having set up the environment you must then place the Moodle files downloaded earlier into the correct location so that they can be accessed for the purposes of initiating the installation process (now) and later to run Moodle. (The installation and use of Moodle is conducted entirely from you web browser e.g. Internet Explorer, Firefox).

'''Note: These guidelines are not intended for the Complete Install Package from Downloads at Moodle.org - although the troubleshooting part may help if you encounter problems.'''

===Preparation===

====Get Moodle!====

*Download the version of Moodle you wish to install from [http://download.moodle.org/ Moodle.org]

[[Image: 14a.gif]].

====Get XAMPP!====

*Download XAMPP for Windows from [http://www.apachefriends.org/en/xampp.html Apachefriends.org]. This example assumes that you have downloaded the “Installer” package.

[[image:Xampp1.png]]

====Allow yourself some time====
*Say 45 minutes.

===Installing XAMPP===

*Run the installer, eventually you will be presented with an option about where to install the package.

[[image:Xampp2.gif]]

*In this example we are installing the package at c:\apachefriends\151 – that’s because it suits what our needs, you can choose you own location by specifying any suitable alternative folder.

*Continue with the installation, this will take a while!

[[image:Xampp3.gif]]

*Eventually you will be presented with the option to install Apache, MySQL, Filezilla as a service.

[[image:Xampp4.gif]]

*It’s probably best to choose “No” for now. You can always enable these as services later.

*Next you’ll be asked if you want to start the XAMPP Control Panel.

[[image:Xampp5.gif]]

*Click the “No” button.

===Change PHP version===

*It's often a good idea to switch to PHP version 4.x before installing Moodle to lessen the chances of any incompatibilities with more recent versions. Currently Moodle requires PHP version 4.3 (or higher).

To roll back to an earlier version of PHP as follows:

*From the “Start” menu locate the program group for apachefriends > xampp

[[image:Xampp20.gif]]

*Select “php switch”

[[image:Xampp21.gif]]

*Follow the instructions in the window.

[[image:Xampp22.gif]]

===Launch XAMPP Control Panel ===

*On your Desktop, locate the XAMPP icon and double click to launch the Control Panel.

*When the XAMPP Control Panel has launched, click the “Start” buttons for Apache and MySQL.

[[image:Xampp6.gif]]

*If all is well you will see something like this.
'''If Apache fails to run i.e. the "Running" text with the green background keeps disappearing) and you are using Skype - please review "Troubleshooting" at the end of these instructions.'''

[[image:Xampp31.gif]]

===Create the database===

*To create a database for your Moodle “site” we will use the phpMyAdmin utility included with XAMPP.

*To access this launch the web browser of your choice (Firefox is used in this example), type http://localhost in the address bar.

[[image:Xampp8.gif]]

*The XAMPP default page is displayed, click the link for your preferred language – we will be using English.

[[image:Xampp9.gif]]

*From the menu on the left, click on “phpMyAdmin”

[[image:Xampp10.gif]]

*When phpMy Admin has launched in your browser window, enter the name of your database in the “Create new database” field. In this example we are naming our database “moodle153”.

[[image:Xampp11.gif]]

*Click the “Create” button to create the database.

[[image:Xampp12.gif]]

The new database should be present in the dropdown list when the page has refreshed.

[[image:Xampp13.gif]]

===Extract the downloaded Moodle files to the correct location.===

*Locate the file downloaded from Moodle.org and either copy or cut the file to the Windows clipboard.

*Open the XAMPP Control Panel and click on the “Explore” button.

[[image:Xampp15.gif]]

*A Windows Explorer view similar to the one below will be displayed.

[[image:Xampp16.gif]]

*Open the “htdocs” folder.

[[image:Xampp17.gif]]

[[image:Xampp18.gif]]

*Paste the file cut/copied earlier into this folder.

*Extract the Moodle files from the file downloaded earlier. A default folder named “moodle” is created with the Moodle files within.

[[image:Xampp19.gif]]

===Start the installation===

*In your web browser, type the path to the folder containing the Moodle files in te address bar – in this example it’s <nowiki>http://localhost/moodle</nowiki>.

[[image:Xampp23.gif]]

*The initial install page is displayed.

[[image:Xampp24.gif]]

*Choose your preferred language (English is used in this example) and click the “Next” button.

*A diagnostic report is displayed – hopefully it will look like this, if not you may need to address some issues.

[[image:Xampp25.gif]]

*Click the “Next” button to continue.

*The paths for your Moodle installation are shown – accept these or amend as desired.

[[image:Xampp26.gif]]

*Click the “Next” button to continue.

*In this screen we enter the database settings. The fields are populated with some suggested values.

[[image:Xampp27.gif]]

*In this example the database created is “moodle153”. The “root” user will be used without a password.

*DO NOT USE THE “ROOT” USER WITHOUT A PASSWORD FOR PRODUCTION INSTALLATIONS AS THIS CREATES A SECURITY VULNERABILITY

[[image:Xampp28.gif]]

*When the fields have been populated, click the “Next” button to continue.

*Provided the Moodle folder is writable a message confirming the configuration has been completed will be displayed.

[[image:Xampp29.gif]]

*Click the “ Continue” button to proceed.

The Moodle copyright / licence notices are displayed.

[[image:Xampp30.gif]]

*Click the “Yes” button to continue, then follow the instructions on the following screens.

===Troubleshooting===
====Skype====
*If XAMPP does not work when you launch your browser and you have [http://www.skype.com Skype] enabled it may be necessary to change the port settings in Skype.

* Locate "Options..." in Skype.

[[Image: Skype1.gif]]

* Locate the "Connection" options.

[[Image: Skype2.gif]]

* Remove the tick / check from the Checkbox.

[[Image: Skype3.gif]]

* Click the "Save" button.

* You may need to re-start your computer for this to take effect.

====Moodle Networking does not work====
You may need to enable curl. Instructions at this link [http://www.tildemark.com/programming/php/enable-curl-with-xampp-on-windows-xp.html Enable curl in XAMPP on XP]

====Still having problems but do not have Skype installed?====
* Check for another program which may be using port 80. IIS is commonly found to be the culprit.

[[Category:Administrator]]
[[Category:Installation]]

Windows installation using XAMPP

2007-02-09T12:56:18Z

Ray: /* Introduction */

*Return to [[Windows installation]]

== Windows installation using XAMPP ==
===Introduction===

Note: This guide uses XAMPP 1.5.1

In this guide to installing Moodle on a computer using the Windows XP operating system there are a series of steps you will need to take which are explained step-by-step below. In overview the process is as follows:

The first steps are to obtain the Moodle files themselves and the software package (XAMPP) which installs the environment (PHP, Apache and MySql) Moodle requires to run on you computer. When these have been downloaded you will need to install XAMPP on you computer in much the same way as any other Windows program. The steps detail a recommended change to one of the installed components before explaining how to launch XAMPP and create the database required by Moodle (the database you create will be referred to later when installing Moodle).

Having set up the environment you must then place the Moodle files downloaded earlier into the correct location so that they can be accessed for the purposes of initiating the installation process (now) and later to run Moodle. (The installation and use of Moodle is conducted entirely from you web browser e.g. Internet Explorer, Firefox).

'''Note: These guidelines are not intended for the Complete Install Package from Downloads at Moodle.org - although the troubleshooting part may help if you encounter problems.'''

===Preparation===

====Get Moodle!====

*Download the version of Moodle you wish to install from [http://download.moodle.org/ Moodle.org]

[[Image: 14a.gif]].

====Get XAMPP!====

*Download XAMPP for Windows from [http://www.apachefriends.org/en/xampp.html Apachefriends.org]. This example assumes that you have downloaded the “Installer” package.

[[image:Xampp1.png]]

====Allow yourself some time====
*Say 45 minutes.

===Installing XAMPP===

*Run the installer, eventually you will be presented with an option about where to install the package.

[[image:Xampp2.gif]]

*In this example we are installing the package at c:\apachefriends\151 – that’s because it suits what our needs, you can choose you own location by specifying any suitable alternative folder.

*Continue with the installation, this will take a while!

[[image:Xampp3.gif]]

*Eventually you will be presented with the option to install Apache, MySQL, Filezilla as a service.

[[image:Xampp4.gif]]

*It’s probably best to choose “No” for now. You can always enable these as services later.

*Next you’ll be asked if you want to start the XAMPP Control Panel.

[[image:Xampp5.gif]]

*Click the “No” button.

===Change PHP version===

*It's often a good idea to switch to PHP version 4.x before installing Moodle to lessen the chances of any incompatibilities with more recent versions. Currently Moodle requires PHP version 4.3 (or higher).

To roll back to an earlier version of PHP as follows:

*From the “Start” menu locate the program group for apachefriends > xampp

[[image:Xampp20.gif]]

*Select “php switch”

[[image:Xampp21.gif]]

*Follow the instructions in the window.

[[image:Xampp22.gif]]

===Launch XAMPP Control Panel ===

*On your Desktop, locate the XAMPP icon and double click to launch the Control Panel.

*When the XAMPP Control Panel has launched, click the “Start” buttons for Apache and MySQL.

[[image:Xampp6.gif]]

*If all is well you will see something like this.
'''If Apache fails to run i.e. the "Running" text with the green background keeps disappearing) and you are using Skype - please review "Troubleshooting" at the end of these instructions.'''

[[image:Xampp31.gif]]

===Create the database===

*To create a database for your Moodle “site” we will use the phpMyAdmin utility included with XAMPP.

*To access this launch the web browser of your choice (Firefox is used in this example), type http://localhost in the address bar.

[[image:Xampp8.gif]]

*The XAMPP default page is displayed, click the link for your preferred language – we will be using English.

[[image:Xampp9.gif]]

*From the menu on the left, click on “phpMyAdmin”

[[image:Xampp10.gif]]

*When phpMy Admin has launched in your browser window, enter the name of your database in the “Create new database” field. In this example we are naming our database “moodle153”.

[[image:Xampp11.gif]]

*Click the “Create” button to create the database.

[[image:Xampp12.gif]]

The new database should be present in the dropdown list when the page has refreshed.

[[image:Xampp13.gif]]

===Extract the downloaded Moodle files to the correct location.===

*Locate the file downloaded from Moodle.org and either copy or cut the file to the Windows clipboard.

*Open the XAMPP Control Panel and click on the “Explore” button.

[[image:Xampp15.gif]]

*A Windows Explorer view similar to the one below will be displayed.

[[image:Xampp16.gif]]

*Open the “htdocs” folder.

[[image:Xampp17.gif]]

[[image:Xampp18.gif]]

*Paste the file cut/copied earlier into this folder.

*Extract the Moodle files from the file downloaded earlier. A default folder named “moodle” is created with the Moodle files within.

[[image:Xampp19.gif]]

===Start the installation===

*In your web browser, type the path to the folder containing the Moodle files in te address bar – in this example it’s <nowiki>http://localhost/moodle</nowiki>.

[[image:Xampp23.gif]]

*The initial install page is displayed.

[[image:Xampp24.gif]]

*Choose your preferred language (English is used in this example) and click the “Next” button.

*A diagnostic report is displayed – hopefully it will look like this, if not you may need to address some issues.

[[image:Xampp25.gif]]

*Click the “Next” button to continue.

*The paths for your Moodle installation are shown – accept these or amend as desired.

[[image:Xampp26.gif]]

*Click the “Next” button to continue.

*In this screen we enter the database settings. The fields are populated with some suggested values.

[[image:Xampp27.gif]]

*In this example the database created is “moodle153”. The “root” user will be used without a password.

*DO NOT USE THE “ROOT” USER WITHOUT A PASSWORD FOR PRODUCTION INSTALLATIONS AS THIS CREATES A SECURITY VULNERABILITY

[[image:Xampp28.gif]]

*When the fields have been populated, click the “Next” button to continue.

*Provided the Moodle folder is writable a message confirming the configuration has been completed will be displayed.

[[image:Xampp29.gif]]

*Click the “ Continue” button to proceed.

The Moodle copyright / licence notices are displayed.

[[image:Xampp30.gif]]

*Click the “Yes” button to continue, then follow the instructions on the following screens.

===Troubleshooting===
====Skype====
*If XAMPP does not work when you launch your browser and you have [http://www.skype.com Skype] enabled it may be necessary to change the port settings in Skype.

* Locate "Options..." in Skype.

[[Image: Skype1.gif]]

* Locate the "Connection" options.

[[Image: Skype2.gif]]

* Remove the tick / check from the Checkbox.

[[Image: Skype3.gif]]

* Click the "Save" button.

* You may need to re-start your computer for this to take effect.

====Still having problems but do not have Skype installed?====
* Check for another program which may be using port 80. IIS is commonly found to be the culprit.

[[Category:Administrator]]
[[Category:Installation]]

Windows installation using XAMPP

2007-02-09T12:56:05Z

Ray: /* Introduction */

*Return to [[Windows installation]]

== Windows installation using XAMPP ==
===Introduction===

Not: This guide uses XAMPP 1.5.1

In this guide to installing Moodle on a computer using the Windows XP operating system there are a series of steps you will need to take which are explained step-by-step below. In overview the process is as follows:

The first steps are to obtain the Moodle files themselves and the software package (XAMPP) which installs the environment (PHP, Apache and MySql) Moodle requires to run on you computer. When these have been downloaded you will need to install XAMPP on you computer in much the same way as any other Windows program. The steps detail a recommended change to one of the installed components before explaining how to launch XAMPP and create the database required by Moodle (the database you create will be referred to later when installing Moodle).

Having set up the environment you must then place the Moodle files downloaded earlier into the correct location so that they can be accessed for the purposes of initiating the installation process (now) and later to run Moodle. (The installation and use of Moodle is conducted entirely from you web browser e.g. Internet Explorer, Firefox).

'''Note: These guidelines are not intended for the Complete Install Package from Downloads at Moodle.org - although the troubleshooting part may help if you encounter problems.'''

===Preparation===

====Get Moodle!====

*Download the version of Moodle you wish to install from [http://download.moodle.org/ Moodle.org]

[[Image: 14a.gif]].

====Get XAMPP!====

*Download XAMPP for Windows from [http://www.apachefriends.org/en/xampp.html Apachefriends.org]. This example assumes that you have downloaded the “Installer” package.

[[image:Xampp1.png]]

====Allow yourself some time====
*Say 45 minutes.

===Installing XAMPP===

*Run the installer, eventually you will be presented with an option about where to install the package.

[[image:Xampp2.gif]]

*In this example we are installing the package at c:\apachefriends\151 – that’s because it suits what our needs, you can choose you own location by specifying any suitable alternative folder.

*Continue with the installation, this will take a while!

[[image:Xampp3.gif]]

*Eventually you will be presented with the option to install Apache, MySQL, Filezilla as a service.

[[image:Xampp4.gif]]

*It’s probably best to choose “No” for now. You can always enable these as services later.

*Next you’ll be asked if you want to start the XAMPP Control Panel.

[[image:Xampp5.gif]]

*Click the “No” button.

===Change PHP version===

*It's often a good idea to switch to PHP version 4.x before installing Moodle to lessen the chances of any incompatibilities with more recent versions. Currently Moodle requires PHP version 4.3 (or higher).

To roll back to an earlier version of PHP as follows:

*From the “Start” menu locate the program group for apachefriends > xampp

[[image:Xampp20.gif]]

*Select “php switch”

[[image:Xampp21.gif]]

*Follow the instructions in the window.

[[image:Xampp22.gif]]

===Launch XAMPP Control Panel ===

*On your Desktop, locate the XAMPP icon and double click to launch the Control Panel.

*When the XAMPP Control Panel has launched, click the “Start” buttons for Apache and MySQL.

[[image:Xampp6.gif]]

*If all is well you will see something like this.
'''If Apache fails to run i.e. the "Running" text with the green background keeps disappearing) and you are using Skype - please review "Troubleshooting" at the end of these instructions.'''

[[image:Xampp31.gif]]

===Create the database===

*To create a database for your Moodle “site” we will use the phpMyAdmin utility included with XAMPP.

*To access this launch the web browser of your choice (Firefox is used in this example), type http://localhost in the address bar.

[[image:Xampp8.gif]]

*The XAMPP default page is displayed, click the link for your preferred language – we will be using English.

[[image:Xampp9.gif]]

*From the menu on the left, click on “phpMyAdmin”

[[image:Xampp10.gif]]

*When phpMy Admin has launched in your browser window, enter the name of your database in the “Create new database” field. In this example we are naming our database “moodle153”.

[[image:Xampp11.gif]]

*Click the “Create” button to create the database.

[[image:Xampp12.gif]]

The new database should be present in the dropdown list when the page has refreshed.

[[image:Xampp13.gif]]

===Extract the downloaded Moodle files to the correct location.===

*Locate the file downloaded from Moodle.org and either copy or cut the file to the Windows clipboard.

*Open the XAMPP Control Panel and click on the “Explore” button.

[[image:Xampp15.gif]]

*A Windows Explorer view similar to the one below will be displayed.

[[image:Xampp16.gif]]

*Open the “htdocs” folder.

[[image:Xampp17.gif]]

[[image:Xampp18.gif]]

*Paste the file cut/copied earlier into this folder.

*Extract the Moodle files from the file downloaded earlier. A default folder named “moodle” is created with the Moodle files within.

[[image:Xampp19.gif]]

===Start the installation===

*In your web browser, type the path to the folder containing the Moodle files in te address bar – in this example it’s <nowiki>http://localhost/moodle</nowiki>.

[[image:Xampp23.gif]]

*The initial install page is displayed.

[[image:Xampp24.gif]]

*Choose your preferred language (English is used in this example) and click the “Next” button.

*A diagnostic report is displayed – hopefully it will look like this, if not you may need to address some issues.

[[image:Xampp25.gif]]

*Click the “Next” button to continue.

*The paths for your Moodle installation are shown – accept these or amend as desired.

[[image:Xampp26.gif]]

*Click the “Next” button to continue.

*In this screen we enter the database settings. The fields are populated with some suggested values.

[[image:Xampp27.gif]]

*In this example the database created is “moodle153”. The “root” user will be used without a password.

*DO NOT USE THE “ROOT” USER WITHOUT A PASSWORD FOR PRODUCTION INSTALLATIONS AS THIS CREATES A SECURITY VULNERABILITY

[[image:Xampp28.gif]]

*When the fields have been populated, click the “Next” button to continue.

*Provided the Moodle folder is writable a message confirming the configuration has been completed will be displayed.

[[image:Xampp29.gif]]

*Click the “ Continue” button to proceed.

The Moodle copyright / licence notices are displayed.

[[image:Xampp30.gif]]

*Click the “Yes” button to continue, then follow the instructions on the following screens.

===Troubleshooting===
====Skype====
*If XAMPP does not work when you launch your browser and you have [http://www.skype.com Skype] enabled it may be necessary to change the port settings in Skype.

* Locate "Options..." in Skype.

[[Image: Skype1.gif]]

* Locate the "Connection" options.

[[Image: Skype2.gif]]

* Remove the tick / check from the Checkbox.

[[Image: Skype3.gif]]

* Click the "Save" button.

* You may need to re-start your computer for this to take effect.

====Still having problems but do not have Skype installed?====
* Check for another program which may be using port 80. IIS is commonly found to be the culprit.

[[Category:Administrator]]
[[Category:Installation]]

Adding/editing a glossary

2006-11-18T17:47:28Z

Ray: /* Glossary Type */

{{Help files}}
{{Glossaries}}

==Glossary settings==

===Name/Description===

Here you should describe the purpose of the glossary, provide instructions or background information, links etc.

===Entries shown per page===

This defines the number of entries shown per page. The glossary can be configured to restrict the number of entries shown per page. If you have a large number of automatically-linked entries you should set this number lower to prevent long loading times.

===Glossary Type===

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

In addition, a glossary mey be specified as "Global" (by administrators only in versions prior to 1.7). A Global glossary is different to a normal Main or Secondary glossary in that the entries create automatic links throughout the whole site (and not just in the same course the glossary belongs to or an associated metacourse).

===Students can add entries===

This lets you specify whether a student can or cannot add, edit or delete his/her own entries. Entries exported to a main glossary can be updated or deleted by teachers only, so this setting only applies to secondary glossaries. (Note: A teacher can edit or delete any entry at any time.)

===Duplicated entries allowed===

Turning that on allows multiple entries to use the same concept name.

===Allow comments on entries===

That allows students to add comments to glossary entries. You can choose whether this feature is enabled or disabled. Teachers always can add comments to glossary entries.

===Allow print view===

That allows students to use the print view of the glossary. You can choose whether this feature is enabled or disabled. Teachers always can use the print view.

===Automatically link glossary entries===

If site-wide glossary autolinking is enabled by an administrator (see [[Filters (administrator)]] for further details), then turning this on allows individual entries in this glossary to be automatically linked whenever the concept words and phrases appear throughout the rest of the same course. This includes forum postings, internal resources, week summaries and so on. Note that enabling linking for the glossary does not automatically turn on linking for each entry - linking needs to be set for each entry individually. If you do not want particular text to be linked (in a forum posting, say) then you should add <nolink> and </nolink> tags around the text. Note that category names are also linked.

===Approved by default===

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

===Display format===

That specifies the way that each entry will be shown within the glossary.

The default formats are:

* Simple Dictionary

That looks like a conventional dictionary with separate entries. No authors are displayed and attachments are shown as links.

* Continuous

That shows the entries one after other without any kind of separation but the editing icons.

* Full with Author

A forum-like display format showing author's data. Attachments are shown as links.

* Full without Author

A forum-like display format that does not show author's data. Attachments are shown as links.

* Encyclopedia

Like 'Full with Author' but attached images are shown inline.

* FAQ

Useful for displaying lists of Frequently Asked Questions. It automatically appends the words QUESTION and ANSWER in the concept and definition respectively.

===Browsing options in Alphabet Display===

You can customize the way a user can browse a glossary. Browsing and searching are always available, but you can define three more options:
# SHOW SPECIAL Enable or disable browsing by special characters like @, #, etc.
# SHOW ALPHABET Enable or disable browsing by alphabetic letters.
# SHOW ALL Enable or disable browsing of all entries at once.

===Allow entries to be rated===

As in forums, you can allow entries to be rated. Here you will have to consider enabling two options:

====Use ratings====

If you decide to rate posts on the forum, you will have to define settings of the three following aspects:

* Users

If you want everybody to rate posts, choose 'Everyone can rate posts'. Otherwise, pick 'Only teachers can rate posts'.

* View

If you want to keep the grades known only to the individual students graded, you should choose the option 'Students can only see their own ratings'. If there is no such a need, opt for 'Students can see everyone's ratings'.

* Grade

There are several grading scales you can choose from. You can give a number of points to each post (from 1 to 100) or you can opt for two other scales: '''Scale: satisfactory''' (Outstanding, Satisfactory and Not satisfactory) or '''Separate and Connected ways of knowing''' (Mostly Connected Knowing, Separate and Connected, Mostly Separate Knowing). More information about the latter one are to be found [[Separate and Connected ways of knowing|here]].

====Restrict ratings to posts with dates in this range====

If you enable the '''Use ratings''' option, you will also face the necessity of choosing whether or not enable another option restricting ratings to posts in terms of time.

===Visible to students===

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

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

Windows installation using XAMPP

2006-09-23T20:40:09Z

Ray: /* Still having problems but do not have Skype installed? */

*Return to [[Windows installation]]

== Windows installation using XAMPP ==
===Introduction===
In this guide to installing Moodle on a computer using the Windows XP operating system there are a series of steps you will need to take which are explained step-by-step below. In overview the process is as follows:

The first steps are to obtain the Moodle files themselves and the software package (XAMPP) which installs the environment (PHP, Apache and MySql) Moodle requires to run on you computer. When these have been downloaded you will need to install XAMPP on you computer in much the same way as any other Windows program. The steps detail a recommended change to one of the installed components before explaining how to launch XAMPP and create the database required by Moodle (the database you create will be referred to later when installing Moodle).

Having set up the environment you must then place the Moodle files downloaded earlier into the correct location so that they can be accessed for the purposes of initiating the installation process (now) and later to run Moodle. (The installation and use of Moodle is conducted entirely from you web browser e.g. Internet Explorer, Firefox).

'''Note: These guidelines are not intended for the Complete Install Package from Downloads at Moodle.org - although the troubleshooting part may help if you encounter problems.'''

===Preparation===

====Get Moodle!====

*Download the version of Moodle you wish to install from [http://download.moodle.org/ Moodle.org]

[[Image: 14a.gif]].

====Get XAMPP!====

*Download XAMPP for Windows from [http://www.apachefriends.org/en/xampp.html Apachefriends.org]. This example assumes that you have downloaded the “Installer” package.

[[image:Xampp1.png]]

====Allow yourself some time====
*Say 45 minutes.

===Installing XAMPP===

*Run the installer, eventually you will be presented with an option about where to install the package.

[[image:Xampp2.gif]]

*In this example we are installing the package at c:\apachefriends\151 – that’s because it suits what our needs, you can choose you own location by specifying any suitable alternative folder.

*Continue with the installation, this will take a while!

[[image:Xampp3.gif]]

*Eventually you will be presented with the option to install Apache, MySQL, Filezilla as a service.

[[image:Xampp4.gif]]

*It’s probably best to choose “No” for now. You can always enable these as services later.

*Next you’ll be asked if you want to start the XAMPP Control Panel.

[[image:Xampp5.gif]]

*Click the “No” button.

===Change PHP version===

*It's often a good idea to switch to PHP version 4.x before installing Moodle to lessen the chances of any incompatibilities with more recent versions. Currently Moodle requires PHP version 4.3 (or higher).

To roll back to an earlier version of PHP as follows:

*From the “Start” menu locate the program group for apachefriends > xampp

[[image:Xampp20.gif]]

*Select “php switch”

[[image:Xampp21.gif]]

*Follow the instructions in the window.

[[image:Xampp22.gif]]

===Launch XAMPP Control Panel ===

*On your Desktop, locate the XAMPP icon and double click to launch the Control Panel.

*When the XAMPP Control Panel has launched, click the “Start” buttons for Apache and MySQL.

[[image:Xampp6.gif]]

*If all is well you will see something like this.
'''If Apache fails to run i.e. the "Running" text with the green background keeps disappearing) and you are using Skype - please review "Troubleshooting" at the end of these instructions.'''

[[image:Xampp31.gif]]

===Create the database===

*To create a database for your Moodle “site” we will use the phpMyAdmin utility included with XAMPP.

*To access this launch the web browser of your choice (Firefox is used in this example), type http://localhost in the address bar.

[[image:Xampp8.gif]]

*The XAMPP default page is displayed, click the link for your preferred language – we will be using English.

[[image:Xampp9.gif]]

*From the menu on the left, click on “phpMyAdmin”

[[image:Xampp10.gif]]

*When phpMy Admin has launched in your browser window, enter the name of your database in the “Create new database” field. In this example we are naming our database “moodle153”.

[[image:Xampp11.gif]]

*Click the “Create” button to create the database.

[[image:Xampp12.gif]]

The new database should be present in the dropdown list when the page has refreshed.

[[image:Xampp13.gif]]

===Extract the downloaded Moodle files to the correct location.===

*Locate the file downloaded from Moodle.org and either copy or cut the file to the Windows clipboard.

*Open the XAMPP Control Panel and click on the “Explore” button.

[[image:Xampp15.gif]]

*A Windows Explorer view similar to the one below will be displayed.

[[image:Xampp16.gif]]

*Open the “htdocs” folder.

[[image:Xampp17.gif]]

[[image:Xampp18.gif]]

*Paste the file cut/copied earlier into this folder.

*Extract the Moodle files from the file downloaded earlier. A default folder named “moodle” is created with the Moodle files within.

[[image:Xampp19.gif]]

===Start the installation===

*In your web browser, type the path to the folder containing the Moodle files in te address bar – in this example it’s <nowiki>http://localhost/moodle</nowiki>.

[[image:Xampp23.gif]]

*The initial install page is displayed.

[[image:Xampp24.gif]]

*Choose your preferred language (English is used in this example) and click the “Next” button.

*A diagnostic report is displayed – hopefully it will look like this, if not you may need to address some issues.

[[image:Xampp25.gif]]

*Click the “Next” button to continue.

*The paths for your Moodle installation are shown – accept these or amend as desired.

[[image:Xampp26.gif]]

*Click the “Next” button to continue.

*In this screen we enter the database settings. The fields are populated with some suggested values.

[[image:Xampp27.gif]]

*In this example the database created is “moodle153”. The “root” user will be used without a password.

*DO NOT USE THE “ROOT” USER WITHOUT A PASSWORD FOR PRODUCTION INSTALLATIONS AS THIS CREATES A SECURITY VULNERABILITY

[[image:Xampp28.gif]]

*When the fields have been populated, click the “Next” button to continue.

*Provided the Moodle folder is writable a message confirming the configuration has been completed will be displayed.

[[image:Xampp29.gif]]

*Click the “ Continue” button to proceed.

The Moodle copyright / licence notices are displayed.

[[image:Xampp30.gif]]

*Click the “Yes” button to continue, then follow the instructions on the following screens.

===Troubleshooting===
====Skype====
*If XAMPP does not work when you launch your browser and you have [http://www.skype.com Skype] enabled it may be necessary to change the port settings in Skype.

* Locate "Options..." in Skype.

[[Image: Skype1.gif]]

* Locate the "Connection" options.

[[Image: Skype2.gif]]

* Remove the tick / check from the Checkbox.

[[Image: Skype3.gif]]

* Click the "Save" button.

* You may need to re-start your computer for this to take effect.

====Still having problems but do not have Skype installed?====
* Check for another program which may be using port 80. IIS is commonly found to be the culprit.

[[Category:Administrator]]
[[Category:Installation]]

Windows installation using XAMPP

2006-09-23T20:39:17Z

Ray: /* Troubleshooting */

*Return to [[Windows installation]]

== Windows installation using XAMPP ==
===Introduction===
In this guide to installing Moodle on a computer using the Windows XP operating system there are a series of steps you will need to take which are explained step-by-step below. In overview the process is as follows:

The first steps are to obtain the Moodle files themselves and the software package (XAMPP) which installs the environment (PHP, Apache and MySql) Moodle requires to run on you computer. When these have been downloaded you will need to install XAMPP on you computer in much the same way as any other Windows program. The steps detail a recommended change to one of the installed components before explaining how to launch XAMPP and create the database required by Moodle (the database you create will be referred to later when installing Moodle).

Having set up the environment you must then place the Moodle files downloaded earlier into the correct location so that they can be accessed for the purposes of initiating the installation process (now) and later to run Moodle. (The installation and use of Moodle is conducted entirely from you web browser e.g. Internet Explorer, Firefox).

'''Note: These guidelines are not intended for the Complete Install Package from Downloads at Moodle.org - although the troubleshooting part may help if you encounter problems.'''

===Preparation===

====Get Moodle!====

*Download the version of Moodle you wish to install from [http://download.moodle.org/ Moodle.org]

[[Image: 14a.gif]].

====Get XAMPP!====

*Download XAMPP for Windows from [http://www.apachefriends.org/en/xampp.html Apachefriends.org]. This example assumes that you have downloaded the “Installer” package.

[[image:Xampp1.png]]

====Allow yourself some time====
*Say 45 minutes.

===Installing XAMPP===

*Run the installer, eventually you will be presented with an option about where to install the package.

[[image:Xampp2.gif]]

*In this example we are installing the package at c:\apachefriends\151 – that’s because it suits what our needs, you can choose you own location by specifying any suitable alternative folder.

*Continue with the installation, this will take a while!

[[image:Xampp3.gif]]

*Eventually you will be presented with the option to install Apache, MySQL, Filezilla as a service.

[[image:Xampp4.gif]]

*It’s probably best to choose “No” for now. You can always enable these as services later.

*Next you’ll be asked if you want to start the XAMPP Control Panel.

[[image:Xampp5.gif]]

*Click the “No” button.

===Change PHP version===

*It's often a good idea to switch to PHP version 4.x before installing Moodle to lessen the chances of any incompatibilities with more recent versions. Currently Moodle requires PHP version 4.3 (or higher).

To roll back to an earlier version of PHP as follows:

*From the “Start” menu locate the program group for apachefriends > xampp

[[image:Xampp20.gif]]

*Select “php switch”

[[image:Xampp21.gif]]

*Follow the instructions in the window.

[[image:Xampp22.gif]]

===Launch XAMPP Control Panel ===

*On your Desktop, locate the XAMPP icon and double click to launch the Control Panel.

*When the XAMPP Control Panel has launched, click the “Start” buttons for Apache and MySQL.

[[image:Xampp6.gif]]

*If all is well you will see something like this.
'''If Apache fails to run i.e. the "Running" text with the green background keeps disappearing) and you are using Skype - please review "Troubleshooting" at the end of these instructions.'''

[[image:Xampp31.gif]]

===Create the database===

*To create a database for your Moodle “site” we will use the phpMyAdmin utility included with XAMPP.

*To access this launch the web browser of your choice (Firefox is used in this example), type http://localhost in the address bar.

[[image:Xampp8.gif]]

*The XAMPP default page is displayed, click the link for your preferred language – we will be using English.

[[image:Xampp9.gif]]

*From the menu on the left, click on “phpMyAdmin”

[[image:Xampp10.gif]]

*When phpMy Admin has launched in your browser window, enter the name of your database in the “Create new database” field. In this example we are naming our database “moodle153”.

[[image:Xampp11.gif]]

*Click the “Create” button to create the database.

[[image:Xampp12.gif]]

The new database should be present in the dropdown list when the page has refreshed.

[[image:Xampp13.gif]]

===Extract the downloaded Moodle files to the correct location.===

*Locate the file downloaded from Moodle.org and either copy or cut the file to the Windows clipboard.

*Open the XAMPP Control Panel and click on the “Explore” button.

[[image:Xampp15.gif]]

*A Windows Explorer view similar to the one below will be displayed.

[[image:Xampp16.gif]]

*Open the “htdocs” folder.

[[image:Xampp17.gif]]

[[image:Xampp18.gif]]

*Paste the file cut/copied earlier into this folder.

*Extract the Moodle files from the file downloaded earlier. A default folder named “moodle” is created with the Moodle files within.

[[image:Xampp19.gif]]

===Start the installation===

*In your web browser, type the path to the folder containing the Moodle files in te address bar – in this example it’s <nowiki>http://localhost/moodle</nowiki>.

[[image:Xampp23.gif]]

*The initial install page is displayed.

[[image:Xampp24.gif]]

*Choose your preferred language (English is used in this example) and click the “Next” button.

*A diagnostic report is displayed – hopefully it will look like this, if not you may need to address some issues.

[[image:Xampp25.gif]]

*Click the “Next” button to continue.

*The paths for your Moodle installation are shown – accept these or amend as desired.

[[image:Xampp26.gif]]

*Click the “Next” button to continue.

*In this screen we enter the database settings. The fields are populated with some suggested values.

[[image:Xampp27.gif]]

*In this example the database created is “moodle153”. The “root” user will be used without a password.

*DO NOT USE THE “ROOT” USER WITHOUT A PASSWORD FOR PRODUCTION INSTALLATIONS AS THIS CREATES A SECURITY VULNERABILITY

[[image:Xampp28.gif]]

*When the fields have been populated, click the “Next” button to continue.

*Provided the Moodle folder is writable a message confirming the configuration has been completed will be displayed.

[[image:Xampp29.gif]]

*Click the “ Continue” button to proceed.

The Moodle copyright / licence notices are displayed.

[[image:Xampp30.gif]]

*Click the “Yes” button to continue, then follow the instructions on the following screens.

===Troubleshooting===
====Skype====
*If XAMPP does not work when you launch your browser and you have [http://www.skype.com Skype] enabled it may be necessary to change the port settings in Skype.

* Locate "Options..." in Skype.

[[Image: Skype1.gif]]

* Locate the "Connection" options.

[[Image: Skype2.gif]]

* Remove the tick / check from the Checkbox.

[[Image: Skype3.gif]]

* Click the "Save" button.

* You may need to re-start your computer for this to take effect.

===Still having problems but do not have Skype installed?===
* Check for another program which may be using port 80. IIS is commonly found to be the culprit.

[[Category:Administrator]]
[[Category:Installation]]

Windows installation using XAMPP

2006-09-02T10:34:48Z

Ray: /* Windows installation using XAMPP */

*Return to [[Windows installation]]

== Windows installation using XAMPP ==
===Introduction===
In this guide to installing Moodle on a computer using the Windows XP operating system there are a series of steps you will need to take which are explained step-by-step below. In overview the process is as follows:

The first steps are to obtain the Moodle files themselves and the software package (XAMPP) which installs the environment (PHP, Apache and MySql) Moodle requires to run on you computer. When these have been downloaded you will need to install XAMPP on you computer in much the same way as any other Windows program. The steps detail a recommended change to one of the installed components before explaining how to launch XAMPP and create the database required by Moodle (the database you create will be referred to later when installing Moodle).

Having set up the environment you must then place the Moodle files downloaded earlier into the correct location so that they can be accessed for the purposes of initiating the installation process (now) and later to run Moodle. (The installation and use of Moodle is conducted entirely from you web browser e.g. Internet Explorer, Firefox).

'''Note: These guidelines are not intended for the Complete Install Package from Downloads at Moodle.org - although the troubleshooting part may help if you encounter problems.'''

===Preparation===

====Get Moodle!====

*Download the version of Moodle you wish to install from [http://download.moodle.org/ Moodle.org]

[[Image: 14a.gif]].

====Get XAMPP!====

*Download XAMPP for Windows from [http://www.apachefriends.org/en/xampp.html Apachefriends.org]. This example assumes that you have downloaded the “Installer” package.

[[image:Xampp1.png]]

====Allow yourself some time====
*Say 45 minutes.

===Installing XAMPP===

*Run the installer, eventually you will be presented with an option about where to install the package.

[[image:Xampp2.gif]]

*In this example we are installing the package at c:\apachefriends\151 – that’s because it suits what our needs, you can choose you own location by specifying any suitable alternative folder.

*Continue with the installation, this will take a while!

[[image:Xampp3.gif]]

*Eventually you will be presented with the option to install Apache, MySQL, Filezilla as a service.

[[image:Xampp4.gif]]

*It’s probably best to choose “No” for now. You can always enable these as services later.

*Next you’ll be asked if you want to start the XAMPP Control Panel.

[[image:Xampp5.gif]]

*Click the “No” button.

===Change PHP version===

*It's often a good idea to switch to PHP version 4.x before installing Moodle to lessen the chances of any incompatibilities with more recent versions. Currently Moodle requires PHP version 4.3 (or higher).

To roll back to an earlier version of PHP as follows:

*From the “Start” menu locate the program group for apachefriends > xampp

[[image:Xampp20.gif]]

*Select “php switch”

[[image:Xampp21.gif]]

*Follow the instructions in the window.

[[image:Xampp22.gif]]

===Launch XAMPP Control Panel ===

*On your Desktop, locate the XAMPP icon and double click to launch the Control Panel.

*When the XAMPP Control Panel has launched, click the “Start” buttons for Apache and MySQL.

[[image:Xampp6.gif]]

*If all is well you will see something like this.
'''If Apache fails to run i.e. the "Running" text with the green background keeps disappearing) and you are using Skype - please review "Troubleshooting" at the end of these instructions.'''

[[image:Xampp31.gif]]

===Create the database===

*To create a database for your Moodle “site” we will use the phpMyAdmin utility included with XAMPP.

*To access this launch the web browser of your choice (Firefox is used in this example), type http://localhost in the address bar.

[[image:Xampp8.gif]]

*The XAMPP default page is displayed, click the link for your preferred language – we will be using English.

[[image:Xampp9.gif]]

*From the menu on the left, click on “phpMyAdmin”

[[image:Xampp10.gif]]

*When phpMy Admin has launched in your browser window, enter the name of your database in the “Create new database” field. In this example we are naming our database “moodle153”.

[[image:Xampp11.gif]]

*Click the “Create” button to create the database.

[[image:Xampp12.gif]]

The new database should be present in the dropdown list when the page has refreshed.

[[image:Xampp13.gif]]

===Extract the downloaded Moodle files to the correct location.===

*Locate the file downloaded from Moodle.org and either copy or cut the file to the Windows clipboard.

*Open the XAMPP Control Panel and click on the “Explore” button.

[[image:Xampp15.gif]]

*A Windows Explorer view similar to the one below will be displayed.

[[image:Xampp16.gif]]

*Open the “htdocs” folder.

[[image:Xampp17.gif]]

[[image:Xampp18.gif]]

*Paste the file cut/copied earlier into this folder.

*Extract the Moodle files from the file downloaded earlier. A default folder named “moodle” is created with the Moodle files within.

[[image:Xampp19.gif]]

===Start the installation===

*In your web browser, type the path to the folder containing the Moodle files in te address bar – in this example it’s <nowiki>http://localhost/moodle</nowiki>.

[[image:Xampp23.gif]]

*The initial install page is displayed.

[[image:Xampp24.gif]]

*Choose your preferred language (English is used in this example) and click the “Next” button.

*A diagnostic report is displayed – hopefully it will look like this, if not you may need to address some issues.

[[image:Xampp25.gif]]

*Click the “Next” button to continue.

*The paths for your Moodle installation are shown – accept these or amend as desired.

[[image:Xampp26.gif]]

*Click the “Next” button to continue.

*In this screen we enter the database settings. The fields are populated with some suggested values.

[[image:Xampp27.gif]]

*In this example the database created is “moodle153”. The “root” user will be used without a password.

*DO NOT USE THE “ROOT” USER WITHOUT A PASSWORD FOR PRODUCTION INSTALLATIONS AS THIS CREATES A SECURITY VULNERABILITY

[[image:Xampp28.gif]]

*When the fields have been populated, click the “Next” button to continue.

*Provided the Moodle folder is writable a message confirming the configuration has been completed will be displayed.

[[image:Xampp29.gif]]

*Click the “ Continue” button to proceed.

The Moodle copyright / licence notices are displayed.

[[image:Xampp30.gif]]

*Click the “Yes” button to continue, then follow the instructions on the following screens.

===Troubleshooting===
====Skype====
*If XAMPP does not work when you launch your browser and you have [http://www.skype.com Skype] enabled it may be necessary to change the port settings in Skype.

* Locate "Options..." in Skype.

[[Image: Skype1.gif]]

* Locate the "Connection" options.

[[Image: Skype2.gif]]

* Remove the tick / check from the Checkbox.

[[Image: Skype3.gif]]

* Click the "Save" button.

* You may need to re-start your computer for this to take effect.

[[Category:Administrator]]
[[Category:Installation]]

Windows installation using XAMPP

2006-08-29T09:06:04Z

Ray: /* Change PHP version */

*Return to [[Windows installation]]

== Windows installation using XAMPP ==
*XAMPP is a package which installs PHP, Apache and MySql (amongst other things) and will enable you to run Moodle on a Windows PC, Laptop or Server.

*The following is a step by step guide to installing Moodle on a computer running Windows XP using the XAMPP package.

'''Note: These guidelines are not intended for the Complete Install Package from Downloads at Moodle.org - although the troubleshooting part may help if you encounter problems.'''

===Preparation===

====Get Moodle!====

*Download the version of Moodle you wish to install from [http://download.moodle.org/ Moodle.org]

[[Image: 14a.gif]].

====Get XAMPP!====

*Download XAMPP for Windows from [http://www.apachefriends.org/en/xampp.html Apachefriends.org]. This example assumes that you have downloaded the “Installer” package.

[[image:Xampp1.png]]

====Allow yourself some time====
*Say 45 minutes.

===Installing XAMPP===

*Run the installer, eventually you will be presented with an option about where to install the package.

[[image:Xampp2.gif]]

*In this example we are installing the package at c:\apachefriends\151 – that’s because it suits what our needs, you can choose you own location by specifying any suitable alternative folder.

*Continue with the installation, this will take a while!

[[image:Xampp3.gif]]

*Eventually you will be presented with the option to install Apache, MySQL, Filezilla as a service.

[[image:Xampp4.gif]]

*It’s probably best to choose “No” for now. You can always enable these as services later.

*Next you’ll be asked if you want to start the XAMPP Control Panel.

[[image:Xampp5.gif]]

*Click the “No” button.

===Change PHP version===

*It's often a good idea to switch to PHP version 4.x before installing Moodle to lessen the chances of any incompatibilities with more recent versions. Currently Moodle requires PHP version 4.3 (or higher).

To roll back to an earlier version of PHP as follows:

*From the “Start” menu locate the program group for apachefriends > xampp

[[image:Xampp20.gif]]

*Select “php switch”

[[image:Xampp21.gif]]

*Follow the instructions in the window.

[[image:Xampp22.gif]]

===Launch XAMPP Control Panel ===

*On your Desktop, locate the XAMPP icon and double click to launch the Control Panel.

*When the XAMPP Control Panel has launched, click the “Start” buttons for Apache and MySQL.

[[image:Xampp6.gif]]

*If all is well you will see something like this.
'''If Apache fails to run i.e. the "Running" text with the green background keeps disappearing) and you are using Skype - please review "Troubleshooting" at the end of these instructions.'''

[[image:Xampp31.gif]]

===Create the database===

*To create a database for your Moodle “site” we will use the phpMyAdmin utility included with XAMPP.

*To access this launch the web browser of your choice (Firefox is used in this example), type http://localhost in the address bar.

[[image:Xampp8.gif]]

*The XAMPP default page is displayed, click the link for your preferred language – we will be using English.

[[image:Xampp9.gif]]

*From the menu on the left, click on “phpMyAdmin”

[[image:Xampp10.gif]]

*When phpMy Admin has launched in your browser window, enter the name of your database in the “Create new database” field. In this example we are naming our database “moodle153”.

[[image:Xampp11.gif]]

*Click the “Create” button to create the database.

[[image:Xampp12.gif]]

The new database should be present in the dropdown list when the page has refreshed.

[[image:Xampp13.gif]]

===Extract the downloaded Moodle files to the correct location.===

*Locate the file downloaded from Moodle.org and either copy or cut the file to the Windows clipboard.

*Open the XAMPP Control Panel and click on the “Explore” button.

[[image:Xampp15.gif]]

*A Windows Explorer view similar to the one below will be displayed.

[[image:Xampp16.gif]]

*Open the “htdocs” folder.

[[image:Xampp17.gif]]

[[image:Xampp18.gif]]

*Paste the file cut/copied earlier into this folder.

*Extract the Moodle files from the file downloaded earlier. A default folder named “moodle” is created with the Moodle files within.

[[image:Xampp19.gif]]

===Start the installation===

*In your web browser, type the path to the folder containing the Moodle files in te address bar – in this example it’s <nowiki>http://localhost/moodle</nowiki>.

[[image:Xampp23.gif]]

*The initial install page is displayed.

[[image:Xampp24.gif]]

*Choose your preferred language (English is used in this example) and click the “Next” button.

*A diagnostic report is displayed – hopefully it will look like this, if not you may need to address some issues.

[[image:Xampp25.gif]]

*Click the “Next” button to continue.

*The paths for your Moodle installation are shown – accept these or amend as desired.

[[image:Xampp26.gif]]

*Click the “Next” button to continue.

*In this screen we enter the database settings. The fields are populated with some suggested values.

[[image:Xampp27.gif]]

*In this example the database created is “moodle153”. The “root” user will be used without a password.

*DO NOT USE THE “ROOT” USER WITHOUT A PASSWORD FOR PRODUCTION INSTALLATIONS AS THIS CREATES A SECURITY VULNERABILITY

[[image:Xampp28.gif]]

*When the fields have been populated, click the “Next” button to continue.

*Provided the Moodle folder is writable a message confirming the configuration has been completed will be displayed.

[[image:Xampp29.gif]]

*Click the “ Continue” button to proceed.

The Moodle copyright / licence notices are displayed.

[[image:Xampp30.gif]]

*Click the “Yes” button to continue, then follow the instructions on the following screens.

===Troubleshooting===
====Skype====
*If XAMPP does not work when you launch your browser and you have [http://www.skype.com Skype] enabled it may be necessary to change the port settings in Skype.

* Locate "Options..." in Skype.

[[Image: Skype1.gif]]

* Locate the "Connection" options.

[[Image: Skype2.gif]]

* Remove the tick / check from the Checkbox.

[[Image: Skype3.gif]]

* Click the "Save" button.

* You may need to re-start your computer for this to take effect.

[[Category:Administrator]]
[[Category:Installation]]