MoodleDocs - User contributions [en]

Windows installation using Git

2013-07-10T10:43:29Z

Cruda: /* Getting hold of Moodle */

{{Installing Moodle}}
This page is for non-technical Windows users who would like to be able to keep a copy of Moodle on their computers that they can easily and regularly update.

'''NOTE:''' ''These guidelines are intended for a Standard Moodle installation on a Windows PC for a private or test Moodle installation, NOT a production (public) site or service. If you wish to install Moodle on a public site using Git then please see [[Git for Administrators]]''. ''If you wish to contribute fixes or improvements using Git please see [[Development: Git for developers]]''

If you prefer screencasts to reading, there is a [http://youtu.be/CORFciSlHuo youtube tutorial here]

==What you need to install Moodle on your Windows pc==
#somewhere on your pc to house it and keep it working,with a database to maintain its records. We will use [http://www.wampserver.com/en/ WAMP server]
#the Moodle files themselves. We will use [http://windows.github.com/ Github for Windows]

==What is Git and why use it?==
[http://en.wikipedia.org/wiki/Git_(software) Git] allows Moodlers not only to quickly download the latest versions of Moodle but also to [[File:git-pushpull-modelEDITED.png|200px|thumb|left|Git cycle]] download and test out fixes by developers and to share with others their own changes which may potentially get integrated into Moodle for the benefit of everyone. In this page we are merely going to use the system to download Moodle onto our computer- (see the cycle in yellow in the screenshot)Git makes it easy for us to update Moodle when new versions come out each week, and it gives you the potential when more familiar with it to grab other changes and help test it. However, if you merely want to have Moodle on your Windows pc to practise and try things out and are NOT really interested in having all the latest changes then it might be easier for you to use the [http://download.moodle.org/windows/ All in one Windows Installer package] instead.

==Getting the WAMP server==
[[File:wamplocation.png|200px|thumb|left|path to your wamp folder]]1. Go to [http://www.wampserver.com/en/ Wampserver] and click the Download button
2. You will probably need to click the button '''Wampserver (64 bits &PHP 5.3) 2.2E''' but to be sure, here is how to [http://tips4pc.com/computer_tips_and_tricks/do_i_have_a_32bit_or_64bit_operating_system.htm check if your pc is 64 bit or 32 bit])

3. You may get a warning '''You must install Visual C++ 2010 SP1 Redistributable Package x86 or x64''' - download the appropriate package for you. This may take some time.

4. When it is done, come back to [http://www.wampserver.com/en/ Wampserver] and click the Download button again.
Download, save and run the program, making sure you keep a note of where it has installed it on your computer. It will be in a folder called ''wamp.'' as in the screenshot to the left.

==Making the database==
Once wampserver is installed you will see a '''W''' icon, either on your desktop, start menu or taskbar (according to what you selected when installing.) Click it to bring up its options and then click PhpMyadmin as in Screenshot A below.

''Tip: You can also reach this screen by typing into your browser: http://localhost/phpmyadmin/''

1.Make sure that Server connection collation says "utf8_general_ci" (1 in Screenshot B below)

2.Click "databases" - (2 in Screenshot B below)

{|
| [[File:phpmyadminscreenshot.png|thumb|Screenshot A]]
| [[File:phpmyadmin12.png|thumb|Screenshot B]]
|}

3. Type a name for your database (how about "moodle"?) Make sure you remember its name. Ensure Collation is set to utf8_general-ci. Click "Create".
[[File:create database.png]]

4.Click the "check privileges" to the right of your database name and then click "add user".

5. Add your details as the database administrator. Choose "local" for the host Make sure you remember the name and password you set. Tick (check) all privileges and click "add user".

==Preparing to install Moodle==
[[File:moodledatascreenshot.png|200px|thumb|left|Where Moodle and Moodledata go]]

Along with the folder containing all the Moodle files, we need another folder to hold all the user data once Moodle is up and running. This is traditionally called the "moodledata" folder. We need to create a new folder for this before downloading Moodle.

#Find your wampserver on your computer - for instance, in C:\wamp.
#Note there is a folder called "www". We will install Moodle into there.
#If you wish, create a new folder called "moodledata" in the wampserver folder, as in the screenshot - but if not, Moodle will create it for you and suggest its name.

==Getting hold of Git==
#Go to [http://windows.github.com/ Github for Windows] and click the download button (currently in green, top right)
#You don't need to make an account but if you do, it will help you later if you wish to use Git at a more advanced level.
#Let Windows do its work; save it and run it. It might take some time.
#Once it is installed, you will have two cat-like creature icons on your desktop, taskbar or start menu (depending on what you selected)
#Click the one called "Git shell". It will bring up a black box:

[[File:gitshell.png|400px|Git shell]]

==Getting hold of Moodle==
The file path shown in your black box ("Windows power shell") is where Git has made your personal repository. You can download Moodle into there if you wish, but you will then have to copy the Moodle folder into your wampserver directory. Instead, we will download Moodle straight into the www folder of our wampserver directory.

1. Type <code>cd C:\wamp\www</code> (or whatever the path is to your wampserver directory and where you want to put Moodle)

2. Type <code>git clone -b MOODLE_23_STABLE git://git.moodle.org/moodle.git</code> (If you want a different version, see the [[#Troubleshooting and FAQ]] below.)

3. Wait! Lots of lines will appear and it might take a while. At the end you should see "Checking out files:100% done"

{|
| [[File:cdstep1.png|thumb|Step 1]]
| [[File:step2.png|thumb|Step2]]
| [[File:step3.png|thumb|Step3]]
|}

==Installing Moodle==
#In your browser, type ''localhost/moodle''
#The Moodle set up screen will appear.
#Much of this is straightforward form-filling. Pay attention to:
##the paths -does it know where to find your wampserver folder for Moodle and moodledata?
##the database details (which you should have remembered when setting up in section 4 above)
##the server check.

{|
| [[File:path.png|thumb|Check correct paths]]
| [[File:databaseremember.png|thumb|Database details]]
| [[File:serverchecks.png|thumb|Server check]]
|}

===What are server checks?===
Moodle needs to ensure our wampserver has all the features ("extensions") enabled to run it successfully.

Anything in green is fine. Anything in yellow is OK (but would be better in green). Anything in red will stop us installing Moodle.

#Make a note of the ones in yellow or red (names are under the Information column)
#Click your '''W''' wampserver icon and click "php extensions" (screenshot 1 below)
#Tick those extensions you noted were yellow or red (screenshot 2 below)

{|
| [[File:phpextensions1.png|thumb|Php extensions 1]]
| [[File:phpextensions2.png|thumb|Php extensions 2]]
|}

'''''Note:''' If you have problems enabling the curl extension, see the [[#Troubleshooting and FAQ]] below.''

==Completing the installation==
#Once your server checks page shows all green or all green with some yellow, you can click "Continue"
#Moodle will install - this will take some time. Be patient. When you see "workshop" you know you are nearly done.
#Complete details for your admin username and password (and remember them!)
#Complete details for your front page (name of your Moodle, etc)
#Give yourself a pat on the back!

==Updating your Moodle==
You can get a newer version of Moodle every Thursday. To do this using Git:
#Click the Git shell avatar to open up the Windows powershell black box.
#If it shows a different directory from where you installed Moodle, change the path by typing in <code>C:\wamp\www\moodle</code> or wherever the path to your Moodle folder is.
#You will see it now displays the name of the Moodle version you installed (Screenshot 1 below)
#Type <code>git pull</code>
#Lines will appear and your Moodle will update itself automatically!(Screenshot 2 below)
#Note that <code>git pull</code> will also tell you if your version is currently up to date (Screenshot 3 below)

{|
| [[File:updating1.png|thumb|1: Moodle folder ready for update ]]
| [[File:gitpullscreenshot.png|thumb|2: Moodle has been updated]]
| [[File:updating2.png|thumb|3: Currently up to date]]
|}

==Troubleshooting and FAQ==
===I can't get cURL extension to green (or even yellow) whatever I try.===
It could be your downloaded wampserver had a corrupted cURL extension (mine did). Go to [http://www.mediafire.com/?qwgdzgccthzwc15 mediafire.com] and download the cURL extenstion there. Unzip it and then add it into (for example) ''wamp>bin>php>php 5.3.13>ext.'' (The exact path will depend on where you saved your wampserver.) Let it override the original and try again.

===I type localhost/moodle but it doesn't work!===
Make sure your wampserver is working ("online") The '''W''' icon should be green. If it isn't, then click it and click "restart all services" or "start all services" and try again.

===I want a different version of Moodle===

If you want an earlier version such as Moodle 2.2 then type <code>git clone -b MOODLE_22_STABLE git://git.moodle.org/moodle.git</code>

If you want the latest, non-stable, development version of Moodle (currently 2.4) then type <code> git clone git://git.moodle.org/moodle.git</code>

===I want Moodle in localhost and NOT localhost/moodle===
In the [[#Getting hold of Moodle]] section, make sure your path does not include "www". It might be for instance "C:\wamp". Moodle will then download directly into your wampserver directory. Rename your "www" folder to "wwwOLD" and then rename your newly arrived moodle folder to "www".

==See also==
[http://youtu.be/CORFciSlHuo Video tutorial on youtube]

Using Moodle forum thread [http://moodle.org/mod/forum/discuss.php?d=208904 Git for Dummies]

Windows installation using Git

2013-07-05T15:12:28Z

Cruda: /* Preparing to install Moodle */

{{Installing Moodle}}
This page is for non-technical Windows users who would like to be able to keep a copy of Moodle on their computers that they can easily and regularly update.

'''NOTE:''' ''These guidelines are intended for a Standard Moodle installation on a Windows PC for a private or test Moodle installation, NOT a production (public) site or service. If you wish to install Moodle on a public site using Git then please see [[Git for Administrators]]''. ''If you wish to contribute fixes or improvements using Git please see [[Development: Git for developers]]''

If you prefer screencasts to reading, there is a [http://youtu.be/CORFciSlHuo youtube tutorial here]

==What you need to install Moodle on your Windows pc==
#somewhere on your pc to house it and keep it working,with a database to maintain its records. We will use [http://www.wampserver.com/en/ WAMP server]
#the Moodle files themselves. We will use [http://windows.github.com/ Github for Windows]

==What is Git and why use it?==
[http://en.wikipedia.org/wiki/Git_(software) Git] allows Moodlers not only to quickly download the latest versions of Moodle but also to [[File:git-pushpull-modelEDITED.png|200px|thumb|left|Git cycle]] download and test out fixes by developers and to share with others their own changes which may potentially get integrated into Moodle for the benefit of everyone. In this page we are merely going to use the system to download Moodle onto our computer- (see the cycle in yellow in the screenshot)Git makes it easy for us to update Moodle when new versions come out each week, and it gives you the potential when more familiar with it to grab other changes and help test it. However, if you merely want to have Moodle on your Windows pc to practise and try things out and are NOT really interested in having all the latest changes then it might be easier for you to use the [http://download.moodle.org/windows/ All in one Windows Installer package] instead.

==Getting the WAMP server==
[[File:wamplocation.png|200px|thumb|left|path to your wamp folder]]1. Go to [http://www.wampserver.com/en/ Wampserver] and click the Download button
2. You will probably need to click the button '''Wampserver (64 bits &PHP 5.3) 2.2E''' but to be sure, here is how to [http://tips4pc.com/computer_tips_and_tricks/do_i_have_a_32bit_or_64bit_operating_system.htm check if your pc is 64 bit or 32 bit])

3. You may get a warning '''You must install Visual C++ 2010 SP1 Redistributable Package x86 or x64''' - download the appropriate package for you. This may take some time.

4. When it is done, come back to [http://www.wampserver.com/en/ Wampserver] and click the Download button again.
Download, save and run the program, making sure you keep a note of where it has installed it on your computer. It will be in a folder called ''wamp.'' as in the screenshot to the left.

==Making the database==
Once wampserver is installed you will see a '''W''' icon, either on your desktop, start menu or taskbar (according to what you selected when installing.) Click it to bring up its options and then click PhpMyadmin as in Screenshot A below.

''Tip: You can also reach this screen by typing into your browser: http://localhost/phpmyadmin/''

1.Make sure that Server connection collation says "utf8_general_ci" (1 in Screenshot B below)

2.Click "databases" - (2 in Screenshot B below)

{|
| [[File:phpmyadminscreenshot.png|thumb|Screenshot A]]
| [[File:phpmyadmin12.png|thumb|Screenshot B]]
|}

3. Type a name for your database (how about "moodle"?) Make sure you remember its name. Ensure Collation is set to utf8_general-ci. Click "Create".
[[File:create database.png]]

4.Click the "check privileges" to the right of your database name and then click "add user".

5. Add your details as the database administrator. Choose "local" for the host Make sure you remember the name and password you set. Tick (check) all privileges and click "add user".

==Preparing to install Moodle==
[[File:moodledatascreenshot.png|200px|thumb|left|Where Moodle and Moodledata go]]

Along with the folder containing all the Moodle files, we need another folder to hold all the user data once Moodle is up and running. This is traditionally called the "moodledata" folder. We need to create a new folder for this before downloading Moodle.

#Find your wampserver on your computer - for instance, in C:\wamp.
#Note there is a folder called "www". We will install Moodle into there.
#If you wish, create a new folder called "moodledata" in the wampserver folder, as in the screenshot - but if not, Moodle will create it for you and suggest its name.

==Getting hold of Git==
#Go to [http://windows.github.com/ Github for Windows] and click the download button (currently in green, top right)
#You don't need to make an account but if you do, it will help you later if you wish to use Git at a more advanced level.
#Let Windows do its work; save it and run it. It might take some time.
#Once it is installed, you will have two cat-like creature icons on your desktop, taskbar or start menu (depending on what you selected)
#Click the one called "Git shell". It will bring up a black box:

[[File:gitshell.png|400px|Git shell]]

==Getting hold of Moodle==
The file path shown in your black box ("Windows power shell") is where Git has made your personal repository. You can download Moodle into there if you wish, but you will then have to copy the Moodle folder into your wampserver directory. Instead, we will download Moodle straight into the www folder of our wampserver directory.

1. Type <code>cd: C\wamp\www</code> (or whatever the path is to your wampserver directory and where you want to put Moodle)

2. Type <code>git clone -b MOODLE_23_STABLE git://git.moodle.org/moodle.git</code> (If you want a different version, see the [[#Troubleshooting and FAQ]] below.)

3. Wait! Lots of lines will appear and it might take a while. At the end you should see "Checking out files:100% done"

{|
| [[File:cdstep1.png|thumb|Step 1]]
| [[File:step2.png|thumb|Step2]]
| [[File:step3.png|thumb|Step3]]
|}

==Installing Moodle==
#In your browser, type ''localhost/moodle''
#The Moodle set up screen will appear.
#Much of this is straightforward form-filling. Pay attention to:
##the paths -does it know where to find your wampserver folder for Moodle and moodledata?
##the database details (which you should have remembered when setting up in section 4 above)
##the server check.

{|
| [[File:path.png|thumb|Check correct paths]]
| [[File:databaseremember.png|thumb|Database details]]
| [[File:serverchecks.png|thumb|Server check]]
|}

===What are server checks?===
Moodle needs to ensure our wampserver has all the features ("extensions") enabled to run it successfully.

Anything in green is fine. Anything in yellow is OK (but would be better in green). Anything in red will stop us installing Moodle.

#Make a note of the ones in yellow or red (names are under the Information column)
#Click your '''W''' wampserver icon and click "php extensions" (screenshot 1 below)
#Tick those extensions you noted were yellow or red (screenshot 2 below)

{|
| [[File:phpextensions1.png|thumb|Php extensions 1]]
| [[File:phpextensions2.png|thumb|Php extensions 2]]
|}

'''''Note:''' If you have problems enabling the curl extension, see the [[#Troubleshooting and FAQ]] below.''

==Completing the installation==
#Once your server checks page shows all green or all green with some yellow, you can click "Continue"
#Moodle will install - this will take some time. Be patient. When you see "workshop" you know you are nearly done.
#Complete details for your admin username and password (and remember them!)
#Complete details for your front page (name of your Moodle, etc)
#Give yourself a pat on the back!

==Updating your Moodle==
You can get a newer version of Moodle every Thursday. To do this using Git:
#Click the Git shell avatar to open up the Windows powershell black box.
#If it shows a different directory from where you installed Moodle, change the path by typing in <code>C:\wamp\www\moodle</code> or wherever the path to your Moodle folder is.
#You will see it now displays the name of the Moodle version you installed (Screenshot 1 below)
#Type <code>git pull</code>
#Lines will appear and your Moodle will update itself automatically!(Screenshot 2 below)
#Note that <code>git pull</code> will also tell you if your version is currently up to date (Screenshot 3 below)

{|
| [[File:updating1.png|thumb|1: Moodle folder ready for update ]]
| [[File:gitpullscreenshot.png|thumb|2: Moodle has been updated]]
| [[File:updating2.png|thumb|3: Currently up to date]]
|}

==Troubleshooting and FAQ==
===I can't get cURL extension to green (or even yellow) whatever I try.===
It could be your downloaded wampserver had a corrupted cURL extension (mine did). Go to [http://www.mediafire.com/?qwgdzgccthzwc15 mediafire.com] and download the cURL extenstion there. Unzip it and then add it into (for example) ''wamp>bin>php>php 5.3.13>ext.'' (The exact path will depend on where you saved your wampserver.) Let it override the original and try again.

===I type localhost/moodle but it doesn't work!===
Make sure your wampserver is working ("online") The '''W''' icon should be green. If it isn't, then click it and click "restart all services" or "start all services" and try again.

===I want a different version of Moodle===

If you want an earlier version such as Moodle 2.2 then type <code>git clone -b MOODLE_22_STABLE git://git.moodle.org/moodle.git</code>

If you want the latest, non-stable, development version of Moodle (currently 2.4) then type <code> git clone git://git.moodle.org/moodle.git</code>

===I want Moodle in localhost and NOT localhost/moodle===
In the [[#Getting hold of Moodle]] section, make sure your path does not include "www". It might be for instance "C:\wamp". Moodle will then download directly into your wampserver directory. Rename your "www" folder to "wwwOLD" and then rename your newly arrived moodle folder to "www".

==See also==
[http://youtu.be/CORFciSlHuo Video tutorial on youtube]

Using Moodle forum thread [http://moodle.org/mod/forum/discuss.php?d=208904 Git for Dummies]

Use Time Based Course Report

2011-01-13T13:56:17Z

Cruda: minor spelling issues

The Use Time Based Course Report custom report provides a structured reporting of elapsed time by the users within a Moodle course, and presenting those detailed result conformely to the course most probable pedagogic layout.

The pedagogic organisation is compiled from the internal course setup information and
will be aware of most course formats in Moodle. At least are handled :

* Topic course format
* Weekly course format

as standard

* Flexipage course format (and all variants called "page")

In the former cases will the course structure be derived from section list, getting the
proper order of activities and resources as setup by the editing teacher.

In the latter case will the course structure be derived from a recursive analysis of the
flexipage construction, starting from first page. The recursion will essentially count on
a pagemenu module that should provide the entire explorable structure of the course. In its
standard implementation only published pages (that is visible by students) will be processed.

=== Features ===

Features :

* Per student reports : reports the entire pedagogic track with individual and summarized
presence time.
* Per group (or training session bundled in groups) : Reports a summarized presence time
for an entire group.
* Excel exports of individual timesheet.
* Excel export of a group timesheet as an Excel multiple individual sheet.
* Time range filter.
* Graphical display of progression (progressbars)

=== Progression display ===

The course progression is essentially displayed compiling all accessed items within the entire
course layout. There is no numerical weighting of activities nor resources, so the progress indicator
only gives an idea of how much of the content has been viewed and used. This should not be considered
for qualitative learning analysis.

=== Screens ===

* [[Use Time Based Course Report : Per Student|Per student]]
* [[Use Time Based Course Report : Per Group|Per group]]
* [[Use Time Based Course Report : Excel exports|Excel exports]]

=== Dependencies ===

Dependencies : works with the [[Use Stats Block|blocks/use_stats]] log analyser module.

=== Capabilities ===

* report/trainingsessions:view : allows accessing to the reports sheets.

=== Reference, information, development and support ===

valery.fremaux-AT-club-internet.fr

[[Category:Contributed code]]

Use Time Based Course Report

2011-01-13T13:48:14Z

Cruda: minor spelling issues

The Use Time Based Course Report custome report provides a structured reporting of elapsed time by the usrs within a Moodle course, and presenting those detailed result conformely to the course most probable pedagogic layout.

The pedagogic organisation is compiled from the internal course setup information and
will be aware of most course formats in Moodle. At least are handled :

* Topic course format
* Weekly course format

as standard

* Flexipage course format (and all variants called "page")

In the former cases will the course structure be derivated from section list, getting the
propoer order of activities and resources as setup by the editing teacher.

In the latter case will the course structure be derivated from a recursive analysis of the
flexipage construction, starting from first page. The recursion will essentially count on
a pagemenu module that should provide the entire explorable structure of the course. In its
standard implementation only published pages (that is visible by students) will be processed.

=== Features ===

Features :

* Per student reports : reports the entire pedagogic track with individual and summarized
presence time.
* Per group (or training session bundled in groups) : Reports a summarized presence time
for an entire group.
* Excel exports of individual timesheet.
* Excel export of a group timesheet as an Excel multiple individual sheet.
* Time range filter.
* Graphical display of progression (progressbars)

=== Progression display ===

The course progression is essentially displayed compiling all accessed items within the entire
course layout. There is no numerical weighting of activities nor resources, so the progress indicator
only gives an idea of how much of the content has been viewed and used. This should not be considered
for qualitative learning analysis.

=== Screens ===

* [[Use Time Based Course Report : Per Student|Per student]]
* [[Use Time Based Course Report : Per Group|Per group]]
* [[Use Time Based Course Report : Excel exports|Excel exports]]

=== Dependencies ===

Dependencies : works with the [[Use Stats Block|blocks/use_stats]] log analyser module.

=== Capabilities ===

* report/trainingsessions:view : allows accessing to the reports sheets.

=== Reference, information, development and support ===

valery.fremaux-AT-club-internet.fr

[[Category:Contributed code]]