MoodleDocs - User contributions [en]

Face-to-face walk through

2008-05-08T10:51:45Z

Austens:

{{Facetoface}}

''The following is the walk through of the implementation of the Face to Face module at a Government Department in New Zealand.''

'''Below''', when staff visit the PowerPoint course page they are presented with three separate classroom based PowerPoint courses (101, 201 & 301). Each is listed in its own topic on the same Moodle course page. The screen shots below only shows the first topic - PowerPoint 101.
[[Image:Ftof01.png]]

----
'''Below''', the staff member has clicked on the session offered on 15 August and is then asked to sign up or cancel. Note, in this screen shot the duration time has not been entered - this needs to be manually set as the booking can be for multiple days and varying time slots.
[[Image:Ftof02.png]]

----
'''Below''', the staff member has clicked on sign up and is asked to confirm their manager's email address. In the screen shot below this information is already known and the staff member needs only to confirm that it is correct.
[[Image:Ftof03.png]]

----
'''Below''', on-screen confirmation of the completed booking.
[[Image:Ftof04.png]]

----
'''Below''', the course page is now redrawn and in place of the upcoming session dates is the session they have booked.
[[Image:Ftof05.png]]
----
'''Below''', from here they can see, who else has booked on this session.
[[Image:Ftof06.png]]
----
'''Below''', and they can cancel their booking.
[[Image:Ftof07.png]]
----
'''Below''', they also receive an email message confirming the booking. This email message is re-sent with the header "Reminder" a settable number of days in advance of the session.
[[Image:Ftof08.png]]

Face-to-face module

2008-02-25T00:58:40Z

Austens: /* Walk through (users experience) */

Face-to-face activities are used to keep track of in-person trainings which require advance booking.

Each activity is offered in one or more identical sessions. These sessions can be given over multiple days.

Reminder messages are sent to users and their managers a few days before the session is scheduled to start. Confirmation messages are sent when users sign-up for a session or cancel.

== Walk through (users experience)==

''The following is the walk through of the implementation of the Face to Face module at Inland Revenue in New Zealand.''

'''Below''', when staff visit the PowerPoint course page they are presented with three separate classroom based PowerPoint courses (101, 201 & 301). Each is listed in its own topic on the same Moodle course page. The screen shots below only shows the first topic - PowerPoint 101.
[[Image:Ftof01.png]]

----
'''Below''', the staff member has clicked on the session offered on 15 August and is then asked to sign up or cancel. Note, in this screen shot the duration time has not been entered - this needs to be manually set as the booking can be for multiple days and varying time slots.
[[Image:Ftof02.png]]

----
'''Below''', the staff member has clicked on sign up and is asked to confirm their manager's email address. In the screen shot below this information is already known and the staff member needs only to confirm that it is correct.
[[Image:Ftof03.png]]

----
'''Below''', on-screen confirmation of the completed booking.
[[Image:Ftof04.png]]

----
'''Below''', the course page is now redrawn and in place of the upcoming session dates is the session they have booked.
[[Image:Ftof05.png]]
----
'''Below''', from here they can see, who else has booked on this session.
[[Image:Ftof06.png]]
----
'''Below''', and they can cancel their booking.
[[Image:Ftof07.png]]
----
'''Below''', they also receive an email message confirming the booking. This email message is re-sent with the header "Reminder" a settable number of days in advance of the session.
[[Image:Ftof08.png]]

== Creating a new session ==

Once you have added the Face-to-face activity to a course, you can add new sessions (as a teacher in that course or an administrator) by:

* clicking on the Face-to-face activity to get to the page of "upcoming sessions"
* clicking on the "add session" link at the bottom of the table

== Signing-up for a session ==

Students can sign-up for one of the sessions by clicking on the Face-to-face link in the course page (which brings them to the "upcoming sessions" page) and then clicking on the signup link next to the session they want.

== Integration with the course page ==

To display the session dates directly on the course page, add the following
code to the print_section() function in course/lib.php:

--- /cvs/moodle18/course/lib.php 2007-10-05 20:19:29.000000000 +1300
+++ course/lib.php 2007-11-06 21:14:08.000000000 +1300
@@ -1382,6 +1382,10 @@
echo "";
}

+ } elseif ($mod->modname == 'facetoface') {
+ include_once($CFG->dirroot.'/mod/facetoface/lib.php');
+ echo facetoface_print_coursemodule_info($mod);
+
} else { // Normal activity

//Accessibility: for files get description via icon.

== See also ==

* [http://moodle.org/mod/data/view.php?d=13&rid=995 Download]
* [http://moodle.org/mod/forum/view.php?id=7136 Forum]: get help and read annoucements
* [http://tracker.moodle.org/secure/IssueNavigator.jspa?reset=true&&pid=10033&component=10250&sorter/field=issuekey&sorter/order=DESC Bug tracker]

[[Category:Contributed code]]

Face-to-face module

2008-02-25T00:58:09Z

Austens: /* Walk through (users experience) */

Face-to-face activities are used to keep track of in-person trainings which require advance booking.

Each activity is offered in one or more identical sessions. These sessions can be given over multiple days.

Reminder messages are sent to users and their managers a few days before the session is scheduled to start. Confirmation messages are sent when users sign-up for a session or cancel.

== Walk through (users experience)==

''The following is the walk through of the implementation of the Face to Face module at Inland Revenue in New Zealand.''

'''Below''', when staff visit the PowerPoint course page they are presented with three separate classroom based PowerPoint courses (101, 201 & 301). Each is listed in its own topic on the same Moodle course page. The screen shots below only shows the first topic - PowerPoint 101.
[[Image:Ftof01.png]]

----
'''Below''', the staff member has clicked on the session offered on 15 August and is then asked to sign up or cancel. Note, in this screen shot the duration time has not been entered - this needs to be manually set as the booking can be for multiple days and varying time slots.
[[Image:Ftof02.png]]

----
'''Below''', the staff member has clicked on sign up and is asked to confirm their manager's email address. In the screen shot below this information is already known and the staff needs only to confirm that it is correct.
[[Image:Ftof03.png]]

----
'''Below''', on-screen confirmation of the completed booking.
[[Image:Ftof04.png]]

----
'''Below''', the course page is now redrawn and in place of the upcoming session dates is the session they have booked.
[[Image:Ftof05.png]]
----
'''Below''', from here they can see, who else has booked on this session.
[[Image:Ftof06.png]]
----
'''Below''', and they can cancel their booking.
[[Image:Ftof07.png]]
----
'''Below''', they also receive an email message confirming the booking. This email message is re-sent with the header "Reminder" a settable number of days in advance of the session.
[[Image:Ftof08.png]]

== Creating a new session ==

Once you have added the Face-to-face activity to a course, you can add new sessions (as a teacher in that course or an administrator) by:

* clicking on the Face-to-face activity to get to the page of "upcoming sessions"
* clicking on the "add session" link at the bottom of the table

== Signing-up for a session ==

Students can sign-up for one of the sessions by clicking on the Face-to-face link in the course page (which brings them to the "upcoming sessions" page) and then clicking on the signup link next to the session they want.

== Integration with the course page ==

To display the session dates directly on the course page, add the following
code to the print_section() function in course/lib.php:

--- /cvs/moodle18/course/lib.php 2007-10-05 20:19:29.000000000 +1300
+++ course/lib.php 2007-11-06 21:14:08.000000000 +1300
@@ -1382,6 +1382,10 @@
echo "";
}

+ } elseif ($mod->modname == 'facetoface') {
+ include_once($CFG->dirroot.'/mod/facetoface/lib.php');
+ echo facetoface_print_coursemodule_info($mod);
+
} else { // Normal activity

//Accessibility: for files get description via icon.

== See also ==

* [http://moodle.org/mod/data/view.php?d=13&rid=995 Download]
* [http://moodle.org/mod/forum/view.php?id=7136 Forum]: get help and read annoucements
* [http://tracker.moodle.org/secure/IssueNavigator.jspa?reset=true&&pid=10033&component=10250&sorter/field=issuekey&sorter/order=DESC Bug tracker]

[[Category:Contributed code]]

Face-to-face module

2008-02-25T00:57:36Z

Austens: /* Walk through (users experience) */

Face-to-face activities are used to keep track of in-person trainings which require advance booking.

Each activity is offered in one or more identical sessions. These sessions can be given over multiple days.

Reminder messages are sent to users and their managers a few days before the session is scheduled to start. Confirmation messages are sent when users sign-up for a session or cancel.

== Walk through (users experience)==

''The following is the walk through of the implementation of the Face to Face module at Inland Revenue in New Zealand.''

'''Below''', when staff visit the PowerPoint course page they are presented with three separate classroom based PowerPoint courses (101, 201 & 301). Each is listed in its own topic on the same Moodle course page. The screen shots below only shows the first topic - PowerPoint 101.
[[Image:Ftof01.png]]

----
'''Below''', the staff member has clicked on the session offered on 15 August and is then asked to sign up or cancel. Note, in this screen shot the duration time has not been entered - this needs to be manually set as the booking can be for multiple days and varying time slots)
[[Image:Ftof02.png]]

----
'''Below''', the staff member has clicked on sign up and is asked to confirm their manager's email address. In the screen shot below this information is already known and the staff needs only to confirm that it is correct.
[[Image:Ftof03.png]]

----
'''Below''', on-screen confirmation of the completed booking.
[[Image:Ftof04.png]]

----
'''Below''', the course page is now redrawn and in place of the upcoming session dates is the session they have booked.
[[Image:Ftof05.png]]
----
'''Below''', from here they can see, who else has booked on this session.
[[Image:Ftof06.png]]
----
'''Below''', and they can cancel their booking.
[[Image:Ftof07.png]]
----
'''Below''', they also receive an email message confirming the booking. This email message is re-sent with the header "Reminder" a settable number of days in advance of the session.
[[Image:Ftof08.png]]

== Creating a new session ==

Once you have added the Face-to-face activity to a course, you can add new sessions (as a teacher in that course or an administrator) by:

* clicking on the Face-to-face activity to get to the page of "upcoming sessions"
* clicking on the "add session" link at the bottom of the table

== Signing-up for a session ==

Students can sign-up for one of the sessions by clicking on the Face-to-face link in the course page (which brings them to the "upcoming sessions" page) and then clicking on the signup link next to the session they want.

== Integration with the course page ==

To display the session dates directly on the course page, add the following
code to the print_section() function in course/lib.php:

--- /cvs/moodle18/course/lib.php 2007-10-05 20:19:29.000000000 +1300
+++ course/lib.php 2007-11-06 21:14:08.000000000 +1300
@@ -1382,6 +1382,10 @@
echo "";
}

+ } elseif ($mod->modname == 'facetoface') {
+ include_once($CFG->dirroot.'/mod/facetoface/lib.php');
+ echo facetoface_print_coursemodule_info($mod);
+
} else { // Normal activity

//Accessibility: for files get description via icon.

== See also ==

* [http://moodle.org/mod/data/view.php?d=13&rid=995 Download]
* [http://moodle.org/mod/forum/view.php?id=7136 Forum]: get help and read annoucements
* [http://tracker.moodle.org/secure/IssueNavigator.jspa?reset=true&&pid=10033&component=10250&sorter/field=issuekey&sorter/order=DESC Bug tracker]

[[Category:Contributed code]]

Face-to-face module

2008-02-25T00:54:12Z

Austens: /* Walk through (users experience) */

Face-to-face activities are used to keep track of in-person trainings which require advance booking.

Each activity is offered in one or more identical sessions. These sessions can be given over multiple days.

Reminder messages are sent to users and their managers a few days before the session is scheduled to start. Confirmation messages are sent when users sign-up for a session or cancel.

== Walk through (users experience)==

''The following is the walk through of the implementation of the Face to Face module at Inland Revenue in New Zealand.''

'''Below''', when staff visit the PowerPoint course page they are presented with three separate classroom based PowerPoint courses (101, 201 & 301). Each is listed in its own topic on the same Moodle course page. The screen shots below only shows the first topic - PowerPoint 101.
[[Image:Ftof01.png]]

----
'''Below''', the staff member has clicked on the session offered on 15 August and is then asked to sign up or cancel.
[[Image:Ftof02.png]]

----
'''Below''', the staff member has clicked on sign up and is asked to confirm their manager's email address. In the screen shot below this information is already known and the staff needs only to confirm that it is correct.
[[Image:Ftof03.png]]

----
'''Below''', on-screen confirmation of the completed booking.
[[Image:Ftof04.png]]

----
'''Below''', the course page is now redrawn and in place of the upcoming session dates is the session they have booked.
[[Image:Ftof05.png]]
----
'''Below''', from here they can see, who else has booked on this session.
[[Image:Ftof06.png]]
----
'''Below''', and they can cancel their booking.
[[Image:Ftof07.png]]
----
'''Below''', they also receive an email message confirming the booking. This email message is re-sent with the header "Reminder" a settable number of days in advance of the session.
[[Image:Ftof08.png]]

== Creating a new session ==

Once you have added the Face-to-face activity to a course, you can add new sessions (as a teacher in that course or an administrator) by:

* clicking on the Face-to-face activity to get to the page of "upcoming sessions"
* clicking on the "add session" link at the bottom of the table

== Signing-up for a session ==

Students can sign-up for one of the sessions by clicking on the Face-to-face link in the course page (which brings them to the "upcoming sessions" page) and then clicking on the signup link next to the session they want.

== Integration with the course page ==

To display the session dates directly on the course page, add the following
code to the print_section() function in course/lib.php:

--- /cvs/moodle18/course/lib.php 2007-10-05 20:19:29.000000000 +1300
+++ course/lib.php 2007-11-06 21:14:08.000000000 +1300
@@ -1382,6 +1382,10 @@
echo "";
}

+ } elseif ($mod->modname == 'facetoface') {
+ include_once($CFG->dirroot.'/mod/facetoface/lib.php');
+ echo facetoface_print_coursemodule_info($mod);
+
} else { // Normal activity

//Accessibility: for files get description via icon.

== See also ==

* [http://moodle.org/mod/data/view.php?d=13&rid=995 Download]
* [http://moodle.org/mod/forum/view.php?id=7136 Forum]: get help and read annoucements
* [http://tracker.moodle.org/secure/IssueNavigator.jspa?reset=true&&pid=10033&component=10250&sorter/field=issuekey&sorter/order=DESC Bug tracker]

[[Category:Contributed code]]

Face-to-face module

2008-02-25T00:53:27Z

Austens: /* Walk through */

Face-to-face activities are used to keep track of in-person trainings which require advance booking.

Each activity is offered in one or more identical sessions. These sessions can be given over multiple days.

Reminder messages are sent to users and their managers a few days before the session is scheduled to start. Confirmation messages are sent when users sign-up for a session or cancel.

== Walk through (users experience)==

''The following is the walk through of the implementation of the Face to Face module at Inland Revenue in New Zealand.''

'''Below''', when staff visit the PowerPoint course page they are presented with three separate classroom based PowerPoint courses (101, 201 & 301). Each is listed in its own topic on the same Moodle course page. The screen shot below only shows the first PowerPoint classroom course.
[[Image:Ftof01.png]]

----
'''Below''', the staff member has clicked on the session offered on 15 August and is then asked to sign up or cancel.
[[Image:Ftof02.png]]

----
'''Below''', the staff member has clicked on sign up and is asked to confirm their manager's email address. In the screen shot below this information is already known and the staff needs only to confirm that it is correct.
[[Image:Ftof03.png]]

----
'''Below''', on-screen confirmation of the completed booking.
[[Image:Ftof04.png]]

----
'''Below''', the course page is now redrawn and in place of the upcoming session dates is the session they have booked.
[[Image:Ftof05.png]]
----
'''Below''', from here they can see, who else has booked on this session.
[[Image:Ftof06.png]]
----
'''Below''', and they can cancel their booking.
[[Image:Ftof07.png]]
----
'''Below''', they also receive an email message confirming the booking. This email message is re-sent with the header "Reminder" a settable number of days in advance of the session.
[[Image:Ftof08.png]]

== Creating a new session ==

Once you have added the Face-to-face activity to a course, you can add new sessions (as a teacher in that course or an administrator) by:

* clicking on the Face-to-face activity to get to the page of "upcoming sessions"
* clicking on the "add session" link at the bottom of the table

== Signing-up for a session ==

Students can sign-up for one of the sessions by clicking on the Face-to-face link in the course page (which brings them to the "upcoming sessions" page) and then clicking on the signup link next to the session they want.

== Integration with the course page ==

To display the session dates directly on the course page, add the following
code to the print_section() function in course/lib.php:

--- /cvs/moodle18/course/lib.php 2007-10-05 20:19:29.000000000 +1300
+++ course/lib.php 2007-11-06 21:14:08.000000000 +1300
@@ -1382,6 +1382,10 @@
echo "";
}

+ } elseif ($mod->modname == 'facetoface') {
+ include_once($CFG->dirroot.'/mod/facetoface/lib.php');
+ echo facetoface_print_coursemodule_info($mod);
+
} else { // Normal activity

//Accessibility: for files get description via icon.

== See also ==

* [http://moodle.org/mod/data/view.php?d=13&rid=995 Download]
* [http://moodle.org/mod/forum/view.php?id=7136 Forum]: get help and read annoucements
* [http://tracker.moodle.org/secure/IssueNavigator.jspa?reset=true&&pid=10033&component=10250&sorter/field=issuekey&sorter/order=DESC Bug tracker]

[[Category:Contributed code]]

File:Ftof08.png

2008-02-25T00:46:06Z

Austens:

File:Ftof07.png

2008-02-25T00:45:49Z

Austens:

File:Ftof06.png

2008-02-25T00:45:40Z

Austens:

File:Ftof05.png

2008-02-25T00:45:31Z

Austens:

File:Ftof04.png

2008-02-25T00:45:21Z

Austens:

File:Ftof03.png

2008-02-25T00:45:12Z

Austens:

File:Ftof02.png

2008-02-25T00:44:58Z

Austens:

Face-to-face module

2008-02-25T00:38:43Z

Austens: /* Walk through */

Face-to-face activities are used to keep track of in-person trainings which require advance booking.

Each activity is offered in one or more identical sessions. These sessions can be given over multiple days.

Reminder messages are sent to users and their managers a few days before the session is scheduled to start. Confirmation messages are sent when users sign-up for a session or cancel.

== Walk through ==

''The following is the walk through of the implementation of the Face to Face module at Inland Revenue in New Zealand.''

'''Below''', when staff visit the PowerPoint course page they are presented with three separate classroom based PowerPoint courses (101, 201 & 301). Each is listed in its own topic. The screen shot below only shows the first PowerPoint classroom course option on the Moodle course page.
[[Image:Ftof01.png]]

----
'''Below''', the staff member has clicked on the session offered on 15 August and is then asked to sign up or cancel.
[[Image:Ftof02.png]]

----
'''Below''', the staff member has clicked on sign up and is asked to confirm their manager's email address. In the screen shot below this information is already known and the staff needs only to confirm that it is correct.
[[Image:Ftof03.png]]

----
'''Below''', on-screen confirmation of the completed booking.
[[Image:Ftof04.png]]

== Creating a new session ==

Once you have added the Face-to-face activity to a course, you can add new sessions (as a teacher in that course or an administrator) by:

* clicking on the Face-to-face activity to get to the page of "upcoming sessions"
* clicking on the "add session" link at the bottom of the table

== Signing-up for a session ==

Students can sign-up for one of the sessions by clicking on the Face-to-face link in the course page (which brings them to the "upcoming sessions" page) and then clicking on the signup link next to the session they want.

== Integration with the course page ==

To display the session dates directly on the course page, add the following
code to the print_section() function in course/lib.php:

--- /cvs/moodle18/course/lib.php 2007-10-05 20:19:29.000000000 +1300
+++ course/lib.php 2007-11-06 21:14:08.000000000 +1300
@@ -1382,6 +1382,10 @@
echo "";
}

+ } elseif ($mod->modname == 'facetoface') {
+ include_once($CFG->dirroot.'/mod/facetoface/lib.php');
+ echo facetoface_print_coursemodule_info($mod);
+
} else { // Normal activity

//Accessibility: for files get description via icon.

== See also ==

* [http://moodle.org/mod/data/view.php?d=13&rid=995 Download]
* [http://moodle.org/mod/forum/view.php?id=7136 Forum]: get help and read annoucements
* [http://tracker.moodle.org/secure/IssueNavigator.jspa?reset=true&&pid=10033&component=10250&sorter/field=issuekey&sorter/order=DESC Bug tracker]

[[Category:Contributed code]]

Face-to-face module

2008-02-25T00:33:19Z

Austens: /* Walk through */

Face-to-face module

2008-02-25T00:28:17Z

Austens: /* Walk through */

Face-to-face module

2008-02-25T00:27:05Z

Austens: /* Overview */

File:Ftof01.png

2008-02-25T00:25:26Z

Austens:

Face-to-face module

2008-02-25T00:21:29Z

Austens: /* Overview */

Face-to-face module

2008-02-25T00:18:05Z

Austens: /* Overview */

Face-to-face module

2008-02-25T00:15:27Z

Austens:

Complete Install Packages for Mac OS X

2007-07-09T09:23:39Z

Austens: /* Edit the file config.php */

Complete install packages for Mac OS X are available from [http://download.moodle.org/macosx/ Moodle Downloads]. You will find a separate card for the Mac OS X downloads. They are designed for new and local installations on a Mac computer/server. There are other downloads for Linux, and Window Operating Systems that may involve more customization of configuration files.

The complete install packages for Mac OS X are named Moodle4Mac. These do not have sufficient security for public, production servers--only use for private, local testing purposes. These packages allow Moodle to be installed, along with the prerequisites that includes a web server, database and scripting language (Apache, MySQL and PHP in this case). Several versions of the complete install package are available. You will find versions for Intel based Macs and for older PPC based Macs. Please use the correct version for your processor. The instructions on the download page provide guidance on which version is likely to be most suitable.

'''Note 1:''' The latest complete install package version components, may not be backwardly compatible. Always check version compatibility of each component if you intend to develop materials on a later version of Moodle than the version installed on your "main" Moodle site. In short, complete install packages are designed for first time install on a "clean" machine.

'''Note 2:''' If you want a secure, public server with OS X, you may be interested to use the normal web server that comes preinstalled with every Mac Computer--see this [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client | Step-by-Step Guide for Installing Moodle]]. Please remember that the complete package Moodle4Mac is ready to use and really nothing must be installed.

==System requirements==
+ Apple Mac Computer
+ iMac, Mac mini, MacBook, iBook, PowerBook, Mac Pro, Xserve
+ Processor: Intel Core 2 Duo or PPC (G3, G4, G5)
+ RAM: 256 MB or better
+ Hard Disk: 250 MB free
+ System Software: Mac OS X 10.3 or 10.4

==Install complete package Moodle4Mac==
===Download and install Moodle4Mac===
'''Step 1:''' [http://download.moodle.org/macosx/ Download] the zipped disk image file from the Moodle download page. Please choose the correct file for your processor type. The zip archive should be unzipped automatically when the download is complete. If the download file is not unzipped please do this manually.

'''Step 2:''' Doubleclick the file Moodle4Mac.dmg to mount the installation disk.

[[Image:Moodle4Mac_1.png]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac, Apache, MySQL, PHP). MAMP makes no entries in any registry and no settings for the system variables. If you want to know more about MAMP please read the project page http://mamp.info/

'''Step 4:''' Now you are ready to start your web server. Go to the Applications folder. Find the MAMP folder and open it. Doubleclick the icon MAMP to start the server.

[[Image:Moodle4Mac_2.png]]

'''Step 5:''' Start your browser and type <nowiki> http://127.0.0.1:8888 or http://localhost:8888 </nowiki> in the address bar. You will start your preinstalled Moodle. You do not need to do any installation. You are ready. Done ... hey, that was easy, wasn't it??

[[Image:Moodle4Mac_3.jpg]]

'''Step 6:''' Please login with the username '''admin''' and the password '''12345''' and you will be the main administrator of your new local Moodle.

===Some words about the security ...===
Because everybody can read the predefined passwords of Moodle and MAMP you should know that the installation is not good for public servers. It's not secure!! Please read this: [http://www.network0.org/2006/09/23/how-to-secure-mamp/ How to secure MAMP?]. There is also a new package MAMP Pro that will let you do a lot of settings for a more secure web server. Please look to the web page for this product. You can find a describtion on the [http://www.living-e.com/MAMP-PRO/ MAMP server].
  

==Using Moodle4Mac as a local server in your network==

In some workshops we used Moodle4Mac as a quick server installation for our local network. You should change the admin passwords (Moodle and MySQL) before you do this. There are only two steps to get the server connection from every computer in your network. One step is the change of only one line in the Moodle config.php, and the second step is that you must open the firewall of the Mac OS X. This chapter shows how you can do this.

===Edit the file config.php===

Use the current ip address of your computer instead of localhost so an external computer can connect the the web server. If your network is configured to dynamic ip addresses via DHCP please make sure that your computer retains its ip address while you want to use it as a Moodle server.The best thing would be to get a static ip address for your computer. Mostly your ip address in a local network will show one of the following numbers 10.x.x.x, 172.x.x.x, or 192.168.x.x

If your computer for example has the ip address 192.168.0.20 then you must change the configuration from ''localhost'' to ''192.168.0.20''. In the following box you will see this address in the line $CFG->wwwroot. This ip address will be different in your own network. You must use own address for your own network!! Please do not use an ip address if you do not know what you are doing ... ask your network administrator.

<pre><?php /// Moodle Configuration File

unset($CFG);

$CFG->dbtype = 'mysql';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle18';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->dbpersist = false;
$CFG->prefix = 'mdl_';

// Use the ip address of your computer instead of localhost
$CFG->wwwroot = 'http://192.168.0.20:8888/moodle18';
$CFG->dirroot = '/Applications/MAMP/htdocs/moodle18';
$CFG->dataroot = '/Applications/MAMP/data/moodle18';
$CFG->admin = 'admin';

$CFG->directorypermissions = 00777; // try 02777 on a server in Safe Mode

$CFG->unicodedb = true; // Database is utf8

require_once("$CFG->dirroot/lib/setup.php");
// MAKE SURE WHEN YOU EDIT THIS FILE THAT THERE ARE NO SPACES, BLANK LINES,
// RETURNS, OR ANYTHING ELSE AFTER THE TWO CHARACTERS ON THE NEXT LINE.
?>
</pre>

===Open the firewall===
The web server that comes together with Moodle4Mac works on the TCP port 8888. Moodle4Mac uses this port because this gets no conflicts with the normal web server of Mac OS X that answers on TCP port 80. You can switch the port from 8888 to 80 but you must know the administration password of your Mac. In this case the normal web server will not work.

To open the firewall please go to '''System Preferences > Sharing > Firewall'''. Choose '''New...''', fill in TCP port 8888, and set the rule name '''Moodle4Mac'''.

[[Image:Moodle4Mac_Firewall1.png]]

When the rule exists it must be activated to get a connection to Moodle from any computer in your internal network.

[[Image:Moodle4Mac_Firewall2.png]]

===Connect Moodle from your network ...===
Your web server can be connected with the url http://x.x.x.x:8888/moodle18/ in your local network, where x.x.x.x is the address your Mac was given by the local router on your LAN. Usually such numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x. All users from any computer in your network can use your Moodle via this address.

This also works if your computer is connected to the internet directly. If you open the firewall in your internet router and if you forward the port 8888 to your computer then any user everywhere on the world would be able to work with your Moodle ... but please remember also that there are a lot of security risks if you do this ... it would be better if you don't do this!!

[[Image:Moodle4Mac_Network1.png]]

[[Image:Moodle4Mac_Network2.png]]

==How To Update Your Moodle4Mac==

It is very simple to update your locally installed Moodle. If you have got this course together with Moodle4Mac then you should have everything you need for a CVS update.

The only software you must have installed on your Apple computer is the Xcode Tools package from your system installation media. After this it only needs a doubleclick to get the newest Moodle version without downloading the complete installation package.

===Update the local Moodle via CVS===

Be sure that the Xcode Tools are installed on your Mac computer. You also must have an internet connection to get the files from the update server.

Now the only thing you need to do is to doubleclick on an icon inside your MAMP folder. That's all .... really .... it's easy!!

Please look for the document '''UpdateMoodle.sh'''. If you doubleclick this file you will see that the system utility '''Terminal''' opens and the update process starts automatically. You must allow to connect to the Moodle internet server ... but think about this fact only if a system tool asks you.

[[Image:Moodle4Mac_Update1.png]]

The update tool CVS connects to the Moodle internet server and looks for all those files that must be downloaded. If the process asks for a password you press the return button to enter ... the password is "empty". The update needs a few moments to find all the updated or new files but then only those files are transfered. Please wait for some minutes.

[[Image:Moodle4Mac_Update2.png]]

Every updated file is shown in the update log so you can control if the updater works and when it is completed. At least you will see the config.php because this file does not come from the update server.

If the update takes too long you may break with <strg>-C. It doesn't matter because only text files are copied. On break the process stops working. If you restart the update again the CVS tool runs through all folders and files again to find those that need to be renewed.

===Look Inside ... ===

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor. It is only a text file but it uses the Mac OS X feature to open a file with a chosen program via doubleclick.

[[Image:Moodle4Mac_Update3.png]]

I chose the system utility '''Terminal''' to open the file '''UpdateMoodle.sh''' and to run the script it contains automatically. So everything can be done with a doubleclick. It's easy and everybody can do it!!

<pre>
#! /bin/sh
#
# This CVS updater for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20070429 - Ralf Krause
#

export CVS_RSH=ssh

echo
echo "+--------------------------------------------+"
echo "| CVS update for your local Moodle server "
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs/moodle18/

### delete all files named .DS_Store
find . -name ".DS_Store" -type f -print0 | xargs -0 rm -f

### file ~/.cvspass must exist
if ! test -e ~/.cvspass ; then
touch ~/.cvspass
fi

### login to the cvs server only for the first time
if ! grep "uk.cvs.moodle.org" ~/.cvspass > /dev/null ; then
echo "CVS password is empty ... please only press <return> to start"
cvs -d :pserver:anonymous@uk.cvs.moodle.org:/cvsroot/moodle login
echo
fi

echo "Connecting to the CVS server. Download will take a few moments!"
echo "If the CVS update runs too long you may break with <strg>-C"
echo
cvs -q update -dP -r MOODLE_18_STABLE

</pre>

The different versions of the update script are different in only two things ... first you need to choose the correct folder for the Moodle files and seconds you must input the correct CVS tag for the Moodle version in the last line. The shown script is for updating the version Moodle 1.8
* Moodle 1.6 uses MOODLE_16_STABLE
* Moodle 1.7 uses MOODLE_17_STABLE
* Moodle 1.8 uses MOODLE_18_STABLE
* Moodle 1.9 dev uses HEAD

===More about Moodle and CVS ... ===

Please look at the documentation [[CVS for Administrators]] if you want to learn more. Remember that the CVS server for Moodle changed on 25th April 2007 so you have to update your scripts if you already installed an older version. Moodle had problems with the old CVS server so they had to change it.

If you are using an older package Moodle4Mac you must not reload the whole package and you must not reinstall all your local courses again. You only have to download the archive [http://download.moodle.org/macosx/ChangeCVSServer.zip ChangeCVSServer.zip]. It contains the script ChangeCSVSServer.sh ... please run it once and it changes all the CVS data automatically. You also will find new scripts UpdateMoodle.sh for Moodle 1.6, 1.7, 1.8, and 1.9 dev. You must use the correct version of the new script UpdateMoodle.sh for all your future updates. Please delete the old script from your MAMP folder.
  

===Install Xcode Tools on your Mac===

Xcode Tools is the developer tools package for Mac OS X. This package includes an integrated suite of software development tools, including compilers and applications.

If you do not know whether the Xcode Tools are installed on your Mac please look on your main harddrive. If there is a folder named Developer then you must do nothing.

[[Image:Moodle4Mac_Update4.png]]

If you cannot find this on your harddrive then you must install this package before following the instructions in this document. The Xcode Tools package is part of the Mac OS X installation media. You will find the Xcode Tools on your installation CD or DVD set.

[[Image:Moodle4Mac_Update5.png]]

If you do not find your installation media anymore you also can download the Xcode Tools from the URL http://developer.apple.com/tools/xcode/. It is free but you have to register as a developer. If you start the download from there please remember that the Xcode package brings a lot of bytes and will need a very few minutes to complete.

After you have put these things into your system you will see a new folder named Developer on your harddisk. If you only want to update your Moodle you do not need all these nice developer tools from the inside of the folder. Sorry about this but there is no separate installer for the CVS update process.
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [[Step-by-step Guide for Installing Moodle on Mac OS X 10.4 Client]]
* [[CVS for Administrators]]

* [http://en.wikipedia.org/wiki/Private_network Private network addresses in Wikipedia]
* [http://moodle.org/mod/forum/discuss.php?d=24632 Using Moodle: Dynamic DNS Home Server]

* [[Configuring aspell on Mac OS X]]

[[Category:Administrator]]
[[Category:Installation]]
[[Category:Mac OS X]]